Label Points command (Text menu) JR   Viewer

Adds a label to a specific data point. For XY plots and 2D views of 3D data you may also add individual labels to points by clicking the Edit Mode button on the toolbar.

Edit Mode button:

XY plots

To label a point near a specific X (or angle for polar plots) value (as opposed to scrolling through the points with the Point # horizontal scrollbar), enter the desired value under Jump to: and click on the Go button. Alternatively, to automatically select the point with the highest or lowest amplitude, click on the Ymax or Ymin buttons (Rmax or Rmin for polar plots). Note that these controls are only used to assist you in selecting the point to label; if the coordinates of the labeled point are later changed or if you perform some operation that shifts the minimum or maximum amplitudes, the label is still applied to the point selected in this dialog.

To embed the amplitude of a data point in a label, type \$Y in the Label field. To embed the abscissa of a data point in a label, type \$X. When the label is drawn the corresponding numeric values will be substituted for these control codes. For example, a label of "\$X sec, \$Y psi" at the point (5.5,100) will appear as "5.5 sec, 100 psi". For bubble plots and vector plots, \$Z will be replaced with the bubble/vector magnitude. For all other XY plot types, \$Z is replaced with "0".

In addition, you can embed placeholder codes for certain data parameters (minima, maxima, standard deviation, etc.) in point labels that will be replaced with the corresponding numeric values when the plot is drawn. You can also present the results of equations within the text. For more information on placeholder codes see the Text Placeholders topic.

The \$X, \$Y, and \$Z codes will use the same number formatting as the corresponding axis. You can restrict the number of decimal places shown in the label by using the ROUND function in an equation. For example, if the Y value of the referenced point is 2.3462567 and the label text is "Y=\$=(ROUND(\$Y,2)), the label will be drawn as "Y=2.35".

NOTE: You can quickly add a "\$X, \$Y" label to any point without bringing up this dialog box by right-clicking near the point and selecting "Add \$X, \$Y Label" from the drop-down menu.

1D plots (box-and-whisker plots, dot graphs)

Identical to the options for XY plots, except that the "Jump to X" entries are meaningless and therefore disabled.

3D surface plots

To automatically select the point with the highest or lowest amplitude (Z value), click on the Zmax or Zmin buttons. Note that these controls are only used to assist you in selecting the point to label; if the coordinates of the labeled point are later changed or if you perform some operation that shifts the minimum or maximum amplitudes, the label is still applied to the point selected in this dialog.

As with XY plots, the control codes \$X, \$Y, and \$Z will be replaced with the corresponding X, Y, and/or Z components of the labeled point.

Point labels are not drawn on 3D views of surface plots, only on 2D views.

NOTE: For all data types, if \$X, \$Y, or \$Z are not immediately followed by a space, as in "Y=\$Y kg" vs. "Y=\$Ykg", you should use a backslash character following the \$X, \$Y, \$Z, as in "Y=\$Y\kg". Otherwise the resulting label will not have the desired appearance. The backslash character following \$X, \$Y, or \$Z in the context of point labels has a special meaning: the following characters are irrelevant in interpreting the label text.

A label may include line breaks so that the text spans multiple lines. To break a string into 2 or more lines, embed a "\n" sequence in the string (for C programmers, that is the actual characters \n, not a linefeed character).

If mouse-activated is checked, the label will only be drawn when you move the mouse cursor over the data point referenced by the label. The label will not be shown in printed plots or saved images.

To use only the amplitude of the data point as the label, check the "Use Amplitude Only" box.

To move a label, point to the label and drag to the desired location. You may also specify the label location as either an offset in physical units (inches=", centimeters=cm, millimeters=mm, points=pt) or give an absolute location in data space coordinates.

In addition to this menu command, you may edit a label by pointing to the label and double clicking the left mouse button, or by right-clicking on the label and selecting "Edit" from the dropdown menu.

The font used in point labels is the same as that used for the numbers along the axes, and may be changed with the Fonts command on the Text menu.

Related macro commands

DeleteLabel

TextPointLabel

TextPointLabel3D