Verbs

The verbs used in all the graphics commands are explained in this section, the verbs used only in a command, or that have a special meaning in a command, are explained in the specific command section.

? Help

Causes the print of a short list of verbs available in the specific application. Only the first three characters of the verbs are typed in the alphanumeric window. The list is written on the terminal window and doesn't erase the graphic window.

?L Help

Causes the print of a complete list of verbs available in the specific application. The list is written on the full screen and it can erase the graphic window.

ACTive Set--up

Selects among the opened catalogues the one in use. A prompt '>' at the left of the parameters window shows which catalogue is the active one. A lot of commands and parameters refers to the 'ACTive' catalogue. When a new catalogue is opened it is set as the active. To change it you must type the command followed by the sequential number of the catalogue. This command is saved on the log file.

Example: HIS> ACTive 3

ALL Execution

Executes the main operations of the task on all the catalogues currently opened. In some tasks this command has the same effect that a 'GRId' command followed by a 'DISplay' command for each opened catalogue. In other tasks, as DB_HISTO, with 'ALL' you can get specific results.

AUToscale Statistic

Calculates the maximum and minimum value of the numerical variable selected with the verb 'VARiable', then resets the value of 'MAXimum' and 'MINimum'. Note that if you have used the 'CONstraints' on the catalogue, only the records that satisfy the constraints are processed.

AVErage Statistic

Calculates the mean and the root square mean of the numerical variable selected with the verb 'VARiable'. Note that if you set 'MAXimum' and 'MINimum' and 'CONstraints' on a catalogue, only the records that satisfy the constraints are processed. A 'DISplay' operation must precede this command. The output values are written on the terminal window and on the log file.

BREak log file

Writes a 'BREak' string on the log file. By this verb you can interrupt the load of a log file. See section for more details.

CATalogue Set--Up

Opens a new catalogue and sets it active. The same catalogue can be opened more than one time on the same session for different purposes. The number of catalogues that you can open in a task is application dependent, but the maximum number is eight. If you are using a personal catalogue a 'P' character must follows the catalogue name. This command is saved on the log file.

Example: HIS> CATalogue AGK3 HIS> CATalogue MYCAT P

CLEar Screen

Clears the working window and resets the metafile used for the hard copy .

CLOse Set--Up

Closes the active catalogue. This command is saved on the log file.

CLS Screen

Clears the terminal window.

COLor Display

Defines the color used for the 'DISplay' of data on the 'ACTive' catalogue. This is the color used for marks, lines, or bar, in the specific application. The color is defined by a number that is device dependent. You can use the 'LUT' verb to get a list of the colors available on the specific device. This parameter can be used in two ways. If the verb is followed by a number, the color of the mark of the active catalogue is changed, if there are N numbers the colors of the mark of the catalogues from 1 to N are changed.

Example: CHA> COLor 6 CHA> COLor 2,7,3,1,1,4

COOrdinates Set--up

To set the type of the coordinates in use in the map in order to have right label, valid response to cursor position 'CPOsition' query, and coherent plot of equators and poles in the plot map. The codes that can be entered are: 0 for equatorial (default), 1 for galactic and 2 for supergalactic coordinates.

Examples: WED> COO 1

CONstraints Set--Up

Defines the constraints that you want to set on the 'ACTive' catalogue. All the statements of the DIRA query language can be used here. When you want to remove the constraints you can use the command: "CONstraints NONE ". Remember that you can set a constraints for each catalogue opened.

Example: HIS> CON MAG < 14. AND RADVEL > 6000.

CVAriables Set--up

Set the names of the variables as Longitude and Latitude in the active catalogue. The default names for the coordinate are 'RA' and 'DEC', but if the user wants to use other coordinates names or coordinate types he must set these with this verb.

Examples: WED> CVAR RA2000 DEC2000

DEClination Set--up

Set the values of the coordinate window in declination. When this parameter is set the task uses only the catalogue data inside the window. This is a global command and defines the window for all the catalogues used in the task. This verb requires two parameters: South Dec. and North Dec. in the format sDDPPSS. When you work with galactic or supergalactic coordinate you can use the 'LATitude' command that is an alias of 'DEC'. When you enter this command you can see, inside square bracket, the field used as declination coordinate. You can change this field by 'CVAriable' command.

