Skip to content

Commit

Permalink
Update documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
actions-user committed Nov 13, 2024
1 parent 731a8ce commit 294c4f7
Show file tree
Hide file tree
Showing 98 changed files with 196 additions and 189 deletions.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
7 changes: 5 additions & 2 deletions docs/_sources/control/drive/current_ctrl.rst
Original file line number Diff line number Diff line change
Expand Up @@ -123,14 +123,17 @@ Here, the complex vector design is considered. Hence, the controller :eq:`cc` ca
where the angular speed of the coordinate system equals typically the measured rotor speed, :math:`\omega_\mathrm{s} = \omega_\mathrm{m}`, or the estimated rotor speed :math:`\omega_\mathrm{s} = \hat{\omega}_\mathrm{m}`. If the magnetic saturation is not considered, this flux-linkage-based current controller is equivalent to a regular 2DOF PI current controller (even if inductance estimates are inaccurate). Notice that :math:`\boldsymbol{i}_\mathrm{s,ref} = \boldsymbol{i}_\mathrm{s}` holds in the steady state even with inductance estimate inaccuracies, since the same inductances are used to map both the reference current and the actual current to the corresponding flux linkages.

.. note::
The control law :eq:`cc_flux` omits the effect of the stator resistance for simplicity, i.e., :math:`\hat R_\mathrm{s} = 0` is assumed. This is a common and practical assumption. However, if needed, the resistive voltage drop term :math:`\hat R_\mathrm{s}\boldsymbol{i}_\mathrm{s}` could be simply added to :math:`\boldsymbol{u}_\mathrm{s,ref}` in :eq:`cc_flux`.

The gain selection analogous to :eq:`complex_vector_gains` becomes

.. math::
\boldsymbol{k}_\mathrm{p} = 2\alpha_\mathrm{c} - \hat R_\mathrm{s} \qquad\qquad
\boldsymbol{k}_\mathrm{p} = 2\alpha_\mathrm{c} \qquad\qquad
\boldsymbol{k}_\mathrm{i} = \alpha_\mathrm{c}^2 \qquad \qquad
\boldsymbol{k}_\mathrm{t} = \alpha_\mathrm{c}
where :math:`\hat R_\mathrm{s} = 0` can be used in practice. Assume accurate parameter estimates and perfect alignment of the controller coordinate system with the rotor coordinate system. Then, using :eq:`sm_model`, :eq:`flux_mapping_sm`, and :eq:`cc_flux`, the closed-loop system can be shown to be analogous to the induction machine case. This control design corresponds to the implementation in the :class:`motulator.drive.control.sm.CurrentController` class.
Assume accurate parameter estimates and perfect alignment of the controller coordinate system with the rotor coordinate system. Then, using :eq:`sm_model`, :eq:`flux_mapping_sm`, and :eq:`cc_flux`, the closed-loop system can be shown to be analogous to the induction machine case. This control design corresponds to the implementation in the :class:`motulator.drive.control.sm.CurrentController` class.

.. rubric:: References

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -180,7 +180,7 @@ Plot results in per-unit values.

.. rst-class:: sphx-glr-timing

**Total running time of the script:** (0 minutes 9.871 seconds)
**Total running time of the script:** (0 minutes 9.893 seconds)


.. _sphx_glr_download_drive_examples_flux_vector_plot_flux_vector_im_2kw.py:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -168,7 +168,7 @@ Plot results in per-unit values.

.. rst-class:: sphx-glr-timing

**Total running time of the script:** (0 minutes 5.243 seconds)
**Total running time of the script:** (0 minutes 5.175 seconds)


.. _sphx_glr_download_drive_examples_flux_vector_plot_flux_vector_pmsm_2kw.py:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -357,7 +357,7 @@ Plot results in per-unit values.
.. rst-class:: sphx-glr-timing

**Total running time of the script:** (0 minutes 15.535 seconds)
**Total running time of the script:** (0 minutes 15.750 seconds)


.. _sphx_glr_download_drive_examples_flux_vector_plot_flux_vector_pmsyrm_5kw.py:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -280,7 +280,7 @@ machine has no magnets.
.. rst-class:: sphx-glr-timing

**Total running time of the script:** (0 minutes 14.955 seconds)
**Total running time of the script:** (0 minutes 15.273 seconds)


.. _sphx_glr_download_drive_examples_flux_vector_plot_flux_vector_syrm_7kw.py:
Expand Down
10 changes: 5 additions & 5 deletions docs/_sources/drive_examples/flux_vector/sg_execution_times.rst
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@

Computation times
=================
**00:45.604** total execution time for 4 files **from drive_examples/flux_vector**:
**00:46.091** total execution time for 4 files **from drive_examples/flux_vector**:

.. container::

