brushline.monitoring.mission
Corridor-graph UAV/LiDAR mission simulation.
- class brushline.monitoring.mission.MissionConfig(*, start_node_id: Annotated[str, MinLen(min_length=1)], endurance_minutes: Annotated[float, Gt(gt=0)] = 45, speed_m_per_min: Annotated[float, Gt(gt=0)] = 300, sensor_footprint_m: Annotated[float, Gt(gt=0)] = 50, cost_per_minute: Annotated[float, Ge(ge=0)] = 5, fixed_cost: Annotated[float, Ge(ge=0)] = 100)[source]
Bases:
BaseModelMission settings.
- Parameters:
start_node_id (str) – Start node.
endurance_minutes (float) – Flight endurance.
speed_m_per_min (float) – Travel speed.
sensor_footprint_m (float) – Sensor footprint radius.
cost_per_minute (float) – Flight cost.
fixed_cost (float) – Fixed mission cost.
- model_config = {'extra': 'forbid', 'frozen': True}
Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].
- class brushline.monitoring.mission.MissionEdge(*, start_id: Annotated[str, MinLen(min_length=1)], end_id: Annotated[str, MinLen(min_length=1)], length_m: Annotated[float, Gt(gt=0)])[source]
Bases:
BaseModelOne undirected corridor-graph edge.
- Parameters:
start_id (str) – Start node.
end_id (str) – End node.
length_m (float) – Length.
- model_config = {'extra': 'forbid', 'frozen': True}
Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].
- exception brushline.monitoring.mission.MissionError[source]
Bases:
ValueErrorRaised when a mission input is inconsistent.
- class brushline.monitoring.mission.MissionNode(*, node_id: Annotated[str, MinLen(min_length=1)], x_m: float, y_m: float)[source]
Bases:
BaseModelOne corridor-graph node.
- Parameters:
node_id (str) – Node id.
x_m (float) – X coordinate.
y_m (float) – Y coordinate.
- model_config = {'extra': 'forbid', 'frozen': True}
Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].
- class brushline.monitoring.mission.MissionPlan(*, schema_version: Literal['brushline.monitoring-mission.v1'] = 'brushline.monitoring-mission.v1', plan_id: str, request_id: str, node_order: list[str], covered_node_ids: list[str], route_length_m: Annotated[float, Ge(ge=0)], flight_minutes: Annotated[float, Ge(ge=0)], cost: Annotated[float, Ge(ge=0)], feasible: bool, reason: str, created_utc: datetime)[source]
Bases:
BaseModelA feasible or blocked mission.
- Parameters:
schema_version ({"brushline.monitoring-mission.v1"}) – Schema version.
plan_id (str) – Plan id.
request_id (str) – Request id.
node_order (list of str) – Visited node order.
covered_node_ids (list of str) – Covered nodes.
route_length_m (float) – Route length.
flight_minutes (float) – Flight time.
cost (float) – Cost.
feasible (bool) – Endurance/weather/route feasibility.
reason (str) – Explanation.
created_utc (datetime) – Timezone-aware time.
- model_config = {'extra': 'forbid', 'frozen': True}
Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].
- class brushline.monitoring.mission.MissionRequest(*, request_id: Annotated[str, MinLen(min_length=1)], required_node_ids: Annotated[list[str], MinLen(min_length=1)], weather_open: bool = True)[source]
Bases:
BaseModelA monitor mission request.
- Parameters:
request_id (str) – Request id.
required_node_ids (list of str) – Nodes that must be covered.
weather_open (bool) – Whether the weather window is open.
- model_config = {'extra': 'forbid', 'frozen': True}
Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].
- brushline.monitoring.mission.build_mission_plan(*, plan_id: str, nodes: list[MissionNode], edges: list[MissionEdge], request: MissionRequest, config: MissionConfig, created_utc: datetime | None = None) MissionPlan[source]
Build a deterministic nearest-neighbour mission and check feasibility.
- Parameters:
plan_id (str) – Plan id.
nodes (list of MissionNode) – Nodes.
edges (list of MissionEdge) – Edges.
request (MissionRequest) – Request.
config (MissionConfig) – Settings.
created_utc (datetime, optional) – Creation time.
- Returns:
MissionPlan – Mission plan.