Skip to main content

Crate spacelab_earthvision

Crate spacelab_earthvision 

Source
Expand description

earthvision — Earth-observation foundations, the first Phase-8 line.

Two building blocks that sit under every optical remote-sensing pipeline:

  • observation_geometry — the sun/sensor angles (solar and view zenith, relative azimuth, scattering angle, air mass) that drive atmospheric correction and surface-BRDF inversion. The satellite tells you where it looked; these tell you how the light arrived.
  • monte_carlo_slab — a photon Monte Carlo of radiative transfer through a plane-parallel scattering-and-absorbing atmosphere (Marchuk’s method), returning the layer’s reflectance, transmittance and absorptance. This is the path-radiance / atmospheric-correction core: what fraction of sunlight is scattered back to space, reaches the surface, or is absorbed. What a scattering event does is a PhaseFunction — analytic, or tabulated from mie theory or an ice-crystal ray trace, which is what lets cirrus scatter like cirrus rather than like a one-parameter fit with no halo in it. Those three are flux fractions, over the whole hemisphere; path_reflectance is the same layer seen down one line of sight, by next-event estimation — which is what a sensor measures, and what the 6S path-reflectance term means.
  • swath_geometry — the sensor’s ground reach: from an off-nadir look angle, the Earth-central angle, elevation, ground and slant ranges of the footprint edge, with ground_point_at to trace footprint circles and ground tracks. The where it looked the two above take as given.

no_std + libm, deterministic (a seeded xoshiro256** stream), no external dependencies.

Re-exports§

pub use atmospheric_correction::AtmosphericCoupling;
pub use atmospheric_correction::CorrelatedKCoupling;
pub use atmospheric_correction::brdf_reflectance;
pub use atmospheric_correction::correlated_k_coupling;
pub use atmospheric_correction::coupling_from_slab;
pub use atmospheric_correction::coupling_from_stack;
pub use atmospheric_correction::li_sparse_reciprocal_kernel;
pub use atmospheric_correction::ross_thick_kernel;
pub use camera::Observation;
pub use camera::OutlierScale;
pub use camera::PinholeCamera;
pub use camera::bundle_adjust;
pub use camera::bundle_adjust_robust;
pub use camera::ransac_resection;
pub use camera::resection;
pub use camera::triangulate;
pub use features::Corner;
pub use features::FeatureMatch;
pub use features::HarrisConfig;
pub use features::Image;
pub use features::NccConfig;
pub use features::detect_corners;
pub use features::harris_response;
pub use features::match_ncc;
pub use gas::GasError;
pub use gas::KDistribution;
pub use gas::gas_optical_depths;
pub use gas::gas_optical_depths_binned;
pub use geometry::ObservationGeometry;
pub use geometry::air_mass;
pub use geometry::observation_geometry;
pub use ice::GeometricOptics;
pub use ice::HexagonalCrystal;
pub use ice::MAX_LOBE_PANELS;
pub use ice::RayTracingOptics;
pub use ice::add_diffraction;
pub use ice::diffraction_on_grid;
pub use ice::trace_on_grid;
pub use mie::BulkOptics;
pub use mie::Complex;
pub use mie::SizeDistribution;
pub use mvs::plane_sweep_mvs;
pub use ortho::DemGrid;
pub use ortho::MapGrid;
pub use ortho::SourceTile;
pub use ortho::orthorectify;
pub use ortho::orthorectify_point;
pub use ortho::ray_dem_intersection;
pub use ortho::sample_bilinear;
pub use pansharpen::brovey_pan_sharpen;
pub use pansharpen::gram_schmidt_pan_sharpen;
pub use phase::PhaseError;
pub use phase::PhaseFunction;
pub use phase::TabulatedPhase;
pub use phase::tabulate_legendre;
pub use phase::tabulate_mie;
pub use radiative_transfer::Atmosphere;
pub use radiative_transfer::Layer;
pub use radiative_transfer::MAX_LAYERS;
pub use radiative_transfer::SlabResult;
pub use radiative_transfer::monte_carlo_slab;
pub use radiative_transfer::monte_carlo_stack;
pub use radiative_transfer::path_reflectance;
pub use radiative_transfer::stack_path_reflectance;
pub use rpc::GroundPoint;
pub use rpc::InverseError;
pub use rpc::RationalPolynomialCamera;
pub use rpc_adjust::AdjustmentModel;
pub use rpc_adjust::GroundControlPoint;
pub use rpc_adjust::RpcAdjustment;
pub use rpc_adjust::adjustment_residual_rms;
pub use rpc_adjust::estimate_adjustment;
pub use rpc_adjust::forward_adjusted;
pub use sfm::Observation2d;
pub use sfm::Track;
pub use sfm::build_tracks;
pub use sfm::triangulate_tracks;
pub use stereo::DIRECTIONS_4;
pub use stereo::DIRECTIONS_8;
pub use stereo::SgmConfig;
pub use stereo::aggregate_sgm;
pub use stereo::census_cost_volume;
pub use stereo::depth_from_disparity;
pub use stereo::disparity_wta;
pub use stereo::semi_global_match;
pub use swath::SwathGeometry;
pub use swath::ground_point_at;
pub use swath::horizon_look_angle;
pub use swath::swath_geometry;
pub use cloud::CloudMasker;
pub use cloud::Footprint;
pub use cloud::SwathLine;
pub use cloud::usable_footprints;

