# stactools-datacube
[](https://pypi.org/project/stactools-datacube/)
- Name: datacube
- Package: `stactools.datacube`
- [stactools-datacube on PyPI](https://pypi.org/project/stactools-datacube/)
- Owner: @constantinius
- STAC extensions used:
- [datacube](https://github.com/stac-extensions/datacube/)
- [Browse the example in human-readable form](https://radiantearth.github.io/stac-browser/#/external/raw.githubusercontent.com/stactools-packages/datacube/main/examples/item/item.json)
This stactools extension package allows to create or extend STAC Items
dealing with multi-dimensional data formats and to extract `datacube` related
metadata from these assets.
This extension relies on the GDAL multi-dimensional raster capabilities via
the official Python API.
## STAC Examples
- [Item](examples/item/item.json)
## Installation
```shell
pip install "pygdal==$(gdal-config --version).*"
pip install stactools-datacube
```
## Command-line Usage
This command creates a new STAC Item from a multi-dimensional file like a
netCDF:
```shell
stac datacube create-item source destination
```
The following command extends an existing STAC Item, optionally by
specifying an explicit asset:
```shell
stac datacube extend-item source --asset asset-name
```
Use `stac datacube --help` to see all subcommands and options.
## Contributing
We use [pre-commit](https://pre-commit.com/) to check any changes.
To set up your development environment:
```shell
pip install -e .
pip install -r requirements-dev.txt
pre-commit install
```
To check all files:
```shell
pre-commit run --all-files
```
To run the tests:
```shell
pytest -vv
```
Raw data
{
"_id": null,
"home_page": "https://github.com/stactools-packages/datacube",
"name": "stactools-datacube",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "stactools,pystac,catalog,STAC",
"author": "stac-utils",
"author_email": "stac@radiant.earth",
"download_url": "https://files.pythonhosted.org/packages/15/2b/9e859de79fb62fa1d73fb2e312ffb718150c0e5f5274fcf760b0c7970620/stactools-datacube-0.1.0.tar.gz",
"platform": null,
"description": "# stactools-datacube\n\n[](https://pypi.org/project/stactools-datacube/)\n\n- Name: datacube\n- Package: `stactools.datacube`\n- [stactools-datacube on PyPI](https://pypi.org/project/stactools-datacube/)\n- Owner: @constantinius\n- STAC extensions used:\n - [datacube](https://github.com/stac-extensions/datacube/)\n- [Browse the example in human-readable form](https://radiantearth.github.io/stac-browser/#/external/raw.githubusercontent.com/stactools-packages/datacube/main/examples/item/item.json)\n\nThis stactools extension package allows to create or extend STAC Items\ndealing with multi-dimensional data formats and to extract `datacube` related\nmetadata from these assets.\n\nThis extension relies on the GDAL multi-dimensional raster capabilities via\nthe official Python API.\n\n## STAC Examples\n\n- [Item](examples/item/item.json)\n\n## Installation\n\n```shell\npip install \"pygdal==$(gdal-config --version).*\"\npip install stactools-datacube\n```\n\n## Command-line Usage\n\nThis command creates a new STAC Item from a multi-dimensional file like a\nnetCDF:\n\n```shell\nstac datacube create-item source destination\n```\n\nThe following command extends an existing STAC Item, optionally by\nspecifying an explicit asset:\n\n```shell\nstac datacube extend-item source --asset asset-name\n```\n\nUse `stac datacube --help` to see all subcommands and options.\n\n## Contributing\n\nWe use [pre-commit](https://pre-commit.com/) to check any changes.\nTo set up your development environment:\n\n```shell\npip install -e .\npip install -r requirements-dev.txt\npre-commit install\n```\n\nTo check all files:\n\n```shell\npre-commit run --all-files\n```\n\nTo run the tests:\n\n```shell\npytest -vv\n```\n",
"bugtrack_url": null,
"license": "",
"summary": "stactools package for datacube data formats",
"version": "0.1.0",
"project_urls": {
"Homepage": "https://github.com/stactools-packages/datacube",
"Issues": "https://github.com/stactools-packages/datacube/issues"
},
"split_keywords": [
"stactools",
"pystac",
"catalog",
"stac"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "eadb4f388f978aa3867d355b5ba6c8071b6de0fe937b3c639ee4360672cf2bd3",
"md5": "ca7f0cfebed3f8a34efdf778ce318087",
"sha256": "73a8594ac80feff5b804fc48384d586e1df2336b0ed7c802c9557eec313a8538"
},
"downloads": -1,
"filename": "stactools_datacube-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ca7f0cfebed3f8a34efdf778ce318087",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 7688,
"upload_time": "2023-09-05T14:28:07",
"upload_time_iso_8601": "2023-09-05T14:28:07.122103Z",
"url": "https://files.pythonhosted.org/packages/ea/db/4f388f978aa3867d355b5ba6c8071b6de0fe937b3c639ee4360672cf2bd3/stactools_datacube-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "152b9e859de79fb62fa1d73fb2e312ffb718150c0e5f5274fcf760b0c7970620",
"md5": "b4a93282366bd061b79350ac1917a8d0",
"sha256": "cb5865b80f534c7f30e1ab2a40f559711ac83490fc517de2c0327e56ef2e3430"
},
"downloads": -1,
"filename": "stactools-datacube-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "b4a93282366bd061b79350ac1917a8d0",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 9290,
"upload_time": "2023-09-05T14:28:08",
"upload_time_iso_8601": "2023-09-05T14:28:08.507864Z",
"url": "https://files.pythonhosted.org/packages/15/2b/9e859de79fb62fa1d73fb2e312ffb718150c0e5f5274fcf760b0c7970620/stactools-datacube-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-05 14:28:08",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "stactools-packages",
"github_project": "datacube",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "stactools-datacube"
}
JSON