Examples: WED> DEC -003000 053000

WED> DEC DEC > Sky Latitude [DEC2000 ] > -ddppss S -> N From:> -003000 To: > 53000

DELete Log file

Deletes all records in the current log file.

DGRid Grid

Resets the default value for the parameters involved in the grid,as number of steps ('NSTep'), color of grid ('GCOlor'), label size ('LSIze')

DISplay Execution

Displays data of the specific task. Works only on the active catalogue. Some applications require the graphic environment on the screen when you use this command: in this case a 'GRId' command is automatically executed. If the environment is present but you have changed a major parameter, a 'CLEar' is executed and a new grid is drawn, otherwise data are plotted over the existent picture.

DWIndow Set--Up

Resets the window value ('WRA' and 'WDEc') to 0. The window imposed on the catalogues is dropped and the value of 'RA' and 'DEC' are restored as coordinates constraints.

DZOom Set--Up

Resets the default value for the zoom, that is to return to the original image before the zoom operation.

EXIt Execution

Closes the session and returns to system level.

FONt Grid

Define the fonts to use. The font types are devices dependent, you can have the list of the available fonts with the command 'LFOnt'

GCOlor Grid

Defines the color of the grid. Use 'LUT' command to show the available colors.

Example: HIS> GCO 3

GO Execution

Executes in a standard mode the specific task. This command is equivalent to the use of 'GRId' and 'DISplay' commands and provides an easy way to execute a task with standard parameters. In fact, all the major parameters will be asked from the task by prompt strings

GRId Execution

This command draws the graphic environment related to the task. This can be a coordinate grid for coordinate based program, or x-y axes in other case. This command generates a clear action on the screen if a major parameter was modified. The environment can be drawn after the data.

HARdcopy hard copy

Generates an hardcopy of the screen on a graphic device. The name of the graphic unit is the value of the parameter 'HDEvice', and is dependent from the graphic library in use. The parameter 'HDImension' determines the size (in cm.) of the base of the working window. If you have not defined the dimension of the output plot the program asks for a value. Note that an hard copy device generally has not the same number of colors as the graphic terminal. The way used to convert the original colors depends on the graphic library in use. You can't obtain two hard-copies of the screen with two 'HARd' command without re-draw the screen, but you can save the graphic metafile on disk and copy it on the hard copy device many times.

HDEvice hard copy

Defines the hard copy device name. The name is graphic-library dependent.

Example: HIS> HDEv LN03P

HDImension hard copy

Defines the size in cm. of an element of the working window in the hard copy. Typically, it is the dimension of the base of the window.

Example: HIS> HDIm 12.5

HELp Help

Writes the help related with the verb. If the length of the information exceeds the text window you must type a key to resume the process. Requires a verb as first parameter.

Example : HIS> HELP GRID

LABel Grid

The user can use a catalogue variable to set a label near the plotted objects. This verb define the name of the field used for the label text. The labels will be written when the user enter a 'DISplay' command.

Example : CHA > LAB NAME

LATitude Set-up

Set a coordinate window in latitude. When 'LAT' is defined the task uses only the catalogue data inside the window. This is a global command and is valid for all catalogues used in the task. The verb needs two parameters: South Latitude and North Latitude in the format sDD.ssssss. An alias of 'LAT' is 'DEC'. When you enter this command you can see, inside square bracket, the field used as latitude coordinate. You can change this field by 'CVAariable' command.

Examples: WED> LAT -003000 053000

WED> LAT LAT > Sky Latitude [BII ] > -dd.mmmmm S -> N From:> -00.30000 To: > 5.30000

LFOnts Help

Draws on the screen strings written with the available fonts. The types of font available are graphic library dependent.

LISt Execution

Writes, on a file, a list of the objects retrieved in the task. The content of the list is task dependent.

Example : CHA > LIST LIS > File Name ? > LIST.LIS

