Skip to main content

Inspect CloudOptimized Geotiff using Mapbox GL JS

Project description

https://circleci.com/gh/mapbox/rio-glui.svg?style=svg https://codecov.io/gh/mapbox/rio-glui/branch/master/graph/badge.svg

Explore CloudOptimized geotiff on your browser using Mapbox GL JS.

http://i.giphy.com/3ohzdVQrl8uUc8I2dO.gif

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

rio-glui-1.0.2.tar.gz (47.3 kB view details)

Uploaded Source

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

Hashes for rio-glui-1.0.2.tar.gz
Algorithm Hash digest
SHA256 ebeb197ed1c1165fdc3eb2a63763dd83e29412474ca6dfd682feb8bea9599359
MD5 d1302e3ce8cd1d62eb4eb0b60f6cdf12
BLAKE2b-256 655efc4cc3101713b5ba3cfec785bec267572558cca470e0c075e72cf1a30e1e

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page