DSP API SDFITS Extension

Macros
#define	FITS_TABLE_SDFITS   "SINGLE DISH"
	SDFITS Convention Table.
#define	SDFITS_COLUMN_OBJECT   (dsp_fits_column){"OBJECT", "8A", "", "", "common FITS usage", (char*[]){""}}
#define	SDFITS_COLUMN_TELESCOP   (dsp_fits_column){"TELESCOP", "8A", "", "", "common FITS keyword", (char*[]){""}}
	common FITS keyword
#define	SDFITS_COLUMN_FREQRES   (dsp_fits_column){"FREQRES", EXTFITS_ELEMENT_DOUBLE.typestr, EXTFITS_MEASURE_UNIT_HZ, "", "resolution may differ from spacing of backend, not one channel", (char*[]){""}}
	resolution may differ from spacing of backend, not one channel
#define	SDFITS_COLUMN_DATE_OBS   (dsp_fits_column){"DATE-OBS", "8A", "", "", "common FITS usage; JD preferable?", (char*[]){""}}
	common FITS usage; JD preferable?
#define	SDFITS_COLUMN_TIME   (dsp_fits_column){"TIME", EXTFITS_ELEMENT_DOUBLE.typestr, EXTFITS_MEASURE_UNIT_SECOND, "", "UT time of day; UT seconds since Oh UT", (char*[]){""}}
	UT time of day; UT seconds since Oh UT.
#define	SDFITS_COLUMN_EXPOSURE   (dsp_fits_column){"EXPOSURE", EXTFITS_ELEMENT_DOUBLE.typestr, EXTFITS_MEASURE_UNIT_SECOND, "", "effective integration time", (char*[]){""}}
	effective integration time
#define	SDFITS_COLUMN_TSYS   (dsp_fits_column){"TSYS", EXTFITS_ELEMENT_DOUBLE.typestr, EXTFITS_MEASURE_UNIT_KELVIN, "", "system, not receiver, temperature", (char*[]){""}}
	system, not receiver, temperature
#define	SDFITS_COLUMN_OBJCTRA   (dsp_fits_column){"OBJCTRA", EXTFITS_ELEMENT_STRING.typestr, EXTFITS_MEASURE_UNIT_DEGREE, "", "Target right ascension coordinate", (char*[]){""}}
	Target right ascension coordinate.
#define	SDFITS_COLUMN_OBJCTDEC   (dsp_fits_column){"OBJCTDEC", EXTFITS_ELEMENT_STRING.typestr, EXTFITS_MEASURE_UNIT_DEGREE, "", "Target declination coordinate", (char*[]){""}}
	Target declination coordinate.
#define	SDFITS_COLUMN_DATA   (dsp_fits_column){"DATA", "", "", "", "", (char*[]){""}}
	Data buffer.
#define	OBSTYPE_LINE   "LINE"
#define	OBSTYPE_CONT   "CONT"
	continuum
#define	OBSTYPE_PULS   "PULS"
	pulses
#define	OBSMODE_PSSW   "PSSW"
	position switch
#define	OBSMODE_FQSW   "FQSW"
	frequency switch
#define	OBSMODE_BMSW   "BMSW"
	beam switch
#define	OBSMODE_PLSW   "PLSW"
	phase-lock switch
#define	OBSMODE_LDSW   "LDSW"
	load switch
#define	OBSMODE_TLPW   "TLPW"
	total power
#define	OBSMODE_LINE_PSSW   OBSTYPE_LINE OBSMODE_PSSW
	average
#define	OBSMODE_LINE_FQSW   OBSTYPE_LINE OBSMODE_FQSW
	frequency switch
#define	OBSMODE_LINE_BMSW   OBSTYPE_LINE OBSMODE_BMSW
	beam switch
#define	OBSMODE_LINE_PLSW   OBSTYPE_LINE OBSMODE_PLSW
	phase-lock switch
#define	OBSMODE_LINE_LDSW   OBSTYPE_LINE OBSMODE_LDSW
	load switch
#define	OBSMODE_LINE_TLPW   OBSTYPE_LINE OBSMODE_TLPW
	total power