Expand All @@ -33,14 +33,14 @@ Computation times
- Time
- Mem (MB)
* - :ref:`sphx_glr_drive_examples_flux_vector_plot_flux_vector_pmsyrm_5kw.py` (``plot_flux_vector_pmsyrm_5kw.py``)
- 00:15.535
- 00:15.750
- 0.0
* - :ref:`sphx_glr_drive_examples_flux_vector_plot_flux_vector_syrm_7kw.py` (``plot_flux_vector_syrm_7kw.py``)
- 00:14.955
- 00:15.273
- 0.0
* - :ref:`sphx_glr_drive_examples_flux_vector_plot_flux_vector_im_2kw.py` (``plot_flux_vector_im_2kw.py``)
- 00:09.871
- 00:09.893
- 0.0
* - :ref:`sphx_glr_drive_examples_flux_vector_plot_flux_vector_pmsm_2kw.py` (``plot_flux_vector_pmsm_2kw.py``)
- 00:05.243
- 00:05.175
- 0.0
Original file line number Diff line number Diff line change
Expand Up @@ -197,7 +197,7 @@ the results in SI units.

.. rst-class:: sphx-glr-timing

**Total running time of the script:** (0 minutes 9.061 seconds)
**Total running time of the script:** (0 minutes 9.049 seconds)


.. _sphx_glr_download_drive_examples_obs_vhz_plot_obs_vhz_ctrl_im_2kw.py:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -175,7 +175,7 @@ the results in SI units.

.. rst-class:: sphx-glr-timing

**Total running time of the script:** (0 minutes 24.322 seconds)
**Total running time of the script:** (0 minutes 24.004 seconds)


.. _sphx_glr_download_drive_examples_obs_vhz_plot_obs_vhz_ctrl_pmsm_2kw.py:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -265,7 +265,7 @@ rotor speed w_M.
.. rst-class:: sphx-glr-timing

**Total running time of the script:** (0 minutes 4.628 seconds)
**Total running time of the script:** (0 minutes 4.669 seconds)


.. _sphx_glr_download_drive_examples_obs_vhz_plot_obs_vhz_ctrl_pmsm_2kw_two_mass.py:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -287,7 +287,7 @@ the results in SI units.

.. rst-class:: sphx-glr-timing

**Total running time of the script:** (0 minutes 51.657 seconds)
**Total running time of the script:** (0 minutes 51.802 seconds)


.. _sphx_glr_download_drive_examples_obs_vhz_plot_obs_vhz_ctrl_pmsyrm_thor.py:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -266,7 +266,7 @@ the results in SI units.
.. rst-class:: sphx-glr-timing

**Total running time of the script:** (0 minutes 28.275 seconds)
**Total running time of the script:** (0 minutes 28.614 seconds)


.. _sphx_glr_download_drive_examples_obs_vhz_plot_obs_vhz_ctrl_syrm_7kw.py:
Expand Down
12 changes: 6 additions & 6 deletions docs/_sources/drive_examples/obs_vhz/sg_execution_times.rst
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@

Computation times
=================
**01:57.943** total execution time for 5 files **from drive_examples/obs_vhz**:
**01:58.138** total execution time for 5 files **from drive_examples/obs_vhz**:

.. container::

Expand All @@ -33,17 +33,17 @@ Computation times
- Time
- Mem (MB)
* - :ref:`sphx_glr_drive_examples_obs_vhz_plot_obs_vhz_ctrl_pmsyrm_thor.py` (``plot_obs_vhz_ctrl_pmsyrm_thor.py``)
- 00:51.657
- 00:51.802
- 0.0
* - :ref:`sphx_glr_drive_examples_obs_vhz_plot_obs_vhz_ctrl_syrm_7kw.py` (``plot_obs_vhz_ctrl_syrm_7kw.py``)
- 00:28.275
- 00:28.614
- 0.0
* - :ref:`sphx_glr_drive_examples_obs_vhz_plot_obs_vhz_ctrl_pmsm_2kw.py` (``plot_obs_vhz_ctrl_pmsm_2kw.py``)
- 00:24.322
- 00:24.004
- 0.0
* - :ref:`sphx_glr_drive_examples_obs_vhz_plot_obs_vhz_ctrl_im_2kw.py` (``plot_obs_vhz_ctrl_im_2kw.py``)
- 00:09.061
- 00:09.049
- 0.0
* - :ref:`sphx_glr_drive_examples_obs_vhz_plot_obs_vhz_ctrl_pmsm_2kw_two_mass.py` (``plot_obs_vhz_ctrl_pmsm_2kw_two_mass.py``)
- 00:04.628
- 00:04.669
- 0.0
Original file line number Diff line number Diff line change
Expand Up @@ -210,7 +210,7 @@ Plot results in per-unit values.

