FromJet - Maple Help
For the best experience, we recommend viewing online help using Google Chrome or Microsoft Edge.

Online Help

All Products    Maple    MapleSim


PDEtools

  

ToJet

  

rewrites in jet notation a given mathematical expression

  

FromJet

  

rewrites in function notation a mathematical expression written in jet notation

 

Calling Sequence

Parameters

Description

Examples

Calling Sequence

ToJet(expr, DepVars, jetnotation = ..., ...)

FromJet(expr, DepVars, differentiationnotation = ...)

Parameters

expr

-

algebraic expression or equation

DepVars

-

function or list of functions indicating the dependent variables of the problem

differentiationnotation = ...

-

(optional) can be diff (default), D; specifies the derivative notation to use

jetnotation = ...

-

(optional) can be jetnumbers, jetvariables (default), jetvariableswithbrackets or jetODE; specifies the jet notation to use

quiet = ...

-

(optional) can be true (default for FromJet) or false (default for ToJet); to avoid displaying information regarding the enumeration representing independent variables

Description

• 

The ToJet and FromJet commands rewrite back and forth mathematical expressions using jet and function notation respectively. ToJet is also used to rewrite an expression already in jet notation using a different jet notation.

• 

Given a set of m smooth functions Ym depending on n independent variables Xn, the associated "jet space" prolonged to order k is the Euclidean space you construct taking each of these n independent and m dependent variables, as well as the partial derivatives of the Ym with respect to the Xn up to order k, all as independent variables in equal footing. Recalling, a function of n variables has n+kk partial derivatives of order k, including order 0. Thus, the dimension of the kth prolongation of the jet space is n+mn+kk.

• 

The four alternative jet notations handled by ToJet and FromJet and understood by all the symmetry commands of PDEtools  are: jetvariables (also used in DifferentialAlgebra), jetvariableswithbrackets (also used in DifferentialAlgebra and the deprecated diffalg), jetnumbers (also used in the Maple D differentiation operator) and jetODE (also used in DEtools[Lie]). You transform from one notation to the other one using ToJet with the option jetnotation = ... or the synonym notation = ..., as shown in the Examples section.

• 

The default jet notation used by ToJet is jetvariables, which is frequently used in textbooks and easier to read than the other notations. The table relating function <-> jetvariables notation can be summarized around an example - say the function ux&comma;t, as follows:

function notation

jetvariables notation

ux&comma;t

=  u

xux&comma;t

=  ux

2xtux&comma;t

=  ux,t

...

...

  

Both the DifferentialAlgebra and its preceding deprecated diffalg packages also use a similar notation, jetvariableswithbrackets, with only one difference: ux&comma;t=u, so with brackets [] after the name of the dependent variable only when representing the derivative of order zero. To have these brackets in the output of ToJet use the option jetnotation = jetvariableswithbrackets.

• 

An alternative jet notation, frequently used for programming purposes, is the jetnumbers notation, that follows the conventions used by the Maple D differentiation operator. The equivalence between function and jetnumbers notation is thus as follows:

function notation

jet notation

ux&comma;t

=  u

xux&comma;t

=  u1

2xtux&comma;t

=  u1,2

...

...

  

When the dependent variables involved have different dependencies, the enumeration used to represent the independent variables is displayed on the screen (see first example in the Examples section). To avoid the display of this information use the quiet option.

• 

Finally, the jetODE notation can be used when there is only one dependent variable of only one independent variable, as for instance ux. The table relating function <-> jetODE notation is

function notation

jetODE notation

ux

=  u

&DifferentialD;&DifferentialD;xux

=  _y1

&DifferentialD;2&DifferentialD;x2ux

=  _y2

...

...

  

Note the use of _y to prefix the representation of derivatives regardless of whether the unknown (in this example, ux) has the name y.

• 

By default FromJet returns the derivatives found in expr expressed using diff; to make it return using the D notation specify the optional argument differentiationnotation = D.

• 

To avoid having to remember the optional keywords, if you type the keyword misspelled, or just a portion of it, a matching against the correct keywords is performed, and when there is only one match, the input is automatically corrected.

Examples

withPDEtools&comma;D_Dx&comma;declare&comma;ToJet&comma;FromJet

D_Dx&comma;declare&comma;ToJet&comma;FromJet

(1)

DepVarsux&comma;t&comma;vt&comma;wy

DepVarsux&comma;t&comma;vt&comma;wy

(2)

PDEdiffux&comma;tvtwy&comma;x+diffux&comma;tvtwy&comma;t&comma;y

PDExux&comma;tvtwy+tux&comma;tvt&DifferentialD;&DifferentialD;ywy+ux&comma;t&DifferentialD;&DifferentialD;tvt&DifferentialD;&DifferentialD;ywy

(3)

