Fehlende Werte ausfüllen (Space Time Pattern Mining)

Zusammenfassung

Ersetzt fehlende Werte (NULL-Werte) durch geschätzte Werte basierend auf Werten von räumlichen Nachbarn, Raum-Zeit-Nachbarn, Zeitserien oder globalen Statistiken.

Weitere Informationen zur Funktionsweise des Werkzeugs Fehlende Werte ausfüllen

Abbildung

Abbildung des Werkzeugs "Fehlende Werte ausfüllen"

Verwendung

  • Der Wert des Parameters Eingabe-Features oder -Tabelle kann Punkt- oder Polygon-Features oder eine Standalone-Tabelle angeben.

  • Bei einem Eingabe-Feature können die fehlenden Werte unter Verwendung von räumlichen Nachbarn, Raum-Zeit-Nachbarn oder Zeitserienwerten geschätzt werden. Die fehlenden Werte können sich in den Eingabe-Features oder in einer zugehörigen Tabelle befinden. Bei Standalone-Tabellen können die fehlenden Werte unter Verwendung von globalen Statistiken der Eingabefeld- oder Zeitserienwerte geschätzt werden. Da Standalone-Tabellen keine räumlichen Informationen enthalten, können räumliche Nachbarn für Tabellen nicht definiert werden.

  • Die Ausgabe enthält dann zwei Felder pro Feld des Parameters Auszufüllende Felder. Das erste Feld enthält die ursprünglichen und die ausgefüllten Werte, und das zweite Feld enthält einen Indikator dafür, dass der Wert geschätzt wurde. Das geschätzte Feld behält den ursprünglichen Feldnamen, es werden jedoch Feld-Aliasnamen mit der folgenden Namenskonvention erstellt: <field>_FILLED und <field>_ESTIMATED. Bei Eingabe-Features ist das dritte Feld das Feld <field>_ N_NEIGHBORS mit der Anzahl der Nachbarn, die in den Berechnungen für jeden geschätzten Wert verwendet wurden. Bei Eingabe-Standalone-Tabellen ist das dritte Feld das Feld <field>_NUM_REC_USED mit der Anzahl der Datensätze, die in den Berechnungen für jeden geschätzten Wert verwendet wurden.

  • Bei Eingabe-Features enthält die Ausgabe außerdem Felder mit Werten, die Ihnen ein besseres Verständnis der Anzahl der Nachbarn und des Bereichs der Nachbarschaftswerte vermitteln, die in den Berechnungen für den fehlenden Zielwert herangezogen werden. Wenn der Parameter Füllmethode auf Durchschnitt festgelegt ist, wird die in Berechnungen verwendete Standardabweichung (<field>_STD) der Nachbarn aufgezeichnet. Der maximale Nachbarschaftswert (<field>_MAX) wird für die Option Maximum und der minimale Nachbarschaftswert (<field>_MIN) wird für die Option Minimum erfasst. Wenn der Parameter Füllmethode auf Medianwert festgelegt ist, wird die mittlere absolute Abweichung (<field>_MAD) der Nachbarn erfasst. Wenn fehlende Werte mit der Option Zeitlicher Trend gefüllt werden, enthält das Feld <field>_RES die Summe der Spline-Residuen im Quadrat. Das Feld NNBRS enthält die Anzahl der Nachbarn, die zum Berechnen der geschätzten Werte verwendet wurden.

  • Bei Standalone-Tabellen enthält die Ausgabe Felder mit Werten, die Ihnen ein besseres Verständnis der Statistik und des Bereichs der Nicht-NULL-Werte des Feldes vermitteln, das in den Berechnungen für den fehlenden Zielwert herangezogen wird. Wenn der Parameter Füllmethode auf Durchschnitt festgelegt ist, wird die in Berechnungen verwendete Standardabweichung (<field>_STD) aller Nicht-NULL-Werte im Feld aufgezeichnet. Der Maximalwert des Eingabefeldes (<field>_MAX) wird für die Option Maximum und der Minimalwert (<field>_MIN) wird für die Option Minimum erfasst. Wenn der Parameter Füllmethode auf Medianwert festgelegt ist, wird die mittlere absolute Abweichung (<field>_MAD) der Nicht-NULL-Werte erfasst. Wenn fehlende Werte mit der Option Zeitlicher Trend gefüllt werden, enthält das Feld <field>_RES die Summe der Spline-Residuen im Quadrat.

  • Sie können Felder einbeziehen, die keine NULL-Werte enthalten. Diese Felder werden in die Ausgabe kopiert, weisen jedoch keine zusätzlichen Felder auf, die mit ihnen in der Ausgabe verknüpft sind (z. B. <field>_FILLED oder <field>_ESTIMATED). Sie können auch einen Wert für den Parameter Eindeutige ID angeben, der der Ausgabe hinzugefügt werden soll und verwendet werden kann, um die Ergebnisse wieder mit den Eingabe-Features bzw. mit der Eingabetabelle zu verbinden.

  • Das Feld NUM_EST (TOT_EST, falls Sie eine zugehörige Tabelle verwenden) ist die Gesamtzahl der geschätzten Variablen für den verknüpften Datensatz. Dieses Feld wird zum Rendern der Ausgabekarte verwendet.

  • Die zusätzlichen Felder können Sie mit dem Parameter Felder an Eingabe anhängen an das Eingabe-Feature bzw. an die Eingabetabelle anhängen. Wenn Sie diese Felder anhängen, kann keine zugehörige Tabelle angegeben werden.

  • Bei Eingabe-Features kann der Parameter Positions-ID je nach der Struktur der Eingabe-Raum-Zeit-Daten auf verschiedene Arten verwendet werden.

    • Wenn die Daten in einer zugehörigen Tabelle gespeichert werden (es geht also um bestimmte Features in einer Feature-Class mit einer zugehörigen Tabelle, die mit der Zeit erfasste Attribute enthält) und Sie die fehlenden Werte in der zugehörigen Tabelle ausfüllen möchten, dann können Sie den Parameter Zugehörige Tabelle verwenden. Der Wert des Parameters Positions-ID verknüpft jedes Feature in der Eingabe-Feature-Class mit einer Gruppe bestimmter Datensätze in der zugehörigen Tabelle und muss für jedes Eingabe-Feature eindeutig sein.
    • Wenn die Daten in derselben Feature-Class gespeichert werden (das heißt, über sich wiederholende Shapes oder Geometrie), dann gibt der Parameter Positions-ID jede eindeutige Position in der Feature-Class an. Wenn Sie zum Beispiel mit den US-Bevölkerungsdaten auf der Ebene der Countys aus 10 Jahren arbeiten, dann wird jedes County in der Feature-Class 10-mal wiederholt, wobei die County-ID zum eindeutigen Angeben der Position der einzelnen Countys verwendet wird. Die Positions-ID muss für jede Position eindeutig sein, aber nicht unbedingt für jedes Feature.

  • Der Parameter Positions-ID ist ein ganzzahliges oder Textfeld und sollte eine eindeutige und stationäre Position darstellen. Die XY-Koordinaten sollten sich im Zeitverlauf nicht ändern.

  • Dieses Werkzeug kann mit Bereichsdaten verwendet werden, die als wiederholte Shapes oder mit einer zugehörigen Tabelle gespeichert werden. Wenn ein Wert für den Parameter Positions-ID angegeben wurde, dann erkennt das Werkzeug, dass es sich bei der Eingabe um Bereichsdaten handelt und der Parameter Zeitfeld erforderlich ist.

  • Wenn bei Standalone-Tabellen ein Wert für den Parameter Positions-ID angegeben wurde und kein Wert für den Parameter Zeitfeld angegeben wurde, dann werden die geschätzten Werte unter Verwendung der Datensätze mit derselben Positions-ID wie die Position mit dem NULL-Wert, der ausgefüllt werden soll, berechnet. Wenn Sie zum Beispiel mit den US-Daten auf der Ebene der Countys arbeiten und die fehlenden Werte unter Verwendung des Durchschnitts aller Countys in demselben Bundesstaat ausfüllen möchten, dann können Sie ein Feld, das den Bundesstaat darstellt, als Positions-ID verwenden.

  • Wenn die Werte der beiden Parameter Positions-ID und Zeitfeld Eingabe-Standalone-Tabellen sind, dann ist nur die Option Zeitlicher Trend für den Parameter Füllmethode verfügbar.

  • Wenn die Option Feste Entfernung, Nur benachbarte Kanten oder Benachbarte Kanten/Ecken für den Parameter Konzeptualisierung von räumlichen Beziehungen ausgewählt wird, kann ein Raum-Zeit-Fenster simuliert werden, indem ein Wert für die Parameter Entfernungsband und Zeitliche Nachbarschaft ausgewählt wird.

  • Wenn die Option Feste Entfernung, Nur benachbarte Kanten oder Benachbarte Kanten/Ecken für den Parameter Konzeptualisierung von räumlichen Beziehungen ausgewählt wird, kann ein Wert für den Parameter Anzahl der räumlichen Nachbarn zum Festlegen einer Mindestanzahl der Nachbarn festgelegt werden.

  • Die Option Zeitlicher Trend für den Parameter Füllmethode ist nur dann verfügbar, wenn Werte für die Parameter Positions-ID und Zeitfeld festgelegt wurden.

  • Wenn die Option Zeitlicher Trend zum Ausfüllen von Werten verwendet wird, dann müssen sich an der Position mit einem auszufüllenden NULL-Wert mindestens zwei Zeiträume mit Werten am Anfang und mindestens zwei Zeiträume mit Werten am Ende der Zeitserie, die ausgefüllt werden soll, befinden. Aufgrund dieser Anforderung können Nullen in den ersten oder letzten beiden Zeitschritten nicht mit der Option Zeitlicher Trend ausgefüllt werden.

  • Die Option Zeitlicher Trend verwendet die interpolierte eindimensionale Spline-Methode (Interpolated Univariate Spline) im Interpolationspaket von SciPy.

  • Wenn die fehlenden Werte von Bereichsdaten mit räumlichen Nachbarn ausgefüllt werden, dann legen Sie den Parameter Zeitliche Nachbarschaft auf 0 fest.

  • Wenn es sich bei den Daten um Bereichsdaten handelt, dann können Sie den Parameter Zeitliche Nachbarschaft zum Filtern nach Zeit verwenden. Sie können aber auch für Zeitliche Nachbarschaft den Wert 0 verwenden, damit nur räumliche Nachbarn angezeigt werden.

  • Es ist wichtig, die resultierenden Füllwerte zu überprüfen, um sicherzustellen, dass sie für Ihre Analyse sinnvoll sind. Wenn das ursprüngliche Feld beispielsweise ein ganzzahliger Wert und das Werkzeug so eingestellt war, dass mit dem Durchschnitt räumlicher Nachbarn gefüllt werden soll, dann sind in den Ergebnissen Dezimalzahlen enthalten, die nicht sinnvoll sind, wenn Ihr Eingabefeld eine Anzahl war. Außerdem kann aufgrund der Methode, die für den Parameter Zeitlicher Trend verwendet wurde, das Ergebnis eine negative Zahl sein, auch wenn keiner der vorhandenen Werte negativ war. Dies wäre nicht sinnvoll, wenn es sich bei dem ausgefüllten Feld um das Feld "Bevölkerung" handelt.

  • Das Feld N_NEIGHBORS enthält die Anzahl der Nachbarn, die in die Berechnungen für dieses Feature verwendet wurden. Wenn der Parameter Füllmethode auf Zeitlicher Trend festgelegt ist, dann ist diese Zahl die Anzahl der Werte, die in der Zeitserie für diesen Wert der Positions-ID vorhanden sind (wenn zum Beispiel nur ein Wert in der Zeitserie gefehlt hat, dann wird in diesem Feld die Anzahl der Zeitschritte in Ihrem Dataset minus eins angegeben). Wenn Sie für den Parameter Konzeptualisierung von räumlichen Beziehungen den Wert Nächste Nachbarn (K) und einen Wert für Zeitliche Nachbarschaft verwenden, dann sind in der angegebenen Anzahl der Nachbarn die k Nachbarn für das Feature enthalten, die innerhalb des angegebenen Zeitfensters liegen.

  • Der Parameter NULL-Wert enthält die NULL-Werte (fehlenden Werte). Dieser Parameter wird je nach Eingabe- und Ausgabeformat auf verschiedene Arten verwendet.

    • Für Geodatabase-Feature-Classes oder -Tabellen wird vorausgesetzt, dass <NULL> der NULL-Wert (fehlende Wert) ist, wenn für den Parameter NULL-Wert kein Wert angegeben ist. Wenn ein Wert angegeben ist, dann werden dieser Wert und die <NULL>-Werte in der Werkzeugausgabe geschätzt.
    • Für Shapefiles und dBASE-Tabellen ist der Parameter NULL-Wert erforderlich. Sie müssen einen Wert angeben, der NULL-Werte oder fehlende Werte in den Eingabedaten darstellt (zum Beispiel -9999).
    • Wenn die Eingabe eine File-Geodatabase-Feature-Class oder -Tabelle und die Ausgabe ein Shapefile oder eine dBASE-Tabelle ist, dann ist dieser Parameter erforderlich, um anzugeben, wie die fehlenden Werte, die nicht geschätzt werden können, in der Werkzeugausgabe dargestellt werden sollen.

  • Fehlende Werte, die weder geschätzt noch gefüllt werden können, werden in der Ausgabe in dem Format erfasst, in dem die NULL-Werte ursprünglich vorhanden waren oder das im Parameter NULL-Wert festgelegt ist.

  • Meldungen, die die Details der Analyse und Eigenschaften der gefüllten Felder beschreiben, werden während der Ausführung des Werkzeugs am unteren Rand des Bereichs Geoverarbeitung angezeigt. Um auf die Meldungen zuzugreifen, zeigen Sie mit der Maus auf die Fortschrittsleiste, und klicken Sie auf die Pop-out-Schaltfläche Pop-out, oder erweitern Sie den Abschnitt "Meldungen" im Bereich Geoverarbeitung. Sie können auch auf die Meldungen für eine vorherige Ausführung des Werkzeugs Fehlende Werte ausfüllen über den Geoverarbeitungsverlauf zugreifen.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Features oder -Tabelle

