usno_look
Updated: Apr26,2016

This is a general purpose (bash) script that uses a variety of scocode tasks. An input RA,DEC and a field size were originally fed as input. An DSS image and USNO catalog for that area are collected and the user is shown the field in a ds9 window with the selected targets overplotted. This code was heavily ugraded Apr26,2016 do that targets could be overplotted with TEST labels alone. To execute usno_look:


%    
Usage: usno_look 08:13:15.10 +45:59:29.0 5.0 15.0 1 JustText 
arg1 - Ra J2000 in sexigecimal
arg2 - Dec J2000 in sexigecimal
arg3 - search Radius in arcmin
arg4 - faint V magnitude limit
arg5 - ds9 frame to display in 
arg6 - overplot code (S,G,SG,JustText,magR2,V)

Explanation of arg6:
  S        = plot labeled circles around STARS only 
  G        = plot labeled circles around GALAXIES only 
  SG       = plot labeled circles around STARS and GALAXIES 
  JustText = plot only target names (centered on targets) 
  magR2    = magR2 magnitudes (Second PSS Red mags) are added to the name labels 
  V        = V magnitudes are added to the name labels 

NOTE: Text labels are the Line Number from the input file (EXCLUDING header line!) 

NOTE2: 
I embeded the code get_font_attributes in usno_look. If you want 
a specific color ans size for the JustText labels, this will get it:
% cat Text.Defaults  
 blue 18 


A number of task are performed. First the dss.fits file for the requested field is retrieved (using dssg.sh). Next, the usno_grab (bash) script is used to retrieve the USNO sources for the field. The result of usno_grab is a cdfp (CoorDinate Floating Point catalog) file containing the sources. Finally, a specialized script, cdfp_usno_targs.sh, is run that takes user-specified ranges for the stellarity index (in usno_look we use sglo="5.5", sghi="11.5", and Vlim="19.5") that determines which USNO targets are to be recognized as stellar (i.e. those targets most useful for astrometry). The targets collect in this process are written to the local catalog named usno_targs.cdfp. In addition, some cummulative star density statistics are gathered. These values are summarized and explained in: cdfp_usno_targs.out and cdfp_usno_targs.explain. Finally a few ds9 regions files (gals.reg, stars.reg, cdfp2reg.type, etc...) are generated (with cdfp2reg.sh) and used to overplot targets on the DSS image when it is viewed with ds9. Stellar sources are plotted in RED, and non-stellar sources are plotted using CYAN markers. In Apri2016 I added (to cdfp2reg.f) to ability to simply label sources with just the Text Name (line number in the cdfp) coordinates and text. For this I use the plotcode = "JustText" value.

What is the primary result? A lot of things are done here, but the most fundamental file is usno_targs.cdfp. Here is a sample:
 

Ra_hrs,Dec_deg,Bmag,Rmag,SG,V,
  10.785385132  12.299997330       20.19      19.68       2.00      19.68
  10.786627769  12.293783188       20.33      19.68       1.00      19.73
  10.786748886  12.296005249       15.93      14.32       1.00      14.76
  10.787014008  12.293436050       20.77      19.57       2.00      19.84

The cdfp catalogs can be used by a lot of my scripts. The first few columns are obviously positions and magnitudes. The SG value is 1 for a stellar (star-like) source, and 2 for non-stellar. The final column is a V magnitude estimated from (Bmag,Rmag) using the transformation of Pelaez (2007).




Back to SCO CODES page