Skip to content

PermafrostDiscoveryGateway/viz-raster

Repository files navigation

Viz-raster: raster data processing for geospatial visualization

Converts pre-tiled vector output from from the PDG viz-staging step into a series of GeoTIFFs and web-ready image tiles at a range of zoom levels. View the content under example to see the type of output produced. Most parts of the process are configurable, including the methods used to summarize vector data into rasters, the color palette, and the size of the tiles. See the documentation in ConfigManager.py for more details.

PDG raster summary

Citation

Cite this software as:

Robyn Thiessen-Bock, Juliet Cohen, Matt Jones, Lauren Walker. 2023. Viz-raster: raster data processing for geospatial visualization (version 0.9.2). Arctic Data Center. doi: 10.18739/A2M03XZ9Z

Install

Requires Python version 3.9 or 3.10 and libspatialindex or libspatialindex-dev

  1. Follow the instructions to install libspatialindex or libspatialindex-dev
  2. Make sure that Python version 3.9 or 3.10 is installed (try which python3.9).
  3. Install pdgraster from GitHub repo using pip: pip install git+https://github.com/PermafrostDiscoveryGateway/viz-raster.git

Usage

  1. Create a config JSON file for the raster job, see PDG-Staging docs for details, help(pdgstaging.ConfigManager) for all configuration options, and pdgstaging.ConfigManager.defaults for default config values.

From the command line:

  • run: python -m pdgraster -c '/path/to/config.json'

In python: See example/main.py for a complete example.

License

Copyright [2013] [Regents of the University of California]

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.