Multipoint

Zusammenfassung

Multipoint objects are ordered collection of points.

Beschreibung

Bei vielen Workflows der Geoverarbeitung möchten Sie eventuell bestimmte Vorgänge mit Koordinaten- und Geometriedaten ausführen, jedoch nicht unbedingt eine neue (temporäre) Feature-Class erstellen, diese mit Cursorn füllen, die Feature-Class verwenden und dann die vorläufige Feature-Class wieder löschen. Sie können anstelle von Eingabe und Ausgabe auch Geometrieobjekte verwenden und so die Geoverarbeitung vereinfachen. Geometrieobjekte können von Grund auf neu mit Geometry-, Multipoint-, PointGeometry-, Polygon- oder Polyline-Classes erstellt werden.

Syntax

Multipoint (inputs, {spatialReference}, {hasZ}, {hasM})

Parameter	Erläuterung	Datentyp
inputs	The coordinates used to create the object. The datatype can be either Point or Array objects.	Object
spatialReference	The spatial reference of the new geometry. (Der Standardwert ist None)	SpatialReference
hasZ	The Z state: True for geometry if Z is enabled and False if it is not. (Der Standardwert ist False)	Boolean
hasM	The M state: True for geometry if M is enabled and False if it is not. (Der Standardwert ist False)	Boolean

Eigenschaften

Eigenschaft	Erläuterung	Datentyp
area (Nur lesen)	The area of a polygon feature. Empty for all other feature types.	Double
centroid (Nur lesen)	The true centroid if it is within or on the feature; otherwise, the label point is returned. Returns a point object.	Point
extent (Nur lesen)	The extent of the geometry.	Extent
firstPoint (Nur lesen)	The first coordinate point of the geometry.	Point
hullRectangle (Nur lesen)	A space-delimited string of the coordinate pairs of the convex hull rectangle.	String
isMultipart (Nur lesen)	True, if the number of parts for this geometry is more than one.	Boolean
labelPoint (Nur lesen)	The point at which the label is located. The labelPoint is always located within or on a feature.	Point
lastPoint (Nur lesen)	The last coordinate of the feature.	Point
length (Nur lesen)	The length of the linear feature. Zero for point, multipoint feature types.	Double
partCount (Nur lesen)	The number of geometry parts for the feature.	Integer
pointCount (Nur lesen)	The total number of points for the feature.	Integer
trueCentroid (Nur lesen)	The center of gravity for a feature.	Point
type (Nur lesen)	The geometry type: polygon, polyline, point, multipoint, multipatch, dimension, annotation.	String

Methodenübersicht

Methode	Erläuterung
contains (second_geometry)	Gibt an, ob die Basisgeometrie die Vergleichsgeometrie enthält. contains ist das Gegenteil von within. Only True relationships are shown in this illustration.
crosses (second_geometry)	Gibt an, ob die beiden Geometrien sich in einer Geometrie mit einem geringeren Shape-Typ überschneiden. Zwei Polylinien kreuzen sich, wenn sie nur Punkte gemeinsam haben, von denen mindestens einer kein Endpunkt ist. Eine Polylinie und ein Polygon kreuzen sich, wenn sie im Inneren des Polygons eine Polylinie oder einen Punkt (für eine vertikale Linie) gemeinsam haben, die bzw. der nicht der gesamten Polylinie entspricht. Only True relationships are shown in this illustration.
disjoint (second_geometry)	Gibt an, ob die Basis- und die Vergleichsgeometrie keine gemeinsamen Punkte aufweisen. Zwei Geometrien überschneiden sich, wenn disjoint den Wert False zurückgibt. Only True relationships are shown in this illustration.
equals (second_geometry)	Indicates if the base and comparison geometries are of the same shape type and define the same set of points in the plane. This is a 2D comparison only; M and Z values are ignored. Only True relationships are shown in this illustration.
getPart ({index})	Returns an array of point objects for a particular part of geometry or an array containing a number of arrays, one for each part.
overlaps (second_geometry)	Gibt an, üb die Überschneidung der beiden Geometrien denselben Shape-Typ wie eine der Eingabegeometrien aufweist, aber keiner der Eingabegeometrien entspricht. Only True relationships are shown in this illustration.
touches (second_geometry)	Gibt an, ob sich die Grenzen der Geometrien überschneiden. Zwei Geometrien berühren sich, wenn die Schnittmenge der Geometrien nicht leer, die Schnittmengen der Innenbereiche jedoch leer ist. Ein Punkt berührt beispielsweise eine Polylinie nur, wenn der Punkt lagegleich mit einem der Endpunkte der Polylinie ist. Only True relationships are shown in this illustration.
within (second_geometry)	Gibt an, ob sich die Basisgeometrie innerhalb der Vergleichsgeometrie befindet. Der within-Operator stellt das Gegenteil von contains dar. Only True relationships are shown in this illustration.

