Feld transformieren (Data Management)—ArcGIS Pro

Zusammenfassung

Transformiert kontinuierliche Werte in einem oder mehreren Feldern, indem auf die einzelnen Werte mathematische Funktionen angewendet werden und die Form der Verteilung geändert wird. Zu den Transformationsmethoden dieses Werkzeugs gehören "Logarithmisch", "Quadratwurzel", "Box-Cox", "Kehrwert", "Quadrat", "Exponentiell" und "Box-Cox invers".

Eine Transformation kann angewendet werden, um die Verzerrung der Verteilung zu verringern, damit sie der Normalverteilung (Gaußkurve) folgt.

Abbildung

Die ursprünglichen Werte werden transformiert, sodass sie sich der Normalverteilung annähern.

Verwendung

Vorsicht:

Mit diesem Werkzeug werden die Eingabedaten geändert. Weitere Informationen und Strategien zur Vermeidung unerwünschter Datenänderungen finden Sie unter Werkzeuge, die Eingabedaten ändern oder aktualisieren.

Eingaben für dieses Werkzeug können Feature-Classes oder Tabellensichten sein.
Für den Parameter Transformationsmethode sind die folgenden Transformationen verfügbar:
- Logarithmisch: Die natürliche logarithmische Funktion log(x) wird auf den ursprünglichen Wert (x) in den ausgewählten Feldern angewendet.
  - Die logarithmische Transformation kann nur auf positive Werte angewendet werden. Bei negativen oder Null-Werten in den ausgewählten Feldern wird vor der Transformation standardmäßig ein Versatz zu den Daten hinzugefügt, log(x+Versatz), damit die Werte positiv sind. Der Standardversatz entspricht dem maximalen absoluten negativen Wert im Feld zuzüglich es kleinen positiven Wertes (~10^-6). Wenn die maximale negative Zahl im ausgewählten Feld z. B. -25 ist, werden alle Werte um einen Versatz von 25,000001 verschoben, damit sie alle positiv sind.
- Quadratwurzel: Die Quadratwurzel der einzelnen Werte in den ausgewählten Feldern angewendet.
  - Die Quadratwurzeltransformation kann nicht auf negative Werte angewendet werden. Bei negativen Werten in den ausgewählten Feldern wird vor der Transformation standardmäßig ein Versatz zu den Daten hinzugefügt, damit die Werte nicht negativ sind. Der Standardversatz entspricht dem maximalen absoluten negativen Wert im Feld, damit die Werte nicht mehr negativ sind.
- Box-Cox: Die folgende Potenzfunktion wird angewendet, um die Daten in den ausgewählten Feldern normal zu verteilen:
  Dabei gilt: x' ist der transformierte Wert, x ist der ursprüngliche Wert, λ₁ ist der Potenzparameter (Exponent), und λ₂ ist der Versatzparameter.
  - Die Box-Cox-Transformation kann nur auf positive Werte angewendet werden. Bei negativen oder Null-Werten in den ausgewählten Feldern wird vor der Transformation standardmäßig ein Versatz zu den Daten hinzugefügt, damit die Werte positiv sind. Der Standardwert entspricht dem maximalen absoluten negativen Wert im Feld, damit die Werte nicht mehr negativ sind. Hinzu kommt ein unendlich kleiner Wert (~10^-6), damit sie nicht null sind. Der Parameter Potenz kann verwendet werden, um den Wert der Potenz anzugeben. Wenn kein Wert angegeben wird, wird die beste Annäherung einer Normalverteilungskurve verwendet und in den Geoverarbeitungsmeldungen angezeigt.
- Kehrwert: In den ausgewählten Feldern wird der reziproke Wert (1/x) der einzelnen Werte (x) angewendet.
  - Die Kehrwerttransformation kann nicht auf Null-Werte angewendet werden. Null-Werte in den ausgewählten Feldern werden im transformierten Feld als null aufgeführt. Bei dieser Methode wird kein Versatz angewendet.
