Metadata-Version: 2.1
Name: useful-math-functions
Version: 0.1.2
Summary: useful-math-functions for Optimization, Benchmarking, Visualizing, and more ...
Author: Anselm Hahn
Author-email: anselm.hahn@gmail.com
Requires-Python: >=3.10,<3.12
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Provides-Extra: all
Provides-Extra: matplotlib
Provides-Extra: plotly
Requires-Dist: imagemagic (>=0.2.1,<0.3.0) ; extra == "matplotlib" or extra == "all"
Requires-Dist: kaleido (==0.2.1) ; extra == "plotly" or extra == "all"
Requires-Dist: matplotlib (>=3.7.2,<4.0.0) ; extra == "matplotlib" or extra == "all"
Requires-Dist: numpy (>=1.23.5,<2.0.0)
Requires-Dist: plotly (>=5.16.0,<6.0.0) ; extra == "plotly" or extra == "all"
Requires-Dist: pydantic (>=2.0.0,<3.0.0)
Requires-Dist: scipy (>=1.11.2,<2.0.0)
Description-Content-Type: text/markdown

[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.8373435.svg)](https://doi.org/10.5281/zenodo.8373435)

# useful-math-functions

`useful-math-functions` is a collection of useful mathematical functions with a
focus on:

1. **ease of use** - the functions are designed to be as easy to use as possible
2. **pure python** - the functions are written in much python as possible and
   only use external libraries when necessary
3. **documentation** - the functions are documented in code itself with:
   1. Examples
   2. Equations
   3. References
   4. Links to external resources

## Installation

The package can be installed via pip:

```bash
pip install useful-math-functions
```

and for Visualizations:

```bash
# matplotlib
pip install useful-math-functions[matplotlib]

# plotly
pip install useful-math-functions[plotly]

# all visualizations
pip install useful-math-functions[all]
```

## Usage

The package can be imported like any other python package:

```python
from umf.core.create import OptBench
res = OptBench(["DeJongN5Function"], dim=3)
res.plot_type_3d = "plot_surface"
res.plot()
res.save_as_image()
```

![_](https://github.com/Anselmoo/useful-math-functions/blob/main/docs/extra/images/DeJongN5Function.png?raw=true)

## Documentation

The documentation can be found
[here](https://anselmoo.github.io/useful-math-functions/).

## Contributing

Contributions are welcome. For major changes, please open an issue first to
discuss what you would like to change.

## License

The project is licensed under the
[MIT](https://github.com/Anselmoo/useful-math-functions/blob/main/LICENSE)
license.

