Navigation:  Menu Commands > File Menu > Open command >

DPlot File

Print this Topic Previous pageReturn to chapter overviewNext page

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

keyword

nCurves

do i = 1 to nCurves

 keyword-specific data

 LineStyle(i), SymbolStyle(i)

 Legend(i)

 CurveLabel(i)

end do

Title(1)

Title(2)

XAxisLabel

YAxisLabel

ScalingCode

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:

 Resize arrays

 

 


Page url: https://www.dplot.com/help/index.htm?dplotfile.htm