Skip to main content

Image viewers for geospatial data

Project description

imview

Image viewers for geospatial data

Overview

This repo contains several utilities that I use on a daily basis for rapid data preview, detailed analysis, and figure generation. The imviewer.py tool is probably the most useful. It works well, but could use a rewrite, as it has been glommed together over the span of 4-5 years.

Viewers

  • imviewer - viewer for geospatial data, overlay capabilities
  • stack_view - viewer for "stack.npz" time series output (see pygeotools), allowing for point sampling and plotting
  • iv - lightweight viewer for standard images (jpg, png, etc.)
  • review_img - lightweight viewer to identify good and bad images

Modules

  • lib/pltlib - a collection of useful functions for matplotlib plotting, including drawing vector data over raster data

Command-line Examples

Preprocessing (optional):

mos_fn=BigDEM.tif
gdaldem hillshade $mos_fn ${mos_fn}_hs_az315.tif
gdaladdo -ro -r average --config COMPRESS_OVERVIEW LZW --config BIGTIFF_OVERVIEW YES $mos_fn 2 4 8 16 32 64
gdaladdo -ro -r average --config COMPRESS_OVERVIEW LZW --config BIGTIFF_OVERVIEW YES ${mos_fn}_hs_az315.tif 2 4 8 16 32 64

View color DEM overlaid on shaded relief map:

imviewer.py $mos_fn -overlay ${mos_fn}_hs_az315.tif -label 'Elevation (m WGS84)'

  • By default, this will quickly load a low-resolution preview (specify -full to load full-res image)
  • Lower right corner shows coordinates and value under cursor
  • Left-click to sample image coordinates, map coordinates and raster value
  • Can specify transparency with -alpha 0.5

View with user-defined color map and limits

imviewer.py -cmap 'RdYlBl' -clim -5 5 dem_dz_eul.tif -label 'Elevation difference (m)'

Link several images (allows for simultaneous zoom and pan):

imviewer.py -link dem.tif image.tif velocity.tif

View polyline shapefile overlay:

imviewer.py $mos_fn -overlay ${mos_fn}_hs_az315.tif -shp polyline.shp

Output high-quality figure with scalebar:

imviewer.py $mos_fn -overlay ${mos_fn}_hs_az315.tif -scale x -label 'Elevation (m WGS84)' -of png -dpi 300

View time series stack:

make_stack.py -tr 'mean' -te 'intersection' 20080101_dem.tif 20090101_dem.tif 20100101_dem.tif
stack_view.py 20080101_dem_20100101_dem_stack_3.npz
  • Left-click to extract time series at point on any of the context maps
  • Right-click to clear all points
  • Can zoom and pan on context maps

Installation

Install the latest release from PyPI:

pip install imview 

Note: by default, this will deploy executable scripts in /usr/local/bin

Building from source

Clone the repository and install:

git clone https://github.com/dshean/imview.git
pip install -e imview

The -e flag ("editable mode", setuptools "develop mode") will allow you to modify source code and immediately see changes.

Core requirements

License

This project is licensed under the terms of the MIT License.

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

imview-0.4.0.tar.gz (35.6 kB view details)

Uploaded Source

File details

Details for the file imview-0.4.0.tar.gz.

File metadata

  • Download URL: imview-0.4.0.tar.gz
  • Upload date:
  • Size: 35.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.12

File hashes

Hashes for imview-0.4.0.tar.gz
Algorithm Hash digest
SHA256 724bd0fb42ae6685f419900f2ac36b7a9c478fab3b1a9ab198ba8a4fa47f86e6
MD5 e31f9cbf1bb2d94e0488c73320b40cd0
BLAKE2b-256 232a4ed0c98a22df698d449a5ec6f0bd35162bfbe6bd935210238f4575000696

See more details on using hashes here.

Supported by

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