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:
DPlot v1.6
do i = 1 to nCurves
keyword-specific data
end do
Title(1)
Title(2)
XAxisLabel
YAxisLabel
LegendX, LegendY|,LegendAlignment|
Other miscellaneous identifiers
For “keyword” = “1D”, the file format is:
DPlot v1.6
1D
NumGroups
do I = 1 to NumGroups
NumPoints
do j = 1 to NumPoints
z(I,j)
end do
Label
end do
For “keyword” = “3D”, the file format is:
DPlot v1.6
3D
x_lowerlimit, y_lowerlimit, x_upperlimit, y_upperlimit
NumX, NumY
do I = 1 to NumX+1
do j = 1 to NumY+1
z(I,j)
end do
end do
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:
DPlot v1.6
3DR
NumPoints
do I = 1 to NumPoints
x(i), y(i), z(i)
end do
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.
____________________________
See also:
Page url:
https://www.dplot.com/help/index.htm?dplotfile.htm