- Exponentiell: Die Exponentialfunktion (e^x) wird in den ausgewählten Feldern auf den ursprünglichen Wert (x) angewendet. Die exponentielle Transformation ist zudem die Umkehrung einer logarithmischen Transformation. Dies bedeutet, dass die Anwendung der exponentiellen Transformation auf ein logarithmisch transformiertes Feld wieder zu den ursprünglichen Datenwerten führt.
  - Standardmäßig wird kein Versatz auf das ausgewählte Feld angewendet. Um die ursprünglichen Werte eines logarithmisch transformierten Feldes zu erhalten, geben Sie den gleichen Versatzwert an, der zum Erstellen des logarithmischen Feldes verwendet wurde. Der Versatz wird subtrahiert, nachdem die exponentielle Transformation angewendet wurde: e^x - Versatz.
- Quadrat: Die Quadratfunktion wird auf die einzelnen Werte in den ausgewählten Feldern angewendet. Die Quadrattransformation ist zudem die Umkehrung der Quadratwurzeltransformation. Dies bedeutet, dass die Anwendung der Quadrattransformation auf ein mit Quadratwurzel transformiertes Feld wieder zu den ursprünglichen Datenwerten führt.
  - Standardmäßig wird kein Versatz auf die ausgewählten Felder angewendet. Um die ursprünglichen Werte eines mit Quadratwurzel transformierten Feldes zu erhalten, geben Sie den gleichen Versatzwert an, der zum Erstellen des Quadratwurzelfeldes verwendet wurde. Der Versatz wird subtrahiert, nachdem die Quadrattransformation angewendet wurde: x² - Versatz.
- Box-Cox invers: Die Umkehrung der Box-Cox-Transformation wird angewendet. Die Anwendung der inversen Box-Cox-Transformation auf ein mit Box-Cox transformiertes Feld führt also zu den ursprünglichen Datenwerten. Die inverse Box-Cox-Potenzfunktion wird wie folgt berechnet:
  Dabei gilt: x' ist der transformierte Wert, x ist der ursprüngliche Wert, λ₁ ist der Potenzparameter (Exponent), und λ₂ ist der Versatzparameter.
  - Es muss ein Wert für die Potenz angegeben werden. Um die ursprünglichen Werte eines mit Box-Cox transformierten Feldes zu erhalten, geben Sie die gleichen Versatz- und Potenzwerte an, die zum Erstellen des Box-Cox-Feldes verwendet wurden.
Wenn kein Versatz auf die Methoden "Logarithmisch", "Quadratwurzel" und "Box-Cox" angewendet werden soll, können Sie den Wert 0 für den Parameter Versatz angeben. Dann wird kein Versatz angewendet.
Wenn bei der Werkzeugausführung mehrere Felder verwendet werden, wird die ausgewählte Transformationsmethode auf alle Felder angewendet. Wenn ein Versatz- oder Potenzwert angegeben wird, werden die gleichen Werte auf alle ausgewählten Felder angewendet. Wenn keine Werte für die Parameter Versatz und Potenz angegeben werden, werden die Standardwerte für jedes ausgewählte Feld je nach angegebener Transformationsmethode unabhängig berechnet.
Das Werkzeug ändert die Eingabedaten und fügt die neu erstellten transformierten Felder der Eingabetabelle oder -Feature-Class an.
Im Parameter Zu transformierendes Feld können Eingabe- und Ausgabefeldnamen angegeben werden. Wenn der Ausgabefeldname in den Daten bereits vorhanden ist, wird das Feld überschrieben.
Für jedes transformierte Feld werden in den Ergebnismeldungen der Geoverarbeitung Summenstatistiken für die Quellfelder und die transformierten Felder angegeben. Diese Statistiken enthalten Werte für Maximum, Minimum, Summe, Mittelwert, Standardabweichung, Medianwert, Verzerrung und Wölbung.
Die für die Parameter Potenz und Versatz vom Werkzeug geschätzten Werte werden in den Geoverarbeitungsmeldungen ebenfalls angezeigt. Mithilfe dieser Werte können die ursprünglichen Datenwerte über eine Umkehrung der Transformationsmethode ermittelt werden.
Das Werkzeug erstellt ein Histogramm für jedes der neu erstellten transformierten Felder, um die Verteilungen zu visualisieren.

