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: BaseModel

Mission 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: BaseModel

One 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: ValueError

Raised 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: BaseModel

One 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: BaseModel

A 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: BaseModel

A 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:
Returns:

MissionPlan – Mission plan.