Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/liamtoney/landslide_superimpose
To-scale superimposition of landslide deposits over arbitrary satellite images, for outreach purposes
https://github.com/liamtoney/landslide_superimpose
geospatial imagery landslides outreach
Last synced: about 1 month ago
JSON representation
To-scale superimposition of landslide deposits over arbitrary satellite images, for outreach purposes
- Host: GitHub
- URL: https://github.com/liamtoney/landslide_superimpose
- Owner: liamtoney
- Created: 2023-05-11T17:51:28.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2023-05-22T18:16:27.000Z (over 1 year ago)
- Last Synced: 2024-01-29T14:39:44.703Z (11 months ago)
- Topics: geospatial, imagery, landslides, outreach
- Language: Python
- Homepage:
- Size: 3.1 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# *landslide_superimpose*
*landslide_superimpose* is a landslide size visualization outreach tool.
Given the following inputs:
* A satellite image of a landslide deposit
* An outline of the landslide deposit (e.g., from GIS software)
* The coordinates of the crown of the landslide
* A "background" satellite image of any other location
* The coordinates of a target point in the "background" satellite image[`landslide_superimpose.py`](landslide_superimpose.py) will:
* Convert all geospatial objects into their equivalent UTM coordinate reference
systems
* Clip the landslide image using the landslide outline
* Superimpose the clipped landslide image on the background image, placing the
landslide crown at the target locationThe operations are performed such that the landslide deposit has the same scale
as the background image. **This can create powerful visualizations of the size
of events:**![Imagery © 2016 and 2022 Planet Labs, Inc.](iliamna_2016_fbx.jpg)
All images (rasters) are expected to be in GeoTIFF format. Landslide outlines
can be KML files or shapefiles. The code *should* [keyword! 😉] be able to
handle arbitrary coordinate reference systems for these inputs. All coordinates
are expected to be (latitude, longitude) in the WGS 84 datum.## Quickstart
1. Obtain
```
git clone --depth 1 https://github.com/liamtoney/landslide_superimpose.git
cd landslide_superimpose
```2. Create environment, install, and activate
([install conda](https://conda.io/projects/conda/en/latest/user-guide/install/index.html)
first, if necessary)
```
conda env create
conda activate landslide_superimpose
```3. Run as a Python script within IPython
```
ipython
In [1]: run landslide_superimpose.py
```## Disclaimer
This code has not been extensively tested, nor should you expect it to work
without modifying the paths in the top of the script and providing your own
input files!