Example Catalog Config Entry

 
Here is an example catalog config entry for a catalog implemented by a local command: 
serv_type:     catalog 
 
long_name:     My test catalog 
 
short_name:    test1@local 
 
url:           /usr/local/bin/test1.cat \
                     -pos "%ra %dec" \
                     -radius "%r1 %r2 " \
                     -cond "%cond" \
                     -sort "%sort" \
                      -sortorder %sortorder 
 
symbol:        "mag pa a/b" "ellipse red ${a/b} $pa mag=$mag" 15-$mag
 
search_cols:   mag "Brightest (min)" "Faintest (max)" \ 
                : pos-e "Min Pos Err" "Max Pos Err" \ 
                : ppa "Min ppa" "Max ppa" 
 
sort_cols:     mag ppa 
sort_order:    decreasing 
id_col:        2 
ra_col:        3 
dec_col:       4

This entry defines a catalog with the name " My test catalog " (alias test1@local ) that is implemented by a local command (script or application) /usr/local/bin/test1.cat . A user interface, such as the catalog window in Skycat , will display entries to enter min and max values for mag , pos-e and ppa . The entries will be labeled Brightest (min): , Faintest (max): , and so on.

When a query is made, the command (test1.cat) will be called with the argument variables expanded. For example:

 

    /usr/local/bin/test1.cat \
        -pos "03:19:48.24 +41:30:40.31" \
        -radius "0 10" \
        -cond "mag=0,15&pos-e=0,1&ppa=45,90" \
        -sort "mag,ppa" \
        -sortorder decreasing

The command should output a query result in tab table format. In this case the column indexes for the id , ra and dec fields are 2, 3 and 4, resp. An image display application such as Skycat will then plot each row of the result as a red ellipse with the ratio ${a/b}, and the angle $pa and label each object with the label "mag=$mag".