Die Point- oder Polygon-Feature-Class oder Standalone-Tabelle, die die auszufüllenden NULL-Werte enthält.

Wenn für den Parameter Zugehörige Tabelle ein Wert angegeben ist, dann sind die auszufüllenden NULL-Werte in der zugehörigen Tabelle enthalten. Die Eingabe-Features werden mit den Zeilen in der zugehörigen Tabelle abgeglichen, um die Raum-Zeit-Nachbarschaft anzugeben.

Table View
Ausgabe-Features oder -Tabelle
(optional)

Die Ausgabe-Features (bzw. Standalone-Tabelle), in denen die ausgefüllten (geschätzten) Werte enthalten sein sollen.

Wenn für den Parameter Zugehörige Tabelle ein Wert angegeben ist, dann enthält die Ausgabe dieses Parameters die Anzahl der geschätzten Werte an jeder Position, und der Wert des Parameters Ausgabetabelle enthält die ausgefüllten (geschätzten) Werte.

Feature Class; Table
Auszufüllende Felder

Die numerischen Felder, die die fehlenden Daten (NULL-Werte) enthalten.

Field
Füllmethode

Gibt den Typ der Berechnung an, die angewendet werden soll. Die Option Zeitlicher Trend ist nur dann verfügbar, wenn Werte für die Parameter Positions-ID und Zeitfeld angegeben sind.

  • DurchschnittNULL-Werte werden durch den Mittelwert (Durchschnittswert) der Nachbarn des Features bzw. den Mittelwert des auszufüllenden Feldes für Standalone-Tabellen ersetzt.
  • MinimumNULL-Werte werden durch den Minimalwert (kleinsten Wert) der Nachbarn des Features bzw. den Minimalwert des auszufüllenden Feldes für Standalone-Tabellen ersetzt.
  • MaximumNULL-Werte werden durch den Maximalwert (größten Wert) der Nachbarn des Features bzw. den Maximalwert des auszufüllenden Feldes für Standalone-Tabellen ersetzt.
  • MedianwertNULL-Werte werden durch den Medianwert (sortierten Mittelwert) der Nachbarn des Features bzw. den Medianwert des auszufüllenden Feldes für Standalone-Tabellen ersetzt.
  • Zeitlicher TrendNULL-Werte werden basierend auf dem Trend an dieser eindeutigen Position ersetzt.
