Back to Table of Contents

COSMOS subroutines

• ccd8
• fp2ccd
• Getchipdat
• mspos
• Readcdf
• Readcof

• interpol
• OpenCosParm
• OpenFitsFile
• ReadObsDef
• ReadParm

Focal Plane transformation routines

ccd8

SUMMARY:

Transforms pixel coordinates to accurate full 8-chip scale

USAGE:

ccd8( int chip, float xccd, float yccd, float* x8, float* y8)

chip	chip
xccd,yccd	pixel coordinate on chip
x8,y8	8-chip coordinates

RETURN:

0

fp2ccd

SUMMARY:

Transforms from focal plane to CCD coordinates

USAGE:

fp2ccd(float xfp, float yfp, float* xccd, float* yccd, float lambda, char cam[])

xfp, yfp	focal plane coordinates
xccd, yccd	CCD coordinates
lambda	wavelength
cam	camera = LONG/SHORT

RETURN:

CCD chip #. 0 => position not on a CCD

Getchipdat

SUMMARY:

Returns data on chip arrangement and dewar offset

USAGE:

Getchipdat(int* nc, int* xc, int* yc, float* scale, float* theta, int* sx14, int* sy14, int* sx58, int* sy58)

nc	number of chips
xc,yc	x,y coordinates of chip corners
scale	scale
theta	dewar rotation angle
sx,y14	x,y coordinate sign for chips 1-4
sx,y58	x,y coordinate sign for chips 5-8

RETURN:

none

mspos

SUMMARY:

Transforms pixel coordinates to mosaic coordinates

USAGE:

ccd8( int chip, float xccd, float yccd, float* x8, float* y8)

chip	chip
xccd,yccd	pixel coordinate on chip
x8,y8	mosaic coordinates

RETURN:

0

Readcdf

SUMMARY:

Reads in camera definition file. Must be called before first call to fp2ccd, Getchipdat, ccd8, or mspos.

USAGE:

Readcd(char filename[])

filename

name of camera definition file (e.g. 'SITE')

RETURN:

0	if successful
1	if unsuccessful

Readcof

SUMMARY:

Reads in dewar offset file. Must be called before first call to fp2ccd, Getchipdat, ccd8, or mspos

USAGE:

Readcof(char filename[])

filename

name of dewar offset file

RETURN:

0	if successful
1	if unsuccessful

Other Routines

interpol

SUMMARY:

Interpolates within a 2-d data array. f_interpol interpolates in a float array, i_interpol in an integer array.

USAGE:

f_interpol(float** array, long naxes[], float xpos, float ypos)
i_interpol(int** array, long naxes[], float xpos, float ypos)

naxes is an array containing axis dimensions

RETURN:

interpolated value

OpenCosParm

SUMMARY:

Opens COSMOS parameter files from COSMOS_PAR_DIR evironmental variable.

USAGE:

OpenCosParm(char* program-name)

read in parameter values with ReadParm_x

RETURN:

0	if successful
1	if unsuccessful

OpenFitsFile

SUMMARY:

Uses fitsio routines to open a fits file. Returns a file pointer, and a data structure with file information.

USAGE:

OpenFitsFile(char* filename, fitsfile* fileptr, fitsdef* fitsdata);

fitsdef contains the following elements:

int	naxis	number of axes
int	naxes[n]	size of each axis
int	bitpix	bits/pixel
int	binning	binning
int	subrstr	subraster?1=yes 0=no
int	subx[2]	x subraster indices
int	suby[2]	y subraster indices
int	overscan	number of overscan columns
int	biaslins	number of bias rows
char	dewarori[2]	dewar orientation Nor NS
int	nshuffle	# of pixels of shuffle 0 if not n&s mode
float	ranod	ra nod, in arc sec
float	decnod	dec nod, in arc sec

RETURN:

0	if successful
1	if unsuccessful

ReadObsDef

SUMMARY:

Reads data from an observation definition file and returns in a data structure

USAGE:

ReadobsDef(char* obsdeffilename,obsdef* obssdata);

obsdef containes the following elements:

int	gr_order	number of axes
int	gr_angle	size of each axis
float	temp	temperature
char	grating[20]	grating
char	dewoff[80]	dewar offset filename
char	camera[6]	LONG or SHORT
char	mode[7]	DIRECT or SPEC
char	mask[80]	SMF filename
char	dewar[5]	SITE
int	nshuffle	# of pixels of shuffle 0 if not n&s mode
float	ranod	ra nod, in arc sec
float	decnod	dec nod, in arc sec

RETURN:

0	if successful
1	if unsuccessful

ReadParm

SUMMARY:

Reads parameter values from parameter file opened with OpenCosParm

USAGE:

ReadParm_s(char* paramname, char* paramval) for strings
ReadParm_i(char* paramname, int* paramval) for integers
Readparm_r(char* paramname, float* paramval) for reals

RETURN:

0	if successful
1	if unsuccessful

Back to Table of Contents