Reproducing PyOSP paper results (Part 1) - topographic analysis of Teton Range, Wyoming
The objective of this tutorial is to present the process of analysis shown in the PyOSP paper section 4.1. We will reproduce all relevant results by the following steps.
This tutorial starts from installing Python and PyOSP on your computer. If you are familiar with the installing process, please jumping into the section of downloading the dataset.
We start from installing Python on your machine. Since PyOSP is installed through Conda environment, we recommend users install Python through conda environment as well. First, click the link below and download the latest version of Miniconda based on your OS.
After installing the Miniconde, user should be able to see the Anaconda prompt in the terminal. For example, if Windows is the using OS, searching and clicking the “Anaconda prompt” in the searching bar, it should open a terminal window such as:
Now, we create a conda environment called env_pyosp, and install PyOSP in it. Entering following commends line by line:
conda create -n env_pyosp conda activate env_pyosp conda config --env --add channels conda-forge conda config --env --set channel_priority strict conda install python=3 pyosp
After PyOSP installed, we can verify the installation by entering a Python shell (type python in the terminal window), and then check:
import pyosp print(pyosp.__version__)
Quit the Python shell by pressing Ctrl-Z and then Enter.
We also recommend install Jupyter Notebook for the analysis, run the commend below in the terminal:
conda install jupyterlab
After you have installed the Jupyter Notebook on your computer, you can start the notebook server by running:
When the notebook opens in your browser, you will see the level of directory containing notebooks. Now we can create a new folder (from the new button on the top right of page) for our analysis, rename it as ‘pyosp_teton’, and then enter the new folder. In the new folder, you can click the new button again, select Python 3, it will open a new notebook, such as below:
By entering the notebook, we can start our analysis.
Download the datasets
You will need to download the GeoRaster and baseline shapefile for the swath analysis. In the terminal, cd to the folder ‘pyosp_teton’ that we created above, and input:
git clone https://github.com/PyOSP-devs/pyosp-case-studies.git
It will download datasets for this analysis.
Basic swath analysis
In the jupyter notebook, input follwing code snippet:
import pyosp baseline = './pyosp-case-studies/teton/baseline.shp' raster = './pyosp-case-studies/teton/teton_dem.tif' orig = pyosp.Orig_curv( baseline, raster, width=100000, line_stepsize=1000, cross_stepsize=10 )
Processing: [#########################] 68 of 68 lineSteps
After the processing bar go through the end, a swath object orig should be generated. Before we move to the swath results, let’s take a look at baseline swath polygon, and swath polyline objects.
import matplotlib.pyplot as plt from pyosp import read_shape # read the baseline shape line_shape = read_shape(baseline) lx, ly = line_shape.xy # Plot the swath polygon fig, ax = plt.subplots() swath_polygon = orig.out_polygon() px, py = swath_polygon.exterior.xy ax.plot(px, py) ax.plot(lx, ly, color='C3', label="Baseline") ax.set_aspect('equal', adjustable='box') ax.set_title("Swath polygon") ax.legend() # Plot the swath profile lines fig, ax = plt.subplots() swath_polylines = orig.out_polylines() for line in swath_polylines.geoms: x, y = line.xy ax.plot(x, y, color='C1') ax.plot(lx, ly, color='C3', label="Baseline") ax.set_aspect('equal', adjustable='box') ax.set_title("Swath profile lines") ax.legend()
<matplotlib.legend.Legend at 0x2dd620c97c0>
As shown above, our sampling profile lines are bounded by the swath polygon rather than defined swath width 100,000. Because in this case, we used a customized shape associating with the structure of Teton Range to clip the DEM. And our objective is to characterize Teton Range within the structure area. Thus, we used an over-extended swath width 100,000 to ensure the profile line can reach the raster boundary. When PyOSP detected the data boundary of DEM, it will prevent the profile line extending to the nodata region. The resulted sampling data is exactly within the area of clip shape. Check the background information in the PyOSP paper PyOSP paper.
To plot the swath profile, simply run the method:
Differential swath analysis
In the paper, we show the ability of PyOSP to split swath results, which we term “differential swaths.” We used TPI = 0 during post-processing as a threshold to delineate the inflection of slope shape where topography changes from concave-down (TPI > 0) to convex up (TPI < 0). Thus, differential swaths enable the separation of topography via geomorphic processes, with positive and negative TPI representing erosional and depositional areas of the topography, respectively.
We plot reclassfied TPI>0 and TPI<0 swath profiles as below.
tpi_big = orig.post_tpi(radius=1000, min_val=0, color='maroon', swath_plot=True)
tpi_small = orig.post_tpi(radius=1000, max_val=0, color='maroon', swath_plot=True)
tpi_small contain the distance and values of reclassified data.
Cross swath profile
Next, we evaluate five cross swath profiles along the striking of the baseline. There are two ways to define the boundary of cross swath profile:
- Specify the start and end points positions from the starting point of baseline.
- Draw the points along the baseline, and then pass the shapefile of points to the function.
In the documentation of PyOSP, there is a tutorial about application process of these two methods.
Here, we use distance to define the cross boundary.
cases = [[58250, None], [42500, 58250], [30000, 42500], [22000, 30000], [5000, 22000], [0, 5000]] colors = ['maroon', 'indigo', 'red', 'navy', 'darkolivegreen', 'darkgoldenrod'] titles = ['(f)', '(e)', '(d)', '(c)', '(b)', '(a)'] fig, ax = plt.subplots(6, 1, sharex=True, figsize=(4, 7)) fig.subplots_adjust(hspace=0.2) for i in cases: ind = cases.index(i) orig.cross_plot(start=i, end=i, ax=ax[ind], color=colors[ind]) ax[ind].set_title(titles[ind], pad=2) ax[ind].set_xlabel("") ax[ind].set_ylabel("Elevation (m)") ax[ind].set_xticks([-20000, -10000, 0, 10000]) ax[ind].set_ylim(1700,4500) if ind == len(cases)-1: ax[ind].set_xlabel('Distance from the baseline (m)') plt.tight_layout()
This tutorial introduces the swath analysis of Teton range by PyOSP, which corresponds to section 4.1 of PyOSP paper. In the next tutorial, we will use PyOSP to correlate river terraces exemplified by Licking River, Kentucky.
If you have any questions, you can open an issue at https://github.com/PyOSP-devs/PyOSP, or send email to yichuan.zhu[at]temple.edu