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 aPhaseFunction— analytic, or tabulated frommietheory or anice-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_reflectanceis 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, withground_point_atto 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::brdf_reflectance;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
onnxfeature. - 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::RationalPolynomialCameraand 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§
- Onnx
Error - An ONNX load-or-run failure. Wraps the runtime’s message as a
Stringso the public surface never leakstracttypes (the model runtime behind this module can change without a breaking change).