Markerplatzierung in Punkte konvertieren (Cartography Tools)

Zusammenfassung

Erstellt Punkte aus den Markern einer Markerplatzierung in einem symbolisierten Polygon-Feature.

Abbildung

Verwendung

Dieses Werkzeug bewertet Grafikkonflikte bei symbolisierten Features, um zu bestimmen, welche Marker in der Ausgabe berücksichtigt werden. Es wird sowohl die Ausdehnung der Symbole als auch der Bezugsmaßstab verwendet. Führen Sie dieses Werkzeug erst aus, nachdem Sie das Aussehen der Symbole endgültig festgelegt haben, und stellen Sie sicher, dass der Bezugsmaßstab dem beabsichtigten endgültigen Ausgabemaßstab entspricht.
Das Standardkoordinatensystem der Ausgabe entspricht der aktuellen Kartenansicht. Verwenden Sie zum Ändern des Koordinatensystems die Umgebungseinstellung "Kartografisches Koordinatensystem". Wenn das Werkzeug in einer Skriptumgebung ohne aktive Karte ausgeführt wird, wird das Koordinatensystem der Eingabe-Features verwendet.
Im Eingabe-Layer werden nur die Optionen "Einzelsymbol" und "Einzelwertsymbolisierung" unterstützt. Die im Eingabe-Layer gespeicherten Einstellungen für die Attributzuordnung werden berücksichtigt.
Wenn der Parameter** Mindestens einen Marker beibehalten** angegeben ist, wird eine Protokolldatei erstellt, in der die Eingabe-Features aufgeführt sind, für die ein einzelner Marker erstellt wurde, der andernfalls ausgelassen worden wäre. Der Speicherort der Protokolldatei ist in den Details der Geoverarbeitungsmeldung angegeben.
Punkte werden für alle unterstützten Marker-Layer in einem Eingabesymbol erstellt. Um sicherzustellen, dass komplexe Multilayer-Marker als eine einzelne Entität behandelt und als ein einzelner Punkt in der Ausgabe erstellt werden, erstellen Sie zunächst das Symbol als Punktsymbol, und speichern Sie es in einem Style. Verwenden Sie dann auf der Registerkarte Layer im Bereich Symbolisierung die Schaltfläche Style in den Einstellungen für Aussehen, um das Markersymbol aus dem Style festzulegen.
Die Parameter Versatzmethode und Minimale Markerentfernung sind verfügbar, wenn in mindestens einem Marker-Layer eine Platzierung nach dem Zufallsprinzip verwendet wird. Verwenden Sie diese Parameter, um Konflikte zwischen überlappenden Markern zu lösen und eine minimale Entfernung zwischen ihnen aufrechtzuerhalten. Mit der Option Voneinander weg verschieben werden Marker voneinander weg bewegt, bis sie die minimale Entfernung zueinander erreicht haben, und Marker werden bei Bedarf entfernt, um Konflikte zu vermeiden. Mit der Option Zum Gitternetz verschieben werden Marker verschoben, bis entweder die minimale Entfernung zueinander oder ihre ursprüngliche Platzierung im Gitternetz erreicht ist. Bei der Option Zum Gitternetz verschieben werden keine Marker entfernt.

