FITSIO Home
Next:
Contents
CFITSIO User's Guide
An Interface to FITS Format Files
for C Programmers
Version 2.0
HEASARC
Code 662
Goddard Space Flight Center
Greenbelt, MD 20771
USA
November 1998
Contents
Introduction
Creating the CFITSIO Library
Building the Library
Testing the Library
Getting Started with CFITSIO
Example Program
Acknowledgements
A FITS Primer
Extended File Name Syntax
Overview
Detailed Filename Syntax
Filetype
Notes about the root filetype
Notes about the shmem filetype:
Base Filename
Output File Name when Opening an Existing File
Template File Name when Creating a New File
Detailed Template Line Format
Template Parser Directives
Formal Template Syntax
Auto-indexing of Keywords
Errors
HDU Location Specification
Column and Keyword Filtering Specification
Row Filtering Specification
Binning or Histogramming Specification
CFITSIO Conventions and Guidelines
CFITSIO Definitions
CFITSIO Size Limitations
Multiple Access to the Same FITS File
Current Header Data Unit (CHDU)
Function Names and Datatypes
Unsigned Integers
Character Strings
Implicit Data Type Conversion
Data Scaling
Error Status Values and the Error Message Stack
Variable-Length Arrays in Binary Tables
Support for IEEE Special Values
When the Final Size of the FITS HDU is Unknown
Local FITS Conventions supported by CFITSIO
Long String Keyword Values.
Arrays of Fixed-Length Strings in Binary Tables
Keyword Units Strings
Optimizing Code for Maximum Processing Speed
Background Information: How CFITSIO Manages Data I/O
Optimization Strategies
The CFITSIO Iterator Function
The Iterator Work Function
The Iterator Driver Function
Guidelines for Using the Iterator Function
Basic CFITSIO Interface Routines
CFITSIO Error Status Routines
FITS File Access Routines
HDU Access Routines
Header Keyword Read/Write Routines
Iterator Routines
Primary Array or IMAGE Extension I/O Routines
ASCII and Binary Table Routines
Column Information Routines
Routines to Edit Rows or Columns
Read and Write Column Data Routines
Celestial Coordinate System Routines
Hierarchical Grouping Convention Support Routines
Row Selection and Calculator Routines
File Checksum Routines
Date and Time Utility Routines
General Utility Routines
Specialized CFITSIO Interface Routines
Specialized FITS File Access Routines
Specialized HDU Access Routines
Specialized Header Keyword Routines
Header Information Routines
Read and Write the Required Keywords
Specialized Write Keyword Routines
Insert Keyword Routines
Specialized Read Keyword Routines
Modify Keyword Routines
Specialized Update Keyword Routines
Define Data Scaling and Undefined Pixel Parameters
Specialized FITS Primary Array or IMAGE Extension I/O Routines
Specialized FITS ASCII and Binary Table Routines
Column Information Routines
Low-Level Table Access Routines
Specialized Write Column Data Routines
Specialized Read Column Data Routines
Index of Routines
Parameter Definitions
CFITSIO Error Status Codes
About this document ...
FITSIO Home