introduction

 The set commands are used to set options. Most set commands set the option for the duration of the current plot. When a NEW command is issued, the options revert to the default. You may make the current option the default by using the option PERMANENT. If no options are specified for the set command, the options are set back to the original default value.

For example you wish to do a series of plots with the same limits on the X,Y scales. Normally TOPDRAWER sets the limits automatically according to your data, so you use the command: TD:SET LIMITS X FROM 0 TO 10 Y FROM 0.5 to 1.5 PERMANENT which sets the limits permanently. When you have done the plots you wish to revert to the original default: TD:SET LIMITS Now the limits are reset to automatic limits for the current plot only. The next plot will have the PERMANENT limits. To have automatic limits for all subsequent plots you must: TD:SET LIMITS;SET LIMITS PERMANENT

After using a set command you may "see" what you have done with a SHOW command. For each set command there is a SHOW command which shows the current options. For example you may see the limits you have modified by: TD:SHOW LIMITS

options

1. ARROW - Sets default arrow format 2. AXES - Sets default axis 3. BAR - Sets size of ends of error bars and a break in error bars 4. BOX - Sets default box size 5. BLINK - Sets the BLINK attribute. 6. CARD - Maximum length of input lines 7. CHARACTER - The character set used 8. CIRCLE - Same as SET ELLIPSE 9. CLEAR - Selects deferred or immediate screen clearing 10. COLOR - Sets default color or pen number 11. Ctrl_Z - Enables or disables the Ctrl_Z key. 12. CYCLE - The color,width, texture to cycle through. 13. DATE - Set base date for date\time. 14. DEVICE - Chooses I/O device 15. DIAMOND - Sets default diamond size 16. DIGITS - Sets number of digits for show command. 17. ELLIPSE - Sets default ellipse size 18. ERRORS - Changes the output of errors 19. FILE - Selects files for input, output, and journaling. 20. FILL - Selects the fill style. 21. FLUSH - Sets automatic flush mode. 22. FONT - Chooses UGSYS character set 23. FORMAT - Format for input lines (256A1) 24. GRID - Specifies grid marks overlay plot 25. INTENSITY - Sets default intensity (line width) 26. LABELS - Sets defaults for numeric labels on axes 27. LIMITS - Sets X,Y,Z limits for plot (range of data to plot) 28. MODE - Set misc. functions 29. MONITOR - Set type of monitor plots 30. ORDER - Determines interpretation of input data 31. OUTLINE - Controls outline around plot 32. PATTERN - Sets the pattern for PATTERNED lines 33. PAUSE - Controls pause at end of plot 34. PEN - Selects the default pen or color to use in plotting. 35. POLAR - Selects polar coordinates. 36. PROMPT - Sets the prompt string. 37. REVISION - Sets the revision level (what features TD has) 38. SECONDARY - Controls the attributes of secondary contour lines. 39. SEGMENTS - Controls breaking the plot into segments 40. SHADOW - Sets 3-d plots to shadow plot to make the point location more obvious. 41. SHIELD - Sets an area to be shielded so that no more plotting is done there. 42. SCALE - Controls scale (log/linear...), and the number of default labels and ticks. 43. SIZE - Defines size of screen or paper 44. STATISTICS - Sets the range of data to use in subsequent lexicals. 45. STORAGE - Defines what is kept in storage 46. SYMBOL - Sets default symbol to plot 47. TEXTURE - Sets default line style (DOTTED,SOLID...) 48. THREE - Sets parameters for 3-dimensional plots 49. TICKS - Controls tick marks on axes 50. TITLE - Sets size of title 51. UNITS - Sets the units of the TEXT coordinates, and character sizes. 52. WIDTH - Sets the line width or intensity 53. WINDOW - Defines the plotting area (labels may be outside area)

AREA

 See:Command SET WINDOW

ARROW

 SET ARROW [SIZE=n] [FLARE|FLAIR=n] [PERMANENT] 1. SIZE=n - length of arrow head in tenths of an inch. The units may be modified by SET UNITS CHARACTER. (Default:2) 2. FLARE=n - is ratio of the base to the height of the arrow head (fatness). (Default:0.2) 3. PERMANENT - Makes the current setting the new default.

If no options are specified all parameters are set to the default.

AXES

