# stactools-glad-glclu2020
[![PyPI](https://img.shields.io/pypi/v/stactools-glad-glclu2020?style=for-the-badge)](https://pypi.org/project/stactools-glad-glclu2020/)
![GitHub Workflow Status (with event)](https://img.shields.io/github/actions/workflow/status/stactools-packages/glad-glclu2020/continuous-integration.yml?style=for-the-badge)
- Name: glad-glclu2020
- Package: `stactools.glad_glclu2020`
- [stactools-glad-glclu2020 on PyPI](https://pypi.org/project/stactools-glad-glclu2020/)
- Owner: @hrodmn
- [Dataset homepage](https://storage.googleapis.com/earthenginepartners-hansen/GLCLU2000-2020/v2/download.html)
- STAC extensions used:
- [proj](https://github.com/stac-extensions/projection/)
- [item-assets](https://github.com/stac-extensions/item-assets/)
- [scientific](https://github.com/stac-extensions/scientific/)
- [version](https://github.com/stac-extensions/version/)
- [classification](https://github.com/stac-extensions/classification/)
- [render](https://github.com/stac-extensions/render/)
- Browse the example in human-readable form
- [`glad-glclu2020-v2`](https://radiantearth.github.io/stac-browser/#/external/raw.githubusercontent.com/stactools-packages/glad-glclu2020/main/examples/glad-glclu2020-v2/collection.json)
- [`glad-glclu2020-change-v2`](https://radiantearth.github.io/stac-browser/#/external/raw.githubusercontent.com/stactools-packages/glad-glclu2020/main/examples/glad-glclu2020-change-v2/collection.json)
- [Browse a notebook demonstrating the example item and collection](https://github.com/stactools-packages/glad-glclu2020/tree/main/docs/example.ipynb)
A short description of the package and its usage.
## STAC examples
- [Collection](https://github.com/stactools-packages/glad-glclu2020/blob/main/examples/glad-glclu2020-v2/collection.json)
- [Item](https://github.com/stactools-packages/glad-glclu2020/blob/main/examples/glad-glclu2020-v2/2000_40N_080W/2000_40N_080W.json)
## Installation
```shell
pip install stactools-glad-glclu2020
```
## Command-line usage
By default, `stactools-glad-glclu2020` will assume that you are generating STAC metadata for the original files which are stored in a Google storage container and publicly available over HTTP.
```bash
stac gladlclu2020 create-collection \
--sample-asset-href https://storage.googleapis.com/earthenginepartners-hansen/GLCLU2000-2020/v2/2000/50N_090W.tif \
{destination}
stac gladlclu2020 create-item \
https://storage.googleapis.com/earthenginepartners-hansen/GLCLU2000-2020/v2/2000/50N_090W.tif \
{destination}
```
> [!WARNING]
> These files are not cloud-optimized geotiffs (COGs)!
> Be aware that this has major performance implications for applications that consume the data from these assets.
If you have created your own copy of the data in a different storage container, you can provide a custom URL format for the assets with the `--href-format` parameter in the `create-item` command:
```bash
stac gladlclu2020 create-collection \
--sample-asset-href {sample_tif_url} \
{destination}
stac gladlclu2020 create-item \
--href-format s3://bucket/glad/GLCLU2000-2020/{version}/{year}/{loc}.tif \
{cog_href} \
{destination}
```
Use `stac glad-glclu2020 --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
uv venv && uv sync --extra dev
uv run pre-commit install
```
To check all files:
```shell
uv run pre-commit run --all-files
```
To run the tests:
```shell
uv run pytest -vv
```
If you've updated the STAC metadata output, update the examples:
```shell
uv run scripts/update-examples
```
Raw data
{
"_id": null,
"home_page": null,
"name": "stactools-glad-glclu2020",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": "Henry Rodman <henry@developmentseed.org>",
"keywords": "stactools, pystac, catalog, STAC",
"author": null,
"author_email": "Henry Rodman <henry@developmentseed.org>",
"download_url": "https://files.pythonhosted.org/packages/99/f1/7ba9302c4b389424acdb48be70d0e53923c7dbf0a58657bc8985e6938ae2/stactools_glad_glclu2020-0.1.1.tar.gz",
"platform": null,
"description": "# stactools-glad-glclu2020\n\n[![PyPI](https://img.shields.io/pypi/v/stactools-glad-glclu2020?style=for-the-badge)](https://pypi.org/project/stactools-glad-glclu2020/)\n![GitHub Workflow Status (with event)](https://img.shields.io/github/actions/workflow/status/stactools-packages/glad-glclu2020/continuous-integration.yml?style=for-the-badge)\n\n- Name: glad-glclu2020\n- Package: `stactools.glad_glclu2020`\n- [stactools-glad-glclu2020 on PyPI](https://pypi.org/project/stactools-glad-glclu2020/)\n- Owner: @hrodmn\n- [Dataset homepage](https://storage.googleapis.com/earthenginepartners-hansen/GLCLU2000-2020/v2/download.html)\n- STAC extensions used:\n - [proj](https://github.com/stac-extensions/projection/)\n - [item-assets](https://github.com/stac-extensions/item-assets/)\n - [scientific](https://github.com/stac-extensions/scientific/)\n - [version](https://github.com/stac-extensions/version/)\n - [classification](https://github.com/stac-extensions/classification/)\n - [render](https://github.com/stac-extensions/render/)\n- Browse the example in human-readable form\n - [`glad-glclu2020-v2`](https://radiantearth.github.io/stac-browser/#/external/raw.githubusercontent.com/stactools-packages/glad-glclu2020/main/examples/glad-glclu2020-v2/collection.json)\n - [`glad-glclu2020-change-v2`](https://radiantearth.github.io/stac-browser/#/external/raw.githubusercontent.com/stactools-packages/glad-glclu2020/main/examples/glad-glclu2020-change-v2/collection.json)\n- [Browse a notebook demonstrating the example item and collection](https://github.com/stactools-packages/glad-glclu2020/tree/main/docs/example.ipynb)\n\nA short description of the package and its usage.\n\n## STAC examples\n\n- [Collection](https://github.com/stactools-packages/glad-glclu2020/blob/main/examples/glad-glclu2020-v2/collection.json)\n- [Item](https://github.com/stactools-packages/glad-glclu2020/blob/main/examples/glad-glclu2020-v2/2000_40N_080W/2000_40N_080W.json)\n\n## Installation\n\n```shell\npip install stactools-glad-glclu2020\n```\n\n## Command-line usage\n\nBy default, `stactools-glad-glclu2020` will assume that you are generating STAC metadata for the original files which are stored in a Google storage container and publicly available over HTTP.\n\n```bash\nstac gladlclu2020 create-collection \\\n --sample-asset-href https://storage.googleapis.com/earthenginepartners-hansen/GLCLU2000-2020/v2/2000/50N_090W.tif \\\n {destination}\n\nstac gladlclu2020 create-item \\\n https://storage.googleapis.com/earthenginepartners-hansen/GLCLU2000-2020/v2/2000/50N_090W.tif \\\n {destination}\n```\n\n> [!WARNING] \n> These files are not cloud-optimized geotiffs (COGs)!\n> Be aware that this has major performance implications for applications that consume the data from these assets.\n\nIf you have created your own copy of the data in a different storage container, you can provide a custom URL format for the assets with the `--href-format` parameter in the `create-item` command:\n\n```bash\n\nstac gladlclu2020 create-collection \\\n --sample-asset-href {sample_tif_url} \\\n {destination}\n\nstac gladlclu2020 create-item \\\n --href-format s3://bucket/glad/GLCLU2000-2020/{version}/{year}/{loc}.tif \\\n {cog_href} \\\n {destination}\n```\n\nUse `stac glad-glclu2020 --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\nuv venv && uv sync --extra dev\nuv run pre-commit install\n```\n\nTo check all files:\n\n```shell\nuv run pre-commit run --all-files\n```\n\nTo run the tests:\n\n```shell\nuv run pytest -vv\n```\n\nIf you've updated the STAC metadata output, update the examples:\n\n```shell\nuv run scripts/update-examples\n```\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "GLAD Land Use Land Cover 2020 stactools packages",
"version": "0.1.1",
"project_urls": {
"Github": "https://github.com/stactools-packages/glad-glclu2020",
"Issues": "https://github.com/stactools-packages/glad-glclu2020/issues"
},
"split_keywords": [
"stactools",
" pystac",
" catalog",
" stac"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "728f1af7d1aebe8ce3dd86c277f80c64379aba1199b3705f9fec8773fa505f88",
"md5": "675637a0b0093336300419ff6f879899",
"sha256": "86d543dd69f0f711ce7061ed7874b1062f9e65bd537a896f0e059b751b64fc7c"
},
"downloads": -1,
"filename": "stactools_glad_glclu2020-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "675637a0b0093336300419ff6f879899",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 16158,
"upload_time": "2024-11-20T02:14:32",
"upload_time_iso_8601": "2024-11-20T02:14:32.717417Z",
"url": "https://files.pythonhosted.org/packages/72/8f/1af7d1aebe8ce3dd86c277f80c64379aba1199b3705f9fec8773fa505f88/stactools_glad_glclu2020-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "99f17ba9302c4b389424acdb48be70d0e53923c7dbf0a58657bc8985e6938ae2",
"md5": "ddf124669610816c8872c41a6d42ab20",
"sha256": "0910615a7f2bc33efc4b7c5d86ef81a029e81c3c8dce0ec312eb37049c0290d5"
},
"downloads": -1,
"filename": "stactools_glad_glclu2020-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "ddf124669610816c8872c41a6d42ab20",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 17731,
"upload_time": "2024-11-20T02:14:34",
"upload_time_iso_8601": "2024-11-20T02:14:34.313134Z",
"url": "https://files.pythonhosted.org/packages/99/f1/7ba9302c4b389424acdb48be70d0e53923c7dbf0a58657bc8985e6938ae2/stactools_glad_glclu2020-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-20 02:14:34",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "stactools-packages",
"github_project": "glad-glclu2020",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "stactools-glad-glclu2020"
}