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:
src table containing column col
col column name
operator CPL relational operator
value reference value
nsrc number 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:
src table containing column col
col column name
operator CPL relational operator
value reference value
nsrc number 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:
src table containing column col
col column name
operator CPL relational operator
value reference value
nsrc number 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:
src table containing column col
col column name
operator CPL relational operator
value reference value
nsrc number 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:
plist Property list contaning NAXIS information
fudge Refining the search
from Matrix with pixel coordinates
ra1 Output initial RA coordinate
ra2 Output final RA coordinate
dec1 Output initial DEC coordinate
dec2 Output final DEC coordinate
Returns:
0 if everything is OK or -1 in case of error.

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:
stdcat pathname of std table
coords vector 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:
catalog cpl_frame of usnoa2 master table
coords vector 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:
objtbl Objects table
stdstab Catalog table
srad radius for match in pixels
outtab output 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:
sci Name of science image
conf Name of weight map
pars Parameter 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().


Generated on 11 Mar 2013 for OMEGA Pipeline Reference Manual by  doxygen 1.6.1