UrbanFootprint supports comprehensive analysis of scenarios based on variations in land use patterns and technical policies. Analysis modules can be run on existing conditions (Base Scenario), following the completion of a new scenario, or at any time during scenario development to evaluate performance. Run times vary according to the complexity of the modules, with some requiring a few minutes or more.

While you wait, you can continue using all of UrbanFootprint’s other features, and even switch to another Project.

To perform analysis, follow these steps:

Step 1 - Select a Scenario

From the Scenario bar, select a scenario (this includes the Base Scenario).

Step 2 - Enable Analyze Mode

Click on “Analyze” in the left hand Mode Bar.

Once Analyze Mode is enabled, you will see the Analyze pane.

The Analyze pane includes:

  • Modules: A row for each UrbanFootprint analysis module. See the analysis module articles for more details about each one.
  • Status: Text indicating whether a module is ready to run, running or complete (see the section below for more details).
  • Run button: On hover of your cursor, each module displays a play icon. Click this icon to run, or re-run, the module.
  • Menu: Each UrbanFootprint analysis module has detailed documentation. You can access it by clicking on the menu icon. This will open the methodology document in another browser tab.
  • Result charts: Click on each module to open a view with result charts for the selected module.

Step 3 - Run a module

Ready to run

Modules that have not been run yet will have light gray icons and say “Ready to run”. To run an analysis, click on the play icon for the given module. 

Analysis is running

The module status will change to “Analysis is running’ and a spinner will replace the Run button. The module will run in the background, so you can continue doing other work in UrbanFootprint and return to check the status or view results at any time.

Analysis complete

Once a module run is complete, the icon will turn dark gray and the status will update to “Analysis complete”.


Analysis out of date

A warning message will appear if a module’s analysis is out of date due to new changes made to a scenario. To re-run the module, click the run button.

Module results will become out of date for a scenario if you:

  • Apply development constraints
  • Paint
  • Adjust land use type variables in Library Settings in Manage Mode (e.g. average household size).

Step 4 - View results

Each module produces three main outputs:

  • Summary charts for key metrics
  • A map layer
  • A data table

Summary charts

Click on an analysis module to open its details pane.

This view displays charts for key metrics for the given scenario and analysis module. Note that you can also run or re-run an analysis module from the modules detail view. You can also compare the same metrics for multiple scenarios side-by-side in Report Mode.

Map layer

Once an analysis module has been run, it will add a new layer to the scenario’s Layer List. Analysis layers are called out with a blue bar chart icon. Find the layer in the Layer List and turn it on to view it on the map. You can select from any column in the data table to review results, curate layer styling, create exhibits, and compare to other scenarios.

Data table

To dig into the details (or to export a .csv file for external review), open the data table by selecting the layer in the layers list. You can view summary stats for each column (min, max, mean, sum), as well as row and column counts.

Review documentation

Each UrbanFootprint analysis module has detailed documentation. You can access it by clicking on the menu icon. This will open the methodology document in another browser tab.

Did this answer your question?