Struct FitsSlice 

pub struct FitsSlice { /* private fields */ }

A FITS file read from a buffer rather than from the filesystem.

This is the reader to use where there is no filesystem to read from — a file already in memory, one arriving over a network, or a build with the fs feature turned off.

Implementations

impl FitsSlice

pub fn from_slice(data: &[u8]) -> Result<Self, Box<dyn Error + Send + Sync>>

Reads a FITS file out of data.

The buffer is copied once, because the HDUs read from it for as long as they live and cannot borrow from the caller’s slice. Use FitsSlice::from_vec to hand over a buffer instead of copying one.

pub fn from_vec(data: Vec<u8>) -> Result<Self, Box<dyn Error + Send + Sync>>

Reads a FITS file out of data, taking ownership of the buffer.

A buffer that holds gzip-compressed data is decompressed first. A FITS file starts with SIMPLE, so it can never be mistaken for one that starts with the gzip marker.

pub async fn from_vec_async( data: Vec<u8>, ) -> Result<Self, Box<dyn Error + Send + Sync>>

Available on crate feature tokio only.

Reads a FITS file out of data without blocking the async runtime.

Parsing a large buffer is real work even though it touches no filesystem, so it runs on a blocking worker, as FsFits::open_async does.

pub fn new() -> Self

An empty FITS file, for building one from nothing.

Trait Implementations

impl Clone for FitsSlice

fn clone(&self) -> FitsSlice

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FitsSlice

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

Formats the value using the given formatter.

impl Default for FitsSlice

fn default() -> Self

Returns the “default value” for a type.

impl Fits for FitsSlice

type ImageHDU = SliceImageHDU

The kind of image HDU this reader produces.

type BinTableHDU = SliceBinTableHDU

The kind of binary table HDU this reader produces.

type AsciiTableHDU = SliceAsciiTableHDU

The kind of ASCII table HDU this reader produces.

fn primary_hdu(&self) -> &Self::ImageHDU

The primary HDU, which every FITS file has.

fn primary_hdu_mut(&mut self) -> &mut Self::ImageHDU

The primary HDU, to be changed.

fn extension_count(&self) -> usize

How many extensions follow the primary HDU.

fn extension_hdu(&self, index: usize) -> Option<&ExtensionHDU<Self>>

The extension at index, or None if there is none.

fn extension_hdu_mut(&mut self, index: usize) -> Option<&mut ExtensionHDU<Self>>

The extension at index, to be changed.

fn extension_hdus(&self) -> impl Iterator<Item = &ExtensionHDU<Self>>

Every extension, in the order they appear in the file.

fn extension_hdus_mut( &mut self, ) -> impl Iterator<Item = &mut ExtensionHDU<Self>>

Every extension, to be changed.

fn push_extension(&mut self, extension: ExtensionHDU<Self>)

Appends an extension after the ones already here.

fn remove_extension(&mut self, index: usize) -> Option<ExtensionHDU<Self>>

Removes the extension at index, or returns None if there is none.

fn to_vec(&self) -> Result<Vec<u8>, Box<dyn Error + Send + Sync>>

Serialises this FITS file back into its on-disk byte representation.