FITSIO Home
Next:
Contents
FITSIO User's Guide
A Subroutine Interface to FITS Format Files
for Fortran Programmers
Version 5.0
Dr. William D. Pence
HEASARC
Code 662
Goddard Space Flight Center
Greenbelt, MD 20771
USA
November 1997
Contents
Introduction
Acknowledgements
Creating the FITSIO Library
Machine Specific Versions
Building the Fortran Library
Unix Platforms
VMS Platforms
IBM Compatible PCs running DOS or Windows
Using Macintosh PCs
Using the f2c Compiler
The IRAF SPP Compatible Version of FITSIO
Testing the FITSIO Library
Getting Started with FITSIO
Example Program
Calling FITSIO from C programs (Obsolete Section)
A FITS Primer
Basic FITSIO Conventions
Current Header Data Unit (CHDU)
Subroutine Names
Subroutine Families and Datatypes
Implicit Data Type Conversion
Data Scaling
Error Status Values and the Error Message Stack
Variable-Length Array Facility in Binary Tables
Support for IEEE Special Values
Local FITS Conventions supported by FITSIO
Support for Long String Keyword Values.
Arrays of Strings in Binary Table Extensions
Keyword Units Strings
Programming Guidelines
Reading an existing FITS file
Creating a new FITS file
When the Final Size of the FITS File is Unknown
Optimizing Code for Maximum Processing Speed
FITSIO Array Size Limitations
Basic Interface Routines
File I/O Routines
Keyword I/O Routines
Data I/O Routines
Advanced Interface Subroutines
FITS File Open and Close Subroutines:
HDU-Level Operations
Define or Redefine the structure of the CHDU
FITS Header I/O Subroutines
Header Space and Position Routines
Read or Write Standard Header Routines
Write Keyword Subroutines
Insert Keyword Subroutines
Read Keyword Subroutines
Modify Keyword Subroutines
Update Keyword Subroutines
Delete Keyword Subroutines
Data Scaling and Undefined Pixel Parameters
FITS Primary Array or IMAGE Extension I/O Subroutines
FITS ASCII and Binary Table Data I/O Subroutines
Column Information Subroutines
Low-Level Table Access Subroutines
High-Level Table Access Subroutines
Celestial Coordinate System Subroutines
File Checksum Subroutines
General Utility Subroutines
Summary of all FITSIO User-Interface Subroutines
Parameter Definitions
FITSIO Error Status Codes
About this document ...