Modules§

atmospheric_correction
Atmospheric correction (TOA → surface reflectance) and a kernel-driven surface BRDF.
camera
Frame-camera photogrammetry — the multi-view-geometry backbone: pinhole projection, space resection, space intersection, and sparse bundle adjustment with the Schur-complement reduced camera system.
cloud
Cloud masking and swath-footprint filtering — the onboard Earth-observation decision layer, behind the opt-in onnx feature.
features
The feature front-end of a photogrammetric pipeline — Harris corner detection and normalised cross-correlation matching — that turns image pairs into the tie-point correspondences bundle adjustment consumes.
gas
Gaseous band absorption as a k-distribution, and how it composes with the scattering slab.
geometry
Earth-observation viewing geometry — the sun/sensor angles atmospheric correction and BRDF need.
ice
Hexagonal ice crystals by geometric-optics ray tracing — the phase function with halos in it.
image_quality
Image quality — the numbers an imaging contract is actually written in.
mie
Mie scattering by a size distribution of homogeneous spheres.
mvs
Dense multi-view stereo by plane sweeping — the depth map behind a photogrammetric DSM, from a reference view and one or more calibrated neighbours.
ortho
Orthorectification — reprojecting a satellite image onto a map grid over terrain, using an crate::rpc::RationalPolynomialCamera and a digital elevation model.
pansharpen
Pan-sharpening — fusing a high-resolution panchromatic band with low-resolution multispectral bands to synthesise high-resolution colour, by component substitution.
phase
Scattering phase functions: what a single scattering event does to a photon’s direction.
radiative_transfer
Monte Carlo radiative transfer through a plane-parallel atmosphere (Marchuk’s method).
rpc
Rational Polynomial Camera (RPC00B) — the replacement sensor model optical satellites ship instead of a physical pushbroom model.
rpc_adjust
RPC bias compensation by block adjustment (Grodecki & Dial 2003) — correcting the systematic error of a vendor RPC with a small image-space affine, estimated from ground control.
sfm
Structure-from-motion feature tracks — the multi-view correspondence graph that turns pairwise matches into the point tracks bundle adjustment optimises.
stereo
Dense stereo matching by Semi-Global Matching (SGM, Hirschmüller 2008) — the disparity engine behind a stereo DSM (digital surface model).
swath
Sensor swath and ground-footprint geometry — where on the Earth a satellite looks.

Structs§

OnnxError
An ONNX load-or-run failure. Wraps the runtime’s message as a String so the public surface never leaks tract types (the model runtime behind this module can change without a breaking change).