.. rst-class:: sphx-glr-timing

**Total running time of the script:** (0 minutes 12.559 seconds)
**Total running time of the script:** (0 minutes 12.719 seconds)


.. _sphx_glr_download_drive_examples_signal_inj_plot_signal_inj_pmsm_2kw.py:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -211,7 +211,7 @@ Plot results in per-unit values.

.. rst-class:: sphx-glr-timing

**Total running time of the script:** (0 minutes 12.644 seconds)
**Total running time of the script:** (0 minutes 12.633 seconds)


.. _sphx_glr_download_drive_examples_signal_inj_plot_signal_inj_syrm_7kw.py:
Expand Down
10 changes: 5 additions & 5 deletions docs/_sources/drive_examples/signal_inj/sg_execution_times.rst
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@

Computation times
=================
**00:25.202** total execution time for 2 files **from drive_examples/signal_inj**:
**00:25.353** total execution time for 2 files **from drive_examples/signal_inj**:

.. container::

Expand All @@ -32,9 +32,9 @@ Computation times
* - Example
- Time
- Mem (MB)
* - :ref:`sphx_glr_drive_examples_signal_inj_plot_signal_inj_syrm_7kw.py` (``plot_signal_inj_syrm_7kw.py``)
- 00:12.644
- 0.0
* - :ref:`sphx_glr_drive_examples_signal_inj_plot_signal_inj_pmsm_2kw.py` (``plot_signal_inj_pmsm_2kw.py``)
- 00:12.559
- 00:12.719
- 0.0
* - :ref:`sphx_glr_drive_examples_signal_inj_plot_signal_inj_syrm_7kw.py` (``plot_signal_inj_syrm_7kw.py``)
- 00:12.633
- 0.0
Original file line number Diff line number Diff line change
Expand Up @@ -223,7 +223,7 @@ the results in SI units.
.. rst-class:: sphx-glr-timing

**Total running time of the script:** (0 minutes 4.067 seconds)
**Total running time of the script:** (0 minutes 4.071 seconds)


.. _sphx_glr_download_drive_examples_vector_plot_vector_ctrl_im_2kw.py:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -179,7 +179,7 @@ the results in SI units.

.. rst-class:: sphx-glr-timing

**Total running time of the script:** (0 minutes 4.653 seconds)
**Total running time of the script:** (0 minutes 4.633 seconds)


.. _sphx_glr_download_drive_examples_vector_plot_vector_ctrl_im_2kw_tq_mode.py:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -157,15 +157,15 @@ Create the simulation object and simulate it.

.. code-block:: none
Simulation time: 4.21 s
Simulation time: 4.30 s
.. rst-class:: sphx-glr-timing

**Total running time of the script:** (0 minutes 5.219 seconds)
**Total running time of the script:** (0 minutes 5.342 seconds)


.. _sphx_glr_download_drive_examples_vector_plot_vector_ctrl_pmsm_2kw.py:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -180,7 +180,7 @@ Create the simulation object and simulate it.

.. rst-class:: sphx-glr-timing

**Total running time of the script:** (0 minutes 14.225 seconds)
**Total running time of the script:** (0 minutes 14.321 seconds)


.. _sphx_glr_download_drive_examples_vector_plot_vector_ctrl_pmsm_2kw_diode.py:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -207,7 +207,7 @@ Create the simulation object, simulate, and plot results in per-unit values.

.. rst-class:: sphx-glr-timing

**Total running time of the script:** (0 minutes 4.982 seconds)
**Total running time of the script:** (0 minutes 4.933 seconds)


.. _sphx_glr_download_drive_examples_vector_plot_vector_ctrl_pmsyrm_thor.py:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -159,7 +159,7 @@ Create the simulation object, simulate, and plot results in per-unit values.

.. rst-class:: sphx-glr-timing

**Total running time of the script:** (0 minutes 25.659 seconds)
**Total running time of the script:** (0 minutes 25.911 seconds)


.. _sphx_glr_download_drive_examples_vector_plot_vector_ctrl_syrm_7kw.py:
Expand Down
14 changes: 7 additions & 7 deletions docs/_sources/drive_examples/vector/sg_execution_times.rst
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@

Computation times
=================
**00:58.805** total execution time for 6 files **from drive_examples/vector**:
**00:59.211** total execution time for 6 files **from drive_examples/vector**:

.. container::