Controls the presence or absence of each axes and sets the attributes of the axis. SET AXES|AXIS [INHIBIT|ENABLE] [ALL|TOP|BOTTOM|RIGHT|LEFT|X|Y|Z] [ON| OFF] [FRONT[=[ON|OFF]] [BOTH[=[ON|OFF]] [THREE[=[ON|OFF]] [INTENSITY|WIDTH=n] [NOCOLOR|WHITE|RED|GREEN|BLUE|YELLOW|MAGENTA|CYAN] [NOTEXTURE|SOLID|DOTS|DASHES|DAASHES|DOTDASH|PATTERNED|FUNNY| SPACE] [PERMANENT]

Normally AXES are drawn at the first HIST, JOIN, BARGRAPH, PLOT, or PLOT AXES command unless inhibited or turned off. To control individual elements of the axes use: SET TICKS, SET LABELS, SET OUTLINE, SET SCALES

Additional Information on:

  • options
  • Example

    • BAR

     This sets options for error bars. SET BAR [ALL|X|Y|Z] [BREAK=[n]] [SIZE=[n]] [SUPPRESS=[ON|OFF]] [PERMANENT]

    Additional Information on:

  • ALL-X-Y-Z
  • SIZE
  • BREAK
  • SUPPRESS
  • PERMANENT
  • examples

    • BOX

     This sets the default size for boxes. SET BOX [SIZE=dx[,dy]] [PERMANENT]

    PERMANENT - Makes the current setting the new default. (Default:1.0)

    If dx is omitted it is set to the default. If dy is omitted it is the same as dx.

    BLINK

    SET BLINK [ON|OFF] Text or data plotted while this is on will blink. This will only work with certain devices. The blink attrubute is reset to off at the beginning of each new plot. If ON or OFF are omitted BLINK is set ON. (Default:OFF)

    CARD

     This sets the number of columns per input line for non interactive input. SET CARD|INPUT [LENGTH]=[length]

    All data past the length is ignored The length must be in the range 20 to 256. See also SET FORMAT. This parameter remains the same when a new plot is started. (Default:256)

    You should be careful when using this command. If you extend the input line before extending the format, TOPDRAWER will expect multiple input lines per command.

    If length is omitted it is reset to the default value. For interactive input on the VAX the length is 256 and it is independent of the set card command.

    CHARACTER

    SET CHARACTER {TERMINATOR|SEPARATOR|SPECIAL|ALPHA|ILLEGAL|COMMENT | ENDCOMMENT} "characters" This redefines the input character set. You may not redefine the letters "A" to "Z", the numbers "0" to "9", the period "." or the minus and plus signs "-+". The current definitions are: 1. SEPARATORS = ",/=" 2. TERMINATOR = ";" 3. SPECIAL = "@!#$%^&*~`{}|\[]" 4. COMMENT = "(" 5. ENDCOMMENT = "(" 6. ALPHA = "_" 7. ILLEGAL = all non printable characters. Special characters may be imbedded inside an option, but may not be the first character in an option.

    CIRCLE

     This sets the default size for circles. SET CIRCLE [SIZE=dx[,dy]] [PERMANENT]

    This is same as SET ELLIPSE

    PERMANENT - Makes the current setting the new default. (Default:1.0)

    If dx is omitted it is set to the default. If dy is omitted it is the same as dx.

    CLEAR

    SET {CLEAR|ERASE} {DEFERRED|IMMEDIATE}

    1. DEFERRED - After a CLEAR or NEW PLOT command the screen is not cleared until data is plotted. In other words the current plot remains on the screen until the new plot appears. 2. IMMEDIATE - The screen is cleared immediately after a CLEAR or NEW PLOT command.

    COLOR

    SET COLOR [WHITE|RED|GREEN|BLUE|YELLOW|MAGENTA|CYAN] [PERMANENT]

    (Default:WHITE) This sets the default color of the display or the pen number. This is effective only for the current plot, or until another SET COLOR or SET PEN command. If PERMANENT is specified the current color is the permanent default. See:Command SET PEN

    If no options are specified it is set to the WHITE.

    COMMAND

    SET COMMAND [MAXSUBSTITUTION=n] This sets the maximum number of command substitutions allowed on a single line. (Default:MAXSUBSTITUTIONS=1000)

    Ctrl_Z

     SE Ctrl_Z [ON|OFF]

    Enables or disables the Ctrl_Z key as a means of stopping TOPDRAWER. (Default:ON)

    CYCLE

    SET CYCLE [NUMBER=n] [ENTRY[=n]] [WIDTH|INTENSITY=n] [NOCOLOR|WHITE| RED|GREEN|BLUE|YELLOW|MAGENTA|CYAN] [NOTEXTURE|SOLID|DOTS| DASHES|DAASHES|DOTDASH|PATTERNED|FUNNY|SPACE] [SYMBOL=sym] [PERMANENT] This selects a cycle of attributes to be used when the CYCLE option is used with HISTOGRAM, JOIN, CONTOUR, or PLOT.

    Additional Information on:

  • options
  • examples
  • defaults

    • DATE

     SET DATE [YYYY\MM\DD] [MONTH=n] [YEAR=n] [DAY=n] [JANUARY,...,DECEMBER] This sets the base date for date\time values. Date\time is normally expressed in hours. However since it is only single precision it is accurate to only 7 digits or about 1 day on the date 1900. If greater accuracy is needed you may set the base date to a value within the range of time you need to express. If you do not specify any options the base date is reset to the original default. (Default:0\1\1)

    Options YEAR,MONTH, or DAY allow you to reset just the selected value. Instead of MONTH=3 you may also specify MARCH. All 3 may be modified using the standard YEAR\MONTH\DAY notation.

    DEVICE

    This selects the unified graphics device and sets options back to default values. This is equivalent to starting a new plot on another device. SET DEVICE [name] ["option_string"] [SIDEWAYS|ROTATED|ORIENTATION=n] [LANDSCAPE|PORTRAIT] [COlOR[=ON|OFF] [FILE|OUTPUT|DDNAME=filename|CHANNEL=dev:] [INTERACTIVE|SEQUENTIAL|SLAVE] [ADD|UNIT=n] [IDENT=aaaa] [NUMBER=nnnn] [PERMANENT] [WIDTH=n] [HEIGHT=n] [REVERSE] This selects the device name. It is modified by the option_string. If omitted the default is used. See:PERMANENT.

    (Interactive Default:TEK)

    (Batch Default:PS)

    Additional Information on:

  • Names
  • COLOR
  • LANDSCAPE-PORTRAIT
  • TEST
  • CALCOMP
  • EXCL
  • GKS
  • GRINNELL
  • HPGL
  • IMAGEN
  • POSTSCRIPT
  • PRINTRONIX
  • QMS-1200
  • REGIS
  • SIXELS
  • TEKTRONIX
  • TEK4027
  • VERSATEC
  • Xwindows
  • string
  • ADD
  • FILE
  • WIDTH|HEIGHT
  • IDENT
  • INTERACTIVE
  • NUMBER
  • ORIENTATION
  • REVERSE
  • SIDEWAYS
  • PERMANENT
  • UNIT
  • Example

    • DIAMOND

     This sets the default size for diamonds. SET DIAMOND [SIZE=dx[,dy]] [PERMANENT]

    PERMANENT - Makes the current setting the new default. (Default:1.0)

    If dx is omitted it is set to the default. If dy is omitted it is the same as dx.

    DIGITS

    SET DIGITS=n

    Sets the number of significant digits displayed in a SHOW DATA command and the lexicals. The number of digits may be set to a value from 0 to 7. If n=0 then the number of digits is adjusted to suit the display. If n is omitted it is assumed to be 0. (Default:DIGITS=0)

    ELLIPSE

    This sets the default size for the major and semi-major ellipse sizes. If dy is omitted the ellipse becomes a circle. SET ELLIPSE [SIZE=dx[,dy]] [PERMANENT]

    PERMANENT - Makes the current setting the new default. (Default:1.0)

    If dx is omitted it is set to the default. If dy is omitted it is the same as dx.

    ERRORS

    SET ERRORS [{DEFERRED|IMMEDIATE|LIST}] [WAIT|PAUSE[=ON|OFF]]

    1. DEFERRED - The error messages appear after the plot is finished. 2. IMMEDIATE - The error messages appear when the command is entered. 3. LIST - The error messages appear only in the listing file. 4. WAIT - When error messages are immediate, WAIT causes TOPDRAWER to wait after each message. PAUSE is a synonym for wait.

    This option remains the same until changed by a SET ERRORS command. (Default:IMMEDIATE,NOWAIT)

    EXACT

    SET EXACT [ON|OFF] [PERMANENT] Sets the character comparison to be exact rather than case blind. (Default:OFF)

    FILE

     This selects the file names for data input, output, and journaling. SET FILE [INPUT=filename] [LIST|OUTPUT=filename] [JOURNAL=filename] NOTE This command is very different from the original SLAC version of TOPDRAWER.

    Additional Information on:

  • INPUT
  • LIST
  • JOURNAL
  • filename
  • example

    • FILL

     SET FILL [ENTRY[=n]] [FULL] [SIZE[=n]] [ANGLE[=n]] [ALTERNATE=[ON|OFF]] [WIDTH|INTENSITY=n] [NOCOLOR|WHITE|RED|GREEN|BLUE|YELLOW| MAGENTA|CYAN] [NOTEXTURE|SOLID|DOTS|DASHES|DAASHES|DOTDASH| PATTERNED|FUNNY|SPACE] This selects a fill attributes to be used when the FILL option is used with HISTOGRAM, JOIN, or PLOT. This selects the type of cross hatch fill. Up to 4 different lines may be used. 1. ALTERNATE selects filling alternate areas. If off the entire area bounded by the outside of the curve is filled. (Default:ON) 2. ENTRY selects the fill entry to change. If n is omitted the next entry is selected. 3. FULL sets the fill size to be the same as the screen resolution, the angle is set to 90, and the WIDTH is set to 1. 4. SOLID... selects the line texture to use. (Default:NONE) 5. WHITE... selects the line color to use. (Default:NONE) 6. ANGLE the angle that the line is to be drawn at. 0 is horizontal, while 90 is straight up and down. (Default:+-45 degrees) 7. SIZE the separation between the lines. If negative this is specified in pixels. If positive it is specified in inch. (Default:0.1) 8. WIDTH selects the line width to use (0 to 5). A width of 0 indicates no width is selected. (Default:NONE) IF no options are specified, the fill patterns are reset to the default value.

    FIT

     SET FIT [options] Sets the fitting options. See:Command FIT.

    FLUSH

     FLUSH [ON|OFF] This selects automatic flush of plot data. When automatic flushing of data is on, plot data is displayed immediately after each interactive line of input. When OFF plot data is only displayed after a FLUSH command or when the plot buffer is full. Pause is normally on for interactive devices, and off for non interactive.

    FONT

     This selects which fonts are used in generating plots. SET FONT [BASIC|EXTENDED|DUPLEX] 1. BASIC - 64 character uppercase font (not useful) 2. EXTENDED - Full font with Greek and lowercase (Default) 3. DUPLEX - Fancy font. This one may not look good on devices such as Tektronix 4010 with limited resolution. This also requires the most memory and time to generate.

    This option remains in effect until changed by a SET FONT command. The EXTENDED and DUPLEX fonts both use proportional spacing. If you wish to use a fixed spacing font See:Command SET MODE PROPORTIONAL.

    FORMAT

    Sets the format used by the Fortran READ statement. SET FORMAT "format"

    This is useful if you wish to skip lines at the beginning of a line when you are using a list file as input to TOPDRAWER. Normally you do not need to use this command, unless the data is in an extremely weird format. The format is limited to 64 characters. (Default:(256A1) The number of columns is also limited by SET CARD. This option remains the same until changed by a SET FORMAT command. This option has no effect on input you enter interactively at the terminal. Example If you wish to skip the first 10 columns: TD:SET FORMAT "(10x,256A1)"

    GRID

    This causes a grid to overlay the plot when axes are drawn. The grid lines are lined up with the large tick marks. This acts on the current plot only a new SET GRID is required for each plot or the options PERMANENT must be specified. The command must be followed by either a HIST, JOIN, BARGRAPH or PLOT command to be effective. SET GRID [ON|OFF] [Y|HORIZONTAL|X|VERTICAL!Z[=ON|OFF]] [SYMBOL[=sym]] [XY|YZ|ZX[=ON|OFF]] [CYCLE[=ON|OFF]] [OUTLINE[=ON|OFF]] [SIZE=n] [INTENSITY|WIDTH=n] [NOCOLOR|WHITE|RED|GREEN|BLUE|YELLOW|MAGENTA|CYAN] [NOTEXTURE|SOLID|DOTS|DASHES|DAASHES|DOTDASH|PATTERNED|FUNNY| SPACE] [THETA=n] [PHI=n] [ANGLE=n] [PERMANENT]

    Additional Information on:

  • options
  • example

    • HISTOGRAM

     SET HISTOGRAM [HBOOK|HANDYPAK|RICE] [APPEND[=ON|OFF]] [CHECK[=ON|OFF]] [CONFIRM[=ON|OFF]] [ENTRIES[=ON|OFF]] [ERRORS[=ON|OFF]] [OVERFLOWS[=ON|OFF]] [LOG[=ON|OFF]] [SECTION=section_name] [FILE=filename] [NUMBER=n] [SELECT|NAME='hist_name'] [IDENT=nnn] [EXACT[=ON|OFF]] [CURRENT|NEXT|PREVIOUS|FIRST| LAST] [PROCESS='Process_name'] [PID='nnnn'] [TITLE[=ON|OFF]] [WRAP[=ON|OFF] [HISTOGRAM[=ON|OFF]] [MESH[=ON|OFF]] HBOOK4 only [AREA|DIRECTORY[="directory"]] [TREE[=ON|OFF]] [WILD[=ON| OFF]] [SHRE=section_id] [IOFFSET=n] [CYCLE=n] NTUPLES [NTUPLES[=ON|OFF]] [EVENTS[=[FROM] n [TO] n] [[N][D]{X|Y|Z|U| V|W|THETA|RADIUS|PHI}=N] [NLIMIT[=n [FROM] n [TO] n] [NMASK[=n [IDENT=n] [X=n] [Y=n]] This selects a histogram and puts it into data storage. Once a histogram is selected, the data is available for plotting. The command: SHOW HISTOGRAMS Shows the current list of histograms available. LIST HISTOGRAMS Produces a listing of the current histograms.

    Additional Information on:

  • options
  • APPEND
  • AREA|DIRECTORY
  • CHECK
  • CONFIRM
  • ENTRIES
  • ERRORS
  • FILE
  • HISTOGRAM
  • LOG
  • MESH
  • NTUPLES
  • NUMBER
  • OVERFLOWS
  • CURRENT|NEXT|PREVIOUS|FIRST|LAST
  • SECTION
  • SELECT
  • TITLE
  • TREE
  • WILD
  • WRAP
  • lexicals
  • restrictions
  • examples

    • INPUT

     See command: SET CARD

    INTENSITY

     SET {INTENSITY|WIDTH} level [PERMANENT] This sets the intensity level or line width of a plot. The permanent default is restored when a new plot is started.

    level=1 to 5. (Default:2) 5 is the brightest (widest). If no intensity is specified it is set to 2. PERMANENT - Sets the current width to be the new default.

    LABELS

    This sets the size and enables the numeric labels on each axis. To control the default number of ticks see SET SCALE. SET LABELS [SIZE=n] [CHARACTERS=n] [INSIDE[=ON|OFF] [ALL|TOP|BOTTOM| RIGHT|LEFT|X|Y|Z] [ON|OFF] [SHIFT=n] [INTENSITY|WIDTH=n] [NOCOLOR|WHITE|RED|GREEN|BLUE|YELLOW|MAGENTA|CYAN] [PERMANENT] This acts on the current plot only if PERMANENT not specified. If the parameters are omitted they are reset to the original default. To control other individual elements of the axes use: SET AXES, SET TICKS, SET OUTLINE, SET SCALES

    (DEFAULT:LEFT ON,BOTTOM ON)

    Additional Information on:

  • ALL|TOP|BOTTOM|LEFT|RIGHT
  • X|Y|Z
  • CHARACTERS
  • INSIDE
  • SIZE
  • SHIFT
  • ON|OFF
  • INTENSITY
  • WHITE...
  • PERMANENT
  • examples

    • LIMITS

     SET LIMITS [CURSOR] [PERMANENT] [SCALE n1 [[TO] n2]] either... FROM [X=]nx,[[Y=]ny,[[Z=]nz]]] TO [X=]nx,[[Y=]ny,[[Z=]nz]]] or... [X [FROM] x [TO] x] [Y [FROM] y [TO] y] [Z [FROM] z [TO] z] [XMIN=x] [XMAX=x] [YMIN=y] [YMAX=y] [ZMIN=z] [ZMAX=z] [PERMANENT] Limits define the space to draw the data. They do not necessarily limit the data points plotted. Normally limits are automatically set from all available data during the first plot. If you read data, plot and then read more data and plot again, the first data set determines the limits. This command allows you to set the limits of the plot independently of the data. This should be used before the first PLOT, JOIN, HIST, or BARGRAPH command. The limits are reset when a new plot is started. If this command is issued without any limits specified, all currently set limits are removed. WARNING If this command is issued in between 2 plots overlaying each other, they will not have the same scales.

    See also:SET WINDOW

    Additional Information on:

  • SCALE
  • CURSOR
  • PERMANENT
  • Example

    • MODE

     This controls a grab-bag of options. SET MODE [AUTOPLOT[=ON|OFF]] [ABORT[=ON|OFF]] [APPEND[=ON|OFF]] [CHECK[=ON|OFF]] [CONFIRM[=ON|OFF]] [ERASE[=ON|OFF]] [DEBUG[=ON|OFF]] [ECHO=[n]|NOECHO] [EXPAND[=ON|OFF]] [FILECASE=UPPER|LOWER|MIXED] [HARDTEXTURE[=ON|OFF]] [JOURNALING[=ON|OFF]] [LISTING[=ON|OFF]] [LOG[=ON|OFF]] [MONITOR[=ON|OFF]] [PROPORTIONAL[=ON|OFF]] [QUICK|SLOW] [SHOW[=ON|OFF]] [TITLE[=ON|OFF]] [TRACE[=ON|OFF]] [TREE[=ON|OFF]] [VECTOR[=ON|OFF]] [VLOG[=ON|OFF]] If ON|OFF is omitted ON is assumed. Most of these options remain the same until explicitly reset. They are generally not reset by a NEW PLOT command. (Default:AUTOPLOT=ON, ABORT=ON, APPEND=OFF, CONFIRM=OFF, ERASE=OFF, DEBUG=OFF, ECHO=20, HARD=ON, JOURNALING=ON, LISTING=ON, LOG=OFF, MONITOR=OFF, PROPORTIONAL=ON, SHOW=OFF, TRACE=OFF, TREE=OFF, VECTOR=ON)

    Additional Information on:

  • AUTOPLOT
  • ABORT
  • APPEND
  • CONFIRM
  • CHECK
  • DATAVECTOR
  • DEBUG
  • ECHO
  • ERASE
  • EXPAND
  • FILECASE
  • HARDTEXTURE
  • JOURNALING
  • LISTING
  • LOG
  • MONITOR
  • PROPORTIONAL
  • QUICK
  • SHOW
  • TITLE
  • TRACE
  • TREE
  • VECTOR
  • VLOG

    • MONITOR

     This sets the type of plot each monitor mode produces. SET MONITOR [{ALL|DATA|MESH} {BIN|CONTOUR|JOIN|HISTOGRAM|PLOT "options"}] The options may be any legitimate options for the type of plot selected. If you do not supply any options then the defaults are used. example TD:SET MONITOR MESH HISTOGRAM "BLOCK" Produces a block or "Lego" plot when you monitor a mesh histogram. TD:SET MONITOR DATA JOIN "1 dots Joins normal data sets with single dotted line segments. TD:SET MONITOR DATA PLOT "SYM=5O" MESH JOIN Plots normal data and joins mesh data. (Default:MESH PLOT "NORAN VAR SYM=10" DATA HISTOGRAM "")

    NAME

     SET NAME "New data set name" [CONFIRM[=ON|OFF]] [SETS=[FROM] n1 [TO] [n2]] [SELECT="old name"]

    Sets a new name for all the selected data sets. If no sets are specified, then all data set names are modified. If the name ends in "%" then the old name is appended to the new name.

    Options 1. CONFIRM - If selected Topdrawer will prompt you for each data set. You repy YES, NO, ALL, or QUIT. ALL will do the rest without any more prompts, while QUIT skips all the rest. 2. SETS - Selects a range of data sets to rename. 3. SELECT - Selects the data sets by name. WIld characters are permitted "*" or "%" See:SET EXACT. Example TD:SET NAME "My data" SET=5 Data set number 5 has the new name "My data" TD:SET NAME "My %" SELECT="Your*" All data sets beginning with the name "Your" are renamed to "My Your..."

    ORDER

    This sets the order in which data must be entered. The order is the same as specified in the set order command. This option remains the same until the next SET ORDER or NEW PLOT command. This has no effect on mesh data input. SET ORDER [[N][R|D]{X|THETA} [fctr]] [[N][R|D]{Y|RADIUS} [fctr]] [[N][R|D]{Z|PHI} [fctr]] [[N][R|D]U [fctr]] [[N][R| D]V [fctr]] [[N][R|D]W [fctr]] [SYMBOL] [DUMMY[=n]] [PACKED[=ON|OFF]] [PERMANENT]

    Additional Information on:

  • options
  • Examples

    • OUTLINE

     This enables the outline on each axis. The outline is the line drawn at the edge of the plot. SET {OUTLINE|FRAME} [INHIBIT|ENABLE] [ALL|TOP|BOTTOM|RIGHT|LEFT] [ON| OFF] [INTENSITY|WIDTH=n] [NOCOLOR|WHITE|RED|GREEN|BLUE|YELLOW|MAGENTA|CYAN] [NOTEXTURE|SOLID|DOTS|DASHES|DAASHES|DOTDASH|PATTERNED|FUNNY| SPACE] [PERMANENT] This acts on the current plot only if PERMANENT not specified. To control other individual elements of the axes use: SET AXES, SET TICKS, SET LABELS, SET SCALES

    (Default:ON)

    Additional Information on:

  • options

    • PATTERN

     This selects the pattern for patterned lines. These are produced by JOIN, HIST, PLOT, or BAR commands. This option remains the same until changed by a SET PATTERN command. SET PATTERN [RANDOM|FUNNY] [DOT] [DASH] [DAASH] [SPACE] [SIZE=n] [PERMANENT] SET PATTERN p1 s1 p2 s2 ....p10 s10

    1. RANDOM - The distance following this is random. 2. DOT - Draws a single dot followed by a 0.1" space. 3. DASH - Draws a short dash 0.1" long followed by 0.1" space. 4. DAASH - Draws a long dash 0.3" followed by 0.1" space. 5. SPACE - Adds 0.05" of blank space. 6. SIZE=n - Size of dashes, and the distance between dashes and dots. (Default:0.1) 7. p = distance to draw in inches. If negative it varies randomly. 8. s = distance to skip in inches. If negative it varies randomly. 9. PERMANENT - Makes the current SIZE the permanent default.

    You may enter up to a maximum of 20 values or 10 DOT/DASH/DAASH specifiers. Random values vary from zero to the value specified. You may also specify patterns as part of any drawing command. For example: TD:HISTOGRAM PATTERN DOT DOT DASH is the same as ... TD:SET PATTERN DOT DOT DASH; HISTOGRAM PATTERN or... TD:HISTOGRAM DOT DOT DASH See:Command SET TEXTURE

    Additional Information on:

  • example

    • PAUSE

     SET PAUSE|WAIT [ON|OFF] Pause is normally set on for interactive devices, and off for non interactive. The Pause occurrs at each NEW PLOT command inside an input file, or when deferred errors must be typed.

    PEN

     This selects the default Calcomp plotter pens or the color. This is effective only for the current plot, or until another SET COLOR or SET PEN command. SET PEN 1|2|3|4|5|6|7

    See:Command SET COLOR

    (Default:1)

    If no pen number is specified it is set to 1.

    POLAR

    SET POLAR [ON|OFF] [DEGREES|RADIANS|GRAD|PERCENT|FULLCIRCLE=n] [PERMANENT]

    This sets up to plot in polar coordinates. Coordinates are (R,THETA,Z) instead of (X,Y,Z) In addition you may select the scale for angle representaton. This affects not only the plotting of data, but also the FFT and TRANSFORM commands. 1. ON|OFF turn the polar coordinates on or off. (Default:ON) 2. PERMANENT - Sets these parameters permanently. 3. DEGREES... - Selects angle representation (Default:DEGREES) A. GRAD - (0-400) B. DEGREES - (0-360) C. PERCENT - (0-100) D. RADIANS - (0-6.2831853) E. FULLCIRCLE=n - (0-n)

    This feature is not fully implemented. You still set the limits in X,Y,Z coordinates, and automatic scaling centers the origin. When you plot, the axes are not automatically generated if polar coordinates are on. You must manually plot the axes with the command: PLOT AXES. If you wish the X and Y axes to be scaled the same way you should. TD:SET LIMITS SCALE See commands:X,SET ORDER,SET STORAGE,SET SPHERICAL

    Example

    TD:SET POLAR FULL=1.0 Angles represented by a number from 0 to 1.0 range from 0 to 360 degrees.

    PROMPT

    SET PROMPT [MAIN|PAUSE] [ERASE] [TOP] [BOTTOM] [BELL] [nn] ["prompt_string"]

    This sets the current prompt string with a maximum of 80 characters. If a null or blank string is used, then there is no prompt. If a prompt has imbedded blanks it must be enclosed in quotes. The prompt string remains the same until a new one is selected. 1. MAIN - Is the main prompt string. (Default:"TD:") 2. PAUSE - Is the prompt string used when a NEW PLOT is started. (Default:"PAUSE:") 3. ERASE - The prompt erases the screen (ANSI terminal). This erases text from a VT-1xx/2xx compatible terminal. This does not erase TEKTRONIX graphics, but REGIS graphics will be erased. This must be precede the string. 4. TOP - The prompt is at the top of the screen (ANSI terminal). 5. BOTTOM - The prompt is at the bottom of the screen (ANSI terminal). 6. BELL - This rings the bell for each prompt. 7. nn - This inserts a control character (0-255) into the string. 8.

    This command is useful for controlling the prompt for different types of terminals. On some terminals you can control the position of the prompt, so that it will not interfere with the plot, while on others, you may not want any prompts.

    Additional Information on:

  • Examples

    • REVISION

     SET REVISION=n.m Sets the current revision level. This affects the operation of TOPDRAWER. By lowering the revision level you may return to old behavior. Some of the old revision levels are: * 1.0 - Original version * 2.0 - SET THREE THETA modified to conform to documentation. * 2.2 - X= SET=n FROM=n1 TO=n2... Worked incorrectly if n>1.

    SECONDARY

     SET SECONDARY [INTENSITY|WIDTH=n] [WHITE|RED|GREEN|BLUE|YELLOW|MAGENTA|CYAN] [NOTEXTURE|SOLID|DOTS|DASHES|DAASHES|DOTDASH|PATTERNED|FUNNY| SPACE]

    SEGMENTS

     SET SEGMENTS [ALL |AXES |LABELS |OULINE |POINTS |PLOTS |TICKS |TITLES =[ON|OFF]] Breaks the selected objects into separate segments. Each segment is immediately flushed.

    SCALE

     This selects the scales to use. To select the range of data to plot See:Command SET LIMITS. SET SCALE {X|Y|Z|ALL} [LINEAR] [MONTHS] [YEARS] [DAYS|TIME|HOURS|MINUTES|SECONDS] [POWER[=n]|ROOT[=n]] [USER=[n1[,n2,...n10]]] [LABELS|TICKS=n [LONG|SHORT|NONE]] [NORMAL [MEAN=x] [DEVIATION=s] ] [[-]LOGARITHMIC] [LABELS=n1,n2... [EXPONENTIAL[=ON|OFF]][NONE]] [TICKS=n1,n2... [LONG|SHORT|ALL|NONE]] [DECADES=n] [SUBTICKS=n] [REVERSE[=ON|OFF]] [BASE=n] [PERMANENT] To control other individual elements of the axes use: SET AXES, SET TICKS, SET LABELS, SET OUTLINE (Default:ALL LINEAR LABELS=6 TICKS=5)

    Additional Information on:

  • X|Y|Z|ALL
  • BASE
  • DAYS
  • LABELS
  • LINEAR
  • LOGARITHMIC
  • MINUTES
  • MONTHS
  • NORMAL
  • POWER|ROOT
  • REVERSE
  • SECONDS
  • TICKS
  • TIME-HOURS
  • USER
  • YEARS
  • PERMANENT
  • Example

    • SHADOW

     This causes a 3-d plot to be shadowed onto the back side where the grid is drawn. SET SHADOW [ALL[=ON|OFF]] [SYMBOL[=ON|OFF]] [Y|X!Z[=ON|OFF]] [XY|YZ| ZX[=ON|OFF]] [INTENSITY|WIDTH=n] [NOCOLOR|WHITE|RED|GREEN|BLUE|YELLOW|MAGENTA|CYAN] [NOTEXTURE|SOLID|DOTS|DASHES|DAASHES|DOTDASH|PATTERNED|FUNNY| SPACE] [PERMANENT]

    To produce shadowing you must select at least one plane to shadow the plot in (XY,YZ,ZX).

    Additional Information on:

  • options
  • example

    • SHIELD

     Sets an area to be shielded. Nothing may be drawn inside this area while shielded. SET SHIELD [=n] [OFF] [DAtA|TExT] [FROM]|TO [[X=]nx,[Y=]ny,[Z=]nz]] [CURSOR]

    1. n - The shield number between 1 and 4. If unspecified the next available shield is used.

    2. OFF - Turns the n'th shield off. If n is not specied all shielded areas are turned off.

    3. FROM|TO - Allows you to specify the limit of the shielded area. If no limits are specified the current window is shielded.

    4. DATA - Specifies the limit in data coordinates.

    5. TEXT - Specifies the limit in text coordinates.

    6. CURSOR - You use the cursor to specify the limits.

    example TD:SET SHIELD FROM 1,2 to 3,5 Sets a shielded area in text coordinates. TD:SET SHIELD DATA FROM Y=5 Shield all data from Y=5 for all X values.

    SIZE

    This sets the physical size of the plot. Once set it remains the same until a new SET SIZE command is issued. This command should only be used immediately after a NEW PLOT command or a SET DEVICE command. It may not be used after any commands that plot data. SET SIZE [[X=]x [BY|Y=] y] [UNITS=units] [CM|CENTIMETERS|MM|MILLIMTERS|METERS|INCHES] [MAGNIFY|REDUCE=factor] [SIDEWAYS|ROTATED|NORMAL|ORIENTATION=n] [MARGINS=[nl,[nr,[nb,[nt]]]]] [LEFT=n] [RIGHT=n] [BOTTOM=n] [TOP=n] If no options are specified the sizes are reset to the defaults. (Default:NORMAL 13 by 10 inches MARGINS=0)

    Additional Information on:

  • x,y
  • UNITS
  • CM....
  • MAGNIFY|REDUCE
  • ORIENTATION
  • SIDEWAYS
  • MARGINS
  • LEFT|RIGHT|TOP|BOTTOM
  • examples

    • SPHERICAL

     SET POLAR [ON|OFF] [RADIANS|DEGREES|FULLCIRCLE=n|GRAD] [PEERMANENT]

    This sets up to plot in spherical coordinates. (THETA,R,PHI) instead of (X,Y,Z). The data in X is now interpreted as THETA, Y is intepreted as R and Z is intepreted as PHI. The data is not modified, just reinterpreted. R=sqrt(X**2=Y**2+Z**2) THETA=ATAN2(Y,X) PHI=ATAN2(sqrt(x**2+Y**2),Z)

    NOTE: There is no universally accepted convention for THETA or PHI. Various books use different conventons. I have adopted a convention that gives THETA the same definition in both spherical and polar coordinates.

    1. ON|OFF turn the spherical coordinates on or off. (Default:ON) 2. PERMANENT - Sets these parameters permanently. 3. DEGREES... - Selects angle representation (Default:DEGREES) A. GRAD - (0-400) B. DEGREES - (0-360) C. PERCENT - (0-100) D. RADIANS - (0-6.2831853) E. FULLCIRCLE=n - (0-n)

    You still set the limits in X,Y,Z coordinates, and automatic scaling centers the origin. When you plot, the axes are not automatically generated if spherical coordinates are on. You must manually plot the axes with the command: PLOT AXES.

    STATISTICS

    SET STATISTICS [SETS=[FROM] n1 [TO] [n2]] [SELECT="name"] [POINTS|COLUMNS=[FROM] n1 [TO] [n2]] [LINES|ROWS=[FROM] n1 [TO] [n2]] [LIMITED [VLOG[=ON|OFF]] [[FROM]|TO [[X=]nx,[[Y=]ny[,[Z=]nz]]] [RECURSOR] [CURSOR] ] This sets the range of data used by the lexicals. If any changes are made to the data you need to use this command again.

    Additional Information on:

  • LIMITED
  • LINES|ROWS
  • POINTS|COLUMNS
  • SETS

    • STORAGE

     This defines what is kept in storage. SET ORDER automatically calls SET STORAGE if room for extra data is needed. This option remains the same until changed by a SET ORDER or SET STORAGE command. The VAX uses virtual memory, so the actual amount of storage is not not limited, but expands as needed. If you have a virtual memory allocation failure, you may prevent it by preallocating the needed memory with the SIZE option. If you still get memory allocation failures, ask your system manager to increase the available virtual memory. SET STORAGE [ALL] [[N][R|D]X|THETA] [[N][R|D]Y|RADIUS] [[N][R|D]Z|PHI] [[N][R|D]U] [[N][R|D]V] [[N][R|D]W] [SYMBOL] [SIZE=n]

    (Default:SYMBOL,X,Y,DX,DY)

    ALL selects all coordinates. If this command is used without any options, the storage is reset to the default. If all 3 coordinates X,Y,Z are included in storage, 3-d plots are turned on.

    If DX, the error on X, is selected then X is also selected. If NDX is selected then both DX and X are selected. Likewise DY,DZ,..DPHI automatically select Y....PHI. SYMBOL, X and Y are always included in the storage. All other variables must be declared.

    The NDX is the negative half of the error bar while DX is the positive half. If NDX is not in stoage then DX specifies both halves. Similarly NDY and NDZ are the negative halves of the Y,Z error bars.

    If THETA is specified polar coordinates are enabled permanently. If PHI is specified spherical coordinates are enabled.

    SIZE=n allows you to pick the number of words of storage to allocate for the VAX. This is not necessary, but it may save time since you may preallocate the storage and avoid multiple automatic storage expansion. Normally the amount of storage needed for regular data is about n*d+4 where n is the number of points and d is the number of coordinates available in storage (SYMBOL,X,DX,Y,DY,....). For mesh data it is ((n+1)*(m+1)+4)*d+4 where n and m are the mesh dimensions and d is 1 for regular mesh data or 2 for data with errors. If you have a name for the data set it takes up 1 storage location for every 4 characters.

    Example TD:SET STORAGE X Y SYMBOL To see the current storage use the command: SHOW STORAGE. TD:SET STORAGE SIZE=<4+101*201+20> Preallocates storage for a 100 by 200 mesh with an 80 character name.

    SYMBOL

    This selects the default symbol SET SYMBOL "xx" [SIZE=n] [THETA=n] [PHI=n] [ANGLE=n] [PERMANENT] If no parameters are specified the symbol and size are set to NONE and 2 and the angles are turned off. In other words SET SYMBOL is the same as SET SYMBOL=NONE SIZE=2.

    This command determines the symbol plotted data that have no symbol. If you SET SYMBOL before reading data the symbol is assumed for the data you are reading. See:Command READ POINTS and PLOT.

    Additional Information on:

  • xx
  • ANGLE
  • SIZE
  • THETA

    • PERMANENT

     Makes the current symbol the permanent default. Normally a NEW PLOT command resets the symbol to the permanent default.

    Additional Information on:

  • PHI
  • 3-d
  • example

    • TEXTURE

     SET TEXTURE|STRUCTURE [SOLID|DOTS|DASHES|DAASHES|DOTDASH|PATTERNED| FUNNY|SPACE] [PERMANENT] This sets the default texture of a line drawn by a BOX, CIRCLE, ELLIPSE, DIAMOND, PLOT, BAR, JOIN, or HIST command. To set the Texture of the axes, ticks, or outline See:Command SET AXIS, SET OUTLINE, or SET TICKS. You may also specify the texture with any command that draws. For example you may JOIN DOTS or JOIN PATTERN and so on.

    1. SOLID - Solid line 2. DOTS - Dotted line 3. DASHES - Short dashed line 4. DAASHES - Long dashed line (3x) 5. DOTDASH - Dot-dash line 6. SPACE - Adds an extra space between dots/dashes 7. PATTERNED - Line determined by SET PATTERN. 8. FUNNY - is a dot at the ends of each line segment. This is generally only useful for joined and smoothed curves. 9. PERMANENT - Sets the current texture to be the permanent default.

    (Default:SOLID)

    If no options are specified it is set to SOLID. When a new plot is started the texture is set to the permanent default.

    If you specify more than 1 texture option, or use the option PATTERN, then a patterned texture is assumed and the pattern is generated. When FUNNY precedes any other texture specifier then it is generated randomly.

    Additional Information on:

  • example

    • THREE

     This sets parameters for 3-dimensional plots and turns ON 3-d graphics. Essentially you must set up the viewpoint for 3-D. The plot is seen by an observer through a "screen" or window. The location of the screen and observers eye may be specified. SET THREE [ON|OFF|AUTOMATIC]] [CENTER=x,y,z] [VERTICAL=xv,yv,zv] [DIRECTION=xv,yv,zv] [THETA=angle] [PHI=angle] [DISTANCE|RDISTANCE=n] [SCRD=n] [REDUCE|MAGNIFY=n] [ORIGIN=x,y,z] [SEPARATION=s|LEFT|RIGHT|MIDDLE] [WORLD=x [BY] y [BY] z] [XAXIS|YAXIS|ZAXIS=angle] [PERMANENT]

    NOTE: The actual view also depends on the window size selected by SET WINDOW.

    WARNING

    If this command is issued in between 2 plots overlaying each other, they will not have the same scales.

    Additional Information on:

  • Options
  • CENTER
  • DIRECTION
  • DISTANCE,SCRD,RDIST
  • REDUCE|MAGNIFY
  • ON|OFF|AUTOMATIC
  • ORIGIN
  • PERMANENT
  • SEPARATION
  • VERTICAL
  • WORLD
  • XAXIS
  • Revisions
  • Examples

    • TICKS

     This determines the presence or absence of tick marks and their sizes. To control the default number of ticks see SET SCALE. SET TICKS [SIZE=n] [LONG=n] [ALL|TOP|BOTTOM|RIGHT|LEFT|X|Y|Z] [ON|OFF] [INTENSITY|WIDTH=n] [NOCOLOR|WHITE|RED|GREEN|BLUE|YELLOW|MAGENTA|CYAN] [NOTEXTURE|SOLID|DOTS|DASHES|DAASHES|DOTDASH|PATTERNED|FUNNY| SPACE] [PERMANENT] This acts on the current plot only if PERMANENT not specified. If the parameters are omitted they are reset to the original default. To control other individual elements of the axes use: SET AXES, SET TICKS, SET LABELS, SET OUTLINE

    (Default:ALL ON)

    Additional Information on:

  • options
  • examples

    • TITLES

     This sets default title values. SET TITLES [ALL|TOP|BOTTOM|RIGHT|LEFT|X|Y] [INDEX=n] [LINES=n] [MARGIN=n] [SCALE=n] [SHIFT=n] [SIZE=n] [INTENSITY|WIDTH=n] [NOCOLOR|WHITE|RED|GREEN|BLUE|YELLOW|MAGENTA|CYAN] [PERMANENT] [ESCAPE="char"] [SUBSTITUTE="char1char2"] If the parameters are omitted they are reset to the original default. You should make modifications to the title options before any plotting is done. The MARGIN, SIZE, SCALE, INDEX, and LINES all modify the location and size of relative windows. See:Command SET WINDOWS.

    Additional Information on:

  • options
  • ALL|TOP|BOTTOM|LEFT|RIGHT|X|Y
  • INDEX
  • INTENSITY
  • LINES
  • MARGIN
  • PERMANENT
  • SCALE
  • SIZE
  • WHITE...
  • windows
  • ESCAPE
  • SUBSTITUTE
  • examples

    • UNITS

     This sets the units that you may use to specify sizes and locations. SET UNITS [REDUCE=units] [ALL|TEXT|CHARACTERS] [CM|CENTIMETERS| DM| DECIMETERS| MM|MILLIMTERS|METERS|INCHES| POINTS|MILS] If no options are specified the sizes are reset to the defaults. (Default:TEXT INCHES CHARACTERS REDUCE=10)

    Additional Information on:

  • CM....
  • REDUCE
  • ALL...

    • WAIT

     See:Command SET PAUSE

    WIDTH

     This sets the default line width or intensity of a plot. SET WIDTH level [PERMANENT] level=1 to 5. (Default:2) 5 is the widest (brightest). PERMANENT - Sets the current width to be the new default. If no options are specified it is set to 2.

    WINDOWS

     There are 3 ways to set windows, absolute, numbered, or relative.

    Absolute windows SET WINDOW|AREA [CURSOR] {X|Y}[FROM] n1 [TO] n2] [AT n1 [SIZE] n2] [LEVEL=n] or... SET WINDOW|AREA [FROM] nx,ny [TO] nx,ny] [AT nx,ny [SIZE] nx,ny] Sets the X,Y axes to run between the specified limits in inches.

    Numbered SET WINDOW [{FIRST|LAST|NEXT|PREVIOUS|n1 [OF n2]}] [LEVEL=n| INSIDE|OUTSIDE] Divides the entire screen into n2 windows of equal size, and sets the current window to number n1. The windows are as close to square as possible.

    Relative SET WINDOW [{X|Y} n1 [OF n2]] [LEVEL=n] Divides one axis of the screen into n2 windows of equal size and selects one of them.

    WARNING

    If this command is issued in between 2 plots overlaying each other, they will not have the same scales.

    Additional Information on:

  • ABSOLUTE
  • NUMBERED
  • RELATIVE
  • LEVEL
  • labels
  • examples
  • 3-d