Crate fitrs

Library to parse FITS file written in pure rust.

Uses only one dependency, byteorder, to deal with endianness.

Uses intelligent cache to parse big FITS files. Developed for use in multi-threaded environments.

How to use

Read FITS

extern crate fitrs;
use fitrs::{Fits, FitsData, FitsDataArray};

let fits = Fits::open("path/to/fits/file.fits").expect("Failed to open");
// Iterate over HDUs
for hdu in fits.iter() {
    println!("{:?}", hdu.value("EXTNAME"));
    println!("{:?}", hdu.read_data());
}

// Get HDU by ID
let hdu_2 = &fits[2];
// Get HDU by EXTNAME
let hdu_flux = &fits["FLUX"];

match hdu_flux.read_data() {
    &FitsData::FloatingPoint32(FitsDataArray { ref shape, ref data }) => {
        println!("{:?}", shape);
        println!("{:?}", data);
    }
    _ => { /* ... */ }
}

Write FITS

The FITS files written by [fitrs] are verified by astropy.io.fits for standard compliance. If [fits] outputs a non-compliant FITS file, please file a bug.

extern crate fitrs;
use fitrs::{Fits, Hdu};

// Make example dummy data array
let shape = [20, 20];
let data = (0..shape[0])
    .map(|i| (0..shape[1]).map(move |j| i + j))
    .flatten()
    .collect();
let primary_hdu = Hdu::new(&[20, 20], data);
Fits::create("new_file.fits", primary_hdu).expect("Failed to create");

A lot of possibly desirable functionalities are still missing. PR are welcome.

Structs

Fits	Represent an open FITS file.
FitsDataArray	Actual array data inside the Hdu
FitsIntoIter	An iterator over Hdus. Obtained from a consumed Fits object.
FitsIter	An iterator over references to Hdus.
FitsIterMut	An iterator over mutable references to Hdus.
Hdu	Represent an HDU as defined in FITS standard 4.1.

Enums

FitsData	Represent a data array inside an Hdu.
HeaderValue	Value stored inside the Hdu header.

Traits

FitsDataType

A type that can be stored in a FITS data array implements this trait.