UWG_QiXiang

UWG_QiXiang provides geomorphic analysis of the observational data or the results from the models built by UWGeodyanmics and Badlands. It is based on some topographic analysis tools such as TopoToolbox.

Name Introduction

Qi Xiang: The god of the Yangtze River.

奇相: 长江之神。 《广雅·释天》：“江神谓之奇相。” “庾仲雍《江记》：‘奇相，帝女也，卒为江神。’”

Installation

It is recommended to install UWG_QiXiang and all its dependencies on your local machine. You may try it first through Binder.

In binder, if you run into some wrong results when plotting by Cartopy, change the data_img input without processing by np.flipud, for example:

In local :

data_img = np.flipud(topo_f.copy()) 

In binder, change it to :

data_img = topo_f.copy() 

Dependencies

Python >=3.7.6

• numpy>=1.18.4

• matplotlib>=3.2.1

• cartopy>=0.17.0

• pyshp>=2.1.0

• gdal>=2.4.4

• scipy>=1.4.1

• pyshtools>=4.6.2

• scipy>=1.4.1

• scikit-image>=0.17.2

Tutorials

Tutorials with worked examples can be found in the tutorials subdirectory, include:

• Start Here

  • 0-StartHere_Binder

• Data load and plot

  • 1_01_LoadnSmoothTopo_Earth2014
  • 1_02_MapRivers_Earth2014nWDBII
  • 1_03_TopoRivers_Tibet_Earth2014nWDBII
  • 1_04_TopoRivers_Tibet_Earth2014_Cartopy
  • 1_04_TopoRivers_Tibet_Earth2014_Cartopy_GMTcolor

• Calculate the Conformity Factor

  • 2_00_MakeGeotiff_Earth2014_SRTM90m
  • 2_00_RiverData
  • 2_01_ConformityFactor
  • 2_02_ConformityFactor_Analysis

• Topographic analysis tools (developing)

  • 3_01_Example_topopy
  • 3_02_Example_qixiang

• Note

  • [River meanders and the theory of minimum variance](tutorials/Note_River meanders and the theory of minimum variance.ipynb)

Reference

Most functions in UWG_Qixiang are based on TopoToolbox and geolovic/topopy.

• Schwanghart, W., Scherler, D., 2014. Short Communication: TopoToolbox 2 - MATLAB-based software for topographic analysis and modeling in Earth surface sciences. Earth Surf. Dyn. 2, 1–7. https://doi.org/10.5194/esurf-2-1-2014