Configuring the Application to Work with Other Data

By default the Landscape Modeler application creates models using a subset of the raster Landscape Layers hosted by Esri on ArcGIS Online. In order to configure it to work with your own data, you will have to follow the steps outlined in this document.

##Prerequisites

Before you can configure the application, you must first complete these steps which are documented elsewhere:

1. Prepare the data and publish an image service with weighted overlay functions

2. Verify that your image service has the raster function templates applied. Using a web browser, browse to your image service’s REST URL. For example:
   http://your-server-name:your-port-number/arcgis/rest/services/a-service-name/ImageServer
   Scroll down the directory page until you see an entry for RasterFunctionInfos. This entry should read {"name":"None","description":"A No-Op Function.","help":""}, {"name":"WeightedOverlay_7_0_9_histogram","description":"A raster function template.","help":""}, {"name":"WeightedOverlay_7_1_9_colormap","description":"A raster function template.","help":""}. If it does not, try republishing the service making sure you follow step 16 in this document.

3. Verify that you have the required fields in your Catalog in the image service. Again using a web browser, browse to your image service’s REST URL. Scroll down the directory page until you see an entry for Fields. Verify that you have these fields: Title; Url; InputRanges; OutputValues; NoDataRanges; RangeLabels; NoDataRangeLabels. If you are missing any of these fields, revisit section Adding and populating fields used by Landscape Modeler in this document.

4. Register the application with ArcGIS Online or another portal to get an app ID. Note: This step will require that you plan the URL to your application first.

##Application Configuration

Once you have an image service that exposes the weighted overlay functions, and an app ID, you will have to modify some of the configuration settings in src/app/config.js before deploying the application.

1. The following settings must be modified:

• Set weightedOverlayService.url to the URL of the image service published in prerequisite step 1 (above)
• Set oauthOptions.appId to the app ID from perquisite step 4 (above)
• Set portalOptions.typeKeyword to something other than "Landscape Modeler" (i.e. "My Modeler")
• Set weightedOverlayService.dummyRasterId to the ID (OBJECTID) of a raster in your mosaic that is continuous for all of your area of interest. If the dummy raster has NoData values for any part of your area of interest, every model will show NoData (holes) for that area.

2. In addition you may need to change the following settings:

• Set oauthOptions.portal to the URL of your portal if you are not using ArcGIS Online
• Set weightedOverlayService.queryParameters.where to "1=1" for all rasters or any other valid expression to limit which rasters in your mosaic are exposed to the app
• Set the URLs to the proxy page, geometry service, etc to match your environment
• You will likely also want to configure the application title, map center/zoom, area units, and/or colormap definitions to match your data.

3. Deploy the application to a web server.

###Configuration Settings

Below is a partial list of some of more critical (and/or potentially confusing) configuration settings and what they mean.

Section	Variable	Description
oauthOptions	portal	Url to the portal (ArcGIS Online, Organization, etc) where the application is registered
oauthOptions	appId	App ID that the application is registered with
portalOptions	typeKeyword	Used to filter portal search results to items saved by this application.
weightedOverlayService	url	URL to the image service that exposes the mosaic data and raster functions
weightedOverlayService	rasterFunctionName	Name of raster function that perfoms weighted overlay calculation
weightedOverlayService	histogramRasterFunctionName	Name of raster function that perfoms weighted overlay calculation on histograms for charts
weightedOverlayService	rastersInFunction	The maximum number of rasters the raster functions can operate on
weightedOverlayService	dummyRasterId	This should be the OBJECT ID of a raster that is continuous for the entire extent you data set (i.e. does not have any NoData cells)
weightedOverlayService	queryParameters.where	An expression to filter the mosaic rasters that are exposed to the app
weightedOverlayService	queryParameters.outFields	An array of mosaic attribute table field names that are exposed to the app. Must either be set to ['*'] or at least include the required fields