Struct DatasetRegistry 

pub struct DatasetRegistry {
    pub odometry: HashMap<String, OdometryEntry>,
    pub bundle_adjustment: HashMap<String, BaEntry>,
}

The complete dataset registry, parsed from datasets.toml.

Fields

odometry: HashMap<String, OdometryEntry>

Odometry datasets keyed by short name (e.g. "sphere2500", "intel").

bundle_adjustment: HashMap<String, BaEntry>

Bundle adjustment datasets keyed by collection name (e.g. "ladybug").

Implementations

impl DatasetRegistry

pub fn load() -> Result<Self>

Load the registry from the compile-time embedded datasets.toml.

Errors

Returns an error only if datasets.toml is malformed TOML — a developer error that should never occur with the bundled file.

pub fn odometry_path(&self, name: &str) -> Option<PathBuf>

Returns the on-disk path for an odometry dataset, including its category subdirectory.

Returns None if name is not in the registry.

Example

use apex_io::DatasetRegistry;
let reg = DatasetRegistry::load()?;
assert_eq!(
    reg.odometry_path("intel"),
    Some(std::path::Path::new("data/odometry").join("2d").join("intel.g2o"))
);

pub fn odometry_by_category( &self, category: &str, ) -> Vec<(&str, &OdometryEntry)>

Returns all odometry entries with the given category ("2d" or "3d"), sorted alphabetically by name for deterministic output.

pub fn ba_path(&self, name: &str, cameras: u32, points: u32) -> Option<PathBuf>

Returns the on-disk path for a specific BA problem file.

The path follows the same layout the downloader creates: data/bundle_adjustment/{name}/problem-{cameras}-{points}-pre.txt

Returns None if name is not in the registry.

pub fn ba_sorted(&self) -> Vec<(&str, &BaEntry)>

Returns all bundle adjustment entries sorted alphabetically by name.

Trait Implementations

impl Debug for DatasetRegistry

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for DatasetRegistry

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.