trailgen-core 0.2.0

Typed trail graph, route scoring, loop search, and geospatial route I/O for adequate-trailgen.
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
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93

//! Provider-agnostic trail graph, scoring, routing, and route I/O.

pub mod builder;
pub mod cache;
pub mod conflate;
pub mod constraints;
pub mod crs;
pub mod enrich;
pub mod geo;
pub mod hiking;
pub mod io;
pub mod model;
pub mod optimizer;
pub mod overlay;
pub mod raster;
pub mod route;
pub mod routing;
pub mod seed;
pub mod source;
pub mod trail;

pub use builder::{
    DEFAULT_SNAP_TOLERANCE_M, GraphBuilder, JunctionKey, JunctionPolicy, SegmentDraft,
    TurnRestrictionDraft, TurnRestrictionRule,
};
pub use cache::{GRAPH_CACHE, decode_graph, encode_graph};
pub use conflate::{
    ConflatedNetwork, ConflationDecision, ConflationPolicy, ConflationReport, ConflationStats,
    NetworkStratum, conflate,
};
pub use constraints::{
    ConstraintAudit, ConstraintVerdict, DEFAULT_MAX_DISTANCE_M, DEFAULT_MIN_DISTANCE_M,
    LoopConstraints,
};
pub use enrich::{
    ElevationMosaic, ElevationSample, ElevationSampler, EmbeddedElevation, EnrichmentConfig,
    PlaneElevation, enrich_graph,
};
pub use geo::{Coord, LineString};
pub use hiking::{EdgeTraversal, HikingModel, TraversalEstimate, joint_work_factor};
pub use model::{
    Access, CoverageGap, CoverageGapKind, CrossingControl, CrossingEvidence, CrossingKind, Edge,
    EdgeAttr, EdgeId, EdgeIndex, EdgeProjection, EdgeTravel, GeometryClaim, GradeDistribution,
    Provenance, RouteCoverage, RouteSnapStats, Terrain, TrailMarking, TrailStanding, TurnBan,
    Vertex, VertexId, WalkGraph, WayKind, WayRealm,
};
pub use optimizer::{
    EdgeDisposition, EdgeEdicts, ExactLoopSolver, LoopHunter, RouteSolver, SearchMonitor,
    SearchParams, SearchProgress, SearchScope, SearchStage, SolverKind,
};
pub use overlay::{
    AccessOverlay, AccessWindow, ContextOverlay, DailyTimeWindow, MonthDay, OverlayGeometry,
    PlanningDate, PlanningMoment, PlanningTime, SeasonalWindow, TerrainOverlay, Weekday,
    WeekdaySet, apply_access_overlays, apply_access_overlays_at, apply_context_overlays,
    apply_terrain_overlays,
};
pub use raster::{ArcAsciiGrid, GeoTiffDem, RasterCrs, RasterDem, RasterTransform, VrtDem};
pub use route::{
    LOW_CONFIDENCE_THRESHOLD, Route, RouteMetrics, RouteShape, is_restricted_access, rank_routes,
};
pub use routing::{RouteRequest, RoutingWorkspace, WalkRealmIndex, WalkRouter};
pub use seed::{SeedRoute, artifact_key};
pub use trail::{
    DEFAULT_ROAD_AVERSION, RoutingLaw, SupportBinding, SupportInsertion, SupportPoint, Trail,
    TrailRealization, TrailReversal,
};

#[derive(Debug, thiserror::Error)]
pub enum TrailgenError {
    #[error("invalid geometry: {0}")]
    InvalidGeometry(String),
    #[error("invalid data: {0}")]
    InvalidData(String),
    #[error("support points realize {actual:?}, not {expected:?}")]
    ShapeMismatch {
        actual: RouteShape,
        expected: RouteShape,
    },
    #[error("this loop uses a one-way segment")]
    OneWayReversal,
    #[error("the reversed walk violates a turn restriction")]
    TurnRestrictedReversal,
    #[error("the reversed walk cannot be encoded as support points")]
    UnrepresentableReversal,
    #[error("unsupported format: {0}")]
    UnsupportedFormat(String),
    #[error("json error: {0}")]
    Json(#[from] serde_json::Error),
    #[error("xml error: {0}")]
    Xml(String),
}

pub type Result<T> = std::result::Result<T, TrailgenError>;