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

CHARACTER UNITS

Name:
    CHARACTER UNITS
Type:
    Plot Control Command
Purpose:
    Specifies whether the x and y coordinate positions for plot characters are in units of the current plot or in screeen units (0 to 100).
Description:
    By default, when a plot is generated the coordinates for the plot characters are assumed to be in units of the current plot (referred to as data units).

    There may be occassions where it is useful to have the coordinates specify screen units (i.e., 0 to 100). This is most likely when the plot character is being used in a labeling context. For example, it can sometimes be more efficient from a performance context to use the CHARACTER command rather than using a series of MOVE and TEXT commands to generate the labels.

    The CHARACTER UNITS command can be used to specify whether data units or screen units will be used. Specifically,

      DD - data units will be used for both the x and y coordinates
      DS - data units will be used for the x coordinate and screen units will be used for the y coordinate
      SD - screen units will be used for the x coordinate and data units will be used for the y coordinate
      SS - screen units will be used for both the x and y coordinates
Syntax:
    CHARACTER UNITS <val> <val> <val> ...
    where <val> specifies the desired units.

    Up to 100 character unit values can be specified.

Examples:
    CHARACTER UNITS SD DS
    CHARACTER UNITS SD ALL
Note:
    This command was motivated by the desire to improve the performance of DEXODP.DP of the macros for the 10-step analysis of 2-level full and fractional factorial designs. However, it can have utility outside of that application.
Note:
    Characters are specified by trace. All characters belonging to the same trace are plotted using the same character units.
Note:
    The BAR, SPIKE, CHARACTER, and LINE switch all work independently of each other. That is, a plot point can be a line, a character, a spike or a bar or any combination of the above.
Note:
    The CHARACTER UNITS command with no arguments sets the character units to default for all traces. The CHARACTER UNITS command with the word ALL before or after the specified unit assigns that unit to the characters on all traces; thus CHARACTER UNIT SS ALL or CHARACTER UNIT ALL SS specifies screen units for both the x and y coordinates on all traces.
Default:
    DD for all character traces
Synonyms:
    None
Related Commands: Applications:
    Presentaion Graphics
Implementation Date:
    2018/02
Program:
     
    . Step 1:   Read the data
    .
    dimension 200 columns
    skip 25
    read scott_8_16.dat y x1 to x8
    skip 0
    let n = size y
    .
    . Step 2:   Set plot control features
    .
    case asis
    title case asis
    label case asis
    tic mark label case asis
    .
    xlimits 1 n
    major x1tic mark number n
    minor x1tic mark number 0
    x1tic mark offset 0.5 0.5
    x1tic mark labels off
    .
    ylimits -0.75 1
    major y1tic mark number 8
    y1tic mark label decimal 2
    .
    title Ordered Dex Plot
    .
    line blank
    character circle
    character hw 1 0.75 all
    character fill on
    .
    . Step 3:   Generate the plot
    .
    set dex pareto plot order ascending
    set dex ordered plot identification on
    dex ordered plot y x1 to x8
    .
    . Step 4:   Plot the "-" and "+"
    .
    read dpst1f.dat zx zfact zcode
    let zcode = code zcode
    .
    line blank blank
    character - +
    character size 1.5 all
    .
    let zfacts = zfact
    let zfacts = 16   subset zfact = 1
    let zfacts = 14.5 subset zfact = 2
    let zfacts = 13   subset zfact = 3
    let zfacts = 11.5 subset zfact = 4
    let zfacts = 10   subset zfact = 5
    let zfacts =  8.5 subset zfact = 6
    let zfacts =  7   subset zfact = 7
    let zfacts =  5.5 subset zfact = 8
    .
    tic marks off
    tic mark labels off
    label
    title
    pre-erase off
    .
    character units ds all
    plot zfacts zx zcode
        
     
        plot generated by sample program
        

Privacy Policy/Security Notice
Disclaimer | FOIA

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

Date created: 04/05/2018
Last updated: 04/05/2018

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