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

ROW LABEL

Name:
    ROWLABEL (LET)
Type:
    Subcommand under LET
Purpose:
    Converts previously read character data to row labels.
Description:
    Dataplot can now read character data using the

      SET CONVERT CHARACTER ON

    command. This command stores the character fields in the file "dpchzf.dat".

    The two primary uses of character data are:

    1. Provide a row identifier for the data.

    2. Define a group (or factor) variable. For example, we can identify sex by coding males as M and females as F.

    The ROWLABEL command is used to convert one of the previosuly read character variables to a row label.

    Once a row label has been defined, you can use the

      CHARACTER ROWLABEL

    command to label plot points. Additional uses for row labels are anticipated in future releases of Dataplot.

Syntax:
    LET ROWLABEL = <ix>
    where <ix> specifies the name of the character variable in the file dpzchf.dat.

    The character variable is originally created with a READ command where the SET CONVERT CHARACTER ON was entered prior to the READ.

Examples:
    SET CONVERT CHARACTER ON
    READ TEST.DAT Y X IX
    LET IG = GROUP LABEL IX
Note:
    Row labels can be up to 24 characters long.
Note:
    Row labels can also be defined using the READ ROW LABELS command.
Default:
    None
Synonyms:
    None
Related Commands:
    READ = Carries out a column-wise input of data.
    CONVERT CHARACTER = Specify how Dataplot will handle character data.
    CHARACTER CODE = Converts character data to a coded numeric variable.
    GROUP LABELS = Define row labels from character data.
Applications:
    Input/Output
Implementation Date:
    2004/1
Program:
     
    set convert character on
    skip 25
    read draft69c.dat rank day month
    .
    let rowlabel = month
    character  rowlabel
    let xcode = character code month
    .
    xlimits 1 12
    xtic offset 1 1
    .
    plot rank xcode
        
    plot generated by sample program

Date created: 2/3/2004
Last updated: 2/3/2004
Please email comments on this WWW page to alan.heckert@nist.gov.