From b48b75dbbe580071224c30a13fd69ec45079f368 Mon Sep 17 00:00:00 2001 From: firefly-cpp Date: Fri, 2 Sep 2022 14:46:53 +0200 Subject: [PATCH 01/51] Update CHANGELOG --- CHANGELOG.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 889f435..af1306e 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,13 @@ # Changelog +## [0.3.2](https://github.com/firefly-cpp/FireflyAlgorithm/tree/0.3.2) (2022-07-12) + +[Full Changelog](https://github.com/firefly-cpp/FireflyAlgorithm/compare/0.3.1...0.3.2) + +**Merged pull requests:** + +- Rename project name in pyproject.toml [\#9](https://github.com/firefly-cpp/FireflyAlgorithm/pull/9) ([firefly-cpp](https://github.com/firefly-cpp)) + ## [0.3.1](https://github.com/firefly-cpp/FireflyAlgorithm/tree/0.3.1) (2022-06-05) [Full Changelog](https://github.com/firefly-cpp/FireflyAlgorithm/compare/0.3...0.3.1) From 4e569f6a5df4f8142551d0b5eb5f00a969a440d8 Mon Sep 17 00:00:00 2001 From: Iztok Fister Jr Date: Thu, 13 Oct 2022 14:29:34 +0200 Subject: [PATCH 02/51] Update dependencies --- poetry.lock | 214 ++++++++++++++++++++++++++++++++++++------------- pyproject.toml | 2 +- 2 files changed, 158 insertions(+), 58 deletions(-) diff --git a/poetry.lock b/poetry.lock index 01061cd..ab8f0d2 100644 --- a/poetry.lock +++ b/poetry.lock @@ -1,6 +1,53 @@ +[[package]] +name = "attrs" +version = "22.1.0" +description = "Classes Without Boilerplate" +category = "dev" +optional = false +python-versions = ">=3.5" + +[package.extras] +dev = ["coverage[toml] (>=5.0.2)", "hypothesis", "pympler", "pytest (>=4.3.0)", "mypy (>=0.900,!=0.940)", "pytest-mypy-plugins", "zope.interface", "furo", "sphinx", "sphinx-notfound-page", "pre-commit", "cloudpickle"] +docs = ["furo", "sphinx", "zope.interface", "sphinx-notfound-page"] +tests = ["coverage[toml] (>=5.0.2)", "hypothesis", "pympler", "pytest (>=4.3.0)", "mypy (>=0.900,!=0.940)", "pytest-mypy-plugins", "zope.interface", "cloudpickle"] +tests_no_zope = ["coverage[toml] (>=5.0.2)", "hypothesis", "pympler", "pytest (>=4.3.0)", "mypy (>=0.900,!=0.940)", "pytest-mypy-plugins", "cloudpickle"] + +[[package]] +name = "colorama" +version = "0.4.5" +description = "Cross-platform colored terminal text." +category = "dev" +optional = false +python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*" + +[[package]] +name = "importlib-metadata" +version = "5.0.0" +description = "Read metadata from Python packages" +category = "dev" +optional = false +python-versions = ">=3.7" + +[package.dependencies] +typing-extensions = {version = ">=3.6.4", markers = "python_version < \"3.8\""} +zipp = ">=0.5" + +[package.extras] +docs = ["sphinx (>=3.5)", "jaraco.packaging (>=9)", "rst.linker (>=1.9)", "furo", "jaraco.tidelift (>=1.4)"] +perf = ["ipython"] +testing = ["pytest (>=6)", "pytest-checkdocs (>=2.4)", "pytest-flake8", "flake8 (<5)", "pytest-cov", "pytest-enabler (>=1.3)", "packaging", "pyfakefs", "flufl.flake8", "pytest-perf (>=0.9.2)", "pytest-black (>=0.3.7)", "pytest-mypy (>=0.9.1)", "importlib-resources (>=1.3)"] + +[[package]] +name = "iniconfig" +version = "1.1.1" +description = "iniconfig: brain-dead simple config-ini parsing" +category = "dev" +optional = false +python-versions = "*" + [[package]] name = "numpy" -version = "1.21.5" +version = "1.21.6" description = "NumPy is the fundamental package for array computing with Python." category = "main" optional = false @@ -8,69 +55,122 @@ python-versions = ">=3.7,<3.11" [[package]] name = "numpy" -version = "1.22.0" +version = "1.23.4" description = "NumPy is the fundamental package for array computing with Python." category = "main" optional = false python-versions = ">=3.8" +[[package]] +name = "packaging" +version = "21.3" +description = "Core utilities for Python packages" +category = "dev" +optional = false +python-versions = ">=3.6" + +[package.dependencies] +pyparsing = ">=2.0.2,<3.0.5 || >3.0.5" + +[[package]] +name = "pluggy" +version = "1.0.0" +description = "plugin and hook calling mechanisms for python" +category = "dev" +optional = false +python-versions = ">=3.6" + +[package.dependencies] +importlib-metadata = {version = ">=0.12", markers = "python_version < \"3.8\""} + +[package.extras] +testing = ["pytest-benchmark", "pytest"] +dev = ["tox", "pre-commit"] + +[[package]] +name = "py" +version = "1.11.0" +description = "library with cross-python path, ini-parsing, io, code, log facilities" +category = "dev" +optional = false +python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*" + +[[package]] +name = "pyparsing" +version = "3.0.9" +description = "pyparsing module - Classes and methods to define and execute parsing grammars" +category = "dev" +optional = false +python-versions = ">=3.6.8" + +[package.extras] +diagrams = ["railroad-diagrams", "jinja2"] + +[[package]] +name = "pytest" +version = "7.1.3" +description = "pytest: simple powerful testing with Python" +category = "dev" +optional = false +python-versions = ">=3.7" + +[package.dependencies] +attrs = ">=19.2.0" +colorama = {version = "*", markers = "sys_platform == \"win32\""} +importlib-metadata = {version = ">=0.12", markers = "python_version < \"3.8\""} +iniconfig = "*" +packaging = "*" +pluggy = ">=0.12,<2.0" +py = ">=1.8.2" +tomli = ">=1.0.0" + +[package.extras] +testing = ["argcomplete", "hypothesis (>=3.56)", "mock", "nose", "pygments (>=2.7.2)", "requests", "xmlschema"] + +[[package]] +name = "tomli" +version = "2.0.1" +description = "A lil' TOML parser" +category = "dev" +optional = false +python-versions = ">=3.7" + +[[package]] +name = "typing-extensions" +version = "4.4.0" +description = "Backported and Experimental Type Hints for Python 3.7+" +category = "dev" +optional = false +python-versions = ">=3.7" + +[[package]] +name = "zipp" +version = "3.9.0" +description = "Backport of pathlib-compatible object wrapper for zip files" +category = "dev" +optional = false +python-versions = ">=3.7" + +[package.extras] +docs = ["sphinx (>=3.5)", "jaraco.packaging (>=9)", "rst.linker (>=1.9)", "furo", "jaraco.tidelift (>=1.4)"] +testing = ["pytest (>=6)", "pytest-checkdocs (>=2.4)", "pytest-flake8", "flake8 (<5)", "pytest-cov", "pytest-enabler (>=1.3)", "jaraco.itertools", "func-timeout", "jaraco.functools", "more-itertools", "pytest-black (>=0.3.7)", "pytest-mypy (>=0.9.1)"] + [metadata] lock-version = "1.1" python-versions = "^3.7" -content-hash = "e578f616a2df32b9a4a3e27da71545e65bd1ae9544982e3067f8363e69bf7136" +content-hash = "7886afe25f44148269aae9b5a98e0030046b4c5d7b8ad6a1c9dc6be8a57e1219" [metadata.files] -numpy = [ - {file = "numpy-1.21.5-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:301e408a052fdcda5cdcf03021ebafc3c6ea093021bf9d1aa47c54d48bdad166"}, - {file = "numpy-1.21.5-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:a7e8f6216f180f3fd4efb73de5d1eaefb5f5a1ee5b645c67333033e39440e63a"}, - {file = "numpy-1.21.5-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:fc7a7d7b0ed72589fd8b8486b9b42a564f10b8762be8bd4d9df94b807af4a089"}, - {file = "numpy-1.21.5-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:58ca1d7c8aef6e996112d0ce873ac9dfa1eaf4a1196b4ff7ff73880a09923ba7"}, - {file = "numpy-1.21.5-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:dc4b2fb01f1b4ddbe2453468ea0719f4dbb1f5caa712c8b21bb3dd1480cd30d9"}, - {file = "numpy-1.21.5-cp310-cp310-win_amd64.whl", hash = "sha256:cc1b30205d138d1005adb52087ff45708febbef0e420386f58664f984ef56954"}, - {file = "numpy-1.21.5-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:08de8472d9f7571f9d51b27b75e827f5296295fa78817032e84464be8bb905bc"}, - {file = "numpy-1.21.5-cp37-cp37m-manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:4fe6a006557b87b352c04596a6e3f12a57d6e5f401d804947bd3188e6b0e0e76"}, - {file = "numpy-1.21.5-cp37-cp37m-manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:3d893b0871322eaa2f8c7072cdb552d8e2b27645b7875a70833c31e9274d4611"}, - {file = "numpy-1.21.5-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:341dddcfe3b7b6427a28a27baa59af5ad51baa59bfec3264f1ab287aa3b30b13"}, - {file = "numpy-1.21.5-cp37-cp37m-win32.whl", hash = "sha256:ca9c23848292c6fe0a19d212790e62f398fd9609aaa838859be8459bfbe558aa"}, - {file = "numpy-1.21.5-cp37-cp37m-win_amd64.whl", hash = "sha256:025b497014bc33fc23897859350f284323f32a2fff7654697f5a5fc2a19e9939"}, - {file = "numpy-1.21.5-cp38-cp38-macosx_10_9_universal2.whl", hash = "sha256:3a5098df115340fb17fc93867317a947e1dcd978c3888c5ddb118366095851f8"}, - {file = "numpy-1.21.5-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:311283acf880cfcc20369201bd75da907909afc4666966c7895cbed6f9d2c640"}, - {file = "numpy-1.21.5-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:b545ebadaa2b878c8630e5bcdb97fc4096e779f335fc0f943547c1c91540c815"}, - {file = "numpy-1.21.5-cp38-cp38-manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:c5562bcc1a9b61960fc8950ade44d00e3de28f891af0acc96307c73613d18f6e"}, - {file = "numpy-1.21.5-cp38-cp38-manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:eed2afaa97ec33b4411995be12f8bdb95c87984eaa28d76cf628970c8a2d689a"}, - {file = "numpy-1.21.5-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:61bada43d494515d5b122f4532af226fdb5ee08fe5b5918b111279843dc6836a"}, - {file = "numpy-1.21.5-cp38-cp38-win32.whl", hash = "sha256:7b9d6b14fc9a4864b08d1ba57d732b248f0e482c7b2ff55c313137e3ed4d8449"}, - {file = "numpy-1.21.5-cp38-cp38-win_amd64.whl", hash = "sha256:dbce7adeb66b895c6aaa1fad796aaefc299ced597f6fbd9ceddb0dd735245354"}, - {file = "numpy-1.21.5-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:507c05c7a37b3683eb08a3ff993bd1ee1e6c752f77c2f275260533b265ecdb6c"}, - {file = "numpy-1.21.5-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:00c9fa73a6989895b8815d98300a20ac993c49ac36c8277e8ffeaa3631c0dbbb"}, - {file = "numpy-1.21.5-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:69a5a8d71c308d7ef33ef72371c2388a90e3495dbb7993430e674006f94797d5"}, - {file = "numpy-1.21.5-cp39-cp39-manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:2d8adfca843bc46ac199a4645233f13abf2011a0b2f4affc5c37cd552626f27b"}, - {file = "numpy-1.21.5-cp39-cp39-manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:c293d3c0321996cd8ffe84215ffe5d269fd9d1d12c6f4ffe2b597a7c30d3e593"}, - {file = "numpy-1.21.5-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3c978544be9e04ed12016dd295a74283773149b48f507d69b36f91aa90a643e5"}, - {file = "numpy-1.21.5-cp39-cp39-win32.whl", hash = "sha256:2a9add27d7fc0fdb572abc3b2486eb3b1395da71e0254c5552b2aad2a18b5441"}, - {file = "numpy-1.21.5-cp39-cp39-win_amd64.whl", hash = "sha256:1964db2d4a00348b7a60ee9d013c8cb0c566644a589eaa80995126eac3b99ced"}, - {file = "numpy-1.21.5-pp37-pypy37_pp73-manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:a7c4b701ca418cd39e28ec3b496e6388fe06de83f5f0cb74794fa31cfa384c02"}, - {file = "numpy-1.21.5.zip", hash = "sha256:6a5928bc6241264dce5ed509e66f33676fc97f464e7a919edc672fb5532221ee"}, - {file = "numpy-1.22.0-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:3d22662b4b10112c545c91a0741f2436f8ca979ab3d69d03d19322aa970f9695"}, - {file = "numpy-1.22.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:11a1f3816ea82eed4178102c56281782690ab5993251fdfd75039aad4d20385f"}, - {file = "numpy-1.22.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:5dc65644f75a4c2970f21394ad8bea1a844104f0fe01f278631be1c7eae27226"}, - {file = "numpy-1.22.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:42c16cec1c8cf2728f1d539bd55aaa9d6bb48a7de2f41eb944697293ef65a559"}, - {file = "numpy-1.22.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:a97e82c39d9856fe7d4f9b86d8a1e66eff99cf3a8b7ba48202f659703d27c46f"}, - {file = "numpy-1.22.0-cp310-cp310-win_amd64.whl", hash = "sha256:e41e8951749c4b5c9a2dc5fdbc1a4eec6ab2a140fdae9b460b0f557eed870f4d"}, - {file = "numpy-1.22.0-cp38-cp38-macosx_10_9_universal2.whl", hash = "sha256:bece0a4a49e60e472a6d1f70ac6cdea00f9ab80ff01132f96bd970cdd8a9e5a9"}, - {file = "numpy-1.22.0-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:818b9be7900e8dc23e013a92779135623476f44a0de58b40c32a15368c01d471"}, - {file = "numpy-1.22.0-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:47ee7a839f5885bc0c63a74aabb91f6f40d7d7b639253768c4199b37aede7982"}, - {file = "numpy-1.22.0-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:a024181d7aef0004d76fb3bce2a4c9f2e67a609a9e2a6ff2571d30e9976aa383"}, - {file = "numpy-1.22.0-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f71d57cc8645f14816ae249407d309be250ad8de93ef61d9709b45a0ddf4050c"}, - {file = "numpy-1.22.0-cp38-cp38-win32.whl", hash = "sha256:283d9de87c0133ef98f93dfc09fad3fb382f2a15580de75c02b5bb36a5a159a5"}, - {file = "numpy-1.22.0-cp38-cp38-win_amd64.whl", hash = "sha256:2762331de395739c91f1abb88041f94a080cb1143aeec791b3b223976228af3f"}, - {file = "numpy-1.22.0-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:76ba7c40e80f9dc815c5e896330700fd6e20814e69da9c1267d65a4d051080f1"}, - {file = "numpy-1.22.0-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:0cfe07133fd00b27edee5e6385e333e9eeb010607e8a46e1cd673f05f8596595"}, - {file = "numpy-1.22.0-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:6ed0d073a9c54ac40c41a9c2d53fcc3d4d4ed607670b9e7b0de1ba13b4cbfe6f"}, - {file = "numpy-1.22.0-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:41388e32e40b41dd56eb37fcaa7488b2b47b0adf77c66154d6b89622c110dfe9"}, - {file = "numpy-1.22.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:b55b953a1bdb465f4dc181758570d321db4ac23005f90ffd2b434cc6609a63dd"}, - {file = "numpy-1.22.0-cp39-cp39-win32.whl", hash = "sha256:5a311ee4d983c487a0ab546708edbdd759393a3dc9cd30305170149fedd23c88"}, - {file = "numpy-1.22.0-cp39-cp39-win_amd64.whl", hash = "sha256:a97a954a8c2f046d3817c2bce16e3c7e9a9c2afffaf0400f5c16df5172a67c9c"}, - {file = "numpy-1.22.0-pp38-pypy38_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:bb02929b0d6bfab4c48a79bd805bd7419114606947ec8284476167415171f55b"}, - {file = "numpy-1.22.0.zip", hash = "sha256:a955e4128ac36797aaffd49ab44ec74a71c11d6938df83b1285492d277db5397"}, -] +attrs = [] +colorama = [] +importlib-metadata = [] +iniconfig = [] +numpy = [] +packaging = [] +pluggy = [] +py = [] +pyparsing = [] +pytest = [] +tomli = [] +typing-extensions = [] +zipp = [] diff --git a/pyproject.toml b/pyproject.toml index ef08843..50b5891 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -22,5 +22,5 @@ numpy = [ pytest = "^7.0.1" [build-system] -requires = ["poetry-core>=1.0.0"] +requires = ["poetry-core"] build-backend = "poetry.core.masonry.api" From da812c5ac9ecc10fee0631f7e77398f2525bcf3d Mon Sep 17 00:00:00 2001 From: firefly-cpp Date: Mon, 31 Oct 2022 21:58:40 +0100 Subject: [PATCH 03/51] Update metadata in pyproject --- pyproject.toml | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/pyproject.toml b/pyproject.toml index 50b5891..32e00fa 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -2,15 +2,16 @@ name = "fireflyalgorithm" version = "0.3.2" description = "Implementation of Firefly Algorithm in Python" -authors = ["firefly-cpp"] +authors = ["Iztok Fister Jr. ", "Luka Pečnik ", "Žiga Stupan "] license = "MIT" readme = "README.md" +homepage = "https://github.com/firefly-cpp/FireflyAlgorithm" +repository = "https://github.com/firefly-cpp/FireflyAlgorithm" include = [ { path="LICENSE", format="sdist" } ] - [tool.poetry.dependencies] python = "^3.7" numpy = [ From 7c98c7f0e0611cd9cc3de8ce654c3f6d3c00c0c2 Mon Sep 17 00:00:00 2001 From: firefly-cpp Date: Mon, 31 Oct 2022 22:02:30 +0100 Subject: [PATCH 04/51] Update pyproject & bump version --- fireflyalgorithm/__init__.py | 2 +- poetry.lock | 104 ++++++++++++++++++++++++++--------- pyproject.toml | 2 +- 3 files changed, 79 insertions(+), 29 deletions(-) diff --git a/fireflyalgorithm/__init__.py b/fireflyalgorithm/__init__.py index 7992490..fabf74c 100644 --- a/fireflyalgorithm/__init__.py +++ b/fireflyalgorithm/__init__.py @@ -2,4 +2,4 @@ __all__ = ['FireflyAlgorithm'] -__version__ = '0.3.2' +__version__ = '0.3.3' diff --git a/poetry.lock b/poetry.lock index ab8f0d2..883a10b 100644 --- a/poetry.lock +++ b/poetry.lock @@ -7,18 +7,29 @@ optional = false python-versions = ">=3.5" [package.extras] -dev = ["coverage[toml] (>=5.0.2)", "hypothesis", "pympler", "pytest (>=4.3.0)", "mypy (>=0.900,!=0.940)", "pytest-mypy-plugins", "zope.interface", "furo", "sphinx", "sphinx-notfound-page", "pre-commit", "cloudpickle"] -docs = ["furo", "sphinx", "zope.interface", "sphinx-notfound-page"] -tests = ["coverage[toml] (>=5.0.2)", "hypothesis", "pympler", "pytest (>=4.3.0)", "mypy (>=0.900,!=0.940)", "pytest-mypy-plugins", "zope.interface", "cloudpickle"] -tests_no_zope = ["coverage[toml] (>=5.0.2)", "hypothesis", "pympler", "pytest (>=4.3.0)", "mypy (>=0.900,!=0.940)", "pytest-mypy-plugins", "cloudpickle"] +tests_no_zope = ["cloudpickle", "pytest-mypy-plugins", "mypy (>=0.900,!=0.940)", "pytest (>=4.3.0)", "pympler", "hypothesis", "coverage[toml] (>=5.0.2)"] +tests = ["cloudpickle", "zope.interface", "pytest-mypy-plugins", "mypy (>=0.900,!=0.940)", "pytest (>=4.3.0)", "pympler", "hypothesis", "coverage[toml] (>=5.0.2)"] +docs = ["sphinx-notfound-page", "zope.interface", "sphinx", "furo"] +dev = ["cloudpickle", "pre-commit", "sphinx-notfound-page", "sphinx", "furo", "zope.interface", "pytest-mypy-plugins", "mypy (>=0.900,!=0.940)", "pytest (>=4.3.0)", "pympler", "hypothesis", "coverage[toml] (>=5.0.2)"] [[package]] name = "colorama" -version = "0.4.5" +version = "0.4.6" description = "Cross-platform colored terminal text." category = "dev" optional = false -python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*" +python-versions = "!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,!=3.5.*,!=3.6.*,>=2.7" + +[[package]] +name = "exceptiongroup" +version = "1.0.0" +description = "Backport of PEP 654 (exception groups)" +category = "dev" +optional = false +python-versions = ">=3.7" + +[package.extras] +test = ["pytest (>=6)"] [[package]] name = "importlib-metadata" @@ -84,16 +95,8 @@ python-versions = ">=3.6" importlib-metadata = {version = ">=0.12", markers = "python_version < \"3.8\""} [package.extras] -testing = ["pytest-benchmark", "pytest"] -dev = ["tox", "pre-commit"] - -[[package]] -name = "py" -version = "1.11.0" -description = "library with cross-python path, ini-parsing, io, code, log facilities" -category = "dev" -optional = false -python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*" +dev = ["pre-commit", "tox"] +testing = ["pytest", "pytest-benchmark"] [[package]] name = "pyparsing" @@ -108,7 +111,7 @@ diagrams = ["railroad-diagrams", "jinja2"] [[package]] name = "pytest" -version = "7.1.3" +version = "7.2.0" description = "pytest: simple powerful testing with Python" category = "dev" optional = false @@ -117,12 +120,12 @@ python-versions = ">=3.7" [package.dependencies] attrs = ">=19.2.0" colorama = {version = "*", markers = "sys_platform == \"win32\""} +exceptiongroup = {version = ">=1.0.0rc8", markers = "python_version < \"3.11\""} importlib-metadata = {version = ">=0.12", markers = "python_version < \"3.8\""} iniconfig = "*" packaging = "*" pluggy = ">=0.12,<2.0" -py = ">=1.8.2" -tomli = ">=1.0.0" +tomli = {version = ">=1.0.0", markers = "python_version < \"3.11\""} [package.extras] testing = ["argcomplete", "hypothesis (>=3.56)", "mock", "nose", "pygments (>=2.7.2)", "requests", "xmlschema"] @@ -145,7 +148,7 @@ python-versions = ">=3.7" [[package]] name = "zipp" -version = "3.9.0" +version = "3.10.0" description = "Backport of pathlib-compatible object wrapper for zip files" category = "dev" optional = false @@ -163,14 +166,61 @@ content-hash = "7886afe25f44148269aae9b5a98e0030046b4c5d7b8ad6a1c9dc6be8a57e1219 [metadata.files] attrs = [] colorama = [] +exceptiongroup = [] importlib-metadata = [] -iniconfig = [] -numpy = [] -packaging = [] -pluggy = [] -py = [] -pyparsing = [] +iniconfig = [ + {file = "iniconfig-1.1.1-py2.py3-none-any.whl", hash = "sha256:011e24c64b7f47f6ebd835bb12a743f2fbe9a26d4cecaa7f53bc4f35ee9da8b3"}, + {file = "iniconfig-1.1.1.tar.gz", hash = "sha256:bc3af051d7d14b2ee5ef9969666def0cd1a000e121eaea580d4a313df4b37f32"}, +] +numpy = [ + {file = "numpy-1.21.6-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:8737609c3bbdd48e380d463134a35ffad3b22dc56295eff6f79fd85bd0eeeb25"}, + {file = "numpy-1.21.6-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:fdffbfb6832cd0b300995a2b08b8f6fa9f6e856d562800fea9182316d99c4e8e"}, + {file = "numpy-1.21.6-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:3820724272f9913b597ccd13a467cc492a0da6b05df26ea09e78b171a0bb9da6"}, + {file = "numpy-1.21.6-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f17e562de9edf691a42ddb1eb4a5541c20dd3f9e65b09ded2beb0799c0cf29bb"}, + {file = "numpy-1.21.6-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:5f30427731561ce75d7048ac254dbe47a2ba576229250fb60f0fb74db96501a1"}, + {file = "numpy-1.21.6-cp310-cp310-win32.whl", hash = "sha256:d4bf4d43077db55589ffc9009c0ba0a94fa4908b9586d6ccce2e0b164c86303c"}, + {file = "numpy-1.21.6-cp310-cp310-win_amd64.whl", hash = "sha256:d136337ae3cc69aa5e447e78d8e1514be8c3ec9b54264e680cf0b4bd9011574f"}, + {file = "numpy-1.21.6-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:6aaf96c7f8cebc220cdfc03f1d5a31952f027dda050e5a703a0d1c396075e3e7"}, + {file = "numpy-1.21.6-cp37-cp37m-manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:67c261d6c0a9981820c3a149d255a76918278a6b03b6a036800359aba1256d46"}, + {file = "numpy-1.21.6-cp37-cp37m-manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:a6be4cb0ef3b8c9250c19cc122267263093eee7edd4e3fa75395dfda8c17a8e2"}, + {file = "numpy-1.21.6-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:7c4068a8c44014b2d55f3c3f574c376b2494ca9cc73d2f1bd692382b6dffe3db"}, + {file = "numpy-1.21.6-cp37-cp37m-win32.whl", hash = "sha256:7c7e5fa88d9ff656e067876e4736379cc962d185d5cd808014a8a928d529ef4e"}, + {file = "numpy-1.21.6-cp37-cp37m-win_amd64.whl", hash = "sha256:bcb238c9c96c00d3085b264e5c1a1207672577b93fa666c3b14a45240b14123a"}, + {file = "numpy-1.21.6-cp38-cp38-macosx_10_9_universal2.whl", hash = "sha256:82691fda7c3f77c90e62da69ae60b5ac08e87e775b09813559f8901a88266552"}, + {file = "numpy-1.21.6-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:643843bcc1c50526b3a71cd2ee561cf0d8773f062c8cbaf9ffac9fdf573f83ab"}, + {file = "numpy-1.21.6-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:357768c2e4451ac241465157a3e929b265dfac85d9214074985b1786244f2ef3"}, + {file = "numpy-1.21.6-cp38-cp38-manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:9f411b2c3f3d76bba0865b35a425157c5dcf54937f82bbeb3d3c180789dd66a6"}, + {file = "numpy-1.21.6-cp38-cp38-manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:4aa48afdce4660b0076a00d80afa54e8a97cd49f457d68a4342d188a09451c1a"}, + {file = "numpy-1.21.6-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:d6a96eef20f639e6a97d23e57dd0c1b1069a7b4fd7027482a4c5c451cd7732f4"}, + {file = "numpy-1.21.6-cp38-cp38-win32.whl", hash = "sha256:5c3c8def4230e1b959671eb959083661b4a0d2e9af93ee339c7dada6759a9470"}, + {file = "numpy-1.21.6-cp38-cp38-win_amd64.whl", hash = "sha256:bf2ec4b75d0e9356edea834d1de42b31fe11f726a81dfb2c2112bc1eaa508fcf"}, + {file = "numpy-1.21.6-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:4391bd07606be175aafd267ef9bea87cf1b8210c787666ce82073b05f202add1"}, + {file = "numpy-1.21.6-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:67f21981ba2f9d7ba9ade60c9e8cbaa8cf8e9ae51673934480e45cf55e953673"}, + {file = "numpy-1.21.6-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:ee5ec40fdd06d62fe5d4084bef4fd50fd4bb6bfd2bf519365f569dc470163ab0"}, + {file = "numpy-1.21.6-cp39-cp39-manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:1dbe1c91269f880e364526649a52eff93ac30035507ae980d2fed33aaee633ac"}, + {file = "numpy-1.21.6-cp39-cp39-manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:d9caa9d5e682102453d96a0ee10c7241b72859b01a941a397fd965f23b3e016b"}, + {file = "numpy-1.21.6-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:58459d3bad03343ac4b1b42ed14d571b8743dc80ccbf27444f266729df1d6f5b"}, + {file = "numpy-1.21.6-cp39-cp39-win32.whl", hash = "sha256:7f5ae4f304257569ef3b948810816bc87c9146e8c446053539947eedeaa32786"}, + {file = "numpy-1.21.6-cp39-cp39-win_amd64.whl", hash = "sha256:e31f0bb5928b793169b87e3d1e070f2342b22d5245c755e2b81caa29756246c3"}, + {file = "numpy-1.21.6-pp37-pypy37_pp73-manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:dd1c8f6bd65d07d3810b90d02eba7997e32abbdf1277a481d698969e921a3be0"}, + {file = "numpy-1.21.6.zip", hash = "sha256:ecb55251139706669fdec2ff073c98ef8e9a84473e51e716211b41aa0f18e656"}, +] +packaging = [ + {file = "packaging-21.3-py3-none-any.whl", hash = "sha256:ef103e05f519cdc783ae24ea4e2e0f508a9c99b2d4969652eed6a2e1ea5bd522"}, + {file = "packaging-21.3.tar.gz", hash = "sha256:dd47c42927d89ab911e606518907cc2d3a1f38bbd026385970643f9c5b8ecfeb"}, +] +pluggy = [ + {file = "pluggy-1.0.0-py2.py3-none-any.whl", hash = "sha256:74134bbf457f031a36d68416e1509f34bd5ccc019f0bcc952c7b909d06b37bd3"}, + {file = "pluggy-1.0.0.tar.gz", hash = "sha256:4224373bacce55f955a878bf9cfa763c1e360858e330072059e10bad68531159"}, +] +pyparsing = [ + {file = "pyparsing-3.0.9-py3-none-any.whl", hash = "sha256:5026bae9a10eeaefb61dab2f09052b9f4307d44aee4eda64b309723d8d206bbc"}, + {file = "pyparsing-3.0.9.tar.gz", hash = "sha256:2b020ecf7d21b687f219b71ecad3631f644a47f01403fa1d1036b0c6416d70fb"}, +] pytest = [] -tomli = [] +tomli = [ + {file = "tomli-2.0.1-py3-none-any.whl", hash = "sha256:939de3e7a6161af0c887ef91b7d41a53e7c5a1ca976325f429cb46ea9bc30ecc"}, + {file = "tomli-2.0.1.tar.gz", hash = "sha256:de526c12914f0c550d15924c62d72abc48d6fe7364aa87328337a31007fe8a4f"}, +] typing-extensions = [] zipp = [] diff --git a/pyproject.toml b/pyproject.toml index 32e00fa..b0a8e1a 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "fireflyalgorithm" -version = "0.3.2" +version = "0.3.3" description = "Implementation of Firefly Algorithm in Python" authors = ["Iztok Fister Jr. ", "Luka Pečnik ", "Žiga Stupan "] license = "MIT" From d5059010ff0a9e0f929b636ecf5cea7f8ee77f45 Mon Sep 17 00:00:00 2001 From: rhododendrom Date: Fri, 2 Dec 2022 13:34:07 +0100 Subject: [PATCH 05/51] logo add --- imgs/firefly_logo.png | Bin 0 -> 227599 bytes 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 imgs/firefly_logo.png diff --git a/imgs/firefly_logo.png b/imgs/firefly_logo.png new file mode 100644 index 0000000000000000000000000000000000000000..9a16dcda60fb22ded93f2cfa20df45a02b0eaa77 GIT binary patch literal 227599 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

