ds9_view_markII

View a FITS image in a ds9 gui. This is an exanpsion of ds9_view. It has some more display features, but the most significant addition is an online help page. I simply copy the help page info here.

 
% ds9_view_markII --help  
Help Information for:  ds9_view_markII

Usage: ds9_view_markII a.fits 1.0 2000.0 1 A
arg1 - names of fits image to be viewed
arg2 - low display level (z1)
arg3 - high display level (z2)
arg4 - frame number to be used 
arg5 - region display (Q=query, A=always_display, N=never_display) 
z1,z2= (minmax n) or (zscale n) will work

I will show: /home/sco/sco/codes/bash/HELP_FILES/ds9_view_markII.help

Enter any key to roceed with the view of help: Any 
ds9_view_markII: 
  Display a FITS image in a ds9 window that is already open. 

  The FITS file is displayed in the user-specified frame of a 
  ds9 window that is presumed to already be open (i.e. with a 
  routine like ds9_open). The z1,x2 greyscale level values can 
  input on the command line. However, the easier way is to use 
  the "minmax n" or "zcsale n" arguments instead. This will give 
  a pretty goo initial view for most astronomical images. 

  One useful option is the last one: the region (reg) display 
  flag. If a fds9 regions file is present (i.e. FITSNAME.reg) 
  then this routine will ALWAYS plot that file if reg="A". If 
  reg="N" then the file will NEVER be automatically plotted. If
  reg="Q", then the user will be QUERIED as to whether the regions 
  file should be plotted. 

  Typical examples (image name = Blah.fits):
   ds9_view_markII Blah.fits 100.0 23000.0 1 A   # Use z1=100.0 and z2=23000.0 
   ds9_view_markII Blah.fits minmax n 2 Q        # display in frame 2, query for regions

The normal usage message will still appear should you not have the proper number of command line arguments.




Back to SCO CODES page