---
name: "spydr"
section: "1"
platform: "linux"
package: "yorick-spydr"
version: "0.8.2-3"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/spydr"
---

# spydr(1)

GUI for Image display and analysis with yorick

## 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-interactive 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)](/yorick/1.md), [yao(1)](/yao/1.md)