file: 00-Readme.txt for rjr-idl directory
init: Aug  7 2010 Rob Rutten  LA Deil
last: Sep 29 2013  Rob Rutten
site: http://www.staff.science.uu.nl/~rutte101/rrweb/rjr-idl
note: these are IDL/SSW routines that I have often spread to DOT students.
      They are discussed in ../rjr-edu/manuals/idl-cube-manual.txt.
      Calls without parameters give parameter specifications.


cubeslicer.pro is an ancient program from Christiaan Balke to slice 1,
  2, or 3 3D bytescaled (x,y,t) cubes simultaneously.  It plays x-y
  movies (mouse right button forward, middle button backard) plus
  simultaneous x-t space-time slice as defined by the cursor defined
  by the cross hairs over the first movie panel.
    Quit: type q in the calling IDL window.
    Parameters: hit space to get a menu.
  An up-to-date alternative is Alfred de Wijn's xslice.pro on SolarSoft:
    xslice,cube1,root=root 
    xslice,cube2,root=root   etc. 

cubeximovie.pro is a wrapper to use ximovie.pro (see below) on 1 or 2
  data cubes in memory, by writing them as fitsfiles on /tmp and then
  calling fitsximovie.pro (see below) to assoc into these.  Type
  ximovie for the _extra keywords.

DOT-2004-10-14-gb.fits	
DOT-2004-10-14-ca.fits	
  Two small data cubes from the Dutch Open Telescope for demo
  use in my "Simple IDL manual for astronomy students" at
  http://www.staff.science.uu.nl/~rutte101/Manuals.html, with gb = G band, 
  ca = Ca II H line center, only a quarter of the DOT field of view,
  temporal cadence 30s, bytes.

fitsximovie.pro calls ximovie.pro (see below) for data cubes in the
  form of fits files.  You don't have to specify the nx and ny
  dimensions, nor the data type or endian type.  Type ximovie for the
  _extra keywords.  Run in SolarSoft ssw.

frimage.pro is an ancient annotated-image plotter in which I tried to
  obtain identical output on the screen and in postscript (dating from
  when there was no postscript viewer but only printer access so that
  previewing required printing).  For some unclear reason you have to
  run it twice at startup.  Better use newer image plot programs as
  Coyote cgimage.

plotconfusogram.pro plots spatially-averaged Fourier phase difference
  spectra between two (x,y,t) data cubes, together with the
  spatially-averaged power spectra and coherence spectrum.  The
  "confusogram" format was initially developed by Bruce Lites and
  applied by Thijs Krijger and Alfred de Wijn in their PhD theses.
  This program is a paste-together of Alfred de Wijn's routines.

plotkophasediff.pro plots a "k-omega" phase difference diagram as
  function of horizontal wavenumber k_h and temporal frequency f.
  Also an Alfred de Wijn routine collage.

plotkopower.pro plots a "k-omega" power diagram as function of
  horizontal wavenumber k_h and temporal frequency f.  Also an Alfred
  de Wijn routine collage.

plotpowermap.pro plots a Fourier power map for a specified frequency
  band using frimage.pro.  Setting detrend=1 slows it down; detrend=2
  makes it very slow.  The same transformed data cube can be
  re-accessed via keyword olddata.  Also an Alfred de Wijn routine
  collage.  It uses frimage.pro.

plotscatter.pro replaces my old scatcont.pro.  It plots a scatter
  diagram using point density contours instead of individual sample
  points to avoid plot saturation (as suggested by Louis Strous who
  did so in his thesis). Also an Alfred (and Harold) de Wijn routine
  collage.

readdotcube.pro reads a DOT data cube, from Tim van Werkhoven.  It
  gleans the dimensions from the DOT-convention filename.  Options:
  read only a part of the sequence, return it bytescaled.

scatcont.pro produces pixel-by-pixel scatter plots for two arrays.
  The idea (from Louis Strous) is to replace saturated point clusters
  by contours.  Many people have contributed to it but it isn't
  robust.  Use plotscatter.pro with Alfred de Wijn's routine instead.

ximovie.pro is a slick movie player written by Oyvind Wikstol at ITA
  Oslo.  It sits hidden under hinode/eis/idl/util in SolarSoft so I
  copied it here.  It reads input files with assoc and therefore can
  play unlimited-size data cubes.  It can accept a second cube file
  and then blink or alternate the two movies.  You can adjust the
  color table and you can pull out small subareas to zoom in to.  My
  version has an option /bytsclind to bytescale each frame
  individually (for cubes representing an [x,y,wav] line profile scan
  rather then a [x,y,t] time sequence).  See also fitsximovie and
  cubeximovie above.

