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

READ MISSING VALUE (SET)

Name:
    READ MISSING VALUE (SET)
Type:
    Subcommand under SET
Purpose:
    Specifies the value to be used when a missing value is encountered with the array form of the COLUMN LIMITS command.
Description:
    The January, 2004 version of Dataplot added support for an array form of the COLUMN LIMITS command. This form is used to specify the lower and upper columns to read for each data field. One specific case this was intended to handle was data files containing columns of unequal length. This is a common occurence when Excel files are saved to ASCII data files.

    When the array form of the COLUMN LIMITS comamnd is used, an empty field is interpreted as a missing value. By default, Dataplot will assign a value of zero. If you want to assign a value other than zero, use the SET READ MISSING VALUE command to specify that value.

Syntax:
    SET READ MISSING VALUE <value>
    where <value> denotes the value to assign when an empty data field is encoutered.
Examples:
    SET READ MISSING VALUE -999
    SET READ MISSING VALUE 0
    SET READ MISSING VALUE -1
Note:
    This command only applies when the array form of the COLUMN LIMITS command has been invoked. Otherwise, if the number of values read is less than the number of variables specified on the READ command, Dataplot treats this as an error.
Default:
    Zero
Synonyms:
    None
Related Commands:
    READ = Carries out a column-wise input of data.
    COLUMN LIMITS = Specify what columns to read.
Applications:
    Input/Output
Implementation Date:
    2004/1
Program:
     
    SET READ MISSING VALUE -99
    LET LOWLIM = DATA  1 11
    LET UPPLIM = DATA 10 20
    COLUMN LIMITS LOWLIM UPPLIM
    READ DUMMY.DAT  Y X
    PLOT Y X   SUBSET Y > -99 SUBSET X > -99
        

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.