Next Previous Contents

2. FITS keywords

2.1 The 53 defined standard FITS keywords

The 53 keywords currently defined in the FITS standard are as follows:

(blank) AUTHOR BITPIX BLANK BLOCKED BSCALE BUNIT 
BZERO CDELTn COMMENT CROTAn CRPIXn CRVALn CTYPEn 
DATAMAX DATAMIN DATE DATE-OBS END EPOCH EQUINOX 
EXTEND EXTLEVEL EXTNAME EXTVER GCOUNT GROUPS 
HISTORY INSTRUME NAXIS NAXISn OBJECT OBSERVER 
ORIGIN PCOUNT PSCALn PTYPEn PZEROn REFERENC 
SIMPLE TBCOLn TDIMn TDISPn TELESCOP TFIELDS 
TFORMn THEAP TNULLn TSCALn TTYPEn TUNITn TZEROn
XTENSION

A concise definition of each of these is available from the FWG html page:

53 Standard FITS keywords or local file here

A summary of the standard keywords follows

Used in images

BLANK BSCALE BUNIT BZERO  CDELT CROTAn CRPIXn CRVALn
CTYPEn CTYPEn DATAMAX DATAMIN

General keywords

AUTHOR

author of the data

BITPIX

-64,-32,8,16,32 - bits per data value

BLOCKED

is physical blocksize a multiple of 2880?

COMMENT

descriptive comment

DATE

date of file creation 'yyyy-mm-ddTHH:MM:SS[.sss]'.

DATE-OBS

date of the observation The new Y2K compliant date format is 'yyyy-mm-dd' or 'yyyy-mm-ddTHH:MM:SS[.sss]'.

END

marks the end of the header keywords

EPOCH

deprecated

EQUINOX

equinox of celestial coordinate system

EXTEND

(T/F)- may the FITS file contain extensions?

EXTLEVEL

[1:] (default 1) hierarchical level of the extension. The value shall be 1 for the highest level; levels with a higher value of this keyword shall be subordinate to levels with a lower value.

HISTORY

The text should contain a history of steps and procedures associated with the processing of the associated data.

INSTRUME

name of instrument

NAXIS

number of axes. In FITS 'TABLE' or 'BINTABLE' extensions, the value of NAXIS is always 2.

NAXISn

size of the axis

OBJECT

name of observed object

OBSERVER

observer who acquired the data

ORIGIN

organization responsible for the data

REFERENC

bibliographic reference

SIMPLE

does file conform to the Standard?

TELESCOP

name of telescope

XTENSION

marks beginning of new HDU. The value field shall contain a character string giving the name of the extension type.

Keywords used in tables

EXTLEVEL

[1:] (default 1) hierarchical level of the extension. The value shall be 1 for the highest level; levels with a higher value of this keyword shall be subordinate to levels with a lower value.

EXTNAME

name of the extension used to distinguish among different extensions of the same type, i.e., with the same value of XTENSION, in a FITS file.

EXTVER

[1:] (default 1) version of the extension. The value field shall contain an integer, to be used to distinguish among different extensions in a FITS file with the same type and name, i.e., the same values for XTENSION and EXTNAME. The values need not start with 1 for the first extension with a particular value of EXTNAME and need not be in sequence for subsequent values.

NAXIS

number of axes. In FITS 'TABLE' or 'BINTABLE' extensions, the value of NAXIS is always 2.

NAXISn

size of the axis

TBCOLn

begining column number. The value field of this indexed keyword shall contain an integer specifying the column in which field n starts in an ASCII TABLE extension.

TDIMn

dimensionality of the array. The value field of this indexed keyword shall contain a character string describing how to interpret the contents of field n as a multidimensional array, providing the number of dimensions and the length along each axis.

TDISPn

display format

TFIELDS

number of columns in the table

TFORMn

column data format

THEAP

offset to starting data heap address. The value field of this keyword shall contain an integer providing the separation, in bytes, between the start of the main data table and the start of a supplemental data area called the heap. The default value shall be the product of the values of NAXIS1 and NAXIS2. This keyword shall not be used if the value of PCOUNT is zero. A proposed application of this keyword is presented in Appendix B.1 of the FITS Standard.

TNULLn

value used to indicate undefined table element

TSCALn

linear data scaling factor. physical_value = TZEROn + TSCALn * field_value

TTYPEn

column name. The use of identical names for different fields should be avoided.

TUNITn

column units

TZEROn

column scaling zero point. The default value for this keyword is 0.0. This keyword may not be used if the format of field n is A, L, or X.

XTENSION

marks beginning of new HDU. The value field shall contain a character string giving the name of the extension type.

Standard keywords used for random groups

GCOUNT

group count. In most other cases this keyword will have the value 1.

GROUPS

indicates random groups structure The value field shall contain the logical constant T. The value T associated with this keyword implies that random groups records are present.

PSCALn

Reserved for use within the FITS Random Groups structure.

PTYPE

name of random groups parameter

PZEROn

parameter scaling zero point

PCOUNT

parameter count. This keyword was originated for use with FITS Random Groups and represented the number of parameters preceding each group. It has since been used in 'BINTABLE' extensions to represent the size of the data heap following the main data table. In most other cases its value will be zero.

2.2 The additional GBT specific standard keywords

The additional GBT specific standard keywords

BACKEND BANDWDTH BANK DATEBLD DEVICE DELTA 
FEED FITSVER GBTMCVER MANAGER PORT RECEIVER 
RECEPTOR SAMPLER SIMULATE UTCSTART UTDSTART

2.3 The single dish FITS keyword set

From Single dish FITS

This section is taken verbatim from AIPS++ Note 236

CORE keywords and columns

These must be provided in all SDFITS tables. They are essential and common to all observations and telescopes. All single dish FITS readers and writers must acknowledge (write and properly interpret) all CORE keywords.

