Electromechanical Dynamic Code

ElectroM: Electromechanical Dynamic Code is a Matlab code designed to simulate the nonlinear dynamics of typical electromechanical systems. This package includes two physical-mathematical models:

Full-order model: Considers the mutual interaction between electrical and mechanical sub-systems, resulting in a coupled system of ODEs.
Reduced-order model: Considers only the influence of the mechanical sub-systems on the electrical one, resulting in a decoupled system of ODEs.

Overview
Features
Usage
Documentation
Reproducibility
Authors
Citing ElectroM
License
Institutional support
Funding

Overview

ElectroM was used to generate the results reported in the following works:

A. Cunha Jr, M. Pereira, R. Avanço, A. M. Tusset, and J. M. Balthazar, ElectroM: ElectroMechanical dynamic code, Software Impacts, 17:100533, 2023. DOI
A. Cunha Jr, M. Pereira, R. Avanço, A. M. Tusset, and J. M. Balthazar, On the modeling of nonlinear electromechanical systems, Meccanica, 57:2679-2697, 2022. DOI
R. H. Avanço, D. A. Zanella, A. Cunha Jr, A. M. Tusset, J. M. Balthazar, A Tutorial on the Simplification of Electromechanical Dynamic Models, In: Balthazar, JM (eds), Nonlinear Vibrations Excited by Limited Power Sources. Mechanisms and Machine Science, vol 116. Springer, Cham, 2022. DOI

Preprint available here.

Features

Simulates nonlinear dynamics of electromechanical systems
Includes full-order and reduced-order models
Considers mutual interaction between electrical and mechanical sub-systems in the full-order model
Decouples electrical and mechanical sub-systems in the reduced-order model
Calculates dimensionless groups for electromechanical systems
Provides easy-to-understand, well-commented code
Offers educational style code implementation for intuitive use

Usage

To started with ElectroM, follow these steps:

Clone the repository:

git clone https://github.com/americocunhajr/ElectroM.git

Navigate to the code directory:
```
cd ElectroM/ElectroM-1.0
```
To simulate both dynamical systems, execute:
```
main_ElectroM_ivp
```
To perform Fourier analysis, execute:
```
main_ElectroM_fourier
```
To compute dimensionless parameters value, execute:
```
main_ElectroM_dimensionless
```
To compute dimensionless groups, execute:
```
main_ElectroM_pi_groups
```

Documentation

ElectroM routines are thoroughly commented to explain their functionality to the user. Each routine includes a short description of its purpose and a list of inputs and outputs.

Reproducibility

Simulations done with ElectroM are fully reproducible. You can access a reproducible capsule of the simulations on CodeOcean.

Authors

Americo Cunha Jr
Marcelo Pereira
Rafael Avanço
Angelo Marcelo Tusset
José Manoel Balthazar

Citing ElectroM

If you use ElectroM in your research, please cite the following publications:

A. Cunha Jr, M. Pereira, R. Avanço, A. M. Tusset, and J. M. Balthazar, ElectroM: ElectroMechanical dynamic code, Software Impacts, 17:100533, 2023 https://doi.org/10.1016/j.simpa.2023.100533
A. Cunha Jr, M. Pereira, R. Avanço, A. M. Tusset, and J. M. Balthazar, On the modeling of nonlinear electromechanical systems, Meccanica, 57:2679-2697, 2022 https://doi.org/10.1007/s11012-022-01542-4
R. H. Avanço, D. A. Zanella, A. Cunha Jr, A. M. Tusset, J. M. Balthazar, A Tutorial on the Simplification of Electromechanical Dynamic Models, In: Balthazar, JM (eds), Nonlinear Vibrations Excited by Limited Power Sources. Mechanisms and Machine Science, vol 116. Springer, Cham, 2022 https://doi.org/10.1007/978-3-030-96603-4_1

@article{CunhaJr2023ElectroM,
   author  = {A. Cunha Jr and M. Pereira and R. Avanço and A. M. Tusset and J. M. Balthazar},
   title   = "{ElectroM: Electromechanical Dynamic Code}",
   journal = {Software Impacts},
   year    = {2023},
   volume  = {17},
   pages   = {100533},
   doi     = {10.1016/j.simpa.2023.100533},
}

@article{CunhaJr2022p2679,
   author  = {A. Cunha Jr and M. Pereira and R. Avanço and A. M. Tusset and J. M. Balthazar},
   title   = {On the reduction of nonlinear electromechanical systems},
   journal = {Meccanica},
   year    = {2022},
   volume  = {57},
   pages   = {2679-2697},
   doi     = {10.1007/s11012-022-01542-4},
}

@Inbook{Avanço2022bookchap,
author    = {Avan{\c{c}}o, Rafael Henrique and Zanella, Danilo Antonio and Cunha, Americo and Tusset, Angelo Marcelo and Balthazar, Jose Manoel},
editor    = {Balthazar, Jose Manoel},
title     = "{A Tutorial on the Simplification of Electromechanical Dynamic Models}",
bookTitle = {Nonlinear Vibrations Excited by Limited Power Sources},
year      = {2022},
publisher = {Springer International Publishing},
address   = {Cham},
pages.    = {3--14},
doi       = {10.1007/978-3-030-96603-4_1},
}

License

ElectroM is released under the MIT license. See the LICENSE file for details. All new contributions must be made under the MIT license.