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

DEVICE 3 NAME COUNTER

Name:
    DEVICE 3 NAME COUNTER (SET)
Type:
    Set Subcommand
Purpose:
    Specify whether device 3 output will generate each plot into a separate file.
Description:
    Dataplot uses device 3 to maintain a copy of the most recent plot only (the default file name is "dppl2f.dat") in Postscript format. Dataplot automatically handles the opening and closing of device 3. The PP command uses the device 3 output to print the most recent plot from within a Dataplot session.

    The SET DEVICE 3 NAME COUNTER command can be used to add a counter to the base file name each time the plot file is opened. That is, each plot will be saved in a different file name.

    The counter is added to the name before the extension (i.e., the period in the file name). For the default name, the files will be called

      dppl2f_1.dat
      dppl2f_2.dat
      ....

    You can use the SET IPL2NA command to specify the base file name. This is demonstrated in the Program example below.

Syntax:
    SET DEVICE 3 NAME COUNTER <ON/OFF>

    If you specify OFF (the default), the plot file will be overwritten each time a new plot is generated. If you specify ON, a counter value will be added to the plot file name so that each plot will be saved in a different file.

Examples:
    SET DEVICE 3 NAME COUNTER ON
    SET DEVICE 3 NAME COUNTER OFF
Default:
    OFF
Synonyms:
    None
Related Commands:
    DEVICE = Open or close a graphics device.
    DEVICE 3 = Specifies whether device 3 output will be controlled by Dataplot or by the user.
    PP = Print the most recent graph.
    SET DEVICE 2 SPLIT = Split the device 2 graphics output into separate files.
Applications:
    Graphics Output
Implementation Date:
    2015/12
Program:
    . Step 0:   Define output devices
    .
    .           The following commands will generate the
    .           plot files "plot_1.ps", "plot_2.ps", "plot_3.ps",
    .           "plot_4.ps".
    .
    set device 3 name counter on
    set ipl2na plot.ps
    device 3 close
    .
    . Step 1:   Plot control features
    .
    label case asis
    title case asis
    title automatic
    y1label Y Axis
    x1label X Axis
    character X
    line blank
    .
    . Step 2:   Generate several plots
    .
    plot x    for x = 1 1 9
    plot x**2 for x = 1 1 9
    plot x**3 for x = 1 1 9
    plot x**4 for x = 1 1 9
    .
    device 3 close
        

Privacy Policy/Security Notice
Disclaimer | FOIA

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

Date created: 02/29/2016
Last updated: 02/29/2016

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