OBJECT

A string value giving an object name.

TELESCOP

A string value giving the telescope name.

BANDWID

The total bandwidth of the backend in units of Hertz.

DATE-OBS

A string giving the observation date and optionally the time at the start using the new FITS y2k convention. The TIMESYS keyword may be used to indicate the time system. UTC is assumed if TIMESYS is absent.

EXPOSURE

The effective integration time in seconds.

TSYS

The system temperature in Kelvin.

SHARED keywords and columns

These have agreeded definitions and interpretations however their presense is optional. These are largely common to all observations and telescopes but not essential. These may be ignored by a single dish FITS reader.

OBSERVER

A string giving the observer's name.

OBSID

A string describing the observation.

PROJID

A string describing the project

SCAN

A scan ID number. Typically this is an identification number given to a chunk of data when the data is taken. Not all telescopes provide a scan ID number.

OBSMODE

The type of data and observing mode (8 characters total). The type (LINE, CONT, PULS, etc) + the mode (PSSW, FQSW, BMSQ, PLSQ, LDSW, TLPW, etc). These rules do NOT define these observing modes. Writers are strongly encouraged to use the FITS comments to document these modes.

MOLECULE

A string used as a line identifier (with TRANSITI).

TRANSITI

A string used as a line identifier (with MOLECULE.)

TEMPSCAL

A string describing the scaling applied to reach the output intensity scale (``TB'',``TA'',``TA*'',``TR'',``TR*'').

FRONTEND

A string giving the name of the front end device.

BACKEND

A string giving the name of the back end device.

TCAL

The calibration temp (K).

THOT

The hot load temp (K).

TCOLD

The cold load temp (K).

TRX

The receiver temp (K).

FREQRES

The frequency resolution in Hz. This may differ from the channel spacing.

TIMESYS

The time system which applies to all time columns and keywords (see the y2k FITS DATE agreement).

VELDEF

The velocity definition and frame (8 characters). The first 4 characters describe the velicity definition. Possible definitions include: RADI radio OPTI optical RELA relativistic The second 4 characters describe the reference frame (e.g. ``-LSR'',``-HEL'', ``-OBS''). If the frequency-like axis gives a frame, then the frame in VELDEF only applies to any velocities given as columns or keywords (virtual columns).

VFRAME

The radial velocity of the reference frame wrt the observer. Vframe -Vtelescope.

RVSYS

The radial velocity, Vsource - Vtelescope.

OBSFREQ

The observed frequency (Hz) at the reference pixel of the frequency-like axis.

IMAGFREQ

The image sideband freq (Hz) corresp. to OBSFREQ.

LST

The LST (seconds) at the start of scan.

AZIMUTH

The azimuth at TIME (deg) (if the TIME axis is non-degenerate, then this is the azimuth at the TIME of the first pixel on the TIME axis.

ELEVATIO

The elevation at TIME (deg) (same caveat as for AZIMUTH)

TAU

The opacity at OBSFREQ.

TAUIMAGE

The opacity at IMAGFREQ.

TAUZENIT

The opacity per unit air mass.

HUMIDITY

The relative humidity (fraction, 0..1).

TAMBIENT

The ambient temp (K).

PRESSURE

The atmospheric pressure (mm Hg).

DEWPOINT

The dew point (K).

WINDSPEE

The wind speed (m/s).

WINDDIRE

The wind direction (deg. west of north).

BEAMEFF

The main-beam efficiency.

APEREFF

The antenna aperture efficiency.

ETAL

The rear spillover and scattering efficiency.

ETAFSS

The forward spillover and scattering efficiency.

ANTGAIN

K per Jy.

BMAJ

The major main-beam FWHM (deg).

BMIN

The minor main-beam FWHM (deg).

BPA

The beam position angle (degrees east of north).

SITELONG

The site longitude (deg).

SITELAT

The site latitude (deg).

SITEELEV

The site elevation (m).

RESTFREQ

The rest frequency (Hz).

2.4 Dictionary of Commonly Used FITS Keywords

This data dictionary contains FITS keywords that have been widely used within the astronomical community. It is recommended that these keywords only be used as defined here. These keywords may be grouped within the following 7 broad categories:

1. Keywords that describe the data or the FITS file itself:

TITLE FILENAME FILETYPE ROOTNAME PROGRAM CREATOR 
CONFIGUR NEXTEND HDUNAME HDUVER HDULEVEL TLMINn 
TLMAXn TDMINn TDMAXn TDBINn TSORTKEY PROGRAM 
CREATOR CONFIGUR HDUCLASS HDUDOC HDUVERS HDUCLASn

2. Keywords that describe the observation:

SUNANGLE MOONANGL RA DEC RA_NOM DEC_NOM RA_OBJ 
DEC_OBJ RA_PNT DEC_PNT PA_PNT RA_SCX DEC_SCX 
RA_SCY DEC_SXY RA_SCZ DEC_SCZ ORIENTAT AIRMASS 
LATITUDE OBJNAME OBS_ID

3. Keywords that describe the instrument that took the data:

OBS_MODE DATAMODE APERTURE DETNAM FILTER 
FILTERn GRATING GRATINGn SATURATE

4. Keywords that give the date or duration of the observation:

TIME-OBS TIME-END DATE-END EXPOSURE 
EXPTIME TELAPSE ELAPTIME ONTIME LIVETIME

5. Keywords that denote non-standard FITS keyword format conventions:

HIERARCH INHERIT CONTINUE

6. File checksum keywords:

CHECKSUM DATASUM CHECKVER

7. Hierarchical file grouping keywords:

GRPNAME GRPIDn GRPLCn

Commonly used keywords

Or local file Local version


Next Previous Contents