#define	OBSMODE_CONT_PSSW   OBSTYPE_CONT OBSMODE_PSSW
#define	OBSMODE_CONT_FQSW   OBSTYPE_CONT OBSMODE_FQSW
	frequency switch
#define	OBSMODE_CONT_BMSW   OBSTYPE_CONT OBSMODE_BMSW
	beam switch
#define	OBSMODE_CONT_PLSW   OBSTYPE_CONT OBSMODE_PLSW
	phase-lock switch
#define	OBSMODE_CONT_LDSW   OBSTYPE_CONT OBSMODE_LDSW
	load switch
#define	OBSMODE_CONT_TLPW   OBSTYPE_CONT OBSMODE_TLPW
	total power
#define	OBSMODE_PULS_PSSW   OBSTYPE_PULS OBSMODE_PSSW
#define	OBSMODE_PULS_FQSW   OBSTYPE_PULS OBSMODE_FQSW
	frequency switch
#define	OBSMODE_PULS_BMSW   OBSTYPE_PULS OBSMODE_BMSW
	beam switch
#define	OBSMODE_PULS_PLSW   OBSTYPE_PULS OBSMODE_PLSW
	phase-lock switch
#define	OBSMODE_PULS_LDSW   OBSTYPE_PULS OBSMODE_LDSW
	load switch
#define	OBSMODE_PULS_TLPW   OBSTYPE_PULS OBSMODE_TLPW
	total power
#define	TEMPSCAL_TB   "TB"
	TEMPSCAL.
#define	VELDEF_RADI   "*RADI"
	VELDEF.
#define	SDFITS_COLUMN_OBSERVER   (dsp_fits_column){"OBSERVER", "8A", "", "", "Observer name", (char*[]){""}}
#define	SDFITS_COLUMN_OBSID   (dsp_fits_column){"OBSID", "8A", "", "", "Observer & operator initials", (char*[]){""}}
	Observer & operator initials;.
#define	SDFITS_COLUMN_PROJID   (dsp_fits_column){"PROJID", "8A", "", "", "Project ID", (char*[]){""}}
	Project ID;.
#define	SDFITS_COLUMN_SCAN   (dsp_fits_column){"SCAN", EXTFITS_ELEMENT_DOUBLE.typestr, "", "", "Scan number", (char*[]){""}}
	Scan number.
#define	SDFITS_COLUMN_OBSMODE   (dsp_fits_column){"OBSMODE", "8A", "", "", "Type of data, observing mode", (char*[]){OBSMODE_LINE_PSSW, OBSMODE_LINE_FQSW, OBSMODE_LINE_BMSW, OBSMODE_LINE_PLSW, OBSMODE_LINE_LDSW, OBSMODE_LINE_TLPW, OBSMODE_CONT_PSSW, OBSMODE_CONT_FQSW, OBSMODE_CONT_BMSW, OBSMODE_CONT_PLSW, OBSMODE_CONT_LDSW, OBSMODE_CONT_TLPW, OBSMODE_PULS_PSSW, OBSMODE_PULS_FQSW, OBSMODE_PULS_BMSW, OBSMODE_PULS_PLSW, OBSMODE_PULS_LDSW, OBSMODE_PULS_TLPW}}
	Type of data, observing mode;.
#define	SDFITS_COLUMN_MOLECULE   (dsp_fits_column){"MOLECULE", "8A", "", "", "Molecule observed or detected", (char*[]){""}}
	Molecule observed or detected;.
#define	SDFITS_COLUMN_TRANSITI   (dsp_fits_column){"TRANSITI", "8A", "", "", "As appropriate", (char*[]){""}}
	As appropriate;.
#define	SDFITS_COLUMN_TEMPSCAL   (dsp_fits_column){"TEMPSCAL", "8A", "", "", "Normalization of TA", (char*[]){""}}
	Normalization of TA;.
#define	SDFITS_COLUMN_TCAL   (dsp_fits_column){"TCAL", EXTFITS_ELEMENT_DOUBLE.typestr, EXTFITS_MEASURE_UNIT_KELVIN, "", "Calibration Temp", (char*[]){""}}
	Calibration Temp (K)
#define	SDFITS_COLUMN_THOT   (dsp_fits_column){"THOT", EXTFITS_ELEMENT_DOUBLE.typestr, EXTFITS_MEASURE_UNIT_KELVIN, "", "Hot load temperature", (char*[]){""}}
	Hot load temperature (K)
