{ "info": { "author": "David Shean", "author_email": "dshean@gmail.com", "bugtrack_url": null, "classifiers": [], "description": "# vmap \n\nVelocity map generation using the NASA Ames Stereo Pipeline (ASP) image correlator\n\n## Overview\n\nThe [ASP/VW](https://ti.arc.nasa.gov/tech/asr/intelligent-robotics/ngt/stereo/) correlator is fast, memory-efficient, multi-threaded, and _generalized_. This means it can be used for efficient feature tracking operations on two arbitrary input rasters acquired at different times. \n\n### Example\n\n![Rainier velocity map](docs/rainier_vmap.png)\n\n### Command-line examples (run with no arguments for usage)\n\nGenerate a velocity map from two orthorectified images (or any raster in projected coord sys, e.g. high-res DEM shaded relief maps with identical illumination):\n- `vmap.py img1_YYYYMMDD.tif img2_YYYYMMDD.tif` \n- Generates ASP disparity maps (`'-RD.tif'`, `'-F.tif'`, `'-F_smooth.tif'`)\n- By default, calls `disp2v.py` on `'-F.tif'` to generate output velocity products\n- Correlator options are currently hardcoded - can edit directly in main(), but eventually will be accepted as command-line arguments\n\nConvert output ASP disparity map to m/yr or m/day:\n- `disp2v.py img1_YYYYMMDD__img2_YYYYMMDD_vmap/img1_YYYYMMDD__img2_YYYYMMDD_vmap-F.tif`\n- Output: `'_vm.tif'` (velocity magnitude in m/yr or m/day), `'_vx.tif'` (horizontal velocity component), `'_vy.tif'` (vertical velocity component)\n\nPreview subsampled version of disparity map:\n- `disp_view.sh img1_YYYYMMDD__img2_YYYYMMDD_vmap/img1_YYYYMMDD__img2_YYYYMMDD_vmap-F.tif`\n- Creates `'-F_b1_5.tif'` and `'-F_b2_5.tif'` and opens linked view with [`imview.py`](https://github.com/dshean/imview)\n\nSorry about the long filenames. \n\n## Installation\n\nInstall the latest release from PyPI:\n\n pip install vmap \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/vmap.git\n pip install -e vmap/\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- [NASA Ames Stereo Pipeline (ASP)](https://ti.arc.nasa.gov/tech/asr/intelligent-robotics/ngt/stereo/)\n- [GDAL/OGR](http://www.gdal.org/)\n- [NumPy](http://www.numpy.org/)\n- [pygeotools](https://github.com/dshean/pygeotools)\n\n### Optional requirements (needed for some functionality) \n- [imview](https://github.com/dshean/imview)\n- [demcoreg](https://github.com/dshean/demcoreg) (offset correction over bare ground surfaces)\n- [matplotlib](http://matplotlib.org/)\n- [SciPy](https://www.scipy.org/)\n\n## License\n\nThis project is licensed under the terms of the MIT License.", "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/vmap", "keywords": "", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "vmap", "package_url": "https://pypi.org/project/vmap/", "platform": "", "project_url": "https://pypi.org/project/vmap/", "project_urls": { "Homepage": "https://github.com/dshean/vmap" }, "release_url": "https://pypi.org/project/vmap/0.2.0/", "requires_dist": null, "requires_python": "", "summary": "Velocity map generation using the Ames Stereo Pipeline image correlator", "version": "0.2.0" }, "last_serial": 2942642, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "997c5e01a1dece15bc13296ac0ecd8c8", "sha256": "daa19e628a12c640ddc7ed4319d93331f94e395b7a775b3c3d6c970d46222ec7" }, "downloads": -1, "filename": "vmap-0.1.0.tar.gz", "has_sig": false, "md5_digest": "997c5e01a1dece15bc13296ac0ecd8c8", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9388, "upload_time": "2016-11-12T22:59:00", "url": "https://files.pythonhosted.org/packages/fc/4b/9e799a78349fc8a50fc2f7bf8c2b77a57a3daf99534ae815092723354eb3/vmap-0.1.0.tar.gz" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "797de560dc288d044fb112ecc21bcd3c", "sha256": "11f922c1d0f46b344c77251148a3e004ea59bb25ed9bed10327dd93483dde49d" }, "downloads": -1, "filename": "vmap-0.1.1.tar.gz", "has_sig": false, "md5_digest": "797de560dc288d044fb112ecc21bcd3c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10698, "upload_time": "2016-11-14T05:19:35", "url": "https://files.pythonhosted.org/packages/09/30/129243d57b832a81b41f84b1ad95bbf4f5e79dea84ea7c0987ec1133d0f3/vmap-0.1.1.tar.gz" } ], "0.2.0": [ { "comment_text": "", "digests": { "md5": "5ce1f5cef275559d6eb019da1c386f8b", "sha256": "6a623cbae1046b3ea5f1d67af5b83434877618c962e8d1a2f96c6149062b351e" }, "downloads": -1, "filename": "vmap-0.2.0.tar.gz", "has_sig": false, "md5_digest": "5ce1f5cef275559d6eb019da1c386f8b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12222, "upload_time": "2017-06-11T20:08:48", "url": "https://files.pythonhosted.org/packages/ea/f5/00380dee401a8376dcc6bffe4b286a47a59c6193beeee816929627a421db/vmap-0.2.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "5ce1f5cef275559d6eb019da1c386f8b", "sha256": "6a623cbae1046b3ea5f1d67af5b83434877618c962e8d1a2f96c6149062b351e" }, "downloads": -1, "filename": "vmap-0.2.0.tar.gz", "has_sig": false, "md5_digest": "5ce1f5cef275559d6eb019da1c386f8b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12222, "upload_time": "2017-06-11T20:08:48", "url": "https://files.pythonhosted.org/packages/ea/f5/00380dee401a8376dcc6bffe4b286a47a59c6193beeee816929627a421db/vmap-0.2.0.tar.gz" } ] }