Symbolisierung aus Layer anwenden (Data Management Tools)

Zusammenfassung

Wendet die Symbolisierung eines angegebenen Layers oder einer angegebenen Layer-Datei auf den Eingabe-Layer an. Das Werkzeug kann auf Feature-, Raster-, Netzwerkanalyse-, TIN- und geostatistische Layer angewendet werden.

Abbildung

Abbildung: Werkzeug "Symbolisierung aus Layer anwenden"

Verwendung

Der Symbolisierungs-Layer muss mit dem Datentyp des Eingabe-Layers übereinstimmen. Es ist z. B. nicht möglich, einen Feature-Layer auf einen Raster-Layer (oder umgekehrt) anzuwenden.
Ebenso kann die Symbolisierung nur auf Features mit identischer Geometrie angewendet werden. Es ist also nicht möglich, eine Punktsymbolisierung auf einen Polygon-Layer anzuwenden.
Zusätzlich zur Symbolisierung überträgt das Werkzeug das Zeitfeld, 3D-Höhe und -Versatz, die Beschriftungsklasse und HTML-Pop-up-Eigenschaften.
Wenn es sich bei der Eingabe um eine Feature-Class oder einen Dataset-Pfad handelt, wird von diesem Werkzeug ein neuer Layer erstellt und mit dem Ergebnis des angewendeten Werkzeugs zurückgegeben.
Sie können die Symbolisierungsbereiche beibehalten oder mit dem Parameter Symbolisierungsbereiche nach Daten aktualisieren aktualisieren. Die Standardsymbolisierungsmethoden sind dynamisch. Wird beispielsweise die fünfklassige Klassifizierungsmethode "Natürliche Unterbrechungen" aus dem Symbolisierungs-Layer auf den Eingabe-Layer angewendet, werden die Bereichswerte aktualisiert, um die Shape_Area-Werte des Eingabe-Layers widerzuspiegeln. Die Option Bereiche beibehalten verwendet dieselben Werte wie der Symbolisierungs-Layer. Bei der Option Bereiche aktualisieren wird die fünfklassige Klassifizierungsmethode "Natürliche Unterbrechungen" aus dem Feld Shape_Area des Eingabe-Layers verwendet.

Die folgenden Methoden sind dynamisch:
- Einzelwertsymbolisierung zu einem Feature
  - Die Einzelwerte werden aktualisiert, um die Werte des Eingabe-Layers widerzuspiegeln.
  - Wenn Sie nicht möchten, dass die Einzelwertklassifizierung aktualisiert wird, können Sie das Standardsymbol <all other values> im Symbolisierungs-Layer auswählen.
- Symbolisierung "Abgestufte Farben" zu einem Feature
  - Die Bereichswerte werden auf die Werte des Eingabe-Layers aktualisiert.
  - Wenn Sie nicht möchten, dass die Ausgabe des Bereichs aktualisiert wird, können Sie die manuelle Klassifizierung auswählen.
- Wert-Rendering "Klassifiziert" zu einem Raster
  - Die Bereichswerte werden aktualisiert, um die Werte des Eingabe-Layers widerzuspiegeln.
  - Wenn Sie nicht möchten, dass die Ausgabe des Bereichs aktualisiert wird, können Sie die manuelle Klassifizierung auswählen.
Wird der Parameter Symbolisierungsbereiche nach Daten aktualisieren auf Bereiche beibehalten gesetzt, werden die Beschriftungen aus dem Wert Symbolisierungs-Layer in den Wert Eingabe-Layer kopiert. Falls der Parameter auf Bereiche aktualisieren gesetzt wird, werden die Beschriftungen neu berechnet.
Die Symbolisierung besteht nur solange der Layer vorhanden ist. Ein Layer kann beibehalten werden, indem die ArcGIS Pro-Sitzung gespeichert wird oder indem er unter Verwendung des Werkzeugs In Layer-Datei speichern in eine Layer-Datei gespeichert wird.

Damit die in einem Skriptwerkzeug erstellte Symbolisierung angezeigt werden kann, muss das Werkzeug den Layer als abgeleiteten Ausgabeparameter enthalten. Dementsprechend muss der Wert des Parameters Aktualisierter Eingabe-Layer als abgeleiteter Modellparameter in einem Modellwerkzeug hinzugefügt werden, um die Änderungen der Symbolisierung anzuzeigen.

