# chunky3d
A 3D array-like NumPy-based data structure for large sparsely-populated volumes
## Build
[![Build Status](https://travis-ci.org/K3D-tools/chunky3d.svg?branch=master)](https://travis-ci.org/K3D-tools/chunky3d)
# Introduction
This library provides a data structure, `Sparse`, which represents 3D volumetric data
and supports a subset of `np.ndarray` features.
## Example
```
>>> import numpy as np
>>> from chunky3d import Sparse
>>> s = Sparse(shape=(64, 64, 64))
>>> s[0, 0, 0]
0
>>> s.dtype
numpy.float64
>>> s.nchunks
8
>>> s.nchunks_initialized
0
>>> s[1, 2, 3] = 3
>>> s.nchunks_initialized
1
>>> s[:2, 2, 3:5]
array([[0., 0.],
[3., 0.]])
```
# Features
* `chunky3d.sparse_func` - a collection of functions for analyzing chunked arrays, including
morphological operations (opening, closing), thinning, connected components
* Fast load and save using `msgpack`
* Operations on arrays using `.run()`, with possible acceleration using `multiprocessing`
* `multiprocessing`-based acceleration in most of existing `sparse_func`
* Accelerated lookup using `numba`
* Interpolation (point probe)
* Origin and spacing: representing 3D space with non-uniform spacing for different axes
* Easy visualization of arrays with `dtype=np.uint8` via `chunky3d.k3d_connector.get_k3d_object()`
Raw data
{
"_id": null,
"home_page": null,
"name": "chunky3d",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "3d, array, chunked, sparse",
"author": null,
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/8b/7e/7ed49ec80c3549d440a7f02f5353e3d2c4720c65da98f44363c6bc76e8a9/chunky3d-0.1.14.tar.gz",
"platform": null,
"description": "# chunky3d\nA 3D array-like NumPy-based data structure for large sparsely-populated volumes\n\n## Build\n[![Build Status](https://travis-ci.org/K3D-tools/chunky3d.svg?branch=master)](https://travis-ci.org/K3D-tools/chunky3d)\n\n# Introduction\n\nThis library provides a data structure, `Sparse`, which represents 3D volumetric data\nand supports a subset of `np.ndarray` features.\n\n## Example\n\n```\n>>> import numpy as np\n>>> from chunky3d import Sparse\n\n>>> s = Sparse(shape=(64, 64, 64))\n>>> s[0, 0, 0]\n0\n\n>>> s.dtype\nnumpy.float64\n\n>>> s.nchunks\n8\n\n>>> s.nchunks_initialized\n0\n\n>>> s[1, 2, 3] = 3\n>>> s.nchunks_initialized\n1\n\n>>> s[:2, 2, 3:5]\narray([[0., 0.],\n [3., 0.]])\n```\n\n# Features\n\n* `chunky3d.sparse_func` - a collection of functions for analyzing chunked arrays, including \n morphological operations (opening, closing), thinning, connected components\n* Fast load and save using `msgpack`\n* Operations on arrays using `.run()`, with possible acceleration using `multiprocessing`\n* `multiprocessing`-based acceleration in most of existing `sparse_func`\n* Accelerated lookup using `numba`\n* Interpolation (point probe)\n* Origin and spacing: representing 3D space with non-uniform spacing for different axes\n* Easy visualization of arrays with `dtype=np.uint8` via `chunky3d.k3d_connector.get_k3d_object()`\n\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A 3D array-like NumPy-based data structure for large sparsely-populated volumes",
"version": "0.1.14",
"project_urls": {
"Source": "https://github.com/K3D-tools/chunky3d",
"Tracker": "https://github.com/K3D-tools/chunky3d/issues"
},
"split_keywords": [
"3d",
" array",
" chunked",
" sparse"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c2f1f5c6d77221bbce216e921da5e330b4b7ac37600dd8687f3178de1a0409be",
"md5": "c7d53d5a685a1cb090bd6fbfc091538d",
"sha256": "b7e2fec83ead6604f035dbd0fa0e84f78ba9a5ffb2e5138688dfc3c021561415"
},
"downloads": -1,
"filename": "chunky3d-0.1.14-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c7d53d5a685a1cb090bd6fbfc091538d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 33263,
"upload_time": "2024-12-21T22:12:15",
"upload_time_iso_8601": "2024-12-21T22:12:15.428880Z",
"url": "https://files.pythonhosted.org/packages/c2/f1/f5c6d77221bbce216e921da5e330b4b7ac37600dd8687f3178de1a0409be/chunky3d-0.1.14-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "8b7e7ed49ec80c3549d440a7f02f5353e3d2c4720c65da98f44363c6bc76e8a9",
"md5": "deb6683a8f8fb700f457ca62e5a032d2",
"sha256": "9f734fcae113445e2b17e54eb525c22785766b9af776473c870b928a4d264f0a"
},
"downloads": -1,
"filename": "chunky3d-0.1.14.tar.gz",
"has_sig": false,
"md5_digest": "deb6683a8f8fb700f457ca62e5a032d2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 30968,
"upload_time": "2024-12-21T22:12:19",
"upload_time_iso_8601": "2024-12-21T22:12:19.769828Z",
"url": "https://files.pythonhosted.org/packages/8b/7e/7ed49ec80c3549d440a7f02f5353e3d2c4720c65da98f44363c6bc76e8a9/chunky3d-0.1.14.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-21 22:12:19",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "K3D-tools",
"github_project": "chunky3d",
"travis_ci": true,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "dill",
"specs": []
},
{
"name": "msgpack",
"specs": []
},
{
"name": "msgpack_numpy",
"specs": []
},
{
"name": "numba",
"specs": []
},
{
"name": "psutil",
"specs": []
},
{
"name": "scipy",
"specs": []
},
{
"name": "scikit-image",
"specs": []
}
],
"lcname": "chunky3d"
}