Expand All @@ -33,20 +33,20 @@ Computation times
- Time
- Mem (MB)
* - :ref:`sphx_glr_drive_examples_vector_plot_vector_ctrl_syrm_7kw.py` (``plot_vector_ctrl_syrm_7kw.py``)
- 00:25.659
- 00:25.911
- 0.0
* - :ref:`sphx_glr_drive_examples_vector_plot_vector_ctrl_pmsm_2kw_diode.py` (``plot_vector_ctrl_pmsm_2kw_diode.py``)
- 00:14.225
- 00:14.321
- 0.0
* - :ref:`sphx_glr_drive_examples_vector_plot_vector_ctrl_pmsm_2kw.py` (``plot_vector_ctrl_pmsm_2kw.py``)
- 00:05.219
- 00:05.342
- 0.0
* - :ref:`sphx_glr_drive_examples_vector_plot_vector_ctrl_pmsyrm_thor.py` (``plot_vector_ctrl_pmsyrm_thor.py``)
- 00:04.982
- 00:04.933
- 0.0
* - :ref:`sphx_glr_drive_examples_vector_plot_vector_ctrl_im_2kw_tq_mode.py` (``plot_vector_ctrl_im_2kw_tq_mode.py``)
- 00:04.653
- 00:04.633
- 0.0
* - :ref:`sphx_glr_drive_examples_vector_plot_vector_ctrl_im_2kw.py` (``plot_vector_ctrl_im_2kw.py``)
- 00:04.067
- 00:04.071
- 0.0
Original file line number Diff line number Diff line change
Expand Up @@ -197,7 +197,7 @@ Plot results in per-unit values.

.. rst-class:: sphx-glr-timing

**Total running time of the script:** (0 minutes 8.934 seconds)
**Total running time of the script:** (0 minutes 8.967 seconds)


.. _sphx_glr_download_drive_examples_vhz_plot_vhz_ctrl_6step_im_2kw.py:
Expand Down
2 changes: 1 addition & 1 deletion docs/_sources/drive_examples/vhz/plot_vhz_ctrl_im_2kw.rst
Original file line number Diff line number Diff line change
Expand Up @@ -217,7 +217,7 @@ Plot results in per-unit values.
.. rst-class:: sphx-glr-timing

**Total running time of the script:** (0 minutes 17.388 seconds)
**Total running time of the script:** (0 minutes 17.639 seconds)


.. _sphx_glr_download_drive_examples_vhz_plot_vhz_ctrl_im_2kw.py:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -239,7 +239,7 @@ Plot additional waveforms.
.. rst-class:: sphx-glr-timing

**Total running time of the script:** (0 minutes 9.666 seconds)
**Total running time of the script:** (0 minutes 9.706 seconds)


.. _sphx_glr_download_drive_examples_vhz_plot_vhz_ctrl_im_2kw_lc.py:
Expand Down
8 changes: 4 additions & 4 deletions docs/_sources/drive_examples/vhz/sg_execution_times.rst
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@

Computation times
=================
**00:35.988** total execution time for 3 files **from drive_examples/vhz**:
**00:36.312** total execution time for 3 files **from drive_examples/vhz**:

.. container::

Expand All @@ -33,11 +33,11 @@ Computation times
- Time
- Mem (MB)
* - :ref:`sphx_glr_drive_examples_vhz_plot_vhz_ctrl_im_2kw.py` (``plot_vhz_ctrl_im_2kw.py``)
- 00:17.388
- 00:17.639
- 0.0
* - :ref:`sphx_glr_drive_examples_vhz_plot_vhz_ctrl_im_2kw_lc.py` (``plot_vhz_ctrl_im_2kw_lc.py``)
- 00:09.666
- 00:09.706
- 0.0
* - :ref:`sphx_glr_drive_examples_vhz_plot_vhz_ctrl_6step_im_2kw.py` (``plot_vhz_ctrl_6step_im_2kw.py``)
- 00:08.934
- 00:08.967
- 0.0
Original file line number Diff line number Diff line change
Expand Up @@ -195,7 +195,7 @@ Plot the results.

.. rst-class:: sphx-glr-timing

**Total running time of the script:** (0 minutes 1.136 seconds)
**Total running time of the script:** (0 minutes 1.240 seconds)


.. _sphx_glr_download_grid_examples_grid_following_plot_gfl_10kva.py:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -195,7 +195,7 @@ Plot the results.

.. rst-class:: sphx-glr-timing

**Total running time of the script:** (0 minutes 1.169 seconds)
**Total running time of the script:** (0 minutes 1.281 seconds)


.. _sphx_glr_download_grid_examples_grid_following_plot_gfl_dc_bus_10kva.py:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -184,7 +184,7 @@ Plot the results.

.. rst-class:: sphx-glr-timing

**Total running time of the script:** (0 minutes 1.218 seconds)
**Total running time of the script:** (0 minutes 1.312 seconds)


.. _sphx_glr_download_grid_examples_grid_following_plot_gfl_lcl_10kva.py:
Expand Down
Loading

0 comments on commit 294c4f7

Please sign in to comment.