Parameter

Beschriftung	Erläuterung	Datentyp
Eingabetabelle	Die Eingabetabelle oder -Feature-Class mit dem Feld, das transformiert werden soll. Die neu transformierten Felder werden zur Eingabetabelle hinzugefügt.	Table View; Raster Layer; Mosaic Layer
Zu transformierendes Feld	Die Felder, die die zu transformierenden Werte enthalten. Für jedes Feld kann ein Ausgabefeldname angegeben werden. Wenn kein Ausgabefeldname angegeben wird, erstellt das Werkzeug einen Ausgabefeldnamen aus dem Feldnamen und der Transformationsmethode.	Value Table
Transformationsmethode (optional)	Gibt die Methode an, die zum Transformieren der Werte in den angegebenen Feldern verwendet wird. Kehrwert—Die Kehrwertmethode (1/x) wird auf den ursprünglichen Wert (x) in den ausgewählten Feldern angewendet. Quadratwurzel—Die Quadratwurzelmethode wird auf den ursprünglichen Wert in den ausgewählten Feldern angewendet. Logarithmisch—Die natürliche logarithmische Funktion log(x) wird auf den ursprünglichen Wert (x) in den ausgewählten Feldern angewendet. Box-Cox—Die Box-Cox-Potenzfunktion wird angewendet, um die ursprünglichen Werte in den ausgewählten Feldern normal zu verteilen. Dies ist die Standardeinstellung. Box-Cox invers—Die Umkehrung der Box-Cox-Transformation wird auf die ursprünglichen Werte in den ausgewählten Feldern angewendet. Quadrat (Quadratwurzel invers)—Die Quadratmethode wird auf die ursprünglichen Werte in den ausgewählten Feldern angewendet. Diese Transformation ist die Umkehrung der Quadratwurzeltransformation. Exponentiell (logarithmisch invers)—Die Exponentialfunktion exp(x) wird auf den ursprünglichen Wert (x) in den ausgewählten Feldern angewendet. Diese Transformation ist die Umkehrung der logarithmischen Transformation.	String
Potenz (optional)	Der Potenzparameter (λ₁) der Box-Cox-Transformation und der inversen Box-Cox-Transformation. Wenn für die Box-Cox-Transformation kein Wert angegeben wird, wird ein optimaler Wert über eine Schätzung der maximalen Wahrscheinlichkeit (Maximum Likelihood Estimation, MLE) ermittelt. Für die inverse Box-Cox-Transformation muss ein Wert angegeben werden.	Double
Verschieben (optional)	Der Wert, um den die Daten verschoben werden (ein konstanter Wert wird hinzugefügt). Kein Versatz wird angewendet, wenn 0 angegeben ist. Für die Transformationen "Logarithmisch", "Box-Cox" und "Quadratwurzel" wird vor der Transformation ein Standardversatzwert hinzugefügt, falls negative oder Null-Werte vorhanden sind. Für die Transformationen "Exponentiell" (logarithmisch invers), "Box-Cox invers" und "Quadrat" (Quadratwurzel invers) wird standardmäßig kein Versatz angewendet. Wenn ein Versatzwert angegeben wird, wird er nach Anwendung der Transformation subtrahiert. Dadurch können Sie den gleichen Versatzwert für Transformationen und deren Umkehrungen verwenden.	Double

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Aktualisierte Eingabetabelle	Die aktualisierte Tabelle mit den transformierten Feldern.	Table View

arcpy.management.TransformField(in_table, fields, {method}, {power}, {shift})

