1 EXPLAIN [VECTOR\]EXPLAIN [Task [Parameter]] Gives explanation about a GILDAS task. If Parameter is specified, EXPLAIN will give help about the parameter. Parameter = * can be used to list help about all parameters of the specified task. Note that if Parameter is absent, EXPLAIN accesses the topic "Summary". The GILDAS tasks can only be activated from the VECTOR\ language, with commands RUN or SUBMIT. The VECTOR\ language is included in programs VECTOR, GRAPHIC and other reduction programs such as MAPPING. From within RUN and SUBMIT commands, you can get help upon the current Task by typing GOLD ? in the editor, or by answering ? to a prompt in non editing mode. 1 Language EXPLAIN [Task] : Gives explanation about a GILDAS task RUN Task : Activate a GILDAS task SPY [Task] : Look at current status of detached Tasks SUBMIT Task : Submit a GILDAS Task in batch queue GILDAS_BATCH TRANSPOSE : Transpose data cubes WAIT [Task] : Wait for Task completion 1 RUN [VECTOR\]RUN Task_Name [Parameter_File] [/EDIT] [/NOWINDOW] [/WINDOW] Execute a GILDAS task as a detached process. If no directory is specified in the task name, the Task is assumed to be in the GILDAS_LOCAL: or GILDAS_RUN: area. The input parameters are read from the file Parameter_File, which is a SIC procedure with commands from the TASK\ language. A * can be used instead to specify a parameter file of name Task_name.INIT in the current directory. The parameter file can be prepared in "Window-mode", or using a text editor. In Window-mode, activated implicitely in the RUN_WINDOW variable is YES (default on X-Window systems), or explicitely if the /WINDOW option is specified, a panel appears to enter all parameters. Help if available by clicking on the prompt string for each parameter, or on the HELP button. Once all parameters have been adequately specified, the task can be activated by clicking OK, or aborted by clicking ABORT. The text-editor mode is activated using the /EDIT option. The parameter file of default name Task_name.INIT is edited before submission, taking a template in GILDAS_RUN: area if no version of this file already exist. If this template file does not exists, it may be that the Task you want to run doesnot exists either, or is not yet debugged at all. Once the parameter file has been prepared in Edit-mode or Window-mode, the RUN command will prompt you for all missing parameters in the answering ? to the prompt. The RUN command checks that the Task exists, and only GILDAS Tasks can be submitted in this way. A second 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 Task not submitted. The input file which is created by the RUN command is located in the GAG_SCRATCH: directory and may be deleted after Task execution. The output of the Task is in the file GAG_LOG:Task_Name.GILDAS, which may be listed or printed later on. Task execution may be synchronous (the main program waiting for task completion) or asynchronous (control returns to the main program immediately). If the Task terminates before you exit from the activating program, a termination message will be typed on the terminal, giving the termination status. Use the EXPLAIN command for help on available Tasks. Task may execute on a remote node rather than on the local machine. The node name is controlled by logical name GILDAS_NODE. If GILDAS_NODE = LOCAL, local execution is performed. If not, GILDAS_NODE must be the node name of the computer on which execution will be performed. No synchronisation is offered for remote execution. 1 SPY [VECTOR\]SPY [Task_Name] Displays the status of all active GILDAS tasks, or list the last output from the specified task. 1 SUBMIT [VECTOR\]SUBMIT Task_Name [Parameter_File] [/EDIT] [/NOWINDOW] [/WINDOW] The SUBMIT command is similar to the RUN command, except that the Task is submitted to a batch queue (named GILDAS_BATCH) instead of being executed as a detached process. See RUN command for details. Use the EXPLAIN command for a documentation on available Tasks. 1 TRANSPOSE [VECTOR\]TRANSPOSE Input Output Order This command takes an input 3-D data cube to produce an output transposed 3-D cube according to the transposition order specified by Order (312, 213, etc...). For example: VECTOR\TRANSPOSE TEST.VLM TEST.LMV 231 1 WAIT [VECTOR\]WAIT [Task_name] 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 until all tasks complete. Waiting can be interrupted by pressing ^C. It may be used to synchronize complex procedures where the result of some task is used as input by others. For batch jobs sent through command SUBMIT, this synchronization is normally ensured by the job limit of the GILDAS_BATCH batch queue. 1 END