Suitability Modeler widget

The Suitability Modeler widget helps you do the following:

  • Find the best location for an activity.
  • Predict susceptibility to risk.
  • Identify where something is likely to occur.

This widget allows you to combine and weight different layers so you can evaluate multiple factors at once. For example, suitability models help answer questions such as Where are the greatest risks for insect damage? or Where are optimal locations for a commercial development? The answers to these types of questions depend on your input data and the criteria you define from that data.

The Suitability Modeler widget uses fast, web-based weighted raster overlay to generate models from a service. You can start from a blank state of a weighted raster overlay (WRO) service or a preconfigured WRO model. Choose layers, assign weights, and adjust layer classification values to define your analysis. Then, run the modeler, visualize results, and optionally save the result as an item in your organization or portal.

The Suitability Modeler widget, identical to the modeler in GeoPlanner, leverages a special type of image layer known as a weighted overlay service. This type of service is published to ArcGIS for Server and added as an item on ArcGIS Online. There are several weighted overlay services provided by Esri and available publicly in ArcGIS Online. These include ecological and physiographic datasets that have global extents. Some of these services are maintained and updated by Esri so your analyses always execute against current data. The suitability models created by the Suitability Modeler widget, once exported, are hosted as ArcGIS Online image service layers. These are referred to as weighted overlay model services, or models for short.

Understanding weighted overlay

Weighted overlay has three conceptual steps. First, each raster layer is assigned a weight, as a percentage, in the analysis. This allows you to emphasize the relative importance of each layer in the analysis. Second, values within each raster layer are mapped to a common suitability scale. This allows you to compare the different types of information in each raster layer. Third, all raster layers in the analysis are overlaid. Each raster cell’s suitability value is multiplied by its layer weight and totaled with the values of other raster cells it overlays. The result is a suitability value that is used for symbology in the output raster layer.

Two input rasters have been reclassified

In the illustration, the two input rasters have been reclassified to a suitability scale of 1 to 3. Each raster is weighted with a percent influence. The cell values are multiplied by their weight, and the results are added together to create the output raster. For example, in the upper-left cell, the values for the two inputs become (2 * 0.75) = 1.5 and (3 * 0.25) = 0.75. The sum of 1.5 and 0.75 is 2.25. The final value is rounded to 2 as the output is an integer raster layer.

Configuring the Suitability Modeler widget

  1. Add the Suitability Modeler widget to your app.

    Adding the Suitability Modeler widget

  2. In the Configuration panel, you have the following two choices for Starting state:
    • Blank model—This model allows you to point to a WRO service URL directly. With this approach, users will start from a blank state every time they open the widget. This is a good approach for use cases when the criteria (layer) combinations are also open for experimentation.

      Blank model option

    • Pre-configured model—This model allows you to find a WRO model that contains the WRO service on which it is based, the layer combinations, as well as the weighting. This is a good approach when users are expected to derive new models from an existing model. (for example, various stakeholders’ different views on risk factors and their respective importance).

      Pre-configured model
      Select a model

  3. For the Allow Export option, decide whether or not users are allowed to export their models after using the widget (storage may consume credits) by checking or un-checking the check box.
  4. Select OK to confirm the configuration.

Using the Suitability Modeler widget

  1. Open the Suitability Modeler widget

    Suitability Modeler widget

  2. Check the layers you want to include in your analysis.

    You can choose up to 15 layers. Scroll down the list to see all the options.

  3. Click Design Model.

    Assign each layer a relative importance in the analysis by typing a percentage into the percentage (%) text box. The total percentage must equal 100 before you can execute the analysis.

    Add a percentage of importance to each option

  4. Optionally expand each layer and adjust its class weights.

    Class weights are values within the layer that are mapped to a suitability scale. For example, Human Modified has a class weight of 30 percent and is mapped to suitability values 1–9. This means that any values of 0–0.2 in this Human Modified index layer will be treated as 9 (high) in the analysis. How you interpret this depends on your criteria. For example, if you are trying to identify areas at risk of flooding, a value of 9 signifies that an area is highly likely to flood. However, if you are trying to site a new housing development, a value of 9 could signify highly suitable.

  5. Click Run.

    A rendered WRO model appears on the map.

    Rendered WRO model

  6. In the Export dialog box, type a name for your model and click Export.

    The Export dialog box closes. The model is processed in ArcGIS Online and is returned as an image layer to the app.


    The Export option only appears if Allow Export was checked in the configuration.

Weighted overlay models provide a powerful way to visualize and analyze site suitability factors. Based on the shading in your model, you can identify areas of opportunity and risk. The models you create can be further leveraged for real–time feedback in the GeoPlanner dashboard charts. These charts show how your design or other feature layers overlay with assessment layers. This view can help you understand the suitability or risk in your designs and plans.

For more information regarding how to publish your own data for weighted overlay, see the GeoPlanner documentation.