table_mask_builder
Updated: May03,2020

Construct and use mask files based on text and/or floating point rules. Logically combine these masks and produce a final output table of selected rows. If the name of the output table is "none" then only the final mask file is bulit and the number of selected rows is sent to standard out. This option is available for when we might want to apply multiple rule sets, and then then combine all of the mask files into one mask using the routine masklogic.sh.


% table_mask_builder --help

This routine can use two types of rules: thos for text strings (text_ and ths for a foating point number range (fpr). In the first case we simply search for text string that match the input string, and in the second case we search for numbers in a given table column that lie within a specfiied numerial range. The rules are specified in the input rules file. I show examples using both types of rules below.


% table_mask_builder PFCRC3 Rules.1 B0 N  

% cat Rules.1  
PGC    text    42575  none 
fil    text    U      none
Type   fpr     -3.0   6.0  

This makes a table (B0) with my 7 U images of N4618 (=42575) 
% bigds9 B0.images 4 4             # to view the U images

Hence, the large (2022 table) PFCRC3 was queried for NGC4618 (parameter PGC = 42575) images that used the U filter (parameter fil = U). The 7 rows (i.e.images) satisfying these conditions were written to the B0 table. I show a simple example of how I might view these images quickly.

In the example below I demonstrate the use of this routine to isolate members in a table that hav g magnitudes in the range 14.0 to 18.0.



% cat ZPCLEAN.parlab 
ZPSEC    ZP for 1-sec exptime 
MeanSky  Mean sky in adu    
Fpeak    Flux peak (including bkg) 
g        g magnitude from PABSTARRS
r        r magnitude from PABSTARRS

% cat ZPCLEAN.table 
# data
      -2.648      75.896   13957.640      14.086      12.375
      -2.702      65.875    5290.610      19.133      14.428
      -2.699      73.421    4204.510      20.355      14.401
      -2.735      66.440    2212.590      16.016      15.040

% cat rules.1  
g    fpr   14.0  18.0 

% table_mask_builder ZPCLEAN rules.1 Bnew N  
  2     final_number

% cat Bnew.parlab 
ZPSEC    ZP for 1-sec exptime 
MeanSky  Mean sky in adu    
Fpeak    Flux peak (including bkg) 
g        g magnitude from PABSTARRS
r        r magnitude from PABSTARRS
 
% cat Bnew.table 
# data
 -2.648      75.896   13957.640      14.086      12.375
 -2.735      66.440    2212.590      16.016      15.040

Here we see that the column 4 values (the g magnitude column) have only values between 14.0 and 18.0.

Back to SCO CODES page