# <div align="left"><img src="https://rapids.ai/assets/images/rapids_logo.png" width="90px"/> cuCIM</div>
[RAPIDS](https://rapids.ai) cuCIM is an open-source, accelerated computer vision and image processing software library for multidimensional images used in biomedical, geospatial, material and life science, and remote sensing use cases.
cuCIM offers:
- Enhanced Image Processing Capabilities for large and n-dimensional tag image file format (TIFF) files
- Accelerated performance through Graphics Processing Unit (GPU)-based image processing and computer vision primitives
- A Straightforward Pythonic Interface with Matching Application Programming Interface (API) for Openslide
cuCIM supports the following formats:
- Aperio ScanScope Virtual Slide (SVS)
- Philips TIFF
- Generic Tiled, Multi-resolution RGB TIFF files with the following compression schemes:
- No Compression
- JPEG
- JPEG2000
- Lempel-Ziv-Welch (LZW)
- Deflate
**NOTE:** For the latest stable [README.md](https://github.com/rapidsai/cucim/blob/main/README.md) ensure you are on the `main` branch.
- [GTC 2022 Accelerating Storage IO to GPUs with Magnum IO [S41347]](https://events.rainfocus.com/widget/nvidia/gtcspring2022/sessioncatalog/session/1634960000577001Etxp)
- cuCIM's GDS API examples: <https://github.com/NVIDIA/MagnumIO/tree/main/gds/readers/cucim-gds>
- [SciPy 2021 cuCIM - A GPU image I/O and processing library](https://www.scipy2021.scipy.org/)
- [video](https://youtu.be/G46kOOM9xbQ)
- [GTC 2021 cuCIM: A GPU Image I/O and Processing Toolkit [S32194]](https://www.nvidia.com/en-us/on-demand/search/?facet.mimetype[]=event%20session&layout=list&page=1&q=cucim&sort=date)
- [video](https://www.nvidia.com/en-us/on-demand/session/gtcspring21-s32194/)
**[Developer Page](https://developer.nvidia.com/multidimensional-image-processing)**
**Blogs**
- [Enhanced Image Analysis with Multidimensional Image Processing](https://developer.nvidia.com/blog/enhanced-image-analysis-with-multidimensional-image-processing/)
- [Accelerating Scikit-Image API with cuCIM: n-Dimensional Image Processing and IO on GPUs](https://developer.nvidia.com/blog/cucim-rapid-n-dimensional-image-processing-and-i-o-on-gpus/)
- [Accelerating Digital Pathology Pipelines with NVIDIA Claraâ„¢ Deploy](https://developer.nvidia.com/blog/accelerating-digital-pathology-pipelines-with-nvidia-clara-deploy-2/)
**Webinars**
- [cuCIM: a GPU Image IO and Processing Library](https://www.youtube.com/watch?v=G46kOOM9xbQ)
**[Documentation](https://docs.rapids.ai/api/cucim/stable)**
**Release notes** are available on our [wiki page](https://github.com/rapidsai/cucim/wiki/Release-Notes).
## Install cuCIM
### Conda
#### [Conda (stable)](https://anaconda.org/rapidsai/cucim)
```bash
conda create -n cucim -c rapidsai -c conda-forge cucim cuda-version=`<CUDA version>`
```
`<CUDA version>` should be 11.2+ (e.g., `11.2`, `12.0`, etc.)
#### [Conda (nightlies)](https://anaconda.org/rapidsai-nightly/cucim)
```bash
conda create -n cucim -c rapidsai-nightly -c conda-forge cucim cuda-version=`<CUDA version>`
```
`<CUDA version>` should be 11.2+ (e.g., `11.2`, `12.0`, etc.)
### [PyPI](https://pypi.org/project/cucim/)
Install for CUDA 12:
```bash
pip install cucim-cu12
```
Alternatively install for CUDA 11:
```bash
pip install cucim-cu11
```
### Notebooks
Please check out our [Welcome](notebooks/Welcome.ipynb) notebook ([NBViewer](https://nbviewer.org/github/rapidsai/cucim/blob/main/notebooks/Welcome.ipynb))
#### Downloading sample images
To download images used in the notebooks, please execute the following commands from the repository root folder to copy sample input images into `notebooks/input` folder:
(You will need [Docker](https://www.docker.com/) installed in your system)
```bash
./run download_testdata
```
or
```bash
mkdir -p notebooks/input
tmp_id=$(docker create gigony/svs-testdata:little-big)
docker cp $tmp_id:/input notebooks
docker rm -v ${tmp_id}
```
## Build/Install from Source
See build [instructions](CONTRIBUTING.md#setting-up-your-build-environment).
## Contributing Guide
Contributions to cuCIM are more than welcome!
Please review the [CONTRIBUTING.md](https://github.com/rapidsai/cucim/blob/main/CONTRIBUTING.md) file for information on how to contribute code and issues to the project.
## Acknowledgments
Without awesome third-party open source software, this project wouldn't exist.
Please find [LICENSE-3rdparty.md](LICENSE-3rdparty.md) to see which third-party open source software
is used in this project.
## License
Apache-2.0 License (see [LICENSE](LICENSE) file).
Copyright (c) 2020-2024, NVIDIA CORPORATION.
Raw data
{
"_id": null,
"home_page": "https://developer.nvidia.com/cucim-for-image-io-processing",
"name": "pylibcucim-cu12",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": null,
"author": "NVIDIA Corporation",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/96/3f/60ef568182154d2f6b89ef9bbc0f53a70253d05473e67b86e19ef04472a1/pylibcucim_cu12-0.0.0.tar.gz",
"platform": null,
"description": "# <div align=\"left\"><img src=\"https://rapids.ai/assets/images/rapids_logo.png\" width=\"90px\"/> cuCIM</div>\n\n[RAPIDS](https://rapids.ai) cuCIM is an open-source, accelerated computer vision and image processing software library for multidimensional images used in biomedical, geospatial, material and life science, and remote sensing use cases.\n\ncuCIM offers:\n\n- Enhanced Image Processing Capabilities for large and n-dimensional tag image file format (TIFF) files\n- Accelerated performance through Graphics Processing Unit (GPU)-based image processing and computer vision primitives\n- A Straightforward Pythonic Interface with Matching Application Programming Interface (API) for Openslide\n\ncuCIM supports the following formats:\n\n- Aperio ScanScope Virtual Slide (SVS)\n- Philips TIFF\n- Generic Tiled, Multi-resolution RGB TIFF files with the following compression schemes:\n - No Compression\n - JPEG\n - JPEG2000\n - Lempel-Ziv-Welch (LZW)\n - Deflate\n\n**NOTE:** For the latest stable [README.md](https://github.com/rapidsai/cucim/blob/main/README.md) ensure you are on the `main` branch.\n\n- [GTC 2022 Accelerating Storage IO to GPUs with Magnum IO [S41347]](https://events.rainfocus.com/widget/nvidia/gtcspring2022/sessioncatalog/session/1634960000577001Etxp)\n - cuCIM's GDS API examples: <https://github.com/NVIDIA/MagnumIO/tree/main/gds/readers/cucim-gds>\n- [SciPy 2021 cuCIM - A GPU image I/O and processing library](https://www.scipy2021.scipy.org/)\n - [video](https://youtu.be/G46kOOM9xbQ)\n- [GTC 2021 cuCIM: A GPU Image I/O and Processing Toolkit [S32194]](https://www.nvidia.com/en-us/on-demand/search/?facet.mimetype[]=event%20session&layout=list&page=1&q=cucim&sort=date)\n - [video](https://www.nvidia.com/en-us/on-demand/session/gtcspring21-s32194/)\n\n**[Developer Page](https://developer.nvidia.com/multidimensional-image-processing)**\n\n**Blogs**\n- [Enhanced Image Analysis with Multidimensional Image Processing](https://developer.nvidia.com/blog/enhanced-image-analysis-with-multidimensional-image-processing/)\n- [Accelerating Scikit-Image API with cuCIM: n-Dimensional Image Processing and IO on GPUs](https://developer.nvidia.com/blog/cucim-rapid-n-dimensional-image-processing-and-i-o-on-gpus/)\n- [Accelerating Digital Pathology Pipelines with NVIDIA Clara\u2122 Deploy](https://developer.nvidia.com/blog/accelerating-digital-pathology-pipelines-with-nvidia-clara-deploy-2/)\n\n**Webinars**\n\n- [cuCIM: a GPU Image IO and Processing Library](https://www.youtube.com/watch?v=G46kOOM9xbQ)\n\n**[Documentation](https://docs.rapids.ai/api/cucim/stable)**\n\n**Release notes** are available on our [wiki page](https://github.com/rapidsai/cucim/wiki/Release-Notes).\n\n## Install cuCIM\n\n### Conda\n\n#### [Conda (stable)](https://anaconda.org/rapidsai/cucim)\n\n```bash\nconda create -n cucim -c rapidsai -c conda-forge cucim cuda-version=`<CUDA version>`\n```\n\n`<CUDA version>` should be 11.2+ (e.g., `11.2`, `12.0`, etc.)\n\n#### [Conda (nightlies)](https://anaconda.org/rapidsai-nightly/cucim)\n\n```bash\nconda create -n cucim -c rapidsai-nightly -c conda-forge cucim cuda-version=`<CUDA version>`\n```\n\n`<CUDA version>` should be 11.2+ (e.g., `11.2`, `12.0`, etc.)\n\n### [PyPI](https://pypi.org/project/cucim/)\n\nInstall for CUDA 12:\n\n```bash\npip install cucim-cu12\n```\n\nAlternatively install for CUDA 11:\n\n```bash\npip install cucim-cu11\n```\n\n### Notebooks\n\nPlease check out our [Welcome](notebooks/Welcome.ipynb) notebook ([NBViewer](https://nbviewer.org/github/rapidsai/cucim/blob/main/notebooks/Welcome.ipynb))\n\n#### Downloading sample images\n\nTo download images used in the notebooks, please execute the following commands from the repository root folder to copy sample input images into `notebooks/input` folder:\n\n(You will need [Docker](https://www.docker.com/) installed in your system)\n\n```bash\n./run download_testdata\n```\nor\n\n```bash\nmkdir -p notebooks/input\ntmp_id=$(docker create gigony/svs-testdata:little-big)\ndocker cp $tmp_id:/input notebooks\ndocker rm -v ${tmp_id}\n```\n\n## Build/Install from Source\n\nSee build [instructions](CONTRIBUTING.md#setting-up-your-build-environment).\n\n## Contributing Guide\n\nContributions to cuCIM are more than welcome!\nPlease review the [CONTRIBUTING.md](https://github.com/rapidsai/cucim/blob/main/CONTRIBUTING.md) file for information on how to contribute code and issues to the project.\n\n## Acknowledgments\n\nWithout awesome third-party open source software, this project wouldn't exist.\n\nPlease find [LICENSE-3rdparty.md](LICENSE-3rdparty.md) to see which third-party open source software\nis used in this project.\n\n## License\n\nApache-2.0 License (see [LICENSE](LICENSE) file).\n\nCopyright (c) 2020-2024, NVIDIA CORPORATION.\n",
"bugtrack_url": null,
"license": "Apache 2.0",
"summary": "cuCIM - an extensible toolkit designed to provide GPU accelerated I/O, computer vision & image processing primitives for N-Dimensional images with a focus on biomedical imaging.",
"version": "0.0.0",
"project_urls": {
"Homepage": "https://developer.nvidia.com/cucim-for-image-io-processing"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f470aac4840ae9e46275659812fc22e58f9d145a083a39a92b29d3fa3cd31f66",
"md5": "4491cde41816afb8ecf5a970757db390",
"sha256": "c6bed23f408c38f82b1e18c2942b682aa12be5cd5b4079ee4fa656c619d09309"
},
"downloads": -1,
"filename": "pylibcucim_cu12-0.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4491cde41816afb8ecf5a970757db390",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 3652,
"upload_time": "2024-11-06T06:17:14",
"upload_time_iso_8601": "2024-11-06T06:17:14.669744Z",
"url": "https://files.pythonhosted.org/packages/f4/70/aac4840ae9e46275659812fc22e58f9d145a083a39a92b29d3fa3cd31f66/pylibcucim_cu12-0.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "963f60ef568182154d2f6b89ef9bbc0f53a70253d05473e67b86e19ef04472a1",
"md5": "c584c2e898fabbcda27ca6968ffc8bfb",
"sha256": "e3d59f3cf41dc59d339772f1ae463461ca14980717029e342db6ef00126ef031"
},
"downloads": -1,
"filename": "pylibcucim_cu12-0.0.0.tar.gz",
"has_sig": false,
"md5_digest": "c584c2e898fabbcda27ca6968ffc8bfb",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 3962,
"upload_time": "2024-11-06T06:17:15",
"upload_time_iso_8601": "2024-11-06T06:17:15.857008Z",
"url": "https://files.pythonhosted.org/packages/96/3f/60ef568182154d2f6b89ef9bbc0f53a70253d05473e67b86e19ef04472a1/pylibcucim_cu12-0.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-06 06:17:15",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "pylibcucim-cu12"
}