Merge pull request #311 from sathvikbhagavan/sb/docs

docs: clean up docs and fix custom component tutorial

Author: ChrisRackauckas

docs/src/API/blocks.md

@@ -19,7 +19,10 @@ Pages = ["blocks.md"]
 ```@docs
 RealInput
 RealOutput
+RealInputArray
+RealOutputArray
 SISO
+MIMO
 ```
 
 ## Math Blocks

docs/src/tutorials/custom_component.md

@@ -91,11 +91,11 @@ The final model can now be created with the components from the library and the
 
 ```@example components
 systems = @named begin
-    L = Inductor(L = 18)
+    L = Inductor(L = 18, i = 0)
     Ro = Resistor(R = 12.5e-3)
     G = Conductor(G = 0.565)
     C1 = Capacitor(C = 10, v = 4)
-    C2 = Capacitor(C = 100)
+    C2 = Capacitor(C = 100, v = 0)
     Nr = NonlinearResistor(Ga = -0.757576,
         Gb = -0.409091,
         Ve = 1)
@@ -124,20 +124,14 @@ Since the initial voltage of the first capacitor was already specified via `v`,
 
 ```@example components
 sys = structural_simplify(model)
-prob = ODEProblem(sys, Pair[], (0, 5e4), saveat = 0.01)
-sol = solve(prob, Rodas4())
+prob = ODEProblem(sys, Pair[], (0, 5e4))
+sol = solve(prob, Rodas4(); saveat = 1.0)
 
-Plots.plot(sol[C1.v], sol[C2.v], title = "Chaotic Attractor", label = "",
+plot(sol[C1.v], sol[C2.v], title = "Chaotic Attractor", label = "",
     ylabel = "C1 Voltage in V", xlabel = "C2 Voltage in V")
-Plots.savefig("chua_phase_plane.png")
-nothing # hide
+```
 
-Plots.plot(sol; idxs = [C1.v, C2.v, L.i],
+```@example components
+plot(sol; idxs = [C1.v, C2.v, L.i],
     labels = ["C1 Voltage in V" "C2 Voltage in V" "Inductor Current in A"])
-Plots.savefig("chua.png")
-nothing # hide
 ```
-
-![Time series plot of C1.v, C2.v and L.i](chua_phase_plane.png)
-
-![Phase plane plot of C1.v and C2.v](chua.png)

docs/src/tutorials/dc_motor_pi.md

@@ -77,11 +77,11 @@ sys = structural_simplify(model)
 prob = ODEProblem(sys, unknowns(sys) .=> 0.0, (0, 6.0))
 sol = solve(prob, Rodas4())
 
-p1 = Plots.plot(sol.t, sol[inertia.w], ylabel = "Angular Vel. in rad/s",
+p1 = plot(sol.t, sol[inertia.w], ylabel = "Angular Vel. in rad/s",
     label = "Measurement", title = "DC Motor with Speed Controller")
-Plots.plot!(sol.t, sol[ref.output.u], label = "Reference")
-p2 = Plots.plot(sol.t, sol[load.tau.u], ylabel = "Disturbance in Nm", label = "")
-Plots.plot(p1, p2, layout = (2, 1))
+plot!(sol.t, sol[ref.output.u], label = "Reference")
+p2 = plot(sol.t, sol[load.tau.u], ylabel = "Disturbance in Nm", label = "")
+plot(p1, p2, layout = (2, 1))
 ```
 
 ## Closed-loop analysis

docs/src/tutorials/rc_circuit.md

@@ -35,8 +35,4 @@ sol = solve(prob, Tsit5())
 plot(sol, idxs = [capacitor.v, resistor.i],
     title = "RC Circuit Demonstration",
     labels = ["Capacitor Voltage" "Resistor Current"])
-savefig("plot.png");
-nothing; # hide
 ```
-
-![](plot.png)

docs/src/tutorials/thermal_model.md

@@ -37,8 +37,4 @@ T_final_K = sol[(mass1.T * C1 + mass2.T * C2) / (C1 + C2)]
 plot(title = "Thermal Conduction Demonstration")
 plot!(sol, idxs = [mass1.T, mass2.T], labels = ["Mass 1 Temperature" "Mass 2 Temperature"])
 plot!(sol.t, T_final_K, label = "Steady-State Temperature")
-savefig("thermal_plot.png");
-nothing; # hide
 ```
-
-![Plot of Temperatures](thermal_plot.png)