User Tools

Site Tools


kuiper:link_to_the_instructions

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

kuiper:link_to_the_instructions [2017/12/01 11:56]
mel created
kuiper:link_to_the_instructions [2017/12/01 12:47] (current)
mel
Line 1: Line 1:
 Postprocessing with Watcher and Merge4k Postprocessing with Watcher and Merge4k
  
-Watcher is a script that automatically converts each incoming Extended FITS images from bigccd into a normal FITS image on Grard, using merge4k, then displays the newly merged fits image in the ds9 window.  After the image is displayed, watcher can also optionally execute any other script that the observer wishes to run.  +Watcher is a script that automatically converts each incoming Extended FITS images from bigccd into a normal FITS image on Gerard, using merge4k, then displays the newly merged fits image in the ds9 window.  After the image is displayed, watcher can also optionally execute any other script that the observer wishes to run.  
  
-(Note that the previous quicklook display had fatal bugs, so it is currently turned off by default at startup; you can also turn it off by tyling "quicklook off" in an window.)+(Note that the previous quicklook display had fatal bugs, so it is currently turned off by default at startup; you can also turn it off by typing "quicklook off" in any window.)
  
 In order to make watcher more robust - so it doesn't crash due to interference with processes in other windows, misses fewer incoming images, etc - a watcher subdirectory has been created with its own separate uparm directory.   In order to make watcher more robust - so it doesn't crash due to interference with processes in other windows, misses fewer incoming images, etc - a watcher subdirectory has been created with its own separate uparm directory.  
  
 To start watcher correctly, open a terminal window, and type  To start watcher correctly, open a terminal window, and type 
 +
 ./watcher_window ./watcher_window
  
-This will pop up a new iraf window that is already cd'ed to the wacher subdirectory.  In this window, the tasks and definitions that watcher needs are alread loaded.+This will pop up a new IRAF window that is already cd'ed to the watcher subdirectory.  In this window, the tasks and definitions that watcher needs are already loaded.
  
 lpar watcher lpar watcher
  
-If you don't want to run an optional script, either epar watcher to set extras="", or else tyoe +If you don't want to run an optional script, either epar watcher to set extras="", or else type 
  
 watcher.extra="" watcher.extra=""
  
-If yu're doing light curves, you should set extras = auto_plot+If you're doing light curves, you should set extras = auto_plot
  
 You can either cd to your data directory first (the same directory where bigccd will send the images ) and type You can either cd to your data directory first (the same directory where bigccd will send the images ) and type
Line 26: Line 27:
 Or just type watcher Or just type watcher
  
-and it will request the name of your data directory.  You may specify the directory names in full, or relative to /home/bigobs (e.g. "sdb/15mar11/hwvir.raw") or relative to your current directory (e.g. "." or "../16mar11"/pg1336.raaw).+and it will request the name of your data directory.  You may specify the directory names in full, or relative to /home/bigobs (e.g. "sdb/15mar11/hwvir.raw") or relative to your current directory (e.g. "." or "../16mar11"/pg1336.raw).
  
-Watcher will announce "watcher started".  The it will sit and wait for a new image to be tranferred to Gerard, whereupon it will run merge4k on that image.   Merge4k converts/combines the raw Extended FITS images into a normal single FITS image, after first correcting each side separately for the croostalk and for the overscan regions.  The original Extended FITS image is saved in a subdirectory named "raw", and the mered image is renamed to have the same name in the orifinal directory.  When mere4k is completed for that image, the watcher script will display the image in the ds9 window, optionally run the requested extra script, then start watching for the next image.  +Watcher will announce "watcher started".  Then it will sit and wait for a new image to be transferred to Gerard, whereupon it will run merge4k on that image.   Merge4k converts/combines the raw Extended FITS images into a normal single FITS image, after first correcting each side separately for the crosstalk and for the overscan regions.  The original Extended FITS image is saved in a subdirectory named "raw", and the merged image is renamed to have the same name in the original directory.  When mere4k is completed for that image, the watcher script will display the image in the ds9 window, optionally run the requested extra script, then start watching for the next image.  
  
-It is useful to reduce the watcher window to a few lines in height and place it under the ds9 image, so that you can see what it's doing as it detects converts, and displays your images. +It is useful to reduce the watcher window to a few lines in height and place it under the ds9 image, so that you can see what it's doing as it detectsconverts, and displays your images. 
  
-If you need to stop watcher, tpe control-c in the watcher window, followed by a flpr or two.+If you need to stop watcher, type control-c in the watcher window, followed by a flpr or two.
  
-Merge4k was written to work properly with images of arbitrary numbers of columns and rows and binning; it readed the header and works with whatever image size and binning exist.  +Merge4k was written to work properly with images of arbitrary numbers of columns and rows and binning; it reads the header and works with whatever image size and binning exist.  
  
 => Until the version of IRAF running on Gerard gets updated, you will see that 3x3 binned images are 1365 pixels in the x direction instead of 1364; there is an extra (junk) column on the far right => Until the version of IRAF running on Gerard gets updated, you will see that 3x3 binned images are 1365 pixels in the x direction instead of 1364; there is an extra (junk) column on the far right
  
-Every now and then, watcher will miss an image.  You can discover whether this has happened to any of your images by typin:+Every now and then, watcher will miss an image.  You can discover whether this has happened to any of your images by typing:
  
 imhead *.fits | grep FX imhead *.fits | grep FX
  
-Any unmerged or improperly merged inamges give an error that looks like: <image_name>:FXF: must specify which FITS extension (<image_name> All you have to do is to run merge4k on the images manually, eg:+Any unmerged or improperly merged images give an error that looks like: <image_name>:FXF: must specify which FITS extension (<image_name> All you have to do is to run merge4k on the images manually, eg:
  
 merge4k <image_name> merge4k <image_name>
Line 52: Line 53:
 dir raw/<image_name> dir raw/<image_name>
  
-If it is there, you can almost alwats successfully reprocess that image by moving the raw image to the observing directory and reprocessing it.  +If it is there, you can almost always successfully reprocess that image by moving the raw image to the observing directory and reprocessing it.   
 + 
 +del <image_name> 
 +rename raw/<image_name>
 +merge4k <image_name>
kuiper/link_to_the_instructions.1512154595.txt.gz · Last modified: 2017/12/01 11:56 by mel