LOAd log file

Load a previously saved log file and set the parameters value at the new value. Requires the file name as parameter. A flag permits also to select three type of load:

Flag = 0 Load file until 'BREak' marker (default)

Flag = 1 Load all the file

Flag = 2 Load a row at time

See section for more details

Example: HIS> LOAd COMMFIL.DAT HIS> LOAd COMMFIL.DAT 2

LONgitude Set-up

Set a coordinate window in longitude. When 'LON' is defined the task uses only the catalogue data inside the window. This is a global command and is valid for all catalogue used in the task. The verb require two parameters in the format sDD.ssssss. An alias of 'LON' is 'RA'. When you enter this command you can see, inside square bracket, the field used as latitude coordinate. You can change this field by 'CVAariable' command.

Examples: WED> LON 003000 053000

WED> LON LON > Sky Longitude [LII ] > -ddd.mmmmm From:> 3.00000 To: > 5.30000

LSIze Grid

Defines the height in cm. of the text labels. The default is 0.35 cm.

Example: HIS> LSIze .3

LTYpe Display

The objects (markers) plotted on the screen can be connected with different types of lines. Default value of this parameter is 0 that means no connection the markers. With the values 1,2,....different types of line are used. The lines connect the objects with respect of the order in with these are plotted on the screen.

Example: HIS> LTYpe 3

LUT Help

The color(s) that you can use in a display is a terminal dependent variable. Different devices have a different number of colors. With this command you get colored symbols with the related color number.

MAXimum Variable

Defines the maximum value of numerical variable that the task processes. It is the maximum value of the X axis.

Example: HIS> MAX 12.3

MINimum Variable

Defines the minimum value of numerical variable that the task processes. It is the minimum value of the X axis. Default is 0.

Example: HIS> MIN 5.

MONitor Graphic

Defines the number of rows of the terminal window. The default is 3 if the terminal and the graphic screen are the same device.

Example: HIS> MONitor 12

MSIze Display

Defines the size in cm. of the marks that will be used to display the data of the active catalogue. This command can be used in two ways. If the verb is followed by a number the mark size of the active symbol is changed , if there are N numbers the marks from 1 to N are changed. Remember that the dot (SYMbol 1) has not dimension, if you need dots with different size you can use small asterisk (SYMbol 8)

Examples: HIS> MSIze .3 .2 .2 .2 .1 .1

NEXt log file

Continues the load of a previously saved log file, interrupted by a 'BREak' comment. A flag permits to select three type of load:

Flag = 0 Loads file until next 'BREak' marker (default)

Flag = 1 Loads all the file

Flag = 2 Loads a row at time

See section for more details

Examples: HIS> NEXT HIS> NEXT 2

NOWindow Screen

When this flag is set to 0 all the working windows are inside a box, when this flag is set to 1 the box and the parameter window are not drawn.

Examples: HIS> NOW 1

RA Set--up

Sets a coordinate window in right ascension. When 'RA' is defined the task uses only the catalogues data inside this window. This is a global parameter and you can not define a coordinate window for each catalogue. If you need to work with different coordinates on different catalogues you must define a 'SELection' on the RA end DEC variable of the catalogues or you can prepare in the PDB a set of catalogue with DB_SELECT command. This verb requires two parameters: in the format HHMMSS. When you enter this command you can see, inside square brackets, the field used as right ascension coordinate. You can change the coordinates in use by 'CVAariable' command.

Examples: WED> RA 233000 053000

WED> RA RA > Sky Longitude [RA2000 ] > hhmmss From:> 233000 To: > 53000

REMark log file

Writes a text string on the log file

Example: HIS> REM This is a good work !

SAVe log file

Closes the current log file and saves the data in a file. The file name is a parameter of this command. When a log file is saved a new log file is automatically opened.

Example: HIS> SAVE FILEDAT.DAT

SELection Set--Up

Defines the catalogue variables that are shown when you identify an object by the cursor, or the variables that are printed in a List file when you execute a 'LISt' command. Giving a 'SELect' command and answering ' ? ' to the prompt you can have a list of the variables available in the active catalogue

