OMEGA Pipeline Reference Manual  1.0.5
Functions
Catalogues

Functions

cpl_table * omega_filter_table_double (cpl_table *src, const char *col, cpl_table_select_operator operator, double value, int *nsrc)
 Filter a table with a column of type double.
cpl_table * omega_filter_table_float (cpl_table *src, const char *col, cpl_table_select_operator operator, float value, int *nsrc)
 Filter a table with a column of type float.
cpl_table * omega_filter_table_int (cpl_table *src, const char *col, cpl_table_select_operator operator, int value, int *nsrc)
 Filter a table with a column of type integer.
cpl_table * omega_filter_table_string (cpl_table *src, const char *col, cpl_table_select_operator operator, const char *value, int *nsrc)
 Filter a table with a column of type string.
int omega_get_coverage (cpl_propertylist *plist, int fudge, cpl_matrix *from, double *ra1, double *ra2, double *dec1, double *dec2)
 Get the Ra and Dec coverage of an image.
cpl_table * omega_get_stds_table (const char *stdcat, cpl_vector *coords, int *nstds)
 Read standard reference fits table and return a fits table that contains stars in a given region.
cpl_table * omega_get_usnoa_table (const cpl_frame *catalog, cpl_vector *coords, int *nstds)
 Read master usnoa2 fits table and return a fits table that contains stars in a given region.
int omega_matchstds (cpl_table *objtab, cpl_table *stdstab, float srad, cpl_table **outtab)
 Find matches between two catalogues.
cpl_table * omega_science_catalogue (const char *sci, const char *conf, double zeropoint_final, cpl_parameterlist *pars)
 Create a catalogue from a science frame.

Detailed Description

This module provides functions to manipulate USNOA2 and reference standard star catalogues.

Synopsis:
Functions to manipulate catalogues
#include "omega_catalog.h"

Function Documentation

cpl_table* omega_filter_table_double ( cpl_table *  src,
const char *  col,
cpl_table_select_operator  operator,
double  value,
int *  nsrc 
)

Filter a table with a column of type double.

Parameters:
srctable containing column col
colcolumn name
operatorCPL relational operator
valuereference value
nsrcnumber of selected rows in table
Returns:
out table with only rows fulfilling criterium
 It will select from unselected rows only the rows that fulfill the condition

Definition at line 800 of file omega_catalog.c.

cpl_table* omega_filter_table_float ( cpl_table *  src,
const char *  col,
cpl_table_select_operator  operator,
float  value,
int *  nsrc 
)

Filter a table with a column of type float.

Parameters:
srctable containing column col
colcolumn name
operatorCPL relational operator
valuereference value
nsrcnumber of selected rows in table
Returns:
out table with only rows fulfilling criterium
 It will select from unselected rows only the rows that fulfill the condition

Definition at line 868 of file omega_catalog.c.

Referenced by omega_match_points(), and omega_zeropoints().

cpl_table* omega_filter_table_int ( cpl_table *  src,
const char *  col,
cpl_table_select_operator  operator,
int  value,
int *  nsrc 
)

Filter a table with a column of type integer.


Parameters:
srctable containing column col
colcolumn name
operatorCPL relational operator
valuereference value
nsrcnumber of selected rows in table
Returns:
out table containing only rows fulfilling criterium
 It will select from unselected rows only the rows that fulfill
 the condition.

Definition at line 766 of file omega_catalog.c.

Referenced by omega_match_points(), omega_photom_tbl(), and omega_science_catalogue().

cpl_table* omega_filter_table_string ( cpl_table *  src,
const char *  col,
cpl_table_select_operator  operator,
const char *  value,
int *  nsrc 
)

Filter a table with a column of type string.

Parameters:
srctable containing column col
colcolumn name
operatorCPL relational operator
valuereference value
nsrcnumber of selected rows in table
Returns:
out table with only rows fulfilling criterium
 It will select from unselected rows only the rows that fulfill the condition

Definition at line 834 of file omega_catalog.c.

int omega_get_coverage ( cpl_propertylist *  plist,
int  fudge,
cpl_matrix *  from,
double *  ra1,
double *  ra2,
double *  dec1,
double *  dec2 
)

Get the Ra and Dec coverage of an image.

Functions to handle catalogues and tables.

Parameters:
plistProperty list contaning NAXIS information
fudgeRefining the search
fromMatrix with pixel coordinates
ra1Output initial RA coordinate
ra2Output final RA coordinate
dec1Output initial DEC coordinate
dec2Output final DEC coordinate
Returns:
0 if everything is OK or -1 in case of error.

Definition at line 226 of file omega_catalog.c.

Referenced by omega_match_points(), and omega_photom_tbl().

cpl_table* omega_get_stds_table ( const char *  stdcat,
cpl_vector *  coords,
int *  nstds 
)

Read standard reference fits table and return a fits table that contains stars in a given region.

Parameters:
stdcatpathname of std table
coordsvector with 4 fields, RA min,RA max, DEC min, DEC max nstds NULL (number of sources to be populated by function)
Returns:
A table with all the standards in the field
 Input reference table has the following structure:
SeqNr origin Name Ra Ra_err Dec Dec_err Epoch Flag JohnsonU JohnsonU_err etc. for
JohnsonB JohnsonV CousinsR,I SloanU,G,R,I,Z

Definition at line 701 of file omega_catalog.c.

Referenced by omega_photom_tbl().

cpl_table* omega_get_usnoa_table ( const cpl_frame *  catalog,
cpl_vector *  coords,
int *  nstds 
)

Read master usnoa2 fits table and return a fits table that contains stars in a given region.

Parameters:
catalogcpl_frame of usnoa2 master table
coordsvector with 4 fields, RA min,RA max, DEC min, DEC max nstds NULL (number of sources to be populated by function)
Returns:
all table of all standards in the field Input master table has the following structure: USNOA2_CAT RA_min RA_max Dec_min Dec_max N_sources

Each usno FITS table contains sources in the whole range of RA divided in slices of 1.5 degrees in DEC. The structure of these tables is: USNO_A2_number RA2000 Dec2000 MagB MagR Plate

Definition at line 595 of file omega_catalog.c.

References omega_get_pathname().

Referenced by omega_match_points().

int omega_matchstds ( cpl_table *  objtab,
cpl_table *  stdstab,
float  srad,
cpl_table **  outtab 
)

Find matches between two catalogues.

Parameters:
objtblObjects table
stdstabCatalog table
sradradius for match in pixels
outtaboutput table with matches
Returns:
the number of matches

It assumes that the two catalogues are sorted by the Y coordinate

Definition at line 353 of file omega_catalog.c.

Referenced by omega_photom_tbl().

cpl_table* omega_science_catalogue ( const char *  sci,
const char *  conf,
double  zeropoint_final,
cpl_parameterlist *  pars 
)

Create a catalogue from a science frame.

Parameters:
sciName of science image
confName of weight map
parsParameter list
Returns:
A cpl_table with the catalogue or NULL in case of error.

Definition at line 898 of file omega_catalog.c.

References omega_filter_table_int().