revert rename

Author: vyudu

docs/src/basics/AbstractSystem.md

@@ -152,7 +152,7 @@ a lower level in the system.
 ## Namespacing
 
 By default, unsimplified systems will namespace variables accessed via `getproperty`.
-Systems created via `@mtkbuild`, or ones passed through `mtkbuild` or
+Systems created via `@mtkbuild`, or ones passed through `structural_simplify` or
 `complete` will not perform this namespacing. However, all of these processes modify
 the system in a variety of ways. To toggle namespacing without transforming any other
 property of the system, use `toggle_namespacing`.

docs/src/basics/Composition.md

@@ -42,7 +42,7 @@ equations(connected)
 # Differential(t)(decay1₊x(t)) ~ decay1₊f(t) - (decay1₊a*(decay1₊x(t)))
 # Differential(t)(decay2₊x(t)) ~ decay2₊f(t) - (decay2₊a*(decay2₊x(t)))
 
-simplified_sys = mtkbuild(connected)
+simplified_sys = structural_simplify(connected)
 
 equations(simplified_sys)
 ```
@@ -84,7 +84,7 @@ example, let's say there is a variable `x` in `unknowns` and a variable
 `x` in `subsys`. We can declare that these two variables are the same
 by specifying their equality: `x ~ subsys.x` in the `eqs` for `sys`.
 This algebraic relationship can then be simplified by transformations
-like `mtkbuild` which will be described later.
+like `structural_simplify` which will be described later.
 
 ### Numerics with Composed Models
 
@@ -169,7 +169,7 @@ parameters(level3)
 
 In many cases, the nicest way to build a model may leave a lot of
 unnecessary variables. Thus one may want to remove these equations
-before numerically solving. The `mtkbuild` function removes
+before numerically solving. The `structural_simplify` function removes
 these trivial equality relationships and trivial singularity equations,
 i.e. equations which result in `0~0` expressions, in over-specified systems.
 
@@ -227,7 +227,7 @@ values. The user of this model can then solve this model simply by
 specifying the values at the highest level:
 
 ```@example compose
-sireqn_simple = mtkbuild(sir)
+sireqn_simple = structural_simplify(sir)
 
 equations(sireqn_simple)
 ```
@@ -251,7 +251,7 @@ sol[reqn.R]
 ## Tearing Problem Construction
 
 Some system types (specifically `NonlinearSystem`) can be further
-reduced if `mtkbuild` has already been applied to them. This is done
+reduced if `structural_simplify` has already been applied to them. This is done
 by using the alternative problem constructors (`BlockNonlinearProblem`).
 In these cases, the constructor uses the knowledge of the
 strongly connected components calculated during the process of simplification

docs/src/basics/Debugging.md

@@ -13,7 +13,7 @@ using ModelingToolkit: t_nounits as t, D_nounits as D
 eqs = [D(u1) ~ -√(u1), D(u2) ~ -√(u2), D(u3) ~ -√(u3)]
 defaults = [u1 => 1.0, u2 => 2.0, u3 => 3.0]
 @named sys = ODESystem(eqs, t; defaults)
-sys = mtkbuild(sys)
+sys = structural_simplify(sys)
 ```
 
 This problem causes the ODE solver to crash:

docs/src/basics/Events.md

@@ -472,7 +472,7 @@ to the system.
 ```@example events
 @named sys = ODESystem(
     eqs, t, [temp], params; continuous_events = [furnace_disable, furnace_enable])
-ss = mtkbuild(sys)
+ss = structural_simplify(sys)
 prob = ODEProblem(ss, [temp => 0.0, furnace_on => true], (0.0, 10.0))
 sol = solve(prob, Tsit5())
 plot(sol)
@@ -585,7 +585,7 @@ We can now simulate the encoder.
 ```@example events
 @named sys = ODESystem(
     eqs, t, [theta, omega], params; continuous_events = [qAevt, qBevt])
-ss = mtkbuild(sys)
+ss = structural_simplify(sys)
 prob = ODEProblem(ss, [theta => 0.0], (0.0, pi))
 sol = solve(prob, Tsit5(); dtmax = 0.01)
 sol.ps[cnt]

docs/src/basics/FAQ.md

@@ -28,7 +28,7 @@ are similarly undocumented. Following is the list of behaviors that should be re
   - `setindex!(::MTKParameters, value, ::ParameterIndex)` can be used to set the value of a
     parameter with the given index.
   - `parameter_values(sys, sym)` will return a `ParameterIndex` object if `sys` has been
-    `complete`d (through `mtkbuild`, `complete` or `@mtkbuild`).
+    `complete`d (through `structural_simplify`, `complete` or `@mtkbuild`).
   - `copy(::MTKParameters)` is defined and duplicates the parameter object, including the
     memory used by the underlying buffers.
 
