Zufällige Punkte erstellen (Data Management)

Zusammenfassung

Erstellt eine bestimmte Anzahl von zufälligen Punkt-Features. Zufällige Punkte können in einem Ausdehnungsfenster, in Polygon-Features, auf Punkt-Features oder entlang von Linien-Features erstellt werden.

Weitere Informationen zur Funktionsweise von "Zufällige Punkte erstellen"

Verwendung

• Die Fläche, auf der die zufälligen Punkte erstellt werden, kann durch einschränkende Polygon-, Punkt- oder Linien-Features oder durch ein einschränkendes Ausdehnungsfenster definiert werden.

• Der Parameter Anzahl Punkte kann als Zahl oder als Zahlenfeld in der Feature-Class-Beschränkung mit Werten angegeben werden, die definieren, wie viele zufällige Punkte in jedem Feature zu platzieren sind. Ein Feld ist nur zulässig, wenn die einschränkenden Features (auch: Beschränkungs-Features) Polygon- oder Linien-Features sind. Wenn Sie die Anzahl von Punkten als Zahl angeben, wird in bzw. auf jedem Feature in der Feature-Class-Beschränkung die angegebene Anzahl von Punkten erstellt.

  Wenn Sie eine Feature-Class-Beschränkung verwenden, die mehr als ein Feature enthält, und Sie die Gesamtanzahl der zu erstellenden zufälligen Punkte angeben möchten (im Gegensatz zur Anzahl von zufälligen Punkten, die in jedem Feature zu platzieren sind), müssen Sie zuerst die einschränkende Feature-Class mit dem Werkzeug Zusammenführen (Dissolve) zusammenführen, sodass sie nur ein einziges Feature enthält, und dann diese zusammengeführte Feature-Class als Feature-Class-Beschränkung verwenden.

• Das Koordinatensystem der Ausgabe-Feature-Class ist das Koordinatensystem der folgenden Elemente:

  • Feature-Class-Beschränkung (falls angegeben)
  • Kartendatenrahmen, wenn eine einschränkende Ausdehnung in der Karte anhand eines Layers in der Karte oder des Pfades zu einer Feature-Class angegeben ist
  • Feature-Class, wenn eine einschränkende Ausdehnung in Python anhand des Pfades zu einer Feature-Class angegeben ist
  • Geoverarbeitungsumgebung für das Ausgabe-Koordinatensystem, falls diese festgelegt ist (und überschreibt alle anderen oben aufgeführten Verhalten)
  • Unbekannt, falls keine der oben stehenden Optionen zutreffend ist

• Um zufällig platzierten Punkten Zufallswerte zuzuweisen, erstellen Sie zunächst zufällige Punkte mit diesem Werkzeug. Erstellen Sie dann mit dem Werkzeug Feld hinzufügen in der Feature-Class mit den zufälligen Punkten ein neues Zahlenfeld. Empfohlene Feldtypen sind "Long Integer" oder "Float". Anschließend weisen Sie dem leeren Feld in der Feature-Class mit den zufälligen Punkten mit dem Werkzeug Feld berechnen Zufallswerte zu. Zum Erstellen einer zufälligen Ganzzahl zwischen a und b (einschließlich) verwenden Sie den Python-Ausdruck random.randint(a,b). Zum Erstellen einer zufälligen Gleitkommazahl zwischen a und b (ausschließlich) verwenden Sie den Python-Ausdruck random.uniform(a,b). Importieren Sie das Modul "random" mit dem Ausdruck import random in den Codeblock.

• Der Parameter Ausdehnungsbeschränkung kann mit minimalen und maximalen X- und Y-Koordinaten oder mit der Ausdehnung eines Feature-Layers bzw. einer Feature-Class angegeben werden.

• Wenn sowohl eine Feature-Class-Beschränkung als auch eine Ausdehnungsbeschränkung angegeben sind, wird die Feature-Class-Beschränkung verwendet, und der Wert der Ausdehnungsbeschränkung wird ignoriert.

• Wenn innerhalb einer Beschränkungsfläche keine zufälligen Punkte unter Einhaltung der Mindestentfernung mehr platziert werden können, wird die angegebene Anzahl der zufälligen Punkte innerhalb der Beschränkungsfläche auf die maximal mögliche Anzahl unter Einhaltung der Mindestentfernung reduziert.

