Welcome to the MFITSIO Webpage

MFITSIO is a MATLAB interface written by Damian Eads to the cfitsio library available from NASA. MFITSIO is used to read images and headers stored in the Flexible Image Transport System (FITS) file format. This format is most commonly used among astrophysics to record astronomical data and observations.

Features Supported

MFITSIO currently supports reading and writing of images, FITS headers, image stacks, N-D image arrays (N>3), and writing of image subsets. For a list of supported data types, refer to Section 5.

Planned Features for Future Versions

In the future, MFITSIO will support routines to manipulate FITS tables, random image groups, ASCII tables, binary tables, variable length arrays, world coordinate system, and image compression.

Architectures Supported

MFITSIO will work on any platform in which (a) CFITSIO can compile into a linked library, (b) MATLAB will successfully run, and (c) MathWork's mex is supported. These platforms should include:

  • Linux on Pentium Family and AMD Athlon Family Architectures
  • Mac OS X on Power Macintosh G3 or G4
  • Solaris 2.6, 2.7, or 2.8 on Sparc
  • HP-UX on PA-RISC 1.1, PA-RISC 2.0
  • IRIX on R5000, R8000, R10000, R12000
  • AIX on RS/6000
  • Tru64 Unix on Alpha
  • Windows on Pentium Family and AMD Athlon Family Architectures
A comprehensive list of system requirements for MATLAB is available from MathWorks, http://www.mathworks.com/products/system.shtml.

Please note: due to the limited availability of architectures I have access to, MFITSIO has only been tested on Linux.

Windows Users

You may download pre-compiled binaries for windows here. Please refer to the Windows FAQ for questions.

Installing MFITSIO

First install the CFITSIO library which is freely available for download here.

There are two ways to install MFITSIO.

Method A: Install Pre-compiled Binaries
Download a pre-compiled binary. Extract it by entering the following at the command prompt:
    gzip -cd TARBALL_NAME | tar xvf -
where TARBALL_NAME is the name of the file downloaded. Read the README file for further instructions.
Method B: Compile Source
Download a source tar file. Extract it by entering the following at the command prompt:
    gzip -cd TARBALL_NAME | tar xvf -
where TARBALL_NAME is the name of the file downloaded. Read the README file for further instructions. Note: this method may be necessary if there are no pre-compiled binaries available for your platform.

Contact Information

Praise, constructive criticism, bug reports, and suggestions may be directed to Damian Eads, eads@lanl.gov.

Documentation

Documentation detailing the installation process is available in the README file.

After installing MFITSIO, help may be accessed by typing "help mfitsio" at the MATLAB session prompt.

If you would like to contribute to mfitsio, then you may find its Interface API Documentation particularly helpful.

Legal Stuff

This software and ancillary information (herein called ``Software'') called MFITSIO is made available under the terms described here. The SOFTWARE has been approved for release with associated LA-CC number: LA-CC-02-085. This SOFTWARE has been authored by an employee or employees of the University of California, operator of the Los Alamos National Laboratory under Contract No. W-7405-ENG-36 with the U.S. Department of Energy. The U.S. Government has rights to use, reproduce, and distribute this SOFTWARE. The public may copy, distribute, prepare derivative works and publicly display this SOFTWARE without charge, provided that this Notice and any statement of authorship are reproduced on all copies. Neither the Government nor the University makes any warranty, express or implied, or assumes any liability or responsibility for the use of this SOFTWARE. If SOFTWARE is modified to produce derivative works, such modified SOFTWARE should be clearly marked, so as not to confuse it with the version available from LANL. Copyright (C) The Regents of the University of California, 2002-2003. Refer to the COPYING file for more information on licensing.
eads@lanl.gov
Last modified: Fri Feb 21 04:12:36 2003


Operated by Los Alamos National Security, LLC for the National Nuclear Security Administration of the US Department of Energy. Copyright © 2002-2006 University of California, 2006-2007 LANS LLC. | Disclaimer/Privacy
This website has been approved for unlimited release with associated LA-UR number LA-UR-03-0949.