SED navigation bar go to SED home page go to Dataplot home page go to NIST home page SED Home Page SED Contacts SED Projects SED Products and Publications Search SED Pages
Dataplot Vol 1 Auxiliary Chapter

LABEL OFFSET

Name:
    ...LABEL OFFSET
Type:
    Plot Control Command
Purpose:
    Specifies the offset of the labels to appear on subsequent plots.
Description:
    The labels are the text which appear below the bottom horizontal frame line and outside of the vertical frame lines. They typically define the variables/axes which are being plotted.

    For the horizontal labels, the displacement (LABEL DISPLACEMENT) is the vertical distance from the frame to the label and the offset is the horizontal displacement. For the vertical labels, the displacement (LABEL DISPLACEMENT) is the horizontal distance from the frame to the label and the offset is the vertical displacement of the label.

    The label offsets hold for all subsequent plots until defaulted (via the ...LABEL OFFSET command with no arguments) or until overridden with new label offsets. The analyst can define offsets for all 5 plot labels: 1) 3 below the bottom horizontal frame; 2) 1 to the left of the left vertical frame; 3) 1 to the right of the right vertical frame line. The label is specified by the prefix in the command.

Syntax:
    <prefix>LABEL OFFSET <value>
    where <value> is a number or parameter that specifies the offset;
    and <prefix> is one of the following:
      X1 refers to the first horizontal label
      X2 refers to the second horizontal label
      X3 refers to the third horizontal label
      X refers to the first horizontal label
      Y1 refers to the left vertical label
      Y2 refers to the right vertical label
      Y refers to the left and right vertical labels
      no prefix refers to all 5 axis labels.
Examples:
    Y1LABEL OFFSET 5.0
    YLABEL OFFSET 10
    X1LABEL OFFSET 5
    X3LABEL OFFSET 13
Note:
    A ...LABEL OFFSET command with no arguments reverts the offset to default. Thus X1LABEL OFFSET with no arguments reverts the first horizontal axis label to default. A ...LABEL OFFSET command with no prefix refers to all 5 labels. Thus LABEL OFFSET 8 assigns the offset 8 to all 5 labels. LABEL OFFSET with no prefix and no arguments reverts all 5 labels to default.
Note:
    This command recieves infrequent usage. The most common application is with the multiplot commands SCATTER PLOT MATRIX, FACTOR PLOT, and CONDITION PLOT.
Default:
    The default offsets are all zero.
Synonyms:
    None
Related Commands:
    LABEL = Specifies the labels for the plot axes.
    LABEL AUTOMATIC = Sets automatically generated labels.
    LABEL CASE = Sets the case (upper/lower) for labels.
    LABEL COLOR = Sets the color for plot labels.
    LABEL DISPLACEMENT = Sets the distance from the frame to the
    LABEL FONT = Sets the plot label fonts.
    LABEL SIZE = Sets the size (height) for plot labels.
    LABEL THICKNESS = Sets the line thickness for plot labels.
Applications:
    Control labels for multiplot commands (SCATTER PLOT MATRIX, FACTOR PLOT, CONDITION PLOT).
Implementation Date:
    2000/1
Program:
    SKIP 25
    READ IRIS.DAT Y1 TO Y4 TAG
    MULTIIPLOT CORNER COORDINATES 10 10 90 90
    MULTIPLOT SCALE FACTOR 3
    SET MATRIX PLOT TYPE BIHISTOGRAM
    YLIMITS -0.6 0.6
    YLABEL DISPLACEMENT 30
    SET RELATIVE HISTOGRAM PERCENT
    X1LABEL JUSTIFICATION LEFT
    X2LABEL JUSTIFICATION LEFT
    X1LABEL OFFSET -30
    X2LABEL OFFSET -30
    MATRIX PLOT Y1 Y2 Y3 Y4

    plot generated by sample program

    Date created: 6/5/2001
    Last updated: 4/4/2003
    Please email comments on this WWW page to alan.heckert@nist.gov.