String
Konzeptualisierung von räumlichen Beziehungen
(optional)

Gibt an, wie räumliche Beziehungen zwischen Features definiert werden sollen.

  • Feste EntfernungBenachbarte Features innerhalb einer angegebenen kritischen Entfernung (der Wert des Parameters Entfernungsband) von jedem Feature werden in die Berechnungen einbezogen; alle außerhalb der kritischen Entfernung liegenden Features werden ausgeschlossen.
  • Nächste Nachbarn (K)Die nächstgelegenen k Features werden in die Berechnungen einbezogen; k ist dabei ein festgelegter numerischer Parameter.
  • Nur KontiguitätskantenNur benachbarte Polygon-Features mit einer gemeinsamen Grenze oder mit einer Überlappung beeinflussen Berechnungen für das Ziel-Polygon-Feature.
  • Kontiguitätsecken und -kantenPolygon-Features mit einer gemeinsamen Grenze, einem gemeinsamen Knoten oder mit einer Überlappung beeinflussen Berechnungen für das Zielpolygon-Feature.
  • Räumliche Gewichtungen aus Datei abrufenRäumliche Beziehungen werden durch eine Datei mit räumlichen Gewichtungen definiert. Der Pfad zur Datei mit räumlichen Gewichtungen wird durch den Parameter Gewichtungsmatrix-Datei angegeben.
