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

VARIABLE LABEL

Name:
    Variable Label
Type:
    Support Command
Purpose:
    Define long labels associated with variable names.
Description:
    Variable names are limited to 8 characters in DATAPLOT. Variable labels allow longer, more descriptive names. The variable label can have up to 52 characters and may include spaces.

    Currently, variable labels can be used in the following ways in DATAPLOT:

    1. The multi-plotting commands (SCATTER PLOT MATRIX, FACTOR PLOT, and CONDITION PLOT) automatically make use of variable labels.

    2. You can use the "^" to substitute a variable label for a variable name in text strings. For example,
        LET Y = NORMAL RAND NUMBERS FOR I = 1 1 100
        VARIABLE LABEL Y NORMAL RANDOM NUMBERS
        Y1LABEL ^Y
        PLOT Y

      Previously, DATAPLOT only supported substitutions for parameters and strings. Now, if a variable name is found, it checks to see if a label has been defined. If yes, the label is substituted for the variable name. If not, the variable label is left as is (with the "^" removed).

    3. The X1LABEL AUTOMATIC and Y1LABEL AUTOMATIC commands will now substitute the variabe label for the variable name on the x and y axes respectively. Note that Y1LABEL AUTOMATIC and X1LABEL AUTOMATIC only apply to the PLOT command.
Syntax:
    VARIABLE LABEL <var name> <text>
    where <var name> is the variable having a label defined;
    and <text> defines the variable label and contains all the from <var name> until the end of the command line (the variable label will be truncated after 52 characters).

    Note that the variable specified in <var name> must already exist.

Examples:
    LET Y = NORMAL RANDOM NUMBERS FOR I = 1 1 100
    VARIABLE LABEL Y NORMAL RANDOM NUMERS
    Y1LABEL ^Y
    PLOT Y
Note:
    The variable labels may have up to 52 characters.
Default:
    All variable labels are blank.
Synonyms:
    None
Related Commands: Applications:
    Presentation Graphics
Implementation Date:
    2000/01
Program:
    LET Y = NORMAL RANDOM NUMBERS FOR I = 1 1 100
    VARIABLE LABEL Y NORMAL RANDOM NUMERS
    Y1LABEL ^Y
    PLOT Y

    plot generated by sample program

Privacy Policy/Security Notice
Disclaimer | FOIA

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

Date created: 6/5/2001
Last updated: 10/29/2015

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