1. Get started

  2.  Welcome
  3.  Get started
  4.  Run as a Windows service
  5.  Build your first app
  6.  Requirements
  7.  Accessibility support
  8.  Development overview
  9.  About release versions
  10.  What's new
  11.  Frequently asked questions
  12. Working with apps

  13.  Home page
  14.  Create or import an app
  15.  Edit and launch an app
  16.  Choose a theme
  17.  Select a map or scene
  18.  Add widgets
  19.  Widgets overview
  20.  Configure app attributes
  21.  Preview apps on smaller screens
  22.  Export as a template
  23.  Edit or preview template
  24.  Use URL parameters
  25.  Upgrade apps
  26. Configure 2D widgets

  27.  About widget
  28.  Add Data widget
  29.  Analysis widget
  30.  Attribute Table widget
  31.  Batch Attribute Editor widget
  32.  Basemap Gallery widget
  33.  Bookmark widget
  34.  Business Analyst widget
  35.  Chart widget
  36.  Controller widget
  37.  Coordinate widget
  38.  Coordinate Conversion widget
  39.  Cost Analysis widget
  40.  Data Aggregation widget
  41.  Directions widget
  42.  Distance and Direction widget
  43.  District Lookup widget
  44.  Draw widget
  45.  Edit widget
  46.  Emergency Response Guide widget
  47.  Extent Navigate widget
  48.  Filter widget
  49.  Full Screen widget
  50.  Geocoder widget
  51.  GeoLookup widget
  52.  Geoprocessing widget
  53.  Grid Overlay widget
  54.  Gridded Reference Graphic widget
  55.  Group Filter widget
  56.  Image Measurement widget
  57.  Home Button widget
  58.  Incident Analysis widget
  59.  Infographic widget
  60.  Info Summary widget
  61.  Layer List widget
  62.  Legend widget
  63.  Measurement widget
  64.  My Location widget
  65.  Near Me widget
  66.  Network Trace widget
  67.  Oblique Viewer widget
  68.  Overview Map widget
  69.  Parcel Drafter widget
  70.  Print widget
  71.  Public Notification widget
  72.  Query widget
  73.  Related Table Charts widget
  74.  Report Feature widget
  75.  Reviewer Dashboard widget
  76.  Scalebar widget
  77.  Screening widget
  78.  Search widget
  79.  Select widget
  80.  Share widget
  81.  Situation Awareness widget
  82.  Smart Editor widget
  83.  Splash widget
  84.  Stream widget
  85.  Suitability Modeler widget
  86.  Summary widget
  87.  Swipe widget
  88.  Threat Analysis widget
  89.  Time Slider widget
  90.  Visibility widget
  91.  Zoom Slider widget
  92. Configure 3D widgets

  93.  3DFx widget
  94.  About widget
  95.  Basemap Gallery widget
  96.  Compass widget
  97.  Coordinate widget
  98.  Daylight widget
  99.  Full Screen widget
  100.  Home Button widget
  101.  Layer List widget
  102.  Legend widget
  103.  Measurement widget
  104.  My Location widget
  105.  Navigate widget
  106.  Search widget
  107.  Share widget
  108.  Slides widget
  109.  Splash widget
  110.  Zoom Slider widget
  111. Widget development

  112.  Get started
  113.  Naming conventions
  114.  In-panel and off-panel widgets
  115.  Deploy your widget
  116.  Required files
  117.  Widget manifest
  118.  Extend BaseWidget
  119.  Required properties
  120.  Define the template
  121.  Configure the Demo widget
  122.  Add i18n support
  123.  Make widgets user-friendly
  124.  Build your first app
  125.  Communication to app container
  126.  Widget properties
  127.  Make widgets responsive
  128.  Communication between widgets
  129.  Dojo dijit
  130.  Make widgets configurable in builder
  131.  Make widgets backward compatible
  132.  Create a controller widget
  133.  Widget life cycle
  134.  Add help for your widget
  135.  Create a feature action in your widget
  136.  Provide and consume data sources in widgets
  137.  Best practices for unit testing
  138. Theme development

  139.  Theme elements
  140.  Create a theme
  141. 3D development

  142.  3D development guide
  143. Sample code

  144.  Create a custom in-panel widget
  145.  Create a ListView widget
  146.  Create a custom widget using the Report dijit
  147.  Create a new theme
  148.  Create a new style for a theme
  149.  Create a new default layout
  150.  Create a nondefault layout
  151.  Create a new panel
  152.  Create a new layout widget
  153.  Create a controller widget
  154.  Create a feature action in your widget
  155.  Send a layer to the Attribute Table widget
  156.  Open multiple widgets simultaneously
  157.  Use other libraries
  158.  Change the URL of ArcGIS API for JavaScript
  159. Deployment

  160.  Deploy your app
  161.  Use proxy
  162.  Web-tier authentication
  163.  Custom widget and theme deployment
  164.  Upgrade custom widgets and themes
  165. Framework reference

  166.  CSS framework
  167.  FeatureActionManager class
  168.  FilterManager class
  169.  LayerInfo class
  170.  LayerInfos class
  171.  LayerNode class
  172.  LayerStructure class
  173.  PanelManager class
  174.  SelectionManager class
  175.  Utils class
  176.  WidgetManager class
  177. dijit

  178.  FeaturelayerChooserFromMap class
  179.  FeaturelayerServiceBrowser class
  180.  FeatureSetChooserForSingleLayer class
  181.  Filter class
  182.  ImageChooser class
  183.  ItemSelector class
  184.  LayerChooserFromMap class
  185.  RendererChooser class
  186.  Report class
  187.  SnapShot class
  188.  SymbolChooser class
  189. JSON reference

  190.  App configuration
  191.  Map configuration
  192.  Widget configuration
  193.  Widget pool configuration
  194.  Widget on-screen configuration
  195.  Panel configuration
  196.  Group configuration
  197.  DataSource configuration
  198.  About
  199.  Analysis
  200.  Attribute Table
  201.  Basemap Gallery
  202.  Bookmark
  203.  Chart
  204.  Coordinate
  205.  Directions
  206.  Draw
  207.  Edit
  208.  Full Screen
  209.  Geocoder
  210.  Geoprocessing
  211.  Controller
  212.  Home Button
  213.  Image Measurement
  214.  Infographic
  215.  Layer List
  216.  Legend
  217.  Loading Page
  218.  Measurement
  219.  My Location
  220.  Near Me
  221.  Oblique Viewer
  222.  Overview Map
  223.  Print
  224.  Query
  225.  Report Feature
  226.  Reviewer Dashboard
  227.  Scalebar
  228.  Search
  229.  Share
  230.  Splash
  231.  Stream
  232.  Swipe
  233.  Time Slider
  234.  Zoom Slider
  235. What's new archive

  236.  What's new in version 2.23
  237.  What's new in version 2.22
  238.  What's new in version 2.21
  239.  What's new in version 2.20
  240.  What's new in version 2.19
  241.  What's new in version 2.18
  242.  What's new in version 2.17
  243.  What's new in version 2.16
  244.  What's new in version 2.15
  245.  What's new in version 2.14
  246.  What's new in version 2.13
  247.  What's new in version 2.12
  248.  What's new in version 2.11
  249.  What's new in version 2.10
  250.  What's new in version 2.9
  251.  What's new in version 2.8
  252.  What's new in version 2.7
  253.  What's new in version 2.6
  254.  What's new in version 2.5
  255.  What's new in version 2.4
  256.  What's new in version 2.3
  257.  What's new in version 2.2
  258.  What's new in version 2.1
  259.  What's new in version 2.0
  260.  What's new in version 1.3
  261.  What's new in version 1.2
  262.  What's new in version 1.1