• Der Parameter Mindestens zulässige Entfernung kann als lineare Einheit oder als Feld aus den einschränkenden Features mit numerischen Werten angegeben werden. Mit diesem Wert wird die kürzeste zulässige Entfernung zwischen zufälligen Punkten innerhalb der einzelnen Eingabe-Features festgelegt. Ein Feld ist nur zulässig, wenn die einschränkenden Features (auch: Beschränkungs-Features) Polygon- oder Linien-Features sind. Zufällige Punkte können innerhalb der kürzesten zulässigen Entfernung liegen, wenn sie innerhalb bzw. auf unterschiedlichen einschränkenden Feature-Teilen erstellt wurden.

• Bei Verwendung von Punkt-Features als Feature-Class-Beschränkung wird eine zufällige Teilmenge der einschränkenden Punkt-Features erstellt. Es werden keine neuen Punktpositionen erstellt.

• Positive Nicht-Ganzzahl-Werte für die Parameter Anzahl Punkte und Mindestens zulässige Entfernung werden auf die nächste ganze Zahl gerundet. Nicht numerische und negative Werte werden auf null (0) gesetzt.

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Ausgabeverzeichnis	Der Speicherort bzw. Workspace, in dem die Feature-Class mit den zufälligen Punkten erstellt wird. Dieser Speicherort bzw. Workspace muss bereits vorhanden sein.	Feature Dataset;Workspace
Ausgabe-Point-Feature-Class	Der Name der zu erstellenden Feature-Class mit den zufälligen Punkten.	String
Feature-Class-Beschränkung (optional)	Zufällige Punkte werden innerhalb bzw. auf den Features in dieser Feature-Class erstellt. Die einschränkende Feature-Class kann Punkt, Multipoint, Linie oder Polygon sein. Die Punkte werden per Zufallsprinzip innerhalb von Polygon-Features, entlang von Linien-Features oder auf Punkt-Features platziert. Für jedes Feature in dieser Feature-Class wird die angegebene Anzahl von Punkten erstellt (wenn Sie beispielsweise 100 Punkte angeben und die einschränkende Feature-Class 5 Features enthält, werden 100 zufällige Punkte in jedem Feature erstellt, also insgesamt 500 Punkte).	Feature Layer
Ausdehnungsbeschränkung (optional)	Zufällige Punkte werden innerhalb der Ausdehnung erstellt. Die Ausdehnungsbeschränkung wird nur verwendet, wenn keine Feature-Class-Beschränkung angegeben wurde. Aktuelle Anzeigeausdehnung : Die Ausdehnung basiert auf der aktiven Karte oder Szene. Diese Option ist nur verfügbar, wenn eine aktive Karte vorhanden ist. Ausdehnung darstellen : Die Ausdehnung basiert auf einem Rechteck, das auf der Karte oder Szene aufgezogen wurde. Bei dieser Option wird eine Feature-Class in der Projekt-Geodatabase erstellt und ein Layer zur Karte hinzugefügt. Das Koordinatensystem der Feature-Class stimmt mit dem der Karte überein. Hinweis: Diese Option ist im Dialogfeld Umgebungen nicht verfügbar. Sie ist nur über einen Werkzeugparameter mit dem Datentyp "Ausdehnung" oder über die Registerkarte Umgebungen eines Werkzeugdialogfeldes verfügbar. Hinweis: Wenn die Bearbeitungsoption Bearbeitung über die Registerkarte "Bearbeiten" aktivieren und deaktivieren aktiviert ist, dann müssen Sie auf der Registerkarte Bearbeiten des Menübands die Bearbeitung aktivieren, um die Ausdehnung darzustellen. Ausdehnung eines Layers: Die Ausdehnung basiert auf einem aktiven Karten-Layer. Verwenden Sie die Dropdown-Liste, um einen verfügbaren Layer auszuwählen, oder verwenden Sie die Option Ausdehnung von Daten in allen Layern, um die kombinierte Ausdehnung aller aktiven Karten-Layer mit Ausnahme der Grundkarte zu erhalten. Diese Option ist nur verfügbar, wenn eine aktive Karte mit Layern vorhanden ist. Jeder Karten-Layer bietet die folgenden Optionen: Alle Features : Die Ausdehnung aller Features im Layer. Ausgewählte Features: Die Ausdehnung der ausgewählten Features im Layer. Sichtbare Features : Die Ausdehnung der sichtbaren Features im Layer. Hinweis: Die Ausdehnungen der Optionen Ausgewählte Features und Sichtbare Features sind nur für Feature-Layer verfügbar. Durchsuchen: Die Ausdehnung basiert auf einem vorhandenen Dataset. Zwischenablage : Die Ausdehnung kann in die Zwischenablage kopiert und aus der Zwischenablage eingefügt werden. Ausdehnung kopieren : Kopiert die Ausdehnungskoordinaten und das Ausdehnungskoordinatensystem in die Zwischenablage. Ausdehnung einfügen : Fügt die Ausdehnungskoordinaten und optional das Koordinatensystem aus der Zwischenablage ein. Wenn die Werte in der Zwischenablage kein Koordinatensystem beinhalten, wird für die Ausdehnung das Koordinatensystem der Karte verwendet. Hinweis: Beim Kopieren der Ausdehnungskoordinaten in die und Einfügen aus der Zwischenablage wird dieselbe Formatierung und Reihenfolge wie beim ArcPy-Objekt Extent verwendet: X-Min, Y-Min, X-Max, Y-Max und der Raumbezug. Ausdehnung zurücksetzen: Die Ausdehnung wird auf den Standardwert zurückgesetzt. Manuell eingegebene Koordinaten: Die Koordinaten müssen numerische Werte sein und im Koordinatensystem der aktiven Karte liegen. Vorsicht: Die Karte kann statt der eingegebenen Koordinaten auch andere Anzeigeeinheiten verwenden. Die Verwendung einer Kardinalrichtung (N, S, O, W) wird nicht unterstützt. Verwenden Sie für die Koordinaten in Richtung Süden und Westen Werte mit negativem Vorzeichen.	Extent; Feature Layer; Raster Layer
Anzahl Punkte [Wert oder Feld] (optional)	Die Anzahl der zu erstellenden zufälligen Punkte. Die Anzahl von Punkten kann als Zahl vom Typ "Long Integer" oder als Feld aus den einschränkenden Features mit numerischen Werten angegeben werden, die definieren, wie viele zufällige Punkte in jedem Feature zu platzieren sind. Ein Feld ist nur zulässig, wenn die einschränkenden Features (auch: Beschränkungs-Features) Polygon- oder Linien-Features sind. Wenn Sie die Anzahl von Punkten als Zahl vom Typ "Long Integer" angeben, wird in bzw. auf jedem Feature in der Feature-Class-Beschränkung die angegebene Anzahl von Punkten erstellt.	Field; Long
Mindestens zulässige Entfernung [Wert oder Feld] (optional)	Die kürzeste Entfernung, die zwischen zwei zufällig platzierten Punkten zulässig ist. Bei Angabe von 1 Meter muss die Entfernung zwischen den zufälligen Punkten mindestens einen Meter betragen.	Field; Linear Unit
Multipoint-Ausgabe erstellen (optional)	Gibt an, ob die Ausgabe-Feature-Class ein Multipart- oder ein Singlepart-Feature ist. Deaktiviert: Der Geometrietyp der Ausgabe ist Punkt (jeder Punkt ist ein separates Feature). Dies ist die Standardeinstellung. Aktiviert: Der Geometrietyp der Ausgabe ist Multipoint (alle Punkte bilden ein einziges Feature).	Boolean
Max. Anzahl Punkte pro Multipoint (optional)	Geben Sie die Anzahl von zufälligen Punkten an, die in jeder Multipoint-Geometrie zu platzieren sind, wenn Multipoint-Ausgabe erstellen aktiviert ist.	Long

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Ausgabe-Feature-Class	Die Ausgabe-Feature-Class für zufällige Punkte.	Feature Class