#define	SDFITS_COLUMN_TCOLD   (dsp_fits_column){"TCOLD", EXTFITS_ELEMENT_DOUBLE.typestr, EXTFITS_MEASURE_UNIT_KELVIN, "", "Cold load temperature", (char*[]){""}}
	Cold load temperature (K)
#define	SDFITS_COLUMN_TRX   (dsp_fits_column){"TRX", EXTFITS_ELEMENT_DOUBLE.typestr, EXTFITS_MEASURE_UNIT_KELVIN, "", "Receiver Temp, Float", (char*[]){""}}
	Receiver Temp (K), Float.
#define	SDFITS_COLUMN_VELDEF   (dsp_fits_column){"VELDEF", "8A", "", "", "Velocity definition & frame", (char*[]){VELDEF_RADI, VELDEF_OPTI, VELDEF_RELA, VELDEF_LSR, VELDEF_HELO, VELDEF_EART, VELDEF_BARI, VELDEF_OBS, ""}}
	Velocity definition & frame;.
#define	SDFITS_COLUMN_VCORR   (dsp_fits_column){"VCORR", EXTFITS_ELEMENT_DOUBLE.typestr, "", "", "radial velocity correction; Vref - Vtel", (char*[]){""}}
	radial velocity correction; Vref - Vtel
#define	SDFITS_COLUMN_OBSFREQ   (dsp_fits_column){"OBSFREQ", EXTFITS_ELEMENT_DOUBLE.typestr, EXTFITS_MEASURE_UNIT_HZ, "", "Observed Frequency", (char*[]){""}}
	Observed Frequency (Hz)
#define	SDFITS_COLUMN_IMAGFREQ   (dsp_fits_column){"IMAGFREQ", EXTFITS_ELEMENT_DOUBLE.typestr, EXTFITS_MEASURE_UNIT_HZ, "", "Image sideband freq", (char*[]){""}}
	Image sideband freq (Hz)
#define	SDFITS_COLUMN_LST   (dsp_fits_column){"LST", EXTFITS_ELEMENT_DOUBLE.typestr, EXTFITS_MEASURE_UNIT_SECOND, "", "LST at start of scan", (char*[]){""}}
	LST (seconds) at start of scan.
#define	SDFITS_COLUMN_LST   (dsp_fits_column){"LST", EXTFITS_ELEMENT_DOUBLE.typestr, EXTFITS_MEASURE_UNIT_SECOND, "", "LST at start of scan", (char*[]){""}}
	LST (seconds) at start of scan.
#define	SDFITS_COLUMN_AZIMUTH   (dsp_fits_column){"AZIMUTH", EXTFITS_ELEMENT_DOUBLE.typestr, EXTFITS_MEASURE_UNIT_DEGREE, "", "Commanded Azimuth", (char*[]){""}}
	Commanded Azimuth (Degrees)
#define	SDFITS_COLUMN_ELEVATIO   (dsp_fits_column){"ELEVATIO", EXTFITS_ELEMENT_DOUBLE.typestr, EXTFITS_MEASURE_UNIT_DEGREE, "", "Commanded Elevation", (char*[]){""}}
	Commanded Elevation (Degrees)
#define	SDFITS_COLUMN_TAU   (dsp_fits_column){"TAU", EXTFITS_ELEMENT_DOUBLE.typestr, EXTFITS_MEASURE_UNIT_PERCENT, "", "Opacity at signal freq", (char*[]){""}}
	Opacity at signal freq.
#define	SDFITS_COLUMN_TAUIMAGE   (dsp_fits_column){"TAUIMAGE", EXTFITS_ELEMENT_DOUBLE.typestr, EXTFITS_MEASURE_UNIT_PERCENT, "", "Opacity at image freq", (char*[]){""}}
	Opacity at image freq.
#define	SDFITS_COLUMN_TAUZENIT   (dsp_fits_column){"TAUZENIT", EXTFITS_ELEMENT_DOUBLE.typestr, EXTFITS_MEASURE_UNIT_PERCENT, "", "Opacity per unit air mass", (char*[]){""}}
	Opacity per unit air mass.
