Show Navigation | Hide Navigation
You are here:
Geoprocessing tool reference > Spatial Statistics toolbox > Measuring Geographic Distributions toolset > Tools

Directional Distribution (Standard Deviational Ellipse) (Spatial Statistics)

Release 9.2
Last modified January 9, 2009
E-mail This Topic Printable Version Give Us Feedback

Print all topics in : "Tools"


Related Topics

Measures whether a distribution of features exhibits a directional trend (whether features are farther from a specified point in one direction than in another direction).

Learn about how Directional Distribution: Standard Deviational Ellipse works


Illustration

Directional Distribution (Standard Deviational Ellipse) illustration

Usage tips

Command line syntax
An overview of the Command Line window
DirectionalDistribution_stats <Input_Feature_Class> <Output_Ellipse_Feature_Class> <1 Standard Deviation | 2 Standard Deviations | 3 Standard Deviations> {Weight_Field} {Case_Field}

Parameter Explanation Data Type
<Input_Feature_Class>

A feature class containing a distribution of features for which the standard deviational ellipse will be calculated.

Feature Layer
<Output_Ellipse_Feature_Class>

A polygon feature class that will contain an ellipse for each input mean center point. Each ellipse graphically portrays the directional trend (if any) of data values around its associated center point.

Feature Class
<1 Standard Deviation | 2 Standard Deviations | 3 Standard Deviations>

The size of output ellipses in standard deviations. The default ellipse size is 1; valid choices are 1, 2, or 3 standard deviations.

String
{Weight_Field}

The numeric field used to weight locations according to their relative importance.

Field
{Case_Field}

Field used to group features for separate directional distribution calculations. The case field can be of numeric, date, or string type.

Field
Data types for geoprocessing tool parameters


Command line example

workspace e:\project93\data
DirectionalDistribution assault.shp assault_ellipse.shp '1 Standard Deviation' # TYPE

Scripting syntax
About getting started with writing geoprocessing scripts
DirectionalDistribution_stats (Input_Feature_Class, Output_Ellipse_Feature_Class, Ellipse_Size, Weight_Field, Case_Field)

Parameter Explanation Data Type
Input_Feature_Class (Required)

A feature class containing a distribution of features for which the standard deviational ellipse will be calculated.

Feature Layer
Output_Ellipse_Feature_Class (Required)

A polygon feature class that will contain an ellipse for each input mean center point. Each ellipse graphically portrays the directional trend (if any) of data values around its associated center point.

Feature Class
Ellipse_Size (Required)

The size of output ellipses in standard deviations. The default ellipse size is 1; valid choices are 1, 2, or 3 standard deviations.

String
Weight_Field (Optional)

The numeric field used to weight locations according to their relative importance.

Field
Case_Field (Optional)

Field used to group features for separate directional distribution calculations. The case field can be of numeric, date, or string type.

Field

Data types for geoprocessing tool parameters


Script example

# Measure the geographic distribution of auto thefts
# Import system modules
import arcgisscripting

# Create the Geoprocessor object
gp = arcgisscripting.create()

# Local variables...
workspace = "C:/chris/data/"
auto_theft_locations = "AutoTheft.shp"
auto_theft_links = "AutoTheft_links.shp"
auto_theft_sd = "auto_theft_SD.shp"
auto_theft_se = "auto_theft_SE.shp"
auto_theft_ldm = "auto_theft_LDM.shp"

try:
    # Set the workspace (to avoid having to type in the full path to the data every time)
    gp.Workspace = workspace

    # Process: Standard Distance of auto theft locations...
gp.StandardDistance_stats(auto_theft_locations, auto_theft_sd, "1 Standard Deviation", "#", "#") # Process: Directional Distribution (Standard Deviational Ellipse) of auto theft locations... gp.DirectionalDistribution_stats(auto_theft_locations, auto_theft_se, "1 Standard Deviation", "#", "#") # Process: Linear Directional Mean of auto thefts... gp.DirectionalMean_stats(auto_theft_links, auto_theft_ldm, "false", "#") except: # If an error occurred while running a tool, print the messages print gp.GetMessages()

Please visit the Feedback page to comment or give suggestions on ArcGIS Desktop Help.
Copyright © Environmental Systems Research Institute, Inc.