Python

arcpy.management.CreateRandomPoints(out_path, out_name, {constraining_feature_class}, {constraining_extent}, {number_of_points_or_field}, {minimum_allowed_distance}, {create_multipoint_output}, {multipoint_size})

Name	Erläuterung	Datentyp
out_path	Der Speicherort bzw. Workspace, in dem die Feature-Class mit den zufälligen Punkten erstellt wird. Dieser Speicherort bzw. Workspace muss bereits vorhanden sein.	Feature Dataset;Workspace
out_name	Der Name der zu erstellenden Feature-Class mit den zufälligen Punkten.	String
constraining_feature_class (optional)	Zufällige Punkte werden innerhalb bzw. auf den Features in dieser Feature-Class erstellt. Die einschränkende Feature-Class kann Punkt, Multipoint, Linie oder Polygon sein. Die Punkte werden per Zufallsprinzip innerhalb von Polygon-Features, entlang von Linien-Features oder auf Punkt-Features platziert. Für jedes Feature in dieser Feature-Class wird die angegebene Anzahl von Punkten erstellt (wenn Sie beispielsweise 100 Punkte angeben und die einschränkende Feature-Class 5 Features enthält, werden 100 zufällige Punkte in jedem Feature erstellt, also insgesamt 500 Punkte).	Feature Layer
constraining_extent (optional)	Zufällige Punkte werden innerhalb der Ausdehnung erstellt. Die Ausdehnungsbeschränkung wird nur verwendet, wenn keine Feature-Class-Beschränkung angegeben wurde. MAXOF: Die maximale Ausdehnung aller Eingaben wird verwendet. MINOF: Die minimale gemeinsame Fläche aller Eingaben wird verwendet. DISPLAY: Die Ausdehnung entspricht der sichtbaren Anzeige. Layer-Name: Die Ausdehnung des angegebenen Layers wird verwendet. Extent-Objekt: Die Ausdehnung des angegebenen Objekts wird verwendet. Durch Leerzeichen getrennte Koordinatenzeichenfolge: Die Ausdehnung der angegebenen Zeichenfolge wird verwendet. Die Koordinaten werden in der Reihenfolge X-Min, Y-Min, X-Max, Y-Max ausgedrückt.	Extent; Feature Layer; Raster Layer
number_of_points_or_field (optional)	Die Anzahl der zu erstellenden zufälligen Punkte. Die Anzahl von Punkten kann als Zahl vom Typ "Long Integer" oder als Feld aus den einschränkenden Features mit numerischen Werten angegeben werden, die definieren, wie viele zufällige Punkte in jedem Feature zu platzieren sind. Ein Feld ist nur zulässig, wenn die einschränkenden Features (auch: Beschränkungs-Features) Polygon- oder Linien-Features sind. Wenn Sie die Anzahl von Punkten als Zahl vom Typ "Long Integer" angeben, wird in bzw. auf jedem Feature in der Feature-Class-Beschränkung die angegebene Anzahl von Punkten erstellt.	Field; Long
minimum_allowed_distance (optional)	Die kürzeste Entfernung, die zwischen zwei zufällig platzierten Punkten zulässig ist. Bei Angabe von 1 Meter muss die Entfernung zwischen den zufälligen Punkten mindestens einen Meter betragen.	Field; Linear Unit
create_multipoint_output (optional)	Gibt an, ob die Ausgabe-Feature-Class ein Multipart- oder ein Singlepart-Feature ist. POINT—Der Geometrietyp der Ausgabe ist Punkt (jeder Punkt ist ein separates Feature). Dies ist die Standardeinstellung. MULTIPOINT—Der Geometrietyp der Ausgabe ist Multipoint (alle Punkte bilden ein einziges Feature).	Boolean
multipoint_size (optional)	Geben Sie die Anzahl von zufälligen Punkten an, die in jeder Multipoint-Geometrie zu platzieren sind, wenn create_multipoint_output auf MULTIPOINT festgelegt ist. Die Standardeinstellung ist 10.	Long

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
out_feature_class	Die Ausgabe-Feature-Class für zufällige Punkte.	Feature Class