#define	SDFITS_COLUMN_HUMIDITY   (dsp_fits_column){"HUMIDITY", EXTFITS_ELEMENT_DOUBLE.typestr, "", "", "Decimal fraction 0..1", (char*[]){""}}
	Decimal fraction 0..1.
#define	SDFITS_COLUMN_TAMBIENT   (dsp_fits_column){"TAMBIENT", EXTFITS_ELEMENT_DOUBLE.typestr, EXTFITS_MEASURE_UNIT_KELVIN, "", "Ambient Temp (K)", (char*[]){""}}
	Ambient Temp (K)
#define	SDFITS_COLUMN_PRESSURE   (dsp_fits_column){"PRESSURE", EXTFITS_ELEMENT_DOUBLE.typestr, "mm Hg", "", "Barometer reading ", (char*[]){""}}
	Barometer reading mm Hg.
#define	SDFITS_COLUMN_DEWPOINT   (dsp_fits_column){"DEWPOINT", EXTFITS_ELEMENT_DOUBLE.typestr, EXTFITS_MEASURE_UNIT_KELVIN, "", "Dew point", (char*[]){""}}
	Dew point (K)
#define	SDFITS_COLUMN_WINDSPEE   (dsp_fits_column){"WINDSPEE", EXTFITS_ELEMENT_DOUBLE.typestr, "m/s", "", "Wind speed", (char*[]){""}}
	Wind speed m/s.
#define	SDFITS_COLUMN_WINDDIRE   (dsp_fits_column){"WINDDIRE", EXTFITS_ELEMENT_DOUBLE.typestr, EXTFITS_MEASURE_UNIT_DEGREE, "", "Degrees West of North", (char*[]){""}}
	Degrees West of North.
#define	SDFITS_COLUMN_BEAMEFF   (dsp_fits_column){"BEAMEFF", EXTFITS_ELEMENT_DOUBLE.typestr, EXTFITS_MEASURE_UNIT_PERCENT, "", "Main-beam efficiency", (char*[]){""}}
	Main-beam efficiency.
#define	SDFITS_COLUMN_APEREFF   (dsp_fits_column){"APEREFF", EXTFITS_ELEMENT_DOUBLE.typestr, EXTFITS_MEASURE_UNIT_PERCENT, "", "Antenna Aperature Efficiency", (char*[]){""}}
	Antenna Aperature Efficiency.
#define	SDFITS_COLUMN_ETAL   (dsp_fits_column){"ETAL", EXTFITS_ELEMENT_DOUBLE.typestr, "", "", "Rear spillover", (char*[]){""}}
	Rear spillover.
#define	SDFITS_COLUMN_ETAFSS   (dsp_fits_column){"ETAFSS", EXTFITS_ELEMENT_DOUBLE.typestr, "", "", "Accounts for forward loss", (char*[]){""}}
	Accounts for forward loss.
#define	SDFITS_COLUMN_ANTGAIN   (dsp_fits_column){"ANTGAIN", EXTFITS_ELEMENT_DOUBLE.typestr, "K/Jy", "", "", (char*[]){""}}
	K per Jy.
#define	SDFITS_COLUMN_BMAJ   (dsp_fits_column){"BMAJ", EXTFITS_ELEMENT_DOUBLE.typestr, "", "", "Large main-beam FWHM", (char*[]){""}}
	Large main-beam FWHM.
#define	SDFITS_COLUMN_BMIN   (dsp_fits_column){"BMIN", EXTFITS_ELEMENT_DOUBLE.typestr, "", "", "Small main-beam FWHM", (char*[]){""}}
	Small main-beam FWHM.
#define	SDFITS_COLUMN_BPA   (dsp_fits_column){"BPA", EXTFITS_ELEMENT_DOUBLE.typestr, EXTFITS_MEASURE_UNIT_DEGREE, "", "Beam position angle", (char*[]){""}}
	Beam position angle, measured East of North.
#define	SDFITS_COLUMN_SITELONG   (dsp_fits_column){"SITELONG", EXTFITS_ELEMENT_DOUBLE.typestr, EXTFITS_MEASURE_UNIT_DEGREE, "", "Site longitude", (char*[]){""}}
	Site longitude (Degrees)
