td.hlp

COMMAND

DEFINE COMMAND new_command "command string"

This defines a new command as the command string. New commands must be different from existing commands, and are only used if an existing command is not found. There is a limit of 3 command substitutions in a row, and 1000 total substitutions per input line. The limit on the number of substitutions per line may be modified by SET COMMAND.

example DEFINE COMMAND EDT "SPAWN EDT" Defines the command EDT so you may edit a file while using TOPDRAWER. DEFINE COMMAND MAIL "SPAWN MAIL" Defines the command MAIL so you may use the mail utility while using TOPDRAWER. DEFINE COMMAND @ "SET FILE INPUT=" Defines @ to work similarly to @ in VMS. @filename will get commands from the specified file. DEFINE COMMAND EDAT "LIST DATA FILE=DAT.TMP;EDT DAT.TMP;DELETE ALL; SET FILE IN=DAT.TMP" Defines the command EDAT to allow you to edit the current data.

Additional Information on:

initialization

examples

HISTOGRAMS

This creates HBOOK histograms or modifies the histograms. See:Command SET HISTOGRAM. You may add together histograms or add ntuples to histograms. The variables in NTUPLES may be added to several histograms all in one operation. DEFINE HISTOGRAMS {IDENT[=FROM n][TOn]| APPEND=n| CURRENT| NEXT| PREVIOUS| FIRST| LAST| ALL} [LOG[=ON|OFF]] Histogram selection [AREA|DIRECTORY="name"] [ENTRIES[=ON|OFF]] [HISTOGRAM[=ON|OFF]] [MESH[=ON|OFF]] [ARRAY[=ON|OFF]] [NTUPLES[=ON|OFF]] [SELECT|NAME="hist name"] [CONFIRM[=ON|OFF]] Histogram creation [[[X|Y][FROM n][TO n][BY n][BINS=n]]| [SETS=[FROM] n1 [TO] [n2]]] [CHECK[=ON|OFF]] [RANGE=n] [PROFILE[=ON|OFF]] Histogram modification [BINSZ[=ON|OFF]] [DEFNME='name'] [ERRORS[=ON|OFF]] [STATISTICS[=ON|OFF]] [ZERO] [SECTION]] Histogram Filling [[ADD|SUBTRACT|MULTIPLY|DIVIDE=n1[,n2]] [FACTOR=f1[,f2]] [CYCLE[=ON|OFF]]] Print options [DEFAULT[=ON|OFF]] [PRAUTOMATIC] [PRBIGBI=n] [PRBLACK] [PRCHANNELS[=ON|OFF]] [PRCONTENTS[=ON|OFF]] [PRERRORS[=ON|OFF]] [PRHISTOGRAM[=ON|OFF]] [PRINTEGRAL[=ON|OFF]] [PRLOGARITHMIC|PRLINEAR[=ON|OFF]] [PRLOW[=ON|OFF]] [PRMAXIMUM=n] [PRMINIMUM=n] [PRROTATE[=ON|OFF]] [PRSTAR] [PRSTATISTICS[=ON|OFF]] [PRSQUEEZE[=ON|OFF]] [PR1PAGE[=ON|OFF]] [PR2PAGE[=ON|OFF]] [PRPAGE=n] [TITLE="general_title"]

Additional Information on:

KEY

DEFINE KEY keyname "key definition" options

This defines a key on your keypad so you can abbreviate a command to a single keystroke. The syntax is similar to the VMS DEFINE/KEY command. Since the syntax is VMS the key definition must be enclosed in quotes (") and not in apostrophes ('). For more information See:DEFINE/KEY in the VAX/VMS DCL Dictionary.

Additional Information on:

keyname

options

Example

STRING

You may define strings for "Lexicals" TD:DEFINE STRING name 'string' A lexical of the form S_name is give the string

Example TD:DEFINE STRING NAME 'George Washington TD:TITLE TOP 'The first president was ' S_NAME TD:TYPE 'NAME="' S_NAME '"'

You may show all defined strings with the SHOW STRINGS command. An individual string may be examined by the TYPE command. TYPE S_name

Additional Information on:

Variable

VALUE

You may define values for "Lexicals" DEFINE VALUE name=value [LOG=[ON|OFF]] [FAST[=ON|OFF]] A lexical of the form V_name is give the value n If you specify LOG then the value is typed on your terminal. When FAST=ON the value is defined as a local symbol in non readable form. This will speeds up symbol definitions, but it has little effect on the symbol usage. You should use FAST when you are repeatedly redefining symbols. Non readable symbols do not make sense for a SHOW VALUE command. If you need speed, single letter names are the most efficient. (Default:FAST=OFF)

Example TD:DEFINE VALUE NORM=125.5 TD:Y=Y TIMES V_NORM Multiplies all data by 125.5. TD:DEFINE VALUE NORM=<100/V_SUM> TD:Y=Y TIMES V_NORM Normalizes the data to SUM=100.

You may show all defined values with the SHOW VALUE command. Individual values may be shown by the SHOW LEXICAL command. See:TOPDRAWER DATA

Additional Information on:

Variable