ds9_multi_view

Use a ds9 window to view multiple images in different frames.


ds9_multi_view list1 1.0 2000.0 

arg1 - file listing other fits images
arg2 - low display level (z1)
arg3 - high display level (z2)

The base image is the first in the series that defines the initial image frame (i.e. the image that goes into frame 1). This base image is taken by ds9_multi_view to be the first image listed in the input file (list1 in the example above) This is meant to be used for the rather special case where the images shifts are small (i.e. smaller than the size of the marker used to identify the fiducial target in the base image.

A useful feature: Sometimes it is useful to overplot a regions file on every image. If you build a regions file named "show.reg" then it will be diplayed with every image viewd in ds9_multi_view. This can be very useful for identifying particualr images in a long listing.

More Notes: Sometimes

I am finding more useful features of xpa+ds9 when I have multiple frames loaded:

 
To get a list of all frames loaded:
% xpaget ds9 frame all
1 2 3 4 5 

To view frame #3:
% xpaset -p ds9 frame 3

I have scripts "cds" that will dump the physical coordiantes of the 
current frame: 
% cds 

If there are no markers, then I just get an entry like:
% cat ds9.regions_save_cds

# Saved ds9 regions:Fri Sep  4 16:48:56 CDT 2015
# Region file format: DS9 version 4.1
# Filename: 20150824T082944.7_acm_sci.fits
global color=green dashlist=8 3 width=1 font="helvetica 10 normal roman" select=1 highlite=1 dash=0 fixed=0 edit=1 move=1 delete=1 include=1 source=1

When I have made some marker for a frame:
# Saved ds9 regions:Fri Sep  4 16:51:08 CDT 2015
# Region file format: DS9 version 4.1
# Filename: 20150824T083008.4_acm_sci.fits
global color=green dashlist=8 3 width=1 font="helvetica 10 normal roman" select=1 highlite=1 dash=0 fixed=0 edit=1 move=1 delete=1 include=1 source=1
physical
circle(361.66149,600.29969,23.050011)
circle(182.08075,402.76087,41.518109) # color=red
circle(488.56522,277.05435,17.817253)
box(550.22127,567.97516,49.085404,35.916149,0) # color=blue width=4

NOTE: In this early stage of "cds" I just dump any cds query to the 
      local file named "ds9.regions_save_cds". Results are always 
      appended to any existing "ds9.regions_save_cds" file. 



Back to SCO CODES page