Fehlende Werte ausfüllen (Space Time Pattern Mining)

Zusammenfassung

Ersetzt fehlende Werte (NULL-Werte) durch Schätzwerte, die auf räumlichen Nachbarn, Raum-Zeit-Nachbarn, Zeitserienwerten oder globalen Statistikwerten basieren.

Weitere Informationen zur Funktionsweise des Werkzeugs Fehlende Werte ausfüllen

Abbildung

Abbildung des Werkzeugs "Fehlende Werte ausfüllen"

Verwendung

  • Als Wert des Parameters Eingabe-Features oder Eingabetabelle können Punkt- oder Polygon-Features oder eine Standalone-Tabelle verwendet werden.

  • Bei einem Eingabe-Feature können die fehlenden Werte basierend auf 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 basierend auf globalen Statistiken des Eingabefeldes oder auf Zeitserienwerten 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 drei Felder für jedes Feld des Parameters Auszufüllende Felder. Das erste enthält die ursprünglichen und die ausgefüllten Werte und das zweite 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. Für Eingabe-Features ist das dritte Feld das Feld mit der Anzahl der Nachbarn, <field>_ N_NEIGHBORS, die in Berechnungen für jeden geschätzten Wert verwendet wird. Für Eingabe-Standalone-Tabellen ist das dritte Feld das Feld mit der Anzahl der Datensätze, <field>_NUM_REC_USED, die in Berechnungen für jeden geschätzten Wert verwendet wird.

  • Für 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 gesetzt 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 gesetzt 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 herangezogen werden.

  • Für Standalone-Tabellen enthält die Ausgabe Felder mit Werten, die Ihnen ein besseres Verständnis der Statistiken und des Bereichs der Werte im Feld, die keine NULL-Werte sind, vermitteln, die in den Berechnungen für den fehlenden Zielwert herangezogen werden. Wenn der Parameter Füllmethode auf Durchschnitt gesetzt ist, wird die in Berechnungen verwendete Standardabweichung (<field>_STD) aller Werte im Feld, die keine NULL-Werte sind, aufgezeichnet. Der Maximalwert des Feldes (<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 gesetzt ist, wird die mittlere absolute Abweichung (<field>_MAD) der Feld, die keine NULL-Werte sind, 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 wird und mit dem Sie die Ergebnisse wieder dem Eingabe-Feature oder der Tabelle hinzufügen können.

  • 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.

  • Sie können die zusätzlichen Felder an das Eingabe-Feature oder die Eingabetabelle anhängen, indem Sie den Parameter Felder an Eingabe anhängen verwenden. Wenn Sie diese Felder anhängen, kann keine zugehörige Tabelle bereitgestellt werden.

  • Für Eingabe-Features kann der Parameter Positions-D je nach der Struktur der Eingabe-Raum-Zeit-Daten auf unterschiedliche Weise verwendet werden.

    • Wenn die Daten in einer zugehörigen Tabelle gespeichert sind (das heißt, Sie verwenden bestimmte Features in einer Feature-Class mit einer zugehörigen Tabelle, in der Attribute im Zeitverlauf enthalten sind) und Sie die fehlenden Werte in der zugehörigen Tabelle füllen möchten, dann können Sie den Parameter Zugehörige Tabelle verwenden. Der Wert des Parameters Positions-ID muss jedes Feature in der Eingabe-Feature-Class mit einer Gruppe von Datensätzen in der zugehörigen Tabelle abgleichen und muss für jedes Eingabe-Feature eindeutig sein.
    • Wenn die Daten in derselben Feature-Class gespeichert sind (das heißt, durch Wiederholung von Shapes oder Geometrie), gibt der Parameter Positions-ID jede eindeutige Position in der Feature-Class an. In den US-Bevölkerungsdaten auf Landkreisebene für 10 Jahre wiederholt sich zum Beispiel in der Feature-Class jeder Landkreis 10 Mal. In diesem Fall wird die Landkreis-ID zur Angabe der Position jedes Landkreises verwendet. Die Positions-ID muss für jede Position, aber nicht unbedingt für jedes Feature eindeutig sein.

  • Der Wert Positions-ID ist ein Ganzzahl- oder Textfeld und sollte eine eindeutige und stationäre Position darstellen. Sie sollte keine unterschiedlichen XY-Koordinaten im Zeitverlauf aufweisen.

  • Dieses Werkzeug kann mit Bereichsdaten verwendet werden, die als wiederholte Shapes oder mit einer zugehörigen Tabelle gespeichert werden. Bei Angabe eines Wertes für den Parameter Positions-ID 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 und kein Wert für den Parameter Zeitfeld angegeben wurde, werden die geschätzten Werte unter Verwendung der Datensätze mit derselben Positions-ID wie die Position mit dem zu füllenden NULL-Wert berechnet. Wenn Sie zum Beispiel in den US-Daten auf Landkreisebene die fehlenden Werten unter Verwendung des Durchschnitts aller Landkreise in demselben Bundesstaat füllen möchten, dann können Sie ein Feld verwenden, das den Bundesstaat als Positions-ID darstellt.

  • Wenn die Werte der beiden Parameter Positions-ID und Zeitfeld Eingabe-Standalone-Tabellen sind, 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 der Parameterwert Anzahl von räumlichen Nachbarn zum Festlegen einer Mindestanzahl von Nachbarn eingestellt werden.

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

  • Wenn Werte mit der Option Zeitlicher Trend gefüllt werden, muss der NULL-Wert mindestens zwei Zeiträume mit Werten am Anfang und mindestens zwei Zeiträume mit Werten am Ende der Zeitserie aufweisen, um ausgefüllt zu werden. Aufgrund dieser Anforderung können NULL-Werte, die in den beiden ersten oder in den beiden letzten Zeitschritten vorhanden sind, nicht mit der Option Zeitlicher Trend gefüllt werden.

  • Die Option Zeitlicher Trend verwendet die Methode "Interpolated Univariate Spline" im Interpolationspaket von SciPy.

  • Wenn die fehlenden Werte von Bereichsdaten mit räumlichen Nachbarn gefüllt werden, 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 verwenden, um nach Zeit zu filtern. Alternativ können Sie mit einem Wert für Zeitliche Nachbarschaft von 0 lediglich räumliche Nachbarn anzeigen.

  • Es ist wichtig, die resultierenden Füllwerte zu überprüfen, um sicherzustellen, dass sie für Ihre Analyse sinnvoll sind. Wenn Ihr ursprüngliches Feld beispielsweise eine ganze Zahl enthielt und Sie das Werkzeug so eingestellt hatten, dass es zum Füllen den Durchschnitt räumlicher Nachbarn verwendet, dann sind in den Ergebnissen Dezimalzahlen enthalten, was nicht sinnvoll wäre, wenn es sich beim Eingabefeld um eine Anzahl gehandelt hat. Außerdem kann je 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 gibt die Anzahl der Nachbarn aus, die in die Berechnungen für dieses Feature eingeschlossen wird. Wenn für den Parameter Füllmethode die Option Zeitlicher Trend festgelegt ist, gibt diese Zahl die Anzahl der Werte an, die in der Zeitserie für diesen Positions-ID-Wert vorhanden ist (wenn in der Zeitserie beispielsweise nur ein Wert fehlt, wird die Anzahl der Zeitschritte in Ihrem Dataset minus 1 gemeldet). Wenn Sie den Parameterwert Konzeptualisierung von räumlichen Beziehungen der k nächsten Nachbarn sowie einen Zeitliche Nachbarschaft-Wert verwenden, enthält die Anzahl der gemeldeten Nachbarn die k Nachbarn für das Feature, die im festgelegten Zeitfenster liegen.

  • Der Parameter NULL-Wert enthält die NULL-Werte (fehlende Werte). Dieser Parameter wird je nach Eingabe- und Ausgabeformat auf unterschiedliche Weise verwendet.

    • Bei Geodatabase-Feature-Classes oder -Tabellen gilt <NULL> als NULL-Wert (fehlender Wert), wenn für den Parameter NULL-Wert kein Wert angegeben wurde. Wenn ein Wert angegeben wurde, dann werden dieser Wert und die NULL-Werte in der Ausgabe des Werkzeugs geschätzt.
    • Bei 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 Feature-Class oder Tabelle in einer File-Geodatabase 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 Ausgabe des Werkzeugs dargestellt werden sollen.

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

  • 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 SchaltflächePop-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 Punkt- oder Polygon-Feature-Class oder Standalone-Tabelle, die die auszufüllenden NULL-Werte enthält.

Wenn im Parameter Zugehörige Tabelle ein Wert angegeben wurde, dann sind die auszufüllenden NULL-Werte in der zugehörigen Tabelle enthalten. Die Eingabe-Features werden den Zeilen in der zugehörigen Tabelle zugeordnet, um die Raum-Zeit-Nachbarn anzugeben.

Feature Layer; Table View
Ausgabe-Features oder -Tabelle
(optional)

Die Ausgabe-Features bzw. die Standalone-Tabelle, die die ausgefüllten (geschätzten) Werte enthält.

Wenn im Parameter Zugehörige Tabelle ein Wert angegeben wurde, dann enthält die Ausgabe dieses Parameters die Anzahl der geschätzten Werte an jeder Position, und die im Parameter Ausgabetabelle angegebene Tabelle 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, der angewendet wird. Die Option Zeitlicher Trend ist nur verfügbar, wenn die Parameterwerte Positions-ID und Zeitfeld angegeben sind.

  • DurchschnittNULL-Werte werden durch den Mittelwert (Durchschnittswert) der Nachbarn des Features oder den Mittelwert des zu füllenden Feldes bei Standalone-Tabellen ersetzt.
  • MinimumNULL-Werte werden durch den Minimalwert (kleinsten Wert) der Nachbarn des Features oder den Minimalwert des zu füllenden Feldes bei Standalone-Tabellen ersetzt.
  • MaximumNULL-Werte werden durch den Maximalwert (größten Wert) der Nachbarn des Features oder den Maximalwert des zu füllenden Feldes bei Standalone-Tabellen ersetzt.
  • MedianwertNULL-Werte werden durch den Medianwert (sortierten Mittelwert) der Nachbarn des Features oder den Medianwert des zu füllenden Feldes bei 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.

  • Feste EntfernungBenachbarte Features innerhalb einer angegebenen kritischen Entfernung (Parameterwert 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 benachbarte KantenNur benachbarte Polygon-Features mit einer gemeinsamen Grenze oder mit einer Überlappung beeinflussen Berechnungen für das Ziel-Polygon-Feature.
  • Benachbarte Kanten/EckenPolygon-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 Grenzwertes für ein Ziel-Feature werden in Berechnungen für dieses Feature ignoriert. Dieser Parameter ist für die Optionen Nur benachbarte Kanten und Benachbarte Kanten/Ecken nicht verfügbar.

Linear Unit
Zeitliche Nachbarschaft
(optional)

Ein Intervall vorwärts oder rückwärts in der Zeit, das ermittelt, welche Features in Berechnungen für das Ziel-Feature verwendet werden. 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 beim Ausfüllen von fehlenden Werten zeitliche Nachbarn. Wenn eine zugehörige Tabelle angegeben wird, muss ein Wert angegeben werden.

Bei einer Feature- und Tabelleneingabe wird das Zeitfeld beim Ausfüllen von fehlenden Werten unter Verwendung eines zeitlichen Trends an der Position verwendet.

Field
Anzahl der räumlichen Nachbarn
(optional)

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

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

Long
Positions-ID
(optional)

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

Wenn eine zugehörige Tabelle angegeben wurde, wird dieses Feld verwendet, um jedes Eingabe-Feature mit Zeilen in der zugehörigen Tabelle abzugleichen. Die Werte dieses Feldes müssen für jedes Eingabe-Feature eindeutig sein. Wenn eine zugehörige Tabelle nicht angegeben wurde, wird dieses Feld verwendet, um jede eindeutige Position in den Eingabe-Features anzugeben, damit zeitliche Nachbarn bestimmt werden können. In diesem Fall müssen die Werte dieses Feldes für jede Position, aber nicht unbedingt für jedes Feature eindeutig sein (da auch mehrere Features dieselbe Positionsangabe haben können).

Field
Zugehörige Tabelle
(optional)

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

Table View
Zugehörige Positions-ID
(optional)

Ein Ganzzahl- oder Textfeld im Parameter Zugehörige Tabelle, das den Parameterwert Positions-ID enthält, auf dem die Beziehung basiert.

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 des Parameterwertes Eingabe-Features oder Eingabetabelle 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 der Wert <NULL> vorausgesetzt. Wenn ein Wert angegeben wurde, dann werden dieser Wert und alle NULL-Werte gefüllt. Wenn die Eingabe oder Ausgabe ein Shapefile oder eine dBASE-Tabelle ist, ist ein numerischer Wert des NULL-Platzhalters erforderlich.

Double
Ausgabetabelle
(optional)

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

Die Ausgabetabelle ist erforderlich, wenn eine zugehörige Tabelle angegeben wird.

Table
Felder an Eingabedaten anhängen
(optional)

Gibt an, ob die ausgefüllten Wertefelder an die Eingabedaten angehängt werden oder eine Ausgabe-Feature-Class mit den ausgefüllten Wertefeldern erstellt wird. Wenn Sie die Felder anhängen, können Sie keine zugehörige Tabelle bereitstellen, und die Umgebung des Ausgabekoordinatensystems wird ignoriert.

  • Aktiviert: Die Felder, die die ausgefüllten Werte enthalten, werden an die Eingabedaten angehängt. Mit dieser Option werden die Eingabedaten geändert.
  • Deaktiviert: Eine Ausgabe-Feature-Class oder Ausgabetabelle, welche die ausgefüllten Wertefelder enthält, wird erstellt. Dies ist die Standardeinstellung.

Boolean

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Aktualisierte Eingabe-Features oder -Tabelle

Die aktualisierten Eingabe-Features oder Eingabetabellen, welche die ausgefüllten Wertefelder enthalten.

Feature Layer, 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 Punkt- oder Polygon-Feature-Class oder Standalone-Tabelle, die die auszufüllenden NULL-Werte enthält.

Wenn im Parameter related_table ein Wert angegeben wurde, dann sind die auszufüllenden NULL-Werte in der zugehörigen Tabelle enthalten. Die Eingabe-Features werden den Zeilen in der zugehörigen Tabelle zugeordnet, um die Raum-Zeit-Nachbarn anzugeben.

Feature Layer; Table View
out_features
(optional)

Die Ausgabe-Features bzw. die Standalone-Tabelle, die die ausgefüllten (geschätzten) Werte enthält.

Wenn im Parameter related_table ein Wert angegeben wurde, dann enthält die Ausgabe dieses Parameters die Anzahl der geschätzten Werte an jeder Position, und die im Parameter out_table angegebene Tabelle 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, der angewendet wird. Die Option TEMPORAL_TREND ist nur verfügbar, wenn die Parameterwerte 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.

  • FIXED_DISTANCEBenachbarte Features innerhalb einer angegebenen kritischen Entfernung (Parameterwert 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 Grenzwertes für ein Ziel-Feature werden in Berechnungen für dieses Feature ignoriert. Dieser Parameter ist für die Optionen CONTIGUITY_EDGES_ONLY und CONTIGUITY_EDGES_CORNERS nicht verfügbar.

Linear Unit
temporal_neighborhood
(optional)

Ein Intervall vorwärts oder rückwärts in der Zeit, das ermittelt, welche Features in Berechnungen für das Ziel-Feature verwendet werden. 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 beim Ausfüllen von fehlenden Werten zeitliche Nachbarn. Wenn eine zugehörige Tabelle angegeben wird, muss ein Wert angegeben werden.

Bei einer Feature- und Tabelleneingabe wird das Zeitfeld beim Ausfüllen von fehlenden Werten unter Verwendung eines zeitlichen Trends an der Position verwendet.

Field
number_of_spatial_neighbors
(optional)

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

Bei Auswahl der Option FIXED_DISTANCE, CONTIGUITY_EDGES_ONLY oder CONTIGUITY_EDGES_CORNERS des Parameters conceptualization_of_spatial_relationships entspricht diese Zahl der Mindestanzahl von Nachbarn, die in Berechnungen einbezogen werden sollen.

Long
location_id
(optional)

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

Wenn eine zugehörige Tabelle angegeben wurde, wird dieses Feld verwendet, um jedes Eingabe-Feature mit Zeilen in der zugehörigen Tabelle abzugleichen. Die Werte dieses Feldes müssen für jedes Eingabe-Feature eindeutig sein. Wenn eine zugehörige Tabelle nicht angegeben wurde, wird dieses Feld verwendet, um jede eindeutige Position in den Eingabe-Features anzugeben, damit zeitliche Nachbarn bestimmt werden können. In diesem Fall müssen die Werte dieses Feldes für jede Position, aber nicht unbedingt für jedes Feature eindeutig sein (da auch mehrere Features dieselbe Positionsangabe haben können).

Field
related_table
(optional)

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

Table View
related_location_id
(optional)

Ein Ganzzahl- oder Textfeld im Parameter related_table, das den Parameterwert location_id enthält, auf dem die Beziehung basiert.

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 des Parameterwerts 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 Tabelle der Feature-Class 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 der Wert <NULL> vorausgesetzt. Wenn ein Wert angegeben wurde, dann werden dieser Wert und alle NULL-Werte gefüllt. Wenn die Eingabe oder Ausgabe ein Shapefile oder eine dBASE-Tabelle ist, ist ein numerischer Wert des NULL-Platzhalters erforderlich.

Double
out_table
(optional)

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

Die Ausgabetabelle ist erforderlich, wenn eine zugehörige Tabelle angegeben wird.

Table
append_to_input
(optional)

Gibt an, ob die ausgefüllten Wertefelder an die Eingabedaten angehängt werden oder eine Ausgabe-Feature-Class mit den ausgefüllten Wertefeldern erstellt wird. Wenn Sie die Felder anhängen, können Sie keine zugehörige Tabelle bereitstellen, und die Umgebung des Ausgabekoordinatensystems wird ignoriert.

  • APPEND_TO_INPUTDie Felder, die die ausgefüllten Werte enthalten, werden an die Eingabedaten angehängt. Mit dieser Option werden die Eingabedaten geändert.
  • NEW_FEATURESEine Ausgabe-Feature-Class oder Ausgabetabelle, welche die ausgefüllten Wertefelder enthält, wird erstellt. Dies ist die Standardeinstellung.
Boolean

Abgeleitete Ausgabe

NameErläuterungDatentyp
updated_features

Die aktualisierten Eingabe-Features oder Eingabetabellen, welche die ausgefüllten Wertefelder enthalten.

Feature Layer, 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