Suitability Modeler widget

The Suitability Modeler widget helps you do the following:

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 ArcGIS GeoPlanner, leverages a special type of image layer known as a weighted overlay service. This type of service is published to ArcGIS Server and added as an item in 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 run using 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.

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

Configure the Suitability Modeler widget

Steps:
  1. Add the Suitability Modeler widget to your app.

    Adding the Suitability Modeler widget

  2. In the Configuration panel, choose one of the following options 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, and the weighting. This is a good approach when users are expected to derive new models from an existing model (for example, various stakeholders’ views on risk factors and their respective importance).

      Pre-configured model option
      Select a Model window

  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 unchecking the check box.
  4. Click OK to confirm the configuration.

Use the Suitability Modeler widget

Steps:
  1. Open the Suitability Modeler widget.

    Suitability Modeler widget

  2. Under the Layers section, 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.

    In the Model section, you can assign each layer a relative importance in the analysis by typing a percentage in 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 how layer values are mapped to a suitability scale. In the example above, the Elevation layer is weighted at 10% and has five classes. Each class is mapped to a suitability value of 1 to 9. The Very Low class (-618 to 0) is mapped to a suitability value of 1. During the analysis, any Elevation value between -618 and 0 is remapped to a value of 1. How you interpret this depends on your criteria. For example, if you are trying to identify areas that can support a flower that grows at higher elevations, a suitability value of 1 indicates that it is unlikely to be found there.

  5. Click Run.

    A rendered WRO model appears on the map.

    Rendered WRO model

    Once you've run your model, you'll be able to create charting percentages.

  6. Select Chart in the Suitability Modeler window.

    Choose between the features to create a chart of your model. You can use tools including the following:

    • Draw a polygon
    • Draw a freehand polygon
    • Select from a layer
    • Pan

    Chart tool

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

    NoteNote:

    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.