FITSIO User’s Guide
A Subroutine Interface to FITS Format Files
for Fortran Programmers
Version 4.2
2.5cm
HEASARC
Code 662
Goddard Space Flight Center
Greenbelt, MD 20771
USA
Nov 2022
Contents
Introduction
Creating FITSIO/CFITSIO
Building the Library
Testing the Library
Linking Programs with FITSIO
Getting Started with FITSIO
Example Program
Legal Stuff
Acknowledgments
A FITS Primer
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
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
The CFITSIO Iterator Function
Extended File Name Syntax
Overview
Filetype
Base Filename
Output File Name when Opening an Existing File
Template File Name when Creating a New File
Image Tile-Compression Specification
HDU Location Specification
Image Section
Image Transform Filters
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
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
.