OMEGA Pipeline Reference Manual  1.0.6
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. More...
 
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. More...
 
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. More...
 
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. More...
 
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. More...
 
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. More...
 
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. More...
 
int omega_matchstds (cpl_table *objtab, cpl_table *stdstab, float srad, cpl_table **outtab)
 Find matches between two catalogues. More...
 
cpl_table * omega_science_catalogue (const char *sci, const char *conf, double zeropoint_final, cpl_parameterlist *pars)
 Create a catalogue from a science frame. More...
 

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().