GME

Geospatial Modelling Environment

isectpolypoly

Generate summary statistics for one polygon dataset based on another polygon dataset

Description

For each polygon in a 'zonal' polygon dataset that defines the area over which a summary is to be made, this tool summarizes a thematic or continuous attribute field in another polygon dataset and writes the results to the attribute table of the zonal polygon dataset. Examples of zonal polygon data include sampling plots, counties, school catchment areas, watershed, etc. The other polygon data contains the data in an attribute field. Examples of continuous data include soil pH in a soils dataset or population size in a census dataset. Examples of thematic (categorical or ordinal) data include landcover code or zoning code.

For continuous data this tool creates a statistical summary of the field including the area-weighted mean (AWM), minimum (MIN), and maximum (MAX). For thematic data, the tool reports the area of each category present in the zonal polygon. Because the tool cannot automatically distinguish between continuous and thematic data, you must use the 'thematic' parameter if you wish to obtain the thematic summary; by default the tool assumes that the field represents continuous data. For thematic summaries you also have the option of reporting the proportion of the zonal polygon occupied by each category rather than the area (see the 'proportion' parameter).

Syntax

isectpolypoly(in, poly, field, prefix, [thematic], [proportion], [where]);

inthe input zonal polygon data source
polythe polygon data source containing the quantitative data to summarize
fieldthe field in this second polygon layer to process
prefixa short prefix to use in the summary statistic fields that are added, which end with AWM, MIN, MAX for continuous data, and V# for thematic data where # is each of the unique values. The prefix should be no longer than 6 characters.
[thematic](TRUE/FALSE) controls whether the polygon data should be treated as thematic (categorical) (default=FALSE)
[proportion](TRUE/FALSE) only applies to thematic data: records the proportion of the polygon in each unique value instead of the area of the polygon (default=FALSE)
[where]the filter/selection statement that will be applied to the first ('in', not 'poly') polygon feature class to identify a subset of polygons to process

Example

isectpolypoly(in="C:\data\fields.shp", poly="C:\data\soils.shp", field="SOILTYPE", prefix="SOIL", thematic=TRUE);

isectpolypoly(in="C:\data\plots.shp", poly="C:\data\lcov.shp", field="LANDCOVER", thematic=TRUE, proportion=TRUE);

isectpolypoly(in="C:\data\counties.shp", poly="C:\data\census.shp", field="POPSIZE");


Messages

Please consider making a purchase to support the continued development of these tools  Read more...

An apology for failing to respond to correspondence in recent months  Read more...

Tips on how to use this interface efficiently  Read more...

Sign up for the newsletter if you wish to receive notification of updates, new functionality, bug fixes, and other related news

Links

Open Source GIS

Copyright © 2001-2010 Hawthorne L. Beyer, Spatial Ecology LLC