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.