Beschriftung	Erläuterung	Datentyp
Eingabe-Layer	Mit einer Markerplatzierung symbolisierter Polygon-Layer.	Layer
Ausgabe-Feature-Class	Eine Point-Feature-Class mit Punkten, die aus Markern in den Einstellungen für die Markerplatzierung des Eingabe-Layers erstellt wurden. Die Punkte werden der aktiven Karte als Layer hinzugefügt, der unter Verwendung der Symbole aus der Eingabe mit einem Einzelwert-Renderer symbolisiert wird.	Feature Class
Multipoints erstellen (Optional)	Gibt an, ob Ausgabepunkt-Features als Multipoint-Features erstellt werden. Aktiviert—Für die Marker in jedem Eingabe-Polygon wird ein Multipoint-Feature erstellt. Dies ist die Standardeinstellung. Deaktiviert—Für jeden Marker wird ein Punkt-Feature erstellt.	Boolean
Grenzoption (Optional)	Gibt an, ob für Eingabe-Marker, die Polygongrenzen kreuzen, Ausgabepunkte erstellt werden. Grenze kann gekreuzt werden—Für Eingabe-Marker, die Polygongrenzen kreuzen, werden Ausgabepunkte erstellt. Dies ist die Standardeinstellung. Feste Entfernung—Für Eingabe-Marker, die sich innerhalb der Entfernung der Polygongrenzen befinden, die mit dem Parameter Grenzentfernung festgelegt wurde, werden keine Ausgabepunkte erstellt. Wert aus Feld—Für Eingabe-Marker, die sich innerhalb der Entfernung der Polygongrenzen befinden, die mit dem Parameter Feld für Grenzentfernung festgelegt wurde, werden keine Ausgabepunkte erstellt.	String
Grenzentfernung (Optional)	Die minimale Entfernung zwischen den Ausgabepunktsymbolen und den Polygongrenzen. Dieser Parameter wird nur angewendet, wenn der Parameter Grenzoption auf Feste Entfernung festgelegt ist. Der Standardwert ist 0.	Double
Feld für Grenzentfernung (Optional)	Ein numerisches Feld von den Eingabe-Polygonen, das zur Bestimmung der Grenzentfernung verwendet wird. Dieser Parameter wird nur angewendet, wenn der Parameter Grenzoption auf Von-Wertefeld festgelegt ist.	Field
Einheit für Grenzentfernung (Optional)	Gibt die lineare Einheit an, die für die Grenzentfernungswerte verwendet wird. Kilometer—Die Einheit ist Kilometer. Meter—Die Einheit ist Meter. Dezimeter—Die Einheit ist Dezimeter. Zentimeter—Die Einheit ist Zentimeter. Millimeter—Die Einheit ist Millimeter. Seemeilen—Die Einheit ist Seemeilen. Meilen (Britisch)—Die Einheit ist Meilen (Britisch). Yard—Die Einheit ist Yards. Fuß—Die Einheit ist Fuß. Fuß (US Survey)—Die Einheit ist Fuß (US Survey). Zoll—Die Einheit ist Zoll. Grad—Die Einheit ist Grad. Punkte—Die Einheit ist Punkte. Dies ist die Standardeinstellung.	String
Eingabe-Barriere-Layer (Optional)	Die Layer mit den Punkten, Linien oder Polygon-Features, die Konfliktbarrieren für Eingabe-Marker darstellen. Marker, die mit Barrieren in Konflikt stehen, werden nicht erstellt. Die Symbolisierung der Barriere-Layer wird berücksichtigt. Spalten der Wertetabelle: Barrier Layer—A layer containing points, lines, or polygon features. Barrier Distance—A numeric value specifying the minimum distance between markers and the barrier. This will be ignored if the barrier distance field value is set. The default value is 0. Barrier Distance Field—A numerical field from the barrier layer that will be used as the barrier distance. This will override the barrier distance value. The default value is none. Barrier Distance Unit—The linear unit that will be used for barrier distance values. Kilometers—The unit will be kilometers. Meters—The unit will be meters. Decimeters—The unit will be decimeters. Centimeters—The unit will be centimeters. Millimeters—The unit will be millimeters. Nautical Miles—The unit will be nautical miles. Statute Miles—The unit will be statute miles. Yards—The unit will be yards. Feet—The unit will be feet. Inches—The unit will be inches. Degrees—The unit will be degrees. Points—The unit will be points. This is the default.	Value Table
Mindestens einen Marker beibehalten (Optional)	Gibt an, ob für Eingabe-Polygone ein einzelner Marker erstellt wird, wenn alle Marker mit Grenzen oder Barrieren in Konflikt stehen. Aktiviert—Wenn alle Marker mit Grenzen oder Barrieren in Konflikt stehen, wird ein Marker für Eingabe-Polygone erstellt. Deaktiviert—Wenn alle Marker mit Grenzen oder Barrieren in Konflikt stehen, werden keine Marker für Eingabe-Polygone erstellt. Dies ist die Standardeinstellung.	Boolean
Versatzmethode (Optional)	Gibt die Versatzmethode an, die zum Verschieben von Markern verwendet wird, die zu eng beieinander liegen. Dieser Parameter wird nur angewendet, wenn Marker nach dem Zufallsprinzip in den Polygonen positioniert werden. Nicht verschieben—Marker werden nicht verschoben. Dies ist die Standardeinstellung. Zum Gitternetz verschieben—Konfliktverursachende Marker werden in Richtung ihrer ursprünglichen regulären Gitternetzpunkte verschoben. Voneinander weg verschieben—Konfliktverursachende Marker werden voneinander weg verschoben.	String
Minimale Markerentfernung (Optional)	Die minimale Entfernung zwischen einzelnen Markern. Dieser Parameter wird nur angewendet, wenn Marker nach dem Zufallsprinzip in den Polygonen positioniert werden. Der Standardwert ist 0.	Linear Unit

