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.
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.
cpl_table * irplib_2mass_extract (char *path, float ramin, float ramax, float decmin, float decmax)
 Extract standards from the 2mass catalogue.
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.

Function Documentation

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

Extract standards from the 2mass catalogue.

Parameters:
path The full path to the catalogue FITS files and index.
ramin1 The minimum RA, this can be negative in the case the area wraps around the equinox.
ramax1 The maximum RA
decmin The minimum Declination
decmax The 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 280 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:
index The frame for the index FITS file
catpath The full path to the catalgoue FITS files
catname The 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:
plist Input property list
ext_search Factor for an extra box search.
ra1 Lower RA
ra2 Upper RA
dec1 Lower Dec
dec2 Upper 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:
catalogues All the catalogues
ncats Number 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.


Generated on 3 Mar 2013 for DETMON Pipeline Reference Manual by  doxygen 1.6.1