1 HEADER
          HEADER [Image_Name]

     List the Header of the current or specified Image.  The  header  of
the  current  image can only be listed (even if the image is mapped with
the /WRITE option), but for another image (and provided you  have  write
access  to it and nobody else is using it already), if the terminal is a
VT100 (or upward) compatible, the header is editable, that is,  one  can
wander  through  the  page  with  the VT100 keypad and the arrows (as in
EDT):
           +--------+--------+--------+--------+
           |  enter |        |        |  Del L |
           |  edit  |        |        |        |
           +--------+--------+--------+--------+
           |        |        |        |  Del W |
           |        |        |        |        |
           +--------+--------+--------+--------+
           | Advance| Backup |        |  Del C |
           |        |        |        |        |
           +--------+--------+--------+--------+
           |  Word  |   Eol  |  Char  |        |
           |        |        |        |  Enter |
           +--------+--------+--------+        |
           |       Line      |        |(Update)|
           |                 |        |        |
           +-----------------+--------+--------+
To edit an item, strike the GOLD key (Enter Edit), then use  keypad  and
arrows  as  in  EDT.   To compute MAXIMA and MINIMA of the image, strike
ENTER key.  Strike <^Z> to exit.
1 IMAGE
          [DISPLAY\]IMAGE [Filename] [/PLANE I1 I2] [/SUBSET  Imin  Imax
Jmin Jmax]

     Read the GDF map Filename.  The default  image  extension  is  .GDF
This  command  defines  the image found in given file as the new current
image to be used by next PLOT command.

     The /PLANE I1 I2 option allows  to  define  part  of  a  more  than
2-Dimensional  image  as  the  current image.  A file name should not be
specified if you want to select a new plane in the current image.

     The /SUBSET Imin Imax Jmin Jmax option allows to load only a subset
of  the  input  image  or  image  plane.   Again,  a file name should be
specified only to change the input image.

     You can combine /PLANE and /SUBSET options.  The behaviour of  this
command  depends  on  the current MODE defined by command DISPLAY\SELECT
MODE.  In IMAGE MODE, a single plane is mapped.  In CUBE MODE, the whole
image is mapped.  CUBE MODE should be used only for MOVIES.
1 Language
                    DISPLAY\ Language Summary
CLEAR           : Reset the image processor
HEADER [Name]   : Give the Header of the current or specified Image.
IMAGE [Name]    : Read the image Name. Default extension is .GDF
KILL [i j]      : Kills pixels
LIST            : Show current operating modes
LOOK            : Use the image cursor to look for image values
LUT [arg]       : Change the color Look-Up-Table
MOVIE           : Make a movie for a cube
PAN [i j]       : Move the zooming window around a new pixel
OVERLAY File    : Make an UIS or PostScript hardcopy of image and
graphics
PLOT            : Plot the image and redraw graphics
SELECT Mode     : Select some operating mode
WRITE
ZOOM            : Zoom part of the image.
1 LIST
          [DISPLAY\]LIST

     Lists some internal parameters of the DISPLAY  program  :   scaling
mode, range, Look Up Table mode, etc...
1 LOOK
          [DISPLAY\]LOOK

     Examine pixel values using the mouse or  trackerball  pointer.   On
VAXStation, Click central button to examine values, left button to exit.
On ARGS, use Green button to exit, any other to examine values.
1 LUT
          LUT Argum

     Modify the color look up table.  Possibles arguments are

      -  COLOR Load a default color table

      -  WHITE Load a black and white  color  table  (White  background,
         black sources)

      -  BLACK Load a black and white  color  table  (Black  background,
         white sources).

      -  LUT Load the color table defined by the arrays  HUE  SATURATION
         VALUE  (if  LUT  mode is HSV) or RED GREEN BLUE (if LUT mode is
         RGB).  LUT mode is selected by command  SELECT.   The  HUE  has
         values  between 0 and 360, all other arrays have values between
         0 and 1.0.  Arrays may be handled using standard SIC mathematic
         functions.

      -  Any other :  Red Green Blue values are read from the  formatted
         file named "Argum".


     HSV color representation is the most convenient since  HUE  defines
the  color  itself.  SATURATION defines the amount of white added to the
color (1.0 no white added, 0.0 gives perfect white), while VALUE defines
the  intensity  (0  is  black...).   The  default  argument  is  LUT.  A
convenient value for the HUE array is
LET HUE[I] = 256-I
a "classical" color table from blue to red as used in AIPS for  example.
Color  contours  can  be  obtained using variations around the following
command
LET HUE[I] = 16*INT((256-I)|16)
and so on with the most funny functions you may invent.
1 MOVIE
          MOVIE

     Start a movie procedure.  MOVIE mode must have been  selected  when
mapping the image.

     On VAXStation GPX, The button control the movie mode

      -  Left button :  Stop movie command

      -  Middle button :  Image by image mode

      -  Right button :  Start movie

Movie speed is controlled by pointer position (left fast, right slow).

     On ARGS the parameters are  controlled  by  the  trackerball.   The
buttons perform the following actions :

      -  GREEN :  Exit from the movie

      -  Leftmost WHITE :  start the movie (if stopped).

      -  Rightmost WHITE :  stop the movie on the current image.

      -  RED :  image by image mode.