Codebeispiel

CreateRandomPoints – Beispiel 1 (Python-Fenster)

Das folgende Skript im Python-Fenster veranschaulicht, wie das Werkzeug CreateRandomPoints im unmittelbaren Modus verwendet wird.

import arcpy
arcpy.management.CreateRandomPoints("c:/data/project", "samplepoints", 
                                    "c:/data/studyarea.shp", "", 500, "", 
                                    "POINT")

CreateRandomPoints: Beispiel 2 (eigenständiges Skript)

Das folgende eigenständige Python-Skript veranschaulicht, wie Sie zufällige Punkte mit Zufallswerten erstellen.

# Name: RandomPointsRandomValues.py
# Purpose: create random points with random values

# Import system modules
import arcpy

# Create random points in the features of a constraining feature class
# Number of points for each feature determined by the value in the field 
# specified
outGDB = "C:/data/county.gdb"
outName = "randpeople"
conFC = "C:/data/county.gdb/blocks"
numField = "POP2000"
arcpy.management.CreateRandomPoints(outGDB, outName, conFC, "", numField)

# set workspace
arcpy.env.workspace = "C:/data/county.gdb"

# Create fields for random values
fieldInt = "fieldInt"
fieldFlt = "fieldFlt"
arcpy.management.AddField(outName, fieldInt, "LONG")  # add long integer field
arcpy.AddField_management(outName, fieldFlt, "FLOAT") # add float field

