Substrate Raster Generation (batch process)

The substrate raster produced within the CHaMP Topo Toolbar is used in habitat modeling. The Substrate Raster Generation (Batch) tool makes it easier to create substrate rasters for multiple CHaMP visits to be used for this purpose.


In order for Substrate Raster Generation (Batch) to run successfully the user must have a recent version of the CHaMP Workbench database and the data to be processed needs to be organized in a particular fashion. The requirements are:

  1. Obtain a recent version of the CHaMP Workbench
  2. Organize the visits to be processed in the same folder structure the CHaMP Workbench requires:
  3. MonitoringData/Year/Watershed/Site/Visit/Topo/SurveyGDB/
  4. for more information about this folder structure visit this webpage.
  5. Make sure the Survey Geodatabases to be processed have been unzipped if they were obtained via a ftp transfer.
  6. a batch unzipping tool is available in the CHaMP Workbench, see here for information about this tool.


  1. Open CHaMP Toolbar/Advanced/Substrate Raster Generation (Batch).
  2. Set the CHaMP workbench DB by browsing to a copy of the CHaMP Workbench database.
  3. Set the Monitoring data folder by browsing to the parent folder containing the data to be processed.
  4. for example: ~\MonitoringData.
  5. Select the desired grain size percentile. The CHaMP standard is D50.
  6. Set the Raster name by entering a text into the associated text box, all roughness rasters produced from this tool will have this name. The CHaMP standard for this name is AssocRough.tif
  7. Set the Top level output folder path by browsing to a folder the output will be created in.
  8. the tool will recreate the Year/Watershed/Site/Visit/Topo structure within the selected folder and save each roughness raster to its relevant folder.
  9. Set whether or not to overwrite existing substrate rasters by checking or unchecking Overwrite existing substrate rasters.
  10. Set which field seasons to process by navigating to the Field Seasons tab, select only the years to be processed.
  11. Set which watersheds to process by navigating to the Watersheds tab, select only the watersheds to be processed.
  12. This tab will be empty until the CHaMP workbench DB parameter has been set.
  13. Set whether or not to filter for annual sites by checking or unchecking Filter for annual sites.
  14. Set whether or not to filter for primary visits by checking or unchecking Filter for primary visits.
  15. Click OK and then wait. This form does not have a progress box or wait cursor. Simply wait for it to finish processing. Generating each substrate raster could take more than a minute. Generating a whole watershed could take two hours. Be patient even though there is no indication of progress. A message box will appear when it has finished processing that reports how many substrate rasters were produced.
  16. Upon completion, the tool will report how many visits the substrate raster was successfully created for and provides details about how many visits did not successfully process and why.