SPYDR(1)						      General Commands Manual							  SPYDR(1)

NAME

       spydr - GUI for Image display and analysis with yorick

SYNOPSIS

       Spydr (pronounce spider) can be invoqued from the shell
	 spydr [ options ] image1.fits [ image2.fits ... ]
	 where the fits images can contain single images (not necessarily of the same size) or data cube. Widlcards are allowed in names.

       or within yorick
	  #include spydr.i
	  spydr,im1,im2,cube
	  spydr,"image1.fits",...

COMMAND LINE OPTIONS

       --conf file
	      configuration file.

       --hdu value
	      Specify a fits HDU to read

       --dpi value
	      Yorick dpi value (yorick default = 75, spydr default = 83). Any value between 30 and 150 make sense.

       --itt value
	      Intensity Transfer Table (1=linear, 2=sqrt, 3=square, 4=log, 5=hist equalized)

       --pixsize value
	      Pixel size (or plate scale) in arcsec.

       --boxsize value
	      Size of box for PSF fitting and Strehl calculation (pixels)

       --saturation value
	      Value above which pixels have to be considered as saturated (ADU)

       --wavelength value
	      Force wavelength for all images

       --zeropoint value
	      Photometric zeropoint (magnitude)

       --nbins value
	      Number of bins for histograms

       --strehlaper value
	      Diameter	of  circular  mask for Strehl calculations (pixels). The flux is integrated in a circle of this diameter, while the sky is
	      estimated from the remaining pixels within the box of size "boxsize"

       --batch
	      Turn on yorick batch mode (yorick quits when encountering an error). This flag is recommended when starting spydr from a	non-inter-
	      active session (e.g. from a gnome applet).

       --debug
	      Turn on the verbose mode (debugging mode).

       --invert
	      Invert LUT

       --fullgui
	      Show the plugin pane when the GUI is realized

       --compact
	      Hide the lower part of the GUI at startup

DESCRIPTION

       Spydr  is  a  GUI for image visualization and simple analysis (cuts, zoom, values, statistics, histogram, sigma filter) with changeable LUT
       and ITT. Spydr has a couple of plugins to measure FWHM and Strehl. Press "?" on the main display area to get a popup help:

       The following shortcuts are available:
	x/y: Plot line/column under cursor
	X/Y: Toggle continuous plot of line/column
	      under cursor
	c:   Interactive plot of cut across image
	h:   Plot histogram of visible region
	r:   Radial plot centered on cursor
	f:   Fit 1d gaussian to 1d plot
	e:   Adjust min and max cut to 10% and 99.9%
	     of distribution
	E:   Reset min and max cut to min and max
	     of visible region
	n/p: Next/prevous image
	s:   Sigma filter displayed image
	-/+: Decrease/Increase zoom factor in zoom window
	?:   This help

EXAMPLES

	From the shell:
	$ spydr --dpi 74 --fullgui 20070730_2*.fits
	$ spydr --pixsize 0.127 20070730_2[2-3]?.fits 20070730_241.fits

	Within yorick:
	> spydr,"~/ascam/2007jun26/20070625T2000*.fits"
	> spydr,["20070730_1[1-3].fits","20070730_23.fits"]
	> spydr,image
	> spydr,[im1,im2]
	> spydr,im1,im2

ENVIRONMENT VARIABLES

       Y_PYTHON
	      Force the path to spydr.py. The default path is

	      ./:Y_USER:Y_USER/python/:Y_SITES/python/:Y_SITE/python/

       Y_GLADE
	      Force the path to spydr.glade. The default path is

	      ./:Y_USER:Y_USER/glade/:Y_SITES/glade/:Y_SITE/glade/

       Y_CONF Force the path to spydr.conf. The default path is

	      ./:Y_USER:Y_SITE:/etc/:
	      ./share/:Y_USER/share/:Y_SITE/share/:
	      ./share/spydr/:Y_USER/share/spydr/:Y_SITE/share/spydr/

RESTRICTIONS AND BUGS

	- only fits images handled to date
	- the ITT display is not very well handled

AUTHOR

       Francois Rigaut, Gemini Observatory

FILES

       Input files:

       spydr.conf  The spydr configuration file. Needed. It should have come with your installation. The  routine  which_spydrconf()  returns  the
		   path  to  the  used	spydr.conf.  The  following  directories are searched for spydr.conf, in this order: Y_USER, Y_SITE, /etc,
		   Y_USER/share, Y_SITE/share, Y_USER/share/spydr, Y_SITE/share/spydr. If you wish to modify the defaults, copy the file  over	to
		   Y_USER and modify at will.

       Output files: none.

SEE ALSO

       yorick(1), yao(1)

4th Berkeley Distribution					  2008 January 02							  SPYDR(1)