Beschriftung	Erläuterung	Datentyp
Eingabe-Layer	Der Layer, auf den die Symbolisierung angewendet wird.	Feature Layer; Raster Layer; Layer
Symbolisierungs-Layer	Der Layer, der die Symbolisierung enthält, wird dann auf den Eingabe-Layer angewendet. Sowohl `.lyrx`- als auch `.lyr`-Dateien werden unterstützt.	Layer
Symbolisierungsfelder (Optional)	Die Felder aus dem Eingabe-Layer, die mit den Symbolisierungsfeldern übereinstimmen, die im Symbolisierungs-Layer verwendet werden. Spalten der Wertetabelle: Type—Specifies whether the field is the symbology value field, normalization field, or other type. Value field—The field will be used as the primary field to symbolize values. Normalization field—The field will be used to normalize quantitative values. Exclusion clause field—The field will be used for the symbology exclusion clause. Chart renderer pie size field—The field will be used to set the size of pie chart symbols. Rotation X expression field—The field will be used to set the rotation of symbols on the x-axis. Rotation Y expression field—The field will be used to set the rotation of symbols on the y-axis. Rotation Z expression field—The field will be used to set the rotation of symbols on the z-axis. Transparency expression field—The field will be used to set the transparency of symbols Transparency normalization field—The field will be used to normalize transparency values. Size expression field—The field will be used to set the size or width of symbols. Color expression field—The field will be used to set the color of symbols. Primitive override expression field—The field will be used to set various properties on individual symbol layers. Source Field—The symbology field used in the symbology layer. Use "#" if you do not know the source field and want the system default to be used. Target Field—The field from the input layer to use when applying the symbology.	Value Table
Symbolisierungsbereiche nach Daten aktualisieren (Optional)	Gibt an, ob Symbolisierungsbereiche aktualisiert werden. Standard—Symbolisierungsbereiche werden aktualisiert, außer unter den folgenden Bedingungen: Der Eingabe-Layer ist leer, der Symbolisierungs-Layer verwendet Klassengrenzen (z. B. abgestufte Farben oder abgestufte Symbole) und die Klassifizierungsmethode ist "Manuell" oder "Definiertes Intervall", oder der Symbolisierungs-Layer verwendet Einzelwerte und die Option Alle anderen Werte anzeigen ist aktiviert. Bereiche aktualisieren—Symbolisierungsbereiche werden aktualisiert. Bereiche beibehalten—Symbolisierungsbereiche werden nicht aktualisiert, sondern beibehalten.	String

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Aktualisierter Eingabe-Layer	Der aktualisierte Eingabe-Layer.	Layer

arcpy.management.ApplySymbologyFromLayer(in_layer, in_symbology_layer, {symbology_fields}, {update_symbology})

Name	Erläuterung	Datentyp
in_layer	Der Layer, auf den die Symbolisierung angewendet wird.	Feature Layer; Raster Layer; Layer
in_symbology_layer	Der Layer, der die Symbolisierung enthält, wird dann auf den Eingabe-Layer angewendet. Sowohl `.lyrx`- als auch `.lyr`-Dateien werden unterstützt.	Layer
symbology_fields [[field_type, source_field, target_field],...] (Optional)	Die Felder aus dem Eingabe-Layer, die mit den Symbolisierungsfeldern übereinstimmen, die im Symbolisierungs-Layer verwendet werden. Spalten der Wertetabelle: `Type`—Specifies whether the field is the symbology value field, normalization field, or other type. `VALUE_FIELD`—The field will be used as the primary field to symbolize values. `NORMALIZATION_FIELD`—The field will be used to normalize quantitative values. `EXCLUSION_CLAUSE_FIELD`—The field will be used for the symbology exclusion clause. `CHART_RENDERER_PIE_SIZE_FIELD`—The field will be used to set the size of pie chart symbols. `ROTATION_XEXPRESSION_FIELD`—The field will be used to set the rotation of symbols on the x-axis. `ROTATION_YEXPRESSION_FIELD`—The field will be used to set the rotation of symbols on the y-axis. `ROTATION_ZEXPRESSION_FIELD`—The field will be used to set the rotation of symbols on the z-axis. `TRANSPARENCY_EXPRESSION_FIELD`—The field will be used to set the transparency of symbols `TRANSPARENCY_NORMALIZATION_FIELD`—The field will be used to normalize transparency values. `SIZE_EXPRESSION_FIELD`—The field will be used to set the size or width of symbols. `COLOR_EXPRESSION_FIELD`—The field will be used to set the color of symbols. `PRIMITIVE_OVERRIDE_EXPRESSION_FIELD`—The field will be used to set various properties on individual symbol layers. `Source Field`—The symbology field used in the symbology layer. Use "#" if you do not know the source field and want the system default to be used. `Target Field`—The field from the input layer to use when applying the symbology.	Value Table
update_symbology (Optional)	Gibt an, ob Symbolisierungsbereiche aktualisiert werden. `DEFAULT`—Symbolisierungsbereiche werden aktualisiert, außer in den folgenden Situationen: Der Eingabe-Layer ist leer. Der Symbolisierungs-Layer verwendet Klassengrenzen (z. B. abgestufte Farben oder abgestufte Symbole) und die Klassifizierungsmethode ist "Manuell" oder "Definiertes Intervall". Der Symbolisierungs-Layer verwendet Einzelwerte, und die Option Alle anderen Werte anzeigen ist aktiviert. `UPDATE`—Symbolisierungsbereiche werden aktualisiert. `MAINTAIN`—Symbolisierungsbereiche werden nicht aktualisiert, sondern beibehalten.	String

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
out_layer	Der aktualisierte Eingabe-Layer.	Layer

