QFIE 1.2.1__tar.gz

qfie-1.2.1/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Quasar-UniNA
+
+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.

qfie-1.2.1/PKG-INFO

@@ -0,0 +1,175 @@
+Metadata-Version: 2.4
+Name: QFIE
+Version: 1.2.1
+Summary: Quantum Fuzzy Inference Engines with Python
+Home-page: https://github.com/Quasar-UniNA/QFIE
+Author: R. Schiattarella
+Author-email: roberto.schiattarella@unina.it
+Project-URL: Documentation, https://qfie.readthedocs.io/en/latest/
+Project-URL: Source, https://github.com/Quasar-UniNA/QFIE
+Project-URL: Issue Tracker, https://github.com/Quasar-UniNA/QFIE/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Science/Research
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Scientific/Engineering :: Quantum Computing
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE.md
+Requires-Dist: numpy
+Requires-Dist: packaging
+Requires-Dist: qiskit<3.0,>=1.0.2
+Requires-Dist: qiskit-aer<1.0,>=0.14.2
+Requires-Dist: scikit-fuzzy>=0.4.2
+Requires-Dist: sympy>=1.9
+Provides-Extra: examples
+Requires-Dist: matplotlib; extra == "examples"
+Requires-Dist: jupyter==1.0.0; extra == "examples"
+Provides-Extra: docs
+Requires-Dist: sphinx>=5.1.1; extra == "docs"
+Requires-Dist: sphinx-rtd-theme>=1.0.0; extra == "docs"
+Requires-Dist: sphinxcontrib-napoleon>=0.7; extra == "docs"
+Requires-Dist: nbsphinx>=0.8.9; extra == "docs"
+Provides-Extra: ibm
+Requires-Dist: qiskit-ibm-runtime; extra == "ibm"
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: license-file
+
+# Quantum Fuzzy Inference Engine
+
+[![Made at QuasarLab](https://img.shields.io/badge/UniNA-QuasarLab-blue)](http://quasar.unina.it)
+[![Documentation](https://img.shields.io/badge/docs-Read_the_Docs-brightgreen)](https://qfie.readthedocs.io/en/latest/)
+[![Related paper](https://img.shields.io/badge/paper-IEEE-orange)](https://doi.org/10.1109/TFUZZ.2022.3202348)
+
+QFIE is a Python package for building and executing Quantum Fuzzy Inference
+Engines. It implements the approach introduced in *On the Implementation of
+Fuzzy Inference Engines on Quantum Computers*.
+
+## Installation
+
+QFIE requires Python 3.10 or later. Install the package from PyPI with:
+
+```bash
+pip install QFIE
+```
+
+
+
+To install the latest development version directly from the repository:
+
+```bash
+pip install "git+https://github.com/Quasar-UniNA/QFIE.git"
+```
+
+The complete user guide and examples are available in the
+[QFIE documentation](https://qfie.readthedocs.io/en/latest/).
+
+## Research using QFIE
+
+QFIE has been used in several application domains and extensions:
+
+- Particle accelerator control at CERN:
+  [*Quantum Fuzzy Inference Engine for Particle Accelerator Control*](https://doi.org/10.1109/TQE.2024.3374251),
+  IEEE Transactions on Quantum Engineering, 2024.
+- Edge detection on real NISQ hardware:
+  [*Quantum Fuzzy Logic for Edge Detection: A Demonstration on NISQ Hardware*](https://doi.org/10.1016/j.asoc.2025.113866),
+  Applied Soft Computing, 2025.
+- Control systems for smart cities:
+  [*Using Quantum Fuzzy Inference Engines in Smart Cities*](https://doi.org/10.1109/FUZZ-IEEE60900.2024.10611863),
+  FUZZ-IEEE 2024.
+- Interval type-2 Mamdani fuzzy systems:
+  [*Hybrid Quantum-Classical Interval Type-2 Mamdani Fuzzy Systems*](https://doi.org/10.1109/FUZZ62266.2025.11152074),
+  FUZZ-IEEE 2025.
+- Distribution across multiple NISQ devices:
+  [*Distributing Fuzzy Inference Engines on Quantum Computers*](https://doi.org/10.1109/FUZZ52849.2023.10309786),
+  FUZZ-IEEE 2023.
+
+## Citation
+
+If you use QFIE in your research, please cite the foundational paper:
+
+```bibtex
+@article{acampora2023implementation,
+  author  = {Acampora, Giovanni and Schiattarella, Roberto and Vitiello, Autilia},
+  title   = {On the Implementation of Fuzzy Inference Engines on Quantum Computers},
+  journal = {IEEE Transactions on Fuzzy Systems},
+  volume  = {31},
+  number  = {5},
+  pages   = {1419--1433},
+  year    = {2023},
+  doi     = {10.1109/TFUZZ.2022.3202348}
+}
+```
+
+<details>
+<summary>BibTeX entries for QFIE applications and extensions</summary>
+
+```bibtex
+@article{acampora2024quantum,
+  author    = {Acampora, Giovanni and Grossi, Michele and Schenk, Michael and Schiattarella, Roberto},
+  title     = {Quantum Fuzzy Inference Engine for Particle Accelerator Control},
+  journal   = {IEEE Transactions on Quantum Engineering},
+  volume    = {5},
+  pages     = {1--13},
+  year      = {2024},
+  publisher = {IEEE},
+  doi       = {10.1109/TQE.2024.3374251}
+}
+
+@article{nunziata2025quantum,
+  author    = {Nunziata, G. and Crisci, S. and De Gregorio, G. and Schiattarella, R. and Acampora, G. and Coraggio, L. and Itaco, N.},
+  title     = {Quantum Fuzzy Logic for Edge Detection: A Demonstration on {NISQ} Hardware},
+  journal   = {Applied Soft Computing},
+  volume    = {185},
+  pages     = {113866},
+  year      = {2025},
+  publisher = {Elsevier},
+  doi       = {10.1016/j.asoc.2025.113866}
+}
+
+@inproceedings{acampora2024using,
+  author    = {Acampora, Giovanni and Schiattarella, Roberto and Vitiello, Autilia},
+  title     = {Using Quantum Fuzzy Inference Engines in Smart Cities},
+  booktitle = {2024 IEEE International Conference on Fuzzy Systems (FUZZ-IEEE)},
+  pages     = {1--8},
+  year      = {2024},
+  organization = {IEEE},
+  doi       = {10.1109/FUZZ-IEEE60900.2024.10611863}
+}
+
+@inproceedings{acampora2025hybrid,
+  author    = {Acampora, Giovanni and Schiattarella, Roberto and Vitiello, Autilia},
+  title     = {Hybrid Quantum-Classical Interval Type-2 Mamdani Fuzzy Systems},
+  booktitle = {2025 IEEE International Conference on Fuzzy Systems (FUZZ)},
+  pages     = {1--6},
+  year      = {2025},
+  organization = {IEEE},
+  doi       = {10.1109/FUZZ62266.2025.11152074}
+}
+
+@inproceedings{acampora2023distributing,
+  author    = {Acampora, Giovanni and Massa, Alfredo and Schiattarella, Roberto and Vitiello, Autilia},
+  title     = {Distributing Fuzzy Inference Engines on Quantum Computers},
+  booktitle = {2023 IEEE International Conference on Fuzzy Systems (FUZZ)},
+  pages     = {1--6},
+  year      = {2023},
+  organization = {IEEE},
+  doi       = {10.1109/FUZZ52849.2023.10309786}
+}
+```
+
+</details>
+
+## License
+
+QFIE is distributed under the [MIT License](LICENSE.md).

qfie-1.2.1/README.md

@@ -0,0 +1,128 @@
+# Quantum Fuzzy Inference Engine
+
+[![Made at QuasarLab](https://img.shields.io/badge/UniNA-QuasarLab-blue)](http://quasar.unina.it)
+[![Documentation](https://img.shields.io/badge/docs-Read_the_Docs-brightgreen)](https://qfie.readthedocs.io/en/latest/)
+[![Related paper](https://img.shields.io/badge/paper-IEEE-orange)](https://doi.org/10.1109/TFUZZ.2022.3202348)
+
+QFIE is a Python package for building and executing Quantum Fuzzy Inference
+Engines. It implements the approach introduced in *On the Implementation of
+Fuzzy Inference Engines on Quantum Computers*.
+
+## Installation
+
+QFIE requires Python 3.10 or later. Install the package from PyPI with:
+
+```bash
+pip install QFIE
+```
+
+
+
+To install the latest development version directly from the repository:
+
+```bash
+pip install "git+https://github.com/Quasar-UniNA/QFIE.git"
+```
+
+The complete user guide and examples are available in the
+[QFIE documentation](https://qfie.readthedocs.io/en/latest/).
+
+## Research using QFIE
+
+QFIE has been used in several application domains and extensions:
+
+- Particle accelerator control at CERN:
+  [*Quantum Fuzzy Inference Engine for Particle Accelerator Control*](https://doi.org/10.1109/TQE.2024.3374251),
+  IEEE Transactions on Quantum Engineering, 2024.
+- Edge detection on real NISQ hardware:
+  [*Quantum Fuzzy Logic for Edge Detection: A Demonstration on NISQ Hardware*](https://doi.org/10.1016/j.asoc.2025.113866),
+  Applied Soft Computing, 2025.
+- Control systems for smart cities:
+  [*Using Quantum Fuzzy Inference Engines in Smart Cities*](https://doi.org/10.1109/FUZZ-IEEE60900.2024.10611863),
+  FUZZ-IEEE 2024.
+- Interval type-2 Mamdani fuzzy systems:
+  [*Hybrid Quantum-Classical Interval Type-2 Mamdani Fuzzy Systems*](https://doi.org/10.1109/FUZZ62266.2025.11152074),
+  FUZZ-IEEE 2025.
+- Distribution across multiple NISQ devices:
+  [*Distributing Fuzzy Inference Engines on Quantum Computers*](https://doi.org/10.1109/FUZZ52849.2023.10309786),
+  FUZZ-IEEE 2023.
+
+## Citation
+
+If you use QFIE in your research, please cite the foundational paper:
+
+```bibtex
+@article{acampora2023implementation,
+  author  = {Acampora, Giovanni and Schiattarella, Roberto and Vitiello, Autilia},
+  title   = {On the Implementation of Fuzzy Inference Engines on Quantum Computers},
+  journal = {IEEE Transactions on Fuzzy Systems},
+  volume  = {31},
+  number  = {5},
+  pages   = {1419--1433},
+  year    = {2023},
+  doi     = {10.1109/TFUZZ.2022.3202348}
+}
+```
+
+<details>
+<summary>BibTeX entries for QFIE applications and extensions</summary>
+
+```bibtex
+@article{acampora2024quantum,
+  author    = {Acampora, Giovanni and Grossi, Michele and Schenk, Michael and Schiattarella, Roberto},
+  title     = {Quantum Fuzzy Inference Engine for Particle Accelerator Control},
+  journal   = {IEEE Transactions on Quantum Engineering},
+  volume    = {5},
+  pages     = {1--13},
+  year      = {2024},
+  publisher = {IEEE},
+  doi       = {10.1109/TQE.2024.3374251}
+}
+
+@article{nunziata2025quantum,
+  author    = {Nunziata, G. and Crisci, S. and De Gregorio, G. and Schiattarella, R. and Acampora, G. and Coraggio, L. and Itaco, N.},
+  title     = {Quantum Fuzzy Logic for Edge Detection: A Demonstration on {NISQ} Hardware},
+  journal   = {Applied Soft Computing},
+  volume    = {185},
+  pages     = {113866},
+  year      = {2025},
+  publisher = {Elsevier},
+  doi       = {10.1016/j.asoc.2025.113866}
+}
+
+@inproceedings{acampora2024using,
+  author    = {Acampora, Giovanni and Schiattarella, Roberto and Vitiello, Autilia},
+  title     = {Using Quantum Fuzzy Inference Engines in Smart Cities},
+  booktitle = {2024 IEEE International Conference on Fuzzy Systems (FUZZ-IEEE)},
+  pages     = {1--8},
+  year      = {2024},
+  organization = {IEEE},
+  doi       = {10.1109/FUZZ-IEEE60900.2024.10611863}
+}
+
+@inproceedings{acampora2025hybrid,
+  author    = {Acampora, Giovanni and Schiattarella, Roberto and Vitiello, Autilia},
+  title     = {Hybrid Quantum-Classical Interval Type-2 Mamdani Fuzzy Systems},
+  booktitle = {2025 IEEE International Conference on Fuzzy Systems (FUZZ)},
+  pages     = {1--6},
+  year      = {2025},
+  organization = {IEEE},
+  doi       = {10.1109/FUZZ62266.2025.11152074}
+}
+
+@inproceedings{acampora2023distributing,
+  author    = {Acampora, Giovanni and Massa, Alfredo and Schiattarella, Roberto and Vitiello, Autilia},
+  title     = {Distributing Fuzzy Inference Engines on Quantum Computers},
+  booktitle = {2023 IEEE International Conference on Fuzzy Systems (FUZZ)},
+  pages     = {1--6},
+  year      = {2023},
+  organization = {IEEE},
+  doi       = {10.1109/FUZZ52849.2023.10309786}
+}
+```
+
+</details>
+
+## License
+
+QFIE is distributed under the [MIT License](LICENSE.md).

qfie-1.2.1/pyproject.toml

@@ -0,0 +1,11 @@
+[build-system]
+requires = [
+    "setuptools>=42",
+    "wheel"
+]
+build-backend = "setuptools.build_meta"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]
+addopts = "-ra"

qfie-1.2.1/setup.cfg

@@ -0,0 +1,65 @@
+[metadata]
+name = QFIE
+version = attr: QFIE.__version__
+author = R. Schiattarella
+author_email = roberto.schiattarella@unina.it
+description = Quantum Fuzzy Inference Engines with Python
+long_description = file: README.md
+long_description_content_type = text/markdown
+license_files = LICENSE.md
+url = https://github.com/Quasar-UniNA/QFIE
+project_urls = 
+	Documentation = https://qfie.readthedocs.io/en/latest/
+	Source = https://github.com/Quasar-UniNA/QFIE
+	Issue Tracker = https://github.com/Quasar-UniNA/QFIE/issues
+classifiers = 
+	Programming Language :: Python :: 3
+	Programming Language :: Python :: 3.10
+	Programming Language :: Python :: 3.11
+	Programming Language :: Python :: 3.12
+	Programming Language :: Python :: 3.13
+	Programming Language :: Python :: 3.14
+	License :: OSI Approved :: MIT License
+	Operating System :: OS Independent
+	Intended Audience :: Science/Research
+	Topic :: Scientific/Engineering :: Artificial Intelligence
+	Topic :: Scientific/Engineering :: Quantum Computing
+	Topic :: Software Development :: Libraries :: Python Modules
+
+[options]
+zip_safe = False
+package_dir = 
+	=src
+packages = find:
+python_requires = >=3.10
+install_requires = 
+	numpy
+	packaging
+	qiskit>=1.0.2,<3.0
+	qiskit-aer>=0.14.2,<1.0
+	scikit-fuzzy>=0.4.2
+	sympy>=1.9
+
+[options.packages.find]
+where = src
+
+[options.extras_require]
+examples = 
+	matplotlib
+	jupyter==1.0.0
+docs = 
+	sphinx>=5.1.1
+	sphinx-rtd-theme>=1.0.0
+	sphinxcontrib-napoleon>=0.7
+	nbsphinx>=0.8.9
+ibm = 
+	qiskit-ibm-runtime
+dev = 
+	build
+	pytest
+	twine
+
+[egg_info]
+tag_build = 
+tag_date = 0
+