${}$
Appendix
${}$
Section A1: The Working Environment
${}$

The Standard Interface


•

Maple's Standard Interface provides a host of easeofuse features, many requested by Maple users. It has two modes: the worksheet mode and the document mode. The document mode was designed for writing mathematical expositions as they would appear in a textbook. Its syntaxfree tools are designed to permit computing without having to master a set of Maple commands and the related syntax. Moreover, mathematical expressions are "live," and can be evaluated and updated if changes are made to other parts of the document. This functionality then lends itself to using the document mode as a scratch sheet, with interactive computations being entered and moved around the workspace with draganddrop techniques.

•

But the two modes of worksheet and document are not mutually exclusive. In the midst of a document, a section that behaves like a worksheet can be entered, and in the midst of a worksheet, a section that functions like a document can be inserted.

•

This ebook assumes the use of the Standard interface, supporting either the worksheet or document mode. It is written in document mode, with interactive calculations in document sections and commandbased calculations in worksheet sections. Our documents are written with the Marker column visible. This column of opposing triangles that delineate "document blocks," the building blocks of the document, appears to the left side of the work space, and is made visible by selecting "Markers" from the View menu. These delineating triangles are extremely useful when working interactively in Maple itself.

•

The buildingblocks of the worksheet are the "execution groups" delineated by $\[\mathbf{\>}$, a bracket and a greaterthan symbol. In those sections where we illustrate working with commands, we insert an execution group, but do not display the bracket. An execution group can be inserted by clicking on thetoolbar icon:
.

•

Examples in this ebook are presented in both a document and a worksheet mode. Maple Solutions use the document mode to illustrate syntaxfree calculations, whereas Coded Solutions use the worksheet mode to illustrate commandbased calculations.

${}$


Math Mode vs. Text Mode


•

Input to Maple can be in math or text mode, or nonexecutable math mode. The current mode is indicated in the Context Bar at the top of the workspace, and you can change modes by clicking Text, Nonexecutable Math or Math in the Context Bar. (Function key F5 is a threeway toggle between these modes.)

•

In math mode, "x^2" will appear as ${x}^{2}$, and for this reason such math is often called "2D" because it has both horizontal and vertical extension, just like handwritten notation. In text mode, math is linear and onedimensional; hence, it is often called "1D."

•

Nonexecutable math is for math that you don't want to evaluate, and it generally used in the middle of a block of text. All math is live unless you've chosen to make it nonexecutable math.

•

Either mode of entry can be used with either the document or the worksheet, as per Table A1.1.

${}$

Math

Text

Document
•

Document block: math, text, or both

•

Math is "live" or nonexecutable

•

Context Panel: Evaluate and Display Inline


$g\'\left(x\right)$
$\frac{\ⅆ}{\ⅆx}\phantom{\rule[0.0ex]{0.4em}{0.0ex}}g\left(x\right)$
$\mathrm{diff}\left(g\left(x\right)\,x\right)$

•

No text input for commands.${}$


Worksheet
•

Evaluate and Display Inline not available. Click Enter to evaluate.

•

Text region: Click "T" in the Toolbar

•

In a paragraph, math is live or nonexecutable. At an input prompt, math is live.


>

$g\prime \left(x\right)$

$\frac{{\ⅆ}}{{\ⅆ}{x}}\phantom{\rule[0.0ex]{0.4em}{0.0ex}}{g}{}\left({x}\right)$
>

$\frac{\ⅆ}{\ⅆ\phantom{\rule[0.0ex]{0.2em}{0.0ex}}x}g\left(x\right)$

$\frac{{\ⅆ}}{{\ⅆ}{x}}\phantom{\rule[0.0ex]{0.4em}{0.0ex}}{g}{}\left({x}\right)$
>

$\mathrm{diff}\left(g\left(x\right)\,x\right)$

$\frac{{\ⅆ}}{{\ⅆ}{x}}\phantom{\rule[0.0ex]{0.4em}{0.0ex}}{g}{}\left({x}\right)$

${2}{}{x}$

Table A1.1 Math vs. text mode in document and worksheet



•

Math mode in a document block places a dotted rectangle around a slightly tilted cursor. The background while editing "live" math is blue, whereas the background for nonexecutable math is gray. Natural math notation can be entered using the keyboard and/or the palettes. Math so entered is understood by the Maple engine as the mathematics for which the notation stands. Maple commands can also be typed in math mode. Such mathematical notation can appear in the midst of a textual sentence, and it can be evaluated in place. To write such a sentence, switch to text mode where the cursor will be vertical, enter text, switch back to math mode, and enter math. This math can be evaluated via Context Panel: Evaluate and Display Inline, in which case an equal sign and the evaluation will appear inline with the math.

•

Math mode entry needs no terminal punctuation, except for the colon (:) when output is to be suppressed.

•

At a worksheet prompt, entry can be in either math or text modes. In math mode, the entry will be the same as it is in the document block, except that there is no dotted rectangle around the tilted cursor, and evaluation must be by pressing the Enter key (no inline evaluation). In text mode, commands are typed linearly. Text can only be entered in text regions. A text region is created by clicking the "T" icon in the toolbar.

${}$
•

Math notation typed in math mode can be converted to text mode by

Context Panel: 2D Math≻Convert To≻1D Math Input
conversion in the opposite direction is by Context Panel: Convert To≻2D Math Input.
${}$


The Structure of This Ebook


${}$
•

The examples in this manual are presented with one or more of a Mathematical Solution, a Maple Solution, and a Coded Solution. A Mathematical Solution appears as if it were in a textbook, with no reference to software tools; a Maple Solution is a syntaxfree Maple solution; and a Coded Solution is a commandbased Maple solution. The Maple Solution is deemed "syntaxfree" because it is implemented with easeofuse tools that require no commands. Some of these solutions use such builtin tools as Assistants, Tutors, and/or task templates; some can be implemented solely from the Context Panel, as described in Table A1.2, below. Thus, nearly all the examples in this manual can be worked without having to know a single Maple command.

•

The Coded Solutions require knowledge and mastery of a suite of commands and their related syntax. This "learning curve" used to be a prerequisite for using Maple productively. But with the advent of the easeofuse features, this learning curve is significantly flattened by resorting to Maple's syntaxfree tools.

${}$${}$


Useful Features


${}$
•

The Standard interface allowed Maple to acquire a number of useful features, the more important of which are listed in Table A1.2.

${}$
Palettes

The palettes along the left and right edges of the Maple window allow the insertion of templates for many mathematical constructions. The Tab and Shift+Tab keys are used to move between the fields in the template. Palettes are arranged by selecting the Palettes option in the View menu.

The Variable Manager

The Variable Manager, implemented interactively in the Variables palette, automatically records variables to which a value has been assigned. The Context Panel for a variable in this list provides the Unassign option, the equivalent of the unassign command.

The Math Editor

Natural mathematical notation is easily entered either from the keyboard or from the palettes. In document mode, this notation is understood by the Maple engine as the math for which the notation stands. See below in the section "Getting Help in Maple" for pointers to places in the Maple Help system where keyboard shortcuts are documented.

Subscripts

•

A literal (i.e., atomic) subscript is set by first typing the underscore character twice: (Shift + minus + minus). Such a subscripted variable, an example of an atomic variable, or Atomic Identifier, is available in both math and text modes of input.

•

Atomic variables appear in black, unless the View/Atomic Variables option is selected, in which case they appear in magenta.


Atomic Identifier

•

An Atomic Identifier is a group of characters that Maple sees as a single name. Any group of characters become a name if converted to an Atomic Identifier: Select the characters, and press Ctrl + Shift + A.

•

Atomic Identifiers appear in black, unless the View/Atomic Variables option is selected, in which case they appear in magenta.

•

The general Atomic Identifier is available only in math mode.


Exponents (superscripts)

In math mode, exponents are set by first typing the caret (^) symbol: press Shift and the 6/^ key. This raises the cursor but does not display the caret. In text mode, type the caret, which will now be visible.

Context Sensitive Menus

•

When a mathematical object is in focus, the Context Panel at the right edge of the worksheet provides a menu tailored to the mathematical object, and permits many calculations by simply selecting from the menu.


Assistants

A collection of 18 interactive popup tools, including the interactive Plot Builder for interactive graphing. Available in the Tools menu (as an Assistant) or through the Context Panel.

Tutors

Some 50 interactive popups designed for pedagogical purposes, available in the Tools menu or through the Context Panel.

Task Templates

Some 350 interactive tools designed to assist implementing specific tasks. Available from the Tools menu (Tools≻Tasks≻Browse) or from the Help system.

Equation Labels

Maple outputs are automatically assigned an equation label (on the right of the screen) that stands for the item so labeled. This label can be used to reference the item by launching the Equation Label dialog via Ctrl+L (or its equivalent).

Command Completion

Accessed either from the Tools menu, or the keyboard (Esc; or Ctrl+Space, or its equivalent), a popup list of all items in Maple that start with the letters typed.

Draganddrop

Nearly all 2D math (either input/output) can be copied and pasted, the equivalent of which is selection and dragging while holding a special key. In Windows®, this key is Ctrl, so we use the phrase "Controldrag." (The other popular operating systems support the same feature.) Selection and dragging without holding the special key is the equivalent of cut/paste, an operation that is not used in this ebook.

Table A1.2 List of some useful interface features



${}$


Getting Help in Maple


${}$
•

One of the best sources of help for Maple is the builtin Maple help system itself. This is accessed from the Help menu or from the help icon in the toolbar.

•

Help on a particular item can be found directly by typing a question mark before the item and pressing the Enter key. (For example, executing the command

$\?\mathrm{worksheet,documenting,2DMathShortcutKeys}$



launches a help page containing the most extensive summary of mathmode operations and usages.) Alternatively, launch the help page for an item by placing the cursor on the item, and pressing function key F2.
•

Each help page in Maple has a set of examples at the bottom. These examples can be copied by selecting "Copy Examples" from the popup menu launched by secondary selection (rightclick with a twobutton mouse). Alternatively, if the toolbar icon that contains the letters "ws" (for "worksheet") is clicked, the help page will open as a worksheet where the examples can then be executed.

•

A particularly useful section of the help system is the Student Portal, accessed by executing ?Student Portal, or by clicking the link Student Portal. The Student Portal is designed to answer nearly 150 questions of the form "How do I…?"

•

The Help menu shows that function key F1 accesses a Quick Help popup, and Ctrl+F2, a Quick Reference page. The Help menu option "Manuals, Resources, and more" provides the options: Maple Portal, Maple Resources, Plotting Guide, Tasks, Applications and Examples, Shortcut Keys, and Manuals. The Manuals option leads further to the builtin copy of the User Manual.

•

Hence, the Maple Help system is generally the best place to obtain information on how to do something in Maple.

${}$


Final Pointers for the Novice User


${}$
Maple has been installed and launched, the Markers column is visible, the palettes have been organized, and it's time to do some Maple calculations. Here are a few additional tips for using Maple effectively.
•

First, note that by default, autosave is enabled and set to save every three minutes. This can be changed via the Tools≻Options dialog, but nothing can be more frustrating than to lose work to a computer malfunction. It's probably best to leave some form of autosave active.

•

Second, like most other software, Maple provides both a Save and a Save As option. In either case, be sure to save work often enough that important material won't be lost.

•

Third, be wary of the assignments made to variables. When too many such assignments are made, it can be confusing to continue using these names in new problems. To unassign a specific variable, select Unassign from the Context Panel for that variable in the Variables palette, or use the unassign command. Alternatively, reset nearly everything in Maple to its initial state by clicking on the restart icon (the closed loop in the toolbar) or by executing the restart command.

•

Fourth, if a Maple input is changed interactively, the effects of that change won't be cascaded down through the rest of any chain of calculations that are logically connected to that input. Something has to be done to cause such a change to ripple through the rest of the document. Select the items that need to be updated, and press the single exclamation mark in the toolbar. Of course, clicking on the triple exclamation icon in the toolbar will execute the whole document.

•

Fifth, when a document has been saved, then recalled, what's on the screen isn't what's in Maple's memory. None of the assignments in the document are known to Maple. Assignments and calculations need to be reexecuted.

•

Sixth, removing an assignment from the screen does not remove it from Maple's memory. Conversely, unassigning an assignment removes the connection in Maple's memory, but does not remove the assignment statement from the screen. So, it is possible to construct a completely unfathomable document by selectively assigning, and unassigning, deleting and inserting at any points in the document. It should be obvious to the reader that although possible, it's neither useful nor productive.

${}$

${}$${}$
<< Appendix  Introduction Table of Contents Next Section of Appendix >>
${}$${}$
© Maplesoft, a division of Waterloo Maple Inc., 2023. All rights reserved. This product is protected by copyright and distributed under licenses restricting its use, copying, distribution, and decompilation.
${}$
For more information on Maplesoft products and services, visit www.maplesoft.com
${}$
${}$
${}$
${}$
${}$
${}$
${}$
${}$
