Loading...
Searching...
No Matches
coverage_scheduler.h
Go to the documentation of this file.
37#define COVERAGE_CANDIDATES 4 /**< Bounded lookahead set, not a queue of retained image pixels. */
38#define COVERAGE_SCAN_LIMIT 4096 /**< Maximum cells per footprint scan, limiting decision work. */
44 double mount_roll_deg, mount_pitch_deg, mount_yaw_deg; /**< Camera-to-body rotation, degrees, Rz*Ry*Rx. */
47 * @brief Delivered width in pixels; must agree with the saved image, not the sensor mode alone. */
60 double latitude_deg, longitude_deg, agl_m; /**< Geographic degrees and height above the local ground plane. */
61 double roll_deg, pitch_deg, yaw_deg; /**< Body attitude in degrees using the USHER/PANGEA convention. */
62 double uncertainty_m; /**< Nonnegative ground-position margin; not a statistical confidence level. */
80 struct coverage_point corner[4]; /**< Cyclic vertices, either winding; never a crossed polygon. */
85 struct coverage_footprint footprint; /**< Predicted or saved footprint, according to the caller's operation. */
86 uint64_t ready_us, deadline_us; /**< Earliest/latest start in the caller's monotonic microsecond domain. */
87 unsigned camera_id; /**< One-based image-camera identity; coverage is never shared between sensors. */
94 double origin_east, origin_north, cell_m; /**< Grid lower corner and cell edge, all in metres. */
95 uint8_t saved[COVERAGE_CAMERAS][COVERAGE_SIDE * COVERAGE_SIDE]; /**< Best committed detail per camera and cell. */
125bool coverage_project_pixel(const struct coverage_camera *camera, const struct coverage_pose *pose,
141double coverage_gain(const struct coverage_state *state, const struct coverage_candidate *candidate);
145 * @return True for a valid bounded update, even if no cells improve; false for unknown geometry.
155bool coverage_wholly_saved(const struct coverage_state *state, const struct coverage_candidate *candidate);
163double coverage_overlap(const struct coverage_state *state, const struct coverage_candidate *first,
176int coverage_choose(const struct coverage_state *state, const struct coverage_candidate *candidates,
double coverage_gain(const struct coverage_state *state, const struct coverage_candidate *candidate)
Score additional detail in conservatively contained cells without mutation.
Definition coverage_scheduler.c:199
bool coverage_commit(struct coverage_state *state, const struct coverage_candidate *candidate)
Credit a successfully saved observation, retaining the best detail per cell.
Definition coverage_scheduler.c:204
bool coverage_init(struct coverage_state *state, double east, double north, double cell_m)
Clear the ledger and set its fixed spatial domain.
Definition coverage_scheduler.c:105
bool coverage_project(const struct coverage_camera *camera, const struct coverage_pose *pose, double origin_latitude_deg, double origin_longitude_deg, struct coverage_footprint *footprint)
Project delivered-image corners onto a local flat ground plane.
Definition coverage_scheduler.c:46
int coverage_choose(const struct coverage_state *state, const struct coverage_candidate *candidates, size_t count, uint64_t now_us, uint64_t service_us)
Choose the first observation of the best feasible one- or two-shot plan.
Definition coverage_scheduler.c:218
bool coverage_wholly_saved(const struct coverage_state *state, const struct coverage_candidate *candidate)
Check whether skipping this observation is geometrically conservative.
Definition coverage_scheduler.c:252
bool coverage_project_pixel(const struct coverage_camera *camera, const struct coverage_pose *pose, double column, double row, struct coverage_point *offset)
Project an image pixel onto the same ground plane as the coverage footprint.
Definition coverage_scheduler.c:88
double coverage_overlap(const struct coverage_state *state, const struct coverage_candidate *first, const struct coverage_candidate *second)
Estimate conservative overlap for deciding whether a delay is acceptable.
Definition coverage_scheduler.c:269
Measured pinhole calibration for the delivered image, including its mount.
Definition coverage_scheduler.h:41
double mount_roll_deg
Camera-to-body roll in degrees; mounting is applied before aircraft attitude.
Definition coverage_scheduler.h:44
double mount_pitch_deg
Camera-to-body pitch in degrees, using the same convention as PANGEA.
Definition coverage_scheduler.h:44
unsigned width
Delivered width in pixels; must agree with the saved image, not the sensor mode alone.
Definition coverage_scheduler.h:42
One feasible observation; deadlines constrain acquisition start, not saving.
Definition coverage_scheduler.h:84
uint64_t ready_us
Earliest acquisition start; all candidates must share a monotonic time domain.
Definition coverage_scheduler.h:86
Convex ground quadrilateral with a conservative boundary margin.
Definition coverage_scheduler.h:79
Local ground coordinates in metres, east and north of the projection origin.
Definition coverage_scheduler.h:73
double north
Metres north of the shared local geographic reference.
Definition coverage_scheduler.h:73
Pose estimate and its positional margin for a single observation.
Definition coverage_scheduler.h:59
double latitude_deg
Observation latitude in geographic degrees, not FC fixed-point units.
Definition coverage_scheduler.h:60
Fixed coverage ledger; zero cells are unknown, not necessarily unphotographed.
Definition coverage_scheduler.h:93
uint8_t saved[COVERAGE_CAMERAS][COVERAGE_SIDE *COVERAGE_SIDE]
Definition coverage_scheduler.h:95
double origin_north
Lower north grid edge in metres relative to the projection origin.
Definition coverage_scheduler.h:94
double origin_east
Lower east grid edge in metres relative to the projection origin.
Definition coverage_scheduler.h:94