` 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%0Dl;+pH4y`Iz zbPNG^!fxuU*1b&fW{MA6MAyVg;wex`08#**$8mV=)*9217aXXI4fp-e?rcBFOy(AA$?b8sx%! zAdM4c$*8829c9fs8*Hf;R&0&?+@ndpiepFcwP)BI&jpVk=n-4xZ6Q0*&>76#GVrzD zA!Du5q{Wq9OIbR90F#r(uMIXgF z2CWK|?!6VXb#3U&#Fjn$kEFk!QKtAz5)?G+FoMqhAY{BvTka(P{F|uSyJ>mXO2vhf z^I;EZ5j$2)aSsokp%^^!X?5wPx~MWS24D=~eQ)z2kL4E(<-@}gLbis?CAX*P)=lq> z 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 literal 0 HcmV?d00001 From df722c909f994fac2d8bad59f9baf7172d0c21d4 Mon Sep 17 00:00:00 2001 From: firefly-cpp Date: Sat, 3 Dec 2022 10:01:39 +0100 Subject: [PATCH 06/51] Update README --- README.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/README.md b/README.md index 83f0c30..7147906 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,9 @@ +

+ +

+ +--- + # Firefly Algorithm --- Implementation of Firefly algorithm in Python --- From 5c7e8ff8e9ad05edf01f5ce1a4c23f54c41709c5 Mon Sep 17 00:00:00 2001 From: firefly-cpp Date: Sat, 3 Dec 2022 10:03:17 +0100 Subject: [PATCH 07/51] Move files --- {imgs => .github/imgs}/firefly_logo.png | Bin 1 file changed, 0 insertions(+), 0 deletions(-) rename {imgs => .github/imgs}/firefly_logo.png (100%) diff --git a/imgs/firefly_logo.png b/.github/imgs/firefly_logo.png similarity index 100% rename from imgs/firefly_logo.png rename to .github/imgs/firefly_logo.png From eb9a42fd918d0095cd743b64e2db9d98a2869ff0 Mon Sep 17 00:00:00 2001 From: Iztok Fister Jr Date: Tue, 6 Dec 2022 13:51:37 +0100 Subject: [PATCH 08/51] Update README.md --- README.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/README.md b/README.md index 7147906..f4fbdda 100644 --- a/README.md +++ b/README.md @@ -50,6 +50,10 @@ Jozef Stefan Institute, Ljubljana, Slovenia, 2012 I. Fister, I. Fister Jr., X.-S. Yang, J. Brest. [A comprehensive review of firefly algorithms](http://www.iztok-jr-fister.eu/static/publications/23.pdf). Swarm and Evolutionary Computation 13 (2013): 34-46. +## License + +This package is distributed under the MIT License. This license can be found online at . + ## Disclaimer This framework is provided as-is, and there are no guarantees that it fits your purposes or that it is bug-free. Use it at your own risk! From 6d98ca42fdcfd3dde6e13eb36f2c8bc607350705 Mon Sep 17 00:00:00 2001 From: firefly-cpp Date: Tue, 13 Dec 2022 12:27:29 +0100 Subject: [PATCH 09/51] Update README --- README.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/README.md b/README.md index f4fbdda..48d016f 100644 --- a/README.md +++ b/README.md @@ -18,6 +18,10 @@ [![Percentage of issues still open](http://isitmaintained.com/badge/open/firefly-cpp/FireflyAlgorithm.svg)](http://isitmaintained.com/project/firefly-cpp/FireflyAlgorithm "Percentage of issues still open") ![GitHub contributors](https://img.shields.io/github/contributors/firefly-cpp/FireflyAlgorithm.svg) +## About + +This package implements a nature-inspired algorithm for optimization called Firefly Algorithm (FA) in Python programming language. + ## Installation: ```sh From 0d87e53673b3c995963aa68418cd7d3508562203 Mon Sep 17 00:00:00 2001 From: firefly-cpp Date: Tue, 13 Dec 2022 21:05:21 +0100 Subject: [PATCH 10/51] Bump version -> 0.3.4 --- fireflyalgorithm/__init__.py | 2 +- pyproject.toml | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/fireflyalgorithm/__init__.py b/fireflyalgorithm/__init__.py index fabf74c..48f3ef7 100644 --- a/fireflyalgorithm/__init__.py +++ b/fireflyalgorithm/__init__.py @@ -2,4 +2,4 @@ __all__ = ['FireflyAlgorithm'] -__version__ = '0.3.3' +__version__ = '0.3.4' diff --git a/pyproject.toml b/pyproject.toml index b0a8e1a..cbf1ab2 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "fireflyalgorithm" -version = "0.3.3" +version = "0.3.4" description = "Implementation of Firefly Algorithm in Python" authors = ["Iztok Fister Jr. ", "Luka Pečnik ", "Žiga Stupan "] license = "MIT" From dbc8ecb522667e4cc12aa9c95a38d10fa46e8a39 Mon Sep 17 00:00:00 2001 From: firefly-cpp Date: Sun, 25 Dec 2022 12:47:57 +0100 Subject: [PATCH 11/51] Update changelog --- CHANGELOG.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index af1306e..18d1380 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,17 @@ # Changelog +## [0.3.4](https://github.com/firefly-cpp/FireflyAlgorithm/tree/0.3.4) (2022-12-13) + +[Full Changelog](https://github.com/firefly-cpp/FireflyAlgorithm/compare/0.3.3...0.3.4) + +**Merged pull requests:** + +- logo add [\#10](https://github.com/firefly-cpp/FireflyAlgorithm/pull/10) ([rhododendrom](https://github.com/rhododendrom)) + +## [0.3.3](https://github.com/firefly-cpp/FireflyAlgorithm/tree/0.3.3) (2022-10-31) + +[Full Changelog](https://github.com/firefly-cpp/FireflyAlgorithm/compare/0.3.2...0.3.3) + ## [0.3.2](https://github.com/firefly-cpp/FireflyAlgorithm/tree/0.3.2) (2022-07-12) [Full Changelog](https://github.com/firefly-cpp/FireflyAlgorithm/compare/0.3.1...0.3.2) From 3585a59f969582bc82c22b994dfcada178df45a5 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Carlos=20Aznar=C3=A1n=20Laos?= Date: Tue, 27 Dec 2022 16:20:42 -0500 Subject: [PATCH 12/51] Add instructions for install FireflyAlgorithm in Arch Linux --- README.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/README.md b/README.md index 48d016f..c325acc 100644 --- a/README.md +++ b/README.md @@ -12,6 +12,7 @@ ![PyPI - Python Version](https://img.shields.io/pypi/pyversions/fireflyalgorithm.svg) ![PyPI - Downloads](https://img.shields.io/pypi/dm/fireflyalgorithm.svg) [![Downloads](https://pepy.tech/badge/fireflyalgorithm)](https://pepy.tech/project/fireflyalgorithm) +[![AUR package](https://img.shields.io/aur/version/python-fireflyalgorithm?color=blue&label=Arch%20Linux&logo=arch-linux)](https://aur.archlinux.org/packages/python-fireflyalgorithm) [![GitHub license](https://img.shields.io/github/license/firefly-cpp/FireflyAlgorithm.svg)](https://github.com/firefly-cpp/FireflyAlgorithm/blob/master/LICENSE) ![GitHub commit activity](https://img.shields.io/github/commit-activity/w/firefly-cpp/FireflyAlgorithm.svg) [![Average time to resolve an issue](http://isitmaintained.com/badge/resolution/firefly-cpp/FireflyAlgorithm.svg)](http://isitmaintained.com/project/firefly-cpp/FireflyAlgorithm "Average time to resolve an issue") @@ -24,6 +25,7 @@ This package implements a nature-inspired algorithm for optimization called Fire ## Installation: +Install FireflyAlgorithm with pip: ```sh pip install fireflyalgorithm ``` @@ -31,6 +33,10 @@ To install FireflyAlgorithm on Fedora, use: ```sh dnf install python-fireflyalgorithm ``` +To install FireflyAlgorithm on Arch Linux, please use an [AUR helper](https://wiki.archlinux.org/title/AUR_helpers): +```sh +$ yay -Syyu python-fireflyalgorithm +``` ## Usage: From 761a927c205c11871841f59b9487b8299ad38b0b Mon Sep 17 00:00:00 2001 From: firefly-cpp Date: Mon, 23 Jan 2023 08:56:52 +0100 Subject: [PATCH 13/51] Improve workflows --- .github/workflows/python-app.yml | 36 ---------------------- .github/workflows/test.yml | 53 ++++++++++++++++++++++++++++++++ 2 files changed, 53 insertions(+), 36 deletions(-) delete mode 100644 .github/workflows/python-app.yml create mode 100644 .github/workflows/test.yml diff --git a/.github/workflows/python-app.yml b/.github/workflows/python-app.yml deleted file mode 100644 index ed1dee6..0000000 --- a/.github/workflows/python-app.yml +++ /dev/null @@ -1,36 +0,0 @@ -# This workflow will install Python dependencies, run tests and lint with a single version of Python -# For more information see: https://help.github.com/actions/language-and-framework-guides/using-python-with-github-actions - -name: FireflyAlgorithm - -on: - push: - branches: [ master ] - pull_request: - branches: [ master ] - -jobs: - build: - - runs-on: ubuntu-latest - - steps: - - uses: actions/checkout@v2 - - name: Set up Python 3.9 - uses: actions/setup-python@v2 - with: - python-version: "3.9" - - name: Install dependencies - run: | - python -m pip install --upgrade pip - pip install flake8 pytest numpy - if [ -f requirements.txt ]; then pip install -r requirements.txt; fi - - name: Lint with flake8 - run: | - # stop the build if there are Python syntax errors or undefined names - flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics - # exit-zero treats all errors as warnings. The GitHub editor is 127 chars wide - flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics - - name: Test with pytest - run: | - pytest diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml new file mode 100644 index 0000000..f6fbc1a --- /dev/null +++ b/.github/workflows/test.yml @@ -0,0 +1,53 @@ +name: fireflyalgorithm + +on: + push: + branches: [ main ] + pull_request: + branches: [ main ] + +jobs: + build: + + runs-on: ${{ matrix.os }} + strategy: + matrix: + os: [ubuntu-latest, windows-latest, macos-latest] + python-version: ['3.9', '3.10'] + defaults: + run: + shell: bash + + steps: + - uses: actions/checkout@v3 + - name: Set up Python ${{ matrix.python-version }} + uses: actions/setup-python@v3 + with: + python-version: ${{ matrix.python-version }} + - name: Get full Python version + id: full-python-version + run: echo ::set-output name=version::$(python -c "import sys; print('-'.join(str(v) for v in sys.version_info))") + - name: Install poetry + run: | + curl -sL https://install.python-poetry.org | python - -y + - name: Update path + if: ${{ matrix.os != 'windows-latest' }} + run: echo "$HOME/.local/bin" >> $GITHUB_PATH + - name: Update Windows path + if: ${{ matrix.os == 'windows-latest' }} + run: echo "$APPDATA\Python\Scripts" >> $GITHUB_PATH + - name: Configure poetry + run: poetry config virtualenvs.in-project true + - name: Set up cache + uses: actions/cache@v3 + id: cache + with: + path: .venv + key: venv-${{ runner.os }}-${{ steps.full-python-version.outputs.version }}-${{ hashFiles('**/poetry.lock') }} + - name: Ensure cache is healthy + if: steps.cache.outputs.cache-hit == 'true' + run: timeout 10s poetry run pip --version || rm -rf .venv + - name: Install dependencies + run: poetry install + - name: Run tests + run: poetry run pytest From 63c86cf957295d2e2142d017ca44f34231588287 Mon Sep 17 00:00:00 2001 From: firefly-cpp Date: Mon, 23 Jan 2023 09:01:11 +0100 Subject: [PATCH 14/51] Fix workflow --- .github/workflows/test.yml | 4 ++-- requirements.txt | 1 - 2 files changed, 2 insertions(+), 3 deletions(-) delete mode 100644 requirements.txt diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml index f6fbc1a..bebce77 100644 --- a/.github/workflows/test.yml +++ b/.github/workflows/test.yml @@ -2,9 +2,9 @@ name: fireflyalgorithm on: push: - branches: [ main ] + branches: [ master ] pull_request: - branches: [ main ] + branches: [ master ] jobs: build: diff --git a/requirements.txt b/requirements.txt deleted file mode 100644 index 24ce15a..0000000 --- a/requirements.txt +++ /dev/null @@ -1 +0,0 @@ -numpy From 6d70291476943e53c09fe1cbdb769f67d8a6d149 Mon Sep 17 00:00:00 2001 From: firefly-cpp Date: Mon, 23 Jan 2023 09:05:39 +0100 Subject: [PATCH 15/51] Update pyproject --- poetry.lock | 191 +++++++++++++++++-------------------------------- pyproject.toml | 2 +- 2 files changed, 67 insertions(+), 126 deletions(-) diff --git a/poetry.lock b/poetry.lock index 883a10b..79fe85b 100644 --- a/poetry.lock +++ b/poetry.lock @@ -1,16 +1,18 @@ [[package]] name = "attrs" -version = "22.1.0" +version = "22.2.0" description = "Classes Without Boilerplate" category = "dev" optional = false -python-versions = ">=3.5" +python-versions = ">=3.6" [package.extras] -tests_no_zope = ["cloudpickle", "pytest-mypy-plugins", "mypy (>=0.900,!=0.940)", "pytest (>=4.3.0)", "pympler", "hypothesis", "coverage[toml] (>=5.0.2)"] -tests = ["cloudpickle", "zope.interface", "pytest-mypy-plugins", "mypy (>=0.900,!=0.940)", "pytest (>=4.3.0)", "pympler", "hypothesis", "coverage[toml] (>=5.0.2)"] -docs = ["sphinx-notfound-page", "zope.interface", "sphinx", "furo"] -dev = ["cloudpickle", "pre-commit", "sphinx-notfound-page", "sphinx", "furo", "zope.interface", "pytest-mypy-plugins", "mypy (>=0.900,!=0.940)", "pytest (>=4.3.0)", "pympler", "hypothesis", "coverage[toml] (>=5.0.2)"] +cov = ["attrs", "coverage-enable-subprocess", "coverage[toml] (>=5.3)"] +dev = ["attrs"] +docs = ["furo", "sphinx", "myst-parser", "zope.interface", "sphinx-notfound-page", "sphinxcontrib-towncrier", "towncrier"] +tests = ["attrs", "zope.interface"] +tests-no-zope = ["hypothesis", "pympler", "pytest (>=4.3.0)", "pytest-xdist", "cloudpickle", "mypy (>=0.971,<0.990)", "pytest-mypy-plugins"] +tests_no_zope = ["hypothesis", "pympler", "pytest (>=4.3.0)", "pytest-xdist", "cloudpickle", "mypy (>=0.971,<0.990)", "pytest-mypy-plugins"] [[package]] name = "colorama" @@ -22,7 +24,7 @@ python-versions = "!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,!=3.5.*,!=3.6.*,>=2.7 [[package]] name = "exceptiongroup" -version = "1.0.0" +version = "1.1.0" description = "Backport of PEP 654 (exception groups)" category = "dev" optional = false @@ -31,57 +33,29 @@ python-versions = ">=3.7" [package.extras] test = ["pytest (>=6)"] -[[package]] -name = "importlib-metadata" -version = "5.0.0" -description = "Read metadata from Python packages" -category = "dev" -optional = false -python-versions = ">=3.7" - -[package.dependencies] -typing-extensions = {version = ">=3.6.4", markers = "python_version < \"3.8\""} -zipp = ">=0.5" - -[package.extras] -docs = ["sphinx (>=3.5)", "jaraco.packaging (>=9)", "rst.linker (>=1.9)", "furo", "jaraco.tidelift (>=1.4)"] -perf = ["ipython"] -testing = ["pytest (>=6)", "pytest-checkdocs (>=2.4)", "pytest-flake8", "flake8 (<5)", "pytest-cov", "pytest-enabler (>=1.3)", "packaging", "pyfakefs", "flufl.flake8", "pytest-perf (>=0.9.2)", "pytest-black (>=0.3.7)", "pytest-mypy (>=0.9.1)", "importlib-resources (>=1.3)"] - [[package]] name = "iniconfig" -version = "1.1.1" -description = "iniconfig: brain-dead simple config-ini parsing" +version = "2.0.0" +description = "brain-dead simple config-ini parsing" category = "dev" optional = false -python-versions = "*" - -[[package]] -name = "numpy" -version = "1.21.6" -description = "NumPy is the fundamental package for array computing with Python." -category = "main" -optional = false -python-versions = ">=3.7,<3.11" +python-versions = ">=3.7" [[package]] name = "numpy" -version = "1.23.4" -description = "NumPy is the fundamental package for array computing with Python." +version = "1.24.1" +description = "Fundamental package for array computing in Python" category = "main" optional = false python-versions = ">=3.8" [[package]] name = "packaging" -version = "21.3" +version = "23.0" description = "Core utilities for Python packages" category = "dev" optional = false -python-versions = ">=3.6" - -[package.dependencies] -pyparsing = ">=2.0.2,<3.0.5 || >3.0.5" +python-versions = ">=3.7" [[package]] name = "pluggy" @@ -91,27 +65,13 @@ category = "dev" optional = false python-versions = ">=3.6" -[package.dependencies] -importlib-metadata = {version = ">=0.12", markers = "python_version < \"3.8\""} - [package.extras] dev = ["pre-commit", "tox"] testing = ["pytest", "pytest-benchmark"] -[[package]] -name = "pyparsing" -version = "3.0.9" -description = "pyparsing module - Classes and methods to define and execute parsing grammars" -category = "dev" -optional = false -python-versions = ">=3.6.8" - -[package.extras] -diagrams = ["railroad-diagrams", "jinja2"] - [[package]] name = "pytest" -version = "7.2.0" +version = "7.2.1" description = "pytest: simple powerful testing with Python" category = "dev" optional = false @@ -121,7 +81,6 @@ python-versions = ">=3.7" attrs = ">=19.2.0" colorama = {version = "*", markers = "sys_platform == \"win32\""} exceptiongroup = {version = ">=1.0.0rc8", markers = "python_version < \"3.11\""} -importlib-metadata = {version = ">=0.12", markers = "python_version < \"3.8\""} iniconfig = "*" packaging = "*" pluggy = ">=0.12,<2.0" @@ -138,89 +97,71 @@ category = "dev" optional = false python-versions = ">=3.7" -[[package]] -name = "typing-extensions" -version = "4.4.0" -description = "Backported and Experimental Type Hints for Python 3.7+" -category = "dev" -optional = false -python-versions = ">=3.7" - -[[package]] -name = "zipp" -version = "3.10.0" -description = "Backport of pathlib-compatible object wrapper for zip files" -category = "dev" -optional = false -python-versions = ">=3.7" - -[package.extras] -docs = ["sphinx (>=3.5)", "jaraco.packaging (>=9)", "rst.linker (>=1.9)", "furo", "jaraco.tidelift (>=1.4)"] -testing = ["pytest (>=6)", "pytest-checkdocs (>=2.4)", "pytest-flake8", "flake8 (<5)", "pytest-cov", "pytest-enabler (>=1.3)", "jaraco.itertools", "func-timeout", "jaraco.functools", "more-itertools", "pytest-black (>=0.3.7)", "pytest-mypy (>=0.9.1)"] - [metadata] lock-version = "1.1" -python-versions = "^3.7" -content-hash = "7886afe25f44148269aae9b5a98e0030046b4c5d7b8ad6a1c9dc6be8a57e1219" +python-versions = "^3.9" +content-hash = "ee07901be93db48ea18c563d48b12653e83a575fe902db609850e0f31719612c" [metadata.files] -attrs = [] -colorama = [] -exceptiongroup = [] -importlib-metadata = [] +attrs = [ + {file = "attrs-22.2.0-py3-none-any.whl", hash = "sha256:29e95c7f6778868dbd49170f98f8818f78f3dc5e0e37c0b1f474e3561b240836"}, + {file = "attrs-22.2.0.tar.gz", hash = "sha256:c9227bfc2f01993c03f68db37d1d15c9690188323c067c641f1a35ca58185f99"}, +] +colorama = [ + {file = "colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6"}, + {file = "colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44"}, +] +exceptiongroup = [ + {file = "exceptiongroup-1.1.0-py3-none-any.whl", hash = "sha256:327cbda3da756e2de031a3107b81ab7b3770a602c4d16ca618298c526f4bec1e"}, + {file = "exceptiongroup-1.1.0.tar.gz", hash = "sha256:bcb67d800a4497e1b404c2dd44fca47d3b7a5e5433dbab67f96c1a685cdfdf23"}, +] iniconfig = [ - {file = "iniconfig-1.1.1-py2.py3-none-any.whl", hash = "sha256:011e24c64b7f47f6ebd835bb12a743f2fbe9a26d4cecaa7f53bc4f35ee9da8b3"}, - {file = "iniconfig-1.1.1.tar.gz", hash = "sha256:bc3af051d7d14b2ee5ef9969666def0cd1a000e121eaea580d4a313df4b37f32"}, + {file = "iniconfig-2.0.0-py3-none-any.whl", hash = "sha256:b6a85871a79d2e3b22d2d1b94ac2824226a63c6b741c88f7ae975f18b6778374"}, + {file = "iniconfig-2.0.0.tar.gz", hash = "sha256:2d91e135bf72d31a410b17c16da610a82cb55f6b0477d1a902134b24a455b8b3"}, ] numpy = [ - {file = "numpy-1.21.6-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:8737609c3bbdd48e380d463134a35ffad3b22dc56295eff6f79fd85bd0eeeb25"}, - {file = "numpy-1.21.6-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:fdffbfb6832cd0b300995a2b08b8f6fa9f6e856d562800fea9182316d99c4e8e"}, - {file = "numpy-1.21.6-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:3820724272f9913b597ccd13a467cc492a0da6b05df26ea09e78b171a0bb9da6"}, - {file = "numpy-1.21.6-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f17e562de9edf691a42ddb1eb4a5541c20dd3f9e65b09ded2beb0799c0cf29bb"}, - {file = "numpy-1.21.6-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:5f30427731561ce75d7048ac254dbe47a2ba576229250fb60f0fb74db96501a1"}, - {file = "numpy-1.21.6-cp310-cp310-win32.whl", hash = "sha256:d4bf4d43077db55589ffc9009c0ba0a94fa4908b9586d6ccce2e0b164c86303c"}, - {file = "numpy-1.21.6-cp310-cp310-win_amd64.whl", hash = "sha256:d136337ae3cc69aa5e447e78d8e1514be8c3ec9b54264e680cf0b4bd9011574f"}, - {file = "numpy-1.21.6-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:6aaf96c7f8cebc220cdfc03f1d5a31952f027dda050e5a703a0d1c396075e3e7"}, - {file = "numpy-1.21.6-cp37-cp37m-manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:67c261d6c0a9981820c3a149d255a76918278a6b03b6a036800359aba1256d46"}, - {file = "numpy-1.21.6-cp37-cp37m-manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:a6be4cb0ef3b8c9250c19cc122267263093eee7edd4e3fa75395dfda8c17a8e2"}, - {file = "numpy-1.21.6-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:7c4068a8c44014b2d55f3c3f574c376b2494ca9cc73d2f1bd692382b6dffe3db"}, - {file = "numpy-1.21.6-cp37-cp37m-win32.whl", hash = "sha256:7c7e5fa88d9ff656e067876e4736379cc962d185d5cd808014a8a928d529ef4e"}, - {file = "numpy-1.21.6-cp37-cp37m-win_amd64.whl", hash = "sha256:bcb238c9c96c00d3085b264e5c1a1207672577b93fa666c3b14a45240b14123a"}, - {file = "numpy-1.21.6-cp38-cp38-macosx_10_9_universal2.whl", hash = "sha256:82691fda7c3f77c90e62da69ae60b5ac08e87e775b09813559f8901a88266552"}, - {file = "numpy-1.21.6-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:643843bcc1c50526b3a71cd2ee561cf0d8773f062c8cbaf9ffac9fdf573f83ab"}, - {file = "numpy-1.21.6-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:357768c2e4451ac241465157a3e929b265dfac85d9214074985b1786244f2ef3"}, - {file = "numpy-1.21.6-cp38-cp38-manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:9f411b2c3f3d76bba0865b35a425157c5dcf54937f82bbeb3d3c180789dd66a6"}, - {file = "numpy-1.21.6-cp38-cp38-manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:4aa48afdce4660b0076a00d80afa54e8a97cd49f457d68a4342d188a09451c1a"}, - {file = "numpy-1.21.6-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:d6a96eef20f639e6a97d23e57dd0c1b1069a7b4fd7027482a4c5c451cd7732f4"}, - {file = "numpy-1.21.6-cp38-cp38-win32.whl", hash = "sha256:5c3c8def4230e1b959671eb959083661b4a0d2e9af93ee339c7dada6759a9470"}, - {file = "numpy-1.21.6-cp38-cp38-win_amd64.whl", hash = "sha256:bf2ec4b75d0e9356edea834d1de42b31fe11f726a81dfb2c2112bc1eaa508fcf"}, - {file = "numpy-1.21.6-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:4391bd07606be175aafd267ef9bea87cf1b8210c787666ce82073b05f202add1"}, - {file = "numpy-1.21.6-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:67f21981ba2f9d7ba9ade60c9e8cbaa8cf8e9ae51673934480e45cf55e953673"}, - {file = "numpy-1.21.6-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:ee5ec40fdd06d62fe5d4084bef4fd50fd4bb6bfd2bf519365f569dc470163ab0"}, - {file = "numpy-1.21.6-cp39-cp39-manylinux_2_12_i686.manylinux2010_i686.whl", hash = "sha256:1dbe1c91269f880e364526649a52eff93ac30035507ae980d2fed33aaee633ac"}, - {file = "numpy-1.21.6-cp39-cp39-manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:d9caa9d5e682102453d96a0ee10c7241b72859b01a941a397fd965f23b3e016b"}, - {file = "numpy-1.21.6-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:58459d3bad03343ac4b1b42ed14d571b8743dc80ccbf27444f266729df1d6f5b"}, - {file = "numpy-1.21.6-cp39-cp39-win32.whl", hash = "sha256:7f5ae4f304257569ef3b948810816bc87c9146e8c446053539947eedeaa32786"}, - {file = "numpy-1.21.6-cp39-cp39-win_amd64.whl", hash = "sha256:e31f0bb5928b793169b87e3d1e070f2342b22d5245c755e2b81caa29756246c3"}, - {file = "numpy-1.21.6-pp37-pypy37_pp73-manylinux_2_12_x86_64.manylinux2010_x86_64.whl", hash = "sha256:dd1c8f6bd65d07d3810b90d02eba7997e32abbdf1277a481d698969e921a3be0"}, - {file = "numpy-1.21.6.zip", hash = "sha256:ecb55251139706669fdec2ff073c98ef8e9a84473e51e716211b41aa0f18e656"}, + {file = "numpy-1.24.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:179a7ef0889ab769cc03573b6217f54c8bd8e16cef80aad369e1e8185f994cd7"}, + {file = "numpy-1.24.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:b09804ff570b907da323b3d762e74432fb07955701b17b08ff1b5ebaa8cfe6a9"}, + {file = "numpy-1.24.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f1b739841821968798947d3afcefd386fa56da0caf97722a5de53e07c4ccedc7"}, + {file = "numpy-1.24.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0e3463e6ac25313462e04aea3fb8a0a30fb906d5d300f58b3bc2c23da6a15398"}, + {file = "numpy-1.24.1-cp310-cp310-win32.whl", hash = "sha256:b31da69ed0c18be8b77bfce48d234e55d040793cebb25398e2a7d84199fbc7e2"}, + {file = "numpy-1.24.1-cp310-cp310-win_amd64.whl", hash = "sha256:b07b40f5fb4fa034120a5796288f24c1fe0e0580bbfff99897ba6267af42def2"}, + {file = "numpy-1.24.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:7094891dcf79ccc6bc2a1f30428fa5edb1e6fb955411ffff3401fb4ea93780a8"}, + {file = "numpy-1.24.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:28e418681372520c992805bb723e29d69d6b7aa411065f48216d8329d02ba032"}, + {file = "numpy-1.24.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e274f0f6c7efd0d577744f52032fdd24344f11c5ae668fe8d01aac0422611df1"}, + {file = "numpy-1.24.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0044f7d944ee882400890f9ae955220d29b33d809a038923d88e4e01d652acd9"}, + {file = "numpy-1.24.1-cp311-cp311-win32.whl", hash = "sha256:442feb5e5bada8408e8fcd43f3360b78683ff12a4444670a7d9e9824c1817d36"}, + {file = "numpy-1.24.1-cp311-cp311-win_amd64.whl", hash = "sha256:de92efa737875329b052982e37bd4371d52cabf469f83e7b8be9bb7752d67e51"}, + {file = "numpy-1.24.1-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:b162ac10ca38850510caf8ea33f89edcb7b0bb0dfa5592d59909419986b72407"}, + {file = "numpy-1.24.1-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:26089487086f2648944f17adaa1a97ca6aee57f513ba5f1c0b7ebdabbe2b9954"}, + {file = "numpy-1.24.1-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:caf65a396c0d1f9809596be2e444e3bd4190d86d5c1ce21f5fc4be60a3bc5b36"}, + {file = "numpy-1.24.1-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:b0677a52f5d896e84414761531947c7a330d1adc07c3a4372262f25d84af7bf7"}, + {file = "numpy-1.24.1-cp38-cp38-win32.whl", hash = "sha256:dae46bed2cb79a58d6496ff6d8da1e3b95ba09afeca2e277628171ca99b99db1"}, + {file = "numpy-1.24.1-cp38-cp38-win_amd64.whl", hash = "sha256:6ec0c021cd9fe732e5bab6401adea5a409214ca5592cd92a114f7067febcba0c"}, + {file = "numpy-1.24.1-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:28bc9750ae1f75264ee0f10561709b1462d450a4808cd97c013046073ae64ab6"}, + {file = "numpy-1.24.1-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:84e789a085aabef2f36c0515f45e459f02f570c4b4c4c108ac1179c34d475ed7"}, + {file = "numpy-1.24.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8e669fbdcdd1e945691079c2cae335f3e3a56554e06bbd45d7609a6cf568c700"}, + {file = "numpy-1.24.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ef85cf1f693c88c1fd229ccd1055570cb41cdf4875873b7728b6301f12cd05bf"}, + {file = "numpy-1.24.1-cp39-cp39-win32.whl", hash = "sha256:87a118968fba001b248aac90e502c0b13606721b1343cdaddbc6e552e8dfb56f"}, + {file = "numpy-1.24.1-cp39-cp39-win_amd64.whl", hash = "sha256:ddc7ab52b322eb1e40521eb422c4e0a20716c271a306860979d450decbb51b8e"}, + {file = "numpy-1.24.1-pp38-pypy38_pp73-macosx_10_9_x86_64.whl", hash = "sha256:ed5fb71d79e771ec930566fae9c02626b939e37271ec285e9efaf1b5d4370e7d"}, + {file = "numpy-1.24.1-pp38-pypy38_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ad2925567f43643f51255220424c23d204024ed428afc5aad0f86f3ffc080086"}, + {file = "numpy-1.24.1-pp38-pypy38_pp73-win_amd64.whl", hash = "sha256:cfa1161c6ac8f92dea03d625c2d0c05e084668f4a06568b77a25a89111621566"}, + {file = "numpy-1.24.1.tar.gz", hash = "sha256:2386da9a471cc00a1f47845e27d916d5ec5346ae9696e01a8a34760858fe9dd2"}, ] packaging = [ - {file = "packaging-21.3-py3-none-any.whl", hash = "sha256:ef103e05f519cdc783ae24ea4e2e0f508a9c99b2d4969652eed6a2e1ea5bd522"}, - {file = "packaging-21.3.tar.gz", hash = "sha256:dd47c42927d89ab911e606518907cc2d3a1f38bbd026385970643f9c5b8ecfeb"}, + {file = "packaging-23.0-py3-none-any.whl", hash = "sha256:714ac14496c3e68c99c29b00845f7a2b85f3bb6f1078fd9f72fd20f0570002b2"}, + {file = "packaging-23.0.tar.gz", hash = "sha256:b6ad297f8907de0fa2fe1ccbd26fdaf387f5f47c7275fedf8cce89f99446cf97"}, ] pluggy = [ {file = "pluggy-1.0.0-py2.py3-none-any.whl", hash = "sha256:74134bbf457f031a36d68416e1509f34bd5ccc019f0bcc952c7b909d06b37bd3"}, {file = "pluggy-1.0.0.tar.gz", hash = "sha256:4224373bacce55f955a878bf9cfa763c1e360858e330072059e10bad68531159"}, ] -pyparsing = [ - {file = "pyparsing-3.0.9-py3-none-any.whl", hash = "sha256:5026bae9a10eeaefb61dab2f09052b9f4307d44aee4eda64b309723d8d206bbc"}, - {file = "pyparsing-3.0.9.tar.gz", hash = "sha256:2b020ecf7d21b687f219b71ecad3631f644a47f01403fa1d1036b0c6416d70fb"}, +pytest = [ + {file = "pytest-7.2.1-py3-none-any.whl", hash = "sha256:c7c6ca206e93355074ae32f7403e8ea12163b1163c976fee7d4d84027c162be5"}, + {file = "pytest-7.2.1.tar.gz", hash = "sha256:d45e0952f3727241918b8fd0f376f5ff6b301cc0777c6f9a556935c92d8a7d42"}, ] -pytest = [] tomli = [ {file = "tomli-2.0.1-py3-none-any.whl", hash = "sha256:939de3e7a6161af0c887ef91b7d41a53e7c5a1ca976325f429cb46ea9bc30ecc"}, {file = "tomli-2.0.1.tar.gz", hash = "sha256:de526c12914f0c550d15924c62d72abc48d6fe7364aa87328337a31007fe8a4f"}, ] -typing-extensions = [] -zipp = [] diff --git a/pyproject.toml b/pyproject.toml index cbf1ab2..6ebe666 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -13,7 +13,7 @@ include = [ ] [tool.poetry.dependencies] -python = "^3.7" +python = "^3.9" numpy = [ { version = "^1.21.5", python = ">=3.7,<3.11" }, { version = "^1.22.0", python = "^3.11" } From fe6137c0065bc7066cf83bbe041256d1e5d6cba5 Mon Sep 17 00:00:00 2001 From: Iztok Fister Jr Date: Wed, 13 Sep 2023 14:25:39 +0200 Subject: [PATCH 16/51] Update LICENSE --- LICENSE | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/LICENSE b/LICENSE index 0500760..0d39b71 100644 --- a/LICENSE +++ b/LICENSE @@ -1,6 +1,6 @@ MIT License -Copyright (c) 2017 firefly-cpp +Copyright (c) 2017-2023 firefly-cpp Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal From aafbdb3283da2c84bfaa40bfb3845db5fff15b4b Mon Sep 17 00:00:00 2001 From: zStupan Date: Sun, 5 Nov 2023 20:14:09 +0100 Subject: [PATCH 17/51] added test problem implementations --- fireflyalgorithm/problems.py | 268 +++++++++++++++++++++++++++++++++++ 1 file changed, 268 insertions(+) create mode 100644 fireflyalgorithm/problems.py diff --git a/fireflyalgorithm/problems.py b/fireflyalgorithm/problems.py new file mode 100644 index 0000000..e0747e6 --- /dev/null +++ b/fireflyalgorithm/problems.py @@ -0,0 +1,268 @@ +import numpy as np + + +def ackley(x): + a = 20 + b = 0.2 + c = 2 * np.pi + dim = len(x) + + val1 = np.sum(np.square(x)) + val2 = np.sum(np.cos(c * x)) + + temp1 = -b * np.sqrt(val1 / dim) + temp2 = val2 / dim + + return -a * np.exp(temp1) - np.exp(temp2) + a + np.exp(1) + + +def alpine1(x): + return np.sum(np.abs(np.sin(x) + 0.1 * x)) + + +def alpine2(x): + return np.prod(np.sqrt(x) * np.sin(x)) + + +def cigar(x): + return x[0] ** 2 + 1000000 * np.sum(x[1:] ** 2) + + +def cosine_mixture(x): + return -0.1 * np.sum(np.cos(5 * np.pi * x)) - np.sum(x**2) + + +def csendes(x): + mask = x != 0 + return np.sum(np.power(x[mask], 6) * (2 + np.sin(1 / x[mask]))) + + +def dixon_price(x): + dim = len(x) + indices = np.arange(2, dim) + val = np.sum(indices * (2 * x[2:] ** 2 - x[1 : dim - 1]) ** 2) + return (x[0] - 1) ** 2 + val + + +def griewank(x): + dim = len(x) + i = np.arange(1, dim + 1) + val1 = np.sum(x**2 / 4000) + val2 = np.prod(np.cos(x / np.sqrt(i))) + return val1 - val2 + 1 + + +def katsuura(x): + dim = len(x) + k = np.atleast_2d(np.arange(1, 33)).T + i = np.arange(0, dim * 1) + inner = np.round(2**k * x) * (2 ** (-k)) + return np.prod(np.sum(inner, axis=0) * (i + 1) + 1) + + +def levy(x): + w = 1 + (x - 1) / 4 + wi = w[:-1] + term1 = np.sin(np.pi * w[0]) ** 2 + term2 = np.sum((wi - 1) ** 2 * (1 + 10 * np.sin(np.pi * wi + 1))) + term3 = (w[-1] - 1) ** 2 * (1 + np.sin(2 * np.pi * w[-1]) ** 2) + return term1 + term2 + term3 + + +def michalewicz(x): + dim = len(x) + m = 10 + i = np.arange(1, dim + 1) + return -np.sum(np.sin(x) * np.sin(i * x**2 / np.pi) ** (2 * m)) + + +def perm1(x): + dim = len(x) + beta = 0.5 + k = np.atleast_2d(np.arange(dim) + 1).T + j = np.atleast_2d(np.arange(dim) + 1) + s = (j**k + beta) * ((x / j) ** k - 1) + return np.sum(np.sum(s, axis=1) ** 2) + + +def perm2(x): + dim = len(x) + beta = 10 + k = np.atleast_2d(np.arange(dim) + 1).T + j = np.atleast_2d(np.arange(dim) + 1) + s = (j + beta) * (x**k - (1 / j) ** k) + return np.sum(np.sum(s, axis=1) ** 2) + + +def pinter(x): + dim = len(x) + x = np.asarray(x) + sub = np.roll(x, 1) + add = np.roll(x, -1) + indices = np.arange(1, dim + 1) + + a = sub * np.sin(x) + np.sin(add) + b = (sub * sub) - 2 * x + 3 * add - np.cos(x) + 1 + + val1 = np.sum(indices * x * x) + val2 = np.sum(20 * indices * np.power(np.sin(a), 2)) + val3 = np.sum(indices * np.log10(1 + indices * np.power(b, 2))) + + return val1 + val2 + val3 + + +def powell(x): + x1 = x[0::4] + x2 = x[1::4] + x3 = x[2::4] + x4 = x[3::4] + + term1 = (x1 + 10 * x2) ** 2 + term2 = 5 * (x3 - x4) ** 2 + term3 = (x2 - 2 * x3) ** 4 + term4 = 10 * (x1 - x4) ** 4 + return np.sum(term1 + term2 + term3 + term4) + + +def quing(x): + dim = len(x) + return np.sum(np.power(x**2 - np.arange(1, dim + 1), 2)) + + +def quintic(x): + return np.sum(np.abs(x**5 - 3 * x**4 + 4 * x**3 + 2 * x**2 - 10 * x - 4)) + + +def rastrigin(x): + dim = len(x) + return 10 * dim + np.sum(x**2 - 10 * np.cos(2 * np.pi * x)) + + +def rosenbrock(x): + return np.sum(100.0 * (x[1:] - x[:-1] ** 2) ** 2 + (1 - x[:-1]) ** 2, axis=0) + + +def salomon(x): + val = np.sqrt(np.sum(x**2)) + return 1 - np.cos(2 * np.pi * val) + 0.1 * val + + +def schaffer2(x): + return ( + 0.5 + + (np.sin(x[0] ** 2 - x[1] ** 2) ** 2 - 0.5) + / (1 + 0.001 * (x[0] ** 2 + x[1] ** 2)) ** 2 + ) + + +def schaffer4(x): + return ( + 0.5 + + (np.cos(np.sin(x[0] ** 2 - x[1] ** 2)) ** 2 - 0.5) + / (1 + 0.001 * (x[0] ** 2 + x[1] ** 2)) ** 2 + ) + + +def schwefel(x): + dim = len(x) + return 418.9829 * dim - np.sum(x * np.sin(np.sqrt(np.abs(x)))) + + +def schwefel21(x): + return np.amax(np.abs(x)) + + +def schwefel22(x): + return np.sum(np.abs(x)) + np.prod(np.abs(x)) + + +def sphere(x): + return np.sum(x**2) + + +def step(x): + return np.sum(np.floor(np.abs(x))) + + +def step2(x): + return np.sum(np.floor(x + 0.5) ** 2) + + +def styblinski_tang(x): + return 0.5 * np.sum(x**4 - 16 * x**2 + 5 * x) + + +def trid(x): + sum1 = np.sum((x - 1) ** 2) + sum2 = np.sum(x[1:] * x[:-1]) + return sum1 - sum2 + + +def weierstrass(x): + dim = len(x) + kmax = 20 + a = 0.5 + b = 3 + + k = np.atleast_2d(np.arange(kmax + 1)).T + t1 = a**k * np.cos(2 * np.pi * b**k * (x + 0.5)) + t2 = dim * np.sum(a**k.T * np.cos(np.pi * b**k.T)) + + return np.sum(np.sum(t1, axis=0)) - t2 + + +def whitley(x): + xi = x + xj = np.atleast_2d(x).T + + temp = 100 * ((xi**2) - xj) + (1 - xj) ** 2 + inner = (temp**2 / 4000) - np.cos(temp) + 1 + return np.sum(np.sum(inner, axis=0)) + + +def zakharov(x): + dim = len(x) + sum1 = np.sum(x**2) + sum2 = 0.5 * np.sum(np.arange(1, dim + 1) * x) + return sum1 + sum2**2 + sum2**4 + + +PROBLEMS = { + "ackley": ackley, + "alpine1": alpine1, + "alpine2": alpine2, + "cigar": cigar, + "cosine_mixture": cosine_mixture, + "csendes": csendes, + "dixon_price": dixon_price, + "griewank": griewank, + "katsuura": katsuura, + "levy": levy, + "michalewicz": michalewicz, + "perm1": perm1, + "perm2": perm2, + "pinter": pinter, + "powell": powell, + "quing": quing, + "quintic": quintic, + "rastrigin": rastrigin, + "rosenbrock": rosenbrock, + "salomon": salomon, + "schaffer2": schaffer2, + "schaffer4": schaffer4, + "schwefel": schwefel, + "schwefel21": schwefel21, + "schwefel22": schwefel22, + "sphere": sphere, + "step": step, + "step2": step2, + "styblinski_tang": styblinski_tang, + "trid": trid, + "weierstrass": weierstrass, + "whitley": whitley, + "zakharov": zakharov, +} + + +def get_problem(name): + return PROBLEMS[name] From ba4dfe4617626a29d84f519d992ea4b0ccdf01a6 Mon Sep 17 00:00:00 2001 From: zStupan Date: Sun, 5 Nov 2023 20:15:19 +0100 Subject: [PATCH 18/51] updated dependencies --- poetry.lock | 171 +++++++++++++++++++++---------------------------- pyproject.toml | 11 ++-- 2 files changed, 77 insertions(+), 105 deletions(-) diff --git a/poetry.lock b/poetry.lock index 79fe85b..0bf4182 100644 --- a/poetry.lock +++ b/poetry.lock @@ -1,34 +1,26 @@ -[[package]] -name = "attrs" -version = "22.2.0" -description = "Classes Without Boilerplate" -category = "dev" -optional = false -python-versions = ">=3.6" - -[package.extras] -cov = ["attrs", "coverage-enable-subprocess", "coverage[toml] (>=5.3)"] -dev = ["attrs"] -docs = ["furo", "sphinx", "myst-parser", "zope.interface", "sphinx-notfound-page", "sphinxcontrib-towncrier", "towncrier"] -tests = ["attrs", "zope.interface"] -tests-no-zope = ["hypothesis", "pympler", "pytest (>=4.3.0)", "pytest-xdist", "cloudpickle", "mypy (>=0.971,<0.990)", "pytest-mypy-plugins"] -tests_no_zope = ["hypothesis", "pympler", "pytest (>=4.3.0)", "pytest-xdist", "cloudpickle", "mypy (>=0.971,<0.990)", "pytest-mypy-plugins"] +# This file is automatically @generated by Poetry 1.7.0 and should not be changed by hand. [[package]] name = "colorama" version = "0.4.6" description = "Cross-platform colored terminal text." -category = "dev" optional = false python-versions = "!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,!=3.5.*,!=3.6.*,>=2.7" +files = [ + {file = "colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6"}, + {file = "colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44"}, +] [[package]] name = "exceptiongroup" -version = "1.1.0" +version = "1.1.3" description = "Backport of PEP 654 (exception groups)" -category = "dev" optional = false python-versions = ">=3.7" +files = [ + {file = "exceptiongroup-1.1.3-py3-none-any.whl", hash = "sha256:343280667a4585d195ca1cf9cef84a4e178c4b6cf2274caef9859782b567d5e3"}, + {file = "exceptiongroup-1.1.3.tar.gz", hash = "sha256:097acd85d473d75af5bb98e41b61ff7fe35efe6675e4f9370ec6ec5126d160e9"}, +] [package.extras] test = ["pytest (>=6)"] @@ -37,33 +29,75 @@ test = ["pytest (>=6)"] name = "iniconfig" version = "2.0.0" description = "brain-dead simple config-ini parsing" -category = "dev" optional = false python-versions = ">=3.7" +files = [ + {file = "iniconfig-2.0.0-py3-none-any.whl", hash = "sha256:b6a85871a79d2e3b22d2d1b94ac2824226a63c6b741c88f7ae975f18b6778374"}, + {file = "iniconfig-2.0.0.tar.gz", hash = "sha256:2d91e135bf72d31a410b17c16da610a82cb55f6b0477d1a902134b24a455b8b3"}, +] [[package]] name = "numpy" -version = "1.24.1" +version = "1.26.1" description = "Fundamental package for array computing in Python" -category = "main" optional = false -python-versions = ">=3.8" +python-versions = "<3.13,>=3.9" +files = [ + {file = "numpy-1.26.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:82e871307a6331b5f09efda3c22e03c095d957f04bf6bc1804f30048d0e5e7af"}, + {file = "numpy-1.26.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:cdd9ec98f0063d93baeb01aad472a1a0840dee302842a2746a7a8e92968f9575"}, + {file = "numpy-1.26.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:d78f269e0c4fd365fc2992c00353e4530d274ba68f15e968d8bc3c69ce5f5244"}, + {file = "numpy-1.26.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8ab9163ca8aeb7fd32fe93866490654d2f7dda4e61bc6297bf72ce07fdc02f67"}, + {file = "numpy-1.26.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:78ca54b2f9daffa5f323f34cdf21e1d9779a54073f0018a3094ab907938331a2"}, + {file = "numpy-1.26.1-cp310-cp310-win32.whl", hash = "sha256:d1cfc92db6af1fd37a7bb58e55c8383b4aa1ba23d012bdbba26b4bcca45ac297"}, + {file = "numpy-1.26.1-cp310-cp310-win_amd64.whl", hash = "sha256:d2984cb6caaf05294b8466966627e80bf6c7afd273279077679cb010acb0e5ab"}, + {file = "numpy-1.26.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:cd7837b2b734ca72959a1caf3309457a318c934abef7a43a14bb984e574bbb9a"}, + {file = "numpy-1.26.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:1c59c046c31a43310ad0199d6299e59f57a289e22f0f36951ced1c9eac3665b9"}, + {file = "numpy-1.26.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:d58e8c51a7cf43090d124d5073bc29ab2755822181fcad978b12e144e5e5a4b3"}, + {file = "numpy-1.26.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:6081aed64714a18c72b168a9276095ef9155dd7888b9e74b5987808f0dd0a974"}, + {file = "numpy-1.26.1-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:97e5d6a9f0702c2863aaabf19f0d1b6c2628fbe476438ce0b5ce06e83085064c"}, + {file = "numpy-1.26.1-cp311-cp311-win32.whl", hash = "sha256:b9d45d1dbb9de84894cc50efece5b09939752a2d75aab3a8b0cef6f3a35ecd6b"}, + {file = "numpy-1.26.1-cp311-cp311-win_amd64.whl", hash = "sha256:3649d566e2fc067597125428db15d60eb42a4e0897fc48d28cb75dc2e0454e53"}, + {file = "numpy-1.26.1-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:1d1bd82d539607951cac963388534da3b7ea0e18b149a53cf883d8f699178c0f"}, + {file = "numpy-1.26.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:afd5ced4e5a96dac6725daeb5242a35494243f2239244fad10a90ce58b071d24"}, + {file = "numpy-1.26.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:a03fb25610ef560a6201ff06df4f8105292ba56e7cdd196ea350d123fc32e24e"}, + {file = "numpy-1.26.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:dcfaf015b79d1f9f9c9fd0731a907407dc3e45769262d657d754c3a028586124"}, + {file = "numpy-1.26.1-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:e509cbc488c735b43b5ffea175235cec24bbc57b227ef1acc691725beb230d1c"}, + {file = "numpy-1.26.1-cp312-cp312-win32.whl", hash = "sha256:af22f3d8e228d84d1c0c44c1fbdeb80f97a15a0abe4f080960393a00db733b66"}, + {file = "numpy-1.26.1-cp312-cp312-win_amd64.whl", hash = "sha256:9f42284ebf91bdf32fafac29d29d4c07e5e9d1af862ea73686581773ef9e73a7"}, + {file = "numpy-1.26.1-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:bb894accfd16b867d8643fc2ba6c8617c78ba2828051e9a69511644ce86ce83e"}, + {file = "numpy-1.26.1-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:e44ccb93f30c75dfc0c3aa3ce38f33486a75ec9abadabd4e59f114994a9c4617"}, + {file = "numpy-1.26.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9696aa2e35cc41e398a6d42d147cf326f8f9d81befcb399bc1ed7ffea339b64e"}, + {file = "numpy-1.26.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:a5b411040beead47a228bde3b2241100454a6abde9df139ed087bd73fc0a4908"}, + {file = "numpy-1.26.1-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:1e11668d6f756ca5ef534b5be8653d16c5352cbb210a5c2a79ff288e937010d5"}, + {file = "numpy-1.26.1-cp39-cp39-win32.whl", hash = "sha256:d1d2c6b7dd618c41e202c59c1413ef9b2c8e8a15f5039e344af64195459e3104"}, + {file = "numpy-1.26.1-cp39-cp39-win_amd64.whl", hash = "sha256:59227c981d43425ca5e5c01094d59eb14e8772ce6975d4b2fc1e106a833d5ae2"}, + {file = "numpy-1.26.1-pp39-pypy39_pp73-macosx_10_9_x86_64.whl", hash = "sha256:06934e1a22c54636a059215d6da99e23286424f316fddd979f5071093b648668"}, + {file = "numpy-1.26.1-pp39-pypy39_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:76ff661a867d9272cd2a99eed002470f46dbe0943a5ffd140f49be84f68ffc42"}, + {file = "numpy-1.26.1-pp39-pypy39_pp73-win_amd64.whl", hash = "sha256:6965888d65d2848e8768824ca8288db0a81263c1efccec881cb35a0d805fcd2f"}, + {file = "numpy-1.26.1.tar.gz", hash = "sha256:c8c6c72d4a9f831f328efb1312642a1cafafaa88981d9ab76368d50d07d93cbe"}, +] [[package]] name = "packaging" -version = "23.0" +version = "23.2" description = "Core utilities for Python packages" -category = "dev" optional = false python-versions = ">=3.7" +files = [ + {file = "packaging-23.2-py3-none-any.whl", hash = "sha256:8c491190033a9af7e1d931d0b5dacc2ef47509b34dd0de67ed209b5203fc88c7"}, + {file = "packaging-23.2.tar.gz", hash = "sha256:048fb0e9405036518eaaf48a55953c750c11e1a1b68e0dd1a9d62ed0c092cfc5"}, +] [[package]] name = "pluggy" -version = "1.0.0" +version = "1.3.0" description = "plugin and hook calling mechanisms for python" -category = "dev" optional = false -python-versions = ">=3.6" +python-versions = ">=3.8" +files = [ + {file = "pluggy-1.3.0-py3-none-any.whl", hash = "sha256:d89c696a773f8bd377d18e5ecda92b7a3793cbe66c87060a6fb58c7b6e1061f7"}, + {file = "pluggy-1.3.0.tar.gz", hash = "sha256:cf61ae8f126ac6f7c451172cf30e3e43d3ca77615509771b3a984a0730651e12"}, +] [package.extras] dev = ["pre-commit", "tox"] @@ -71,14 +105,16 @@ testing = ["pytest", "pytest-benchmark"] [[package]] name = "pytest" -version = "7.2.1" +version = "7.4.3" description = "pytest: simple powerful testing with Python" -category = "dev" optional = false python-versions = ">=3.7" +files = [ + {file = "pytest-7.4.3-py3-none-any.whl", hash = "sha256:0d009c083ea859a71b76adf7c1d502e4bc170b80a8ef002da5806527b9591fac"}, + {file = "pytest-7.4.3.tar.gz", hash = "sha256:d989d136982de4e3b29dabcc838ad581c64e8ed52c11fbe86ddebd9da0818cd5"}, +] [package.dependencies] -attrs = ">=19.2.0" colorama = {version = "*", markers = "sys_platform == \"win32\""} exceptiongroup = {version = ">=1.0.0rc8", markers = "python_version < \"3.11\""} iniconfig = "*" @@ -87,81 +123,20 @@ pluggy = ">=0.12,<2.0" tomli = {version = ">=1.0.0", markers = "python_version < \"3.11\""} [package.extras] -testing = ["argcomplete", "hypothesis (>=3.56)", "mock", "nose", "pygments (>=2.7.2)", "requests", "xmlschema"] +testing = ["argcomplete", "attrs (>=19.2.0)", "hypothesis (>=3.56)", "mock", "nose", "pygments (>=2.7.2)", "requests", "setuptools", "xmlschema"] [[package]] name = "tomli" version = "2.0.1" description = "A lil' TOML parser" -category = "dev" optional = false python-versions = ">=3.7" - -[metadata] -lock-version = "1.1" -python-versions = "^3.9" -content-hash = "ee07901be93db48ea18c563d48b12653e83a575fe902db609850e0f31719612c" - -[metadata.files] -attrs = [ - {file = "attrs-22.2.0-py3-none-any.whl", hash = "sha256:29e95c7f6778868dbd49170f98f8818f78f3dc5e0e37c0b1f474e3561b240836"}, - {file = "attrs-22.2.0.tar.gz", hash = "sha256:c9227bfc2f01993c03f68db37d1d15c9690188323c067c641f1a35ca58185f99"}, -] -colorama = [ - {file = "colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6"}, - {file = "colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44"}, -] -exceptiongroup = [ - {file = "exceptiongroup-1.1.0-py3-none-any.whl", hash = "sha256:327cbda3da756e2de031a3107b81ab7b3770a602c4d16ca618298c526f4bec1e"}, - {file = "exceptiongroup-1.1.0.tar.gz", hash = "sha256:bcb67d800a4497e1b404c2dd44fca47d3b7a5e5433dbab67f96c1a685cdfdf23"}, -] -iniconfig = [ - {file = "iniconfig-2.0.0-py3-none-any.whl", hash = "sha256:b6a85871a79d2e3b22d2d1b94ac2824226a63c6b741c88f7ae975f18b6778374"}, - {file = "iniconfig-2.0.0.tar.gz", hash = "sha256:2d91e135bf72d31a410b17c16da610a82cb55f6b0477d1a902134b24a455b8b3"}, -] -numpy = [ - {file = "numpy-1.24.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:179a7ef0889ab769cc03573b6217f54c8bd8e16cef80aad369e1e8185f994cd7"}, - {file = "numpy-1.24.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:b09804ff570b907da323b3d762e74432fb07955701b17b08ff1b5ebaa8cfe6a9"}, - {file = "numpy-1.24.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f1b739841821968798947d3afcefd386fa56da0caf97722a5de53e07c4ccedc7"}, - {file = "numpy-1.24.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0e3463e6ac25313462e04aea3fb8a0a30fb906d5d300f58b3bc2c23da6a15398"}, - {file = "numpy-1.24.1-cp310-cp310-win32.whl", hash = "sha256:b31da69ed0c18be8b77bfce48d234e55d040793cebb25398e2a7d84199fbc7e2"}, - {file = "numpy-1.24.1-cp310-cp310-win_amd64.whl", hash = "sha256:b07b40f5fb4fa034120a5796288f24c1fe0e0580bbfff99897ba6267af42def2"}, - {file = "numpy-1.24.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:7094891dcf79ccc6bc2a1f30428fa5edb1e6fb955411ffff3401fb4ea93780a8"}, - {file = "numpy-1.24.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:28e418681372520c992805bb723e29d69d6b7aa411065f48216d8329d02ba032"}, - {file = "numpy-1.24.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e274f0f6c7efd0d577744f52032fdd24344f11c5ae668fe8d01aac0422611df1"}, - {file = "numpy-1.24.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0044f7d944ee882400890f9ae955220d29b33d809a038923d88e4e01d652acd9"}, - {file = "numpy-1.24.1-cp311-cp311-win32.whl", hash = "sha256:442feb5e5bada8408e8fcd43f3360b78683ff12a4444670a7d9e9824c1817d36"}, - {file = "numpy-1.24.1-cp311-cp311-win_amd64.whl", hash = "sha256:de92efa737875329b052982e37bd4371d52cabf469f83e7b8be9bb7752d67e51"}, - {file = "numpy-1.24.1-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:b162ac10ca38850510caf8ea33f89edcb7b0bb0dfa5592d59909419986b72407"}, - {file = "numpy-1.24.1-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:26089487086f2648944f17adaa1a97ca6aee57f513ba5f1c0b7ebdabbe2b9954"}, - {file = "numpy-1.24.1-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:caf65a396c0d1f9809596be2e444e3bd4190d86d5c1ce21f5fc4be60a3bc5b36"}, - {file = "numpy-1.24.1-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:b0677a52f5d896e84414761531947c7a330d1adc07c3a4372262f25d84af7bf7"}, - {file = "numpy-1.24.1-cp38-cp38-win32.whl", hash = "sha256:dae46bed2cb79a58d6496ff6d8da1e3b95ba09afeca2e277628171ca99b99db1"}, - {file = "numpy-1.24.1-cp38-cp38-win_amd64.whl", hash = "sha256:6ec0c021cd9fe732e5bab6401adea5a409214ca5592cd92a114f7067febcba0c"}, - {file = "numpy-1.24.1-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:28bc9750ae1f75264ee0f10561709b1462d450a4808cd97c013046073ae64ab6"}, - {file = "numpy-1.24.1-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:84e789a085aabef2f36c0515f45e459f02f570c4b4c4c108ac1179c34d475ed7"}, - {file = "numpy-1.24.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:8e669fbdcdd1e945691079c2cae335f3e3a56554e06bbd45d7609a6cf568c700"}, - {file = "numpy-1.24.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ef85cf1f693c88c1fd229ccd1055570cb41cdf4875873b7728b6301f12cd05bf"}, - {file = "numpy-1.24.1-cp39-cp39-win32.whl", hash = "sha256:87a118968fba001b248aac90e502c0b13606721b1343cdaddbc6e552e8dfb56f"}, - {file = "numpy-1.24.1-cp39-cp39-win_amd64.whl", hash = "sha256:ddc7ab52b322eb1e40521eb422c4e0a20716c271a306860979d450decbb51b8e"}, - {file = "numpy-1.24.1-pp38-pypy38_pp73-macosx_10_9_x86_64.whl", hash = "sha256:ed5fb71d79e771ec930566fae9c02626b939e37271ec285e9efaf1b5d4370e7d"}, - {file = "numpy-1.24.1-pp38-pypy38_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ad2925567f43643f51255220424c23d204024ed428afc5aad0f86f3ffc080086"}, - {file = "numpy-1.24.1-pp38-pypy38_pp73-win_amd64.whl", hash = "sha256:cfa1161c6ac8f92dea03d625c2d0c05e084668f4a06568b77a25a89111621566"}, - {file = "numpy-1.24.1.tar.gz", hash = "sha256:2386da9a471cc00a1f47845e27d916d5ec5346ae9696e01a8a34760858fe9dd2"}, -] -packaging = [ - {file = "packaging-23.0-py3-none-any.whl", hash = "sha256:714ac14496c3e68c99c29b00845f7a2b85f3bb6f1078fd9f72fd20f0570002b2"}, - {file = "packaging-23.0.tar.gz", hash = "sha256:b6ad297f8907de0fa2fe1ccbd26fdaf387f5f47c7275fedf8cce89f99446cf97"}, -] -pluggy = [ - {file = "pluggy-1.0.0-py2.py3-none-any.whl", hash = "sha256:74134bbf457f031a36d68416e1509f34bd5ccc019f0bcc952c7b909d06b37bd3"}, - {file = "pluggy-1.0.0.tar.gz", hash = "sha256:4224373bacce55f955a878bf9cfa763c1e360858e330072059e10bad68531159"}, -] -pytest = [ - {file = "pytest-7.2.1-py3-none-any.whl", hash = "sha256:c7c6ca206e93355074ae32f7403e8ea12163b1163c976fee7d4d84027c162be5"}, - {file = "pytest-7.2.1.tar.gz", hash = "sha256:d45e0952f3727241918b8fd0f376f5ff6b301cc0777c6f9a556935c92d8a7d42"}, -] -tomli = [ +files = [ {file = "tomli-2.0.1-py3-none-any.whl", hash = "sha256:939de3e7a6161af0c887ef91b7d41a53e7c5a1ca976325f429cb46ea9bc30ecc"}, {file = "tomli-2.0.1.tar.gz", hash = "sha256:de526c12914f0c550d15924c62d72abc48d6fe7364aa87328337a31007fe8a4f"}, ] + +[metadata] +lock-version = "2.0" +python-versions = "^3.9,<3.13" +content-hash = "aa27aa586ebf5e13d1936db455cb5da27cc641ae1ffc6434877928a3baa9bb82" diff --git a/pyproject.toml b/pyproject.toml index 6ebe666..29de9fc 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -13,14 +13,11 @@ include = [ ] [tool.poetry.dependencies] -python = "^3.9" -numpy = [ - { version = "^1.21.5", python = ">=3.7,<3.11" }, - { version = "^1.22.0", python = "^3.11" } -] +python = "^3.9,<3.13" +numpy = "^1.26.1" -[tool.poetry.dev-dependencies] -pytest = "^7.0.1" +[tool.poetry.group.test.dependencies] +pytest = "^7.4.3" [build-system] requires = ["poetry-core"] From bd190dec27c1e43542e9e7ea7adf8183957e20e8 Mon Sep 17 00:00:00 2001 From: zStupan Date: Sun, 5 Nov 2023 20:16:06 +0100 Subject: [PATCH 19/51] Added command line interface --- fireflyalgorithm/__init__.py | 4 +- fireflyalgorithm/__main__.py | 6 +++ fireflyalgorithm/cli.py | 79 ++++++++++++++++++++++++++++++++++++ pyproject.toml | 3 ++ 4 files changed, 90 insertions(+), 2 deletions(-) create mode 100644 fireflyalgorithm/__main__.py create mode 100644 fireflyalgorithm/cli.py diff --git a/fireflyalgorithm/__init__.py b/fireflyalgorithm/__init__.py index 48f3ef7..cb5e64a 100644 --- a/fireflyalgorithm/__init__.py +++ b/fireflyalgorithm/__init__.py @@ -1,5 +1,5 @@ from fireflyalgorithm.fireflyalgorithm import FireflyAlgorithm -__all__ = ['FireflyAlgorithm'] +__all__ = ["FireflyAlgorithm"] -__version__ = '0.3.4' +__version__ = "0.3.4" diff --git a/fireflyalgorithm/__main__.py b/fireflyalgorithm/__main__.py new file mode 100644 index 0000000..75c1ac9 --- /dev/null +++ b/fireflyalgorithm/__main__.py @@ -0,0 +1,6 @@ +import sys +from fireflyalgorithm import cli + + +if __name__ == "__main__": + sys.exit(cli.main()) diff --git a/fireflyalgorithm/cli.py b/fireflyalgorithm/cli.py new file mode 100644 index 0000000..b08d4fd --- /dev/null +++ b/fireflyalgorithm/cli.py @@ -0,0 +1,79 @@ +import argparse +import numpy as np +from fireflyalgorithm.problems import PROBLEMS, get_problem +from fireflyalgorithm.fireflyalgorithm import FireflyAlgorithm + + +def get_parser(): + parser = argparse.ArgumentParser( + prog="firefly-algorithm", + description="Evaluate the Firefly Algorithm on one or more test functions", + ) + + problem_functions = list(PROBLEMS.keys()) + parser.add_argument( + "--problem", + type=str, + required=True, + choices=problem_functions, + metavar="PROBLEM", + help="Test problem to evaluate", + ) + parser.add_argument( + "-d", "--dimension", type=int, required=True, help="Dimension of the problem" + ) + parser.add_argument( + "-l", "--lower", type=float, required=True, help="Lower bounds of the problem" + ) + parser.add_argument( + "-u", "--upper", type=float, required=True, help="Upper bounds of the problem" + ) + parser.add_argument( + "-nfes", + "--max-evals", + type=int, + required=True, + help="Max number of fitness function evaluations", + ) + parser.add_argument( + "-r", "--runs", type=int, default=1, help="Number of runs of the algorithm" + ) + parser.add_argument("--pop-size", type=int, default=20, help="Population size") + parser.add_argument("--alpha", type=float, default=1.0, help="Randomness strength") + parser.add_argument( + "--beta-min", type=float, default=1.0, help="Attractiveness constant" + ) + parser.add_argument( + "--gamma", type=float, default=0.01, help="Absorption coefficient" + ) + parser.add_argument("--seed", type=int, help="Seed for the random number generator") + return parser + + +def main(): + parser = get_parser() + args = parser.parse_args() + + algorithm = FireflyAlgorithm( + args.pop_size, args.alpha, args.beta_min, args.gamma, args.seed + ) + problem = get_problem(args.problem) + dim = args.dimension + lb = args.lower + ub = args.upper + max_evals = args.max_evals + runs = args.runs + + fitness = np.empty(runs) + for i in range(runs): + fitness[i] = algorithm.run(problem, dim, lb, ub, max_evals) + + if runs == 1: + print(f"Best fitness: {fitness[0]}") + else: + print(f"Best: {fitness.min()}") + print(f"Worst: {fitness.max()}") + print(f"Mean: {fitness.mean()}") + print(f"Std: {fitness.std()}") + + return 0 diff --git a/pyproject.toml b/pyproject.toml index 29de9fc..5051837 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -19,6 +19,9 @@ numpy = "^1.26.1" [tool.poetry.group.test.dependencies] pytest = "^7.4.3" +[tool.poetry.scripts] +firefly-algorithm = 'fireflyalgorithm.cli:main' + [build-system] requires = ["poetry-core"] build-backend = "poetry.core.masonry.api" From a0fa93d6968e3be1472dce1c87c7ffa24d4e3f1b Mon Sep 17 00:00:00 2001 From: zStupan Date: Sun, 5 Nov 2023 20:25:35 +0100 Subject: [PATCH 20/51] Update README.md --- README.md | 41 +++++++++++++++++++++++++++++++++++++---- 1 file changed, 37 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index c325acc..8516155 100644 --- a/README.md +++ b/README.md @@ -41,11 +41,8 @@ $ yay -Syyu python-fireflyalgorithm ## Usage: ```python -import numpy as np from fireflyalgorithm import FireflyAlgorithm - -def sphere(x): - return np.sum(x ** 2) +from fireflyalgorithm.problems import sphere FA = FireflyAlgorithm() best = FA.run(function=sphere, dim=10, lb=-5, ub=5, max_evals=10000) @@ -53,6 +50,42 @@ best = FA.run(function=sphere, dim=10, lb=-5, ub=5, max_evals=10000) print(best) ``` +### Command line interface + +The package also comes with a simple command line interface which allows you to evaluate the algorithm on several +popular test functions + +```shell +firefly-algorithm -h +``` + +```text +usage: firefly-algorithm [-h] --problem PROBLEM -d DIMENSION -l LOWER -u UPPER -nfes MAX_EVALS [-r RUNS] [--pop-size POP_SIZE] [--alpha ALPHA] [--beta-min BETA_MIN] [--gamma GAMMA] [--seed SEED] + +Evaluate the Firefly Algorithm on one or more test functions + +options: + -h, --help show this help message and exit + --problem PROBLEM Test problem to evaluate + -d DIMENSION, --dimension DIMENSION + Dimension of the problem + -l LOWER, --lower LOWER + Lower bounds of the problem + -u UPPER, --upper UPPER + Upper bounds of the problem + -nfes MAX_EVALS, --max-evals MAX_EVALS + Max number of fitness function evaluations + -r RUNS, --runs RUNS Number of runs of the algorithm + --pop-size POP_SIZE Population size + --alpha ALPHA Randomness strength + --beta-min BETA_MIN Attractiveness constant + --gamma GAMMA Absorption coefficient + --seed SEED Seed for the random number generator +``` + +**Note:** The CLI script can also run as a python module (python -m niaarm ...) + + ## Reference Papers: I. Fister Jr., X.-S. Yang, I. Fister, J. Brest. [Memetic firefly algorithm for combinatorial optimization](http://www.iztok-jr-fister.eu/static/publications/44.pdf) in Bioinspired Optimization Methods and their Applications (BIOMA 2012), B. Filipic and J.Silc, Eds. From 2900c9e850c0c8ea757d30973ebf405bae668683 Mon Sep 17 00:00:00 2001 From: zStupan Date: Sun, 5 Nov 2023 22:21:04 +0100 Subject: [PATCH 21/51] add tests --- tests/test_firefly.py | 11 +-- tests/test_problems.py | 214 +++++++++++++++++++++++++++++++++++++++++ 2 files changed, 217 insertions(+), 8 deletions(-) create mode 100644 tests/test_problems.py diff --git a/tests/test_firefly.py b/tests/test_firefly.py index cc048b7..3a05a3d 100644 --- a/tests/test_firefly.py +++ b/tests/test_firefly.py @@ -1,15 +1,10 @@ from unittest import TestCase - -import numpy as np from fireflyalgorithm import FireflyAlgorithm - -def sphere(x): - return np.sum(x ** 2) +from fireflyalgorithm.problems import sphere class TestFA(TestCase): - def test_algorithm(self): - FA = FireflyAlgorithm() - best = FA.run(function=sphere, dim=10, lb=-5, ub=5, max_evals=10000) + algorithm = FireflyAlgorithm() + best = algorithm.run(function=sphere, dim=10, lb=-5, ub=5, max_evals=10000) self.assertLess(best, 5) diff --git a/tests/test_problems.py b/tests/test_problems.py new file mode 100644 index 0000000..7ced6bb --- /dev/null +++ b/tests/test_problems.py @@ -0,0 +1,214 @@ +from unittest import TestCase +import numpy as np +from fireflyalgorithm.problems import ( + get_problem, + ackley, + alpine1, + alpine2, + cigar, + cosine_mixture, + csendes, + dixon_price, + griewank, + katsuura, + levy, + michalewicz, + perm1, + perm2, + pinter, + powell, + quing, + quintic, + rastrigin, + rosenbrock, + salomon, + schaffer2, + schaffer4, + schwefel, + schwefel21, + schwefel22, + sphere, + step, + step2, + styblinski_tang, + trid, + weierstrass, + whitley, + zakharov, +) + + +class TestProblems(TestCase): + def test_problem_factory(self): + self.assertRaises(KeyError, get_problem, "spherekjl2") + self.assertEqual(get_problem("ackley"), ackley) + self.assertEqual(get_problem("alpine1"), alpine1) + self.assertEqual(get_problem("alpine2"), alpine2) + self.assertEqual(get_problem("cigar"), cigar) + self.assertEqual(get_problem("cosine_mixture"), cosine_mixture) + self.assertEqual(get_problem("csendes"), csendes) + self.assertEqual(get_problem("dixon_price"), dixon_price) + self.assertEqual(get_problem("griewank"), griewank) + self.assertEqual(get_problem("katsuura"), katsuura) + self.assertEqual(get_problem("levy"), levy) + self.assertEqual(get_problem("michalewicz"), michalewicz) + self.assertEqual(get_problem("perm1"), perm1) + self.assertEqual(get_problem("perm2"), perm2) + self.assertEqual(get_problem("pinter"), pinter) + self.assertEqual(get_problem("powell"), powell) + self.assertEqual(get_problem("quing"), quing) + self.assertEqual(get_problem("quintic"), quintic) + self.assertEqual(get_problem("rastrigin"), rastrigin) + self.assertEqual(get_problem("rosenbrock"), rosenbrock) + self.assertEqual(get_problem("salomon"), salomon) + self.assertEqual(get_problem("schaffer2"), schaffer2) + self.assertEqual(get_problem("schaffer4"), schaffer4) + self.assertEqual(get_problem("schwefel"), schwefel) + self.assertEqual(get_problem("schwefel21"), schwefel21) + self.assertEqual(get_problem("schwefel22"), schwefel22) + self.assertEqual(get_problem("sphere"), sphere) + self.assertEqual(get_problem("step"), step) + self.assertEqual(get_problem("step2"), step2) + self.assertEqual(get_problem("styblinski_tang"), styblinski_tang) + self.assertEqual(get_problem("trid"), trid) + self.assertEqual(get_problem("weierstrass"), weierstrass) + self.assertEqual(get_problem("whitley"), whitley) + self.assertEqual(get_problem("zakharov"), zakharov) + + def test_ackley(self): + x = np.zeros(5) + self.assertAlmostEqual(ackley(x), 0.0) + + def test_alpine1(self): + x = np.zeros(5) + self.assertAlmostEqual(alpine1(x), 0.0) + + def test_alpine2(self): + x = np.full(5, 7.9170526982459462172) + self.assertAlmostEqual(alpine2(x), 2.8081311800070053291**5) + + def test_cigar(self): + x = np.zeros(5) + self.assertAlmostEqual(cigar(x), 0.0) + + def test_cosine_mixture(self): + x = np.zeros(5) + self.assertAlmostEqual(cosine_mixture(x), -0.5) + + def test_csendes(self): + x = np.zeros(5) + self.assertAlmostEqual(csendes(x), 0.0) + + def test_dixon_price(self): + x = np.array([2 ** -((2**i - 2) / 2**i) for i in range(1, 6)]) + self.assertAlmostEqual(dixon_price(x), 0.0) + + def test_griewank(self): + x = np.zeros(5) + self.assertAlmostEqual(griewank(x), 0.0) + + def test_katsuura(self): + x = np.zeros(5) + self.assertAlmostEqual(katsuura(x), 1.0) + + def test_levy(self): + x = np.full(5, 1) + self.assertAlmostEqual(levy(x), 0.0) + + def test_michalewicz(self): + x = np.array([2.20290552014618, 1.57079632677565]) + self.assertAlmostEqual(michalewicz(x), -1.80130341009855321) + + def test_perm1(self): + x = np.arange(1, 6) + self.assertAlmostEqual(perm1(x), 0.0) + + def test_perm2(self): + x = 1 / np.arange(1, 6) + self.assertAlmostEqual(perm2(x), 0.0) + + def test_pinter(self): + x = np.zeros(5) + self.assertAlmostEqual(pinter(x), 0.0) + + def test_powell(self): + x = np.zeros(5) + self.assertAlmostEqual(powell(x), 0.0) + + def test_quing(self): + x = np.sqrt(np.arange(1, 6)) + self.assertAlmostEqual(quing(x), 0.0) + + def test_quintic(self): + x = np.full(5, -1) + self.assertAlmostEqual(quintic(x), 0.0) + + def test_rastrigin(self): + x = np.zeros(5) + self.assertAlmostEqual(rastrigin(x), 0.0) + + def test_rosenbrock(self): + x = np.full(5, 1) + self.assertAlmostEqual(rosenbrock(x), 0.0) + + def test_salomon(self): + x = np.zeros(5) + self.assertAlmostEqual(rastrigin(x), 0.0) + + def test_schaffer2(self): + x = np.zeros(5) + self.assertAlmostEqual(schaffer2(x), 0.0) + + def test_schaffer4(self): + x1 = np.array([0, 1.253131828792882]) + x2 = np.array([0, -1.253131828792882]) + x3 = np.array([1.253131828792882, 0]) + x4 = np.array([-1.253131828792882, 0]) + self.assertAlmostEqual(schaffer4(x1), 0.292578632035980) + self.assertAlmostEqual(schaffer4(x2), 0.292578632035980) + self.assertAlmostEqual(schaffer4(x3), 0.292578632035980) + self.assertAlmostEqual(schaffer4(x4), 0.292578632035980) + + def test_schwefel(self): + x = np.full(5, 420.968746) + self.assertAlmostEqual(schwefel(x), 0.0) + + def test_schwefel21(self): + x = np.zeros(5) + self.assertAlmostEqual(schwefel21(x), 0.0) + + def test_schwefel22(self): + x = np.zeros(5) + self.assertAlmostEqual(schwefel22(x), 0.0) + + def test_sphere(self): + x = np.zeros(5) + self.assertAlmostEqual(sphere(x), 0.0) + + def test_step(self): + x = np.full(5, 0.5) + self.assertAlmostEqual(step(x), 0.0) + + def test_step2(self): + x = np.full(5, 0.5) + self.assertAlmostEqual(step(x), 0.0) + + def test_styblinski_tang(self): + x = np.full(5, -2.903534018185960) + self.assertAlmostEqual(styblinski_tang(x), -39.16616570377142 * 5) + + def test_trid(self): + x = np.array([6, 10, 12, 12, 10, 6]) + self.assertAlmostEqual(trid(x), -50) + + def test_weierstrass(self): + x = np.zeros(5) + self.assertAlmostEqual(weierstrass(x), 0.0) + + def test_whitley(self): + x = np.full(5, 1) + self.assertAlmostEqual(whitley(x), 0.0) + + def test_zakharov(self): + x = np.zeros(5) + self.assertAlmostEqual(zakharov(x), 0.0) From 3987b11965d7bab0e531ca6a768f53a3bb96b2f5 Mon Sep 17 00:00:00 2001 From: zStupan Date: Sun, 5 Nov 2023 22:22:49 +0100 Subject: [PATCH 22/51] minor fixes --- .github/workflows/test.yml | 2 +- examples/run.py | 6 +----- fireflyalgorithm/problems.py | 6 ++++-- 3 files changed, 6 insertions(+), 8 deletions(-) diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml index bebce77..493457e 100644 --- a/.github/workflows/test.yml +++ b/.github/workflows/test.yml @@ -13,7 +13,7 @@ jobs: strategy: matrix: os: [ubuntu-latest, windows-latest, macos-latest] - python-version: ['3.9', '3.10'] + python-version: ['3.9', '3.10', '3.11', '3.12'] defaults: run: shell: bash diff --git a/examples/run.py b/examples/run.py index 8597751..645070a 100644 --- a/examples/run.py +++ b/examples/run.py @@ -1,9 +1,5 @@ -import numpy as np from fireflyalgorithm import FireflyAlgorithm - - -def sphere(x): - return np.sum(x ** 2) +from fireflyalgorithm.problems import sphere FA = FireflyAlgorithm() diff --git a/fireflyalgorithm/problems.py b/fireflyalgorithm/problems.py index e0747e6..20a412d 100644 --- a/fireflyalgorithm/problems.py +++ b/fireflyalgorithm/problems.py @@ -56,7 +56,7 @@ def katsuura(x): dim = len(x) k = np.atleast_2d(np.arange(1, 33)).T i = np.arange(0, dim * 1) - inner = np.round(2**k * x) * (2 ** (-k)) + inner = np.round(2**k * x) * (2.0 ** (-k)) return np.prod(np.sum(inner, axis=0) * (i + 1) + 1) @@ -165,7 +165,9 @@ def schaffer4(x): def schwefel(x): dim = len(x) - return 418.9829 * dim - np.sum(x * np.sin(np.sqrt(np.abs(x)))) + return 418.982887272433799807913601398 * dim - np.sum( + x * np.sin(np.sqrt(np.abs(x))) + ) def schwefel21(x): From da5f882076f159d0e66db8f19e1f229208b523cc Mon Sep 17 00:00:00 2001 From: Iztok Fister Jr Date: Mon, 6 Nov 2023 09:27:00 +0100 Subject: [PATCH 23/51] bump version to 0.4.0 --- fireflyalgorithm/__init__.py | 2 +- pyproject.toml | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/fireflyalgorithm/__init__.py b/fireflyalgorithm/__init__.py index cb5e64a..627a2d6 100644 --- a/fireflyalgorithm/__init__.py +++ b/fireflyalgorithm/__init__.py @@ -2,4 +2,4 @@ __all__ = ["FireflyAlgorithm"] -__version__ = "0.3.4" +__version__ = "0.4.0" diff --git a/pyproject.toml b/pyproject.toml index 5051837..9476ee2 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "fireflyalgorithm" -version = "0.3.4" +version = "0.4.0" description = "Implementation of Firefly Algorithm in Python" authors = ["Iztok Fister Jr. ", "Luka Pečnik ", "Žiga Stupan "] license = "MIT" From 09872a6aeaf70195d6e56efaa4d278a3f240bd5e Mon Sep 17 00:00:00 2001 From: zStupan <48752988+zStupan@users.noreply.github.com> Date: Mon, 6 Nov 2023 12:53:45 +0100 Subject: [PATCH 24/51] Fix typos --- fireflyalgorithm/problems.py | 4 ++-- tests/test_problems.py | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/fireflyalgorithm/problems.py b/fireflyalgorithm/problems.py index 20a412d..580cac7 100644 --- a/fireflyalgorithm/problems.py +++ b/fireflyalgorithm/problems.py @@ -124,7 +124,7 @@ def powell(x): return np.sum(term1 + term2 + term3 + term4) -def quing(x): +def qing(x): dim = len(x) return np.sum(np.power(x**2 - np.arange(1, dim + 1), 2)) @@ -245,7 +245,7 @@ def zakharov(x): "perm2": perm2, "pinter": pinter, "powell": powell, - "quing": quing, + "qing": qing, "quintic": quintic, "rastrigin": rastrigin, "rosenbrock": rosenbrock, diff --git a/tests/test_problems.py b/tests/test_problems.py index 7ced6bb..c28c47b 100644 --- a/tests/test_problems.py +++ b/tests/test_problems.py @@ -56,7 +56,7 @@ def test_problem_factory(self): self.assertEqual(get_problem("perm2"), perm2) self.assertEqual(get_problem("pinter"), pinter) self.assertEqual(get_problem("powell"), powell) - self.assertEqual(get_problem("quing"), quing) + self.assertEqual(get_problem("qing"), qing) self.assertEqual(get_problem("quintic"), quintic) self.assertEqual(get_problem("rastrigin"), rastrigin) self.assertEqual(get_problem("rosenbrock"), rosenbrock) @@ -135,7 +135,7 @@ def test_powell(self): x = np.zeros(5) self.assertAlmostEqual(powell(x), 0.0) - def test_quing(self): + def test_qing(self): x = np.sqrt(np.arange(1, 6)) self.assertAlmostEqual(quing(x), 0.0) From f55809e6a684b67a80d46a39cf71ac243c3e4a1d Mon Sep 17 00:00:00 2001 From: zStupan <48752988+zStupan@users.noreply.github.com> Date: Mon, 6 Nov 2023 12:56:04 +0100 Subject: [PATCH 25/51] fix typos --- tests/test_problems.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tests/test_problems.py b/tests/test_problems.py index c28c47b..4f5c93f 100644 --- a/tests/test_problems.py +++ b/tests/test_problems.py @@ -137,7 +137,7 @@ def test_powell(self): def test_qing(self): x = np.sqrt(np.arange(1, 6)) - self.assertAlmostEqual(quing(x), 0.0) + self.assertAlmostEqual(qing(x), 0.0) def test_quintic(self): x = np.full(5, -1) From 3b414d19f357938caca01c14967d238c9198164a Mon Sep 17 00:00:00 2001 From: zStupan <48752988+zStupan@users.noreply.github.com> Date: Mon, 6 Nov 2023 12:57:13 +0100 Subject: [PATCH 26/51] fix typos --- tests/test_problems.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tests/test_problems.py b/tests/test_problems.py index 4f5c93f..e00e479 100644 --- a/tests/test_problems.py +++ b/tests/test_problems.py @@ -17,7 +17,7 @@ perm2, pinter, powell, - quing, + qing, quintic, rastrigin, rosenbrock, From dd8f1a18812a0460882c8c534813c579a131de7f Mon Sep 17 00:00:00 2001 From: zStupan Date: Tue, 7 Nov 2023 15:42:21 +0100 Subject: [PATCH 27/51] added test problem definitions --- Problems.md | 389 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 389 insertions(+) create mode 100644 Problems.md diff --git a/Problems.md b/Problems.md new file mode 100644 index 0000000..84e1e95 --- /dev/null +++ b/Problems.md @@ -0,0 +1,389 @@ +# Test Functions + +Bellow You'll find the definitions of all the test functions implemented in this package. + +## Ackley +***Function name:*** `ackley` + +```math +f(x) = -20 e^{-0.2 \sqrt{\frac{1}{D} \sum_{i=1}^D x_i^2}} - e^{\frac{1}{D} \sum_{i=1}^D \cos(2 \pi x_i)} + 20 + e +``` + +**Dimensions:** $D$ + +**Global optimum:** $`f(x^*) = 0`$ for $`x_i^* = 0`$ + +## Alpine 1 +***Function name:*** `alpine1` + +```math +f(x) = \sum_{i=1}^{D} \lvert {x_i \sin \left( x_i \right) + 0.1 x_i} \rvert +``` + +**Dimensions:** $D$ + +**Global optimum:** $`f(x^*) = 0`$ for $`x_i^* = 0`$ + +## Alpine 2 +***Function name:*** `alpine2` + +```math +f(x) = \prod_{i=1}^{D} \sqrt{x_i} \sin(x_i) +``` + +**Dimensions:** $D$ + +**Global optimum:** $`f(x^*) = 2.808^D`$ for $`x_i^* = 7.917`$ + +## Cigar +***Function name:*** `cigar` + +```math +f(x) = x_1^2 + 10^6\sum_{i=2}^{D} x_i^2 +``` + +**Dimensions:** $D$ + +**Global optimum:** $`f(x^*) = 0`$ for $`x_i^* = 0`$ + +## Cosine Mixture +***Function name:*** `cosine_mixture` + +```math +f(x) = -0.1 \sum_{i=1}^D \cos (5 \pi x_i) - \sum_{i=1}^D x_i^2 +``` + +**Dimensions:** $D$ + +**Global optimum:** $`f(x^*) = -0.1 D`$ for $`x_i^* = 0`$ + +## Csendes +***Function name:*** `csendes` + +```math +f(x) = \sum_{i=1}^D x_i^6 \left( 2 + \sin \frac{1}{x_i}\right) +``` + +**Dimensions:** $D$ + +**Global optimum:** $`f(x^*) = 0`$ for $`x_i^* = 0`$ + +## Dixon-Price +***Function name:*** `dixon_price` + +```math +f(x) = (x_1 - 1)^2 + \sum_{i = 2}^D i (2x_i^2 - x_{i - 1})^2 +``` + +**Dimensions:** $D$ + +**Global optimum:** $`f(x^*) = 0`$ for $`x_i^* = 2^{- \frac{(2^i - 2)}{2^i}}`$ + +## Griewank +***Function name:*** `griewank` + +```math +f(x) = \sum_{i=1}^D \frac{x_i^2}{4000} - \prod_{i=1}^D \cos(\frac{x_i}{\sqrt{i}}) + 1 +``` + +**Dimensions:** $D$ + +**Global optimum:** $`f(x^*) = 0`$ for $`x_i^* = 0`$ + +## Katsuura +***Function name:*** `katsuura` + +```math +\prod_{i=1}^D \left(1 + i \sum_{j=1}^{32} \frac{\lvert 2^j x_i - round\left(2^j x_i \right) \rvert}{2^j} \right) +``` + +**Dimensions:** $D$ + +**Global optimum:** $`f(x^*) = 1`$ for $`x_i^* = 0`$ + +## Levy +***Function name:*** `levy` + +```math + \begin{gather} + \sin^2 (\pi w_1) + \sum_{i = 1}^{D - 1} (w_i - 1)^2 \left( 1 + 10 \sin^2 (\pi w_i + 1) \right) + (w_d - 1)^2 (1 + \sin^2 (2 \pi w_d)),\,\text{where}\\ + w_i = 1 + \frac{x_i - 1}{4},\, \text{for all } i = 1, \ldots, D + \end{gather} + +``` + +**Dimensions:** $D$ + +**Global optimum:** $`f(x^*) = 0`$ for $`x_i^* = 1`$ + +## Michalewicz +***Function name:*** `michalewicz` + +```math +f(x) = - \sum_{i = 1}^{D} \sin(x_i) \sin^{2m}\left( \frac{ix_i^2}{\pi} \right) +``` + +**Dimensions:** $D$ + +**Global optimum:** $`\text{at } D=2,\,f(x^*) = -1.8013`$ for $`x^* = (2.20, 1.57)`$ + +## Perm 1 +***Function name:*** `perm1` + +```math +f(x) = \sum_{i = 1}^D \left( \sum_{j = 1}^D (j^i + \beta) \left( \left(\frac{x_j}{j}\right)^i - 1 \right) \right)^2 +``` + +**Dimensions:** $D$ + +**Global optimum:** $`f(x^*) = 0`$ for $`x_i^* = i`$ + +## Perm 2 +***Function name:*** `perm2` + +```math +f(x) = \sum_{i = 1}^D \left( \sum_{j = 1}^D (j - \beta) \left( x_j^i - \frac{1}{j^i} \right) \right)^2 +``` + +**Dimensions:** $D$ + +**Global optimum:** $`f(x^*) = 0`$ for $`x_i^* = \frac{1}{i}`$ + +## Pinter +***Function name:*** `pinter` + +```math +\begin{equation} +f(\mathbf{x}) = +\sum_{i=1}^D ix_i^2 + \sum_{i=1}^D 20i \sin^2 A + \sum_{i=1}^D i \log_{10} (1 + iB^2),\, \text{where} +\end{equation} + +\begin{align} +A &= (x_{i-1}\sin(x_i)+\sin(x_{i+1})) \\ +B &= (x_{i-1}^2 - 2x_i + 3x_{i+1} - \cos(x_i) + 1) +\end{align} +``` + +**Dimensions:** $D$ + +**Global optimum:** $`f(x^*) = 0`$ for $`x_i^* = 0`$ + +## Powell +***Function name:*** `powell` + +```math +f(x) = \sum_{i = 1}^{D/4} \left[ (x_{4 i - 3} + 10 x_{4 i - 2})^2 + 5 (x_{4 i - 1} - x_{4 i})^2 + (x_{4 i - 2} - 2 x_{4 i - 1})^4 + 10 (x_{4 i - 3} - x_{4 i})^4 \right] +``` + +**Dimensions:** $D$ + +**Global optimum:** $`f(x^*) = 0`$ for $`x_i^* = 0`$ + +## Qing +***Function name:*** `qing` + +```math +f(x) = \sum_{i=1}^D \left(x_i^2 - i\right)^2 +``` + +**Dimensions:** $D$ + +**Global optimum:** $`f(x^*) = 0`$ for $`x_i^* = \pm \sqrt{i}`$ + +## Quintic +***Function name:*** `quintic` + +```math +f(x) = \sum_{i=1}^D \left| x_i^5 - 3x_i^4 + 4x_i^3 + 2x_i^2 - 10x_i - 4\right| +``` + +**Dimensions:** $D$ + +**Global optimum:** $`f(x^*) = 0`$ for $`x_i^* = -1\quad \text{or} \quad x_i^* = 2`$ + +## Rastrigin +***Function name:*** `rastrigin` + +```math +f(x) = 10D + \sum_{i=1}^D \left[x_i^2 -10\cos(2\pi x_i)\right] +``` + +**Dimensions:** $D$ + +**Global optimum:** $`f(x^*) = 0`$ for $`x_i^* = 0`$ + +## Rosenbrock +***Function name:*** `rosenbrock` + +```math +f(x) = \sum_{i=1}^{D-1} \left[100 (x_{i+1} - x_i^2)^2 + (x_i - 1)^2 \right] +``` + +**Dimensions:** $D$ + +**Global optimum:** $`f(x^*) = 0`$ for $`x_i^* = 1`$ + +## Salomon +***Function name:*** `salomon` + +```math +f(x) = 1 - \cos\left(2\pi\sqrt{\sum_{i=1}^D x_i^2} \right)+ 0.1 \sqrt{\sum_{i=1}^D x_i^2} +``` + +**Dimensions:** $D$ + +**Global optimum:** $`f(x^*) = 0`$ for $`x_i^* = 0`$ + +## Schaffer 2 +***Function name:*** `schaffer2` + +```math +f(x) = 0.5 + \frac{ \sin^2 \left( x_1^2 - x_2^2 \right) - 0.5 }{ \left[ 1 + 0.001 \left( x_1^2 + x_2^2 \right) \right]^2 } +``` + +**Dimensions:** 2 + +**Global optimum:** $`f(x^*) = 0`$ for $`x^* = (0, 0)`$ + +## Schaffer 4 +***Function name:*** `schaffer4` + +```math +f(x) = 0.5 + \frac{ \cos^2 \left( \sin \left( \vert x_1^2 - x_2^2\vert \right) \right)- 0.5 }{ \left[ 1 + 0.001 \left( x_1^2 + x_2^2 \right) \right]^2 } +``` + +**Dimensions:** 2 + +**Global optimum:** $`f(x^*) = 0.292579`$ for $`x^* = (0, \pm 1.25313) \text{or} (\pm 1.25313, 0)`$ + +## Schwefel +***Function name:*** `schwefel` + +```math +f(x) = 418.9829D - \sum_{i=1}^{D} x_i \sin(\sqrt{\lvert x_i \rvert}) +``` + +**Dimensions:** $D$ + +**Global optimum:** $`f(x^*) = 0`$ for $`x_i^* = 420.9687`$ + +## Schwefel 2.21 +***Function name:*** `schwefel221` + +```math +f(x) = \max_{1 \leq i \leq D} \vert x_i\vert +``` + +**Dimensions:** $D$ + +**Global optimum:** $`f(x^*) = 0`$ for $`x_i^* = 0`$ + +## Schwefel 2.22 +***Function name:*** `schwefel222` + +```math +f(x) = \sum_{i=1}^{D} \lvert x_i \rvert +\prod_{i=1}^{D} \lvert x_i \rvert +``` + +**Dimensions:** $D$ + +**Global optimum:** $`f(x^*) = 0`$ for $`x_i^* = 0`$ + +## Sphere +***Function name:*** `sphere` + +```math +f(x) = \sum_{i=1}^D x_i^2 +``` + +**Dimensions:** $D$ + +**Global optimum:** $`f(x^*) = 0`$ for $`x_i^* = 0`$ + +## Step +***Function name:*** `step` + +```math +f(x) = \sum_{i=1}^D \left( \lfloor \lvert x_i \rvert \rfloor \right) +``` + +**Dimensions:** $D$ + +**Global optimum:** $`f(x^*) = 0`$ for $`x_i^* = 0`$ + +## Step 2 +***Function name:*** `step2` + +```math +f(x) = \sum_{i=1}^D \left( \lfloor x_i + 0.5 \rfloor \right)^2 +``` + +**Dimensions:** $D$ + +**Global optimum:** $`f(x^*) = 0`$ for $`x_i^* = -0.5`$ + +## Styblinski-Tang +***Function name:*** `styblinski_tang` + +```math + +``` + +**Dimensions:** $D$ + +**Global optimum:** $`f(x^*) = -39.16599 D`$ for $`x_i^* = -2.903534`$ + +## Trid +***Function name:*** `trid` + +```math +f(x) = \sum_{i = 1}^D \left( x_i - 1 \right)^2 - \sum_{i = 2}^D x_i x_{i - 1} +``` + +**Dimensions:** $D$ + +**Global optimum:** $`f(x^*) = \frac{-D (D + 4) (D - 1)}{6}`$ for $`x_i^* = i (d + 1 - i)`$ + +## Weierstrass +***Function name:*** `weierstrass` + +```math +f(x) = \sum_{i=1}^D \left[ \sum_{k=0}^{k_{max}} a^k \cos\left( 2 \pi b^k ( x_i + 0.5) \right) \right] - D \sum_{k=0}^{k_{max}} a^k \cos \left(\pi b^k \right) +``` + +**Dimensions:** $D$ + +**Global optimum:** $`f(x^*) = 0`$ for $`x_i^* = 0`$ + +## Whitley +***Function name:*** `whitley` + +```math +f(x) = \sum_{i=1}^D \sum_{j=1}^D \left[\frac{(100(x_i^2-x_j)^2 + (1-x_j)^2)^2}{4000} - \cos(100(x_i^2-x_j)^2 + (1-x_j)^2)+1\right] +``` + +**Dimensions:** $D$ + +**Global optimum:** $`f(x^*) = 0`$ for $`x_i^* = 1`$ + +## Zakharov +***Function name:*** `zakharov` + +```math +f(x) = \sum_{i = 1}^D x_i^2 + \left( \sum_{i = 1}^D 0.5 i x_i \right)^2 + \left( \sum_{i = 1}^D 0.5 i x_i \right)^4 +``` + +**Dimensions:** $D$ + +**Global optimum:** $`f(x^*) = 0`$ for $`x_i^* = 0`$ + + +# References + +[1] P. Ernesto and U. Diliman, [“MVF–Multivariate Test Functions Library in C for Unconstrained Global Optimization,”](http://www.geocities.ws/eadorio/mvf.pdf) University of the Philippines Diliman, Quezon City, 2005. + +[2] M. Jamil and X.-S. Yang, [“A literature survey of benchmark functions for global optimisation problems,”](https://arxiv.org/abs/1308.4008) International Journal of Mathematical Modelling and Numerical Optimisation, vol. 4, no. 2, p. 150, Jan. 2013, doi: 10.1504/ijmmno.2013.055204. + +[3] J. J. Liang, B. Y. Qu, and P. N. Suganthan, [“Problem definitions and evaluation criteria for the CEC 2014 special session and competition on single objective real-parameter numerical optimization,”](http://bee22.com/manual/tf_images/Liang%20CEC2014.pdf) Computational Intelligence Laboratory, Zhengzhou University, Zhengzhou China and Technical Report, Nanyang Technological University, Singapore, vol. 635, no. 2, 2013. + +[4] S. Surjanovic and D. Bingham, Virtual Library of Simulation Experiments: Test Functions and Datasets. Retrieved November 7, 2023, from https://www.sfu.ca/~ssurjano/. From 19d9807c61485f25dc1aa3c591ad106fca4a3724 Mon Sep 17 00:00:00 2001 From: zStupan Date: Tue, 7 Nov 2023 16:10:02 +0100 Subject: [PATCH 28/51] fix pinter formula --- Problems.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/Problems.md b/Problems.md index 84e1e95..d19d0df 100644 --- a/Problems.md +++ b/Problems.md @@ -153,10 +153,8 @@ f(x) = \sum_{i = 1}^D \left( \sum_{j = 1}^D (j - \beta) \left( x_j^i - \frac{1} ***Function name:*** `pinter` ```math -\begin{equation} f(\mathbf{x}) = \sum_{i=1}^D ix_i^2 + \sum_{i=1}^D 20i \sin^2 A + \sum_{i=1}^D i \log_{10} (1 + iB^2),\, \text{where} -\end{equation} \begin{align} A &= (x_{i-1}\sin(x_i)+\sin(x_{i+1})) \\ From 89f02903bc602c3c48ce6b703bb8a40b6fb65905 Mon Sep 17 00:00:00 2001 From: zStupan <48752988+zStupan@users.noreply.github.com> Date: Tue, 7 Nov 2023 16:40:31 +0100 Subject: [PATCH 29/51] Update Problems.md - There were some rendering issues when doing \sqrt{\sum....} in ackley and salomon. Using \sum\nolimits instead. - Pinter was formatted wrong --- Problems.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/Problems.md b/Problems.md index d19d0df..7bb3ef6 100644 --- a/Problems.md +++ b/Problems.md @@ -6,7 +6,7 @@ Bellow You'll find the definitions of all the test functions implemented in this ***Function name:*** `ackley` ```math -f(x) = -20 e^{-0.2 \sqrt{\frac{1}{D} \sum_{i=1}^D x_i^2}} - e^{\frac{1}{D} \sum_{i=1}^D \cos(2 \pi x_i)} + 20 + e +f(x) = -20 e^{-0.2 \sqrt{D^{-1} \sum\nolimits_{i=1}^D x_i^2}} - e^{D^{-1} \sum\nolimits_{i=1}^D \cos(2 \pi x_i)} + 20 + e ``` **Dimensions:** $D$ @@ -153,9 +153,9 @@ f(x) = \sum_{i = 1}^D \left( \sum_{j = 1}^D (j - \beta) \left( x_j^i - \frac{1} ***Function name:*** `pinter` ```math -f(\mathbf{x}) = -\sum_{i=1}^D ix_i^2 + \sum_{i=1}^D 20i \sin^2 A + \sum_{i=1}^D i \log_{10} (1 + iB^2),\, \text{where} - +f(x) = \sum_{i=1}^D ix_i^2 + \sum_{i=1}^D 20i \sin^2 A + \sum_{i=1}^D i \log_{10} (1 + iB^2),\, \text{where} +``` +```math \begin{align} A &= (x_{i-1}\sin(x_i)+\sin(x_{i+1})) \\ B &= (x_{i-1}^2 - 2x_i + 3x_{i+1} - \cos(x_i) + 1) @@ -225,7 +225,7 @@ f(x) = \sum_{i=1}^{D-1} \left[100 (x_{i+1} - x_i^2)^2 + (x_i - 1)^2 \right] ***Function name:*** `salomon` ```math -f(x) = 1 - \cos\left(2\pi\sqrt{\sum_{i=1}^D x_i^2} \right)+ 0.1 \sqrt{\sum_{i=1}^D x_i^2} +f(x) = 1 - \cos\left(2\pi\sqrt{\sum\nolimits_{i=1}^D x_i^2} \right)+ 0.1 \sqrt{\sum\nolimits_{i=1}^D x_i^2} ``` **Dimensions:** $D$ From 582aeded15ac472d67cfe9987b98acea0f0a62e4 Mon Sep 17 00:00:00 2001 From: zStupan Date: Tue, 7 Nov 2023 16:42:37 +0100 Subject: [PATCH 30/51] minor fixes --- fireflyalgorithm/problems.py | 14 +++++++------- tests/test_problems.py | 16 ++++++++-------- 2 files changed, 15 insertions(+), 15 deletions(-) diff --git a/fireflyalgorithm/problems.py b/fireflyalgorithm/problems.py index 580cac7..c0718cc 100644 --- a/fireflyalgorithm/problems.py +++ b/fireflyalgorithm/problems.py @@ -55,9 +55,9 @@ def griewank(x): def katsuura(x): dim = len(x) k = np.atleast_2d(np.arange(1, 33)).T - i = np.arange(0, dim * 1) + i = np.arange(1, dim + 1) inner = np.round(2**k * x) * (2.0 ** (-k)) - return np.prod(np.sum(inner, axis=0) * (i + 1) + 1) + return np.prod(np.sum(inner, axis=0) * i + 1) def levy(x): @@ -158,7 +158,7 @@ def schaffer2(x): def schaffer4(x): return ( 0.5 - + (np.cos(np.sin(x[0] ** 2 - x[1] ** 2)) ** 2 - 0.5) + + (np.cos(np.sin(abs(x[0] ** 2 - x[1] ** 2))) ** 2 - 0.5) / (1 + 0.001 * (x[0] ** 2 + x[1] ** 2)) ** 2 ) @@ -170,11 +170,11 @@ def schwefel(x): ) -def schwefel21(x): +def schwefel221(x): return np.amax(np.abs(x)) -def schwefel22(x): +def schwefel222(x): return np.sum(np.abs(x)) + np.prod(np.abs(x)) @@ -253,8 +253,8 @@ def zakharov(x): "schaffer2": schaffer2, "schaffer4": schaffer4, "schwefel": schwefel, - "schwefel21": schwefel21, - "schwefel22": schwefel22, + "schwefel221": schwefel221, + "schwefel222": schwefel222, "sphere": sphere, "step": step, "step2": step2, diff --git a/tests/test_problems.py b/tests/test_problems.py index e00e479..c91fed9 100644 --- a/tests/test_problems.py +++ b/tests/test_problems.py @@ -25,8 +25,8 @@ schaffer2, schaffer4, schwefel, - schwefel21, - schwefel22, + schwefel221, + schwefel222, sphere, step, step2, @@ -64,8 +64,8 @@ def test_problem_factory(self): self.assertEqual(get_problem("schaffer2"), schaffer2) self.assertEqual(get_problem("schaffer4"), schaffer4) self.assertEqual(get_problem("schwefel"), schwefel) - self.assertEqual(get_problem("schwefel21"), schwefel21) - self.assertEqual(get_problem("schwefel22"), schwefel22) + self.assertEqual(get_problem("schwefel221"), schwefel221) + self.assertEqual(get_problem("schwefel222"), schwefel222) self.assertEqual(get_problem("sphere"), sphere) self.assertEqual(get_problem("step"), step) self.assertEqual(get_problem("step2"), step2) @@ -175,11 +175,11 @@ def test_schwefel(self): def test_schwefel21(self): x = np.zeros(5) - self.assertAlmostEqual(schwefel21(x), 0.0) + self.assertAlmostEqual(schwefel221(x), 0.0) def test_schwefel22(self): x = np.zeros(5) - self.assertAlmostEqual(schwefel22(x), 0.0) + self.assertAlmostEqual(schwefel222(x), 0.0) def test_sphere(self): x = np.zeros(5) @@ -190,8 +190,8 @@ def test_step(self): self.assertAlmostEqual(step(x), 0.0) def test_step2(self): - x = np.full(5, 0.5) - self.assertAlmostEqual(step(x), 0.0) + x = np.full(5, -0.5) + self.assertAlmostEqual(step2(x), 0.0) def test_styblinski_tang(self): x = np.full(5, -2.903534018185960) From 1397b1e6a55c3c85fece1c1baeabaa317ea40a4a Mon Sep 17 00:00:00 2001 From: zStupan Date: Tue, 7 Nov 2023 17:01:45 +0100 Subject: [PATCH 31/51] Update README.md --- README.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/README.md b/README.md index 8516155..9fcb701 100644 --- a/README.md +++ b/README.md @@ -50,6 +50,19 @@ best = FA.run(function=sphere, dim=10, lb=-5, ub=5, max_evals=10000) print(best) ``` +### Test functions + +In the `fireflyalgorithm.problems` module, you can find the implementations of 33 popular optimization test problems. Additionally, the module provides a utility function, `get_problem`, that allows you to retrieve a specific optimization problem function by providing its name as a string: + +```python +from fireflyalgorithm.problems import get_problem + +# same as from fireflyalgorithm.problems import rosenbrock +rosenbrock = get_problem('rosenbrock') +``` + +For more information about the implemented test functions, [click here](Problems.md) + ### Command line interface The package also comes with a simple command line interface which allows you to evaluate the algorithm on several From d380dd5705578045beef75e24efff039a607571d Mon Sep 17 00:00:00 2001 From: Iztok Fister Jr Date: Fri, 10 Nov 2023 09:36:33 +0100 Subject: [PATCH 32/51] bump version --- fireflyalgorithm/__init__.py | 2 +- pyproject.toml | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/fireflyalgorithm/__init__.py b/fireflyalgorithm/__init__.py index 627a2d6..35ed0d4 100644 --- a/fireflyalgorithm/__init__.py +++ b/fireflyalgorithm/__init__.py @@ -2,4 +2,4 @@ __all__ = ["FireflyAlgorithm"] -__version__ = "0.4.0" +__version__ = "0.4.1" diff --git a/pyproject.toml b/pyproject.toml index 9476ee2..3fdb198 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "fireflyalgorithm" -version = "0.4.0" +version = "0.4.1" description = "Implementation of Firefly Algorithm in Python" authors = ["Iztok Fister Jr. ", "Luka Pečnik ", "Žiga Stupan "] license = "MIT" From ddaeff7cab66ca7f079c6a9fbea6817874568459 Mon Sep 17 00:00:00 2001 From: Iztok Fister Jr Date: Sat, 25 Nov 2023 21:22:42 +0100 Subject: [PATCH 33/51] Add installation instructions for Alpine --- README.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/README.md b/README.md index 9fcb701..8d0c1ee 100644 --- a/README.md +++ b/README.md @@ -37,6 +37,10 @@ To install FireflyAlgorithm on Arch Linux, please use an [AUR helper](https://wi ```sh $ yay -Syyu python-fireflyalgorithm ``` +To install FireflyAlgorithm on Alpine Linux: +```sh +$ apk add py3-fireflyalgorithm +``` ## Usage: From 8df73448b053186648e1e6905cb5f21541700ac1 Mon Sep 17 00:00:00 2001 From: "Iztok Fister Jr." Date: Sun, 3 Dec 2023 13:01:17 +0100 Subject: [PATCH 34/51] Update changelog --- CHANGELOG.md | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 18d1380..2964d4a 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,34 @@ # Changelog +## [0.4.1](https://github.com/firefly-cpp/FireflyAlgorithm/tree/0.4.1) (2023-11-10) + +[Full Changelog](https://github.com/firefly-cpp/FireflyAlgorithm/compare/0.4.0...0.4.1) + +**Closed issues:** + +- Create Problems.md [\#18](https://github.com/firefly-cpp/FireflyAlgorithm/issues/18) + +**Merged pull requests:** + +- Add Test Function definitions [\#19](https://github.com/firefly-cpp/FireflyAlgorithm/pull/19) ([zStupan](https://github.com/zStupan)) + +## [0.4.0](https://github.com/firefly-cpp/FireflyAlgorithm/tree/0.4.0) (2023-11-06) + +[Full Changelog](https://github.com/firefly-cpp/FireflyAlgorithm/compare/0.3.4...0.4.0) + +**Closed issues:** + +- Enhance tests [\#16](https://github.com/firefly-cpp/FireflyAlgorithm/issues/16) +- Provide Command Line Interface \(CLI\) [\#13](https://github.com/firefly-cpp/FireflyAlgorithm/issues/13) +- Add installation instructions for Arch Linux [\#11](https://github.com/firefly-cpp/FireflyAlgorithm/issues/11) + +**Merged pull requests:** + +- Add tests [\#17](https://github.com/firefly-cpp/FireflyAlgorithm/pull/17) ([zStupan](https://github.com/zStupan)) +- Added a Command Line Interface [\#15](https://github.com/firefly-cpp/FireflyAlgorithm/pull/15) ([zStupan](https://github.com/zStupan)) +- Improve workflows [\#14](https://github.com/firefly-cpp/FireflyAlgorithm/pull/14) ([firefly-cpp](https://github.com/firefly-cpp)) +- Add instructions for install FireflyAlgorithm in Arch Linux [\#12](https://github.com/firefly-cpp/FireflyAlgorithm/pull/12) ([carlosal1015](https://github.com/carlosal1015)) + ## [0.3.4](https://github.com/firefly-cpp/FireflyAlgorithm/tree/0.3.4) (2022-12-13) [Full Changelog](https://github.com/firefly-cpp/FireflyAlgorithm/compare/0.3.3...0.3.4) From c44467e8b252a3293393f46fbb4c6af28e954865 Mon Sep 17 00:00:00 2001 From: Tadej Lahovnik Date: Mon, 4 Dec 2023 10:36:46 +0100 Subject: [PATCH 35/51] doc: Templates --- .github/templates/FEATURE_REQUEST.md | 16 ++++++++++++++++ .github/templates/ISSUE_TEMPLATE.md | 18 ++++++++++++++++++ .github/templates/PULL_REQUEST.md | 14 ++++++++++++++ 3 files changed, 48 insertions(+) create mode 100644 .github/templates/FEATURE_REQUEST.md create mode 100644 .github/templates/ISSUE_TEMPLATE.md create mode 100644 .github/templates/PULL_REQUEST.md diff --git a/.github/templates/FEATURE_REQUEST.md b/.github/templates/FEATURE_REQUEST.md new file mode 100644 index 0000000..5a1ccc4 --- /dev/null +++ b/.github/templates/FEATURE_REQUEST.md @@ -0,0 +1,16 @@ +### Feature Request + +**About**: +**Title**: + +**Is your feature request related to a problem? Please describe.** +A clear and concise description of what the problem is. Ex. I'm always frustrated when [...] + +**Describe the solution you'd like** +A clear and concise description of what you want to happen. + +**Describe alternatives you've considered** +A clear and concise description of any alternative solutions or features you've considered. + +**Additional context** +Add any other context or screenshots about the feature request here. \ No newline at end of file diff --git a/.github/templates/ISSUE_TEMPLATE.md b/.github/templates/ISSUE_TEMPLATE.md new file mode 100644 index 0000000..90325f5 --- /dev/null +++ b/.github/templates/ISSUE_TEMPLATE.md @@ -0,0 +1,18 @@ +### Bug Report + +**About**: +**Title**: + +**Steps to reproduce** +Tell us how to reproduce the bug. + +**Expected behavior** +Tell us what should happen. + +**Actual behavior** +Tell us what happens instead. + +**System configuration** + + - OS: + - Python version: \ No newline at end of file diff --git a/.github/templates/PULL_REQUEST.md b/.github/templates/PULL_REQUEST.md new file mode 100644 index 0000000..9a87d5d --- /dev/null +++ b/.github/templates/PULL_REQUEST.md @@ -0,0 +1,14 @@ +### Summary + +Provide a general description of the code changes in your pull +request... were there any bugs you had fixed? If so, mention them. If +these bugs have open GitHub issues, be sure to tag them here as well, +to keep the conversation linked together. + +### Other Information + +If there's anything else that's important and relevant to your pull +request, mention that information here. This could include +benchmarks, or other information. + +Thanks for contributing to Firefly Algorithm! \ No newline at end of file From 362c777e113913a14c5121ef6db12dc438c31059 Mon Sep 17 00:00:00 2001 From: Tadej Lahovnik Date: Mon, 4 Dec 2023 10:37:01 +0100 Subject: [PATCH 36/51] doc: Contribution guide --- CONTRIBUTING.md | 54 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 54 insertions(+) create mode 100644 CONTRIBUTING.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..6162d8d --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,54 @@ +# Contributing to Firefly Algorithm +:+1::tada: First off, thanks for taking the time to contribute! :tada::+1: + +## Code of Conduct +This project and everyone participating in it is governed by the [Firefly Algorithm Code of Conduct](CODE_OF_CONDUCT.md). By participating, you are expected to uphold this code. Please report unacceptable behavior to [iztok.fister1@um.si](mailto:iztok.fister1@um.si). + +## How Can I Contribute? + +### Reporting Bugs +Before creating bug reports, please check existing issues list as you might find out that you don't need to create one. When you are creating a bug report, please include as many details as possible in the [issue template](.github/templates/ISSUE_TEMPLATE.md). + +### Suggesting Enhancements + +Open new issue using the [feature request template](.github/templates/FEATURE_REQUEST.md). + +### Pull requests + +Fill in the [pull request template](.github/templates/PULL_REQUEST.md) and make sure your code is documented. + +## Setup development environment + +### Requirements + +* Poetry: [https://python-poetry.org/docs](https://python-poetry.org/docs) + +After installing Poetry and cloning the project from GitHub, you should run the following command from the root of the cloned project: + +```sh +poetry install +``` + +All of the project's dependencies should be installed and the project ready for further development. **Note that Poetry creates a separate virtual environment for your project.** + +### Dependencies + +| Package | Version | Platform | +|----------|:-------:|:--------:| +| numpy | ^1.26.1 | All | + +#### Development dependencies + +| Package | Version | Platform | +|---------|:--------:|:--------:| +| pytest | ^7.4.3 | Any | + +## Development Tasks + +### Testing + +Manually run the tests: + +```sh +poetry run pytest +``` \ No newline at end of file From f89e607ea84b62ec4747b6bfb3cf4bbe3d0edd98 Mon Sep 17 00:00:00 2001 From: Tadej Lahovnik Date: Mon, 4 Dec 2023 10:40:47 +0100 Subject: [PATCH 37/51] doc: README --- README.md | 21 ++++++++++----------- 1 file changed, 10 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index 8d0c1ee..f0208fe 100644 --- a/README.md +++ b/README.md @@ -19,11 +19,11 @@ [![Percentage of issues still open](http://isitmaintained.com/badge/open/firefly-cpp/FireflyAlgorithm.svg)](http://isitmaintained.com/project/firefly-cpp/FireflyAlgorithm "Percentage of issues still open") ![GitHub contributors](https://img.shields.io/github/contributors/firefly-cpp/FireflyAlgorithm.svg) -## About +## About 📋 -This package implements a nature-inspired algorithm for optimization called Firefly Algorithm (FA) in Python programming language. +This package implements a nature-inspired algorithm for optimization called Firefly Algorithm (FA) in Python programming language. 🌿🔍💻 -## Installation: +## Installation 📦 Install FireflyAlgorithm with pip: ```sh @@ -42,7 +42,7 @@ To install FireflyAlgorithm on Alpine Linux: $ apk add py3-fireflyalgorithm ``` -## Usage: +## Usage 🚀 ```python from fireflyalgorithm import FireflyAlgorithm @@ -54,7 +54,7 @@ best = FA.run(function=sphere, dim=10, lb=-5, ub=5, max_evals=10000) print(best) ``` -### Test functions +### Test functions 📈 In the `fireflyalgorithm.problems` module, you can find the implementations of 33 popular optimization test problems. Additionally, the module provides a utility function, `get_problem`, that allows you to retrieve a specific optimization problem function by providing its name as a string: @@ -65,12 +65,11 @@ from fireflyalgorithm.problems import get_problem rosenbrock = get_problem('rosenbrock') ``` -For more information about the implemented test functions, [click here](Problems.md) +For more information about the implemented test functions, [click here](Problems.md). -### Command line interface +### Command line interface 🖥️ -The package also comes with a simple command line interface which allows you to evaluate the algorithm on several -popular test functions +The package also comes with a simple command line interface which allows you to evaluate the algorithm on several popular test functions. 🔬 ```shell firefly-algorithm -h @@ -100,10 +99,10 @@ options: --seed SEED Seed for the random number generator ``` -**Note:** The CLI script can also run as a python module (python -m niaarm ...) +**Note:** The CLI script can also run as a python module (python -m niaarm ...). -## Reference Papers: +## Reference Papers 📚 I. Fister Jr., X.-S. Yang, I. Fister, J. Brest. [Memetic firefly algorithm for combinatorial optimization](http://www.iztok-jr-fister.eu/static/publications/44.pdf) in Bioinspired Optimization Methods and their Applications (BIOMA 2012), B. Filipic and J.Silc, Eds. Jozef Stefan Institute, Ljubljana, Slovenia, 2012 From 6044bfe78ec0fefa8fdf38cc9ad71cab916c59eb Mon Sep 17 00:00:00 2001 From: Tadej Lahovnik Date: Mon, 4 Dec 2023 10:41:52 +0100 Subject: [PATCH 38/51] doc: Code of conduct --- CODE_OF_CONDUCT.md | 46 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 46 insertions(+) create mode 100644 CODE_OF_CONDUCT.md diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md new file mode 100644 index 0000000..7e77a3a --- /dev/null +++ b/CODE_OF_CONDUCT.md @@ -0,0 +1,46 @@ +# Contributor Covenant Code of Conduct + +## Our Pledge + +In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation. + +## Our Standards + +Examples of behavior that contributes to creating a positive environment include: + +* Using welcoming and inclusive language +* Being respectful of differing viewpoints and experiences +* Gracefully accepting constructive criticism +* Focusing on what is best for the community +* Showing empathy towards other community members + +Examples of unacceptable behavior by participants include: + +* The use of sexualized language or imagery and unwelcome sexual attention or advances +* Trolling, insulting/derogatory comments, and personal or political attacks +* Public or private harassment +* Publishing others' private information, such as a physical or electronic address, without explicit permission +* Other conduct which could reasonably be considered inappropriate in a professional setting + +## Our Responsibilities + +Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior. + +Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful. + +## Scope + +This Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers. + +## Enforcement + +Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team. The project team will review and investigate all complaints, and will respond in a way that it deems appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately. + +Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership. + +## Attribution + +This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, available at [http://contributor-covenant.org/version/1/4][version] + +[homepage]: http://contributor-covenant.org +[version]: http://contributor-covenant.org/version/1/4/ From 0d8243b5da7c63cb1ec0c87722345306f048499f Mon Sep 17 00:00:00 2001 From: Iztok Fister Jr Date: Mon, 4 Dec 2023 12:57:53 +0100 Subject: [PATCH 39/51] Fix error in CLI note --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index f0208fe..df9880d 100644 --- a/README.md +++ b/README.md @@ -99,7 +99,7 @@ options: --seed SEED Seed for the random number generator ``` -**Note:** The CLI script can also run as a python module (python -m niaarm ...). +**Note:** The CLI script can also run as a python module (python -m fireflyalgorithm ...). ## Reference Papers 📚 From 6deaed1838918ced61c34bcf0ac7bdd75f7c86a1 Mon Sep 17 00:00:00 2001 From: "Iztok Fister Jr." Date: Mon, 4 Dec 2023 13:21:03 +0100 Subject: [PATCH 40/51] Bump version to 0.4.2 --- fireflyalgorithm/__init__.py | 2 +- pyproject.toml | 5 +++-- 2 files changed, 4 insertions(+), 3 deletions(-) diff --git a/fireflyalgorithm/__init__.py b/fireflyalgorithm/__init__.py index 35ed0d4..1a8dc9b 100644 --- a/fireflyalgorithm/__init__.py +++ b/fireflyalgorithm/__init__.py @@ -2,4 +2,4 @@ __all__ = ["FireflyAlgorithm"] -__version__ = "0.4.1" +__version__ = "0.4.2" diff --git a/pyproject.toml b/pyproject.toml index 3fdb198..a35c836 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "fireflyalgorithm" -version = "0.4.1" +version = "0.4.2" description = "Implementation of Firefly Algorithm in Python" authors = ["Iztok Fister Jr. ", "Luka Pečnik ", "Žiga Stupan "] license = "MIT" @@ -9,7 +9,8 @@ homepage = "https://github.com/firefly-cpp/FireflyAlgorithm" repository = "https://github.com/firefly-cpp/FireflyAlgorithm" include = [ - { path="LICENSE", format="sdist" } + { path="LICENSE", format="sdist" }, + { path="Problems.md", format="sdist" } ] [tool.poetry.dependencies] From 022942c23b65e1241d6b7b74eb4645334e6752dc Mon Sep 17 00:00:00 2001 From: "Iztok Fister Jr." Date: Tue, 5 Dec 2023 12:19:26 +0100 Subject: [PATCH 41/51] Update changelog --- CHANGELOG.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 2964d4a..ecb6ba2 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,13 @@ # Changelog +## [0.4.2](https://github.com/firefly-cpp/FireflyAlgorithm/tree/0.4.2) (2023-12-04) + +[Full Changelog](https://github.com/firefly-cpp/FireflyAlgorithm/compare/0.4.1...0.4.2) + +**Merged pull requests:** + +- Contribution guide [\#20](https://github.com/firefly-cpp/FireflyAlgorithm/pull/20) ([lahovniktadej](https://github.com/lahovniktadej)) + ## [0.4.1](https://github.com/firefly-cpp/FireflyAlgorithm/tree/0.4.1) (2023-11-10) [Full Changelog](https://github.com/firefly-cpp/FireflyAlgorithm/compare/0.4.0...0.4.1) From cf24a8a1e8541b8ac05215cb06cfc7247bd55293 Mon Sep 17 00:00:00 2001 From: Iztok Fister Jr Date: Thu, 21 Dec 2023 17:54:27 +0100 Subject: [PATCH 42/51] in repositories badge --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index df9880d..34928c9 100644 --- a/README.md +++ b/README.md @@ -18,6 +18,7 @@ [![Average time to resolve an issue](http://isitmaintained.com/badge/resolution/firefly-cpp/FireflyAlgorithm.svg)](http://isitmaintained.com/project/firefly-cpp/FireflyAlgorithm "Average time to resolve an issue") [![Percentage of issues still open](http://isitmaintained.com/badge/open/firefly-cpp/FireflyAlgorithm.svg)](http://isitmaintained.com/project/firefly-cpp/FireflyAlgorithm "Percentage of issues still open") ![GitHub contributors](https://img.shields.io/github/contributors/firefly-cpp/FireflyAlgorithm.svg) +[![Packaging status](https://repology.org/badge/tiny-repos/python:fireflyalgorithm.svg)](https://repology.org/project/python:fireflyalgorithm/versions) ## About 📋 From 65dd6c078d713dc95449c985809c30ab4e3a3504 Mon Sep 17 00:00:00 2001 From: Iztok Fister Jr Date: Mon, 25 Dec 2023 16:38:47 +0100 Subject: [PATCH 43/51] Badge for Zenodo DOI --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index 34928c9..f8cb55e 100644 --- a/README.md +++ b/README.md @@ -19,6 +19,7 @@ [![Percentage of issues still open](http://isitmaintained.com/badge/open/firefly-cpp/FireflyAlgorithm.svg)](http://isitmaintained.com/project/firefly-cpp/FireflyAlgorithm "Percentage of issues still open") ![GitHub contributors](https://img.shields.io/github/contributors/firefly-cpp/FireflyAlgorithm.svg) [![Packaging status](https://repology.org/badge/tiny-repos/python:fireflyalgorithm.svg)](https://repology.org/project/python:fireflyalgorithm/versions) +[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.10430919.svg)](https://doi.org/10.5281/zenodo.10430919) ## About 📋 From fdfb6fac3895ba7466bceca7166ef1f39ce94a25 Mon Sep 17 00:00:00 2001 From: "Iztok Fister Jr." Date: Mon, 25 Dec 2023 16:42:31 +0100 Subject: [PATCH 44/51] Add CITATION.cff and bump version --- CITATION.cff | 21 +++++++++++++++++++++ fireflyalgorithm/__init__.py | 2 +- pyproject.toml | 2 +- 3 files changed, 23 insertions(+), 2 deletions(-) create mode 100644 CITATION.cff diff --git a/CITATION.cff b/CITATION.cff new file mode 100644 index 0000000..9737ab3 --- /dev/null +++ b/CITATION.cff @@ -0,0 +1,21 @@ +abstract: Implementation of Firefly Algorithm in Python +authors: +- family-names: Fister Jr. + given-names: Iztok + orcid: 0000-0002-6418-1272 +- affiliation: '@poviolabs' + family-names: "Pe\u010Dnik" + given-names: Luka + orcid: 0000-0002-3897-9774 +- family-names: Stupan + given-names: "\u017Diga" + orcid: 0000-0001-9847-7306 +cff-version: 1.2.0 +date-released: '2023-12-25' +doi: 10.5281/zenodo.10430919 +license: +- MIT +repository-code: https://github.com/firefly-cpp/FireflyAlgorithm/tree/0.4.4 +title: 'firefly-cpp/FireflyAlgorithm: 0.4.4' +type: software +version: 0.4.4 diff --git a/fireflyalgorithm/__init__.py b/fireflyalgorithm/__init__.py index 1a8dc9b..52d052d 100644 --- a/fireflyalgorithm/__init__.py +++ b/fireflyalgorithm/__init__.py @@ -2,4 +2,4 @@ __all__ = ["FireflyAlgorithm"] -__version__ = "0.4.2" +__version__ = "0.4.4" diff --git a/pyproject.toml b/pyproject.toml index a35c836..b265e6b 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "fireflyalgorithm" -version = "0.4.2" +version = "0.4.4" description = "Implementation of Firefly Algorithm in Python" authors = ["Iztok Fister Jr. ", "Luka Pečnik ", "Žiga Stupan "] license = "MIT" From e4976c0f12db7d184e71d2faec711b56c5e7e111 Mon Sep 17 00:00:00 2001 From: Iztok Fister Jr Date: Sun, 31 Dec 2023 22:57:23 +0100 Subject: [PATCH 45/51] Repo size badge --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index f8cb55e..1d1a69a 100644 --- a/README.md +++ b/README.md @@ -12,6 +12,7 @@ ![PyPI - Python Version](https://img.shields.io/pypi/pyversions/fireflyalgorithm.svg) ![PyPI - Downloads](https://img.shields.io/pypi/dm/fireflyalgorithm.svg) [![Downloads](https://pepy.tech/badge/fireflyalgorithm)](https://pepy.tech/project/fireflyalgorithm) +![GitHub repo size](https://img.shields.io/github/repo-size/firefly-cpp/FireflyAlgorithm?style=flat-square) [![AUR package](https://img.shields.io/aur/version/python-fireflyalgorithm?color=blue&label=Arch%20Linux&logo=arch-linux)](https://aur.archlinux.org/packages/python-fireflyalgorithm) [![GitHub license](https://img.shields.io/github/license/firefly-cpp/FireflyAlgorithm.svg)](https://github.com/firefly-cpp/FireflyAlgorithm/blob/master/LICENSE) ![GitHub commit activity](https://img.shields.io/github/commit-activity/w/firefly-cpp/FireflyAlgorithm.svg) From ea450bb043951f488b3575872f1df51edbbfb8e7 Mon Sep 17 00:00:00 2001 From: Iztok Fister Jr Date: Thu, 4 Jan 2024 21:03:33 +0100 Subject: [PATCH 46/51] Add citation details in README --- README.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/README.md b/README.md index 1d1a69a..8c4a8c6 100644 --- a/README.md +++ b/README.md @@ -112,6 +112,10 @@ Jozef Stefan Institute, Ljubljana, Slovenia, 2012 I. Fister, I. Fister Jr., X.-S. Yang, J. Brest. [A comprehensive review of firefly algorithms](http://www.iztok-jr-fister.eu/static/publications/23.pdf). Swarm and Evolutionary Computation 13 (2013): 34-46. +## Cite us + +Fister Jr., I., Pečnik, L., & Stupan, Ž. (2023). firefly-cpp/FireflyAlgorithm: 0.4.3 (0.4.3). Zenodo. [https://doi.org/10.5281/zenodo.10430919](https://doi.org/10.5281/zenodo.10430919) + ## License This package is distributed under the MIT License. This license can be found online at . From 79fca912def012796fea86e38bdee0cec95a11be Mon Sep 17 00:00:00 2001 From: Iztok Fister Jr Date: Tue, 6 Feb 2024 19:22:13 +0100 Subject: [PATCH 47/51] Add keywords in pyproject --- pyproject.toml | 1 + 1 file changed, 1 insertion(+) diff --git a/pyproject.toml b/pyproject.toml index b265e6b..01cd204 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -3,6 +3,7 @@ name = "fireflyalgorithm" version = "0.4.4" description = "Implementation of Firefly Algorithm in Python" authors = ["Iztok Fister Jr. ", "Luka Pečnik ", "Žiga Stupan "] +keywords = ['computational intelligence', 'firefly algorithm', 'swarm intelligence', 'optimization'] license = "MIT" readme = "README.md" homepage = "https://github.com/firefly-cpp/FireflyAlgorithm" From 1aa98df0246ee75d39abd92be7f54c3000dbce92 Mon Sep 17 00:00:00 2001 From: Tadej Lahovnik Date: Mon, 22 Jul 2024 09:39:20 +0200 Subject: [PATCH 48/51] doc: README Table of contents --- README.md | 63 ++++++++++++++++++++++++++++++++++--------------------- 1 file changed, 39 insertions(+), 24 deletions(-) diff --git a/README.md b/README.md index 8c4a8c6..527a1b2 100644 --- a/README.md +++ b/README.md @@ -2,33 +2,48 @@

---- +

+Firefly Algorithm --- Implementation of Firefly algorithm in Python +

-# Firefly Algorithm --- Implementation of Firefly algorithm in Python +

+ PyPI Version + PyPI - Python Version + Downloads + GitHub repo size + AUR package + GitHub license + build +

---- +

+ GitHub commit activity + Average time to resolve an issue + Percentage of issues still open + GitHub contributors + Packaging status +

-[![PyPI Version](https://img.shields.io/pypi/v/fireflyalgorithm.svg)](https://pypi.python.org/pypi/fireflyalgorithm) -![PyPI - Python Version](https://img.shields.io/pypi/pyversions/fireflyalgorithm.svg) -![PyPI - Downloads](https://img.shields.io/pypi/dm/fireflyalgorithm.svg) -[![Downloads](https://pepy.tech/badge/fireflyalgorithm)](https://pepy.tech/project/fireflyalgorithm) -![GitHub repo size](https://img.shields.io/github/repo-size/firefly-cpp/FireflyAlgorithm?style=flat-square) -[![AUR package](https://img.shields.io/aur/version/python-fireflyalgorithm?color=blue&label=Arch%20Linux&logo=arch-linux)](https://aur.archlinux.org/packages/python-fireflyalgorithm) -[![GitHub license](https://img.shields.io/github/license/firefly-cpp/FireflyAlgorithm.svg)](https://github.com/firefly-cpp/FireflyAlgorithm/blob/master/LICENSE) -![GitHub commit activity](https://img.shields.io/github/commit-activity/w/firefly-cpp/FireflyAlgorithm.svg) -[![Average time to resolve an issue](http://isitmaintained.com/badge/resolution/firefly-cpp/FireflyAlgorithm.svg)](http://isitmaintained.com/project/firefly-cpp/FireflyAlgorithm "Average time to resolve an issue") -[![Percentage of issues still open](http://isitmaintained.com/badge/open/firefly-cpp/FireflyAlgorithm.svg)](http://isitmaintained.com/project/firefly-cpp/FireflyAlgorithm "Percentage of issues still open") -![GitHub contributors](https://img.shields.io/github/contributors/firefly-cpp/FireflyAlgorithm.svg) -[![Packaging status](https://repology.org/badge/tiny-repos/python:fireflyalgorithm.svg)](https://repology.org/project/python:fireflyalgorithm/versions) -[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.10430919.svg)](https://doi.org/10.5281/zenodo.10430919) +

+ DOI +

+ + -## About 📋 +## 📋 About This package implements a nature-inspired algorithm for optimization called Firefly Algorithm (FA) in Python programming language. 🌿🔍💻 -## Installation 📦 +## 📦 Installation -Install FireflyAlgorithm with pip: +To install FireflyAlgorithm with pip, use: ```sh pip install fireflyalgorithm ``` @@ -40,12 +55,12 @@ To install FireflyAlgorithm on Arch Linux, please use an [AUR helper](https://wi ```sh $ yay -Syyu python-fireflyalgorithm ``` -To install FireflyAlgorithm on Alpine Linux: +To install FireflyAlgorithm on Alpine Linux, use: ```sh $ apk add py3-fireflyalgorithm ``` -## Usage 🚀 +## 🚀 Usage ```python from fireflyalgorithm import FireflyAlgorithm @@ -105,18 +120,18 @@ options: **Note:** The CLI script can also run as a python module (python -m fireflyalgorithm ...). -## Reference Papers 📚 +## 📚 Reference Papers I. Fister Jr., X.-S. Yang, I. Fister, J. Brest. [Memetic firefly algorithm for combinatorial optimization](http://www.iztok-jr-fister.eu/static/publications/44.pdf) in Bioinspired Optimization Methods and their Applications (BIOMA 2012), B. Filipic and J.Silc, Eds. Jozef Stefan Institute, Ljubljana, Slovenia, 2012 I. Fister, I. Fister Jr., X.-S. Yang, J. Brest. [A comprehensive review of firefly algorithms](http://www.iztok-jr-fister.eu/static/publications/23.pdf). Swarm and Evolutionary Computation 13 (2013): 34-46. -## Cite us +## 📄 Cite us Fister Jr., I., Pečnik, L., & Stupan, Ž. (2023). firefly-cpp/FireflyAlgorithm: 0.4.3 (0.4.3). Zenodo. [https://doi.org/10.5281/zenodo.10430919](https://doi.org/10.5281/zenodo.10430919) -## License +## 🔑 License This package is distributed under the MIT License. This license can be found online at . From d600ff884bf7fb98f0b1ad85242e58d41e7d5505 Mon Sep 17 00:00:00 2001 From: "Iztok Fister Jr." Date: Thu, 25 Jul 2024 12:12:10 +0200 Subject: [PATCH 49/51] Update references --- README.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 527a1b2..b0a5485 100644 --- a/README.md +++ b/README.md @@ -122,10 +122,12 @@ options: ## 📚 Reference Papers -I. Fister Jr., X.-S. Yang, I. Fister, J. Brest. [Memetic firefly algorithm for combinatorial optimization](http://www.iztok-jr-fister.eu/static/publications/44.pdf) in Bioinspired Optimization Methods and their Applications (BIOMA 2012), B. Filipic and J.Silc, Eds. +I. Fister Jr., X.-S. Yang, I. Fister, J. Brest, D. Fister. [A Brief Review of Nature-Inspired Algorithms for Optimization](http://www.iztok-jr-fister.eu/static/publications/21.pdf). Elektrotehniški vestnik, 80(3), 116-122, 2013. + +I. Fister Jr., X.-S. Yang, I. Fister, J. Brest. [Memetic firefly algorithm for combinatorial optimization](http://www.iztok-jr-fister.eu/static/publications/44.pdf) in Bioinspired Optimization Methods and their Applications (BIOMA 2012), B. Filipic and J.Silc, Eds. Jozef Stefan Institute, Ljubljana, Slovenia, 2012 -I. Fister, I. Fister Jr., X.-S. Yang, J. Brest. [A comprehensive review of firefly algorithms](http://www.iztok-jr-fister.eu/static/publications/23.pdf). Swarm and Evolutionary Computation 13 (2013): 34-46. +I. Fister, I. Fister Jr., X.-S. Yang, J. Brest. [A comprehensive review of firefly algorithms](http://www.iztok-jr-fister.eu/static/publications/23.pdf). Swarm and Evolutionary Computation 13 (2013): 34-46. ## 📄 Cite us From b489f3515dd20b962219e700cf2f0421a0262f30 Mon Sep 17 00:00:00 2001 From: "Iztok Fister Jr." Date: Thu, 8 Aug 2024 14:00:49 +0200 Subject: [PATCH 50/51] Bump version and rebuilt --- fireflyalgorithm/__init__.py | 2 +- pyproject.toml | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/fireflyalgorithm/__init__.py b/fireflyalgorithm/__init__.py index 52d052d..31626e8 100644 --- a/fireflyalgorithm/__init__.py +++ b/fireflyalgorithm/__init__.py @@ -2,4 +2,4 @@ __all__ = ["FireflyAlgorithm"] -__version__ = "0.4.4" +__version__ = "0.4.5" diff --git a/pyproject.toml b/pyproject.toml index 01cd204..4681382 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "fireflyalgorithm" -version = "0.4.4" +version = "0.4.5" description = "Implementation of Firefly Algorithm in Python" authors = ["Iztok Fister Jr. ", "Luka Pečnik ", "Žiga Stupan "] keywords = ['computational intelligence', 'firefly algorithm', 'swarm intelligence', 'optimization'] From 121b1852a5ae3951034aa49e119d0fd44f1525f9 Mon Sep 17 00:00:00 2001 From: "Iztok Fister Jr." Date: Sat, 4 Jan 2025 20:05:26 +0100 Subject: [PATCH 51/51] Fix dependencies, bump version and rebuilt --- fireflyalgorithm/__init__.py | 2 +- poetry.lock | 142 ++++++++++++++++++++++------------- pyproject.toml | 4 +- 3 files changed, 91 insertions(+), 57 deletions(-) diff --git a/fireflyalgorithm/__init__.py b/fireflyalgorithm/__init__.py index 31626e8..feb6d54 100644 --- a/fireflyalgorithm/__init__.py +++ b/fireflyalgorithm/__init__.py @@ -2,4 +2,4 @@ __all__ = ["FireflyAlgorithm"] -__version__ = "0.4.5" +__version__ = "0.4.6" diff --git a/poetry.lock b/poetry.lock index 0bf4182..3c04aca 100644 --- a/poetry.lock +++ b/poetry.lock @@ -1,4 +1,4 @@ -# This file is automatically @generated by Poetry 1.7.0 and should not be changed by hand. +# This file is automatically @generated by Poetry 1.8.3 and should not be changed by hand. [[package]] name = "colorama" @@ -13,13 +13,13 @@ files = [ [[package]] name = "exceptiongroup" -version = "1.1.3" +version = "1.2.2" description = "Backport of PEP 654 (exception groups)" optional = false python-versions = ">=3.7" files = [ - {file = "exceptiongroup-1.1.3-py3-none-any.whl", hash = "sha256:343280667a4585d195ca1cf9cef84a4e178c4b6cf2274caef9859782b567d5e3"}, - {file = "exceptiongroup-1.1.3.tar.gz", hash = "sha256:097acd85d473d75af5bb98e41b61ff7fe35efe6675e4f9370ec6ec5126d160e9"}, + {file = "exceptiongroup-1.2.2-py3-none-any.whl", hash = "sha256:3111b9d131c238bec2f8f516e123e14ba243563fb135d3fe885990585aa7795b"}, + {file = "exceptiongroup-1.2.2.tar.gz", hash = "sha256:47c2edf7c6738fafb49fd34290706d1a1a2f4d1c6df275526b62cbb4aa5393cc"}, ] [package.extras] @@ -38,65 +38,69 @@ files = [ [[package]] name = "numpy" -version = "1.26.1" +version = "1.26.4" description = "Fundamental package for array computing in Python" optional = false -python-versions = "<3.13,>=3.9" +python-versions = ">=3.9" files = [ - {file = "numpy-1.26.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:82e871307a6331b5f09efda3c22e03c095d957f04bf6bc1804f30048d0e5e7af"}, - {file = "numpy-1.26.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:cdd9ec98f0063d93baeb01aad472a1a0840dee302842a2746a7a8e92968f9575"}, - {file = "numpy-1.26.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:d78f269e0c4fd365fc2992c00353e4530d274ba68f15e968d8bc3c69ce5f5244"}, - {file = "numpy-1.26.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8ab9163ca8aeb7fd32fe93866490654d2f7dda4e61bc6297bf72ce07fdc02f67"}, - {file = "numpy-1.26.1-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:78ca54b2f9daffa5f323f34cdf21e1d9779a54073f0018a3094ab907938331a2"}, - {file = "numpy-1.26.1-cp310-cp310-win32.whl", hash = "sha256:d1cfc92db6af1fd37a7bb58e55c8383b4aa1ba23d012bdbba26b4bcca45ac297"}, - {file = "numpy-1.26.1-cp310-cp310-win_amd64.whl", hash = "sha256:d2984cb6caaf05294b8466966627e80bf6c7afd273279077679cb010acb0e5ab"}, - {file = "numpy-1.26.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:cd7837b2b734ca72959a1caf3309457a318c934abef7a43a14bb984e574bbb9a"}, - {file = "numpy-1.26.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:1c59c046c31a43310ad0199d6299e59f57a289e22f0f36951ced1c9eac3665b9"}, - {file = "numpy-1.26.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:d58e8c51a7cf43090d124d5073bc29ab2755822181fcad978b12e144e5e5a4b3"}, - {file = "numpy-1.26.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:6081aed64714a18c72b168a9276095ef9155dd7888b9e74b5987808f0dd0a974"}, - {file = "numpy-1.26.1-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:97e5d6a9f0702c2863aaabf19f0d1b6c2628fbe476438ce0b5ce06e83085064c"}, - {file = "numpy-1.26.1-cp311-cp311-win32.whl", hash = "sha256:b9d45d1dbb9de84894cc50efece5b09939752a2d75aab3a8b0cef6f3a35ecd6b"}, - {file = "numpy-1.26.1-cp311-cp311-win_amd64.whl", hash = "sha256:3649d566e2fc067597125428db15d60eb42a4e0897fc48d28cb75dc2e0454e53"}, - {file = "numpy-1.26.1-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:1d1bd82d539607951cac963388534da3b7ea0e18b149a53cf883d8f699178c0f"}, - {file = "numpy-1.26.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:afd5ced4e5a96dac6725daeb5242a35494243f2239244fad10a90ce58b071d24"}, - {file = "numpy-1.26.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:a03fb25610ef560a6201ff06df4f8105292ba56e7cdd196ea350d123fc32e24e"}, - {file = "numpy-1.26.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:dcfaf015b79d1f9f9c9fd0731a907407dc3e45769262d657d754c3a028586124"}, - {file = "numpy-1.26.1-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:e509cbc488c735b43b5ffea175235cec24bbc57b227ef1acc691725beb230d1c"}, - {file = "numpy-1.26.1-cp312-cp312-win32.whl", hash = "sha256:af22f3d8e228d84d1c0c44c1fbdeb80f97a15a0abe4f080960393a00db733b66"}, - {file = "numpy-1.26.1-cp312-cp312-win_amd64.whl", hash = "sha256:9f42284ebf91bdf32fafac29d29d4c07e5e9d1af862ea73686581773ef9e73a7"}, - {file = "numpy-1.26.1-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:bb894accfd16b867d8643fc2ba6c8617c78ba2828051e9a69511644ce86ce83e"}, - {file = "numpy-1.26.1-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:e44ccb93f30c75dfc0c3aa3ce38f33486a75ec9abadabd4e59f114994a9c4617"}, - {file = "numpy-1.26.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9696aa2e35cc41e398a6d42d147cf326f8f9d81befcb399bc1ed7ffea339b64e"}, - {file = "numpy-1.26.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:a5b411040beead47a228bde3b2241100454a6abde9df139ed087bd73fc0a4908"}, - {file = "numpy-1.26.1-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:1e11668d6f756ca5ef534b5be8653d16c5352cbb210a5c2a79ff288e937010d5"}, - {file = "numpy-1.26.1-cp39-cp39-win32.whl", hash = "sha256:d1d2c6b7dd618c41e202c59c1413ef9b2c8e8a15f5039e344af64195459e3104"}, - {file = "numpy-1.26.1-cp39-cp39-win_amd64.whl", hash = "sha256:59227c981d43425ca5e5c01094d59eb14e8772ce6975d4b2fc1e106a833d5ae2"}, - {file = "numpy-1.26.1-pp39-pypy39_pp73-macosx_10_9_x86_64.whl", hash = "sha256:06934e1a22c54636a059215d6da99e23286424f316fddd979f5071093b648668"}, - {file = "numpy-1.26.1-pp39-pypy39_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:76ff661a867d9272cd2a99eed002470f46dbe0943a5ffd140f49be84f68ffc42"}, - {file = "numpy-1.26.1-pp39-pypy39_pp73-win_amd64.whl", hash = "sha256:6965888d65d2848e8768824ca8288db0a81263c1efccec881cb35a0d805fcd2f"}, - {file = "numpy-1.26.1.tar.gz", hash = "sha256:c8c6c72d4a9f831f328efb1312642a1cafafaa88981d9ab76368d50d07d93cbe"}, + {file = "numpy-1.26.4-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:9ff0f4f29c51e2803569d7a51c2304de5554655a60c5d776e35b4a41413830d0"}, + {file = "numpy-1.26.4-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:2e4ee3380d6de9c9ec04745830fd9e2eccb3e6cf790d39d7b98ffd19b0dd754a"}, + {file = "numpy-1.26.4-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:d209d8969599b27ad20994c8e41936ee0964e6da07478d6c35016bc386b66ad4"}, + {file = "numpy-1.26.4-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ffa75af20b44f8dba823498024771d5ac50620e6915abac414251bd971b4529f"}, + {file = "numpy-1.26.4-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:62b8e4b1e28009ef2846b4c7852046736bab361f7aeadeb6a5b89ebec3c7055a"}, + {file = "numpy-1.26.4-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:a4abb4f9001ad2858e7ac189089c42178fcce737e4169dc61321660f1a96c7d2"}, + {file = "numpy-1.26.4-cp310-cp310-win32.whl", hash = "sha256:bfe25acf8b437eb2a8b2d49d443800a5f18508cd811fea3181723922a8a82b07"}, + {file = "numpy-1.26.4-cp310-cp310-win_amd64.whl", hash = "sha256:b97fe8060236edf3662adfc2c633f56a08ae30560c56310562cb4f95500022d5"}, + {file = "numpy-1.26.4-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:4c66707fabe114439db9068ee468c26bbdf909cac0fb58686a42a24de1760c71"}, + {file = "numpy-1.26.4-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:edd8b5fe47dab091176d21bb6de568acdd906d1887a4584a15a9a96a1dca06ef"}, + {file = "numpy-1.26.4-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:7ab55401287bfec946ced39700c053796e7cc0e3acbef09993a9ad2adba6ca6e"}, + {file = "numpy-1.26.4-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:666dbfb6ec68962c033a450943ded891bed2d54e6755e35e5835d63f4f6931d5"}, + {file = "numpy-1.26.4-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:96ff0b2ad353d8f990b63294c8986f1ec3cb19d749234014f4e7eb0112ceba5a"}, + {file = "numpy-1.26.4-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:60dedbb91afcbfdc9bc0b1f3f402804070deed7392c23eb7a7f07fa857868e8a"}, + {file = "numpy-1.26.4-cp311-cp311-win32.whl", hash = "sha256:1af303d6b2210eb850fcf03064d364652b7120803a0b872f5211f5234b399f20"}, + {file = "numpy-1.26.4-cp311-cp311-win_amd64.whl", hash = "sha256:cd25bcecc4974d09257ffcd1f098ee778f7834c3ad767fe5db785be9a4aa9cb2"}, + {file = "numpy-1.26.4-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:b3ce300f3644fb06443ee2222c2201dd3a89ea6040541412b8fa189341847218"}, + {file = "numpy-1.26.4-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:03a8c78d01d9781b28a6989f6fa1bb2c4f2d51201cf99d3dd875df6fbd96b23b"}, + {file = "numpy-1.26.4-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9fad7dcb1aac3c7f0584a5a8133e3a43eeb2fe127f47e3632d43d677c66c102b"}, + {file = "numpy-1.26.4-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:675d61ffbfa78604709862923189bad94014bef562cc35cf61d3a07bba02a7ed"}, + {file = "numpy-1.26.4-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:ab47dbe5cc8210f55aa58e4805fe224dac469cde56b9f731a4c098b91917159a"}, + {file = "numpy-1.26.4-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:1dda2e7b4ec9dd512f84935c5f126c8bd8b9f2fc001e9f54af255e8c5f16b0e0"}, + {file = "numpy-1.26.4-cp312-cp312-win32.whl", hash = "sha256:50193e430acfc1346175fcbdaa28ffec49947a06918b7b92130744e81e640110"}, + {file = "numpy-1.26.4-cp312-cp312-win_amd64.whl", hash = "sha256:08beddf13648eb95f8d867350f6a018a4be2e5ad54c8d8caed89ebca558b2818"}, + {file = "numpy-1.26.4-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:7349ab0fa0c429c82442a27a9673fc802ffdb7c7775fad780226cb234965e53c"}, + {file = "numpy-1.26.4-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:52b8b60467cd7dd1e9ed082188b4e6bb35aa5cdd01777621a1658910745b90be"}, + {file = "numpy-1.26.4-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:d5241e0a80d808d70546c697135da2c613f30e28251ff8307eb72ba696945764"}, + {file = "numpy-1.26.4-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f870204a840a60da0b12273ef34f7051e98c3b5961b61b0c2c1be6dfd64fbcd3"}, + {file = "numpy-1.26.4-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:679b0076f67ecc0138fd2ede3a8fd196dddc2ad3254069bcb9faf9a79b1cebcd"}, + {file = "numpy-1.26.4-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:47711010ad8555514b434df65f7d7b076bb8261df1ca9bb78f53d3b2db02e95c"}, + {file = "numpy-1.26.4-cp39-cp39-win32.whl", hash = "sha256:a354325ee03388678242a4d7ebcd08b5c727033fcff3b2f536aea978e15ee9e6"}, + {file = "numpy-1.26.4-cp39-cp39-win_amd64.whl", hash = "sha256:3373d5d70a5fe74a2c1bb6d2cfd9609ecf686d47a2d7b1d37a8f3b6bf6003aea"}, + {file = "numpy-1.26.4-pp39-pypy39_pp73-macosx_10_9_x86_64.whl", hash = "sha256:afedb719a9dcfc7eaf2287b839d8198e06dcd4cb5d276a3df279231138e83d30"}, + {file = "numpy-1.26.4-pp39-pypy39_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:95a7476c59002f2f6c590b9b7b998306fba6a5aa646b1e22ddfeaf8f78c3a29c"}, + {file = "numpy-1.26.4-pp39-pypy39_pp73-win_amd64.whl", hash = "sha256:7e50d0a0cc3189f9cb0aeb3a6a6af18c16f59f004b866cd2be1c14b36134a4a0"}, + {file = "numpy-1.26.4.tar.gz", hash = "sha256:2a02aba9ed12e4ac4eb3ea9421c420301a0c6460d9830d74a9df87efa4912010"}, ] [[package]] name = "packaging" -version = "23.2" +version = "24.2" description = "Core utilities for Python packages" optional = false -python-versions = ">=3.7" +python-versions = ">=3.8" files = [ - {file = "packaging-23.2-py3-none-any.whl", hash = "sha256:8c491190033a9af7e1d931d0b5dacc2ef47509b34dd0de67ed209b5203fc88c7"}, - {file = "packaging-23.2.tar.gz", hash = "sha256:048fb0e9405036518eaaf48a55953c750c11e1a1b68e0dd1a9d62ed0c092cfc5"}, + {file = "packaging-24.2-py3-none-any.whl", hash = "sha256:09abb1bccd265c01f4a3aa3f7a7db064b36514d2cba19a2f694fe6150451a759"}, + {file = "packaging-24.2.tar.gz", hash = "sha256:c228a6dc5e932d346bc5739379109d49e8853dd8223571c7c5b55260edc0b97f"}, ] [[package]] name = "pluggy" -version = "1.3.0" +version = "1.5.0" description = "plugin and hook calling mechanisms for python" optional = false python-versions = ">=3.8" files = [ - {file = "pluggy-1.3.0-py3-none-any.whl", hash = "sha256:d89c696a773f8bd377d18e5ecda92b7a3793cbe66c87060a6fb58c7b6e1061f7"}, - {file = "pluggy-1.3.0.tar.gz", hash = "sha256:cf61ae8f126ac6f7c451172cf30e3e43d3ca77615509771b3a984a0730651e12"}, + {file = "pluggy-1.5.0-py3-none-any.whl", hash = "sha256:44e1ad92c8ca002de6377e165f3e0f1be63266ab4d554740532335b9d75ea669"}, + {file = "pluggy-1.5.0.tar.gz", hash = "sha256:2cffa88e94fdc978c4c574f15f9e59b7f4201d439195c3715ca9e2486f1d0cf1"}, ] [package.extras] @@ -105,13 +109,13 @@ testing = ["pytest", "pytest-benchmark"] [[package]] name = "pytest" -version = "7.4.3" +version = "7.4.4" description = "pytest: simple powerful testing with Python" optional = false python-versions = ">=3.7" files = [ - {file = "pytest-7.4.3-py3-none-any.whl", hash = "sha256:0d009c083ea859a71b76adf7c1d502e4bc170b80a8ef002da5806527b9591fac"}, - {file = "pytest-7.4.3.tar.gz", hash = "sha256:d989d136982de4e3b29dabcc838ad581c64e8ed52c11fbe86ddebd9da0818cd5"}, + {file = "pytest-7.4.4-py3-none-any.whl", hash = "sha256:b090cdf5ed60bf4c45261be03239c2c1c22df034fbffe691abe93cd80cea01d8"}, + {file = "pytest-7.4.4.tar.gz", hash = "sha256:2cf0005922c6ace4a3e2ec8b4080eb0d9753fdc93107415332f50ce9e7994280"}, ] [package.dependencies] @@ -127,16 +131,46 @@ testing = ["argcomplete", "attrs (>=19.2.0)", "hypothesis (>=3.56)", "mock", "no [[package]] name = "tomli" -version = "2.0.1" +version = "2.2.1" description = "A lil' TOML parser" optional = false -python-versions = ">=3.7" +python-versions = ">=3.8" files = [ - {file = "tomli-2.0.1-py3-none-any.whl", hash = "sha256:939de3e7a6161af0c887ef91b7d41a53e7c5a1ca976325f429cb46ea9bc30ecc"}, - {file = "tomli-2.0.1.tar.gz", hash = "sha256:de526c12914f0c550d15924c62d72abc48d6fe7364aa87328337a31007fe8a4f"}, + {file = "tomli-2.2.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:678e4fa69e4575eb77d103de3df8a895e1591b48e740211bd1067378c69e8249"}, + {file = "tomli-2.2.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:023aa114dd824ade0100497eb2318602af309e5a55595f76b626d6d9f3b7b0a6"}, + {file = "tomli-2.2.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ece47d672db52ac607a3d9599a9d48dcb2f2f735c6c2d1f34130085bb12b112a"}, + {file = "tomli-2.2.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:6972ca9c9cc9f0acaa56a8ca1ff51e7af152a9f87fb64623e31d5c83700080ee"}, + {file = "tomli-2.2.1-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:c954d2250168d28797dd4e3ac5cf812a406cd5a92674ee4c8f123c889786aa8e"}, + {file = "tomli-2.2.1-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:8dd28b3e155b80f4d54beb40a441d366adcfe740969820caf156c019fb5c7ec4"}, + {file = "tomli-2.2.1-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:e59e304978767a54663af13c07b3d1af22ddee3bb2fb0618ca1593e4f593a106"}, + {file = "tomli-2.2.1-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:33580bccab0338d00994d7f16f4c4ec25b776af3ffaac1ed74e0b3fc95e885a8"}, + {file = "tomli-2.2.1-cp311-cp311-win32.whl", hash = "sha256:465af0e0875402f1d226519c9904f37254b3045fc5084697cefb9bdde1ff99ff"}, + {file = "tomli-2.2.1-cp311-cp311-win_amd64.whl", hash = "sha256:2d0f2fdd22b02c6d81637a3c95f8cd77f995846af7414c5c4b8d0545afa1bc4b"}, + {file = "tomli-2.2.1-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:4a8f6e44de52d5e6c657c9fe83b562f5f4256d8ebbfe4ff922c495620a7f6cea"}, + {file = "tomli-2.2.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:8d57ca8095a641b8237d5b079147646153d22552f1c637fd3ba7f4b0b29167a8"}, + {file = "tomli-2.2.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:4e340144ad7ae1533cb897d406382b4b6fede8890a03738ff1683af800d54192"}, + {file = "tomli-2.2.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:db2b95f9de79181805df90bedc5a5ab4c165e6ec3fe99f970d0e302f384ad222"}, + {file = "tomli-2.2.1-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:40741994320b232529c802f8bc86da4e1aa9f413db394617b9a256ae0f9a7f77"}, + {file = "tomli-2.2.1-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:400e720fe168c0f8521520190686ef8ef033fb19fc493da09779e592861b78c6"}, + {file = "tomli-2.2.1-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:02abe224de6ae62c19f090f68da4e27b10af2b93213d36cf44e6e1c5abd19fdd"}, + {file = "tomli-2.2.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:b82ebccc8c8a36f2094e969560a1b836758481f3dc360ce9a3277c65f374285e"}, + {file = "tomli-2.2.1-cp312-cp312-win32.whl", hash = "sha256:889f80ef92701b9dbb224e49ec87c645ce5df3fa2cc548664eb8a25e03127a98"}, + {file = "tomli-2.2.1-cp312-cp312-win_amd64.whl", hash = "sha256:7fc04e92e1d624a4a63c76474610238576942d6b8950a2d7f908a340494e67e4"}, + {file = "tomli-2.2.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:f4039b9cbc3048b2416cc57ab3bda989a6fcf9b36cf8937f01a6e731b64f80d7"}, + {file = "tomli-2.2.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:286f0ca2ffeeb5b9bd4fcc8d6c330534323ec51b2f52da063b11c502da16f30c"}, + {file = "tomli-2.2.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:a92ef1a44547e894e2a17d24e7557a5e85a9e1d0048b0b5e7541f76c5032cb13"}, + {file = "tomli-2.2.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9316dc65bed1684c9a98ee68759ceaed29d229e985297003e494aa825ebb0281"}, + {file = "tomli-2.2.1-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:e85e99945e688e32d5a35c1ff38ed0b3f41f43fad8df0bdf79f72b2ba7bc5272"}, + {file = "tomli-2.2.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:ac065718db92ca818f8d6141b5f66369833d4a80a9d74435a268c52bdfa73140"}, + {file = "tomli-2.2.1-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:d920f33822747519673ee656a4b6ac33e382eca9d331c87770faa3eef562aeb2"}, + {file = "tomli-2.2.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:a198f10c4d1b1375d7687bc25294306e551bf1abfa4eace6650070a5c1ae2744"}, + {file = "tomli-2.2.1-cp313-cp313-win32.whl", hash = "sha256:d3f5614314d758649ab2ab3a62d4f2004c825922f9e370b29416484086b264ec"}, + {file = "tomli-2.2.1-cp313-cp313-win_amd64.whl", hash = "sha256:a38aa0308e754b0e3c67e344754dff64999ff9b513e691d0e786265c93583c69"}, + {file = "tomli-2.2.1-py3-none-any.whl", hash = "sha256:cb55c73c5f4408779d0cf3eef9f762b9c9f147a77de7b258bef0a5628adc85cc"}, + {file = "tomli-2.2.1.tar.gz", hash = "sha256:cd45e1dc79c835ce60f7404ec8119f2eb06d38b1deba146f07ced3bbc44505ff"}, ] [metadata] lock-version = "2.0" -python-versions = "^3.9,<3.13" -content-hash = "aa27aa586ebf5e13d1936db455cb5da27cc641ae1ffc6434877928a3baa9bb82" +python-versions = "^3.9,<3.14" +content-hash = "3cd4e3325b88b677715a63c130cd79d70a3e3586c0df36c5d40aba429342caa7" diff --git a/pyproject.toml b/pyproject.toml index 4681382..c7346a0 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,6 +1,6 @@ [tool.poetry] name = "fireflyalgorithm" -version = "0.4.5" +version = "0.4.6" description = "Implementation of Firefly Algorithm in Python" authors = ["Iztok Fister Jr. ", "Luka Pečnik ", "Žiga Stupan "] keywords = ['computational intelligence', 'firefly algorithm', 'swarm intelligence', 'optimization'] @@ -15,7 +15,7 @@ include = [ ] [tool.poetry.dependencies] -python = "^3.9,<3.13" +python = "^3.9,<3.14" numpy = "^1.26.1" [tool.poetry.group.test.dependencies] pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy

+ 📋 About • + 📦 Installation • + 🚀 Usage • + 📚 Reference Papers • + 📄 Cite us • + 🔑 License +