mggpy 0.0.3__tar.gz

mggpy-0.0.3/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 RafaelSantos
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mggpy-0.0.3/PKG-INFO

@@ -0,0 +1,112 @@
+Metadata-Version: 2.4
+Name: mggpy
+Version: 0.0.3
+Summary: Multi-Gene Genetic Programming for system identification and regression
+Author-email: Rafael Avila <rafael.santos0t5@gmail.com>, Henrique Castro <henriquec.castro@outlook.com>
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy>=1.26
+Requires-Dist: deap>=1.4
+Requires-Dist: tqdm>=4.67
+Dynamic: license-file
+
+# MGGP (Multigene Genetic Programming)
+
+[![Version](https://img.shields.io/badge/version-0.0.3-blue.svg)](https://github.com/RafaelGAT108/mggp_model/releases/tag/v0.0.3)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
+A flexible and extensible implementation of **Multigene Genetic Programming (MGGP)** focused on **system identification** and **symbolic modeling**, supporting:
+
+- **Regression (static and dynamic systems)**
+- **Classification tasks**
+- **Dynamic models in NARX and FIR formulations**
+- **SISO, MISO, and MIMO system configurations**
+
+---
+
+## 📦 Version: v0.0.3 (Latest Release)
+
+This version introduces important improvements in **modeling capabilities**, **code clarity**, and **project structure**, moving the project closer to a fully packaged Python library.
+
+### 🚀 What's new?
+
+- ✅ **Improved readability of Free-Run and Multi-Shooting (MShooting) implementations**  
+  - Clearer iteration flow  
+  - Explicit batch handling in MShooting  
+  - Consistent behavior across **SISO, MISO, and MIMO**
+
+- ✅ **Support for current input term `u[k]`**  
+  Previously, models only considered delayed inputs (`u[k-1], ..., u[k-lagMax]`).  
+  Including `u[k]` significantly enhances the expressive power of the identified models.
+
+- ✅ **Advancements toward packaging as a Python library**  
+  Internal refactoring and structural improvements preparing for future PyPI release.
+
+- ✅ **Improved symbolic simplification for SISO models**  
+  Cleaner and more interpretable final equations.
+
+- ✅ **General code cleanup and notebook reorganization**
+
+---
+
+
+## 🧠 Core Features
+
+- Symbolic regression via **Multigene Genetic Programming**
+- Support for **dynamic system identification (NARX / FIR)**
+- Native handling of:
+  - SISO (Single Input Single Output)
+  - MISO (Multiple Input Single Output)
+  - MIMO (Multiple Input Multiple Output)
+- Free-run simulation and **multi-shooting training strategies**
+- Interpretable model structures (explicit equations)
+
+---
+
+## 🚀 Quick Start
+
+Before start to run any notebook, run the code below to install the mggp as a library:
+
+```bash
+pip install -e .
+```
+
+otherwise, you'll need use:
+```python
+src.mggp import MGGP
+```
+
+Check out the example notebook to get started:
+
+📓 **`01_MGGP_Regression.ipynb`** - Demonstrates how to configure and use MGGP for Regression problems, and
+
+📓 **`01_MGGP_Classifier.ipynb`** - Demonstrates how to configure and use MGGP for Classification problems.
+
+
+
+## 📋 Requirements
+
+The requirements are descript in the requirements.txt
+
+This implementation is based on the MGGP methodology described in the following papers:
+
+### Foundational Works
+
+**Multi-Gene Genetic Programming for Nonlinear MIMO Modeling of F16 Aircraft Ground Vibrations**
+
+> DOS SANTOS, Rafael Ávila et al. Multi-Gene Genetic Programming para Modelagem MIMO Nao Linear das Vibraçoes de uma Aeronave F16 no Solo.*
+
+[📄 Download PDF](https://www.researchgate.net/profile/Rafael-Dos-Santos-26/publication/400395141_Multi-Gene_Genetic_Programming_para_Modelagem_MIMO_Nao_Linear_das_Vibracoes_de_uma_Aeronave_F16_no_Solo/links/69820b695d60ab48356a7d4f/Multi-Gene-Genetic-Programming-para-Modelagem-MIMO-Nao-Linear-das-Vibracoes-de-uma-Aeronave-F16-no-Solo.pdf)
+
+
+**A Novel MIMO Multi-Gene Genetic Programming Approach for Interpretable NARX Models: an application to vehicle state estimation**
+
+> HENRIQUE GROENNER BARBOSA, Bruno et al. A Novel MIMO Multi-Gene Genetic Programming Approach for Interpretable NARX Models: an application to vehicle state estimation. Henrique and Ávila Santos, Rafael and Correa Victorino, Alessandro and Askari, Hassan and Xu, Nan, A Novel MIMO Multi-Gene Genetic Programming Approach for Interpretable NARX Models: an application to vehicle state estimation.*
+
+[📄 Download PDF](https://doi.org/10.2139/ssrn.5946034)
+
+## 🤝 Contributing
+
+Contributions are welcome! Feel free to open issues or submit pull requests.

mggpy-0.0.3/README.md

@@ -0,0 +1,98 @@
+# MGGP (Multigene Genetic Programming)
+
+[![Version](https://img.shields.io/badge/version-0.0.3-blue.svg)](https://github.com/RafaelGAT108/mggp_model/releases/tag/v0.0.3)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
+A flexible and extensible implementation of **Multigene Genetic Programming (MGGP)** focused on **system identification** and **symbolic modeling**, supporting:
+
+- **Regression (static and dynamic systems)**
+- **Classification tasks**
+- **Dynamic models in NARX and FIR formulations**
+- **SISO, MISO, and MIMO system configurations**
+
+---
+
+## 📦 Version: v0.0.3 (Latest Release)
+
+This version introduces important improvements in **modeling capabilities**, **code clarity**, and **project structure**, moving the project closer to a fully packaged Python library.
+
+### 🚀 What's new?
+
+- ✅ **Improved readability of Free-Run and Multi-Shooting (MShooting) implementations**  
+  - Clearer iteration flow  
+  - Explicit batch handling in MShooting  
+  - Consistent behavior across **SISO, MISO, and MIMO**
+
+- ✅ **Support for current input term `u[k]`**  
+  Previously, models only considered delayed inputs (`u[k-1], ..., u[k-lagMax]`).  
+  Including `u[k]` significantly enhances the expressive power of the identified models.
+
+- ✅ **Advancements toward packaging as a Python library**  
+  Internal refactoring and structural improvements preparing for future PyPI release.
+
+- ✅ **Improved symbolic simplification for SISO models**  
+  Cleaner and more interpretable final equations.
+
+- ✅ **General code cleanup and notebook reorganization**
+
+---
+
+
+## 🧠 Core Features
+
+- Symbolic regression via **Multigene Genetic Programming**
+- Support for **dynamic system identification (NARX / FIR)**
+- Native handling of:
+  - SISO (Single Input Single Output)
+  - MISO (Multiple Input Single Output)
+  - MIMO (Multiple Input Multiple Output)
+- Free-run simulation and **multi-shooting training strategies**
+- Interpretable model structures (explicit equations)
+
+---
+
+## 🚀 Quick Start
+
+Before start to run any notebook, run the code below to install the mggp as a library:
+
+```bash
+pip install -e .
+```
+
+otherwise, you'll need use:
+```python
+src.mggp import MGGP
+```
+
+Check out the example notebook to get started:
+
+📓 **`01_MGGP_Regression.ipynb`** - Demonstrates how to configure and use MGGP for Regression problems, and
+
+📓 **`01_MGGP_Classifier.ipynb`** - Demonstrates how to configure and use MGGP for Classification problems.
+
+
+
+## 📋 Requirements
+
+The requirements are descript in the requirements.txt
+
+This implementation is based on the MGGP methodology described in the following papers:
+
+### Foundational Works
+
+**Multi-Gene Genetic Programming for Nonlinear MIMO Modeling of F16 Aircraft Ground Vibrations**
+
+> DOS SANTOS, Rafael Ávila et al. Multi-Gene Genetic Programming para Modelagem MIMO Nao Linear das Vibraçoes de uma Aeronave F16 no Solo.*
+
+[📄 Download PDF](https://www.researchgate.net/profile/Rafael-Dos-Santos-26/publication/400395141_Multi-Gene_Genetic_Programming_para_Modelagem_MIMO_Nao_Linear_das_Vibracoes_de_uma_Aeronave_F16_no_Solo/links/69820b695d60ab48356a7d4f/Multi-Gene-Genetic-Programming-para-Modelagem-MIMO-Nao-Linear-das-Vibracoes-de-uma-Aeronave-F16-no-Solo.pdf)
+
+
+**A Novel MIMO Multi-Gene Genetic Programming Approach for Interpretable NARX Models: an application to vehicle state estimation**
+
+> HENRIQUE GROENNER BARBOSA, Bruno et al. A Novel MIMO Multi-Gene Genetic Programming Approach for Interpretable NARX Models: an application to vehicle state estimation. Henrique and Ávila Santos, Rafael and Correa Victorino, Alessandro and Askari, Hassan and Xu, Nan, A Novel MIMO Multi-Gene Genetic Programming Approach for Interpretable NARX Models: an application to vehicle state estimation.*
+
+[📄 Download PDF](https://doi.org/10.2139/ssrn.5946034)
+
+## 🤝 Contributing
+
+Contributions are welcome! Feel free to open issues or submit pull requests.

mggpy-0.0.3/pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["setuptools>=61", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "mggpy"
+version = "0.0.3"
+description = "Multi-Gene Genetic Programming for system identification and regression"
+
+license = {text = "MIT"}
+authors = [
+    {name = "Rafael Avila", email = "rafael.santos0t5@gmail.com"},
+    {name = "Henrique Castro", email = "henriquec.castro@outlook.com"},
+]
+readme = "README.md"
+requires-python = ">=3.10"
+
+dependencies = [
+    "numpy>=1.26",
+    "deap>=1.4",
+    "tqdm>=4.67",
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+addopts = "--cov=mggp --cov-report=term-missing"

mggpy-0.0.3/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

mggpy-0.0.3/src/mggp/__init__.py

@@ -0,0 +1,3 @@
+from .mggp import MGGP
+
+__all__ = ["MGGP"]