Navigation:  Menu Commands > Text Menu > Text Placeholders    You can use placeholder codes in a plot's title lines, axis labels, legend, and notations that will be replaced with the corresponding numeric or text values when the plot is drawn. Codes that are replaced with numbers may also be used in equations with the Y=f(X) and similar commands, as well as in equations within macro/DDE commands. Many codes may be specific to a particular data set or curve, or to the entire plot. All codes are preceded by a dollar sign (\$). Placeholder codes and the result of their use is shown below.

 Code Replaced with \$AREA Area under a curve for XY plots. Calculated using the trapezoidal rule: For 3D and 4D surface plots, \$AREA reports the total surface area. \$FILETITLE Text appearing in the window caption of the document, normally the filename of the document if it has been saved. \$LENGTH Dimensionless length of a curve (XY plots only). \$MEAN Average amplitude. For 2D data, the average Y value. For 3D data, the average Z value. \$NEDGE Number of exterior edges (3D plots only) \$NC 1-based curve index. This shortcut is generally only useful when used in the legend or with the Operate on X or Operate on Y commands on the Edit menu. For example, with Operate on Y, Y=Y+\$NC will add 1 to all Y values in the first curve, 2 to all Y values in the second curve, etc. \$NPTS Number of data points \$NTRI Number of triangles (randomly-spaced 3D points only) \$RMS Root-Mean-Square (RMS) of the data amplitudes (Y values for 1D and 2D plots, Z values for 3D data). The RMS is defined by: \$SUMX Sum of the X values for a curve. (XY plots only) \$SUMY Sum of the Y values for a curve. (XY plots only). Barring overflow errors, should be equal to \$MEAN * \$NPTS for a given curve. \$STDEV Standard deviation in the data amplitudes. For 2D data, standard deviation in the Y values. For 3D data, the standard deviation in the Z values. Standard deviation is defined by For MS Excel users, this returns the same value as Excel's STDEVA function. \$X(i,j) X value of the j'th point of the i'th curve. Only meaningful for XY plots. For example, \$X(3,12) will be replaced with the X value of the 12th point from the 3rd curve. \$XMIN Minimum X value. Ignored for box-and-whisker plots and dot graphs. \$XMAX Maximum X value. Ignored for box-and-whisker plots and dot graphs \$XRANGE Maximum X value minus the minimum X value. \$Y(i,j) Y value of the j'th point of the i'th curve. Only meaningful for XY plots. For example, \$Y(3,12) will be replaced with the Y value of the 12th point from the 3rd curve. \$YMIN Minimum Y value. \$YMAX Maximum Y value. \$XYMIN XY plots only. The X coordinate where the minimum Y value occurs. \$XYMAX XY plots only. The X coordinate where the maximum Y value occurs. \$YRANGE Maximum Y value minus the minimum Y value. \$YFIRST Y value of the first point in a curve (XY plots only). \$YLAST Y value of the last point in a curve (XY plots only). 3D/4D plots only: \$ZMIN Minimum Z value. \$ZMAX Maximum Z value. \$ZRANGE Maximum Z value minus the minimum Z value. \$VZMIN Minimum visible Z value after zooming or setting extents with Extents/Intervals/Size \$VZMAX Maximum visible Z value after zooming or setting extents. \$VZAVG Average Z value after zooming or setting extents. \$VXMIN Minimum X value after zooming or setting extents. \$VXMAX Maximum X value after zooming or setting extents. \$VYMIN Minimum Y value after zooming or setting extents. \$VYMAX Maximum Y value after zooming or setting extents. \$=() Result of evaluating . For example, “\$=(sqrt(5))” will be replaced with “2.23607”. Note that the equation must be enclosed by parentheses. Other text shortcuts that are replaced by a number (i.e. any shortcut other than \$FILETITLE) may be used in an equation, as in “\$=(\$STDEV(1)/\$MEAN(1))”. For trigonometric functions, the argument is always assumed to be in degrees. This differs a bit from Y=f(X) and other commands that allow a choice between degrees and radians. For more information on equation syntax, operators, and supported functions see the description of the Y=f(X) command.

Placeholder text IS case-sensitive, e.g. \$Xmax will be ignored.

Many of the placeholders may include a numeric argument specifying which data set the placeholder refers to. That numeric argument must be enclosed with parentheses. A 0 argument means that the value for the entire plot (rather than a specific data set) should be used. If the data set argument is omitted, then a context-sensitive decision is made by DPlot about whether the placeholder refers to a specific data set or to the entire plot. For example,

\$YMAX when used in a title line or notation will be replaced with the maximum Y value for all data sets. If used in a legend entry, then it will be replaced with the maximum Y value of the data set (curve) associated with that legend entry. To use the maximum Y value for all data sets in a legend entry, then, you must use \$YMAX(0) rather than \$YMAX.

\$YMAX(5) will always be replaced with the maximum Y value from the 5th data set, regardless of where this placeholder is used.

Area (\$AREA), mean (\$MEAN) and standard deviation (\$STDEV) values for aggregate multiple data sets are never calculated. If you use a 0 argument for these values then the placeholder will be replaced with the area, mean or standard deviation for the first data set.

Range

For the \$AREA (2D only), \$MEAN (2D only), \$YMIN, \$YMAX, \$ZMIN, and \$ZMAX placeholders you may include a range of X (or X and Y for \$ZMIN, \$ZMAX) within which to find those values.

\$AREA(<curve number>,<xlo>,<xhi>) returns the area under curve number <curve number> that lies between <xlo> < X < <xhi>.

\$MEAN(<curve number>,<xlo>,<xhi>) returns the average amplitude for curve number <curve number> that lies between <xlo> < X < <xhi>. This applies to 2D data only.

\$YMIN(<curve number>,<xlo>,<xhi>) returns the minimum Y value for curve number <curve number> that lies between <xlo> < X < <xhi>.
Example: \$YMIN(2,1.6,3.5) will be replaced with the minimum Y value between 1.6 < X < 3.5 in the 2nd curve. If no points lie between those extents, the replacement text is "!none found".

\$YMAX(<curve number>,<xlo>,<xhi>) returns the maximum Y value for curve number <curve number> that lies between <xlo> < X < <xhi>.

\$ZMIN(<data set>,<xlo>,<ylo>,<xhi>,<yhi>) returns the minimum Z value that lies within the bounds <xlo>,<ylo> to <xhi>,<yhi>.

\$ZMAX(<data set>,<xlo>,<ylo>,<xhi>,<yhi>) returns the maximum Z value that lies within the bounds <xlo>,<ylo> to <xhi>,<yhi>.

In the context of specifying a range, \$YMIN and \$YMAX are valid only for XY plots. \$ZMIN and \$ZMAX are valid only for 3D surface plots and scatter plots. In all cases, the <curve number>/<data set> must be specified. For 3D surface plots this value should always be 1. For XY plots, if <curve number> is set to 0 then the check is against all curves. Similarly, for 3D scatter plots if <data set> is set to 0 then the check is for all data sets.

The range values must be specified using numbers only, not equations and/or other text placeholders.

Please note: Whether because of your default Windows international settings or your personal preference, if you use a comma as a decimal separator then in the placeholder descriptions above that use 2 or more indices, those values should be separated by a semicolon rather than a comma. For example \$X(1,1) should be \$X(1;1). (If you use a comma as a decimal point then \$X(1,1) will be interpreted as \$X(1.1), which makes no sense to DPlot.) This is true for menu commands, macros, AND commands sent from another program via dplotlib.dll.