arcpy.cartography.ConvertMarkerPlacementToPoints(in_layer, out_feature_class, {create_multipoints}, {boundary_option}, {boundary_distance}, {boundary_distance_field}, {boundary_distance_unit}, {in_barriers}, {keep_at_least_one_marker}, {displacement_method}, {minimum_marker_distance})

Name	Erläuterung	Datentyp
in_layer	Mit einer Markerplatzierung symbolisierter Polygon-Layer.	Layer
out_feature_class	Eine Point-Feature-Class mit Punkten, die aus Markern in den Einstellungen für die Markerplatzierung des Eingabe-Layers erstellt wurden. Die Punkte werden der aktiven Karte als Layer hinzugefügt, der unter Verwendung der Symbole aus der Eingabe mit einem Einzelwert-Renderer symbolisiert wird.	Feature Class
create_multipoints (Optional)	Gibt an, ob Ausgabepunkt-Features als Multipoint-Features erstellt werden. `CREATE_MULTIPOINTS`—Für die Marker in jedem Eingabe-Polygon wird ein Multipoint-Feature erstellt. Dies ist die Standardeinstellung. `CREATE_POINTS`—Für jeden Marker wird ein Punkt-Feature erstellt.	Boolean
boundary_option (Optional)	Gibt an, ob für Eingabe-Marker, die Polygongrenzen kreuzen, Ausgabepunkte erstellt werden. `MAY_CROSS_BOUNDARY`—Für Eingabe-Marker, die Polygongrenzen kreuzen, werden Ausgabepunkte erstellt. Dies ist die Standardeinstellung. `FIXED_DISTANCE`—Für Eingabe-Marker, die sich innerhalb der Entfernung der Polygongrenzen befinden, die mit dem Parameter `boundary_distance` festgelegt wurde, werden keine Ausgabepunkte erstellt. `VALUE_FROM_FIELD`—Für Eingabe-Marker, die sich innerhalb der Entfernung der Polygongrenzen befinden, die mit dem Parameter `boundary_distance_field` festgelegt wurde, werden keine Ausgabepunkte erstellt.	String
boundary_distance (Optional)	Die minimale Entfernung zwischen den Ausgabepunktsymbolen und den Polygongrenzen. Dieser Parameter wird nur angewendet, wenn der Parameter `boundary_option` auf `FIXED_DISTANCE` festgelegt ist. Der Standardwert ist 0.	Double
boundary_distance_field (Optional)	Ein numerisches Feld von den Eingabe-Polygonen, das zur Bestimmung der Grenzentfernung verwendet wird. Dieser Parameter wird nur angewendet, wenn der Parameter `boundary_option` auf `VALUE_FROM_FIELD` festgelegt ist.	Field
boundary_distance_unit (Optional)	Gibt die lineare Einheit an, die für die Grenzentfernungswerte verwendet wird. `Kilometers`—Die Einheit ist Kilometer. `Meters`—Die Einheit ist Meter. `Decimeters`—Die Einheit ist Dezimeter. `Centimeters`—Die Einheit ist Zentimeter. `Millimeters`—Die Einheit ist Millimeter. `Nautical Miles`—Die Einheit ist Seemeilen. `Statute Miles`—Die Einheit ist Meilen (Britisch). `Yards`—Die Einheit ist Yards. `Feet`—Die Einheit ist Fuß. `US Survey Feet`—Die Einheit ist Fuß (US Survey). `Inches`—Die Einheit ist Zoll. `Degrees`—Die Einheit ist Grad. `Points`—Die Einheit ist Punkte. Dies ist die Standardeinstellung.	String
in_barriers [[barrier_layer, {barrier_distance}, {barrier_distance_field}, {barrier_distance_unit}],...] (Optional)	Die Layer mit den Punkten, Linien oder Polygon-Features, die Konfliktbarrieren für Eingabe-Marker darstellen. Marker, die mit Barrieren in Konflikt stehen, werden nicht erstellt. Die Symbolisierung der Barriere-Layer wird berücksichtigt. Spalten der Wertetabelle: `Barrier Layer`—A layer containing points, lines, or polygon features. `Barrier Distance`—A numeric value specifying the minimum distance between markers and the barrier. This will be ignored if the barrier distance field value is set. The default value is 0. `Barrier Distance Field`—A numerical field from the barrier layer that will be used as the barrier distance. This will override the barrier distance value. The default value is none. `Barrier Distance Unit`—The linear unit that will be used for barrier distance values. `Kilometers`—The unit will be kilometers. `Meters`—The unit will be meters. `Decimeters`—The unit will be decimeters. `Centimeters`—The unit will be centimeters. `Millimeters`—The unit will be millimeters. `NauticalMiles`—The unit will be nautical miles. `StatuteMiles`—The unit will be statute miles. `Yards`—The unit will be yards. `Feet`—The unit will be feet. `Inches`—The unit will be inches. `Degrees`—The unit will be degrees. `Points`—The unit will be points. This is the default.	Value Table
keep_at_least_one_marker (Optional)	Gibt an, ob für Eingabe-Polygone ein einzelner Marker erstellt wird, wenn alle Marker mit Grenzen oder Barrieren in Konflikt stehen. `KEEP_AT_LEAST_ONE_MARKER`—Wenn alle Marker mit Grenzen oder Barrieren in Konflikt stehen, wird ein Marker für Eingabe-Polygone erstellt. `DO_NOT_KEEP_AT_LEAST_ONE_MARKER`—Wenn alle Marker mit Grenzen oder Barrieren in Konflikt stehen, werden keine Marker für Eingabe-Polygone erstellt. Dies ist die Standardeinstellung.	Boolean
displacement_method (Optional)	Gibt die Versatzmethode an, die zum Verschieben von Markern verwendet wird, die zu eng beieinander liegen. Dieser Parameter wird nur angewendet, wenn Marker nach dem Zufallsprinzip in den Polygonen positioniert werden. `DO_NOT_DISPLACE`—Marker werden nicht verschoben. Dies ist die Standardeinstellung. `DISPLACE_TOWARD_GRID`—Konfliktverursachende Marker werden in Richtung ihrer ursprünglichen regulären Gitternetzpunkte verschoben. `DISPLACE_APART`—Konfliktverursachende Marker werden voneinander weg verschoben.	String
minimum_marker_distance (Optional)	Die minimale Entfernung zwischen einzelnen Markern. Dieser Parameter wird nur angewendet, wenn Marker nach dem Zufallsprinzip in den Polygonen positioniert werden. Der Standardwert ist 0.	Linear Unit

