Merge pull request #2890 from ven-k/vkb/mtk-lang

Rename `@mtkmodel`... docs and add a section describing `@mtkbuild`

docs/pages.jl

@@ -28,7 +28,7 @@ pages = [
         "basics/Composition.md",
         "basics/Events.md",
         "basics/Linearization.md",
-        "basics/MTKModel_Connector.md",
+        "basics/MTKLanguage.md",
         "basics/Validation.md",
         "basics/DependencyGraphs.md",
         "basics/Precompilation.md",

docs/src/basics/MTKModel_Connector.md → docs/src/basics/MTKLanguage.md

@@ -1,4 +1,4 @@
-# [Components and Connectors](@id mtkmodel_connector)
+# [ModelingToolkit Language: Modeling with `@mtkmodel`, `@connectors` and `@mtkbuild`](@id mtk_language)
 
 ## MTK Model
 
@@ -441,3 +441,31 @@ Using ternary operator or if-elseif-else statement, conditional initial guesses
     end
 end
 ```
+
+## Build structurally simplified models:
+
+`@mtkbuild` builds an instance of a component and returns a structurally simplied `ODESystem`.
+
+```julia
+@mtkbuild sys = CustomModel()
+```
+
+This is equivalent to:
+
+```julia
+@named model = CustomModel()
+sys = structural_simplify(model)
+```
+
+Pass keyword arguments to `structural_simplify` using the following syntax:
+
+```julia
+@mtkbuild sys=CustomModel() fully_determined=false
+```
+
+This is equivalent to:
+
+```julia
+@named model = CustomModel()
+sys = structural_simplify(model; fully_determined = false)
+```

docs/src/tutorials/ode_modeling.md

@@ -417,7 +417,7 @@ Where to go next?
   - Not sure how MTK relates to similar tools and packages? Read
     [Comparison of ModelingToolkit vs Equation-Based and Block Modeling Languages](@ref).
   - For a more detailed explanation of `@mtkmodel` checkout
-    [Defining components with `@mtkmodel` and connectors with `@connectors`](@ref mtkmodel_connector)
+    [Defining components with `@mtkmodel` and connectors with `@connectors`](@ref mtk_language)
   - Depending on what you want to do with MTK, have a look at some of the other
     **Symbolic Modeling Tutorials**.
   - If you want to automatically convert an existing function to a symbolic