Contents
Chapter 1 Introduction
Chapter 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 Legal Stuff
2.7 Acknowledgments
Chapter 3 A FITS Primer
Chapter 4 FITSIO Conventions and Guidelines
4.1 CFITSIO Size Limitations
4.2 Multiple Access to the Same FITS File
4.3 Current Header Data Unit (CHDU)
4.4 Subroutine Names
4.5 Subroutine Families and Datatypes
4.6 Implicit Data Type Conversion
4.7 Data Scaling
4.8 Error Status Values and the Error Message Stack
4.9 Variable-Length Array Facility in Binary Tables
4.10 Support for IEEE Special Values
4.11 When the Final Size of the FITS HDU is Unknown
4.12 Local FITS Conventions supported by FITSIO
4.12.1 Support for Long String Keyword Values.
4.12.2 Arrays of Fixed-Length Strings in Binary Tables
4.12.3 Keyword Units Strings
4.12.4 HIERARCH Convention for Extended Keyword Names
4.13 Optimizing Code for Maximum Processing Speed
4.13.1 Background Information: How CFITSIO Manages Data I/O
4.13.2 Optimization Strategies
Chapter 5 Basic Interface Routines
5.1 FITSIO Error Status Routines
5.2 File I/O Routines
5.3 Keyword I/O Routines
5.4 Data I/O Routines
Chapter 6 Advanced Interface Subroutines
6.1 FITS File Open and Close Subroutines:
6.2 HDU-Level Operations
6.3 Define or Redefine the structure of the CHDU
6.4 FITS Header I/O Subroutines
6.4.1 Header Space and Position Routines
6.4.2 Read or Write Standard Header Routines
6.4.3 Write Keyword Subroutines
6.4.4 Insert Keyword Subroutines
6.4.5 Read Keyword Subroutines
6.4.6 Modify Keyword Subroutines
6.4.7 Update Keyword Subroutines
6.4.8 Delete Keyword Subroutines
6.5 Data Scaling and Undefined Pixel Parameters
6.6 FITS Primary Array or IMAGE Extension I/O Subroutines
6.7 FITS ASCII and Binary Table Data I/O Subroutines
6.7.1 Column Information Subroutines
6.7.2 Low-Level Table Access Subroutines
6.7.3 Edit Rows or Columns
6.7.4 Read and Write Column Data Routines
6.8 Row Selection and Calculator Routines
6.9 Celestial Coordinate System Subroutines
6.10 File Checksum Subroutines
6.11 Date and Time Utility Routines
6.12 General Utility Subroutines
Chapter 7 The CFITSIO Iterator Function
Chapter 8 Extended File Name Syntax
8.1 Overview
8.2 Filetype
8.2.1 Notes about HTTP proxy servers
8.2.2 Notes about the stream filetype driver
8.2.3 Notes about the gsiftp filetype
8.2.4 Notes about the root filetype
8.2.5 Notes about the shmem filetype:
8.3 Base Filename
8.4 Output File Name when Opening an Existing File
8.5 Template File Name when Creating a New File
8.6 Image Tile-Compression Specification
8.7 HDU Location Specification
8.8 Image Section
8.9 Image Transform Filters
8.10 Column and Keyword Filtering Specification
8.11 Row Filtering Specification
8.11.1 General Syntax
8.11.2 Bit Masks
8.11.3 Vector Columns
8.11.4 Good Time Interval Filtering and Calculation
8.11.5 Spatial Region Filtering
8.11.6 Example Row Filters
8.12 Binning or Histogramming Specification
Chapter 9 Template Files
9.1 Detailed Template Line Format
9.2 Auto-indexing of Keywords
9.3 Template Parser Directives
9.4 Formal Template Syntax
9.5 Errors
9.6 Examples
Chapter 10 Summary of all FITSIO User-Interface Subroutines
Chapter 11 Parameter Definitions
Chapter 12 FITSIO Error Status Codes
