Open Table of Contents

Uniform Points In Polygons

Go to ToolBox Implementation Go to .NET Implementation

Generates uniform (regularly spaced) points located in the polygons of the input polygon dataset. The number of points per polygon can be constant or different for each polygon - based on the values in a numeric field of the input polygon feature class. The distance between the points is interpolated for each polygon. The user can specify the rotation angle for the resulting point grid.

Inputs:

Outputs:

Illustration:

Original polygons labeled with the values in field to be used as a source for getting the number of points to be generated and the resulting points.
Rotational angle = 0, Minimum distance to boundary = 5

uni1

Original polygons labeled with the values in field to be used as a source for getting the number of points to be generated and the resulting points.
Rotational angle = "Along the longest Axis", Minimum distance to boundary = 5
uni2
Original polygons labeled with the values in field to be used as a source for getting the number of points to be generated and the resulting points.
Rotational angle = "Along the longest side", Minimum distance to boundary = 5
uni3
50 points per polygon.
Rotational angle = "Along the longest side", Minimum distance to boundary = 0
uni4

ToolBox implementation
(Go to TOP)

Command line syntax

ET_GPUniformPointsInPolygons<input_dataset>  <out_feature_class> {number_points_field} {number_points} {min_distance} {angle_from} {rotation_angle} {angle_field}

Parameters

Expression Explanation
<input_dataset> A Polygon feature class or feature layer
<out_feature_class> A String - the full name of the output feature class.
{number_points_field} A String representing the name of a numeric field which values will be used to get the number of points to be generated per polygon.
{number_points} A Double representing the number of points for to be created in each polygons (the same for all polygons)
{min_distance} A Double specifying the minimum distance from boundary.
{angle_from} A String defining how the rotation angle will be specified
  • "Constant" - Constant for all polygons - (in degrees starting from East anti-clockwise)
  • "From field" - different rotation angle for each field (in degrees starting from East anti-clockwise)
  • "Longest Axis" - Along the longest axis of each polygon
  • "Longest Side" - Along the longest side of each polygon
{rotation_angle} A Double - specifying the rotation angle for all polygons.
{angle_field} A String - the name of the field to be used as source for rotation angle.

Scripting syntax

ET_GPUniformPointsInPolygons(input_dataset,  out_feature_class, number_points_field, number_points, min_distance, angle_from, rotation_angle, angle_field)

See the explanations above:
<> - required parameter
{} - optional parameter

.NET implementation
(Go to TOP)

UniformPointsInPolygons(pInFC As IFeatureClass, sOutFName As String, sAngleFrom As String, Optional iNumberPoints As Integer = 0, Optional sNumberPointsField As String = "", Optional dAngle As Double = 0, Optional sAngleField As String = "", Optional dMinDistanceToBoundary As Double = 0) As IFeatureClass

Copyright Ianko Tchoukanski