Encyclopaedia Index

Commands for running PHOENICS and related executables

See scripts

Command files in AUTOPLOT

AUTOPLOT is designed for interactively use. However, there may be occasions when the same sequences of commands have to be used repeatedly. These may be entered into a command file, generally referred to as a USE file. A command file is read by means of the command:

USE

where is the name of the USE file required.

Any editor may be used to create a USE file, which must be saved as a sequential text file. The commands to be entered in it are the same as those entered interactively; all abbreviations are valid, as are several commands on one line separated by semi-colons.

Two extra features have been introduced to control USE files, namely:

(1) The command:

PAUSE

which causes the program to hold the picture on the screen until is pressed. PAUSE must be placed on a line by itself.

(2) A line beginning with an asterisk (*) signifies that the line is a comment.

The following is an example of command file:

*Test command file... first read some data

DATA 1 1
DATA 1 2
DATA 1 3
*Now plot each curve separately
PLOT 1
PAUSE
DOT 2
PAUSE
DOT2 3
PAUSE
*

END

In this file, the first three commands read data elements from a PLOT file. The program then draws each curve in a different line style with a pause between each curve so that the picture can be viewed.

When <Return> is pressed, the program plots the next curve and then PAUSEs again.

The END in a command file causes an exit from AUTOPLOT; if END is omitted, control is returned to the interactive mode and the prompt Command? appears.

Only one USE file may be in use at a time; therefore a USE command cannot be issued from within a USE file.

Command-session recording

A 'macro-making' facility is now available by means of a new command that records the interactive command-session in a file. The file can subsequently be read as a USE file to reproduce automatically the command sequence.

For further information: see the entry LOG in the PHOTON help dictionary

COMMANDS in the PHOENICS Input Language (PIL)

  1. see the entry (COMMANDS, hlp1)
  2. The following commands were added to PIL, or modified, with PHOENICS version 1.5:
INLET (NAME,TYPE,IXF,IXL,IYF,IYL,IZF,IZL,ITF,ITL)
OUTLET (NAME,TYPE,IXF,IXL,IYF,IYL,IZF,IZL,ITF,ITL)
WALL (NAME,TYPE,IXF,IXL,IYF,IYL,IZF,IZL,ITF,ITL)
VALUE (NAME,PHI,VALUE)
SUBGRD (DIR,L1,L2,DIST,POW)
LIBLIST (keyword1,keyword2,...,keywordn)
DUMP (ARRAY[,d1{,d2<,d3>}])
LOCATE (ARRAY,VALUE,IP)_}
SORT (ARRAY,FUNC,IMAX)
GETPTC (NAME,TYPE,IXF,IXL,IYF,IYL,IZF,IZL,ITF,ITL)
GETCOV (NAME,PHI,CO,VAL)
GETSOL (PHI,CT1,CT2,CT3,CT4,CT5,CT6)
GETOUT (PHI,CT1,CT2,CT3,CT4,CT5,CT6)
CHKVAR (VARIABLE,TYPE,LOG)
CHKLEN (VARIABLE,LEN,FUNC)_}
RESTRT (PHI1,PHI1...)
CONPOR ([NAME,]VALUE,TYPE,IXF,IXL,IYF,IYL,IZF,IZL)
XCYIZ (IZF[,IZL],FUNC)

COMMANDS

-----------------------------------

The following commands are recognised by the PHOENICS Input Language
ARRAY, BOOLEAN, CHAR, CHKLEN, CHKVAR, CLEAR, CONPOR, COVAL,
DOMAIN, DUMP, END, FIXDOM, GCLEAR, GDOM, GDRAW, GETCOV,
GETPTC, GETSOL, GGET, GGRID, GLINE, GLIST, GPATCH, GPROJ,
GRDCHK, GRDPWR, GSET, GTEXT, GTPARG, GVIEW, INIT, INLET,
INTEGER, LIBLIST, LOAD, LOCATE, MAGIC, MENSAV, MESG, MESGA,
MESGB, MESGM, MINPUT, OUTLET, OUTPUT, PATCH, PLINE, PLOT,
PRNTIM, PTEXT, PTIME, Q1MESG, RADIAT, READCO, READVDU, REAL,
RELAX, REGEXT, RESTRT, RSET, RUN, SATRUN, SEE, SEE C,
SEE I, SEELIB, SEEPTS, SEE R, SETLIN, SETPT, SHOMEN, SKIP,
SOLUTN, SOLVE, SORT, STOP, STORE, STOVAR, SUBGRD, TERMS,
TEXT, TURMOD, VALUE, VIEW, WALL, XCYIZ.

For help on any item (except END), enter the command name followed by a question mark, thus ARRAY?

COMND

-------------------------------------- Photon Help ----

[Comnd] switches the system from menu mode to command mode. The sub-menu activated with COMND contains two items:

[Command: ]

[Dialog in full size screen]

wbs