{ "info": { "author": "David Shean", "author_email": "dshean@gmail.com", "bugtrack_url": null, "classifiers": [], "description": "# imview\nImage viewers for geospatial data\n\n## Overview\n\nThis 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.\n\n## Viewers\n- imviewer - viewer for geospatial data, overlay capabilities\n- stack_view - viewer for \"stack.npz\" time series output (see [pygeotools](https://github.com/dshean/pygeotools.git)), allowing for point sampling and plotting\n- iv - lightweight viewer for standard images (jpg, png, etc.)\n- review_img - lightweight viewer to identify good and bad images\n\n## Modules\n- lib/pltlib - a collection of useful functions for matplotlib plotting, including drawing vector data over raster data\n\n## Command-line Examples\n\n#### Preprocessing (optional):\n```\nmos_fn=BigDEM.tif\ngdaldem hillshade $mos_fn ${mos_fn}_hs_az315.tif\ngdaladdo -ro -r average --config COMPRESS_OVERVIEW LZW --config BIGTIFF_OVERVIEW YES $mos_fn 2 4 8 16 32 64\ngdaladdo -ro -r average --config COMPRESS_OVERVIEW LZW --config BIGTIFF_OVERVIEW YES ${mos_fn}_hs_az315.tif 2 4 8 16 32 64\n```\n\n#### View color DEM overlaid on shaded relief map:\n\n`imviewer.py $mos_fn -overlay ${mos_fn}_hs_az315.tif -label 'Elevation (m WGS84)'`\n\n* By default, this will quickly load a low-resolution preview (specify -full to load full-res image)\n* Lower right corner shows coordinates and value under cursor\n* Left-click to sample image coordinates, map coordinates and raster value\n* Can specify transparency with `-alpha 0.5`\n\n#### View with user-defined color map and limits\n\n`imviewer.py -cmap 'RdYlBl' -clim -5 5 dem_dz_eul.tif -label 'Elevation difference (m)'`\n\n#### Link several images (allows for simultaneous zoom and pan):\n\n`imviewer.py -link dem.tif image.tif velocity.tif`\n\n#### View polyline shapefile overlay:\n\n`imviewer.py $mos_fn -overlay ${mos_fn}_hs_az315.tif -shp polyline.shp` \n\n#### Output high-quality figure with scalebar:\n\n`imviewer.py $mos_fn -overlay ${mos_fn}_hs_az315.tif -scale x -label 'Elevation (m WGS84)' -of png -dpi 300` \n\n#### View time series stack:\n```\nmake_stack.py -tr 'mean' -te 'intersection' 20080101_dem.tif 20090101_dem.tif 20100101_dem.tif\nstack_view.py 20080101_dem_20100101_dem_stack_3.npz\n```\n* Left-click to extract time series at point on any of the context maps\n* Right-click to clear all points\n* Can zoom and pan on context maps\n\n## Installation\n\nInstall the latest release from PyPI:\n\n pip install imview \n\n**Note**: by default, this will deploy executable scripts in /usr/local/bin\n\n### Building from source\n\nClone the repository and install:\n\n git clone https://github.com/dshean/imview.git\n pip install -e imview\n\nThe -e flag (\"editable mode\", setuptools \"develop mode\") will allow you to modify source code and immediately see changes.\n\n### Core requirements \n- [Matplotlib](http://matplotlib.org/)\n- [GDAL/OGR](http://www.gdal.org/)\n- [NumPy](http://www.numpy.org/)\n- [pygeotools](https://github.com/dshean/pygeotools)\n\n## License\n\nThis project is licensed under the terms of the MIT License.\n\n", "description_content_type": null, "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/dshean/imview", "keywords": "", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "imview", "package_url": "https://pypi.org/project/imview/", "platform": "", "project_url": "https://pypi.org/project/imview/", "project_urls": { "Homepage": "https://github.com/dshean/imview" }, "release_url": "https://pypi.org/project/imview/0.3.0/", "requires_dist": null, "requires_python": "", "summary": "Image viewers for geospatial data", "version": "0.3.0" }, "last_serial": 3164448, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "5d6c1003ebcf5f1c5a86153db5c4f6cd", "sha256": "6309b4646bf4087ea05ff7f36ea029abbcd932616d332416d3ad939ed21f293e" }, "downloads": -1, "filename": "imview-0.1.0.tar.gz", "has_sig": false, "md5_digest": "5d6c1003ebcf5f1c5a86153db5c4f6cd", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 37814, "upload_time": "2016-11-08T04:49:33", "url": "https://files.pythonhosted.org/packages/07/32/001cdcec9d84240702e38e26adf64f67dac0e6ec6749b1163f500e4bfdfc/imview-0.1.0.tar.gz" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "983a99d3ad14e6adac7f460dc7c4edc0", "sha256": "427495d1e20845aa0afc2f581585654463130a30031b9f78c583a69140ee4364" }, "downloads": -1, "filename": "imview-0.1.1.tar.gz", "has_sig": false, "md5_digest": "983a99d3ad14e6adac7f460dc7c4edc0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 37869, "upload_time": "2016-11-14T22:07:41", "url": "https://files.pythonhosted.org/packages/12/71/449e7c5d02bf03c700aeafe1ad62448215a4bf8568d8d70da860945cc6ba/imview-0.1.1.tar.gz" } ], "0.2.0": [ { "comment_text": "", "digests": { "md5": "ce7a96c874d32fb48a6593b570e9a7b5", "sha256": "4e4668c285cc38b7519fdf5502a477aa2cd996943d6cdb9b1e51985ec44d38f2" }, "downloads": -1, "filename": "imview-0.2.0.tar.gz", "has_sig": false, "md5_digest": "ce7a96c874d32fb48a6593b570e9a7b5", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 38706, "upload_time": "2017-01-10T22:00:53", "url": "https://files.pythonhosted.org/packages/bc/51/50193c3ce196c341c8c5705a1b3018e74eaaf294424e19774bc8934ef3c6/imview-0.2.0.tar.gz" } ], "0.3.0": [ { "comment_text": "", "digests": { "md5": "7a2bde16bd679b74c5b0971603c7ac99", "sha256": "9773089753b5a10e3f7f45d451407f18980ea386c3c594c7692a20a7684ba7b1" }, "downloads": -1, "filename": "imview-0.3.0.tar.gz", "has_sig": false, "md5_digest": "7a2bde16bd679b74c5b0971603c7ac99", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 42521, "upload_time": "2017-09-11T06:05:55", "url": "https://files.pythonhosted.org/packages/f4/02/77db17b807cc0b34fa0846d4850f526421c1ab6f0aa4fb636f7d19b4f07c/imview-0.3.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "7a2bde16bd679b74c5b0971603c7ac99", "sha256": "9773089753b5a10e3f7f45d451407f18980ea386c3c594c7692a20a7684ba7b1" }, "downloads": -1, "filename": "imview-0.3.0.tar.gz", "has_sig": false, "md5_digest": "7a2bde16bd679b74c5b0971603c7ac99", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 42521, "upload_time": "2017-09-11T06:05:55", "url": "https://files.pythonhosted.org/packages/f4/02/77db17b807cc0b34fa0846d4850f526421c1ab6f0aa4fb636f7d19b4f07c/imview-0.3.0.tar.gz" } ] }