routee-compass-core 0.11.3

The core routing algorithms and data structures of the RouteE-Compass energy-aware routing engine
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

use crate::model::{
    access::AccessModelError,
    cost::CostModelError,
    frontier::FrontierModelError,
    network::{edge_id::EdgeId, network_error::NetworkError, vertex_id::VertexId},
    state::StateModelError,
    termination::TerminationModelError,
    traversal::TraversalModelError,
};

#[derive(thiserror::Error, Debug)]
pub enum SearchError {
    #[error("failure building search algorithm: {0}")]
    BuildError(String),
    #[error("The search failed due to state model error. The state model is responsible for updates to the state of the search at each increment of traversal. Please review the [state] section of your Compass configuration. Source: {source}")]
    StateFailure {
        #[from]
        source: StateModelError,
    },
    #[error("The search failed due to a road network error. Please review the [graph] section of your Compass configuration. Source: {source}")]
    NetworkFailure {
        #[from]
        source: NetworkError,
    },
    #[error("The search failed due to termination model error. Please review the [termination] section of your Compass Configuration to make changes. Source: {source}")]
    TerminationModelFailure {
        #[from]
        source: TerminationModelError,
    },
    #[error("The search failed due to traversal model error. The traversal model performs edge traversals by updating the various search dimensions, based on the state and cost models. Please review the [traversal] section of your Compass Configuration. Source: {source}")]
    TraversalModelFailure {
        #[from]
        source: TraversalModelError,
    },
    #[error("The search failed due to access model error. The access model performs edge-to-edge transitions by updating the various search dimensions, based on the state and cost models. Please review the [access] section of your Compass Configuration. Source: {source}")]
    AccessModelFailure {
        #[from]
        source: AccessModelError,
    },
    #[error("The search failed due to frontier model error. The frontier model restricts access to edges. Please review the [frontier] section of your Compass Configuration. Source: {source}")]
    FrontierModelFailure {
        #[from]
        source: FrontierModelError,
    },
    #[error("The search failed due to cost model error. The cost model interprets a delta of search state dimensions as having a cost value, which is minimized by the search. Please see the [cost] section of your Compass Configuration and additionally any query-time overrides. Source: {source}")]
    CostFailure {
        #[from]
        source: CostModelError,
    },
    #[error("query terminated due to {0}")]
    QueryTerminated(String),
    #[error("no path exists between vertices {0} and {1} after searching {2} edges")]
    NoPathExistsBetweenVertices(VertexId, VertexId, usize),
    #[error("no path exists between edges {0} and {1} after searching {2} edges")]
    NoPathExistsBetweenEdges(EdgeId, EdgeId, usize),
    #[error("error accessing shared read-only dataset: {0}")]
    ReadOnlyPoisonError(String),
    #[error("internal error due to search logic: {0}")]
    InternalError(String),
}