Methoden

contains (second_geometry)

Parameter	Erläuterung	Datentyp
second_geometry	A second geometry.	Object

Rückgabewert

Datentyp	Erläuterung
Boolean	Der boolesche Rückgabetyp True gibt an, dass diese Geometrie die zweite Geometrie enthält.

crosses (second_geometry)

Parameter	Erläuterung	Datentyp
second_geometry	A second geometry.	Object

Rückgabewert

Datentyp	Erläuterung
Boolean	Der boolesche Rückgabetyp "True" gibt an, dass sich die beiden Geometrien in einer Geometrie mit einem geringeren Shape-Typ schneiden.

disjoint (second_geometry)

Parameter	Erläuterung	Datentyp
second_geometry	A second geometry.	Object

Rückgabewert

Datentyp	Erläuterung
Boolean	Der boolesche Rückgabetyp "True" gibt an, dass die beiden Geometrien keine gemeinsamen Punkte aufweisen.

equals (second_geometry)

Parameter	Erläuterung	Datentyp
second_geometry	A second geometry.	Object

Rückgabewert

Datentyp	Erläuterung
Boolean	A return Boolean value of True indicates that the two geometries are of the same shape type and define the same set of points in the plane.

getPart ({index})

Parameter	Erläuterung	Datentyp
index	The index position of the geometry.	Integer

Rückgabewert

Datentyp	Erläuterung
Array	getPart returns an array of point objects for a particular part of the geometry if an index is specified. If an index is not specified, an array containing an array of point objects for each geometry part is returned.

overlaps (second_geometry)

Parameter	Erläuterung	Datentyp
second_geometry	A second geometry.	Object

Rückgabewert

Datentyp	Erläuterung
Boolean	Der boolesche Rückgabetyp True gibt an, dass die Überschneidung der beiden Geometrien dieselbe Dimension wie eine der Eingabegeometrien aufweist.

touches (second_geometry)

Parameter	Erläuterung	Datentyp
second_geometry	A second geometry.	Object

Rückgabewert

Datentyp	Erläuterung
Boolean	Der boolesche Rückgabetyp True gibt an, dass sich die Grenzen der Geometrien überschneiden.

within (second_geometry)

Parameter	Erläuterung	Datentyp
second_geometry	A second geometry.	Object

Rückgabewert

Datentyp	Erläuterung
Boolean	Der boolesche Rückgabetyp True gibt an, dass diese Geometrie in der zweiten Geometrie enthalten ist.

Codebeispiel

Multipoint example

Create a polyline feature class from scratch.

import arcpy

# A list of features and coordinate pairs
#
coordList = [[[1,2], [2,4], [3,7]],
            [[6,8], [5,7], [7,2], [9,5]]]

# Create empty Point and Array objects
#
point = arcpy.Point()
array = arcpy.Array()

# A list that will hold each of the Multipoint objects 
# 
featureList = []

for feature in coordList:
    # For each coordinate pair, set the x,y properties and add to the 
    #  Array object.
    #
    for coordPair in feature:
        point.X = coordPair[0]
        point.Y = coordPair[1]
        array.add(point)

    # Create a Multipoint object based on the array of points
    #
    multiPoint = arcpy.Multipoint(array)

    # Clear the array for future use
    #
    array.removeAll()

    # Append to the list of Multipoint objects
    #
    featureList.append(multiPoint)

# Create a copy of the Multipoint objects, by using featureList as input to 
#  the CopyFeatures tool.
#
arcpy.CopyFeatures_management(featureList, "c:/geometry/multipoints.shp")