# stactools-canelevation
[](https://pypi.org/project/stactools-canelevation/)
- Name: canelevation
- Package: `stactools.canelevation`
- [stactools-canelevation on PyPI](https://pypi.org/project/stactools-canelevation/)
- Owner: @jbants
- [Dataset homepage](https://open.canada.ca/data/en/dataset/7069387e-9986-4297-9f55-0288e9676947)
- STAC extensions used:
- [proj](https://github.com/stac-extensions/projection/)
- [pointcloud](https://github.com/stac-extensions/pointcloud/)
- [Browse the example in human-readable form](https://radiantearth.github.io/stac-browser/#/external/raw.githubusercontent.com/stactools-packages/canelevation/main/examples/collection.json)
A stactools package for working with Cloud Optimized Point Clouds (copc) data from the CanElevation
data series from NRCan.
## STAC Examples
- [Collection](examples/collection.json)
- [Item](examples/AB_FortMcMurray2018_20180518_NAD83CSRS_UTMZ12_1km_E4760_N62940_CQL1_CLASS.copc/AB_FortMcMurray2018_20180518_NAD83CSRS_UTMZ12_1km_E4760_N62940_CQL1_CLASS.copc.json)
## Installation
```shell
pip install stactools-canelevation
```
## Command-line Usage
Base use is below:
```shell
stac canelevation create-collection -d <destination>
stac canelevation create-item <source> <destination>
stac canelevation create-item https://ftp-maps-canada-ca.s3.amazonaws.com/pub/elevation/pointclouds_nuagespoints/NRCAN/Fort_McMurray_2018/AB_FortMcMurray2018_20180518_NAD83CSRS_UTMZ12_1km_E4760_N62940_CQL1_CLASS.copc.laz examples/
```
PDAL can read just the header of a COPC file using the `quicklook` function.
The `-q` or `--quick` flags allow PDAL to quickly gather some metadata without opening the file.
**This does not fill the [`schemas` property of the pointcloud stac extension](https://github.com/stac-extensions/pointcloud#schema-object)**.
Use `stac canelevation --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/canelevation",
"name": "stactools-canelevation",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "stactools,pystac,catalog,STAC,LiDAR",
"author": "stac-utils",
"author_email": "stac@radiant.earth",
"download_url": "https://files.pythonhosted.org/packages/de/94/6b399010ec4472b45aa0236e5954a0bb74ddfd38036983f2ad6e5c5a6d61/stactools-canelevation-0.2.0.tar.gz",
"platform": null,
"description": "# stactools-canelevation\n\n[](https://pypi.org/project/stactools-canelevation/)\n\n- Name: canelevation\n- Package: `stactools.canelevation`\n- [stactools-canelevation on PyPI](https://pypi.org/project/stactools-canelevation/)\n- Owner: @jbants\n- [Dataset homepage](https://open.canada.ca/data/en/dataset/7069387e-9986-4297-9f55-0288e9676947)\n- STAC extensions used:\n - [proj](https://github.com/stac-extensions/projection/)\n - [pointcloud](https://github.com/stac-extensions/pointcloud/) \n- [Browse the example in human-readable form](https://radiantearth.github.io/stac-browser/#/external/raw.githubusercontent.com/stactools-packages/canelevation/main/examples/collection.json)\n\nA stactools package for working with Cloud Optimized Point Clouds (copc) data from the CanElevation\ndata series from NRCan.\n\n## STAC Examples\n\n- [Collection](examples/collection.json)\n- [Item](examples/AB_FortMcMurray2018_20180518_NAD83CSRS_UTMZ12_1km_E4760_N62940_CQL1_CLASS.copc/AB_FortMcMurray2018_20180518_NAD83CSRS_UTMZ12_1km_E4760_N62940_CQL1_CLASS.copc.json)\n\n## Installation\n\n```shell\npip install stactools-canelevation\n```\n\n## Command-line Usage\n\nBase use is below:\n\n```shell\nstac canelevation create-collection -d <destination>\nstac canelevation create-item <source> <destination>\n\nstac canelevation create-item https://ftp-maps-canada-ca.s3.amazonaws.com/pub/elevation/pointclouds_nuagespoints/NRCAN/Fort_McMurray_2018/AB_FortMcMurray2018_20180518_NAD83CSRS_UTMZ12_1km_E4760_N62940_CQL1_CLASS.copc.laz examples/\n```\n\nPDAL can read just the header of a COPC file using the `quicklook` function.\nThe `-q` or `--quick` flags allow PDAL to quickly gather some metadata without opening the file.\n\n**This does not fill the [`schemas` property of the pointcloud stac extension](https://github.com/stac-extensions/pointcloud#schema-object)**.\n\nUse `stac canelevation --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": "PROVIDE DESCRIPTION HERE",
"version": "0.2.0",
"project_urls": {
"Homepage": "https://github.com/stactools-packages/canelevation",
"Issues": "https://github.com/stactools-packages/canelevation/issues"
},
"split_keywords": [
"stactools",
"pystac",
"catalog",
"stac",
"lidar"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "463354ad664888dc3f8c3afb1c37b2a623594f3a2d533249900371f305608c49",
"md5": "f652663dd506f2b71081b289bb12b907",
"sha256": "0ab9cbf1b0478de02b8234dd035430323a02b41767544584357a7e537ad617ef"
},
"downloads": -1,
"filename": "stactools_canelevation-0.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f652663dd506f2b71081b289bb12b907",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 9299,
"upload_time": "2023-08-18T17:39:02",
"upload_time_iso_8601": "2023-08-18T17:39:02.652672Z",
"url": "https://files.pythonhosted.org/packages/46/33/54ad664888dc3f8c3afb1c37b2a623594f3a2d533249900371f305608c49/stactools_canelevation-0.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "de946b399010ec4472b45aa0236e5954a0bb74ddfd38036983f2ad6e5c5a6d61",
"md5": "4c933623b907d34aefe8244f91701efb",
"sha256": "5827bf5a29fef85dff965b3f3c6176ad01e4c304242aac0fe75eb47c5d7abae2"
},
"downloads": -1,
"filename": "stactools-canelevation-0.2.0.tar.gz",
"has_sig": false,
"md5_digest": "4c933623b907d34aefe8244f91701efb",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 9909,
"upload_time": "2023-08-18T17:39:04",
"upload_time_iso_8601": "2023-08-18T17:39:04.375973Z",
"url": "https://files.pythonhosted.org/packages/de/94/6b399010ec4472b45aa0236e5954a0bb74ddfd38036983f2ad6e5c5a6d61/stactools-canelevation-0.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-08-18 17:39:04",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "stactools-packages",
"github_project": "canelevation",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "stactools-canelevation"
}
JSON
