Dataplot Vol 1 Vol 2

# IPL1NA

Name:
IPL1NA (SET)
Type:
Set Subcommand
Purpose:
Define the name of the plot file created by the DEVICE 2 command.
Description:
By default, Dataplot names the plot file created by the DEVICE 2 command "dppl1f.dat". This is the name used regardless of the type of device.

There are times when it is convenient to use a different name for the plot file. For example, if you are creating multiplot plots and you would like each of these to go into a separate file (i.e., there will be a sequence of DEVICE 2 ... and DEVICE 2 CLOSE commands). Other reasons are to identify the type of output file (e.g., you want a ".ps" extension for Postscript files) or you want to save the file with a unique name for subsequent use after the Dataplot session.

To set the name of the plot file, do the following

SET IPL1NA <file-name>
DEVICE 2 POSTSCRIPT

Note that the SET IPL1NA command must come before the DEVICE 2 command since the plot file is opened when the DEVICE 2 command is entered.

Syntax:
SET IPL1NA <string>
where <string> contains the desired name for the plot file.
Examples:
SET IPL1NA PLOT.PS
SET IPL1NA PLOT1.JPG
Note:
File names have the following restrictions:

1. The file name should be a valid file name for the local operating system.

2. Most Dataplot commands that utilize a file name expect that the file name should contain a period "." in the file name itself or as a trailing character. However, this is not required by the SET IPL1NA command.

3. If the file name contains spaces or hyphens, then it needs to be enclosed in quotes.

4. File names are currently limited to 80 characters. This can in particular be a problem if the file name is contained within a long path name.

You can use the CD command to make the path where the file is stored the current directory. This is most useful for data files. For example,

pwd
cd <path where plot file will be saved>
set ipl1na plot.ps
device 2 postscript
cd ^CURDIR

The pwd command is used to save the current directory. The cd command is then used to set the current directory to the path where the data resides, the read is performed, and then the cd command is used to restore the original working directory (the cd command saves the current path in the string CURDIR).

Note:
File names are case sensitive on Unix/Linux/Mac OS X systems. For these systems, the case of the file name will be as it is entered on the SET IPL1NA command.

As a further caution for Unix/Linux hosts, certain expansion characters (specifically ~ to refer to your home directory) are interpreted by the shell and are not recognized by the Fortran compiler. These expansion characters are interpreted as literal characters and do not yield the intended file name.

Default:
The default name is dppl1f.dat.
Synonyms:
None
Related Commands:
 SET FILE SWITCHES = Probe the values for certain file names and the associated unit numbers and file status. DEVICE = Specify a graphics device. SET IPL2NA = Specify the file name for the DEVICE 3 output.
Applications:
Plotting
Implementation Date:
Pre-1987
Program:

SET IPL1NA plot1.ps
DEVICE 2 POSTSCRIPT
PLOT X**2 FOR X = 1 1 9
DEVICE 2 CLOSE
.
SET IPL1NA plot2.ps
DEVICE 2 POSTSCRIPT
PLOT X**3 FOR X = 1 1 9
DEVICE 2 CLOSE


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

Date created: 05/09/2016
Last updated: 05/09/2016