Inspect CloudOptimized Geotiff using Mapbox GL JS
Project description
Explore CloudOptimized geotiff on your browser using Mapbox GL JS.
Install
You can install rio-glui using pip
$ pip install -U pip
$ pip install rio-glui
or install from source:
$ git clone https://github.com/mapbox/rio-glui.git
$ cd rio-glui
$ pip install -e .
Usage
Usage: rio glui [OPTIONS] PATH
Rasterio glui cli.
Options:
-b, --bidx BIDX Raster band index (default: 1,2,3)
--tiles-format [png|jpg|webp] Tile image format (default: png)
--tiles-dimensions INTEGER Dimension of images being served (default:
512)
--nodata INTEGER Force mask creation from a given nodata value
--gl-tile-size INTEGER mapbox-gl tileSize (default: 512)
--port INTEGER Webserver port (default: 8080)
--playground Launch playground app
--mapbox-token TOKEN Pass Mapbox token
--help Show this message and exit.
Explore COG hosted on aws
$ rio glui https://oin-hotosm.s3.amazonaws.com/5ac626e091b5310010e0d482/0/5ac626e091b5310010e0d483.tif
Playground
The –playground option opens a playgroud template where you an interact with the data to apply rio-color formula.
Creating CloudOptimized Geotiff
To create rio-glui friendly files (CloudOptimized Geotiff) you can use another rasterio plugin: rio-cogeo (https://github.com/mapbox/rio-cogeo.git).
Extras
This plugin also enable raster visualisation in Jupyter Notebook using [mapboxgl-jupyter](https://github.com/mapbox/mapboxgl-jupyter)
Contribution & Devellopement
Issues and pull requests are more than welcome.
Dev install & Pull-Request
$ git clone https://github.com/mapbox/rio-glui.git
$ cd rio-cogeo
$ pip install -e .[dev]
Python3.6 only
This repo is set to use pre-commit to run flake8, pydocstring and black (“uncompromising Python code formatter”) when commiting new code.
$ pre-commit install
$ git add .
$ git commit -m'my change'
black....................................................................Passed
Flake8...................................................................Passed
Verifying PEP257 Compliance..............................................Passed
$ git push origin
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file rio-glui-1.0.2.tar.gz
.
File metadata
- Download URL: rio-glui-1.0.2.tar.gz
- Upload date:
- Size: 47.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | ebeb197ed1c1165fdc3eb2a63763dd83e29412474ca6dfd682feb8bea9599359 |
|
MD5 | d1302e3ce8cd1d62eb4eb0b60f6cdf12 |
|
BLAKE2b-256 | 655efc4cc3101713b5ba3cfec785bec267572558cca470e0c075e72cf1a30e1e |