Struct Plan 

pub struct Plan {
    pub start: (f64, f64),
    pub has_hint: bool,
    pub arcsec_per_px: f64,
    pub scale_known: bool,
    pub fov_height: f64,
    pub binning: usize,
    pub image_size: (usize, usize),
    pub hfd_min_arcsec: f64,
    pub params: SolveParams,
    /* private fields */
}

A SolveRequest with every decision made, for an image of a given size.

Built by Plan::new without touching the pixels, so a caller can report what will happen (the CLI prints it, as ASTAP does) before Plan::solve runs.

Fields

start: (f64, f64)

Start of the search (RA, Dec), radians: the hint, or (0, 0).

has_hint: bool

Whether the request had a hint.

arcsec_per_px: f64

Pixel scale of the unbinned image, arcseconds per pixel.

scale_known: bool

Whether the scale came from the request rather than the 1″/px fallback.

fov_height: f64

Field of view along the image height, radians.

binning: usize

Binning factor the image is solved at.

image_size: (usize, usize)

Unbinned image size, pixels.

hfd_min_arcsec: f64

Minimum star size, arcseconds (as requested).

params: SolveParams

The catalogue solve’s parameters: the start, the field along the longer side, the database, and the minimum HFD in binned pixels.

Implementations

impl Plan

pub fn new(req: &SolveRequest, width: usize, height: usize) -> Result<Self>

Make every decision for a width × height image (unbinned).

Errors

ArcsecError::InvalidParameter for an empty image or a field of view or pixel scale that is not positive and finite.

pub fn binned_size(&self) -> (usize, usize)

Size of the image as solved, after binning.

pub fn solve(&self, img: &ImageBuffer) -> Result<Solved>

Solve img, the unbinned image this plan was made for, with its pixels already normalised (ImageBuffer::normalize_for_detection).

Errors

Everything solve_image returns, and:

• ArcsecError::InvalidParameter if img is not the size planned for;
• ArcsecError::InsufficientStars if the binned image is too small;
• ArcsecError::IndexNotFound if SolveRequest::index names nothing;
• ArcsecError::OutsideSearchRadius if an index found the field beyond the search radius;
• ArcsecError::Cancelled if the request’s token fired.

pub fn solve_with( &self, img: &ImageBuffer, on_event: impl FnMut(Event), ) -> Result<Solved>

Plan::solve, reporting Events to on_event as they happen.

Errors

As Plan::solve.

Trait Implementations

impl Clone for Plan

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Plan

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

Formats the value using the given formatter.