@@ -194,7 +194,7 @@ p, replace, alias = SciMLStructures.canonicalize(Tunable(), prob.p)
 
 # ERROR: ArgumentError: SymbolicUtils.BasicSymbolic{Real}[xˍt(t)] are missing from the variable map.
 
-This error can come up after running `mtkbuild` on a system that generates dummy derivatives (i.e. variables with `ˍt`).  For example, here even though all the variables are defined with initial values, the `ODEProblem` generation will throw an error that defaults are missing from the variable map.
+This error can come up after running `structural_simplify` on a system that generates dummy derivatives (i.e. variables with `ˍt`).  For example, here even though all the variables are defined with initial values, the `ODEProblem` generation will throw an error that defaults are missing from the variable map.
 
 ```julia
 using ModelingToolkit
@@ -206,7 +206,7 @@ eqs = [x1 + x2 + 1 ~ 0
        x1 + D(x3) + x4 + 3 ~ 0
        2 * D(D(x1)) + D(D(x2)) + D(D(x3)) + D(x4) + 4 ~ 0]
 @named sys = ODESystem(eqs, t)
-sys = mtkbuild(sys)
+sys = structural_simplify(sys)
 prob = ODEProblem(sys, [], (0, 1))
 ```
 

docs/src/basics/InputOutput.md

@@ -28,6 +28,10 @@ ModelingToolkit can generate the dynamics of a system, the function ``M\dot x =
 
 This function takes a vector of variables that are to be considered inputs, i.e., part of the vector ``u``. Alongside returning the function ``f``, [`ModelingToolkit.generate_control_function`](@ref) also returns the chosen state realization of the system after simplification. This vector specifies the order of the state variables ``x``, while the user-specified vector `u` specifies the order of the input variables ``u``.
 
+!!! note "Un-simplified system"
+    
+    This function expects `sys` to be un-simplified, i.e., `structural_simplify` or `@mtkbuild` should not be called on the system before passing it into this function. `generate_control_function` calls a special version of `structural_simplify` internally.
+
 ### Example:
 
 The following example implements a simple first-order system with an input `u` and state `x`. The function `f` is generated using `generate_control_function`, and the function `f` is then tested with random input and state values.

docs/src/basics/Linearization.md

@@ -75,7 +75,7 @@ eqs = [D(x) ~ v
        y.u ~ x]
 
 @named duffing = ODESystem(eqs, t, systems = [y, u], defaults = [u.u => 0])
-duffing = mtkbuild(duffing, inputs = [u.u], outputs = [y.u])
+duffing = structural_simplify(duffing, inputs = [u.u], outputs = [y.u])
 
 # pass a constant value for `x`, since it is the variable we will change in operating points
 linfun = linearization_function(duffing, [u.u], [y.u]; op = Dict(x => NaN));

docs/src/basics/MTKLanguage.md

@@ -508,10 +508,10 @@ This is equivalent to:
 
 ```julia
 @named model = CustomModel()
-sys = mtkbuild(model)
+sys = structural_simplify(model)
 ```
 
-Pass keyword arguments to `mtkbuild` using the following syntax:
+Pass keyword arguments to `structural_simplify` using the following syntax:
 
 ```julia
 @mtkbuild sys=CustomModel() fully_determined=false
@@ -521,5 +521,5 @@ This is equivalent to:
 
 ```julia
 @named model = CustomModel()
-sys = mtkbuild(model; fully_determined = false)
+sys = structural_simplify(model; fully_determined = false)
 ```

docs/src/basics/Precompilation.md

@@ -22,7 +22,7 @@ using ModelingToolkit
 
 @variables x(ModelingToolkit.t_nounits)
 @named sys = ODESystem([ModelingToolkit.D_nounits(x) ~ -x + 1], ModelingToolkit.t_nounits)
-prob = ODEProblem(mtkbuild(sys), [x => 30.0], (0, 100), [],
+prob = ODEProblem(structural_simplify(sys), [x => 30.0], (0, 100), [],
     eval_expression = true, eval_module = @__MODULE__)
 
 end

docs/src/basics/Validation.md

@@ -112,7 +112,7 @@ ps = @parameters s=-1 [unit = u"cm"] c=c [unit = u"cm"]
 eqs = [D(a) ~ dummycomplex(c, s);]
 sys = ODESystem(
     eqs, t, [sts...;], [ps...;], name = :sys, checks = ~ModelingToolkit.CheckUnits)
-sys_simple = mtkbuild(sys)
+sys_simple = structural_simplify(sys)
 ```
 
 ## `DynamicQuantities` Literals