Define

Create and edit curves.

From the Line Chart ribbon, click the Define tool.
Figure 1.


Figure 2. Define Curves


From the dialog, you can access the Expression Builder.

If *AutoDefaultCurves() is turned on in the preference file and a curve is added to a plot with existing curves, the new curve is a copy of the most recently added existing curve. If *AutoDefaultCurves() is turned off, the new curve is empty.

Note: The curve name is defined by a Templex expression instead of a fixed string. The Templex expression is visible in editable fields only. In non-editable fields, the evaluated expression is displayed. In most cases, the evaluated expression should match the text that was hard-coded in previous versions.

Please see Dynamic Curve Names for more information on this topic.

Curve List

The Curve list displays the names of the curves in the current window.

To change the attributes of a curve, it must first be selected either from the curve list or picked from the window. Attributes can be assigned to more than one curve at a time by selecting multiple curves from the list or holding down the Control key while picking curves from the window. Attributes are applied only to selected curves. Selected curves are highlighted in the list.

Curve List Controls

The curve list displays the names of all the curves in the active window.

Curves can be renamed, added, cut, copied, and pasted using the curve list controls.

Individual curves can be turned on or off. To turn a curve off, select the curve from the list or pick the curve from the window and deactivate the check box next to the curve name above the curve list. To turn a curve on that was turned off, activate the check box.

The Cut, Copy, Paste, and Add buttons are used to maintain the curve list for the active window. Curves can be copied and pasted into other windows. Curves can also be added and deleted from the list.

Create and Define Curves

To edit a curve, it must first be selected either from the curve list or picked from the window.

The X and Y vectors are displayed at the top of the dialog. The data sources for these vectors are displayed in the text fields. Click the radio button for a vector or click in the corresponding text box to select that vector for editing. You can perform math on curves prior to plotting your data with the support of U and V vectors. U, V, W, Q, and T vectors are optional. From the dialog, use Options to access them.

Figure 3.


New data can be selected from a source file, mathematically defined using the program's Expression Builder, or entered as values. The options change depending on which source is selected.

Constructing Curves

Expressions are constructed in the text fields next to the X and Y radio buttons, and are built with the in-app Expression Builder. As the expression is built, each operator, function, and number is displayed in the text field. An expression may contain basic math functions such as addition, subtraction, multiplication, and division, as well as trigonometric and signal-processing functions. Expressions can also reference other vectors.

See Math Reference for a detailed description of each function and its purpose.

Referencing Curves

Expressions can reference any curve or vector in the current session.

Curve vector references can be defined by picking the curve with the mouse or by using the following syntax:

pmwnco.vector

where:

pm is the number of the page on which the curve resides.

wn is the number of the window which contains the curve.

co is the number of the curve in the window.

vector indicates the X, Y, or time vector of the referenced curve.

For example, p2w1c3.y references the Y vector (.y) of the third curve (c3), in first window (w1), on the second page (p2).

When a referenced curve is edited or updated, the curves that reference that curve are updated as well.

Complex Plot Curves

Complex Plot curves are referenced with additional syntax.
Phase Values
To indicate that a curve references phase values, phase curves have the letter p at the end. For example, pmwnco.vectorp.
Magnitude Values
To indicate that a curve references magnitude values, magnitude curves have the letter m at the end. For example, pmwnco.vectorm.
Real Curves
Real curves that reference real values have the letter r at the end, pmwnco.vectorr.
Imaginary Curves
Imaginary curves that reference imaginary values have the letter i at the end, pmwnco.vectori.