Example: CHA> SELect NAME,MAG,RADVEL,NUMBER

SHOw Help

This command shows on the terminal the value of a parameter. For the parameters that are relative to a catalogue ( eg. 'VARiable') only the value related with active catalogue is shown.

Example: HIS> SHO BINs SHO> Number of bins = 26 HIS> SHO HDE SHO> Hard copy device = LN03P

SYMbol Display

Defines the symbols type that will be used to 'DISplay' the data of the active catalogue. This command can be used in two ways. If the verb is followed by a number the active symbol is changed, if there are N numbers the symbols from 1 to N are changed. Valid values are.

1 - point   2 - cross   3 - triangle   4 - X
5 - square   6 - circle   7 - star   8 - asterisk

Example: CHA> SYMbol 4 or CHA> SYMbol 1,6,4,2,8

SYStem Execution

With this command you can return to the operating system without leaving the task. After this command an operating system prompt is typed and you can type system commands. Typing a < CR > you can return in the task.

Example:

HIS> SYStem $ Dir $ Copy A.for B.for $ HIS>

TEXT Display

Writes on the working window a string of 'LSIze' dimension and 'GCOlor' color. The application asks for the string text and then wait for the cursor input to position the string. When the cursor is in the right position you must type a key and the string is drawn starting from the cursor position.

Example: CHA> TEXt TEX> Type your String TEX> This is object 4533+22 TEX> Now use cursor to define position ...

VARiable Variable

Defines the catalogue variable that you will use in the application. In the DB_HISTO and REGRES task define the variable used on the X axis

Example: HIS> VAR MAG

VFOrmat Variable

Define the FORTRAN format of the label written on the X axis of the grid. This parameter is a string (for example I4, F6.2). When this parameter is set to 'NONE' a default format is used.

Example: HIS> VFOrmat I6

W2 Grid

Redraw the parameter window.

WDEc Set--Up

Defines the coordinate window limits in declination. This variable is updated by the 'WINdow' command. When the differences between the two limits of 'WDE' are not equal to zero this variable overrides 'DEC' in the coordinate window definition. The values of this window are set by WINdow command, but the user can enter the value directly. This command is an alias of 'WLAtitude'.

WHO Cursor

Identifies an object by the cursor and write on the terminal and on the log file the coordinates and the value of the catalogue variables defined in 'SELect'. Acts on the active catalogue only.

WLAtitude Set--Up

Defines the coordinate window limits in latitude. This variable is updated by the 'WINdow' command. When the differences between the two limits of 'WLA' are not equal to zero this variable overrides 'LAT' in the coordinate window definition. The values of this window are set by WINdow command, but the user can enter the value directly. This command is an alias of 'WDEclination'.

WLOngitude Set--Up

Defines the coordinate window limits in longitude. This variable is updated by the 'WINdow' command. When the differences between the two limits of 'WLO' are not equal to zero this variable overrides 'LON' in the coordinate window definition. The values of this window are set by WINdow command, but the user can enter the value directly. This command is an alias of 'WRA'.

WRA Set--Up

Defines the coordinate window limits in right ascension. This variable is updated by the 'WINdow' command. When the differences between the two limits of 'WRA' not equal to zero this variable overrides 'RA' in the coordinate window definition. The values of this window are set by WINdow command, but the user can enter the value directly. This command is an alias of 'WLOngitude'.

XSTep Grid

Defines the number of steps on the X axis. With this verb the user define the number of steps of the grid, or/end the number of labels in the X axis etc.

YSTep Grid

Defines the number of division on the Y axis. With this verb The user define the number of division of the grid, or/end the number of labels in the Y axis etc.

YVFormat Variable

Define the FORTRAN format of the label written on the Y axis of the grid. This parameter is a string (for example I4, F6.2). When this parameter is set to 'NONE' a default format is used.

Example: HIS> YVFormat I6



Previous: DB_WEDGE
Up: Graphic Commands
Previous Page: DB_WEDGE
Next Page: Installation and management