LAbel
LAbel G#|X|Y|Top|OX|OY|OTop|File [label]
Place a label. The command "LA G# label" associates a label with
a particular plot group. Thus the command sequence "LAB G1 Time;
Xaxis 1", associates the label "Time" with group 1. When the command
"Xaxis 1" executes, it makes group 1 the x-axis group, and as a result
the label "Time" will automatically appear on the x-axis.
The arguments "X", "Y", and "Top" would place a label on the x-axis,
y-axis, or the top of the plot. These labels override the Group labels
so that if the x-axis is labelled with both a group label and a x
label, then only the x label appears. When using the "Xaxis Linear"
command, "LAbel X" the the only way to label the x-axis. It is possible
to place an additional line of text just outside these locations by
putting the letter `"O"' in front of these names. For example, "OT"
would write a second label above the top label. Finally one can change
the file name by using "LA File [name]".
If you should at any time wish to delete a label, then just omit the
"[label]" from the command.
LAbel OFf
Suppress plotting of all text labels. (This speeds up the production
of the plot on slow devices.)
LAbel ON
Undo the effects of "LAbel OFf".
LAbel NX|NY ON|OFf [winlist]
where "[winlist]" is a list of windows. NX affects the plotting of
the numeric labels on the x-axis, NY on the y-axis. Thus "LAbel NX OFF 1";
"LAbel NY OFF 1", will prevent the plotting of the numeric labels in both
the x and y directions for the first window. (Note, there are 32 numbered
labels, so using "LAbel NX OFf", followed by several "LAbel #" commands
will allow you to create labels consisting of text strings etc.
LAb POS Y #
Allows the position of the y label(s) to be changed. The default
position is "LA POS Y 2.0".
LAbel Rotate
Rotate numerical labels plotted on the y-axis. The default PGPLOT
mode is to plot the y-axis numerical labels in the vertical direction.
"LAbel Rotate" will rotate these labels so they are written in a
horizontal direction. If you issue the command a second time, then
the labels will flip back to vertical in the next plot.
examples
PLT> LA F ! Delete the file name from the plot
PLT> LA T Test! Plot ! Top label is Test
PLT> LA T "Test! Plot" ! Top label is Test! Plot
Parm
LAbel Parm ON
Display the parameter values associated with the current model,
on the right side of the plot. (This is the default.)
LAbel Parm OFf
Suppress the display of the parameter values on the right side
of the plot.
#
LAbel # [clist] "string"
Allow a label to be placed anywhere on the existing graph. Here # is
a number in the range 1 to 32, "[clist]" is a list of subcommands that
allow you to change various attributes of the label, and ``string''
is the (optional) text. For example,
PLT> LAbel 1 Pos 2 2 "test"
will create label 1 at position (2,2) containing the message "test".
CEnter
LAbel # CEnter Top|Cap|Half|BAse|BOttom
Control the vertical position of the text string. The default
position is "Half", although the use of the "LIne" subcommand will
override this.
COlor
LAbel # COlor #
Cause the label to be plotted with color index #. (Default is color
index 1.)
CSize
LAbel # CSize #
Cause the label to be plotted with character size #. (Default is
character size 1.0.)
Justify
LAbel # Justify Left|Center|Right
Control justification of text string. (Default is left justify.)
LIne
LAbel # LIne # [#]
Draw line at angle # (in degrees) from position to the label.
If the second number is specified, then it will be used as the length
of the line in viewport units. (Default line length is 0.08.) If no
number follows the "LIne" command, then the line is turned off.
LStyle
LAbel # LStyle #
Control the line style of the line plotted, when the "LIne"
subcommand is used. (Default is 1.)
Marker
LAbel # Marker #
Include marker # in the text line. The default will produce a left
justified string just to the right of the marker. If you then right
justify the string, then the string will appear to the left of the
marker. In either case, the (x,y) position corresponds to the position
of the marker.
MSize
LAbel # MSize #
Use the specified marker size with plotting the specified numbered
label. Default size is 1.0.
Position
LAbel # Position # #
Specify the (x,y) location of the string in world coordinates.
When using the "LIne" subcommand, "Position # #" gives the (x,y)
location of the position being `pointed at' with the text string at
the other end. If the "Marker" subcommand is used, then "# #" refers
to the location of the marker. For other cases, "# #" is the location
of the string. The "CEnter" and "Justify" subcommands can later
override how text is plotted relative to a location. (The default
location is (0,0).)
TExt
LAbel # TExt one=%1% two=%2%
All the text on the line following the TExt subcommand becomes
the label. The main difference between using simple " and using TExt
has to do with the command parsing. Thus with LAb 1 "%1%" the label
would be the actual string %1% whereas LAb 1 TExt %1% would substitute
%1% with the first argument.
To
LAbel # To # #
Draws a line from the position specified with the Pos # # option to
the location in the To field.
NOTE: If you add a text label, the text will be plotted at the "To"
location. This is for maximum compatibility with the "LAb # LI 45 .1"
command.
Example:
PLT> LAB 1 Pos 0 1 To 0 1 " " ! Draw line from (0,1) to (1,0)
Rotate
LAbel # Rotate #
Plot the label at an angle of # (degrees) relative to the x-axis.
(Default angle is 0.)
VPos
LAbel # VPos # #
Specify the (x,y) location of the string in viewport coordinates.
When using the "LIne" subcommand, "Position # #" gives the (x,y)
location of the position being `pointed at' with the text string at
the other end. If the "Marker" subcommand is used, then "# #" refers
to the location of the marker. For other cases, "# #" is the location
of the string. The "CEnter" and "Justify" subcommands can later
override how text is plotted relative to a location.
LAbel # VPos Curs
Display the cursor at the current default position. You can move
the cursor to the desired position using the standard (PGPLOT) cursor
keys. Once at the location where you want the label, press the space
bar. The next time the plot is drawn, the label will appear at the
new location.
examples
PLT> LAbel 1 "TEST" ! Place the word TEST at location (0,0)
PLT> LAbel 1 P 10 10 ! TEST will now appear centered at (10,10)
PLT> LAbel 1 LIne 90 ! Draw a vertical line from the point (10,10) to
! the word TEST.
PLT> LAbel 1 CO 3 ! Color line and word TEST green
PLT> LAbel 1 P 10 10 LIne 90 CO 3 "TEST" ! Does all the above in a
PLT> ! single command
Return to plt main page.