Contents

• Contents
• 1. Introduction
• 2. Creating FITSIO/CFITSIO
  • 2.1 Building the Library
  • 2.2 Testing the Library
  • 2.3 Linking Programs with FITSIO
  • 2.4 Getting Started with FITSIO
  • 2.5 Example Program
  • 2.6 Acknowledgements
• 3. A FITS Primer
• 4. Extended File Name Syntax
  • 4.1 Overview
  • 4.2 Detailed Filename Syntax
    • 4.2.1 Filetype
    • 4.2.2 Base Filename
    • 4.2.3 Output File Name when Opening an Existing File
    • 4.2.4 Template File Name when Creating a New File
    • 4.2.5 HDU Location Specification
    • 4.2.6 age Section
    • 4.2.7 Column and Keyword Filtering Specification
    • 4.2.8 Row Filtering Specification
    • 4.2.9 Binning or Histogramming Specification
• 5. FITSIO Conventions and Guidelines
  • 5.1 CFITSIO Size Limitations
  • 5.2 Multiple Access to the Same FITS File
  • 5.3 Current Header Data Unit (CHDU)
  • 5.4 Subroutine Names
  • 5.5 Subroutine Families and Datatypes
  • 5.6 Implicit Data Type Conversion
  • 5.7 Data Scaling
  • 5.8 Error Status Values and the Error Message Stack
  • 5.9 Variable-Length Array Facility in Binary Tables
  • 5.10 Support for IEEE Special Values
  • 5.11 When the Final Size of the FITS HDU is Unknown
  • 5.12 Local FITS Conventions supported by FITSIO
    • 5.12.1 Support for Long String Keyword Values.
    • 5.12.2 Arrays of Fixed-Length Strings in Binary Tables
    • 5.12.3 Keyword Units Strings
  • 5.13 Optimizing Code for Maximum Processing Speed
    • 5.13.1 Background Information: How CFITSIO Manages Data I/O
• 6. The CFITSIO Iterator Function
• 7. Basic Interface Routines
  • 7.1 FITSIO Error Status Routines
  • 7.2 File I/O Routines
  • 7.3 Keyword I/O Routines
  • 7.4 Data I/O Routines
• 8. Advanced Interface Subroutines
  • 8.1 FITS File Open and Close Subroutines:
  • 8.2 HDU-Level Operations
  • 8.3 Define or Redefine the structure of the CHDU
  • 8.4 FITS Header I/O Subroutines
    • 8.4.1 Header Space and Position Routines
    • 8.4.2 Read or Write Standard Header Routines
    • 8.4.3 Write Keyword Subroutines
    • 8.4.4 Insert Keyword Subroutines
    • 8.4.5 Read Keyword Subroutines
    • 8.4.6 Modify Keyword Subroutines
    • 8.4.7 Update Keyword Subroutines
    • 8.4.8 Delete Keyword Subroutines
  • 8.5 Data Scaling and Undefined Pixel Parameters
  • 8.6 FITS Primary Array or IMAGE Extension I/O Subroutines
  • 8.7 FITS ASCII and Binary Table Data I/O Subroutines
    • 8.7.1 Column Information Subroutines
    • 8.7.2 Low-Level Table Access Subroutines
    • 8.7.3 Edit Rows or Columns
    • 8.7.4 Read and Write Column Data Routines
  • 8.8 Row Selection and Calculator Routines
  • 8.9 Celestial Coordinate System Subroutines
  • 8.10 File Checksum Subroutines
  • 8.11 Date and Time Utility Routines
  • 8.12 General Utility Subroutines
• 9. Summary of all FITSIO User-Interface Subroutines
• 10. Parameter Definitions
• 11. FITSIO Error Status Codes