String
Entfernungsband
(optional)

Der Entfernungsgrenzwert für die Option Feste Entfernung des Parameters Konzeptualisierung von räumlichen Beziehungen. Features außerhalb des angegebenen Grenzwerts für ein Ziel-Feature werden in Berechnungen für dieses Feature ignoriert. Dieser Parameter ist für die Optionen Nur benachbarte Kanten oder Benachbarte Kanten/Ecken nicht verfügbar.

Linear Unit
Zeitliche Nachbarschaft
(optional)

Ein Intervall vorwärts oder rückwärts in der Zeit zum Ermitteln der Features, die in Berechnungen für das Ziel-Feature verwendet werden sollen. Features, die nicht in diesem Intervall des Ziel-Features liegen, werden in Berechnungen für dieses Feature ignoriert.

Time Unit
Zeitfeld
(optional)

Das Feld, das den Zeitstempel für den jeweiligen Datensatz des Datasets enthält. Dieses Feld muss vom Typ "Datum" sein.

Bei einer Feature-Eingabe definiert das Zeitfeld die zeitlichen Nachbarn beim Füllen fehlender Werte. Wenn eine zugehörige Tabelle angegeben ist, dann muss ein Wert angegeben werden.

Bei einer Feature- und Tabellen-Eingabe wird das Zeitfeld beim Füllen fehlender Werte unter Verwendung des zeitlichen Trends an der Position verwendet.

