Contents

• 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
    • Base Filename
    • Output File Name when Opening an Existing File
    • Template File Name when Creating a New File
    • 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