FITSIO User's Guide
A Subroutine Interface to FITS Format Files
for Fortran Programmers
Version 2.4
2.5cm
HEASARC
Code 662
Goddard Space Flight Center
Greenbelt, MD 20771
USA
July 2002
Table of Contents
Introduction
Creating FITSIO/CFITSIO
Building the Library
Testing the Library
Linking Programs with FITSIO
Getting Started with FITSIO
Example Program
Legal Stuff
Acknowledgements
A FITS Primer
Extended File Name Syntax
Overview
Filetype
Base Filename
Output File Name when Opening an Existing File
Template File Name when Creating a New File
HDU Location Specification
Image Section
Column and Keyword Filtering Specification
Row Filtering Specification
Binning or Histogramming Specification
Template Files
Detailed Template Line Format
Auto-indexing of Keywords
Template Parser Directives
Formal Template Syntax
Errors
Examples
FITSIO Conventions and Guidelines
CFITSIO Size Limitations
Multiple Access to the Same FITS File
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
When the Final Size of the FITS HDU is Unknown
Local FITS Conventions supported by FITSIO
Optimizing Code for Maximum Processing Speed
The CFITSIO Iterator Function
Basic Interface Routines
FITSIO Error Status 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
Data Scaling and Undefined Pixel Parameters
FITS Primary Array or IMAGE Extension I/O Subroutines
FITS ASCII and Binary Table Data I/O Subroutines
Row Selection and Calculator Routines
Celestial Coordinate System Subroutines
File Checksum Subroutines
Date and Time Utility Routines
General Utility Subroutines
Summary of all FITSIO User-Interface Subroutines
Parameter Definitions
FITSIO Error Status Codes
This document was translated from L
A
T
E
X by
H
E
V
E
A and H
A
C
H
A
.