Field
Anzahl der räumlichen Nachbarn
(optional)

Die Anzahl der nächstgelegenen Nachbarn, die in Berechnungen einbezogen werden sollen.

Wenn die Option Feste Entfernung, Nur benachbarte Kanten oder Benachbarte Kanten/Ecken des Parameters Konzeptualisierung von räumlichen Beziehungen ausgewählt wurde, dann entspricht diese Zahl der Mindestanzahl der Nachbarn, die in Berechnungen einbezogen werden sollen.

Long
Positions-ID
(optional)

Ein ganzzahliges oder Textfeld, das eine eindeutige ID-Nummer für jede Position enthält.

Wenn eine zugehörige Tabelle angegeben ist, dann wird dieses Feld verwendet, um jedes Eingabe-Features mit Zeilen in der zugehörigen Tabelle abzugleichen. Die Werte dieses Feldes müssen für jedes Eingabe-Feature eindeutig sein. Wenn keine zugehörige Tabelle angegeben ist, dann wird dieses Feld verwendet, um jede eindeutige Position zum Ermitteln zeitlicher Nachbarn festzulegen. In diesem Fall müssen die Werte dieses Feldes für jede Position eindeutig sein, aber nicht unbedingt für jedes Feature (da mehrere Features dieselbe Position haben können).

Field
Zugehörige Tabelle
(optional)

Die Tabelle bzw. Tabellensicht, die die Zeitdaten für die einzelnen Features des Parameters Eingabe-Features oder -Tabelle enthält.

Table View
Zugehörige Positions-ID
(optional)

Ein ganzzahliges oder Textfeld im Parameter Zugehörige Tabelle, das den Wert des Parameters Positions-ID enthält, auf dem die Beziehung basieren soll.

Field
Datei mit räumlicher Gewichtungsmatrix
(optional)

Der Pfad zu einer Datei mit Gewichtungen, die räumliche und potenziell zeitliche Beziehungen unter Features definieren.

File
Eindeutige ID
(optional)

Ein ganzzahliges Feld, das für jeden Datensatz im Wert des Parameters Eingabe-Features oder -Tabelle einen anderen Wert enthält. Dieses Feld kann verwendet werden, um die Ergebnisse wieder mit dem jeweiligen ursprünglichen Datensatz zu verbinden.

Wenn Sie nicht über das Feld Unique ID verfügen, können Sie eines erstellen, indem Sie der Attributtabelle des Eingabe-Features ein ganzzahliges Feld hinzufügen und die Feldwerte berechnen, die dem Feld FID oder OBJECTID entsprechen.

Field
NULL-Wert
(optional)

Der Wert, der NULL-Werte (fehlende Werte) enthält. Wenn kein Wert angegeben ist, wird für Geodatabase-Feature-Classes und -Tabellen <NULL> vorausgesetzt. Wenn ein Wert angegeben ist, dann werden dieser Wert und alle NULL-Werte ausgefüllt. Wenn die Eingabe oder Ausgabe ein Shapefile oder eine dBASE-Tabelle ist, dann ist ein numerischer Wert des NULL-Platzhalters erforderlich.

Double
Ausgabetabelle
(optional)