#define	SDFITS_COLUMN_SITELAT   (dsp_fits_column){"SITELAT", EXTFITS_ELEMENT_DOUBLE.typestr, EXTFITS_MEASURE_UNIT_DEGREE, "", "Site latitude", (char*[]){""}}
	Site latitude (Degrees)
#define	SDFITS_COLUMN_SITEELEV   (dsp_fits_column){"SITEELEV", EXTFITS_ELEMENT_DOUBLE.typestr, EXTFITS_MEASURE_UNIT_METER, "", "site elevation", (char*[]){""}}
	site elevation in meters
#define	SDFITS_COLUMN_EPOCH   (dsp_fits_column){"EPOCH", EXTFITS_ELEMENT_DOUBLE.typestr, EXTFITS_MEASURE_UNIT_YEAR, "", "Epoch of observation", (char*[]){""}}
	Epoch of observation (year)
#define	SDFITS_COLUMN_EQUINOX   (dsp_fits_column){"EQUINOX", EXTFITS_ELEMENT_DOUBLE.typestr, EXTFITS_MEASURE_UNIT_YEAR, "", "Equinox of coords", (char*[]){""}}
	Equinox of coords (year)
#define	SDFITS_KEYWORD_TELESCOP   (dsp_fits_keyword){"TELESCOP", "8A", "", "", "", (char*[]){""}}
#define	SDFITS_KEYWORD_OBSERVER   (dsp_fits_keyword){"OBSERVER", "8A", "", "", "", (char*[]){""}}
	Name of observer.
#define	SDFITS_KEYWORD_DATE_OBS   (dsp_fits_keyword){"DATE-OBS", "8A", "", "", "", (char*[]){""}}
	UT date of observation (dd/mm/yy) .
#define	SDFITS_KEYWORD_DATAMAX   (dsp_fits_keyword){"DATAMAX", EXTFITS_ELEMENT_DOUBLE.typestr, "", "", "", (char*[]){""}}
	Max spectral value (K) - for whole file.
#define	SDFITS_KEYWORD_DATAMIN   (dsp_fits_keyword){"DATAMIN", EXTFITS_ELEMENT_DOUBLE.typestr, "", "", "", (char*[]){""}}
	Min spectral value (K) - for whole file.

Functions
DLL_EXPORT dsp_fits_row *	dsp_fits_read_sdfits (char *filename, long *nstreams, long *maxes, long **maxis)
	read a fits file containing a SDFITS Extension More...

Detailed Description

Macro Definition Documentation

OBSMODE_CONT_PSSW

#define OBSMODE_CONT_PSSW   OBSTYPE_CONT OBSMODE_PSSW

continuum position switch

OBSMODE_PULS_PSSW

#define OBSMODE_PULS_PSSW   OBSTYPE_PULS OBSMODE_PSSW

pulses position switch

OBSTYPE_LINE

#define OBSTYPE_LINE   "LINE"

OBSMODE average

SDFITS_COLUMN_OBJECT

#define SDFITS_COLUMN_OBJECT   (dsp_fits_column){"OBJECT", "8A", "", "", "common FITS usage", (char*[]){""}}

SDFITS columns common FITS usage

SDFITS_COLUMN_OBSERVER

#define SDFITS_COLUMN_OBSERVER   (dsp_fits_column){"OBSERVER", "8A", "", "", "Observer name", (char*[]){""}}

SDFITS columns Observer name

SDFITS_KEYWORD_TELESCOP

#define SDFITS_KEYWORD_TELESCOP   (dsp_fits_keyword){"TELESCOP", "8A", "", "", "", (char*[]){""}}

Global keywords for the SDFITS SINGLE DISH table Designation of Telescope.

Function Documentation

dsp_fits_read_sdfits()

DLL_EXPORT dsp_fits_row* dsp_fits_read_sdfits	(	char *	filename,
		long *	nstreams,
		long *	maxes,
		long **	maxis
	)

Parameters

filename	The file name of the fits to read
nstreams	The number of streams of the data matrix passed by reference
maxes	The number of dimensions of the data matrix passed by reference
maxis	The sizes of the data matrix

Returns

dsp_fits_row pointer describing the fits file content