Codebeispiel

ConvertMarkerPlacementToPoints: Beispiel 1 (Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion ConvertMarkerPlacementToPoints im Direkt-Modus verwendet wird.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.env.referenceScale = 5000
arcpy.cartography.ConvertMarkerPlacementToPoints("parks.lyrx", "cartography.gdb/tree_markers")

ConvertMarkerPlacementToPoints: Beispiel 2 (eigenständiges Skript)

Dieses eigenständige Skript stellt ein Beispiel für die Verwendung der Funktion ConvertMarkerPlacementToPoints dar.

# Name: ConvertMarkerPlacementToPoints_standalone_script.py
# Description: Converts markers in a marker placement into point features.

# Import system modules
import arcpy
from arcpy import env

# Set environment settings
env.workspace = "C:/data"
env.referenceScale = "5000"

# Set local variables
in_layer = "parks.lyrx"
out_feature_class = "cartography.gdb/tree_markers"
create_multipoints = "CREATE_MULTIPOINTS"
boundary_option = "VALUE_FROM_FIELD"
boundary_distance = ""
boundary_distance_field = "distance"
boundary_distance_unit = "Points"
in_barriers = [["roads.lyrx", 1, "", "Points"],["rivers.lyrx", 0, "distance", "Points"]]
keep_at_least_one_marker = "KEEP_AT_LEAST_ONE_MARKER"
displacement_method = "DISPLACE_APART"
minimum_marker_distance = "2 Points"

arcpy.cartography.ConvertMarkerPlacementToPoints(in_layer,
                                                 out_feature_class,
                                                 create_multipoints,
                                                 boundary_option,
                                                 boundary_distance,
                                                 boundary_distance_field,
                                                 boundary_distance_unit,
                                                 in_barriers,
                                                 keep_at_least_one_marker,
                                                 displacement_method,
                                                 minimum_marker_distance
)

Umgebungen

Kartografisches Koordinatensystem, Bezugsmaßstab

Lizenzierungsinformationen

Basic: Nein
Standard: Nein
Advanced: Ja