Select points using an interactive cursor. You can use a box to select groups of points. You may also select or de-select single points. You can select points for viewing images (or sources) that are associated with that point. The data are read from and written to a file named xyf.in.

% point_selector --help    

Usage: point_selector margdist_sub pixel mean N 
arg1 - basename of the table file ("Phot_Data" for Phot_Data.table)  
arg2 - parameter name for X axis  
arg3 - parameter name for Y axis  
arg4 - run in debug mode? (Y/N) 

This takes a table file (basename = TABNAME) and creates xyf.in file. The script allows the user to view the (X,Y) and mark points. The interactive cursor operation is currently perfomed with the python script icurs5.py:

/home/sco/Installs/install_sco_20180522/codes/python/cursor/icurs5.py

Example run: 
  % point_selector TABNAME uth bmean N   

Some important points: 

 - Unlike codes like xyplotter_auto, we must use viable names for the 
   parameters that go into the arg2,arg3 positions. 

 - The table basename (arg1) is a string, but it can include a unix-path.
   For example, we could use the string:  ./table_files/July2020/TABNAME 

 - The marked (and unmarked) points are flagged in the local output file 
   named xyf.in.

 - The key entries that are recognized by point_selector:
     key    function 
      v     View (in ds9) the image associate with the selected point 
      p     Select the point closest to the cursor    (uses pointclean.sh)
      u     Deselect the point closest to the cursor  (uses pointclean.sh) 
      b     Mark all points in the current box as selected 
      m     Simply record the cuurent marked position of the cursor 
      E     End the marking operation 
 

The file named "xyf.in" is used for a lot of important communication with downstream routines. For instance, If we want to compute statistics of the marked (or unmarked) points we use this file.

Here is the structure of a typical xyf.in file:       
% head xyf.in
Keys for icurs5.py                                                              
UT in hours                                                           
Mean BIAS signal (adu)                                                
     22.5045    1389.8717    0           1
     22.5076    1390.0443    0           2
     22.5106    1390.0308    0           3
     22.5136    1390.0020    0           4