Speed is controlled by the ball X movement.
1 OVERLAY
          OVERLAY File

     Creates a copy of the current image in PostScript format.   Default
file extension is .PS for PostScript files.  The PostScript files may be
sent to the LaserPrinter.
1 PAN
          PAN [Cx Cy]

     Move the zooming area to center it around the pixel (Cx,Cy) of  the
current  image.   The  zooming factor is not changed.  If no argument is
given, use the mouse or trackerball to point towards the center.
1 PLOT
          PLOT

     Computes the bitmap from the current image and plot it.  The  range
specified  by  SELECT RANGE, and the scaling specified by SELECT SCALING
are used.  If  neither  the  image,  nor  the  scaling  parameters  have
changed, the last bitmap is replotted without computations.
1 RUN
          RUN Program_Name [Parameter_File] [/EDIT]

     The RUN command is similar to the SUBMIT command, except  that  the
program  is  run  as  a detached process instead of being submitted to a
batch queue.  The command file which is  used  by  the  RUN  command  is
located  in  the  SYS$SCRATCH  directory  and  is  deleted after program
execution.    The   output   of   the   program   is   in    the    file
SYS$LOGIN:Program_Name.GILDAS,  which may be listed or printed later on.
If the activated program  terminates  before  you  exit,  a  termination
message will be typed on the terminal, giving the termination status.

     See HELP SUBMIT for details about  programs  and  parameter  files.
Note  that detached processes keep running even if you log off, and that
several detached  processes  may  run  concurrently.   If  you  want  to
synchronize several programs, use the SUBMIT command.

     Use TASK\HELP command for help on available programs.
1 SELECT
          SELECT Item Value

     Specify some parameters.  Available parameters are :

      -  SELECT RANGE AUTO or SELECT RANGE LOW_CUT HIGH_CUT
         specify the range of values to be displayed in the bitmap.

      -  SELECT SCALING LINEAR or SELECT SCALING LOGARITHMIC  or  SELECT
         SCALING EQUALIZATION.
         specify the transformation applied to the image to  obtain  the
         bitmap.   LINEAR  is  the  fastest,  EQUALIZATION  the slowest.
         Moreover, EQUALIZATION scaling requires a large enough map with
         sufficient dynamic range.

      -  SELECT LUT HSV or RGB
         Defines the basic color  Look  Up  Table  representation.   See
         command LUT for details.

      -  SELECT LEVELS nlev
         ???  Ask Gilles DUVERT

      -  SELECT MODE CUBE or SELECT MODE IMAGE
         Specify in which mode you want to display the input data  cube.
         IMAGE  mode  is  used  to display the cube plane by plane, CUBE
         mode is used to make movies.

      -  SELECT X (or Y) INCREASING or DECREASING
         Specify whether image should be displayed using  increasing  or
         decreasing user coordinates along X or Y axis.

1 SPY
          SPY

     Displays the status  of  all  tasks  activated  from  this  program
session.
1 SUBMIT
          SUBMIT Program_Name [Parameter_File] [/EDIT]

     Submit to the batch queue GILDAS_BATCH a program  from  the  GILDAS
environment.   If  no  directory  is  specified in the program name, the
program is assumed to be in the GILDAS_RUN area.  The  input  parameters
will  be  read  from  the  file  Parameter_File,  which is a special SIC
procedure with commands from the TASK\ language.

     If no /EDIT option is present and this argument is  not  specified,
the  template GILDAS_PAR:Program_Name.INIT is used.  If the /EDIT option
is present, the parameter file  of  default  name  Program_Name.INIT  is
edited  before  submission,  taking  a template in GILDAS_PAR area if no
version of this file already  exist.   If  this  template  file  doesnot
exists,  it  may  be  that  the  program  you want to run doesnot exists
either, or is not yet debugged at all.

     You may abort your request while editing by typing QUIT instead  of
EXIT  to  finish.   Help on the task can be obtained while in the editor
using GOLD ? key.

     If you do not use the editor, the SUBMIT command  will  prompt  you
for  all  missing  parameters  in  the  .INIT command file.  Help on the
parameter can be obtained answering ? to the prompt.

     Note that the command does check that the program exists, and  that
only  GILDAS  tasks can be submitted in this way.  Another SIC procedure
is executed before task  submission  to  check  the  validity  of  input
parameters.   If  any parameter is invalid, an error is returned and the
program not submitted.

     Use TASK\HELP (no abbreviations) command  for  a  documentation  on
available programs.
1 WAIT
          WAIT [TaskName]

     Place the current program in a wait state until the specified  task
(started  by command RUN) terminates.  By default, the last started task
is used.  WAIT * waits for all active tasks to complete.
1 ZOOM
          ZOOM [X_blc Y_blc X_trc Y_trc]

     On VAX Station GPX, Display the area specified by its  bottom  left
corner  and  top  right  corner  in  the  ZOOM  window.   If  no area is
specified, use the mouse pointer to define the corners.  The command  is
chained with a PAN command.

     On ARGS image processor, use  the  white  buttons  to  increase  or
decrease  zooming  factor,  green button to exit, trackerball to pan the
image.
