A standard DPlot file is an ASCII text file containing all of the information DPlot needs to fully reproduce a finished plot. DPlot will also produce compressed DPlot files which contain the same information below but are compressed (and not human-readable) by the ZLIB algorithm.
The first line in the file contains a header that informs DPlot of the file version. The second line contains a keyword that describes what follows. The general form of a DPlot file follows:
do i = 1 to nCurves
Other miscellaneous identifiers
For “keyword” = “1D”, the file format is:
do I = 1 to NumGroups
do j = 1 to NumPoints
For “keyword” = “3D”, the file format is:
x_lowerlimit, y_lowerlimit, x_upperlimit, y_upperlimit
do I = 1 to NumX+1
do j = 1 to NumY+1
followed by Title(1), Title(2), etc. NumX and NumY are the number of grid intervals in the X and Y directions. The total number of Z values is then (NumX+1)*(NumY+1). Z values may be on the same or separate lines.
For “keyword” = “3DR” the file format is:
do I = 1 to NumPoints
x(i), y(i), z(i)
followed by Title(1), Title(2), etc.
If the maximum number of curves (set with Resize arrays) is less than the number of curves specified in the file, DPlot will automatically adjust the size of the X and Y arrays so that: 1) the maximum number of curves is equal to the number of curves specified in the file; and 2) the maximum number of points is greater than or equal to the maximum number of points for any one curve. This feature may require DPlot to read the file several times before finding the minimum array sizes.
The file header is a recent addition to the DPlot file format that assists DPlot in immediately identifying a file. Older DPlot files will continue to work with DPlot.