SED navigation bar go to SED home page go to Dataplot home page go to NIST home page SED Home Page SED Staff SED Projects SED Products and Publications Search SED Pages
Dataplot Vol 1 Vol 2

LABEL COORDINATES

Name:
    ...LABEL COORDINATES
Type:
    Plot Control Command
Purpose:
    Specifies the positioning of labels to appear on subsequent plots.
Description:
    By default, the x coordinate of x axis labels is the mid-point of the frame coordinates. For example, the default frame coordinates are (15,20) and (85,90) which results in a default x coordinate of (15+85)/2 = 50. The y coordinate is determined by the LABEL DISPLACEMENT command. This is specified in screen units from the frame line. The default values for the X1LABEL, X2LABEL, and X3LABEL are 8, 11, 14, respectively. This means the default y coordinates are 20 - 8 = 12, 20 - 11 = 9, and 20 -14 = 6, respectively.

    By default, the y coordinate of y axis labels is the mid-point of the frame coordinates. The default y coordinate is (20+90)/2 = 55. The x coordinate is determined by the LABEL DISPLACEMENT command. This is specified in screen units from the frame line. The default values for the Y1LABEL and Y2LABEL are 8 and 8, respectively. This means the default x coordinates are 15 - 8 = 7 and 85 + 8 = 93, respectively.

    The axis labels are by default center justified to these coordinates.

    On occasion, you may want to have more control over the positioning of axis labels. This can be accomplished with the LABEL COORDINATES and LABEL JUSTIFICATION commands. The most common usages would be to left justify one of the horizontal labels from the left frame (or near the left frame) or to right justify one of the horizontal labels from the right frame (or near the right frame).

    The LABEL COORDINATES are given in 0 to 100 screen units (there is currently no provision for specifying the LABEL COORDINATES in data units). If LABEL COORDINATES are outside this range they are ignored. If LABEL COORDINATES are within this range, they will be used and any settings for LABEL DISPLACEMENT and LABEL OFFSET will be ignored. The LABEL JUSTIFICATION settings will be relative to these coordinates.

    The LABEL DISPLACEMENT and LABEL OFFSET commands give an alternative way for positioning the axis labels.

    The label coordinates hold for all subsequent plots until defaulted (via the ...LABEL COORDINATE command with no arguments) or until overridden with new label coordinates. The analyst can define coordinates for all five 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 COORDINATES <xcoor> <ycoor>
    where <xcoor> is a number or parameter that specifies the desired x coordinate in units of 0 to 100;
                <ycoor> is a number or parameter that specifies the desired y coordinate in units of 0 to 100;
    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.

    If you only want to specify the x coordinate, you can omit the <ycoor> argument. If you only want to specify the y coordinate, then enter a value for <xcoor> that is outside the 0 to 100 interval (e.g., use -1).

Examples:
    X1LABEL COORDINATES 15 14
    X1LABEL COORDINATES XCOOR YCOOR
    X1LABEL COORDINATES 15
    X1LABEL COORDINATES -1 6
    Y1LABEL COORDINATES 2 55
Note:
    A ...LABEL COORDINATES command with no arguments will use the default positioning. Thus X1LABEL COORDINATES with no arguments reverts the first horizontal axis label to default. A ...LABEL COORDINATES command with no prefix refers to all 5 labels. Thus LABEL COORDINATES restores the default positioning for all 5 labels.
Default:
    Label positions are based on the FRAME CORNER COORDINATES and the LABEL DISPLACEMENT settings
Synonyms:
    None
Related Commands: Applications:
    Presentation Graphics
Implementation Date:
    2018/10
Program:
     
    label case asis
    .
    x1label coordinates 20 13
    x2label coordinates 50 10
    x3label coordinates 80  7
    y1label coordinates  2 55
    y2label coordinates 90 55
    .
    x1label just lebo
    x2label just cebo
    x3label just ribo
    .
    x1label Label 1
    x2label Label 2
    x3label Label 3
    y1label Left Y Axis
    y2label Right Y Axis
    .
    plot x**2 for x = 1 1 9
        
    plot generated by sample program

Privacy Policy/Security Notice
Disclaimer | FOIA

NIST is an agency of the U.S. Commerce Department.

Date created: 10/31/2018
Last updated: 10/31/2018

Please email comments on this WWW page to alan.heckert@nist.gov.