GetMergedArea()

Summary

Creates an area by merging a set of features.

 

Syntax

merged_area = GetMergedArea(string layer_set, array options)

 

Argument	Contents
layer_set	Name of the input layer or selection set

 

Option	Type	Contents
Progress Message	String	A progress message to display

 

Returns

An array of three elements:

 

Element	Type	Contents
n_polygons	Integer	Number of polygons in the merged area
n_points_array	Array	Array of integers containing the number of points in each polygon
coords	Array	The complete array of coordinates that define the area. The coordinates appear polygon by polygon, and the first coordinate of each polygon is repeated at the end of the polygon

 

Notes

• GetMergedArea() returns coordinates for a new area that removes common boundaries between adjacent areas.

• GetMergedArea() does not make any changes to the input layer.

• If the input layer or selection set consists of line features, GetMergedArea() produces the largest area defined by those features.

• The input layer or selection set must contain line or area features.

Example

// Before running the example, create a map by opening nesouth.cdf

// in the Tutorial folder.

merged_area = GetMergedArea("County", {{"Progress Message", "Building area"}})

ShowArray(merged_area)

 

Error Codes

Error Type	Meaning
Error	The set or layer name is invalid, or the set or layer does not contain geographic features
NotFound	The input set or layer does not exist or the set is empty

 

See Also

Function	Summary
MergeByValue()	Creates districts by merging areas from a geographic file, based on the value of a field