Wiki Home

Installation

Get Started

Lifespans

Morphology (Terraforming)

Ecohydraulics

ProjectMaker

Mapping

Tools

FAQ

Troubleshooting


Keywords

Acknowledgment

Disclaimer


Developers (Contributing)


Pages (Latest 3 updated) :

Mapping



About Mapping with River Architect

The RiverArchitect/02_Maps/ folder contains a template structure that is copied by the LifespanDesign, Max Lifespan, and Modify Terrain modules to map their geodata outputs. The [[HabitatEvaluation]] module produces geofiles that can be mapped within the map project file of the ProjectMaker module (RiverArchitect/ProjectMaker/.templates/REACH_stn_vii_TEMPLATE/ProjectMaps.aprx). This differentiation enables distinguished mapping of river sections and project (versions). This Wiki only treats the automated mapping routines of the results of the LifespanDesign, Max Lifespan, and Modify Terrain modules. The ProjectMaker’s result mapping is design for a user-specific map modifications and export.

Before running any of the before-mentioned modules for mapping, open RiverArchitect/02_Maps/templates/river_template.aprx (ArcGIS Pro project file) and correct the background layer image source (adapt to CONDITION) by right-clicking on the background layer (see figure below), then click on Properties > Source > Set Data Source.... Navigate to the CONDITION folder and select the CONDITION’s background.tif (the background raster file must have the name background.tif - mapping will be inconsistent otherwise).

adaptproject

The standard symbology for lifespan rasters may be modified and it can be restored by right-clicking on a lifespan or Best Lifespans raster layer > Symbology. The Symbology opens up and the standard symbology can be restored from the top-right drop-down menu (import (...) > nagivate to RiverArchitect/02_Maps/templates/symbology/ > select LifespanRasterSymbology.lyrx).

The project (.aprx) files contains a set of pre-defined layouts and layer names and these names must not be changed. Only consider changing the symbology or data sources, because the modules will automatically update the layer connection database and dataset according to the output data (read more).

Standard layouts

LifespanDesign layouts:

Max Lifespan layouts:

Modify Terrain layouts:

  • volumes_cust_neg for mapping the terrain differences (excavation terraforming works) of a manually modified DEM
  • volumes_cust_pos for mapping the terrain differences (fill terraforming works) of a manually modified DEM
  • volumes_grade_neg for mapping the terrain differences of parametrically (threshold-based) floodplain grading within the Modify Terrain module (only excavation neg is meaningful)
  • volumes_widen_neg for mapping the terrain differences of parametrically (threshold-based) river widening within the Modify Terrain module (only excavation neg is meaningful)

Modify the symbology

For creating maps with a different symbology then the template symbology, proceed as follows:

  1. Run the module Map Maker function to create a copy of the template map folder, which will be created in RiverArchitect/02_Maps/CONDITION/.
  2. Open the automatically created RiverArchitect/02_Maps/CONDITION/map_CONDITION_design.aprx and adapt the symbology and legend as needed.
  3. Re-run the module Map Maker function to re-create (overwrite previous) .PDF maps. Note: When a module detects an existing version of RiverArchitect/02_Maps/CONDITION/map_CONDITION_design.aprx for the CONDITION that it is applied on, it will NOT OVERWRITE the PROJECT MAP_CONDITION_DESIGN.APRX file, but it will “overwrite existing .PDF maps.”

Modify map extents

The global map extents are determined by the input rasters to map. The same is true for raster calculations. The application scheme of River Architect (Home Wiki page) starts with the usage of the LifespanDesign module. Here, the calculation can be limited to the background.tif raster. Thus, for changing map extents, adapt the extent of input rasters for the LifespanDesign and Max Lifespan modules. For the Modify Terrain module adapt the dem.tif raster in the input/ condition folder, which determines the map extents. Moreover, when applying Modify Terrain, do not use another condition folder for the modified DEM for volume calculation, because it may interfere, for example, with the dem_detrend.tif raster. Preferably use a copy or extract the modified condition’s dem.tif to ModifyTerrain/Input/DEM/CONDITION/.

Moreover, each module has an own mapping definition file to enable reach-wise or multiple map creation within one PDF. The particular map extent definitions are:

Code information

Mapping is centralized for the LifespanDesign, Max Lifespan, and Modify Terrain modules in the Mapper() class that is stored in RiverArchitect/.site_packages/riverpy/cMapper.py. The layout and layer names are hard-coded (sorry for that…) and this is why layer and layout names should not be changed in the project (.aprx) files.