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

ROW LABEL

Name:
    ROWLABEL (LET)
Type:
    Subcommand under LET
Purpose:
    Converts previously read character data to row labels.
Description:
    The command READ ROW LABELS can be used to read the row labels from a file. Alternatively, Dataplot can 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 (Syntax 1) is used to convert one of the previosuly read character variables to a row label.

    You can also copy a string to a specific row (Syntax 2 or Syntax 3).

    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 1:
    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.

Syntax 2:
    LET ROWLABEL = STRING TO ROW LABEL <irow> <s>
    where <s> is a previously defined string;
    and <irow> is a parameter that identifies which row to set.

    This syntax is used to set a specific row of the row labels to a previously defined string.

Syntax 3:
    LET ROWLABEL <ival> = <string>
    where <string> is a literal string;
    and <ival> is a parameter which specifies the row number.

    This syntax copies <string> into the <ival>th row of the row labels.

Syntax 4:
    LET ROWLABEL DELETE

    This syntax re-initializes all row labels to blank.

Syntax 5:
    LET ROWLABEL = SHIFT LEFT <ival>
    where <ival> is a parameter.

    This syntax shifts all row labels left (= down) by <ival> rows. Vacated row labels will be set to blank.

Syntax 6:
    LET ROWLABEL = SHIFT RIGHT <ival>
    where <ival> is a parameter.

    This syntax shifts all row labels right (= up) by <ival> rows. Vacated row labels will be set to blank.

Examples:
    SET CONVERT CHARACTER ON
    READ TEST.DAT Y X IX
    LET IG = ROW 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
    2012/08: Support for Syntax 2 - Syntax 6 added.
Program 1:
     
    let rowlabel 1 = 100101
    let rowlabel 2 = 100102
    let rowlabel 3 = 100103
    let rowlabel 4 = 100104
    let rowlabel 5 = 100105
    let rowlabel 6 = 100106
    let rowlabel 7 = 100107
    let rowlabel 8 = 100108
    let rowlabel 9 = 100109
    let rowlabel 10 = 100110
    .
    tic mark offset units screen
    tic mark offset 5 5
    character rowlabel
    plot x**2 for x = 1 1 10
        
    plot generated by sample program
Program 2:
     
    skip 25
    read antibody.dat lab  ymean  ysd  nrep
    .
    title case asis
    label case asis
    x1label Mean
    y1label Standard Deviation
    .
    xlimits 0.8  2.4
    major xtic mark number 9
    minor xtic mark number 1
    ylimits 0    1.6
    major ytic mark number 9
    minor ytic mark number 1
    .
    system rm dpzchf.dat
    let rowlabel = lab
    character blank all
    character blank blank blank rowlabel
    line blank all
    line solid dash dotted
    .
    title Highlight/Summary Form of Homoscedasticity Plot with Contour Linescr() ...
    for ANTIBODY.DAT
    set homo plot circle technique on
    summary homoscedasticity plot ymean ysd nrep
        
    plot generated by sample program

Privacy Policy/Security Notice
Disclaimer | FOIA

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

Date created: 02/03/2004
Last updated: 11/04/2015

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