# ACMSimPy

**Repository Path**: xzitzt/ACMSimPy

## Basic Information

- **Project Name**: ACMSimPy
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: numba_demo_fulldynamics_svpwm
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-01-16
- **Last Updated**: 2024-06-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

![acmsimpy logo](https://github.com/horychen/ACMSimPy/blob/gui/gui/images/svg_images/logo_home_acmsimpy.svg?raw=true)

# Motor Control Simulation and its Visualization 

This project is initially intended to adopt the _PyOneDark Qt Modern GUI_ for visualization, but yesterday (2022-09-18) I found a better solutioin with _DearPyGui_.
> The file _main.py_ uses the PySide6 (or PyQt6), and the DearPyGui is simply a script _/simulation/dem_demo.py_.

## Installation
- 1. Install _Anaconda 3_ and open command prompt cmd.exe on Windows
- 2. `conda create -n main python=3.10`
- 3. `conda activate main`
- 4. `pip install PySide6 matplotlib pandas numba qtconsole control dearpygui`
- 5. `cd /d D:\acmsimpy`
- 6. `python main.py` for PySide6 GUI or `python ./simulation/dem_demo.py` for DearPyGui.
Or, you can simply run any core script in ./simulation folder, e.g., `python ./simulation/tutorials_ep6_maglev_motor.py`, batch-generating publication-ready figures with matplotlib.

> To avoid PyQt plugin issues (with Anaconda Python 3.8), please go with Anaconda Python 3.10 as exemplified above.

## Examples

### PyOneDark (with PySide6) Example
What is shown in the screenshot below is a dual-rotor-topology axial-flux in-wheel motor driven by a three-phase voltage source inverter. 
Space-vector PWM with deadtime inserted and a 300 V DC bus are simulated. The motor is closed-loop controlled with speed/position feedback. 
The speed command is sinusoidals and aims to sweep through different frequencies to inspect dynamic speed control performance.

![Example 1](https://github.com/horychen/ACMSimPy/blob/numba_demo_fulldynamics_svpwm/gui/images/acmsimpy-example01.png?raw=true)

### DEM (with DearPyGUi) Example 

add later

## Features

- A [unified ac motor model based on active flux concept by Ion Boldea](https://ieeexplore.ieee.org/document/9853634/) is implemented. Thanks to this, all AC motors can be simulated as control target.
- Numerical simulation is done by Runge–Kutta method (RK4, ode4).
- Space-vector PWM is implemented according to TI ControlSUITE.
- User input logic separation from code and a modern GUI.
- Batch making technical-paper-ready figures. *The code is the figure itself not the .pdf file!*
- Real-time simulation as if you are debugging in CCS with an actual motor. You can change anything during the simulation in real-time. *This is a feature that even Simulink does not provide.*
- With DearPyGui (a python binding or wrapper for implot and imgui), GPU accelerated rendering plots is now possible, yay!