DB_WEDGE

COMMAND TYPE : GRAPHIC

PURPOSE:

By this command you can display on a graphic terminal a wedge diagram selecting data from one or more catalogues.

DESCRIPTION:

This command draws a wedge diagram using the objects selected from one or more catalogues inside a sky area defined by sky coordinates. More catalogues can be superimposed on a diagram and displayed with different colors and symbols.

The coordinate that you use in the angle can be longitude (Right Ascension) or latitude (Declination). The VIEw command selects the coordinate linked with the angle. Moreover the wedge can be rotated, on the screen, to optimize the screen size.

By the cursor you can get information about plotted objects.

REQUIRED Parameters Verb

These parameter verbs are required for the execution of the task.

CATalogue    Opens Catalogue
RA       R.A. Window definition
DEC       Dec. Window definition
VARiable    Catalogue Variable
MAXimum    Max value of 'VARiable'

SPECIFIC VERBS

The task uses all the command verbs defined in section ; moreover specific verbs are :

ANGle Grid and Display

Defines the size of the angle in degrees of the wedge diagram. Default value is 30.

Example: WED> ANGle 45

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

CPOsition Cursor

By the cursor you can get the value of the coordinates and of 'VARiable' at the cursor position.

LISt Execute

Writes in a file the list of the objects that are present on the screen. The catalogue variables that are typed are: the right ascension and declination coordinates, 'VARiable' and the parameters defined in 'SELect'. Works on all the open catalogues.

ORIentation Grid

Define the orientation of the wedge in the screen. When this parameter is set to 0 (default) the wedge vertex is on the left of the screen and the wedge is in a horizontal position, when it is set to 1 the vertex is on the bottom and the wedge is in a vertical position. You may use wedge with ORIentation = 1 when you have a big sky ANGle to show.

RADius Grid

This parameter define the radius in cm. of your wedge. Remember that the virtual size of your picture is 20x13cm. You can use this parameter in conjunction with ANGle, XVErtex, YVErtex and ORIentation parameters to adjust your wedge on the screen.

RETicle Grid

When this parameter is set to 1 a grid is drawn inside the wedge. XSTep and YSTeps parameters define the number of divisions of the grid.

VARiable Variable Parameter

Defines the 'VARiable' used for the wedge diagram. If you answer '?' at the prompt a list of available variables on the catalogue is shown.

Example: WED> VARiable RADVEL

VIEw Grid and Display

The coordinate shown in the angle of the wedge diagram can be the longitude (Right Ascension) or the latitude (Declination) coordinate of the catalogue. This flag selects one of the two case. If VIEw = 0 Right Ascension is displayed otherwise Declination is displayed. Default is 0.

Example: WED> VIE 1

WHO Cursor

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

XSTep Grid

Define the number of marks on the axes of the values.

XVErtex Grid

Define the X position in cm. of the wedge vertex inside the working window. Remember that the virtual size of your picture is 20x13cm. You can use this parameter in conjunction with ANGle, RADius to adjust your wedge on the screen when ORIentation parameter is set to 0.

YSTep Grid

Define the number of marks on the curve of the coordinate.

YVErtex Grid

Define the Y position in cm. of the wedge vertex inside the working window. Remember that the virtual size of your picture is 20x13cm. You can use this parameter in conjunction with ANGle, RADius to adjust your wedge on the screen when ORIentation parameter is set to 1.

DB_WEDGE Summary of the commands

* = must be provided by the user

Command Explanation Ref.

---- Execution

ALL Executes GRI and DIS on all cat. Verb AUToscale Calculates max and min Verb AVErage Evaluates average of VAR Verb DISplay Displays Data Verb EXIt Exits from task Verb GO Executes the task Verb GRId Draws the grid Verb LISt Writes a data file Verb SYStem Returns to VMS Verb TEXt Draws a string of text Verb

---- Set up and selection

ACTive Defines active catalogue Verb * CATalogue Opens a Catalogue Verb CLOse Closes a catalogue Verb CONstrains Sets constraints on active cat. Verb COOrdinates Define coordinate type Spec CVAriable Defines cord. variables name Verb * DEC Sets Dec. coordinates limits Verb DWIndow Resets window condition Verb DZOom Resets zoom condition Verb LATitude Sets a window in latitude cord. Verb LONgitude Sets a window in longitude cord. Verb * RA Sets R.A. coordinate limits Verb WDEc Sets a window in Dec. Verb WLAtitude Sets a window in Latitude Verb WLOngitude Sets a window in Longitude Verb WRA Sets a window in R.A. Verb

---- Variables

* MAXimum Maximum value of VAR Verb MINimum Minimum value of VAR Verb * VARiable Variable shown Spec

---- Grid

ANGle Angle of the wedge Spec DGRid Resets default grid values Verb FONt Font type Verb GCOlor Color of the grid Verb LSIze Sets the label size Verb ORIentation Wedge orientation (0=horizontal) Spec RADius Size in cm of the radius of wedge Spec RETicle Draws a grid into the wedge Spec VFOrmat FORTRAN format of labels Verb VIEw R.A. or Dec. Wedge Spec XSTeps Number of divisions on X axis Spec XVEertex X position of the vertex Spec YSTeps Number of divisions on Y axis Spec YVErtex Y position of the vertex Spec

---- Markers

COLors Color of the markers Verb LABels Write labels near markers Verb LTYpe Type of line that link marks Verb MSIze Markers size (in cm.) Verb SYMbol Markers type Verb

---- Cursor

CPOsition Returns cord and variable values Spec SELect Fields to shows in LISt e WHO Verb WHO Finds a object Spec

---- Screen

CLEar Clears graphic device Verb CLS Clears command monitor Verb MONitor Number of row in command monit. Verb NOWindow Do not draw window box Verb W2 Redraws graphic windows Verb

---- Help

? List of the commands Verb HELp Help of a command Verb LFOnts Shows available fonts Verb LUT Shows available colors Verb SHO Shows a parameter value Verb

---- Hard copy

HARd Executes an hard copy Verb HDEvice Defines hard copy device Verb HDImension Defines hard copy dimensions Spec

---- Log file

BREak Sets a break flag Verb DElete Deletes a log file Verb LOAd Loads an existent log file Verb NEXt Continues the load after a BREak Verb REM Writes a string in the log file Verb SAVe Saves current log file Verb

picture 5



Previous: DB_SCHART
Up: Graphic Commands
Next: Verbs
Previous Page: DB_SCHART
Next Page: Verbs