imops 0.8.8__cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

imops-0.8.8.dist-info/METADATA

@@ -0,0 +1,218 @@
+Metadata-Version: 2.1
+Name: imops
+Version: 0.8.8
+Summary: Efficient parallelizable algorithms for multidimensional arrays to speed up your data pipelines
+Home-page: https://github.com/neuro-ml/imops
+Download-URL: https://github.com/neuro-ml/imops/archive/v0.8.8.tar.gz
+Author: maxme1, vovaf709, talgat, alexeybelkov
+Author-email: maxme1 <max@aumi.ai>, vovaf709 <vovaf709@yandex.ru>, talgat <saparov2130@gmail.com>, alexeybelkov <fpmbelkov@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2022 NeuroML
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/neuro-ml/imops
+Project-URL: Issues, https://github.com/neuro-ml/imops/issues
+Project-URL: Source, https://github.com/neuro-ml/imops
+Project-URL: Docs, https://neuro-ml.github.io/imops
+Keywords: image processing,fast,ndarray,data pipelines
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: scipy <2.0.0,>=1.0
+Requires-Dist: scikit-image
+Requires-Dist: connected-components-3d
+Requires-Dist: fastremap
+Requires-Dist: edt <3.0.0,>=2.0.0
+Requires-Dist: dataclasses ; python_version < "3.7"
+Requires-Dist: numpy <2.0.0,>=1.7 ; python_version < "3.8"
+Requires-Dist: numpy <2.0.0,>=1.22 ; python_version >= "3.8"
+Provides-Extra: all
+Requires-Dist: numba ; extra == 'all'
+Provides-Extra: numba
+Requires-Dist: numba ; extra == 'numba'
+
+[![codecov](https://codecov.io/gh/neuro-ml/imops/branch/master/graph/badge.svg)](https://codecov.io/gh/neuro-ml/imops)
+[![pypi](https://img.shields.io/pypi/v/imops?logo=pypi&label=PyPi)](https://pypi.org/project/imops/)
+![License](https://img.shields.io/github/license/neuro-ml/imops)
+[![PyPI - Downloads](https://img.shields.io/pypi/dm/imops)](https://pypi.org/project/imops/)
+
+# Imops
+
+Efficient parallelizable algorithms for multidimensional arrays to speed up your data pipelines.
+- [Documentation](https://neuro-ml.github.io/imops/)
+- [Benchmarks](https://neuro-ml.github.io/imops/benchmarks/)
+
+# Install
+
+```shell
+pip install imops  # default install with Cython backend
+pip install imops[numba]  # additionally install Numba backend
+```
+
+# How fast is it?
+
+Time comparisons (ms) for Intel(R) Xeon(R) Silver 4114 CPU @ 2.20GHz using 8 threads. All inputs are C-contiguous NumPy arrays. For morphology functions `bool` dtype is used and `float64` for all others.
+| function / backend   |  Scipy()  |  Cython(fast=False)  |  Cython(fast=True)  |  Numba()  |
+|:----------------------:|:-----------:|:----------------------:|:---------------------:|:-----------:|
+| `zoom(..., order=0)` |   2072    |         1114         |         **867**         |   3590    |
+| `zoom(..., order=1)` |   6527    |         596          |         **575**         |   3757    |
+| `interp1d`           |    780    |         149          |         **146**         |    420    |
+| `radon`              |   59711   |         5982         |        **4837**         |      -     |
+| `inverse_radon`      |   52928   |         8254         |        **6535**         |         -  |
+| `binary_dilation`    |   2207    |         310          |         **298**         |        -   |
+| `binary_erosion`     |   2296    |         326          |         **304**         |        -   |
+| `binary_closing`     |   4158    |         544          |         **469**         |        -   |
+| `binary_opening`     |   4410    |         567          |         **522**         |        -   |
+| `center_of_mass`     |   2237    |          **64**          |         **64**          |        -   |
+
+We use [`airspeed velocity`](https://asv.readthedocs.io/en/stable/) to benchmark our code. For detailed results visit [benchmark page](https://neuro-ml.github.io/imops/benchmarks/).
+
+# Features
+
+### Fast Radon transform
+
+```python
+from imops import radon, inverse_radon
+```
+
+### Fast 0/1-order zoom
+
+```python
+from imops import zoom, zoom_to_shape
+
+# fast zoom with optional fallback to scipy's implementation
+y = zoom(x, 2, axis=[0, 1])
+# a handy function to zoom the array to a given shape 
+# without the need to compute the scale factor
+z = zoom_to_shape(x, (4, 120, 67))
+```
+Works faster only for `ndim<=4, dtype=float32 or float64 (and bool-int16-32-64-uint8-16-32 if order == 0), output=None, order=0 or 1, mode='constant', grid_mode=False`
+### Fast 1d linear interpolation
+
+```python
+from imops import interp1d  # same as `scipy.interpolate.interp1d`
+```
+Works faster only for `ndim<=3, dtype=float32 or float64, order=1`
+
+### Fast 2d linear interpolation
+```python
+import numpy as np
+from imops.interp2d import Linear2DInterpolator
+n, m = 1024, 2
+points = np.random.randint(low=0, high=1024, size=(n, m))
+points = np.unique(points, axis=0)
+x_points = points[: n // 2]
+values = np.random.uniform(low=0.0, high=1.0, size=(len(x_points),))
+interp_points = points[n // 2:]
+num_threads = -1 # will be equal to num of CPU cores
+# You can optionally pass your own triangulation as an np.array of shape [num_triangles, 3], element at (i, j) position is an index of a point from x_points
+interpolator = Linear2DInterpolator(x_points, values, num_threads=num_threads, triangles=None)
+# Also you can pass values to __call__ and rewrite the ones that were passed to __init__
+interp_values = interpolator(interp_points, values + 1.0, fill_value=0.0)
+```
+
+### Fast binary morphology
+
+```python
+from imops import binary_dilation, binary_erosion, binary_opening, binary_closing
+```
+These functions mimic `scikit-image` counterparts
+### Padding
+
+```python
+from imops import pad, pad_to_shape
+
+y = pad(x, 10, axis=[0, 1])
+# `ratio` controls how much padding is applied to left side:
+# 0 - pad from right
+# 1 - pad from left
+# 0.5 - distribute the padding equally
+z = pad_to_shape(x, (4, 120, 67), ratio=0.25)
+```
+
+### Cropping
+
+```python
+from imops import crop_to_shape
+
+# `ratio` controls the position of the crop
+# 0 - crop from right
+# 1 - crop from left
+# 0.5 - crop from the middle
+z = crop_to_shape(x, (4, 120, 67), ratio=0.25)
+```
+
+### Labeling
+
+```python
+from imops import label
+
+# same as `skimage.measure.label`
+labeled, num_components = label(x, background=1, return_num=True)
+```
+
+# Backends
+For all heavy image routines except `label` you can specify which backend to use. Backend can be specified by a string or by an instance of `Backend` class. The latter allows you to customize some backend options:
+```python
+from imops import Cython, Numba, Scipy, zoom
+
+y = zoom(x, 2, backend='Cython')
+y = zoom(x, 2, backend=Cython(fast=False))  # same as previous
+y = zoom(x, 2, backend=Cython(fast=True))  # -ffast-math compiled cython backend
+y = zoom(x, 2, backend=Scipy())  # use scipy original implementation
+y = zoom(x, 2, backend='Numba')
+y = zoom(x, 2, backend=Numba(parallel=True, nogil=True, cache=True))  # same as previous
+```
+Also backend can be specified globally or locally:
+```python
+from imops import imops_backend, set_backend, zoom
+
+set_backend('Numba')  # sets Numba as default backend
+with imops_backend('Cython'):  # sets Cython backend via context manager
+    zoom(x, 2)
+```
+Note that for `Numba` backend setting `num_threads` argument has no effect for now and you should use `NUMBA_NUM_THREADS` environment variable.
+Available backends:
+|         function / backend            | Scipy   | Cython  | Numba   |
+|:-------------------:|:---------:|:---------:|:---------:|
+| `zoom`            | &check; | &check; | &check; |
+| `interp1d`        | &check; | &check; | &check; |
+| `radon`           | &cross; | &check; | &cross; |
+| `inverse_radon`   | &cross; | &check; | &cross; |
+| `binary_dilation` | &check; | &check; | &cross; |
+| `binary_erosion`  | &check; | &check; | &cross; |
+| `binary_closing`  | &check; | &check; | &cross; |
+| `binary_opening`  | &check; | &check; | &cross; |
+| `center_of_mass`  | &check; | &check; | &cross; |
+
+# Acknowledgements
+
+Some parts of our code for radon/inverse radon transform as well as the code for linear interpolation are inspired by
+the implementations from [`scikit-image`](https://github.com/scikit-image/scikit-image) and [`scipy`](https://github.com/scipy/scipy).
+Also we used [`fastremap`](https://github.com/seung-lab/fastremap), [`edt`](https://github.com/seung-lab/euclidean-distance-transform-3d) and [`cc3d`](https://github.com/seung-lab/connected-components-3d) out of the box.

imops-0.8.8.dist-info/RECORD

@@ -0,0 +1,58 @@
+_build_utils.py,sha256=3IXWMy_HdvyR_gEjWf-xISVc3xIb8JhXiaKPWTJWxlQ,4011
+imops.libs/libgomp-a34b3233.so.1.0.0,sha256=On6uznIxkRvi-7Gz58tMtcLg-E4MK7c3OUcrWh_uyME,168193
+imops-0.8.8.dist-info/WHEEL,sha256=OvtvnbpcaxHa5TgXgfC48E6JA7zLr7svMspPP7Vk5o8,152
+imops-0.8.8.dist-info/LICENSE,sha256=s4td51soCfOr_HP5fF2gTARksncu_DD1TgugcUGTBQ0,1064
+imops-0.8.8.dist-info/top_level.txt,sha256=jd2uO-zsYvKeqkZbjEjtkGqCca0IEXEiEuoyr3nsHB0,19
+imops-0.8.8.dist-info/RECORD,,
+imops-0.8.8.dist-info/METADATA,sha256=M3BTDg7yRx0bQZAyoWNLXm14rYY8iES7h7Zy8I7F9Lw,9832
+imops/interp1d.py,sha256=DYIB58dezdctM6DWRD7repFCgc4zmT9Z1foRLsPfOWQ,8189
+imops/testing.py,sha256=-koeiCQovlwf2HZ0egvX4rb1rCpn19pcFZlfd4ygcnc,1614
+imops/pad.py,sha256=0-r5ho9Ok1veRnd6-8IPHD-GtysIMfxvRN34bCHvyHU,9109
+imops/__init__.py,sha256=FUVB4d2PQlM4PJUSIjyz9oRlWaqU6RSskyyrX56-RrY,504
+imops/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+imops/crop.py,sha256=pSCW-bl6RhowtunqEyYVJZF8NNXhlwHWIM8aF6jsZcE,4136
+imops/radon.py,sha256=CHv1SA5RfZm4_4m9ktQoWaW78e0UTKroqgb_BJ6qlWI,8988
+imops/numeric.py,sha256=r8D91GWRd4JSg8I3PsWyi5qinulhR-NIg54Ot03padQ,13333
+imops/box.py,sha256=9gixhLJ3nYhap81UuJKx07cD6xpQ8dS0FkMEsJl8bq8,1870
+imops/morphology.py,sha256=Wcee1d1U8Csk2Dl35vcakBQcPRYz2KEeiYWI0LkO3gk,18581
+imops/__version__.py,sha256=ysM7ZSdOuCpaNFiqoGIRai1zq8iwLDlTTCvJsGJ1_eA,22
+imops/measure.py,sha256=FoEkeKc7nvevc4kSEKfObQ8pyiMYEXp5t7viMcUxI0Q,8457
+imops/interp2d.py,sha256=zvDimvUBQv6aS7ayGEQoXdTKJ45hJTyqJrxyFcEnFRA,4452
+imops/zoom.py,sha256=Kzc0ER2KbuHb3xCWMoQCrrjvAeW0pulDZVY7WA2tT7E,9792
+imops/utils.py,sha256=iYsfBhDXnEd70RKozgNbgrbclqfaWvmxqXKRWxRwdUc,6703
+imops/_configs.py,sha256=PoPlwnmmCz-Z8GmKYIqR8xsqcWHPKiYSGWldbQX9GU0,705
+imops/backend.py,sha256=9kJtdd4-66SOP7MEXF-o9-aFImLtvpaqTKe1ttNb0hk,2503
+imops/cpp/cpp_modules.cpython-312-x86_64-linux-gnu.so,sha256=bpCz9ut_7klK4NkuzYn5dKnf_Lg_dpibdwRQvZQpBnI,4951769
+imops/cpp/main.cpp,sha256=ykugzMnwuZSiYn3zHjNGQHWVcr0Nf2qN85TFNj3RFEg,409
+imops/cpp/interp2d/triangulator.h,sha256=PPNy0Jk2xNnpLZaZ1qoEGxFOGhV7jljMGZ6yGY6Ptjg,7496
+imops/cpp/interp2d/utils.h,sha256=P2eTPtG13mL6hGw6sk8RlbjDUk5Y6OMElgjkVOaJh6Q,2153
+imops/cpp/interp2d/interpolator.h,sha256=Ot8tGa-Fr-qzCSGnXYWHBTNNFIbfqAivs9Sl6V0Asm0,2350
+imops/cpp/interp2d/delaunator/delaunator.cpp,sha256=O_Y-g8Q3QbKJDmZRGDqtZMezZuLJMHY3PRboQ0E6aEs,19588
+imops/cpp/interp2d/delaunator/delaunator-header-only.hpp,sha256=i-_ywMT72biNMds6_ZV3ZrI-IE2Q6eiGiwMWkMpET7U,1260
+imops/cpp/interp2d/delaunator/delaunator.hpp,sha256=5AapHrvOZxDD3acbIr5OrS2RC7b9v5L_rqxu0N-jYb4,4724
+imops/src/_measure.cpython-312-x86_64-linux-gnu.so,sha256=Yl4uEuAcGZa8hR7912Svp0jWAEwG7lBXh_3l7DXXgkA,2297625
+imops/src/_backprojection.c,sha256=UyPJpy2a5KZvTxJJnrDBB17Xr4s5ulv869JdFZsSHMo,1033252
+imops/src/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+imops/src/_fast_measure.c,sha256=CPWtlrItw4a3msEj84NnkuPrmcNcNGj7YvOZG8BPLjA,1335614
+imops/src/_numba_zoom.py,sha256=NH1u-64xExw0b_l6GQJ7ICOoWVsGOH8ztuS1LFvsiz0,16354
+imops/src/_zoom.cpython-312-x86_64-linux-gnu.so,sha256=A43wDYuxq8gZPookG9WoTG1qEXiSSDRcao42TlNi4MQ,4427489
+imops/src/_fast_measure.cpython-312-x86_64-linux-gnu.so,sha256=uQbWTaAoi9k1VLsMgNhMPyl4R56oQtPqsnXLReGa5V4,2297633
+imops/src/_fast_numeric.cpython-312-x86_64-linux-gnu.so,sha256=7SBHXjRQN8qxGTB7zICnvgldhj7lLzNjpwWKCrhFT3w,3696441
+imops/src/_zoom.c,sha256=awVmRLERchuLo-50KrmN_bhGXYDB8YZUf2GU1G0EgUA,2380754
+imops/src/_fast_morphology.cpython-312-x86_64-linux-gnu.so,sha256=k1iL8WrNaSrgeA2C1ZSR0UwbHsG_guOUijapJswOUmg,1441249
+imops/src/_fast_numeric.c,sha256=zvW2Gtkjj630HOpA3ILvm8ml-ZLyMc8P8mTMgzmazIo,2106393
+imops/src/_measure.c,sha256=p9NEr20WnRvWSJhZh9JS0WH1gwvXvLfdWLEOKEDwISc,1332239
+imops/src/_morphology.cpython-312-x86_64-linux-gnu.so,sha256=jJAERIbKnqu2lWIQIo6PeNu2KzzZohwN3EFGd5MaymQ,1441241
+imops/src/_fast_zoom.c,sha256=lrE8q8NNi3TzgdMn8K2s-8uu968UqUCHiMbZzq18vck,2393159
+imops/src/_fast_backprojection.cpython-312-x86_64-linux-gnu.so,sha256=jqLGXOzY9glgKkpdBm0vo3btlNqGJ8xON30gleqjYrc,1761033
+imops/src/_fast_zoom.cpython-312-x86_64-linux-gnu.so,sha256=heMRHGZCFAtdNHG5Qhb2xshrRKt_OMjM5jaj-uFtymM,4427497
+imops/src/_fast_radon.c,sha256=d3Trvl4iowrTKMWW1kqLojYVOKelqBZO5Rac76YrUdE,1189327
+imops/src/_numeric.c,sha256=uVZ4BGBqja3XJ7JMBXVUFALdB2FAahhmJa_bxFvie0w,2099050
+imops/src/_fast_backprojection.c,sha256=3sDluZNsZL10u-BZ2nKOQ2-ntvKMvsVzDGd1eFM2hbI,1035336
+imops/src/_radon.c,sha256=8Q7gSjgLvYeZv250f0PHLPuEPBVKOfS_uffh55hnAj0,1186305
+imops/src/_fast_morphology.c,sha256=fcZMkjD9KIrr17EwfJ3wWF1UlrIA6TWKnnErx1tyOMM,970857
+imops/src/_numeric.cpython-312-x86_64-linux-gnu.so,sha256=NGmzE_3JNOklRey-wJj03mMWVL0mAsPfmD6Zdx2UVBM,3696433
+imops/src/_fast_radon.cpython-312-x86_64-linux-gnu.so,sha256=1kXKNeghUv-sVDv-ougS3ZmEhhcrxGJTREH1IgSBN2c,2141945
+imops/src/_backprojection.cpython-312-x86_64-linux-gnu.so,sha256=As6x_wsQ5H0RcruMs3EGcDZfg_LSZHGARBnCFXLGJ54,1761017
+imops/src/_radon.cpython-312-x86_64-linux-gnu.so,sha256=GAJfGXm9f9zJWpjx-DzSCqpjPtKUf8woaa5588dav1Q,2137841
+imops/src/_morphology.c,sha256=USc9fDuYR94FXSMXV6ZUIwaTzTCpfeJ_DG93Esg8Ol8,968231

imops-0.8.8.dist-info/WHEEL

@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.43.0)
+Root-Is-Purelib: false
+Tag: cp312-cp312-manylinux_2_17_x86_64
+Tag: cp312-cp312-manylinux2014_x86_64
+

imops-0.8.8.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+_build_utils
+imops