Codebeispiel

ApplySymbologyFromLayer: Beispiel 1 (Python-Fenster)

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

import arcpy
arcpy.env.workspace = "C:/data.gdb"
arcpy.management.ApplySymbologyFromLayer("sf_points", "sf_points_water.lyrx")

ApplySymbologyFromLayer: Beispiel 2 (eigenständiges Skript)

Das folgende Skript veranschaulicht, wie die Funktion ApplySymbologyFromLayer in einem eigenständigen Skript verwendet wird.

# Import system modules
import arcpy

# Set the current workspace
arcpy.env.workspace = "C:/data.gdb"

# Set layer to apply symbology to
inputLayer = "sf_points"

# Set layer that output symbology will be based on
symbologyLayer = "water_symbols_pnt.lyrx"

# Apply the symbology from the symbology layer to the input layer
arcpy.management.ApplySymbologyFromLayer(inputLayer, symbologyLayer)

ApplySymbologyFromLayer: Beispiel 3 (eigenständiges Skript)

Das folgende Skript veranschaulicht, wie die Funktion ApplySymbologyFromLayer in einem eigenständigen Skript verwendet wird.

# Import system modules
import arcpy

# Set the current workspace
arcpy.env.workspace = "C:/data.gdb"

# Set layer to apply symbology to
inputLayer = "InlandEmpireBlocks"

# Set layer that output symbology will be based on
symbologyLayer = "USCensusBlocks.lyrx"

# The symbology layer is symbolized by population normalized by area.
# Symbolize the input by Pop2014 field normalized to Square Miles
symbologyFields = [["VALUE_FIELD", "#", "Pop2014"],
                   ["NORMALIZATION_FIELD", "#", "SQ_MILES"]]

# Apply the symbology from the symbology layer to the input layer
arcpy.management.ApplySymbologyFromLayer(inputLayer, symbologyLayer,
                                         symbologyFields)

ApplySymbologyFromLayer: Beispiel 3 (Skriptwerkzeug)

Wenden Sie in einem Skriptwerkzeug die Symbolisierung auf mehrere abgeleitete Ausgabe-Feature-Layer an. Das Beispiel-Werkzeug hat die folgenden Parameter:

Eingabe-Layer
- Datentyp: Feature-Layer (MultiValue)
- Typ: Erforderlich
- Richtung: Eingabe
Symbolisierung
- Datentyp: Feature-Layer
- Typ: Erforderlich
- Richtung: Eingabe
Abgeleitete Ausgabe
- Datentyp: Feature-Layer (MultiValue)
- Typ: Abgeleitet
- Richtung: Ausgabe

# Import system modules
import os
import arcpy

# Get Parameters
layers = arcpy.GetParameter(0)  # Accepts Feature Layers (multivalue)
sym = arcpy.GetParameter(1)  # Accepts a Feature Layer

# Apply symbology to each input layer, store the result objects in a list
results = []
for layer in layers:

    # Derive the name of the output featureclass
    layername = arcpy.Describe(layer).baseName
    outfeature = os.path.join(arcpy.env.scratchGDB, layername + "_out")

    # Copy feature to get output. This step can be replaced by other
    # steps that produce or manipulate a feature class.
    arcpy.management.CopyFeatures(layer, outfeature)

    # Apply symbology to the final output
    res = arcpy.management.ApplySymbologyFromLayer(outfeature, sym)

    # Append multivalue feature
    results.append(res)

# Set the symbology of the derived output parameter using the
# list of result objects
arcpy.SetParameter(2, results)

Umgebungen

Auto-Commit, Aktueller Workspace

Lizenzierungsinformationen

Basic: Ja
Standard: Ja
Advanced: Ja

Symbolisierung aus Layer anwenden (Data Management Tools)

Zusammenfassung

Abbildung

Verwendung

Parameter

Abgeleitete Ausgabe

Umgebungen

Lizenzierungsinformationen

Verwandte Themen