Metadata-Version: 2.1
Name: fastfunc
Version: 0.1.6
Summary: Fast numpy ufunc operations
Home-page: https://github.com/nschloe/fastfunc
Author: Nico Schlömer
Author-email: nico.schloemer@gmail.com
License: License :: OSI Approved :: MIT License
Platform: any
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Software Development :: Libraries
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: numpy
Requires-Dist: pybind11

# fastfunc

[![CircleCI](https://img.shields.io/circleci/project/github/nschloe/fastfunc/master.svg)](https://circleci.com/gh/nschloe/fastfunc/tree/master)
[![codecov](https://img.shields.io/codecov/c/github/nschloe/fastfunc.svg)](https://codecov.io/gh/nschloe/fastfunc)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/ambv/black)
[![speedy](https://img.shields.io/badge/speedy-gonzales-ff69b4.svg)](https://github.com/nschloe/fastfunc)
[![PyPi Version](https://img.shields.io/pypi/v/fastfunc.svg)](https://pypi.org/project/fastfunc)
[![GitHub stars](https://img.shields.io/github/stars/nschloe/fastfunc.svg?logo=github&label=Stars&logoColor=white)](https://github.com/nschloe/fastfunc)

[NumPy's own ufunc
operations](https://docs.scipy.org/doc/numpy/reference/generated/numpy.ufunc.at.html)
are handy, but can be quite slow (see https://github.com/numpy/numpy/issues/5922 and
https://github.com/numpy/numpy/issues/11156).  Use `fastfunc` as a drop-in replacement
```python
# import numpy
# numpy.add.at(target, idx, vals)

import fastfunc
fastfunc.add.at(target, idx, vals)
```
to get a speed-up by a factor of 40.

![](https://nschloe.github.io/fastfunc/add.png)

This is achieved by moving the operations to C++ using [pybind11](https://github.com/pybind/pybind11).

### Installation

fastfunc is [available from the Python Package
Index](https://pypi.org/project/fastfunc/), so simply do
```
pip install -U fastfunc
```
to install or upgrade.

### Testing

To run the fastfunc unit tests, check out this repository and type
```
pytest
```

### Distribution
To create a new release

1. bump the `__version__` number,

2. publish to PyPi and tag on GitHub:
    ```
    $ make publish
    ```

### License

fastfunc is published under the [MIT license](https://en.wikipedia.org/wiki/MIT_License).
