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

SAVE PLOT

Name:
    SAVE PLOT
Type:
    Support Command
Purpose:
    Save the current plot for later recall via the REPEAT PLOT command.
Description:
    The SAVE PLOT and REPEAT PLOT commands allow you to save and recall graphs. The primary use of this is to compare the current graph to previously created graphs.

    This command is host dependent. It is currently supported for the following platforms:

    1. Unix platforms via the X11 device driver;
    2. Windows 95/98/NT command line version built with the Microsoft Fortran compiler;
    3. Dataplot GUI (both Unix and Windows 95/98/NT).
Syntax 1:
    SAVE PLOT <file>
    where <file> is the name of a file in which the current graph will be saved.

    This syntax saves the current plot in the specified file. If the file name is omitted, the plot is saved in the file "pixmap.<n> where <n> is a counter. The counter starts at 1 for each new Dataplot session.

Syntax 2:
    SAVE PLOT <file> AUTOMATIC
    where <file> is the name of a file in which the current graph will be saved.

    This syntax saves all subsequent plots in the specified file. The current plot is not saved, only plots subsequent to when the SAVE PLOT command is entered.

    A counter is added to the file name, that is, if the file name specified was SCATPLOT, then the saved graphs are in SCATPLOT.1, SCATPLOT.2, etc. If the file name is omitted, the plot is saved in the file "pixmap.<n> where <n> is the counter.

    The counter starts at 1 for each new Dataplot session.

Examples:
    READ FILE.DAT Y1 Y2 Y3
    HISTOGRAM Y1
    SAVE PLOT HIST.1
    HISTOGRAM Y2
    SAVE PLOT HIST.2
    HISTOGRAM Y3
    SAVE PLOT HIST.3
Default:
    The default file name is "pixmap.<n> where <n> is a counter (reset to 1 for each new Dataplot session).
Synonyms:
    SAVE GRAPH, SP, and SG are all synonyms for SAVE PLOT.
Note:
    The saved plots are essentially screen dumps. There is currently no "linking" in the sense that if a given variable is changed the saved plots are automatically updated.
Note:
    As a technical note for the X11 implementation, the plots are saved in X11 "bitmap" format. This is distinct from the X11 image format that is used by xwd to save a screen image. This choice was made for performance reasons (xlib provides direct routines for reading and writing bitmaps, but not for reading and writing images). The primary limitations are:

    1. Color is not supported for X11 bitmaps. Elements drawn in color will not be saved in the bitmap.
    2. You cannot use the X11 tools xwd and xwud to view the saved plots independently of Dataplot. However, they can be viewed by any software the reads X11 bitmaps.
Note:
    Be aware that for SAVE GRAPH AUTOMATIC the saving for a given plot is not executed until the next screen erase (typically the next plot) is encountered to allow for multi-plotting and the addition of diagrammatic graphics to a plot.
Note:
    The REPEAT PLOT command is used to display a plot saved with SAVE PLOT. The LIST PLOT command lists the currently saved plots (by sequence number, file name, and title). The CYCLE PLOT command allows you to cycle through the pixmaps in the current list by clicking mouse buttons. The PIXMAP TITLE command allows you to specify the title for a saved plot. This title is simply for ease of identification in listing the saved plots and is not saved as part of the plot.
Related Commands: Applications:
    Interactive Usage
Implementation Date:
    7/1997
Program:
    READ BERGER1.DAT Y X
    FIT Y X
    4-PLOT RES
    SAVE PLOT RES.1
    QUADRATIC FIT Y X
    4-PLOT RES
    SAVE PLOT RES.2
    REPEAT PLOT RES.1
    REPEAT PLOT RES.2

Privacy Policy/Security Notice
Disclaimer | FOIA

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

Date created: 6/5/2001
Last updated: 10/13/2015
Please email comments on this WWW page to alan.heckert@nist.gov.