Die Ausgabetabelle die die ausgefüllten (geschätzten) Werte enthält.

Wenn eine zugehörige Tabelle angegeben ist, dann ist die Ausgabetabelle ist erforderlich.

Table
Felder an Eingabedaten anhängen
(optional)

Gibt an, ob die gefüllten Wertefelder an die Eingabedaten angehängt werden sollen oder eine Ausgabe-Feature-Class oder Ausgabetabelle mit den gefüllten Wertefeldern erstellt werden soll. Wenn Sie die Felder anhängen, dann können Sie keine zugehörige Tabelle angeben, und die Umgebungseinstellung des Ausgabe-Koordinatensystems wird ignoriert.

  • Aktiviert: Die Felder, die die ausgefüllten Werte enthalten, werden an die Eingabedaten angehängt. Bei dieser Option werden die Eingabedaten geändert.
  • Deaktiviert: Es wird eine Ausgabe-Feature-Class oder Ausgabetabelle mit den gefüllten Wertefeldern erstellt. Dies ist die Standardeinstellung.

Boolean

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Aktualisierte Eingabe-Features oder -Tabelle

Die aktualisierten Eingabe-Features (bzw. aktualisierte Tabelle) mit den gefüllten Wertefeldern.

Table View

arcpy.stpm.FillMissingValues(in_features, {out_features}, fields_to_fill, fill_method, {conceptualization_of_spatial_relationships}, {distance_band}, {temporal_neighborhood}, {time_field}, {number_of_spatial_neighbors}, {location_id}, {related_table}, {related_location_id}, {weights_matrix_file}, {unique_id}, {null_value}, {out_table}, {append_to_input})
NameErläuterungDatentyp
in_features

Die Point- oder Polygon-Feature-Class oder Standalone-Tabelle, die die auszufüllenden NULL-Werte enthält.

Wenn für den Parameter related_table ein Wert angegeben ist, dann sind die auszufüllenden NULL-Werte in der zugehörigen Tabelle enthalten. Die Eingabe-Features werden mit den Zeilen in der zugehörigen Tabelle abgeglichen, um die Raum-Zeit-Nachbarschaft anzugeben.

Table View
out_features
(optional)

Die Ausgabe-Features (bzw. Standalone-Tabelle), in denen die ausgefüllten (geschätzten) Werte enthalten sein sollen.

Wenn für den Parameter related_table ein Wert angegeben ist, dann enthält die Ausgabe dieses Parameters die Anzahl der geschätzten Werte an jeder Position, und der Wert des Parameters out_table enthält die ausgefüllten (geschätzten) Werte.

Feature Class; Table
fields_to_fill
[fields_to_fill,...]

Die numerischen Felder, die die fehlenden Daten (NULL-Werte) enthalten.

Field
fill_method

Gibt den Typ der Berechnung an, die angewendet werden soll. Die Option TEMPORAL_TREND ist nur dann verfügbar, wenn Werte für die Parameter location_id und time_field angegeben sind.

  • AVERAGENULL-Werte werden durch den Durchschnittswert (Mittelwert) der Nachbarn des Features ersetzt.
  • MINIMUMNULL-Werte werden durch den Minimalwert (kleinsten Wert) der Nachbarn des Features ersetzt.
  • MAXIMUMNULL-Werte werden durch den Maximalwert (größten Wert) der Nachbarn des Features ersetzt.
  • MEDIANNULL-Werte werden durch den Medianwert (sortierten Mittelwert) der Nachbarn des Features ersetzt.
  • TEMPORAL_TRENDNULL-Werte werden basierend auf dem Trend an dieser eindeutigen Position ersetzt.
String
conceptualization_of_spatial_relationships
(optional)

Gibt an, wie räumliche Beziehungen zwischen Features definiert werden sollen.

  • FIXED_DISTANCEBenachbarte Features innerhalb einer angegebenen kritischen Entfernung (der Wert des Parameters distance_band) von jedem Feature werden in die Berechnungen einbezogen; alle außerhalb der kritischen Entfernung liegenden Features werden ausgeschlossen.
  • K_NEAREST_NEIGHBORSDie nächstgelegenen k Features werden in die Berechnungen einbezogen; k ist dabei ein festgelegter numerischer Parameter.
  • CONTIGUITY_EDGES_ONLYNur benachbarte Polygon-Features mit einer gemeinsamen Grenze oder mit einer Überlappung beeinflussen Berechnungen für das Ziel-Polygon-Feature.
  • CONTIGUITY_EDGES_CORNERSPolygon-Features mit einer gemeinsamen Grenze, einem gemeinsamen Knoten oder mit einer Überlappung beeinflussen Berechnungen für das Zielpolygon-Feature.
  • GET_SPATIAL_WEIGHTS_FROM_FILERäumliche Beziehungen werden durch eine Datei mit räumlichen Gewichtungen definiert. Der Pfad zur Datei mit räumlichen Gewichtungen wird durch den Parameter Weights_Matrix_File angegeben.
