The DistanceDecayParameters class provides input parameters for the Distance Decay task.

Object Model

Syntax

Visual Basic (Declaration)

Public Class DistanceDecayParameters 
   Inherits ESRI.ArcGIS.Client.BAServer.Tasks.AnalysisAndReportParameters
   Implements ESRI.ArcGIS.Client.BACore.Client.IBADatasetParameters, ESRI.ArcGIS.Client.BACore.Client.IBATaskParameters

public class DistanceDecayParameters : ESRI.ArcGIS.Client.BAServer.Tasks.AnalysisAndReportParameters, ESRI.ArcGIS.Client.BACore.Client.IBADatasetParameters, ESRI.ArcGIS.Client.BACore.Client.IBATaskParameters

Remarks

The analysis can be restricted to an analysis extent if the AnalysisExtent parameter is specified. Optional SingleStoreID parameter restricts the analysis to a single store of the store layer.

Decay areas creation options:

The DecayAreasType parameter specifies the simple ring or drive-time decay type.
The Radii parameter specifies the radii of areas and the DistanceUnits parameter specifies units in which radii are measured. For simple ring decay type, distance units are used. For drive time decay type, distance units or drive time units are used.
The BuildNonOverlapped parameter specifies creation of non-overlapped areas or overlapped areas (default).
The CreateDetailedBorder parameter specifies the creation of detailed border or not (default). It is used for drive-time decay type.

Market penetration options:

The UseGeographyLevel parameter specifies the use of a geography layer or not (default) in the calculation of market penetration. If the geography layer is in use, the DataHierarchy parameter can be specified.
The TotalMarketCountField parameter specifies the total market count field from the geography layer if the last one is in use or from the store layer otherwise.
The CustomerWeightField parameter can specify a weight field in the customer layer for calculating a weight rather than number of customers, Sales for example.

Output options for this task include rendering an output image (OutputTypes.GetMapImage), creating a feature class for subsequent analysis (OutputTypes.GetFeatureClass), and/or creating a report (OutputTypes.GetReport). If no output options are specified, the required output options are specified as follows. If the RenderingParameters parameter is specified, the image output is requested. If the StandardReportOptions parameter is specified, the report is requested. If the OutputAnalysisItem parameter is specified, the output analysis feature class will be stored in the repository. If RenderingParameters, StandardReportOptions, and OutputAnalysisItem parameters are missing, the feature class output is requested.

Example

The code snippet below creates DistanceDecayParameters and then executes a Distance Decay task.

C#	Copy Code
DistanceDecayParameters parameters = new DistanceDecayParameters(); // The PointLayer type could take either data as // ESRI.ArcGIS.Client.Tasks.FeatureSet, ESRI.ArcGIS.Client.BAServer.FolderItem, // or a list of ESRI.ArcGIS.Client.BACore.PointRecord items, e.g. //List<PointRecord> points = new List<PointRecord>() { // new PointRecord("Store 1", "Steiner St. & Geary Blvd", "1", 37.78415, -122.4346)}; // Set Stores as a list of PointRecord using implicit cast operator. parameters.Stores = points; // The StoreIDField parameter is ignored if stores are specified as a list of PointRecord. //parameters.StoreIDField = "STORE_ID"; // Set Customers with a valid data type. parameters.Customers = customers; // Set the field name to link customers with a store. parameters.CustomerLinkField = "STORE_ID"; // Set array of times or distances. parameters.Radii = new List<double>(){ 1, 3, 5 }; // Set total market count field name. parameters.TotalMarketCountField = totalMarketCountField; distanceDecayTask.ExecuteAsync(parameters, new AsyncResponder(resultHandler, faultHandler));

Copy Code

DistanceDecayParameters parameters = new DistanceDecayParameters();
             
// The PointLayer type could take either data as
// ESRI.ArcGIS.Client.Tasks.FeatureSet, ESRI.ArcGIS.Client.BAServer.FolderItem,
// or a list of ESRI.ArcGIS.Client.BACore.PointRecord items, e.g.
//List<PointRecord> points = new List<PointRecord>() {
//    new PointRecord("Store 1", "Steiner St. & Geary Blvd", "1", 37.78415, -122.4346)};
             
// Set Stores as a list of PointRecord using implicit cast operator.
parameters.Stores = points;
             
// The StoreIDField parameter is ignored if stores are specified as a list of PointRecord.
//parameters.StoreIDField = "STORE_ID";
             
// Set Customers with a valid data type.
parameters.Customers = customers;
 			
// Set the field name to link customers with a store.
parameters.CustomerLinkField = "STORE_ID";
             
// Set array of times or distances.
parameters.Radii = new List<double>(){ 1, 3, 5 };
             
// Set total market count field name.
parameters.TotalMarketCountField = totalMarketCountField;
             
distanceDecayTask.ExecuteAsync(parameters, new AsyncResponder(resultHandler, faultHandler));

Inheritance Hierarchy

System.Object
   ESRI.ArcGIS.Client.BACore.Client.BATaskParameters
      ESRI.ArcGIS.Client.BACore.Client.StandardReportParameters
         ESRI.ArcGIS.Client.BAServer.Tasks.AnalysisAndReportParameters
            ESRI.ArcGIS.Client.BAServer.Tasks.Reports.DistanceDecayParameters

Requirements

Target Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows Server 2008 family