DETMON Pipeline Reference Manual  1.3.0
Functions
Functions for accessing catalogues

Functions

int irplib_2mass_get_catpars (const cpl_frame *master_index, char **catpath, char **catname)
 Find the name of the standard catalogue being used and its location. More...
 
cpl_error_code irplib_cat_get_image_limits (const cpl_wcs *wcs, float ext_search, double *ra1, double *ra2, double *dec1, double *dec2)
 Get coverage in ra, dec of a frame. More...
 
cpl_table * irplib_2mass_extract (char *path, float ramin, float ramax, float decmin, float decmax)
 Extract standards from the 2mass catalogue. More...
 
cpl_table * irplib_match_cat_pairs (cpl_table **catalogues, int ncats, int(*binary_match_condition)(cpl_table *catalogue1, cpl_table *catalogue2, intiobj1, intiobj2))
 Finds all the objects that appear at least in some of the catalogues. More...
 

Detailed Description

Function Documentation

cpl_table* irplib_2mass_extract ( char *  path,
float  ramin,
float  ramax,
float  decmin,
float  decmax 
)

Extract standards from the 2mass catalogue.

Parameters
pathThe full path to the catalogue FITS files and index.
ramin1The minimum RA, this can be negative in the case the area wraps around the equinox.
ramax1The maximum RA
decminThe minimum Declination
decmaxThe maximum Declination
Returns
A table structure with the extracted catalogue objects
 The FITS tables containing the 2mass psc catalogue are searched
 to find all of the objects within an input equatorial area. Deals

with the sigularity at the equinox, but not at the poles.

Definition at line 276 of file irplib_cat.c.

int irplib_2mass_get_catpars ( const cpl_frame *  master_index,
char **  catpath,
char **  catname 
)

Find the name of the standard catalogue being used and its location.

Parameters
indexThe frame for the index FITS file
catpathThe full path to the catalgoue FITS files
catnameThe name of the catalogue
Returns
CPL_ERROR_NONE if sucess CPL_ERROR_FILE_IO if the file does not exist or the header cannot be read.

Find the name of the standard catalogue being used and its location. The former should be in a header keyword in the specified FITS file. The latter is the full path of the FITS file. Both values need to be deallocated when you're finished with them.

Definition at line 75 of file irplib_cat.c.

cpl_error_code irplib_cat_get_image_limits ( const cpl_wcs *  wcs,
float  ext_search,
double *  ra1,
double *  ra2,
double *  dec1,
double *  dec2 
)

Get coverage in ra, dec of a frame.

Parameters
plistInput property list
ext_searchFactor for an extra box search.
ra1Lower RA
ra2Upper RA
dec1Lower Dec
dec2Upper Dec
Returns
CPL_ERROR_NONE if sucess. CPL_ERROR_DATA_NOT_FOUND if wcs is not valid

Given a WCS solution this routine works out the min and max equatorial coordinates covered by the image.

Definition at line 154 of file irplib_cat.c.

cpl_table* irplib_match_cat_pairs ( cpl_table **  catalogues,
int  ncats,
int(*)(cpl_table *catalogue1, cpl_table *catalogue2, intiobj1, intiobj2)  binary_match_condition 
)

Finds all the objects that appear at least in some of the catalogues.

Parameters
cataloguesAll the catalogues
ncatsNumber of catalogues
Returns
The matching table if sucess, NULL otherwise.

Implementation notes:

cat_indexing_order tells you in which order the catalogues are being iterated. For example cat_indexing_order[2] gives the index of the catalogue that is being iterated in the 3rd postion.

Definition at line 126 of file irplib_match_cats.c.