String
distance_band
(optional)

Der Entfernungsgrenzwert für die Option FIXED_DISTANCE des Parameters conceptualization_of_spatial_relationships. Features außerhalb des angegebenen Grenzwerts für ein Ziel-Feature werden in Berechnungen für dieses Feature ignoriert. Dieser Parameter ist für die Optionen CONTIGUITY_EDGES_ONLY oder CONTIGUITY_EDGES_CORNERS nicht verfügbar.

Linear Unit
temporal_neighborhood
(optional)

Ein Intervall vorwärts oder rückwärts in der Zeit zum Ermitteln der Features, die in Berechnungen für das Ziel-Feature verwendet werden sollen. Features, die nicht in diesem Intervall des Ziel-Features liegen, werden in Berechnungen für dieses Feature ignoriert.

Time Unit
time_field
(optional)

Das Feld, das den Zeitstempel für den jeweiligen Datensatz des Datasets enthält. Dieses Feld muss vom Typ "Datum" sein.

Bei einer Feature-Eingabe definiert das Zeitfeld die zeitlichen Nachbarn beim Füllen fehlender Werte. Wenn eine zugehörige Tabelle angegeben ist, dann muss ein Wert angegeben werden.

Bei einer Feature- und Tabellen-Eingabe wird das Zeitfeld beim Füllen fehlender Werte unter Verwendung des zeitlichen Trends an der Position verwendet.

Field
number_of_spatial_neighbors
(optional)

Die Anzahl der nächstgelegenen Nachbarn, die in Berechnungen einbezogen werden sollen.

Wenn die Option FIXED_DISTANCE, CONTIGUITY_EDGES_ONLY oder CONTIGUITY_EDGES_CORNERS des Parameters conceptualization_of_spatial_relationships ausgewählt wurde, dann entspricht diese Zahl der Mindestanzahl der Nachbarn, die in Berechnungen einbezogen werden sollen.

Long
location_id
(optional)

Ein ganzzahliges oder Textfeld, das eine eindeutige ID-Nummer für jede Position enthält.

Wenn eine zugehörige Tabelle angegeben ist, dann wird dieses Feld verwendet, um jedes Eingabe-Features mit Zeilen in der zugehörigen Tabelle abzugleichen. Die Werte dieses Feldes müssen für jedes Eingabe-Feature eindeutig sein. Wenn keine zugehörige Tabelle angegeben ist, dann wird dieses Feld verwendet, um jede eindeutige Position zum Ermitteln zeitlicher Nachbarn festzulegen. In diesem Fall müssen die Werte dieses Feldes für jede Position eindeutig sein, aber nicht unbedingt für jedes Feature (da mehrere Features dieselbe Position haben können).

Field
related_table
(optional)

Die Tabelle bzw. Tabellensicht, die die Zeitdaten für die einzelnen Features des Parameters in_features enthält.

Table View
related_location_id
(optional)

Ein ganzzahliges oder Textfeld im Parameter related_table, das den Wert des Parameters location_id enthält, auf dem die Beziehung basieren soll.

Field
weights_matrix_file
(optional)

Der Pfad zu einer Datei mit Gewichtungen, die räumliche und potenziell zeitliche Beziehungen unter Features definieren.

File
unique_id
(optional)

Ein ganzzahliges Feld, das für jeden Datensatz im Wert des Parameters in_features einen anderen Wert enthält. Dieses Feld kann verwendet werden, um die Ergebnisse wieder mit dem jeweiligen ursprünglichen Datensatz zu verbinden.

Wenn Sie nicht über das Feld unique_id verfügen, können Sie eines erstellen, indem Sie der Feature-Class-Tabelle des Features ein ganzzahliges Feld hinzufügen und die Feldwerte berechnen, die dem Feld FID oder OBJECTID entsprechen.

Field
null_value
(optional)

Der Wert, der NULL-Werte (fehlende Werte) enthält. Wenn kein Wert angegeben ist, wird für Geodatabase-Feature-Classes und -Tabellen <NULL> vorausgesetzt. Wenn ein Wert angegeben ist, dann werden dieser Wert und alle NULL-Werte ausgefüllt. Wenn die Eingabe oder Ausgabe ein Shapefile oder eine dBASE-Tabelle ist, dann ist ein numerischer Wert des NULL-Platzhalters erforderlich.

