Equation Labels - Maple Help

Using Equation Labels

 Equation labeling allows you to reference Maple output in math or text areas of your worksheet. The label is associated with the last output within an execution group and with all of the input in the execution group. (See Join Execution Groups).

Features

 • Each label is unique, whereas a name may be inadvertently assigned more than once for different purposes.
 • Output values are labeled sequentially. If you remove or insert an output, Maple automatically renumbers all equation labels and updates the equation label references.
 • If you change the equation label format, Maple automatically updates all equation labels and equation label references.
 • You cannot apply equation labels to the following:
 – Images, plots, sketches, and spreadsheets
 – Error, warning, and information messages

Preparing to Use Equation Labels

By default, equation labels are displayed. If equation labels are not displayed, verify the following:

 • From the Tools menu, select Options. In the Options dialog, click the Display tab. Ensure the Show Equation Labels feature is selected.
 • From the Format menu, select Equation Labels. Ensure that Worksheet is selected.

Applying Equation Labels

 See the following example.

 1 Enter an expression and press Enter. Note that the equation label is displayed to the right of the answer in the worksheet.
 2 In a new execution group, enter another expression that will reference the output of the previous execution group. Place the cursor where you want to insert the equation label.
 3 From the Insert menu, select Label. The Insert Label dialog is displayed. Enter the label number and click OK. Alternatively, do one of the following:
 – Double-click on the equation label (in the far right side of the output).
 – Use the shortcut keys Ctrl+L (Command+L, for Mac).
 4 The label is displayed in the current cursor position in the expression. Press Enter to obtain the result.
 • You can insert an equation label into a paragraph using the same method.

Converting to Label Reference

 In 1-D math, you can also apply an equation label by typing the number of the desired equation label and using the Convert To Label Reference feature.
 1. Type the desired label number in parentheses. For example, (1).
 2. Select this expression, and from the Format menu, select Convert To>Label Reference.
 Note: Simply typing (1) will not be understood to be a label reference. You must follow the steps described here or above to apply an equation label.

Select Label Format

 Label formatting is useful when execution groups are placed in subsections.
 • From the Format menu, select Equation Labels, then Label Display. In the Format Labels dialog, select a Label Numbering Scheme. (Optional) Enter a label numbering prefix.

Display Label Reference

 You can switch between the label name and its reference content, as shown below.
 • Place the cursor immediately before or after a label reference, then from the Format menu, select Equation Labels, and then Label Reference.

Saving a Worksheet with Equation Labels

 You can set equation labels to be visible or hidden in an execution group, a selected area, or the entire worksheet.
 • The Format>Equation Labels>Execution Group menu item controls equation label display in an execution group.
 • The Format>Equation Labels>Selection menu item controls equation label display in a selected region.
 A selected region may contain displayed and invisible equation labels. By using the Selection menu item (toggle switch), all equation labels in the region will be set to the toggled setting of the first equation label in the region.
 • The Format>Equation Labels>Worksheet menu item controls equation label display in a worksheet.
 When you save a worksheet, the settings are also saved.
 The Display Equation Labels check box in the Options dialog controls equation label display in the entire Maple session or environment. It does not control what areas of the worksheet display equation labels.

Notes

 1 When referring to a mutable structure, such as a module, table, object, Vector, or Matrix, be aware that you will get the current value of that structure, rather than the value of the structure at the time it was printed.
 2 References to Matrix and Vector objects may be lost after a restart. This means that the commands to generate the objects must be re-executed before the Matrix browser is available for inspecting the contents of a large Matrix.
 3 Due to the different way in which these objects are stored and modified inside Maple, label references should be avoided when referring to modules, procedures, tables, and arrays (but not the recommended Array data structure). Assign names to these objects instead.

Returning a Sequence or a Range of Labeled Values

 Use the Insert Label dialog to return a sequence or range of labeled values.
 To return a sequence of labeled values, enter the labels as a comma-separated sequence in the Insert Label dialog.

 To return a range of labeled values, enter the labels as a range (denoted by two dots) in the Insert Label dialog.