The following is PDE in jetvariables notation

jetPDEToJetPDE&comma;DepVars

jetPDEuvtwy+vwux+vutwy

(4)

Compare with the jetnumbers notation, and because the DepVars involve different dependencies, the enumeration representing independent variables is also displayed

jetnumbersPDEToJetPDE&comma;DepVars&comma;notation=jetnumbers

jet notation: [1 = x, 2 = t, 3 = y]

________________________________

jetnumbersPDEuv2w3+u1vw+u2vw3

(5)

To avoid displaying information regarding the enumeration for the independent variables include the keyword quiet.

In all cases, to convert back, use FromJet

FromJetjetnumbersPDE&comma;DepVars

xux&comma;tvtwy+tux&comma;tvt&DifferentialD;&DifferentialD;ywy+ux&comma;t&DifferentialD;&DifferentialD;tvt&DifferentialD;&DifferentialD;ywy

(6)

To have the output in D notation use the optional argument differentiationnotation = D

FromJetjetPDE&comma;DepVars&comma;differentiationnotation=D

D1ux&comma;tvtwy+D2ux&comma;tvtDwy+ux&comma;tDvtDwy

(7)

One of the features of expressions written in jet notation is that you can compute partial derivatives of them with respect to functions and derivatives in the natural way you differentiate in Maple - because in jet notation functions and derivatives are represented by objects of type name. However, because in jet notation the dependency of the functions is not explicit, to compute total derivatives you need to use the total differentiation command D_Dx of PDEtools. For example, the total derivative of jetnumbersPDE with respect to t is given by diff(PDE, t) or, in the jet notation of jetnumbersPDE, by

D_DxjetnumbersPDE&comma;t&comma;DepVars

uv2,2w3+u1v2w+2u2v2w3+u1,2vw+u2,2vw3

(8)

FromJet&comma;DepVars

2txux&comma;tvtwy+xux&comma;t&DifferentialD;&DifferentialD;tvtwy+2t2ux&comma;tvt&DifferentialD;&DifferentialD;ywy+2tux&comma;t&DifferentialD;&DifferentialD;tvt&DifferentialD;&DifferentialD;ywy+ux&comma;t&DifferentialD;2&DifferentialD;t2vt&DifferentialD;&DifferentialD;ywy

(9)

diffPDE&comma;t

0

(10)

Note that the D_Dx command is context sensitive: it returns using the jet notation found in the input, so if instead of jetnumbersPDE you pass jetPDE written using jetvariables, instead of (4.8) you get

D_DxjetPDE&comma;t&comma;DepVars

uvt,twy+vwux,t+vut,twy+wuxvt+2utvtwy

(11)

FromJet can also be used to rewrite expressions involving the ODE jet notation of DEtools[Lie]

JetODE_y2=fx&comma;y&comma;_y1

JetODE_y2=fx&comma;y&comma;_y1

(12)

D_DxJetODE&comma;x&comma;yx

_y3=xfx&comma;y&comma;_y1+yfx&comma;y&comma;_y1_y1+_y1fx&comma;y&comma;_y1_y2

(13)

FromJetJetODE&comma;yx

&DifferentialD;2&DifferentialD;x2yx=fx&comma;yx&comma;&DifferentialD;&DifferentialD;xyx

(14)

ToJet&comma;yx

yx,x=fx&comma;y&comma;yx

(15)

To have this output expressed using jetODE or jetvariableswithbrackets notation use the optional argument notation = ...

ToJet&comma;yx&comma;notation=jetODE

_y2=fx&comma;y&comma;_y1

(16)

ToJet&comma;yx&comma;notation=jetvariableswithbrackets

yx,x=fx&comma;y&comma;yx

(17)

Note also the conversion directly from ODE jet notation to PDE jet notation:

ToJetJetODE&comma;yx

yx,x=fx&comma;y&comma;yx

(18)

Both ToJet and FromJet automatically rewrite any jet notation found in the input into the target notation. Consider this input where the functions are yx and ux&comma;t and various notations appear mixed:

ee_y2_y1+uy+yxux&comma;t+u1yx+uxut

ee_y2_y1+uy+yxux&comma;t+u1yx+uxut

(19)

DepVarsyx&comma;ux&comma;t

DepVarsyx&comma;ux&comma;t

(20)

ToJetee&comma;DepVars

uy+uyx+yux+uxut+yx,xyx

(21)

FromJetee&comma;DepVars

&DifferentialD;2&DifferentialD;x2yx&DifferentialD;&DifferentialD;xyx+ux&comma;tyx+&DifferentialD;&DifferentialD;xyxux&comma;t+xux&comma;tyx+xux&comma;ttux&comma;t

(22)

See Also

D_Dx

declare

DEtools[Lie]

DifferentialAlgebra

PDEtools