Navigation:  »No topics above this level«

DPlot file miscellaneous identifiers

Print this Topic Return to chapter overview

Miscellaneous identifiers in a DPlot file consist of a descriptive keyword followed by associated data, if any. A description of each of the currently supported miscellaneous identifiers follows:

1000Separator

Obsolete. Use 1000Separators. Followed by a non-zero entry if a 1000 separator (character set with Control Panel) should be used. If zero, no 1000 separator will be used.

1000Separators

Followed by 4 numbers indicating whether the Control Panel-specified character should be used to separate the 1000s place in numbers on each of 4 axes. (X,Y,Z on 3D plots or X,Y,alternate X, alternate Y on XY plots).

AxesAtZero

Equivalent to checking "Axes at 0" under Options>Grid Lines or Box.

AxisLineWidth

Followed by the line width used to draw coordinate axes, in 100'th inch units.

BarChartOptions

Followed by an integer value that is a combination of:

0x00000001Filled bars
0x00000002Stacked bars
0x00000004Draw bar amplitude labels
0x00000008Draw percentage labels
0x00000010Labels drawn outside (on top of) the bars
0x00000020For unevenly spaced X values, bars extend from X to the following X. Last point is ignored other than to provide the ending X of the last bar. Ignored if more than one data set is present.
0x00000040Percentage labels (if drawn) are a percentage of this bar's amplitude relative to all data sets. If not set, percentage is for the associated data set only.
0x00000080A different color is used for each bar. The color assigned to curve #1 (with the Colors command) is used for the first bar, and in general the color assigned to curve N is used for the Nth bar. This option is ignored if the bar chart has more than one data set.
0x00000100Base of bars is at minimum Y extent. If not set, base of bars will be at Y=0.
0x00000200Don't draw black border around filled bars.
0x00000400Draw border around extremes only. In other words, if bar width and group width (see below) are both set to 1.0, there will be no vertical lines between bars. Ignored if more than one data set is present. If set, 0x0200 bit (don't draw black border) is ignored.
0x00000800Shade bars as if they are cylindrical. Ignored unless the fill style is set to solid.

BarPctLabels (Obsolete, but currently supported. BarChartOptions is preferred)

Equivalent to checking Percentage labels on the Bar Chart Options dialog and/or BarChartOptions with the 8 bit set.

BarWidth

Followed by the width (0.0-1.0) of bars in bar charts and histograms. A value of 1.0 results in bars with no intervening space.

BorderPoints

Defines the exterior edge of a surface plot for random 3D data. Followed by the number of points then the X and Y values of each point, one point per line.

Cal

Followed by the gage calibration value. Used in the title for data processing mode.

Caption

The filename of a graph will be placed near the lower right corner. Without this option the caption will not be drawn.

ColorBasis

Followed by an integer value that determines what parameter the colors in a 3D scatter plot are based on. 0=Z value, 1=data set, 2=view depth.

Colors

Obsolete. This keyword is supported by all versions of DPlot but will not be written to DPlot files. Followed by up to 16 color specifications used for XY plots, in 4-byte hexadecimal notation: 00rrggbb, where each of the color components vary from 00 to FF.

ColorsEx

Followed by the color specification for each curve of an XY plot in 4-byte hexadecimal notation: 00rrggbb, where each of the color components vary from 00 to FF. Colors will be written to the file with up to 10 colors per line. For example if a plot contains 16 colors then the first 10 colors will be written to the line immediately following ColorsEx and colors 11-16 will be written to the next line.

Contour3d

Will show the surface plot in a 3D view. Followed by the Z scale factor (see Contour3DScale), azimuth and elevation angles (in degrees).

Contour3Daxes

If followed by a non-zero integer, the 3 coordinate planes will be drawn with a 1-dot black pen on 3D contour plots.

Contour3DScale

Followed by X, Y, and Z scale factors to stretch the contour plot by. These settings have no effect on the actual data values, only on appearance.

ContourColor

Defines the color scheme for contour plots. Followed by 0 for a smooth gradation of colors ranging from magenta to red, 1 for a gray scale palette ranging from black to a very light gray, or 2 for a custom blend of 6 colors defined by contourusercolors.

ContourDrawSides

If followed by a non-zero value, black-edged white planes will be drawn from the edges of a 3D surface plot to the XY plane, obscuring the underside of the surface. This setting should not be used with an elevation angle less than 0.

ContourGrid

If followed by a non-zero integer, grid lines on contour plots are drawn with a 1-pixel black pen. If followed by 0, grid lines are not drawn.

ContourLabels

Controls labelling of contour lines on a 2D surface plot. Followed by an integer that is a combination of:

1Label lines (if not set, other bits are ignored)
2Labels are transparent. If not set, the background of labels will be opaque, possibly obscuring the underlying plot.
3Labels use black text. If not set, label text is the same color as the corresponding contour line.

ContourLegend

If followed by a non-zero integer, a legend describing contour intervals is drawn on the right side of contour plots. If followed by 0, the legend is not drawn.

ContourLegendFreq

Followed by the frequency of the labels in the legend, minus 1, of a surface plot or 3D scatter plot. 0=include every label, 1=every 2nd label, etc.

ContourLevels

Followed by the number of contour levels, the low contour value and the high contour value. Keep in mind that the interval between legend values will be different for shaded bands than for contour lines. For shaded bands the interval is (upper limit-lower limit)/(number of intervals). For contour lines the interval is (upper limit-lower limit)/(number of intervals-1).

ContourLevelsEx

Serves a similar purpose to ContourLevels, but is used when custom contour values rather than equally-spaced contours are used. Followed by the number of contour levels on the next line, then each of the contour values, one per line.

ContourMethod

Followed by:

0Contour plots are drawn using shaded bands representing ranges in elevation.
1Contour plots are drawn with contour lines representing specific elevations. If "Contour3D" is set, this setting is forced to 0.
2Waterfall plot. "Contour3D" is forced on. This setting is not valid for randomly-spaced points (only for gridded data).

ContourSymbols

Followed by the symbol type to draw at each data point in a surface plot. (Currently the actual type is ignored; if non-zero, square symbols will be drawn.)

ContourUserColors

Followed by from 1 to 16 color definitions used to construct a color palette when ContourColor=2. If the number of contour intervals is greater than the number of colors, DPlot interpolates between color values. Colors are expected to be 4 byte hexidecimal values, with the red component in the least significant byte. For example,

ContourUserColors
0000ffff,000000ff

creates a palette starting at yellow (low contour) with decreasing green values out to full red for the highest contour line/shade.

ContourXYScale (obsolete. Use Contour3Dscale)

Followed by X and Y scale factors to stretch the contour plot by. These settings have no effect on the actual data values, only on appearance.

Date

Followed by 1 to display today's date in the upper-right corner of the plot. If the following value is greater than 1, DPlot converts this number from an Excel serial number to a calendar date. In either case, if/when the plot is saved as a DPlot file the date will be updated to today's date.

Date Format

Followed by the format description for the date used when the Number Format for either X or Y is "Calendar Date". Default value is the short date format set in Control Panel (normally M/d/yy).

DataProcess

Turns on data processing mode. Followed by

Format, DataType, UseDPlotLabels

Shift1,Start1,Stop1

Shift2,Start2,Stop2

Shift3,Start3,Stop3

Shift4,Start4,Stop4

where

Formatgeneral format of the plot. 0=square, 1=wide, 2=default
DataType0= unknown or don't care
1=pressure
2=stress
3=acceleration
4=deflection
5=strain
6=temperature

UseDPlotLabels
If non-zero, axis labels are generated by DPlot automatically

ShiftnBaseline shift amount.
StartnStart time of the n'th baseline shift
StopnStop time of the n'th baseline shift

DecimalDigits

Followed by three entries, 1 each for the X, Y, and Z axes, for the number of digits that should follow the decimal point in numbers along those respective axes when scientific notation, powers of 10, or the default number format is used. If less than 0, then DPlot does not use a fixed number of digits and trailing zeroes are removed.

DP_Units

Followed by Punits, Aunits, Vunits, Dunits, Tunits, descriptors for the units of the values in the file and/or values automatically generated by DPlot.

where

PunitsPressure units code, currently inaccessible within DPlot.
0 = psi
1 = megapascals
2 = kilopascals
AunitsAcceleration units.
0 = g's
1 = feet/sec^2
2 = inches/sec^2
3 = meters/sec^2
VunitsVelocity units
0 = feet/sec
1 = inches/sec
2 = millimeters/sec
3 = centimeters/sec
4 = meters/sec
DunitsDeflection/displacement units
0 = inches
1 = feet
2 = millimeters
3 = centimeters
4 = meters
TunitsTemperature units
0 = degrees Fahrenheit
1 = degrees Celsius
2 = degrees Kelvin

DenseGrid

Turns on dense gridline option (Options>Grid Lines or Box>Dense Grid Lines)

ErrorBar

Describes error bar parameters for a single curve. Followed by:

CurveNum,Display,Type,Value1,Value2

where

CurveNum =index of the curve.
Display =how error bar is displayed (0=none, 1=above, 2=below, 3=both above and below).
Type =how magnitude of error bar is determined. (0=absolute value, 1=percentage, 2=different absolute values for above and below).
Value1 =Type-dependent parameter (absolute value, percentage, or plus value).
Value2 =Type-dependent parameter (minus value for Type=2).

ErrorBarPenWidth

Followed by pen width used to draw error bars, in 1/1000ths of an inch. Default=20.

ErrorBarWidth

Followed by the width of the horizontal part of error bar, in 1/1000ths of an inch. Default=250.

FilledBars

Causes bar charts to be drawn with solid interiors (default is hollow).

FillLabel

Legend entry for a fill area (see Fill Between Curves on the Options menu and FillRegion below). Followed by two integers in the first line and the label in the next line. Label is limited to 80 characters. The first integer should be 1 or 2; 2 is only valid if the fill is for "Fill to Y reference line" and is the label corresponding to the area below the refernce line. The second number is the fil index, 1 through the number of fill areas.

FillRegion

Paints the area between two curves with a pattern. Followed by:

Curve1, Curve2, Style, Color, Hatch |,yref, Color2|

where

Curve1 = index of first curve.

Curve2 = index of second curve.
0 = fill the area formed by closing Curve1
-1 = fill to the lower X axis
-2 = fill to the line Y=yref

Style = 0 for solid fill, 2 for a pre-defined pattern, or 3 for a user-defined pattern.

Color = Blue*65536 + Green*256 + Red, where each of Blue, Green, and Red range from 0 to 255.

Hatch = index of pre-defined patterns (ignored for Style not equal to 2)
0 = Horizontal lines
1 = Vertical lines
2 = 45 degree downward
3 = 45 degree upward
4 = Horizontal-Vertical cross-hatch
5 = 45 degree crosshatch

yref = Amplitude of the reference line used in the case of Curve2=-2.

Color2 = Color used to fill the area below the yref reference line when Curve2=-2.

If Style = 3, the next line must contain a string of 8 1-byte hexadecimal values (no separator) describing an 8x8 pixel bitmap.

Example:

FillRegion

0001 0002 0003 00000255 0000

AA55AA55AA55

Fills the area between curves 1 and 2 with a red user-defined pattern consisting of every other dot turned on.

FontColor

Followed by FontIndex, Color

where

FontIndex is the index of the font.
1 = numbers on the axes
2 = first title line
3 = second title line
4 = X axis label
5 = Y axis label
6 = legend
7 = note

Color is the color of the font in the form red*65536+green*256+blue.

Fontn

Followed by 45 comma-separated values describing FontIndex n (FontIndex described above): Height, Width, Escapement, Orientation, Weight, Italic, Underline, StrikeOut, CharSet, OutPrecision, ClipPrecision, Quality, PitchAndFamily, FaceName.

Width, Escapement, Orientation, CharSet, OutPrecision, ClipPrecision, Quality, and PitchAndFamily are ignored and reset to default values within DPlot.

Height is the font height in points.

Weight should range from 0 (don't care) to 900 (heavy).

Italic, Underline, and StrikeOut are 1 if that attribute is used; 0 otherwise.

FaceName is a string of 32 integers that are the ASCII equivalents of the font name. Unused characters are set to 0. For example, 'Arial' is

65,114,105,97,108,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0

FontFace (obsolete, but supported)

Followed by:

FontIndex

FontFace

where

FontIndex is the index of the font.
1 = numbers on the axes
2 = first title line
3 = second title line
4 = X axis label
5 = Y axis label
6 = legend
7 = note

FontFace is the name of the font to use; e.g., Times New Roman

Grain Flags

Additional formatting options for grain size distribution plots. Followed by an integer value that may be a combination of the following:

0x00000001Specify sieve size labels. If this bit is not set, bits 1 through 27 are ignored and all of the sieve sizes mentioned below will be drawn (if they will fit on the plot without overlapping and the plot extents include the given size)

Bits 1-27 specify which sieve size labels to draw, dependent on bit 0x40000000 (British sizes, see below).

bit

U.S. sizes

British sizes

0x00000002

6 inch

125 mm

0x00000004

4 inch

75 mm

0x00000008

3 inch

63 mm

0x00000010

2 inch

50 mm

0x00000020

1-1/2 inch

37.5 mm

0x00000040

1 inch

28 mm

0x00000080

3/4 inch

20 mm

0x00000100

1/2 inch

14 mm

0x00000200

3/8 inch

10 mm

0x00000400

#3

8 mm

0x00000800

#4

6.3 mm

0x00001000

#6

5 mm

0x00002000

#8

3.35 mm

0x00004000

#10

2.36 mm

0x00008000

#12

2 mm

0x00010000

#16

1.7 mm

0x00020000

#20

1.18 mm

0x00040000

#30

0.850 mm

0x00080000

#40

0.600 mm

0x00100000

#50

0.425 mm

0x00200000

#60

0.300 mm

0x00400000

#70

0.250 mm

0x00800000

#100

0.212 mm

0x01000000

#140

0.150 mm

0x02000000

#200

0.125 mm

0x04000000

#270

0.075 mm

0x08000000

#400

0.063 mm

0x10000000Draw bold vertical lines at material-type boundaries
0x20000000Use Udden-Wentworth scale rather than AASHTO scale
0x40000000Use British standard sieve sizes rather than U.S. sizes.
0x80000000X axis increases from left-to-right.

Grain FlagsEx

Specifies user-defined sieve sizes. Followed by an integer value that may be a combination of the following bits, which in turn is followed by the size, in millimeters, and text associated with each non-zero bit. This setting is ineffective unless bit 1 of the setting made with Grain Flags is set.

0x00000001Use the first user-specified sieve size.
0x00000002Use the second user-specified sieve size.
0x00000004Use the third user-specified sieve size.
0x00000008Use the fourth user-specified sieve size.

Example:

Grain FlagsEx

3

1.0

#18

0.710

#25

Specifies the use of two user-defined sieve sizes: 1 mm labeled "#18" and 0.71 mm labeled "#25".

GridColor

Followed by the color to use for grid lines, in the form red*65536+green*256+blue

GridColor2

Followed by the color to use for minor grid lines, in the form red*65536+green*256+blue

GridLinesOnTop

Followed by a single number describing the placement of grid lines on an XY plot:

0        below fill regions, curves, and reference lines

1        above fill regions

2        above fill regions and curves

3        above fill regions, curves, and reference lines

GridLineType

Followed by the line style codes to use for the major and minor grid lines (2 values). Both values should be between 1 and 7, inclusive.

GridLineWidth

Followed by the width of the line used to draw grid lines, in 1000'th inch units.

GridLineWidthThin

Followed by the width of the line used to draw minor grid lines, in 1000'th inch units.

Grid Type

Followed by the grid type to use. 0 = Axes only, 1 = Grid, 2 = Box. See Grid Lines or Box.

Hex Format
Followed by two numbers that describe the output when Hexadecimal number formatting is used: NumBytes, PrefixType

NumBytes should be 1, 2, or 4.

PrefixType = 0 for '0x', 1 for '$', or 2 for no prefix.

HideLegend

If present, the legend will not be drawn of XY plots. The legend can be made visible with the Legend/Labels menu command.

Invert Axis

For XY plots only, followed by 1 to reverse the normal direction of the X axis, 2 for the Y axis, or 3 for both the X and Y axes.

LabelBars (Obsolete, but currently supported. BarChartOptions is preferred)

Bars in bar charts will be labeled with the bar amplitude.

LabelDir

Followed by three numbers, one for each of the X, Y, and Z axes describing the orientation of numbers along those axes: 0=horizontal, 1=45 degrees, 2=vertical.

LegendLineLength

Followed by the length of the line segment to use in the legend, in inches. The default line segment length is 1/2 inch.

LineWidths

Followed by a list of line widths for each curve in the file, in hundredths of inches.

Lname

Followed by the title for the legend, which will be placed at the top of the legend. If no legend is present, "lname" may still be used to display miscellaneous text on the plot.

LogTicks

Followed by an integer that specifies the frequency of labels on logarithmic scales:

0Label integer powers of 10 only
1Label 5's as well (e.g. 0.1,0.5,1,5,10,50,...)
2Label all tick marks (as space allows)

Manual Scale

Followed by the corner coordinates (in data space) of the plot window:

xlow, ylow,xhigh,yhigh

or, for 3D data:

xlow,ylow,zlow,xhigh,yhigh,zhigh

See: Extents/Intervals /Size

Manual Size

Followed by the physical width and height of the plot, in inches.

See: Extents,Tick marks,Size

Manual Ticks

Followed by the physical width and height of the plot and the number of tick mark intervals in the X and Y directions. Obsolete. Use "Manual Size", "NumTicks", and/or "TickInterval" instead.

width, height, nXtick, nYtick

See: Extents,Tick marks,Size

Margins

Followed by the left, top, right, and bottom margins of a hard copy, in inches.

MaxLegendRows

Followed by the maximum number of strings to place in a single column of the legend.

MinorGridLines

For XY plots and linear scales only, followed by the number of minor grid intervals between each tick mark on the X and Y axes.

Multiple Axes

Followed by an option code and related data:

code

A, B if code = 1

AxisNumber(i),i=1,nplot if code = 2

where

code = 1 for a second Y axis dependent on the primary Y axis; = 2 for a second, independent Y axis.

A,B = coefficient for a 1st order polynomial that translates primary Y axis values to second Y axis values.

AxisNumber(i) = array of numbers associating curves with axes. AxisNumber(1) must be 1.

See: Multiple Y Axes

NoArrowHeads

Arrowheads will not be drawn on the axes of XY plots.

NoLegendFrame

Turns off the default feature of drawing a rectangle around the legend.

NoteV2

Obsolete. This keyword is supported by all versions of DPlot but will not be written to DPlot files.

Text notation. Followed by:

X, Y, Flags, TabStop

Note\n

Note (cont.)\n

.

.

Note(cont.)

where

X,Y are the coordinates of the upper left corner of the note, expressed as a percentage of the plot size (0.0 to 1.0) or in data coordinates, dependent on the Flags setting.

Flags is a combination of the following:

0x0002Draw a rectangle around the note.
0x0004Hide objects intersecting the note. If not set, note background is transparent.
0x0008Note is “activated” by a button.
0x0010X and Y are expressed in data space rather than the default ratios of plot size. If set, the note will remain in a fixed position relative to the plots data values when you zoom or otherwise change plot extents.

TabStops is the number of character cells used for tab positioning.

Each line of the note other than the last line should end in the sequence “\n”. DPlot replaces “\n” with a <CR><LF> sequence when reading the note. There must be at least one additional line after the last occurrence of “\n”.

NoteV3

Text notation. Followed by:

X, Y, Flags, Alignment, TabStop

Note\n

Note (cont.)\n

.

.

Note(cont.)

where

X,Y are the coordinates of the alignment point of the note, expressed as a percentage of the plot size (0.0 to 1.0) or in data coordinates, dependent on the Flags setting.

Flags is a combination of the following:

0x0002Draw a rectangle around the note.
0x0004Hide objects intersecting the note. If not set, note background is transparent.
0x0008Note is “activated” by a button.
0x0010X and Y are expressed in data space rather than the default ratios of plot size. If set, the note will remain in a fixed position relative to the plots data values when you zoom or otherwise change plot extents.

Alignment is a combination of the following:

0x0001Note is placed such that the center of the note is at X.
0x0002Note is placed such that the right extent of the note text is at X.
0x0004Note is placed such that the vertical middle of the note is at Y.
0x0008Note is placed such that the bottom extent of the note text is at Y.

TabStops is the number of character cells used for tab positioning.

Each line of the note other than the last line should end in the sequence “\n”. DPlot replaces “\n” with a <CR><LF> sequence when reading the note. There must be at least one additional line after the last occurrence of “\n”.

NoteButton

Followed by the text that appears on a button used to activate a note. By default, the button text is "Note". Obsolete. This value is only applicable to the first note defined in the file. Use NoteButtonEx.

NoteButtonEx

Followed by the 1-based index of the applicable note, with the button text on the subsequent line.

NumberFormats

Followed by the number format codes for the X and Y axis.

NumberFormatZ

Followed by the number format code for the Z axis.

NumLegendSymbols

Followed by the number of symbols to use for each legend entry for curves that use symbols at each data points. Must be 1, 2, or 3.

NumTicks

Followed by the number of tick mark intervals on the X and Y axes (and Z in the case of 3D data). Alternatively, see "TickInterval".

See: Extents,Tick marks,Size

PointSizes

Followed by:

NumFonts

Point(i),i=1,NumFonts

PolarOptions
Followed by Flags

where

Flags is a combination of the following bits:

0x00010 degrees at the top of the plot. If not set, 0 degrees is at the right side of the plot.
0x0002Clockwise angles. If not set, angles increase in the counterclockwise direction.
0x0004Force circular plots. If not set, plot may be elliptical, depending on the plot width and height.
0x0008Radial axis labels are vertical.

PtLabel

Prints a character string with an arrow directed toward a data point, XY plots only. Followed by:

CurveNum, PointNum, X, Y, Flags

Label

where

CurveNum, PointNum are the 1-based curve index and point within the curve associated with the label.

X, Y are the coordinates for the label, in plot space.

Flags consists of a series of style bits describing the appearance of the label:

0x0001Label consists of the amplitude of the data point.
0x0002Label will be opaque.
0x0004A rectangular frame will be drawn around the label.
0x0008Rotate label 90 degrees.
0x0010X and Y specify relative offsets from the labeled point, in inches.
0x0020Label is only drawn when the mouse cursor is over the labeled point.

Label is the character string, ignored if Flags & 0x0001 = 0x0001.

PtLabel3D

Prints a character string with an arrow directed toward a data point on a 3D surface plot. Followed by:

Dataset, Xpt, Ypt, Xlabel, Ylabel, Flags

Label

where

Dataset is currently unused. Set to 1.

Xpt, Ypt are the X and Y coordinates of the data point to label.

X, Y are the coordinates for the label, in plot space.

Flags consists of a series of style bits describing the appearance of the label:

0x0001Label consists of the amplitude (Z value) of the data point.
0x0002Label will be opaque.
0x0004A rectangular frame will be drawn around the label.
0x0008Rotate label 90 degrees.
0x0010X and Y specify relative offsets from the labeled point, in inches.
0x0020Label is only drawn when the mouse cursor is over the labeled point.

Label is the character string, ignored if Flags & 0x0001 = 0x0001.

Reflines

Describes up to 20 horizontal or vertical reference lines for XY plots. Followed by

NumRefLines

for i=1 to NumRefLines

Options,Style,Color,Width,Value

Legend (if Options > 1)

next i

Options1 for a horizontal line, 0 for a vertical line, plus 2 if a legend entry is included.
Styleline style code
Color((blue*256)+green)*256+red
Widthline width in thousandths of inches
ValueX or Y value of the line

SquareLogs

Forces physical distance between log cycles on the X and Y axis to be the same.

StackedBars (Obsolete, but currently supported. BarChartOptions is preferred)

Bars in bar charts for different data sets are stacked vertically rather than drawn side-by-side.

All entries prefaced by "Stat_" are applicable only to 1D statistics plots.

Stat_Box

Followed by several options defining how the box in a box-and-whisker plot is drawn:

Draw, Color, Width, BorderWidth, BorderColor

where

Draw =0 to not draw the box, 1 to draw the box
Color = Color used to draw the box, red + green*256 + blue*65536
Width =Width of the box, in 1000'th inch units

BorderWidth =
Width of the line used as a border for the box, in 1000'th inch units. Set to 0 for no border.

BorderColor =
Color used for the border line around the box, red + green*256 + blue*65536

Stat_BWOptions

Followed by options for box-and-whisker plots:

MedianOrMean, DrawWhiskers, StdDevorErr, BoxLimits, WhiskerLimits, OutlierLimits, ExtremeLimits

where

MedianOrMean =
0 for a median-based plot, 1 for a mean-based plot

DrawWhiskers =
0 if whiskers should not be drawn, 1 to draw whiskers

StdDevorErr =
0 if mean-based limits are multipliers for the group standard deviation, 1 if limits are multipliers for the group standard error (group standard deviation divided by the square root of the number of samples).

BoxLimits =
Extents of the box. For median-based plots, this value should be a percentage (0-100) of the range in amplitudes for the group. For mean-based plots, a multiplier for the group standard deviation or standard error (dependent on the StdDevorErr value).

WhiskerLimits =
Extents of the whiskers. For median-based plots, this value should be a percentage (0-100) of the range in amplitudes for the group. This value is not used for median-based plots unless the stat_whisker Option value (see below) is 0. For mean-based plots, a multiplier for the group standard deviation or standard error (dependent on the StdDevorErr value).

OutlierLimits =
Limits defining outliers (distance from mean or median). For median-based plots, a multiplier for the interquartile range (box limits). For mean-based plots, a multiplier for the group standard deviation or standard error (dependent on the StdDevorErr value).

ExtremeLimits =
Limits defining extremes  (distance from mean or median). For median-based plots, a multiplier for the interquartile range (box limits). For mean-based plots, a multiplier for the group standard deviation or standard error (dependent on the StdDevorErr value).

Stat_DotOptions

Followed by options for dot graphs:

Grouping, Symbol, Size, Color, CLimits, CStyle, CWidth, CSymbol, CSize, CColor

where

Grouping =
0 to plot individual data points scaled to their actual amplitude. Identical points are stacked. = 1 to group data points into bins, as in a histogram.

Symbol =Symbol style used for individual data points.

Note: Symbol type 389 is only available in 3D scatter plots.

Size = Height of symbol, in 1000'th inch units
Color = Color used for individual data points, red + green*256 + blue*65536
Climits =Limits of confidence limit line, expressed as a multiplier for the group standard error.
CStyle =Line style used for confidence limit line.

1=solid line

2=long dash

3=dotted

4=dash dot

5=medium dash

6=dash dot dot

CWidth =Pen width used for confidence limit line, in 1000'th inch units.
CSymbol =Symbol style to draw at the ends of the confidence limits line (see symbol codes above)
CSize =Height of CSymbol, in 1000'th inch units.
CColor =Color used for confidence limits, red + green*256 + blue*65536

Stat_DrawLegend

If followed by a non-zero integer, a legend will be drawn with 1D statistics plots. If followed by 0, the legend is not drawn.

Stat_GrandMean

Followed by:

Flags, Width

where

Flags =Combination of bits. If 1 is set, draws the grand mean/median through the mean or median of all values in all groups. If 2 is also set (Flags=3), the legend entry for the grand mean/median includes the value, as in "Grand median (56.2)".
Width =width of line, in 1000'th inch units

Stat_GroupInfo

Followed by:

Draw, Digits

where

Draw =Specifies which entries to draw in the upper left corner of each group. Combine the following settings:

1 = mean (or median for median-based box-and-whisker plots)

2 = standard deviation (IQR for median-based box-and-whisker plots)

4 = coefficient of variation (%) (ignored for median-based plots)

8 = sample size

Digits =number of significant figures to use in numbers.

Stat_LimitsAsCL

If followed by a non-zero entry, then the legend for all limits on mean-based plots will be shown as a percent confidence value rather than a multiplier for the standard error. This option has no effect if limits are a function of standard deviation (Stat_BWOptions StdDevorErr=0) rather than standard error.

Stat_MeanFormat

Followed by several options for how the mean or median is drawn on 1D statistics plots:

SymbolorLine, Style, Width, Symbol, Size, Color

where

SymbolorLine =
0 to draw the mean/median with a symbol, = 1 for a line segment

Style =line style used if SymbolorLine=1 to drawn mean/median

1=solid line

2=long dash

3=dotted

4=dash dot

5=medium dash

6=dash dot dot

Width =line width used, in 1000'th inch units
Symbol =symbol style to use if SymbolorLine=0. See symbol style codes above under Stat_DotOptions.
Size =height of symbol, in 1000'th inch units
Color =Red + Green*256 + Blue*65536, where all components range from 0 to 255.

Stat_Outliers

Followed by options for if and how outliers and extremes are drawn:

Draw, Outlier_Symbol, Outlier_Color, Extreme_Symbol, Extreme_Color

where

Draw =0 for no outliers or extremes, 1 to draw outliers, 2 to draw extremes but not outliers, 3 to draw outliers and extremes

Outlier_Symbol =
Symbol style to use for outliers. See symbol style codes above under Stat_DotOptions.

Outlier_Color =
Color used for outlier symbols, red + green*256 + blue*65536

Extreme_Symbol =
Symbol style to use for extremes (styles defined above).

Extreme_Color =
Color used for extreme symbols, red + green*256 + blue*65536

Stat_PlotType

Followed by 0 for a box-and-whisker plot, or 1 for a dot graph.

Stat_RefLine

Adds a reference line to the plot, drawn across all groups. Followed by Draw, Value, Style, Width, Color on one line, Text on the next line. Each plot may have 2 reference lines. Add a second line by using two Stat_Refline entries, each with Draw=1.

Draw =1 to draw the line, 0 if line should not be drawn.
Value =Amplitude of the line
Style =Line style to use for line
1=solid line
2=long dash
3=dotted
4=dash dot
5=medium dash
6=dash dot dot
Width =Width of pen used to draw the line, in 1000'th inch units
Color =Color of the line, red + green*256 + blue*65536
Text =Text that appears in the legend. Use "" for no legend entry.

Stat_Rotated

If followed by a non-zero integer, the plot will be rotated such that groups are oriented from top to bottom along the vertical axis, amplitudes on the horizontal axis.

Stat_Whiskers

Followed by options defining the appearance of whiskers in box-and-whisker plots:

Option,Style, Width, Color

where

Option =Used only for median-based plots
0=whisker limits are expressed as a percentage
1=whiskers are drawn between non-outliers
2=whiskers include the entire data set.
Style =Line style to use
1=solid line
2=long dash
3=dotted
4=dash dot
5=medium dash
6=dash dot dot
Width =Width of pen used to draw whiskers, in 1000'th inch units.
Color = Colors used for whiskers, red + green*256 + blue*65536

SymbolCycleColors

For XY plots, followed by the 1-based index of the curve for which symbol colors cycle through the color palette rather than using the curve color. Repeat as needed. If followed by -1, then ALL curves use this setting.

SymbolFrequency

Followed by the frequency of symbols (points per symbol). Default value is 1 (draw symbols at every data point). Applied to ALL curves.

SymbolFrequencyEx

Followed by a 1-based curve index and the symbol frequency for that curve.

SymbolOutlines

Followed by 1 to outline solid symbols in black, or 0 to draw symbols using a single color.

SymbolSizes

Followed by a list of symbol heights for each curve in the file, in thousandths of inches.

SymbolUnits

If followed by a non-zero number then symbol sizes are in Y units rather than a fixed physical size. If you zoom in on a plot with SymbolUnits set to 1, for example, then the symbols will be larger on the zoomed plot.

TickInterval

Followed by the tick mark interval on the X and Y axes (and Z in the case of 3D data). Alternatively, see "NumTicks".

See: Extents,Tick marks,Size

Time Format

Time formatting string used for Calendar Date, Date/Time, and Time number formatting. Syntax is identical to that set with Windows Control Panel.

Title3

Followed by the third title line.

TopBarLabels (Obsolete, but currently supported. BarChartOptions is preferred)

Labels for bar charts will be drawn above the bar, rather than at the top of but inside the bar.

TransparentLegend

Turns off the default feature of hiding any objects that intersect the legend.

TriangleList

Used only for 3D surface plots consisting of random 3D points. DPlot will only save this information if one or more triangles have been deleted with Delete Triangles or Delete Thin Triangles. Followed by

NumTris, NumEdges

Vertex(1,1),Vertex(2,1),Vertex(3,1)

....

....

Vertex(1,NumTris),Vertex(2,NumTris),Vertex(3,NumTris),

EdgeVert(1,1),EdgeVert(2,1),EdgeTri(1)

....

....

EdgeVert(1,NumTris),EdgeVert(2,NumTris),EdgeTri(NumTris)

where

NumTris is the number of triangles

NumEdges is the number of edge segments at the outer extremity of the surface

Vertex is the 1-based index of a 3D data point

EdgeVert is the 1-based index of a 3D data point at one end of the edge segment.

EdgeTri is the 1-based index of the triangle for this edge.

Units

For tripartite plots and grain size distribution plots, scaling options allowing the use of user-defined units: the constants used to convert input values to values associated with a particular scaling option, and the labels associated with those constants. Followed by:

A, B

LabelA

LabelB

where

A, B are multipliers used to convert the user-defined units.

LabelA, LabelB are 16-byte character strings.

B and LabelB are ignored for grain size distribution plots.

wysiwyg

Turns on “What You See Is What You Get” style if the “Specify Plot Size” option of the Extents/Intervals /Size command is used.

X2Axis

Specifies a second X axis, whose tick marks and labels will be drawn at the top of the plot. Followed by:

A, B

X2AxisLabel

where

A,B = coefficients for a 1st order polynomial that translates primary X axis values to second X axis values.

X2AxisLabel = text drawn above the axis.

Y2Axis

Followed by a second Y axis label, to be placed along the right edge of the plot. Not displayed unless the Multiple Y Axes command is in effect.

YCutoff

Followed by Ylow, Yhigh. For XY plots, points with amplitudes outside these limits are ignored.

Stop

Forces DPlot to stop processing any other information in the file. This command is useful for developers who wish to add their own information to a DPlot file. DPlot will always add the line “stop” to the end of a DPlot file that it saves.

 

 


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