Enum ArcsecError 

#[non_exhaustive]
pub enum ArcsecError {
    Singular,
    InsufficientStars {
        found: usize,
        required: usize,
    },
    InsufficientQuads {
        found: usize,
        required: usize,
    },
    BadSolution {
        ratio: f64,
    },
    CatalogNotFound(PathBuf),
    CatalogIo(Error),
    InvalidParameter(String),
    Cancelled,
    IndexNotFound(PathBuf),
    OutsideSearchRadius {
        separation_deg: f64,
    },
}

Everything that can stop a solve.

The variants map onto the ASTAP-compatible exit codes the arcsec CLI returns (2 for too few stars, 1 for no solution, 32/33 for database problems), which is why “no match” is reported through ArcsecError::InsufficientQuads rather than a dedicated variant. New variants may be added, so match with a wildcard arm.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Singular

The least-squares system was singular (degenerate or too few points).

InsufficientStars

Fewer stars were detected than the solver needs.

Fields

found: usize

Stars actually detected.

required: usize

Minimum the solver requires.

InsufficientQuads

Pattern matching did not produce a verified solution.

Returned both when too few patterns could be built and when the search finished without any position verifying.

Fields

found: usize

Patterns (or, for the blind solver, verification score) achieved.

required: usize

Minimum required.

BadSolution

The plate fit is not a similarity transform: it stretches or shears the image by more than crate::math::lsq::MAX_PLATE_ANISOTROPY.

Fields

ratio: f64

Ratio of the larger to the smaller singular value of the plate’s linear part (crate::math::lsq::plate_anisotropy); 1 for a similarity.

CatalogNotFound(PathBuf)

The star database directory does not contain the named database.

CatalogIo(Error)

A catalogue or index file could not be read or parsed.

InvalidParameter(String)

A caller-supplied parameter is out of range (e.g. a non-positive field of view).

Cancelled

The solve was stopped through a crate::cancel::CancelToken.

IndexNotFound(PathBuf)

No blind index file was found at the given path.

OutsideSearchRadius

A blind index placed the field outside the search radius, where the radius-limited search cannot reach it. The field is not reported, as the radius requires; this is a “no solution” with a reason.

Fields

separation_deg: f64

Distance from the hint to the field the index found, degrees.

Trait Implementations

impl Debug for ArcsecError

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

Formats the value using the given formatter.

impl Display for ArcsecError

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

Formats the value using the given formatter.

impl Error for ArcsecError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for ArcsecError

fn from(e: Error) -> Self

Converts to this type from the input type.