Notes

Annotate plots using notes.

Notes are text boxes placed in the HyperGraph window for labeling points, describing trends, and relating additional curve information.

To edit a note, right-click on the note's border and select Edit to display the Entity Editor.


Figure 1. Entity Editor - Notes

Entity Editor Options

From the Entity Editor, update the note's properties.

Standard

Name
The name of the note.
Visibility
Displays the note in the plot window. Deactivate to hide the note.
Text
The note text or Templex expression in the note.
Format Scalar Values
Select this option to format scalar values in a note using the Fixed or Scientific format. The format type can be selected from the Format drop-down menu.
Format
Select Scientific or Fixed Format from the drop-down menu.
Precision
Both fixed decimal format and scientific notation display numbers to the right of the decimal point. The accuracy of each format can be adjusted by entering a value in the Precision text field.
Attach To
Select where the note will be attached. Options include Window, View, Curve, and Coordinates.
When Curve is selected as the Attach To method, alternate options are displayed under Standard:
  • Attachment Curve - displays the name of the curve that the note is attached to.
  • Attachment Point - the point value or location of the note's attachment point on the curve.
When Coordinates is selected as the Attach To method:
  • Attachment X Coordinate - the x coordinate value for the note's attachment point.
  • Attachment Y Coordinate - the y coordinate value for the note's attachment point.
Note Placement
Select an option to position your note in a specific location within the modeling window. The note retains its position when zooming in and out. Options include:
  • default
  • Left-Top corner
  • Left-Bottom corner
  • Right-Top corner
  • Right-Bottom corner
  • User defined. Use the X Coordinate and Y Coordinate fields to enter specific coordinates for the note's placement in the modeling window.
Options
See Mouse Over Notes for more information on the features in the Options section.

Display

Font Settings
Click in this field to display the Font Selector dialog. From there, you can change the font type, style, and size.
Alignment
Text can be left aligned, right aligned, or centered in a note box by selecting the corresponding drop-down menu item. Text alignment is updated automatically.
Border Thickness
Determines the line thickness of the note's border. Select one of four line thickness styles from the drop-down menu to change the border.
Curve Color
This option is displayed when a note is attached to a curve.
By default, note text is black. Select a note from the browser and activate Curve Color to make the note text the same color as the curve’s color. When you select Curve Color, the Border Color option disappears and the border around the note becomes yellow. If you change the Line Color of the curve while Curve Color is selected, the note color changes as well.
Border Color
Click the color palette to edit the note's border color.
Auto Position
Auto Position Strategy
See Note Positioning for more information on this feature.

Templex Statements in Notes

Notes can contain Templex statements as well as math and string functions and operators. Notes can be complete Templex templates. Templex enables you to include text from an external file, call external functions, assign variables, and perform math operations within a note.

Note: See Templex Reference for complete descriptions of the Templex statements and for more information on writing Templex templates.
Note: See Math Reference for more information on math and string functions and operators.

From the Notes micro dialog, click Select Macro to select a Templex variable that can be included in a note. For example, if a note contains the variables {X}, {Y}, and {Slope}, the X and Y values, as well as the slope of the curve at the attachment point, are displayed in the note. As the note’s attachment point changes, the Templex variables update automatically.

X
Displays the X value of the attachment point.
Y
Displays the Y value of the attachment point.
Time
Displays the time value of the attachment point.
Slope
Displays the slope (first derivative) of the curve at the attachment point.
Curv
Displays the curvature (second derivative) of the curve at the attachment point.

Other Templex variables that can be included in a note are:

{x.note}
{y.note}
{t.note}
These can be applied if you are reading a curve from an external file, such as an ABF file or an external reader. Within the external file, there can be a particular request to which a note is assigned, or a note may be included to improve the understanding of the curve numbers, for example. The note is preserved in and accessed from the x, y, or t data vector when reading the curve from the external file.
{x.filename}
{y.filename}
{t.filename}
Displays the filename from which the data vector was derived. If the data vector is a math vector, no filename is displayed in the note.
{index}
Displays the index of the curve at the attachment point.
{p1.title}
If a note is attached to a curve, use this Templex expression to access the the page title.
{p1w1.plotheader}
If a note is attached to a curve, use this Templex expression to access the window's header.

Vector data can be referenced in a note calculation using either of the following statements:

c#.vector
Where:
# is the number of a specific curve in the curve list of that plot.
vector (.x, .y, or .t) specifies either the X, Y, or Time vector for the specified curve.
For example, c1.x refers to the X vector of the first curve in the list. c#.vector can be used in notes attached to windows, views, and curves.
c@.vector
Where:
@ references the curve to which the note is attached.
vector (.x, .y, or .t) specifies either the X, Y, or Time vector for the curve to which the note is attached.
For example, c@.x refers to the X vector of the curve to which the note is attached. c@.vector can only be used in notes attached to curves.
{p1.title}
If a note is attached to a curve, use this Templex expression to access the current page's title.
Note: When using c#, # denotes the position of the curve as it appears in the curve list in the Define panel; it is not related to the curve label.

Attach To

The Attach To tab allows you to specify how a note is displayed in the window.

Notes can be anchored one of four ways, which are described below. Once attached, notes can be positioned anywhere in the window. When a curve is either cut or copied, notes attached to the curve are also cut or copied. Notes can also be attached to curves using the Templex statements, attach_note_at and attach_note_to.



Figure 2.
Window
The note remains stationary when the plot is repositioned in the window.
View
The note moves with the plot when the plot is repositioned in the window.
Curve
A leader connects the note to a specific point on the curve and the note moves with the plot when the plot is repositioned in the window. This is not available for bar charts.
Coordinates
A leader connects the note to a specific point on the plot. This is not available for bar charts.