Enum FitsError 

pub enum FitsError {
    Io(Error),
    InvalidKeyword {
        name: String,
    },
    InvalidValue {
        card: String,
    },
    InvalidBitpix {
        code: i64,
    },
    MissingEnd,
    MissingKeyword {
        name: &'static str,
    },
    KeywordOutOfRange {
        name: &'static str,
    },
    UnexpectedEof,
    DataUnitOverflow,
    DataUnitTooLarge {
        bytes: usize,
    },
    DataSizeMismatch {
        expected: usize,
        got: usize,
    },
    HduIndexOutOfBounds {
        index: usize,
        len: usize,
    },
    NotAnImage,
    ImageHasGroups,
    NotABinTable,
    NotRandomGroups,
    NotAnAsciiTable,
    NotCompressedImage,
    NotCompressedTable,
    ConflictingWcsKeywords {
        detail: &'static str,
    },
    UnsupportedCompression {
        name: String,
    },
    InvalidTform {
        tform: String,
    },
    VariableLengthColumn {
        code: char,
    },
    NotAVla {
        code: char,
    },
    NotABitColumn {
        code: char,
    },
    NotAComplexColumn {
        code: char,
    },
    NonNumericColumn {
        code: char,
    },
    ColumnIndexOutOfBounds {
        index: usize,
        len: usize,
    },
    ColumnNotFound {
        name: String,
    },
    RowWidthMismatch {
        computed: usize,
        declared: usize,
    },
    TileShapeRankMismatch {
        tile_rank: usize,
        image_rank: usize,
    },
}

Variants

Io(Error)

InvalidKeyword

A keyword name violated the FITS character set or 8-byte length limit.

Fields

name: String

InvalidValue

A card’s value field could not be parsed as any FITS value type.

Fields

card: String

InvalidBitpix

BITPIX held a value outside {8, 16, 32, 64, −32, −64}.

Fields

code: i64

MissingEnd

A header unit ended (ran out of cards) without an END record.

MissingKeyword

A mandatory keyword was absent where the structure requires it.

Fields

name: &'static str

KeywordOutOfRange

A keyword was present and well-typed but its value lies outside the range the standard permits for its role (e.g. NAXIS > 999, PCOUNT < 0, GCOUNT < 1, a negative axis length, or a THEAP that precedes the heap).

Fields

name: &'static str

UnexpectedEof

The byte stream ended in the middle of a header or data unit.

DataUnitOverflow

The data-unit size implied by the header overflows a 64-bit byte count (a malformed or hostile header with absurd NAXISn/PCOUNT/GCOUNT).

DataUnitTooLarge

The data-unit size implied by the header is non-overflowing but too large to allocate — a malformed or hostile header declaring an absurd (yet in-range) NAXISn/ZNAXISn/ZNAXIS2. The output buffer is allocated fallibly (try_reserve), so this surfaces as a recoverable error rather than an out-of-memory process abort.

Fields

bytes: usize

DataSizeMismatch

A decoded data unit held a different element count than the header’s declared geometry — a corrupt or truncated data unit.

Fields

expected: usize

got: usize

HduIndexOutOfBounds

A data-unit read named an HDU index beyond the parsed sequence.

Fields

index: usize

len: usize

NotAnImage

read_image was called on an HDU that is not an image array (a table, random-groups, or unmodelled extension).

ImageHasGroups

An IMAGE/primary HDU carries group structure (PCOUNT ≠ 0 or GCOUNT ≠ 1), which a plain image array must not have (§4.3).

NotABinTable

read_table was called on an HDU that is not a binary table.

NotRandomGroups

read_groups was called on an HDU that is not a random-groups primary.

NotAnAsciiTable

read_ascii_table was called on an HDU that is not an ASCII table.

NotCompressedImage

The decompressor was handed an HDU that is not a tiled-compressed image (no ZIMAGE = T). read_image guards this and returns FitsError::NotAnImage for a plain BINTABLE, so this surfaces only via the internal decode path.

NotCompressedTable

read_compressed_table was called on an HDU that is not a tiled-compressed table (no ZTABLE = T).

ConflictingWcsKeywords

Two mutually-exclusive WCS keyword conventions are both present (e.g. PC and CD, or CROTA and PC); a conforming header uses only one (§8).

Fields

detail: &'static str

UnsupportedCompression

A tiled-image compression algorithm or variant is not yet supported.

Fields

name: String

InvalidTform

A TFORMn value could not be parsed as a binary-table column format.

Fields

tform: String

VariableLengthColumn

ColumnReader::raw was called on a variable-length-array (P/Q) column; use ColumnReader::vla instead.

Fields

code: char

NotAVla

ColumnReader::vla was called on a fixed-width column.

Fields

code: char

NotABitColumn

ColumnReader::bits was called on a column that is not an X bit array.

Fields

code: char

NotAComplexColumn

ColumnReader::complex was called on a column that is not C/M complex.

Fields

code: char

NonNumericColumn

ColumnReader::physical was called on a column with no numeric physical value (A/L/X/C/M).

Fields

code: char

ColumnIndexOutOfBounds

A column index named a field beyond the table’s column list.

Fields

index: usize

len: usize

ColumnNotFound

No column with the requested TTYPEn name exists in the table.

Fields

name: String

RowWidthMismatch

The summed column widths disagree with the declared row width (NAXIS1).

Fields

computed: usize

declared: usize

TileShapeRankMismatch

A requested compression tile shape has a different rank (axis count) than the image it tiles. Pass an empty shape for the default row-tiling instead.

Fields

tile_rank: usize

image_rank: usize

Trait Implementations

impl Debug for FitsError

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

Formats the value using the given formatter.

impl Display for FitsError

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

Formats the value using the given formatter.

impl Error for FitsError

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 FitsError

fn from(e: Error) -> Self

Converts to this type from the input type.