Mapping

• Standard layouts
• Modify the symbology
• Modify map extents
• Code information

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).

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:

• layout_lf for lifespan mapping
• layout_ds_bio for bioengineering features
• layout_ds_Dcr for grain mobility maps and sediment replenishment / gravel augmentation
• layout_ds_Dw for wood diameter mobility maps
• layout_ds_FS_D15 for fine sediment’s mobile D₁₅ sizes
• layout_ds_FS_D85 for fine sediment’s mobile D₈₅ sizes
• layout_ds_SeS0 for ratios between terrain and (hypothetic) energy slopes (side channels)
• layout_ds_sideca for side cavity application site mapping
• layout_ds for widen application site mapping

Max Lifespan layouts:

• layout_mlf_bioeng for best lifespan maps of the (other) bioengineering feature group
• layout_mlf_maintenance for best lifespan maps of the maintenance/longitudinal connectivity feature group
• layout_mlf_plants for best lifespan maps of the vegetation plantings feature group
• layout_mlf_terraforming for best lifespan maps of the terraforming feature group

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:

• LifespanDesign: RiverArchitect/LifespanDesign/.templates/mapping.inp (see definitions)
• Max Lifespan: RiverArchitect/MaxLifespan/.templates/mapping.inp (definitions are analogue to the LifespanDesign module)
• Modify Terrain: RiverArchitect/ModifyTerrain/.templates/computation_extents.xlsx (see reach definitions)

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.