Metadata-Version: 2.4
Name: dgg_vibes
Version: 0.0.1
Summary: DGGAL High Vibes (vibe-coded high level DGGS tools using DGGAL)
Home-page: https://dggal.org
Author: Jérôme Jacovella-St-Louis, Ecere Corporation
Author-email: jerome@ecere.com
License: BSD-3-Clause
Keywords: dggs hexagonal-grid global-grid ogc ogc-api gnosis dggrs isea ivea rtea isea3h isea9r ivea3h ivea9r slice-and-dice polyhedral-globe icosahedral rhealpix
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: GIS
Classifier: Topic :: Scientific/Engineering :: Astronomy
Classifier: Topic :: Scientific/Engineering :: Atmospheric Science
Classifier: Topic :: Scientific/Engineering :: Hydrology
Classifier: Topic :: Scientific/Engineering :: Image Processing
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Classifier: Topic :: Scientific/Engineering :: Oceanography
Classifier: Topic :: Scientific/Engineering :: Visualization
Description-Content-Type: text/markdown
Requires-Dist: dggal>=0.0.7
Requires-Dist: shapely
Requires-Dist: numpy
Requires-Dist: rasterio
Requires-Dist: pyproj
Requires-Dist: py-ubjson
Requires-Dist: flask
Requires-Dist: requests
Requires-Dist: geopandas
Requires-Dist: pyarrow
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: requires-dist
Dynamic: summary

# DGGAL High Vibes

## A set of high-level vibe-coded tools demonstrating DGGAL usage in Python

### Example usage

#### dgg-import

Create a Scalable UBJSON DGGS Data Store from a raster (e.g., GeoTIFF) or GeoJSON (quantizing to a DGGRS)

```
dgg-import gebco.tiff --dggrs IVEA4R --fields Elevation
dgg-import countries.geojson --dggrs IVEA3H --level 19 --depth 14
```

#### dgg-fetch

Create a Scalable UBJSON DGGS Data Store from an OGC API - DGGS deployment (implementing an OGC API - DGGS client):

```
dgg-fetch http://localhost:8080/collections/gebco/dggs/IVEA4R
```

#### dgg-export

Export a GeoTIFF or GeoJSON from a Scalable UBJSON DGGS Data Store:

```
dgg-export data out.tif --collection gebco --level 10
dgg-export data out.geojson --collection countries --level 19
```

#### dgg-serve

Deploy an OGC API - DGGS interface to DGGS-quantized collections in Scalable UBJSON DGGS Data Stores through OGC API - DGGS with DGGAL High Vibes (implementation of an OGC API - DGGS server):

```
dgg-serve --data-root data --port 8080
```

### Limitations

This code should all work with the latest [0.0.7 DGGAL release](https://github.com/ecere/dggal/releases/tag/v0.0.7).

This is an early version with some limitations:
- the tools do not currently support additional dimensions (time, pressure...) but this is conceptually supported by DGGS-UBJSON and this DGGS Data Store layout,
- Vector stores are currently limited to icosahedral equal-area projections (IVEA, ISEA, RTEA) DGGRSs and have only been tested with IVEA3H and polygons so far,
- a future version will likely introduce a DGGS-JSON (field value) quantization extension significantly reducing data size.
