# Josiann: Just anOther SImulated ANNealing
Josiann is a Python library which implements the simulated annealing algorithm for noisy cost functions. It has
support for vectorized functions, multiprocessing and provides a parallel mode for optimizing several similar but
independent problems at once.
Source code (CeCILL-B): [https://github.com/Vidium/josiann](https://github.com/Vidium/josiann)
Documentation: [https://josiann.readthedocs.io/en/latest/index.html](https://josiann.readthedocs.io/en/latest/index.html)
## Installation
Josiann requires Python 3.8+ to run and relies on the following libraries :
- Numpy
- attrs
- tqdm
### Pip installation
```bash
pip install josiann
```
Optional diagnostic plots need the library `plotly` to be generated. You can install it alongside with Josiann :
```bash
pip install josiann[plot]
```
## Examples
Several examples of using Josiann can be found in the `docs/tutorials` folder.
Raw data
{
"_id": null,
"home_page": null,
"name": "josiann",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.10",
"maintainer_email": null,
"keywords": "simulated annealing, optimization, noisy",
"author": "Matteo Bouvier",
"author_email": "m.bouvier@vidium-solutions.com",
"download_url": "https://files.pythonhosted.org/packages/c9/7d/c5c061f1f1ce72a74d45cd59df2e042a8822a5c32bb93fb4a09c4c344d22/josiann-1.1.9.tar.gz",
"platform": null,
"description": "# Josiann: Just anOther SImulated ANNealing\n\nJosiann is a Python library which implements the simulated annealing algorithm for noisy cost functions. It has\nsupport for vectorized functions, multiprocessing and provides a parallel mode for optimizing several similar but\nindependent problems at once.\n\nSource code (CeCILL-B): [https://github.com/Vidium/josiann](https://github.com/Vidium/josiann)\n\nDocumentation: [https://josiann.readthedocs.io/en/latest/index.html](https://josiann.readthedocs.io/en/latest/index.html)\n\n## Installation\nJosiann requires Python 3.8+ to run and relies on the following libraries :\n- Numpy\n- attrs\n- tqdm\n\n### Pip installation\n\n```bash\npip install josiann\n```\n\nOptional diagnostic plots need the library `plotly` to be generated. You can install it alongside with Josiann :\n\n```bash\npip install josiann[plot]\n```\n\n## Examples\n\nSeveral examples of using Josiann can be found in the `docs/tutorials` folder.\n",
"bugtrack_url": null,
"license": "LICENSE",
"summary": "Simulated Annealing for noisy cost function",
"version": "1.1.9",
"project_urls": {
"Documentation": "https://josiann.readthedocs.io/",
"Source": "https://github.com/Vidium/josiann"
},
"split_keywords": [
"simulated annealing",
" optimization",
" noisy"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "cc22c03b029603a85bbc03cf7dac8a0f7e9861bc1b9a8962b433f782056ceeff",
"md5": "37b573925765912b29d09dfa95901106",
"sha256": "f040cd742e12000b5d91f5ffe4337e3fb5e3e478c3d6eb8abe5035608054b926"
},
"downloads": -1,
"filename": "josiann-1.1.9-py3-none-any.whl",
"has_sig": false,
"md5_digest": "37b573925765912b29d09dfa95901106",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.10",
"size": 72366,
"upload_time": "2024-03-20T23:10:55",
"upload_time_iso_8601": "2024-03-20T23:10:55.640357Z",
"url": "https://files.pythonhosted.org/packages/cc/22/c03b029603a85bbc03cf7dac8a0f7e9861bc1b9a8962b433f782056ceeff/josiann-1.1.9-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c97dc5c061f1f1ce72a74d45cd59df2e042a8822a5c32bb93fb4a09c4c344d22",
"md5": "0723590f6f21390fa487f45e5c8e3dc2",
"sha256": "47c0c6f274d0102b40992ae4d8aed8953376688b060dcb56364d27e718b02326"
},
"downloads": -1,
"filename": "josiann-1.1.9.tar.gz",
"has_sig": false,
"md5_digest": "0723590f6f21390fa487f45e5c8e3dc2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.10",
"size": 44031,
"upload_time": "2024-03-20T23:10:57",
"upload_time_iso_8601": "2024-03-20T23:10:57.876148Z",
"url": "https://files.pythonhosted.org/packages/c9/7d/c5c061f1f1ce72a74d45cd59df2e042a8822a5c32bb93fb4a09c4c344d22/josiann-1.1.9.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-20 23:10:57",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Vidium",
"github_project": "josiann",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "josiann"
}