| Name | cuml-cu12 JSON |
| Version |
24.8.0
JSON |
| download |
| home_page | None |
| Summary | cuML - RAPIDS ML Algorithms |
| upload_time | 2024-08-08 14:55:38 |
| maintainer | None |
| docs_url | None |
| author | NVIDIA Corporation |
| requires_python | >=3.9 |
| license | Apache 2.0 |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# cuML Python Package
This folder contains the Python and Cython code of the algorithms and ML primitives of cuML, that are distributed in the Python cuML package.
Contents:
- [cuML Python Package](#cuml-python-package)
- [Build Configuration](#build-configuration)
- [RAFT Integration in cuml.raft](#raft-integration-in-cumlraft)
- [Build Requirements](#build-requirements)
- [Python Tests](#python-tests)
### Build Configuration
The build system uses setup.py for configuration and building.
cuML's setup.py can be configured through environment variables and command line arguments.
The environment variables are:
| Environment variable | Possible values | Default behavior if not set | Behavior |
| --- | --- | --- | --- |
| CUDA_HOME | path/to/cuda_toolkit | Inferred by location of `nvcc` | Optional variable allowing to manually specify location of the CUDA toolkit. |
| CUML_BUILD_PATH | path/to/libcuml_build_folder | Looked for in path_to_cuml_repo/cpp/build | Optional variable allowing to manually specify location of libcuml++ build folder. |
| RAFT_PATH | path/to/raft | Looked for in path_to_cuml_repo/cpp/build, if not found clone | Optional variable allowing to manually specify location of the RAFT Repository. |
The command line arguments (i.e. passed alongside `setup.py` when invoking, for
example `setup.py --singlegpu`) are:
| Argument | Behavior |
| --- | --- |
| clean --all | Cleans all Python and Cython artifacts, including pycache folders, .cpp files resulting of cythonization and compiled extensions. |
| --singlegpu | Option to build cuML without multiGPU algorithms. Removes dependency on nccl, libcumlprims and ucx-py. |
### RAFT Integration in cuml.raft
RAFT's Python and Cython is located in the [RAFT repository](https://github.com/rapidsai/raft/python). It was designed to be included in projects as opposed to be distributed by itself, so at build time, **setup.py creates a symlink from cuML, located in `/python/cuml/raft/` to the Python folder of RAFT**.
For developers that need to modify RAFT code, please refer to the [RAFT Developer Guide](https://github.com/rapidsai/raft/blob/branch-24.08/docs/source/build.md) for recommendations.
To configure RAFT at build time:
1. If the environment variable `RAFT_PATH` points to the RAFT repo, then that will be used.
2. If there is a libcuml build folder that has cloned RAFT already, setup.py will use that RAFT. Location of this can be configured with the environment variable CUML_BUILD_PATH.
3. If none of the above happened, then setup.py will clone RAFT and use it directly.
The RAFT Python code gets included in the cuML build and distributable artifacts as if it was always present in the folder structure of cuML.
### Build Requirements
cuML's convenience [development yaml files](https://github.com/rapidsai/cuml/tree/branch-24.08/environments) includes all dependencies required to build cuML.
To build cuML's Python package, the following dependencies are required:
- cudatoolkit version corresponding to system CUDA toolkit
- cython >= 0.29, < 0.30
- numpy
- cmake >= 3.14
- cudf version matching the cuML version
- libcuml version matching the cuML version
- libcuml={{ version }}
- cupy>=7.8.0,<12.0.0a0
- joblib >=0.11
Packages required for multigpu algorithms*:
- libcumlprims version matching the cuML version
- ucx-py version matching the cuML version
- dask-cudf version matching the cuML version
- nccl>=2.5
- rapids-dask-dependency version matching the cuML version
* this can be avoided with `--singlegpu` argument flag.
### Python Tests
Python tests are based on the pytest library. To run them, from the `path_to_cuml/python/` folder, simply type `pytest`.
Raw data
{
"_id": null,
"home_page": null,
"name": "cuml-cu12",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": null,
"author": "NVIDIA Corporation",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/0d/c6/4c5c466fe05520d2d820539b49c932314827ab7ac3dd9e2dee90bdcf288d/cuml_cu12-24.8.0.tar.gz",
"platform": null,
"description": "# cuML Python Package\n\nThis folder contains the Python and Cython code of the algorithms and ML primitives of cuML, that are distributed in the Python cuML package.\n\nContents:\n\n- [cuML Python Package](#cuml-python-package)\n - [Build Configuration](#build-configuration)\n - [RAFT Integration in cuml.raft](#raft-integration-in-cumlraft)\n - [Build Requirements](#build-requirements)\n - [Python Tests](#python-tests)\n\n### Build Configuration\n\nThe build system uses setup.py for configuration and building.\n\ncuML's setup.py can be configured through environment variables and command line arguments.\n\nThe environment variables are:\n\n| Environment variable | Possible values | Default behavior if not set | Behavior |\n| --- | --- | --- | --- |\n| CUDA_HOME | path/to/cuda_toolkit | Inferred by location of `nvcc` | Optional variable allowing to manually specify location of the CUDA toolkit. |\n| CUML_BUILD_PATH | path/to/libcuml_build_folder | Looked for in path_to_cuml_repo/cpp/build | Optional variable allowing to manually specify location of libcuml++ build folder. |\n| RAFT_PATH | path/to/raft | Looked for in path_to_cuml_repo/cpp/build, if not found clone | Optional variable allowing to manually specify location of the RAFT Repository. |\n\nThe command line arguments (i.e. passed alongside `setup.py` when invoking, for\nexample `setup.py --singlegpu`) are:\n\n\n| Argument | Behavior |\n| --- | --- |\n| clean --all | Cleans all Python and Cython artifacts, including pycache folders, .cpp files resulting of cythonization and compiled extensions. |\n| --singlegpu | Option to build cuML without multiGPU algorithms. Removes dependency on nccl, libcumlprims and ucx-py. |\n\n\n### RAFT Integration in cuml.raft\n\nRAFT's Python and Cython is located in the [RAFT repository](https://github.com/rapidsai/raft/python). It was designed to be included in projects as opposed to be distributed by itself, so at build time, **setup.py creates a symlink from cuML, located in `/python/cuml/raft/` to the Python folder of RAFT**.\n\nFor developers that need to modify RAFT code, please refer to the [RAFT Developer Guide](https://github.com/rapidsai/raft/blob/branch-24.08/docs/source/build.md) for recommendations.\n\nTo configure RAFT at build time:\n\n1. If the environment variable `RAFT_PATH` points to the RAFT repo, then that will be used.\n2. If there is a libcuml build folder that has cloned RAFT already, setup.py will use that RAFT. Location of this can be configured with the environment variable CUML_BUILD_PATH.\n3. If none of the above happened, then setup.py will clone RAFT and use it directly.\n\nThe RAFT Python code gets included in the cuML build and distributable artifacts as if it was always present in the folder structure of cuML.\n\n### Build Requirements\n\ncuML's convenience [development yaml files](https://github.com/rapidsai/cuml/tree/branch-24.08/environments) includes all dependencies required to build cuML.\n\nTo build cuML's Python package, the following dependencies are required:\n\n- cudatoolkit version corresponding to system CUDA toolkit\n- cython >= 0.29, < 0.30\n- numpy\n- cmake >= 3.14\n- cudf version matching the cuML version\n- libcuml version matching the cuML version\n- libcuml={{ version }}\n- cupy>=7.8.0,<12.0.0a0\n- joblib >=0.11\n\nPackages required for multigpu algorithms*:\n- libcumlprims version matching the cuML version\n- ucx-py version matching the cuML version\n- dask-cudf version matching the cuML version\n- nccl>=2.5\n- rapids-dask-dependency version matching the cuML version\n\n* this can be avoided with `--singlegpu` argument flag.\n\n\n### Python Tests\n\nPython tests are based on the pytest library. To run them, from the `path_to_cuml/python/` folder, simply type `pytest`.\n\n\n",
"bugtrack_url": null,
"license": "Apache 2.0",
"summary": "cuML - RAPIDS ML Algorithms",
"version": "24.8.0",
"project_urls": {
"Documentation": "https://docs.rapids.ai/api/cuml/stable/",
"Homepage": "https://github.com/rapidsai/cuml"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "0dc64c5c466fe05520d2d820539b49c932314827ab7ac3dd9e2dee90bdcf288d",
"md5": "d1d85f8ff782afc4dd7a00d5b949bdfe",
"sha256": "25dd897bc9d60856f305ebb7ac0914e8009a3cc57cfd0cf0711403645a0717a1"
},
"downloads": -1,
"filename": "cuml_cu12-24.8.0.tar.gz",
"has_sig": false,
"md5_digest": "d1d85f8ff782afc4dd7a00d5b949bdfe",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 2070,
"upload_time": "2024-08-08T14:55:38",
"upload_time_iso_8601": "2024-08-08T14:55:38.981214Z",
"url": "https://files.pythonhosted.org/packages/0d/c6/4c5c466fe05520d2d820539b49c932314827ab7ac3dd9e2dee90bdcf288d/cuml_cu12-24.8.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-08 14:55:38",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "rapidsai",
"github_project": "cuml",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "cuml-cu12"
}
