RiverObs

This is a package written initially by Ernesto Rodriguez to estimate various river parameters starting from remote sensing data. Brent Williams has also provided code to reflect the evolving SWOT project.

Detailed installation instructions are in the Install.md file.

Summary of packages provided

RiverObs: This is the main package for associating data with river reaches, and estimating hydrology parameters base on reach averaging (or not...). In addition to the homegrown packages listed below, this package requires the following open source packages:

• scipy: Science algorithms swiss army knife.
• numpy: Numerics swiss army knife.
• netCDF4: Reading netcdf4 files, including SWOT L2 data files.
• StatsModels: Fitting and estimation tools.
• pysal: nice interface to shapefiles and shapely bridge.
• pyproj: Cartographic projections swiss army knife.
• pandas: The Python Data Analysis Library for DataFrames and HDFStore.
• pytables: easy HDF5 support, required for pandas HDFStore.

Centerline: Provides a class that can be used to project data or refine a river center line. Requires the following packages:

• scipy: Science algorithms swiss army knife.
• numpy: Numerics swiss army knife.

GeometryDataBase: Find quickly which reach intersects with a geometry of interest. The geometries are assumed to be stored in a shapefile. Requires the following packages:

• Rtree: Fast bounding box queries.
• libspatialindex: Required by Rtree.
• pysal: nice interface to shapefiles and shapely bridge.
• shapely: geometry calculations.

SWOTRiver: This package contains classes that use the RiverObs capabilities to produce hydrology outputs from SWOT (simulated) data.

• numpy: Numerics swiss army knife.
• netCDF4: Reading netcdf4 files, including SWOT L2 data files.
• pyproj: Cartographic projections swiss army knife.
• pandas: The Python Data Analysis Library for DataFrames and HDFStore.
• pytables: easy HDF5 support, required for pandas HDFStore.

GDALOGRUtilities: Provides homegrown utilities for reading and writing various GIS files. Requires the following packages:

• gdal: GIS files swiss army knife.
• pyproj: Cartographic projections swiss army knife.

GWDLR: This is an optional package to convert Global Width Database-Large Rivers raster data provided by Dai Yamazaki to vectors that can be used as centerlines. Requires:

• grass: for raster to vector program.
• scikit-image: for skeletonize.