Double
out_table
(optional)

Die Ausgabetabelle die die ausgefüllten (geschätzten) Werte enthält.

Wenn eine zugehörige Tabelle angegeben ist, dann ist die Ausgabetabelle ist erforderlich.

Table
append_to_input
(optional)

Gibt an, ob die gefüllten Wertefelder an die Eingabedaten angehängt werden sollen oder eine Ausgabe-Feature-Class oder Ausgabetabelle mit den gefüllten Wertefeldern erstellt werden soll. Wenn Sie die Felder anhängen, dann können Sie keine zugehörige Tabelle angeben, und die Umgebungseinstellung des Ausgabe-Koordinatensystems wird ignoriert.

  • APPEND_TO_INPUTDie Felder, die die ausgefüllten Werte enthalten, werden an die Eingabedaten angehängt. Bei dieser Option werden die Eingabedaten geändert.
  • NEW_FEATURESEs wird eine Ausgabe-Feature-Class oder Ausgabetabelle mit den gefüllten Wertefeldern erstellt. Dies ist die Standardeinstellung.
Boolean

Abgeleitete Ausgabe

NameErläuterungDatentyp
updated_features

Die aktualisierten Eingabe-Features (bzw. aktualisierte Tabelle) mit den gefüllten Wertefeldern.

Table View

Codebeispiel

FillMissingValues – Beispiel 1 (Python-Fenster)

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

import arcpy
arcpy.env.workspace = r"C:\STPM\Chicago.gdb"
arcpy.stpm.FillMissingValues("Chicago_Data", "Chicago_Filled", "COUNT", "AVERAGE",
                             "K_NEAREST_NEIGHBORS", "", "", "", 8)
FillMissingValues – Beispiel 2 (eigenständiges Skript)

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

# Fill missing values using a feature set and related table
# Use the results to create a space-time cube from defined locations
# Run Emerging Hot Spot Analysis on the data
# Visualize the results in 3d

# Import system modules
import arcpy

# Set overwriteOutput property to overwrite existing output, by default
arcpy.env.overwriteOutput = True

# Local variables ...
arcpy.env.workspace = r"C:\STPM\Chicago.gdb"

try:
    # Fill missing values in a feature class containing block group polygon 
    # shapes and a related table containing the incidents. Since some of the 
    # values are missing, you will fill them using the temporal trend method.
    arcpy.stpm.FillMissingValues(
            "Chicago_Feature", "Chicago_FilledFeature", "COUNT", 
            "TEMPORAL_TREND", "", "", NoneNone, "TIME", "", "MYID", 
            "Chicago_Table", "MYID", "", "", "", "Chicago_FilledTable")

    # Create a defined location space-time cube using a related table. Using a 
    # reference time at the start of the month to force binning fall on month 
    # breaks. Using temporal aggregation to sum multiple entries into one month.
    # Using the method drop location if missing values since you already filled 
    # using Fill Missing Values.
    arcpy.stpm.CreateSpaceTimeCubeDefinedLocations(
            "Chicago_FilledFeature", r"C:\STPM\Chicago_Cube.nc", "MYID",
            "APPLY_TEMPORAL_AGGREGATION", "TIME", "1 Months", "REFERENCE_TIME", 
            "10/1/2015", "", "COUNT SUM DROP_LOCATIONS", "Chicago_FilledTable",
            "MYID")

    # Run an emerging hot spot analysis on the defined locations cube. Using 
    # contiguity edges so only block groups that bound each other are considered 
    # neighbors.
    arcpy.stpm.EmergingHotSpotAnalysis(
            r"C:\STPM\Chicago_Cube.nc", "COUNT_SUM_NONE", 
            "Chicago_Cube_EmergingHotSpot", "", 1, "", "CONTIGUITY_EDGES_ONLY")

    # Use Visualize Cube in 3d to see the hot spot results for each time slice
    arcpy.stpm.VisualizeSpaceTimeCube3D(
            r"C:\STPM\Chicago_Cube.nc", "COUNT_SUM_NONE", 
            "HOT_AND_COLD_SPOT_RESULTS", "Chicago_Cube_Visualize3d")

except arcpy.ExecuteError:
    # If an error occurred when running the tool, print the messages
    print(arcpy.GetMessages())

Lizenzinformationen

  • Basic: Ja
  • Standard: Ja
  • Advanced: Ja

Verwandte Themen