You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/systems/diffeqs/basic_transformations.jl
+14-14Lines changed: 14 additions & 14 deletions
Original file line number
Diff line number
Diff line change
@@ -60,30 +60,30 @@ This or other additional equations can also be specified through `eqs`.
60
60
The transformation is well-defined when the mapping between the new and old independent variables are one-to-one.
61
61
This is satisfied if one is a strictly increasing function of the other (e.g. ``du(t)/dt > 0`` or ``du(t)/dt < 0``).
62
62
63
-
Keyword arguments
64
-
=================
65
-
If `dummies`, derivatives of the new independent variable with respect to the old one are expressed through dummy equations; otherwise they are explicitly inserted into the equations.
66
-
If `simplify`, these dummy expressions are simplified and often give a tidier transformation.
67
-
If `fold`, internal substitutions will evaluate numerical expressions.
63
+
# Keyword arguments
64
+
65
+
- `dummies`: Whether derivatives of the new independent variable with respect to the old one are expressed through dummy equations or explicitly inserted into the equations.
66
+
- `simplify`: Whether expanded derivative expressions are simplified. This can give a tidier transformation.
67
+
- `fold`: Whether internal substitutions will evaluate numerical expressions.
68
68
Additional keyword arguments `kwargs...` are forwarded to the constructor that rebuilds `sys`.
69
69
70
-
Usage before structural simplification
71
-
======================================
70
+
# Usage before structural simplification
71
+
72
72
The variable change must take place before structural simplification.
73
73
Subsequently, consider passing `allow_symbolic = true` to `structural_simplify(sys)` to reduce the number of unknowns, with the understanding that the transformation is well-defined.
74
74
75
-
Usage with non-autonomous systems
76
-
=================================
77
-
If `sys` is autonomous (i.e. ``t`` appears explicitly in its equations), it is often desirable to also pass an algebraic equation relating the new and old independent variables (e.g. ``t = f(u(t))``).
75
+
# Usage with non-autonomous systems
76
+
77
+
If `sys` is non-autonomous (i.e. ``t`` appears explicitly in its equations), it is often desirable to also pass an algebraic equation relating the new and old independent variables (e.g. ``t = f(u(t))``).
78
78
Otherwise the transformed system will be underdetermined and cannot be structurally simplified without additional changes.
79
79
80
-
Usage with hierarchical systems
81
-
===============================
80
+
# Usage with hierarchical systems
81
+
82
82
It is recommended that `iv` is a non-namespaced variable in `sys`.
83
83
This means it can belong to the top-level system or be a variable in a subsystem declared with `GlobalScope`.
84
84
85
-
Example
86
-
=======
85
+
# Example
86
+
87
87
Consider a free fall with constant horizontal velocity.
88
88
Physics naturally describes position as a function of time.
89
89
By changing the independent variable, it can be reformulated for vertical position as a function of horizontal position:
0 commit comments