Metadata-Version: 2.1
Name: slpso
Version: 0.1.0
Summary: 
Author: viniciusGomes
Author-email: vsg.dev.tech@gmail.com
Requires-Python: >=3.8,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Dist: numpy (>=1.23.5,<2.0.0)
Description-Content-Type: text/markdown

# SLPso - Social Learning Particle Swarm Optimization

[![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://opensource.org/licenses/MIT)
![Python 3.10](https://img.shields.io/badge/Python-3.10-blue)



SLPso is a Python library that implements the Social Learning Particle Swarm Optimization (SL-PSO) algorithm for scalable optimization problems, as described in the following article:

## About the Algorithm

**A Social Learning Particle Swarm Optimization Algorithm for Scalable Optimization**
*Authors: Ran Cheng and Yaochu Jin*
*Journal: Information Sciences, Volume 291, Pages 43-60, Year 2015*
*DOI: [10.1016/j.ins.2014.08.039](https://doi.org/10.1016/j.ins.2014.08.039)*
*URL to the Paper: [Read the full paper](https://www.sciencedirect.com/science/article/pii/S0020025514008366)*

If you use the SLPso library in your research, please consider citing this library.

<details>
<summary>Reveal quote</summary>

**SLPso - Social Learning Particle Swarm Optimization** [Software]. (2023).  Available at: [https://github.com/vsg-root/slpso](https://github.com/vsg-root/slpso).

</details>



## About SL-PSO

The Social Learning Particle Swarm Optimization is a population-based optimization algorithm inspired by the behavior of a swarm of particles. It leverages social interactions to enhance exploration of the search space and convergence to optimal solutions in scalable optimization problems.

#### - **Restrigin** Function

<div align="center">
  <table>
    <tr>
      <td align="center">
        <img src="assets/restrigin_2d_plot.png" alt="Texto Alternativo 1">
      </td>
      <td align="center">
        <img src="assets/restrigin_3d_plot.png" alt "Texto Alternativo 2">
      </td>
    </tr>
    <tr>
      <td align="center"></td>
      <td align="center"></td>
    </tr>
  </table>
</div>

#### - **Ackley** Function

<div align="center">
  <table>
    <tr>
      <td align="center">
        <img src="assets/ackley_2d_plot.png" alt="Texto Alternativo 1">
      </td>
      <td align="center">
        <img src="assets/ackley_3d_plot.png" alt "Texto Alternativo 2">
      </td>
    </tr>
    <tr>
      <td align="center"></td>
      <td align="center"></td>
    </tr>
  </table>
</div>



## Installation

To get started with SLPso, you can install it via pip:

```bash
pip install slpso
```
### Try your first SL-PSO program

```python
>>> import numpy as np
>>> from slpso.slpso import SLPSO

>>> def custom_objective_function(positions: np.ndarray) -> np.ndarray:
    """
    The custom objective function to be minimized.

    Args:
        positions (np.ndarray): An array of particle positions.

    Returns:
        np.ndarray: An array of fitness values.
    """
>>> return np.sum(positions ** 2, axis=1)

>>> # Create a custom random number generator
>>> rng = np.random.default_rng(seed=50)  # Replace 40 with the desired seed

>>> lower_bound = -5.0  # Set the lower bound
>>> upper_bound = 5.0   # Set the upper bound

>>> slpso_optimizer = SLPSO(custom_objective_function, 
                            rng=rng, 
                            lower_bound=lower_bound, 
                            upper_bound=upper_bound, 
                            show_progress=False)

>>> global_best_position, global_best_value = slpso_optimizer.optimize()
>>> print("Global Best Position:", global_best_position)
>>> print("Global Best Value:", global_best_value)
```


**Note:** This library is not affiliated with or endorsed by the original researchers. It is an independent implementation of the SL-PSO algorithm for the convenience of users interested in applying it to their optimization problems. Please do not confuse this library with the work of the original authors.