Name	Erläuterung	Datentyp
in_table	Die Eingabetabelle oder -Feature-Class mit dem Feld, das transformiert werden soll. Die neu transformierten Felder werden zur Eingabetabelle hinzugefügt.	Table View; Raster Layer; Mosaic Layer
fields [[input_field, output_field_name],...]	Die Felder, die die zu transformierenden Werte enthalten. Für jedes Feld kann ein Ausgabefeldname angegeben werden. Wenn kein Ausgabefeldname angegeben wird, erstellt das Werkzeug einen Ausgabefeldnamen aus dem Feldnamen und der Transformationsmethode.	Value Table
method (optional)	Gibt die Methode an, die zum Transformieren der Werte in den angegebenen Feldern verwendet wird. INVX—Die Kehrwertmethode (1/x) wird auf den ursprünglichen Wert (x) in den ausgewählten Feldern angewendet. SQRT—Die Quadratwurzelmethode wird auf den ursprünglichen Wert in den ausgewählten Feldern angewendet. LOG—Die natürliche logarithmische Funktion log(x) wird auf den ursprünglichen Wert (x) in den ausgewählten Feldern angewendet. BOX-COX—Die Box-Cox-Potenzfunktion wird angewendet, um die ursprünglichen Werte in den ausgewählten Feldern normal zu verteilen. Dies ist die Standardeinstellung. INV_BOX-COX—Die Umkehrung der Box-Cox-Transformation wird auf die ursprünglichen Werte in den ausgewählten Feldern angewendet. INV_SQRT—Die Quadratmethode wird auf die ursprünglichen Werte in den ausgewählten Feldern angewendet. Diese Transformation ist die Umkehrung der Quadratwurzeltransformation. INV_LOG—Die Exponentialfunktion exp(x) wird auf den ursprünglichen Wert (x) in den ausgewählten Feldern angewendet. Diese Transformation ist die Umkehrung der logarithmischen Transformation.	String
power (optional)	Der Potenzparameter (λ₁) der Box-Cox-Transformation und der inversen Box-Cox-Transformation. Wenn für die Box-Cox-Transformation kein Wert angegeben wird, wird ein optimaler Wert über eine Schätzung der maximalen Wahrscheinlichkeit (Maximum Likelihood Estimation, MLE) ermittelt. Für die inverse Box-Cox-Transformation muss ein Wert angegeben werden.	Double
shift (optional)	Der Wert, um den die Daten verschoben werden (ein konstanter Wert wird hinzugefügt). Kein Versatz wird angewendet, wenn 0 angegeben ist. Für die Transformationen "Logarithmisch", "Box-Cox" und "Quadratwurzel" wird vor der Transformation ein Standardversatzwert hinzugefügt, falls negative oder Null-Werte vorhanden sind. Für die Transformationen "Exponentiell" (logarithmisch invers), "Box-Cox invers" und "Quadrat" (Quadratwurzel invers) wird standardmäßig kein Versatz angewendet. Wenn ein Versatzwert angegeben wird, wird er nach Anwendung der Transformation subtrahiert. Dadurch können Sie den gleichen Versatzwert für Transformationen und deren Umkehrungen verwenden.	Double

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
updated_table	Die aktualisierte Tabelle mit den transformierten Feldern.	Table View

Codebeispiel

TransformField: Beispiel 1 (Python-Fenster)

Das folgende Skript im Python-Fenster veranschaulicht, wie Sie die Funktion TransformField verwenden.

import arcpy
arcpy.management.TransformField("County_Data", "Income", "LOG")

TransformField: Beispiel 2 (eigenständiges Skript)

Das folgende eigenständige Python-Skript veranschaulicht, wie die Funktion TransformField verwendet wird.

# Import system modules. 
import arcpy 
 
try: 
    # Set the workspace and input features. 
    arcpy.env.workspace = r"C:\\Transform\\MyData.gdb" 
    inputFeatures = "County_Data" 
 
    # Set the input fields that will be standardized. 
    fields = "population_total;unemployment_rate;income" 
 
    # Set the standardization method. 
    method = "BOX-COX" 
 
    # Run the Transform Field tool. 
    arcpy.management.TransformField(inputFeatures, fields, method) 
 
except arcpy.ExecuteError: 
    # If an error occurred when running the tool, print the error message. 
    print(arcpy.GetMessages())

Umgebungen

Ausdehnung

Lizenzinformationen

Basic: Ja
Standard: Ja
Advanced: Ja

Zusammenfassung

Abbildung

Verwendung

Vorsicht:

Parameter

Abgeleitete Ausgabe

Abgeleitete Ausgabe

Codebeispiel

Umgebungen

Lizenzinformationen

Verwandte Themen

In diesem Thema