Struct FeatureExtractor 

pub struct FeatureExtractor { /* private fields */ }

Feature extractor: backend + store writes.

Implementations

impl FeatureExtractor

pub fn new() -> Self

CPU backend.

pub fn with_backend(backend: Arc<dyn SiftEngine>) -> Self

Creates one with the given SIFT backend (e.g. GPU).

pub fn backend(&self) -> &dyn SiftEngine

SIFT backend in use.

pub fn extract_files( &self, store: &FeatureStore, root: &Path, names: &[String], opts: &ExtractionOptions, ) -> Result<Vec<ImageReport>>

Reads a file list (names relative to root) and adds them to the store. Names are processed in lexicographic order. With Existing(N), fails immediately if camera N does not exist. Per-image failures are recorded in the report.

pub fn extract_ordered( &self, store: &FeatureStore, root: &Path, items: &[(String, CameraMode)], opts: &ExtractionOptions, ) -> Result<Vec<ImageReport>>

Like FeatureExtractor::extract_files for images that each have their own camera mode (e.g. one position of a multi-camera rig: Existing(camera) per image), in the given order instead of sorted order: image rows are issued in that order (deterministic ids), then decoding and SIFT of all images run in parallel. Names are trimmed; empty and repeated names are dropped (the first one counts). Reports come back in the given order.

pub fn extract_inputs( &self, store: &FeatureStore, inputs: Vec<ImageSource>, opts: &ExtractionOptions, ) -> Result<Vec<ImageReport>>

Adds decoded images to the store (for per-position calls). Issues ids in lexicographic name order.

Trait Implementations

impl Clone for FeatureExtractor

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Default for FeatureExtractor

fn default() -> Self

Returns the “default value” for a type.