# Calculate random values between 1-100 in the new fields
arcpy.management.CalculateField(outName, fieldInt, "random.randint(1,100)", 
                                "PYTHON", "import random")
arcpy.management.CalculateField(outName, fieldFlt, "random.uniform(1,100)", 
                                "PYTHON", "import random")

CreateRandomPoints: Beispiel 3 (eigenständiges Skript)

Das folgende eigenständige Python-Skript veranschaulicht verschiedene Methoden zur Verwendung des Werkzeugs CreateRandomPoints.

# Name: RandomPoints.py
# Purpose: create several types of random points feature classes

# Import system modules
import arcpy

# set environment settings
arcpy.env.overwriteOutput = True

# Create random points in an extent defined simply by numbers
outFolder = "C:/data"
numExtent = "0 0 1000 1000"
numPoints = 100
outName = "myRandPnts.shp"
arcpy.env.outputCoordinateSystem = "Coordinate Systems/Projected Coordinate Systems/World/Miller Cylindrical (world).prj"
arcpy.management.CreateRandomPoints(outFolder, outName, "", numExtent, numPoints)
arcpy.env.outputCoordinateSystem = ""
 
# Create random points in an extent defined by another feature class
outName = "testpoints.shp"
fcExtent = "C:/data/studyarea.shp"
arcpy.management.CreateRandomPoints(outFolder, outName, "", fcExtent, numPoints)
 
# Create random points in the features of a constraining feature class
# Number of points for each feature determined by the value in the field specified
outGDB = "C:/data/county.gdb"
outName = "randpeople"
conFC = "C:/data/county.gdb/blocks"
numField = "POP2000"
arcpy.management.CreateRandomPoints(outGDB, outName, conFC, "", numField)

# Create random points in the features of a constraining 
# Feature class with a minimum allowed distance
outName = "constparcelpnts"
conFC = "C:/data/county.gdb/parcels"
numPoints = 10
minDistance = "5 Feet"
arcpy.management.CreateRandomPoints(outGDB, outName, conFC, "", numPoints, 
                                    minDistance) 

# Create random points with a multipoint output
outName = "randomMPs"
fcExtent = "C:/data/county.gdb/county"
numPoints = 100
numMP = 10
arcpy.management.CreateRandomPoints(outGDB, outName, "", fcExtent, numPoints, 
                                    "", "MULTIPOINT", numMP)

Umgebungen

Standard-Ausgabe-Z-Wert, M-Auflösung, M-Toleranz, Ausgabe-M-Domäne, Ausgabe-XY-Domäne, Ausgabe-Z-Domäne, Ausgabe-Koordinatensystem, Aktueller Workspace, Geographische Transformationen, Scratch-Workspace, Ausgabe hat M-Werte, Ausgabe hat Z-Werte, XY-Auflösung, XY-Toleranz, Z-Auflösung, Z-Toleranz, Zufallszahlengenerator, Ausdehnung