DifferentialGeometry
Preferences
Calling Sequence
Parameters
Description
Details
Preferences(keyword)
Preferences(keyword, value)
keyword
-
a string, the name of the particular preference
value
the value to be assigned to the preference
This command allows the user to control various display conventions used by the DifferentialGeometry package; to specify the LaTeX formatting of DifferentialGeometry objects such as vectors, differential forms and tensors; and to specify how commonly used Maple commands are used internally by DifferentialGeometry procedures.
The following are the admissible keywords strings:
DisplayFrameDefinitions
ErrorInfoLevel
ErrorPrintLength
HistoryDepth
JetNotation
Keywords
PrettyPrint
PromptLength
SafeMode
Show
ShowFramePrompt
TensorDisplay
TeXBiformList
TeXFormList
TeXLineBreak
TeXPrintOrder
TeXVectorList
WedgeDisplay
dsolve
nullspace
pdsolve
rref
simplification
solve
The paragraphs below describes the use of each of these keywords.
This command is part of the DifferentialGeometry package, and so can be used in the form Preferences(...) only after executing the command with(DifferentialGeometry). It can always be used in the long form DifferentialGeometry:-Preferences.
"DisplayFrameDefinitions"
This preference controls what information is displayed when the command DGsetup is executed. When this preference is false, no display is displayed. When this preference is true, the names of the coordinate variables and the labels for the frame vectors and coframe 1-forms are displayed. The default preference is false.
with(DifferentialGeometry):
Preferences("DisplayFrameDefinitions");
false
DGsetup([x, y, z], E3);
frame name: E3
Preferences("DisplayFrameDefinitions", true);
The following coordinates have been protected:
x,y,z
The following vector fields have been defined and protected:
_DG⁡vector,E3,,1,1,_DG⁡vector,E3,,2,1,_DG⁡vector,E3,,3,1
The following differential 1-forms have been defined and protected:
_DG⁡form,E3,1,1,1,_DG⁡form,E3,1,2,1,_DG⁡form,E3,1,3,1
"ErrorInfoLevel"
This preference controls the amount of information provided by an error message from a DifferentialGeometry command. The default for ErrorInfoLevel is 1.
"ErrorPrintLength"
For many of the error messages returned by the DifferentialGeometry commands, it is not necessary to display all the component information of the vectors, differential forms, and tensors provided as input. By suppressing the component information, the error messages are generally much easier to read. The ErrorPrintLength preference controls the number of components which will be displayed -- the first k components will be displayed if the sum of their lengths does not exceed the integer specified by the ErrorPrintLength preference. The length of each component is calculated using the Maple length command. The default value for this preference is 0 so that no component information is displayed. To display all component information, set this preference to infinity.
"HistoryDepth"
The Tools command CalculationHistory will store the results of certain critical intermediate computations which the user may wish to view. The HistoryDepth preference specifies the number of such computations to store. The default value for this preference is 10.
To illustrate this preference, we create a small procedure called Test and store some values calculated by this program using the CalculationHistory command.
Test := proc(n) local i; for i to n do Tools:-CalculationHistory:-Update("Test", [i, i^2]) od; n^2 end:
Run the program Test.
Test(25);
625
Retrieve the calculated values.
Tools:-CalculationHistory:-Get("Test");
25,625,24,576,23,529,22,484,21,441,20,400,19,361,18,324,17,289,16,256
Change the HistoryDepth preference to 3.
Preferences("HistoryDepth", 3);
10
Rerun the program Test and retrieve the calculated values. This time only 3 values are stored.
25,625,24,576,23,529
"JetNotation"
In the mathematical literature, there are two standard index notations for representing derivatives of a function. For example, if u = u(x, y) then we have:
JetNotation1: u[1] = u_x, u[2] = u_y, u[1, 1] = u_xx, u[1, 2] = u_xy, u[2, 2] = u_yy, u[1, 1, 1] = u_xxx, u[1, 1, 2] = u_xxy, u[1, 2, 2] = u_xyy, u[2, 2, 2] = u_yyy.
JetNotation2: u[1, 0] = u_x, u[0, 1] = u_y, u[2, 0] = u_xx, u[1, 1] = u_xy, u[0, 2] = u_yy, u[3, 0] = u_xxx, u[2, 1] = u_xxy, u[1, 2] = u_xyy, u[0, 3] = u_yyy.
The JetNotation preference determines which notation is used by the DifferentialGeometry package (and the JetCalculus subpackage). The default is JetNotation1.
Preferences("JetNotation");
JetNotation1
DGsetup([x,y], [u], Jet, 3, verbose);
x,y,u,u1,u2,u1,1,u1,2,u2,2,u1,1,1,u1,1,2,u1,2,2,u2,2,2
_DG⁡vector,Jet,,1,1,_DG⁡vector,Jet,,2,1,_DG⁡vector,Jet,,3,1,_DG⁡vector,Jet,,4,1,_DG⁡vector,Jet,,5,1,_DG⁡vector,Jet,,6,1,_DG⁡vector,Jet,,7,1,_DG⁡vector,Jet,,8,1,_DG⁡vector,Jet,,9,1,_DG⁡vector,Jet,,10,1,_DG⁡vector,Jet,,11,1,_DG⁡vector,Jet,,12,1
_DG⁡form,Jet,1,1,1,_DG⁡form,Jet,1,2,1,_DG⁡form,Jet,1,3,1,_DG⁡form,Jet,1,4,1,_DG⁡form,Jet,1,5,1,_DG⁡form,Jet,1,6,1,_DG⁡form,Jet,1,7,1,_DG⁡form,Jet,1,8,1,_DG⁡form,Jet,1,9,1,_DG⁡form,Jet,1,10,1,_DG⁡form,Jet,1,11,1,_DG⁡form,Jet,1,12,1
The following type [1,0] biforms have been defined and protected::
_DG⁡biform,Jet,1,0,1,1,_DG⁡biform,Jet,1,0,2,1
The following type [0,1] biforms (contact 1-forms) have been defined and protected::
_DG⁡biform,Jet,0,1,3,1,_DG⁡biform,Jet,0,1,4,1,_DG⁡biform,Jet,0,1,5,1,_DG⁡biform,Jet,0,1,6,1,_DG⁡biform,Jet,0,1,7,1,_DG⁡biform,Jet,0,1,8,1,_DG⁡biform,Jet,0,1,9,1,_DG⁡biform,Jet,0,1,10,1,_DG⁡biform,Jet,0,1,11,1,_DG⁡biform,Jet,0,1,12,1
frame name: Jet
Preferences("JetNotation", "JetNotation2");
DGsetup([x, y], [u], Jet, 3, verbose);