Skip to main content

Python micro framework for building nature-inspired algorithms.

Project description

Unix Build Status Windows Build status Coverage Status Scrutinizer Code Quality PyPI Version Documentation Status GitHub license

About

Nature-inspired algorithms are a very popular tool for solving optimization problems. Numerous variants of nature-inspired algorithms have been developed since the beginning of their era. To prove their versatility, those were tested in various domains on various applications, especially when they are hybridized, modified or adapted. However, implementation of nature-inspired algorithms is sometimes a difficult, complex and tedious task. In order to break this wall, NiaPy is intended for simple and quick use, without spending time for implementing algorithms from scratch.

http://c1.staticflickr.com/5/4757/26625486258_41ea6d95e0.jpg

Mission

Our mission is to build a collection of nature-inspired algorithms and create a simple interface for managing the optimization process.
NiaPy will offer:
  • numerous benchmark functions implementations,

  • use of various nature-inspired algorithms without struggle and effort with a simple interface,

  • easy comparison between nature-inspired algorithms and

  • export of results in various formats (LaTeX, JSON, Excel).

Overview

Python micro framework for building nature-inspired algorithms. Official documentation is available here.

The micro framework features following algorithms:

  • basic:
    • Artificial bee colony algorithm

    • Bat algorithm

    • Differential evolution algorithm

    • Firefly algorithm

    • Flower pollination algorithm

    • Genetic algorithm

    • Grey wolf optimizer

    • Particle swarm optimization

  • modified:
    • Hybrid bat algorithm

    • Self-adaptive differential evolution algorithm

The following benchmark functions are included in NiaPy:

  • Ackley

  • Alpine
    • Alpine1

    • Alpine2

  • Chung Reynolds

  • Csendes

  • Griewank

  • Happy cat

  • Pintér

  • Qing

  • Quintic

  • Rastrigin

  • Ridge

  • Rosenbrock

  • Salomon

  • Schumer Steiglitz

  • Schwefel
    • Schwefel 2.21

    • Schwefel 2.22

  • Sphere

  • Step
    • Step2

    • Step3

  • Stepint

  • Styblinski-Tang

  • Sum Squares

  • Whitley

Setup

Requirements

  • Python 3.6+ (backward compatibility with 2.7.14)

  • Pip

Installation

Install NiaPy with pip:

$ pip install NiaPy

or directly from the source code:

$ git clone https://github.com/NiaOrg/NiaPy.git
$ cd NiaPy
$ python setup.py install

Usage

After installation, the package can imported:

$ python
>>> import NiaPy
>>> NiaPy.__version__

For more usage examples please look at examples folder.

Contributing

Open Source Helpers

We encourage you to contribute to NiaPy! Please check out the Contributing to NiaPy guide for guidelines about how to proceed.

Everyone interacting in NiaPy’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the NiaPy code of conduct.

Licence

This package is distributed under the MIT License. This license can be found online at http://www.opensource.org/licenses/MIT.

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!

Revision History

1.0.0 (Feb 28, 2018)

  • stable release 1.0.0

1.0.0rc2 (Feb 28, 2018)

  • fix PyPI build

1.0.0rc1 (Feb 28, 2018)

  • version 1.0.0 release candidate 1

  • added 10 algorithms

  • added 26 benchmark functions

  • added Runner utility with export functionality

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

NiaPy-1.0.0.tar.gz (41.8 kB view details)

Uploaded Source

Built Distribution

NiaPy-1.0.0-py3-none-any.whl (57.6 kB view details)

Uploaded Python 3

File details

Details for the file NiaPy-1.0.0.tar.gz.

File metadata

  • Download URL: NiaPy-1.0.0.tar.gz
  • Upload date:
  • Size: 41.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for NiaPy-1.0.0.tar.gz
Algorithm Hash digest
SHA256 a1ce5e3f3fc67cc41f40c33fd18c6832cdcf8a9e6e05f86e701b67e6e0837c27
MD5 5768d9b62b0d43cb42e26cb8eb374f4c
BLAKE2b-256 136ee90a0b279eb2c0b80f3ff3a40a52fa61044b2c731cf20fba17238a544bb9

See more details on using hashes here.

File details

Details for the file NiaPy-1.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for NiaPy-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 44486682d110eb023704a0e3bbc49af347c5863c1a7d7375ff801994b5567b57
MD5 21a817f5ce7cfe0504b24a039f166f33
BLAKE2b-256 f46e81e727aadaa0503f2c45f12905646df60b6d0c776a36d7fcd7d7cc89c1ae

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page