Data Structures | |
| struct | CameraExifSettings |
| User-supplied exposure labels written to simulated-photo EXIF. More... | |
| struct | LensEffects |
| Engineering lens-distortion and lateral colour-scale parameters. More... | |
| struct | PiAiOptics |
| Nominal Pi AI Camera geometry used by the simulator rendering profile. More... | |
| class | CameraPlane |
| class | GreatSessionLease |
| Hold the per-user GREAT and live-PANGEA locks for one session update. More... | |
| class | ImageFraming |
| Produce a bounded crop/resample view over a source BGRA image. More... | |
| class | IniFile |
| Read scalar values from a bounded, section-based INI file. More... | |
| class | JpegStream |
| Convert one baseline JPEG into a row-major BGRA working raster. More... | |
| struct | MapConfig |
| Fully parsed settings shared by orthomap and XYZ export. More... | |
| class | MapExif |
| Serialize source-camera provenance and map-grid metadata for orthophotos. More... | |
| class | MapProgress |
| Thread-safe progress reporter for staged map work. More... | |
| struct | MapTile |
| Centre and pixel geometry for a projected image tile. More... | |
| class | MapProjection |
| Forward and inverse WGS-84 Transverse Mercator conversion for one UTM zone. More... | |
| class | MapResourcePressure |
| class | MapResources |
| Enforce the configured bounded-work policy for a survey process. More... | |
| class | StorageDescriptor |
| Own a working-file descriptor through success and exception paths. More... | |
| class | DiskRaster |
| Read bounded rectangular regions from a lossless BGRA disk raster. More... | |
| class | MapWriter |
| Create the georeferencing files paired with a rendered map image. More... | |
| struct | OrthoLayout |
| UTM-aligned extent and tile count for one requested map area. More... | |
| struct | OrthoSource |
| One fixed-session source image and its camera/pose evidence. More... | |
| struct | OrthoImage |
| Rendered BGRA map plus coverage, source list, and method provenance. More... | |
| class | Orthorectifier |
| Load a fixed-session source set and render its projected tiles/windows. More... | |
| struct | PhotoPosition |
| Photo location with AMSL camera and ground heights in metres. More... | |
| struct | PhotoCamera |
| Camera and timing provenance required for a simulated-photo EXIF record. More... | |
| class | PhotoExif |
| Build bounded EXIF payloads for simulator-generated source photos. More... | |
| struct | Point |
| Geographic route point; latitude/longitude are degrees and AGL is metres. More... | |
| struct | Config |
| Validated camera, route, simulator-startup, and output settings. More... | |
| class | CameraAltitude |
| Apply the route's chosen terrain-following or fixed-start altitude policy. More... | |
| class | Route |
| Evaluate a back-and-forth route at elapsed time. More... | |
| struct | UtcEvent |
| One simulator event/value pair used to set the Zulu clock. More... | |
| struct | UtcDateTime |
| A Gregorian UTC minute and its simulator clock-matching rules. More... | |
| struct | XyzPixels |
| Colour and confidence planes for one aligned XYZ working batch. More... | |
| struct | XyzRange |
| Inclusive rectangular tile range at one zoom level. More... | |
| class | XyzTiles |
| Convert Web-Mercator geographic coordinates to canonical XYZ addresses. More... | |
| struct | XyzPlan |
| Derive requested XYZ bounds, map grid, and per-zoom tile ranges. More... | |
Functions | |
| cv::Matx33d | cameraRotation (double roll, double pitch, double yaw) |
| Compose body attitude into the local camera-ray coordinate frame. | |
| std::string | sessionText (const fs::path &path) |
| Read a bounded regular session file without following symlinks. | |
| std::string | greatInputText (const MapConfig &config) |
| Snapshot the current accepted photo list for one GREAT revision. | |
| void | publishGreatLatest (const fs::path &root, const std::string &revision) |
| Atomically point latest at a completed, owned revision. | |
| bool | greatRevisionName (const std::string &name) |
| Validate a digest-based revision name and its preview/final suffix. | |
| static bool | updateGreatSession (const MapConfig &settings, const fs::path &ini, bool final, bool render=true) |
| Admit new photos and optionally publish a GREAT preview/final revision. | |
| void | validateJpegSize (int width, int height) |
| Validate encoded-image dimensions before allocating pixel buffers. | |
| void | validateJpegScanMessage (j_common_ptr state) |
| Apply the shared JPEG marker bounds to the current decoder state. | |
| bool | mosaicMode (const std::string &mode) |
| Return whether a supported processing mode uses the Great mosaic. | |
| void | mapMode (MapConfig &config, const std::string &mode) |
| Select one of the two supported processing modes and apply its defaults. | |
| std::string | mosaicRenderMethod (const std::string &method) |
| Give a stable descriptive name to a Great seam-and-blend renderer. | |
| std::filesystem::path | configPath (std::string text) |
| Normalize INI paths to the host filesystem's UTF-8 path parser. | |
| MapConfig | loadMapConfig (const std::filesystem::path &path, const std::string &modeOverride={}) |
| Load and validate a survey INI plus its capture manifest or source CSV. | |
| std::uint64_t | procMemory (const char *path, const char *key) |
| Read a named Linux memory counter and convert its KiB value to bytes. | |
| std::string | dataDigest (const void *data, std::size_t size) |
| Compute a lowercase SHA-256 digest for an in-memory byte range. | |
| std::string | fileDigest (const std::filesystem::path &path, const std::function< bool()> &stopped={}) |
| Hash a file in bounded chunks, optionally honoring cancellation. | |
| void | storageHeadroom (const std::filesystem::path &directory, std::uint64_t bytes) |
| Require requested free space plus a fixed safety reserve. | |
| void | publishWorkingFile (const std::filesystem::path &temporary, const std::filesystem::path &target, bool replace=true) |
| Fsync a completed working file, rename it, then sync its directory. | |
| void | saveWorkingText (const std::filesystem::path &target, const std::string &text) |
| Save checkpoint text through the durable working-file publisher. | |
| OrthoLayout | orthoLayout (const MapConfig &config) |
| Compute a north-up, non-overlapping image grid for the requested bounds. | |
| static cv::Mat | completeMosaicPyramid (const cv::Mat &premultiplied, unsigned workers, const std::function< bool()> &stopped) |
| Fill unsupported areas using a global push-pull colour pyramid. | |
| template<class Function> | |
| void | parallelRows (int rows, Function function, unsigned requested=4) |
| Apply a row operation in parallel without creating nested teams. | |
| std::string | trim (const std::string &text) |
| Strip the ASCII whitespace allowed around route INI tokens. | |
| double | number (const std::string &text, const std::string &name) |
| Read a complete finite numeric route field. | |
| void | range (double value, double minimum, double maximum, const std::string &name) |
| Enforce the inclusive policy bounds for a parsed setting. | |
| void | validateIvyAddress (const std::string &address) |
| Validate the syntax of an Ivy IPv4 bus endpoint. | |
| double | longitudeDelta (double start, double end) |
| Compute the shortest signed longitude change across the antimeridian. | |
| double | distance (const Point &a, const Point &b) |
| Estimate surface distance between two route points. | |
| Config | parseConfig (std::istream &input, const std::filesystem::path &base) |
| Parse and validate a route INI stream relative to a base directory. | |
| Config | loadConfig (const std::filesystem::path &path) |
| Open and parse a route configuration file. | |
| std::vector< OrthoSource > | readUsherSources (const MapConfig &config, const std::filesystem::path &manifest) |
| Read a photo snapshot and verify each source against profile/evidence. | |
| UtcDateTime | parseUtcDateTime (std::string_view text) |
| Parse a strict Gregorian UTC minute in YYYY-MM-DDTHH:MMZ form. | |
| UtcDateTime | utcMinuteFromAbsoluteTime (double actual) |
| Convert simulator calendar seconds to their containing UTC minute. | |
| bool | captureUtcReady (const UtcDateTime &target, double actual, double readAgeSeconds, unsigned long long verifiedFrame, unsigned long long frame, bool pending) |
| Decide whether simulator UTC is stable enough to admit a capture. | |
| bool | captureUtcSampleValid (const UtcDateTime &target, double actual, long long read100ns, long long frame100ns) |
| Validate that a frame's UTC readback is recent and in the locked second. | |
| bool | xyzCompleteCoverage (std::size_t valid) |
| Require every one of the tile's 256 x 256 output pixels to be supported. | |
| XyzPixels | renderXyzPixels (Orthorectifier &processor, const MapConfig &config, const OrthoLayout &layout, int zoom, std::uint64_t originX, std::uint64_t originY, int width, int height, const std::function< bool()> &stopped) |
| Resample an orthomosaic window onto one Web-Mercator pixel grid. | |
| XyzPixels | xyzOverview (const XyzPixels &input, unsigned workers, const std::function< bool()> &stopped) |
| Build one lower-zoom level from aligned 2 x 2 child pixels. | |
Variables | |
| unsigned | parallelRowsDepth = 0 |
| constexpr double | pi = 3.14159265358979323846 |
| constexpr double | earthRadius = 6371008.8 |
Function Documentation
◆ cameraRotation()
|
inline |
Compose body attitude into the local camera-ray coordinate frame.
- Parameters
-
[in] roll Body roll in degrees. [in] pitch Body pitch in degrees. [in] yaw Body yaw in degrees.
- Returns
- Rotation matrix for the supplied Euler angles.
Definition at line 40 of file camera_projection.h.
◆ captureUtcReady()
|
inline |
Decide whether simulator UTC is stable enough to admit a capture.
- Parameters
-
[in] target Requested UTC minute. [in] actual Latest simulator clock readback in absolute seconds. [in] readAgeSeconds Age of that readback in seconds. [in] verifiedFrame Frame number at which the target was last verified. [in] frame Current frame number. [in] pending Whether another time-setting event remains pending.
- Returns
- True only for a fresh matching readback after at least three frames.
Definition at line 185 of file utc_time.h.
◆ captureUtcSampleValid()
|
inline |
Validate that a frame's UTC readback is recent and in the locked second.
- Parameters
-
[in] target Requested UTC minute. [in] actual Simulator calendar time sampled for the frame. [in] read100ns Monotonic clock count when UTC was read. [in] frame100ns Monotonic clock count associated with the rendered frame.
- Returns
- True when the sample is ordered, less than one second old, and in target.
- Note
- Valid simulator-clock provenance does not imply exposure synchronization.
Definition at line 202 of file utc_time.h.
◆ completeMosaicPyramid()
|
static |
Fill unsupported areas using a global push-pull colour pyramid.
- Parameters
-
premultiplied Four-channel float overview with colour weighted by alpha. workers Worker count for row processing. stopped Cooperative cancellation predicate.
- Returns
- Completed four-channel float overview with alpha set to one.
Downsample weighted colour and support together; pull coarser estimates into gaps without introducing tile-local fill boundaries.
- Exceptions
-
std::runtime_error On invalid input, absent support, or cancellation.
Definition at line 366 of file ortho_map.cpp.
◆ configPath()
|
inline |
Normalize INI paths to the host filesystem's UTF-8 path parser.
Definition at line 113 of file map_config.h.
◆ dataDigest()
|
inline |
Compute a lowercase SHA-256 digest for an in-memory byte range.
Definition at line 77 of file map_storage.h.
◆ distance()
Estimate surface distance between two route points.
- Parameters
-
a First geographic position. b Second geographic position.
- Returns
- Spherical great-circle distance in metres, ignoring altitude.
Use haversine with a wrapped longitude delta. Clamp its argument so roundoff near antipodal points cannot invalidate the inverse sine.
◆ fileDigest()
|
inline |
Hash a file in bounded chunks, optionally honoring cancellation.
- Parameters
-
[in] path Input file. [in] stopped Optional cooperative cancellation predicate.
- Returns
- Lowercase SHA-256 digest.
- Exceptions
-
std::runtime_error If the file cannot be read or cancellation is requested.
Definition at line 89 of file map_storage.h.
◆ greatInputText()
|
inline |
Snapshot the current accepted photo list for one GREAT revision.
- Parameters
-
[in] config Session settings and either a source CSV or photo directory.
- Returns
- The accepted list plus newly arrived, sorted AI Camera basenames.
- Exceptions
-
std::runtime_error If the admission record, photo names, or row limit is invalid.
Existing rows remain a prefix; preserving their order is required for stable revision identity and deterministic checkpoint reuse.
Definition at line 108 of file great_session.h.
◆ greatRevisionName()
|
inline |
Validate a digest-based revision name and its preview/final suffix.
Definition at line 155 of file great_session.h.
◆ loadConfig()
|
inline |
◆ loadMapConfig()
|
inline |
Load and validate a survey INI plus its capture manifest or source CSV.
- Parameters
-
[in] path Configuration file path; relative inputs resolve beside it. [in] modeOverride Optional exact CLI mode override, applied before defaults.
- Returns
- A complete configuration whose source CSV exists and matches its contract.
- Exceptions
-
std::runtime_error For unknown settings, invalid values, inconsistent capture metadata, unsupported profile combinations, or missing inputs.
Definition at line 128 of file map_config.h.
◆ longitudeDelta()
|
inline |
◆ mapMode()
|
inline |
Select one of the two supported processing modes and apply its defaults.
- Parameters
-
[in,out] config Settings to update. [in] mode Exact supported name: simple or great.
- Exceptions
-
std::runtime_error If modeis not supported.
- Note
- Explicit INI values are loaded afterward and may override mode defaults.
Definition at line 91 of file map_config.h.
◆ mosaicMode()
|
inline |
Return whether a supported processing mode uses the Great mosaic.
Definition at line 80 of file map_config.h.
◆ mosaicRenderMethod()
|
inline |
Give a stable descriptive name to a Great seam-and-blend renderer.
Definition at line 108 of file map_config.h.
◆ number()
|
inline |
◆ orthoLayout()
| OrthoLayout pangea_survey::orthoLayout | ( | const MapConfig & | config | ) |
Compute a north-up, non-overlapping image grid for the requested bounds.
- Parameters
-
[in] config Validated geographic bounds, pixel size, and tile dimensions.
- Returns
- Projected bounds, EPSG code, and whole-tile row/column counts.
Definition at line 334 of file ortho_map.cpp.
◆ parallelRows()
| void pangea_survey::parallelRows | ( | int | rows, |
| Function | function, | ||
| unsigned | requested = 4 ) |
Apply a row operation in parallel without creating nested teams.
- Template Parameters
-
Function Callable accepting one zero-based row index.
- Parameters
-
[in] rows Number of rows to process; nonpositive values are a no-op. [in] function Independent work for each row. [in] requested Upper bound on workers; hardware availability and row count further reduce the team.
- Exceptions
-
Any exception thrown by function, rethrown after all workers stop.
Definition at line 48 of file parallel_rows.h.
◆ parseConfig()
|
inline |
Parse and validate a route INI stream relative to a base directory.
- Parameters
-
[in] input Readable INI stream. [in] base Directory used to resolve the output path.
- Returns
- Validated route and camera configuration.
- Exceptions
-
std::runtime_error If keys, units, bounds, or option combinations are invalid.
◆ parseUtcDateTime()
|
inline |
Parse a strict Gregorian UTC minute in YYYY-MM-DDTHH:MMZ form.
- Parameters
-
[in] text Candidate ASCII date/time.
- Returns
- Validated date/time preserving the canonical input string.
- Exceptions
-
std::invalid_argument If syntax or any calendar field is invalid.
Definition at line 115 of file utc_time.h.
◆ procMemory()
|
inline |
Read a named Linux memory counter and convert its KiB value to bytes.
- Parameters
-
[in] path procfs file containing the counter. [in] key Exact counter name, including its trailing colon.
- Returns
- Counter value in bytes.
- Exceptions
-
std::runtime_error If the counter is unavailable.
Definition at line 51 of file map_resources.h.
◆ publishGreatLatest()
|
inline |
Atomically point latest at a completed, owned revision.
- Parameters
-
[in] root Session output root. [in] revision Validated revision name beneath revisions/.
- Exceptions
-
std::runtime_error If staging, ownership checks, rename, or directory sync fails.
Definition at line 139 of file great_session.h.
◆ publishWorkingFile()
|
inline |
Fsync a completed working file, rename it, then sync its directory.
- Parameters
-
[in] temporary Completed sibling temporary file. [in] target Final checkpoint path on the same filesystem. replace True to rename over the target; false to publish without replacement.
- Exceptions
-
std::runtime_error If synchronization, rename, or directory access fails.
Definition at line 135 of file map_storage.h.
◆ range()
|
inline |
◆ readUsherSources()
|
inline |
Read a photo snapshot and verify each source against profile/evidence.
- Parameters
-
[in] config GREAT session settings, measured camera profile and source directory. [in] manifest Bounded USHER_AICAM_V1 filename snapshot.
- Returns
- Fully validated sources with camera geometry and capture provenance.
- Exceptions
-
std::runtime_error If any JPEG, EXIF field, profile, frame identity, pose qualification, or shared-coverage check fails.
Exposure-aligned pose is required unless configuration explicitly admits the recorded-pose approximation policy.
Definition at line 46 of file usher_sources.h.
◆ renderXyzPixels()
|
inline |
Resample an orthomosaic window onto one Web-Mercator pixel grid.
- Parameters
-
[in] processor Prepared source-photo mapper. [in] config Validated survey settings and worker budget. [in] layout UTM layout used by the mapper. [in] zoom XYZ zoom level. [in] originX Global XYZ pixel x coordinate of the output window's first pixel. [in] originY Global XYZ pixel y coordinate of the output window's first pixel. [in] width Output window width, at most 1024 pixels. [in] height Output window height, at most 1024 pixels. [in] stopped Cooperative cancellation predicate.
- Returns
- BGRA output and confidence for every resampled pixel.
- Exceptions
-
std::runtime_error If the footprint exceeds its bounded UTM window, projection fails, or cancellation is requested.
Definition at line 59 of file xyz_export.h.
◆ saveWorkingText()
|
inline |
Save checkpoint text through the durable working-file publisher.
Definition at line 158 of file map_storage.h.
◆ sessionText()
|
inline |
Read a bounded regular session file without following symlinks.
- Parameters
-
[in] path Session input, identity, or admission record.
- Returns
- Complete file contents, up to 4 MiB.
- Exceptions
-
std::runtime_error If the path is not a regular bounded file or reading fails.
Definition at line 76 of file great_session.h.
◆ storageHeadroom()
|
inline |
Require requested free space plus a fixed safety reserve.
- Parameters
-
[in] directory Filesystem on which work will be created. [in] bytes Estimated bytes needed by the next operation.
- Exceptions
-
std::runtime_error If free space cannot be queried or is insufficient.
Definition at line 121 of file map_storage.h.
◆ trim()
|
inline |
◆ updateGreatSession()
|
static |
Admit new photos and optionally publish a GREAT preview/final revision.
- Parameters
-
[in] settings Validated low-memory GREAT XYZ configuration. [in] ini Configuration whose content participates in session identity. [in] final True to require a closed photo list and finalize the session. [in] render False to prepare source/checkpoint state without rendering.
- Returns
- True when input was admitted or a revision was processed; false when no complete input row is available yet.
- Exceptions
-
std::runtime_error If session identity, append order, source contents, checkpoints, output coverage, or publication checks fail.
Definition at line 173 of file great_session.h.
◆ utcMinuteFromAbsoluteTime()
|
inline |
Convert simulator calendar seconds to their containing UTC minute.
- Parameters
-
[in] actual Finite, nonnegative simulator calendar seconds.
- Returns
- Canonical UTC minute containing
actual.
- Exceptions
-
std::runtime_error If the value lies outside years 0001 through 9999.
Definition at line 147 of file utc_time.h.
◆ validateIvyAddress()
|
inline |
◆ validateJpegScanMessage()
|
inline |
Apply the shared JPEG marker bounds to the current decoder state.
- Parameters
-
state Decoder reporting the marker.
Definition at line 44 of file jpeg_stream.h.
◆ validateJpegSize()
|
inline |
Validate encoded-image dimensions before allocating pixel buffers.
- Parameters
-
[in] width Image width in pixels. [in] height Image height in pixels.
- Exceptions
-
std::runtime_error If dimensions exceed per-axis or total-pixel bounds.
Definition at line 49 of file image_framing.h.
◆ xyzCompleteCoverage()
|
inline |
Require every one of the tile's 256 x 256 output pixels to be supported.
Definition at line 40 of file xyz_export.h.
◆ xyzOverview()
|
inline |
Build one lower-zoom level from aligned 2 x 2 child pixels.
- Parameters
-
[in] input Complete, even-sized child pixel batch. [in] workers Upper bound on row workers. [in] stopped Cooperative cancellation predicate.
- Returns
- Half-size overview; minimum child confidence propagates missingness.
- Exceptions
-
std::runtime_error If dimensions are not aligned or cancellation is requested.
Definition at line 138 of file xyz_export.h.
Variable Documentation
◆ earthRadius
◆ parallelRowsDepth
|
inlinethread_local |
Definition at line 36 of file parallel_rows.h.