Coverage Analysis¶

Coverage Analysis evaluates when selected assets can access a set of geographic points or cells. It is used to answer questions such as:

Which regions are observed?
How much total access time does each grid point receive?
Which grid points have no access?
How does coverage change across an AOI or global grid?

Inputs¶

Input	Description
Selected assets	Spacecraft, sensors, or other endpoints that act as coverage sources.
AOI type	Global, bounding box, or selected Area of Interest.
Grid granularity	Angular spacing in degrees for generated points.
Altitude	Grid point altitude in km.
Time step	Coarse sampling step in seconds.
Access settings	Bisection, tolerance, minimum access duration, computation mode.
Visualization settings	Grid points, filled area, static and dynamic colors, translucency.

Grid Concept¶

flowchart LR
    A["AOI / bounds"] --> G["CoverageGridBuilder"]
    G --> P["Grid points"]
    G --> C["Grid cells"]
    P --> E["Access endpoints"]
    E --> R["Coverage intervals"]
    R --> S["Scalar field"]

Processing Pipeline¶

Resolve selected assets.
Build grid points and cells from AOI or latitude/longitude bounds.
Convert grid points to access endpoints.
Run the vectorized access engine.
Store intervals per grid point.
Build scalar field values, usually duration-based.
Expose outputs to heat maps, reports, and dynamic viewer layers.

Main Configuration Parameters¶

Field	Meaning
`aoi_type`	Coverage region source.
`selected_aoi_guids`	AOIs referenced by the analysis.
`selected_asset_guids`	Coverage source assets.
`time_step_s`	Coarse access sampling step.
`point_granularity_deg`	Grid spacing.
`altitude_km`	Grid point altitude.
`min_latitude`, `max_latitude`	Latitude bounds.
`min_longitude`, `max_longitude`	Longitude bounds.
`use_bisection`	Enables boundary refinement.
`time_tolerance_s`	Boundary refinement tolerance.
`min_access_duration_s`	Removes very short access intervals.

Outputs¶

Output	Description
`coverage_by_point`	Mapping from grid point index to interval sets.
`grid_scalar_field`	Scalar values for heat map style plotting.
`union_intervals_by_point`	Unioned access windows per point.
`durations_by_point`	Duration summaries per point.
`grid_points`	Geographic grid point list.
`grid_cells`	Optional cell polygons for filled visualization.
`access_meta`	Source count, timeline size, and service metadata.

Interpretation¶

Coverage results are strongly affected by time step, FoV, constraints, and AOI granularity. A coarse time step may miss short accesses. A very fine grid may increase computation time. A good workflow is to start coarse, validate geometry, then refine step and grid spacing.