topagnps2cche1d (1.1.0)

Toolbox of Python functions to handle TopAGNPS outputs and reformat them as CCHE1D inputs

Please refer to the top2cche1d_notebook.ipynb for explanations and quick-start guide.

Current features

Using the files produced by TopAGNPS:

• AnnAGNPS_Reach_Data_Section.csv
• AnnAGNPS_Cell_Data_Section.csv
• Reach raster data: AnnAGNPS_Reach_IDs.asc (with accompanying projection file)

topagnps2cche1d will create a Watershed object containing the reaches and their connectivity in a NetworkX DiGraph.

• Reaches are represented with computational nodes with a structure compatible with the Fluvial Routing Analysis and Modeling Environment (FRAME) developed by Vieira (1997) and therefore usable by CCHE1D

To-do:

• Producing CCHE1D Tables:

  • channel, reaches, links, nodes tables
  • boundary conditions tables (inflows from cells and "ghost" reaches)

• Debug tables, for when reaches are resampled or removed.

• Implement pickle_watershed() and unpickle_watershed() methods

• Implement reach resampling methods

• Debug reach resampling methods

• Implement processing reach geometries from polygons GeoDataFrame (output of polygonization process)

  • Using reach skeletonization method

• Implement cross-sections methods

• Implement reading from NHD network directly using pynhd and NLDI

Changelogs

• August 2023:
  • Rewriting of the whole library in an object oriented programming approach. Removes the need for AgFlow and Strahler output data from TopAGNPS

References:

Vieira, D.A., 1997, FRAME - Control Module Technical Manual, Tech. Rep. No. CCHE-TR-97-7, Center for Computational Hydroscience and Engineering, The University of Mississippi, University, Mississippi.