stactools-geoparquet-items


Namestactools-geoparquet-items JSON
Version 0.4.0 PyPI version JSON
download
home_pagehttps://github.com/stactools-packages/geoparquet-items
SummaryUses stac-geoparquet to generate a geoparquet for a list of STAC items
upload_time2023-07-25 21:57:15
maintainer
docs_urlNone
authorMatthias Mohr
requires_python
license
keywords stactools pystac catalog stac
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls. 
            # stactools-geoparquet-items

[![PyPI](https://img.shields.io/pypi/v/stactools-geoparquet-items)](https://pypi.org/project/stactools-geoparquet-items/)

- Name: geoparquet-items
- Package: `stactools.geoparquet_items`
- [stactools-geoparquet-items on PyPI](https://pypi.org/project/stactools-geoparquet-items/)
- Owner: @m-mohr

Uses stac-geoparquet to generate a geoparquet for a list of STAC items.

## Installation

```shell
pip install stactools-geoparquet-items
```

## Command-line Usage

Use `stac geoparquet-items --help` to see all subcommands and options.

### Create GeoParquet from STAC Items

You need to provide a folder to read the items (deeply) from.
Then you provide a file to write the geoparquet to.
Optionally, you can add the geoparquet as an asset to a STAC Collection.

```shell
stac geoparquet-items create https://example.com/collections/id/items result.geoparquet
```

```shell
stac geoparquet-items create /path/to/folder result.geoparquet --collection /path/to/collection.json
```

### Convert from GeoParquet to other file formats

Convert from geoparquet to GeoPackage (without stac_version, type and assets):

```shell
stac geoparquet-items convert source.geoparquet result.gpkg
```

Convert to FlatGeoBuf and exclude even more fields:

```shell
stac geoparquet-items convert source.geoparquet result.fgb --format flatgeobuf --exclude stac_version,type,assets,links,collection
```

Supported formats: flatgeobuf, geojson, geojsonseq, gpkg (default), shapefile

### Show information about a geoparquet file

You can easily retrieve metadata and a data excerpt:

```shell
stac geoparquet-items info source.geoparquet
```

## 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
```

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/stactools-packages/geoparquet-items",
    "name": "stactools-geoparquet-items",
    "maintainer": "",
    "docs_url": null,
    "requires_python": "",
    "maintainer_email": "",
    "keywords": "stactools,pystac,catalog,STAC",
    "author": "Matthias Mohr",
    "author_email": "matthias@mohr.ws",
    "download_url": "https://files.pythonhosted.org/packages/b6/a8/ee321f0f2ec6eba13af3c099a82cfde2bf5319d62dac18372de55f9f1958/stactools-geoparquet-items-0.4.0.tar.gz",
    "platform": null,
    "description": "# stactools-geoparquet-items\n\n[![PyPI](https://img.shields.io/pypi/v/stactools-geoparquet-items)](https://pypi.org/project/stactools-geoparquet-items/)\n\n- Name: geoparquet-items\n- Package: `stactools.geoparquet_items`\n- [stactools-geoparquet-items on PyPI](https://pypi.org/project/stactools-geoparquet-items/)\n- Owner: @m-mohr\n\nUses stac-geoparquet to generate a geoparquet for a list of STAC items.\n\n## Installation\n\n```shell\npip install stactools-geoparquet-items\n```\n\n## Command-line Usage\n\nUse `stac geoparquet-items --help` to see all subcommands and options.\n\n### Create GeoParquet from STAC Items\n\nYou need to provide a folder to read the items (deeply) from.\nThen you provide a file to write the geoparquet to.\nOptionally, you can add the geoparquet as an asset to a STAC Collection.\n\n```shell\nstac geoparquet-items create https://example.com/collections/id/items result.geoparquet\n```\n\n```shell\nstac geoparquet-items create /path/to/folder result.geoparquet --collection /path/to/collection.json\n```\n\n### Convert from GeoParquet to other file formats\n\nConvert from geoparquet to GeoPackage (without stac_version, type and assets):\n\n```shell\nstac geoparquet-items convert source.geoparquet result.gpkg\n```\n\nConvert to FlatGeoBuf and exclude even more fields:\n\n```shell\nstac geoparquet-items convert source.geoparquet result.fgb --format flatgeobuf --exclude stac_version,type,assets,links,collection\n```\n\nSupported formats: flatgeobuf, geojson, geojsonseq, gpkg (default), shapefile\n\n### Show information about a geoparquet file\n\nYou can easily retrieve metadata and a data excerpt:\n\n```shell\nstac geoparquet-items info source.geoparquet\n```\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",
    "bugtrack_url": null,
    "license": "",
    "summary": "Uses stac-geoparquet to generate a geoparquet for a list of STAC items",
    "version": "0.4.0",
    "project_urls": {
        "Homepage": "https://github.com/stactools-packages/geoparquet-items",
        "Issues": "https://github.com/stactools-packages/geoparquet-items/issues"
    },
    "split_keywords": [
        "stactools",
        "pystac",
        "catalog",
        "stac"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "446b81701014f9431a46c94d6cdf21fdc7f73465fc3c2a8d0ef352925d2787ed",
                "md5": "1a81bc483f8ec5dbc8133e140c8f0030",
                "sha256": "16dca35a0e8445a1525d695bf1c35eb024296e06f5ca4cbfc834f2c633333928"
            },
            "downloads": -1,
            "filename": "stactools_geoparquet_items-0.4.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "1a81bc483f8ec5dbc8133e140c8f0030",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 6670,
            "upload_time": "2023-07-25T21:57:14",
            "upload_time_iso_8601": "2023-07-25T21:57:14.503191Z",
            "url": "https://files.pythonhosted.org/packages/44/6b/81701014f9431a46c94d6cdf21fdc7f73465fc3c2a8d0ef352925d2787ed/stactools_geoparquet_items-0.4.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "b6a8ee321f0f2ec6eba13af3c099a82cfde2bf5319d62dac18372de55f9f1958",
                "md5": "9683259af2d80627b609a35ce3b7ace1",
                "sha256": "324583f45f52d6190a4a63aaf8d90e30818413fb0cd273ce25dce494e3961070"
            },
            "downloads": -1,
            "filename": "stactools-geoparquet-items-0.4.0.tar.gz",
            "has_sig": false,
            "md5_digest": "9683259af2d80627b609a35ce3b7ace1",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 6269,
            "upload_time": "2023-07-25T21:57:15",
            "upload_time_iso_8601": "2023-07-25T21:57:15.711385Z",
            "url": "https://files.pythonhosted.org/packages/b6/a8/ee321f0f2ec6eba13af3c099a82cfde2bf5319d62dac18372de55f9f1958/stactools-geoparquet-items-0.4.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-07-25 21:57:15",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "stactools-packages",
    "github_project": "geoparquet-items",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "stactools-geoparquet-items"
}
Matthias Mohr
Elapsed time: 0.12791s