Raten berechnen (Spatial Statistics)

Zusammenfassung

Berechnet Bruttoraten oder geglättete Raten. Die Methode "Globale empirische Bayes-Rate" glättet die Raten entsprechend einer globalen Referenzrate. Bei den Methoden "Lokale empirische Bayes-Rate", "Lokal gewichtete Durchschnittsrate" und "Lokal gewichtete Medianrate" werden lokale Nachbarn für die räumliche Glättung von Raten verwendet.

Weitere Informationen zur Funktionsweise von "Raten berechnen"

Verwendung

• Wenn der Wert des Parameters Eingabe-Tabelle oder -Features eine Tabelle ist, sind die Optionen für den Parameter Ratenmethode auf Bruttorate und Globale empirische Bayes-Rate beschränkt. Die Optionen Lokale empirische Bayes-Rate, Lokal gewichtete Durchschnittsrate und Lokal gewichtete Medianrate sind nur für räumliche Daten gültig.

• Das Werkzeug bietet mehrere Optionen für den Parameter Nachbarschaftstyp. Wenn Sie jedoch die Nachbarschaften umfassender anpassen möchten, verwenden Sie den Nachbarschafts-Explorer, um die Nachbarschaften zu konfigurieren und eine .swm-Datei zu exportieren. Verwenden Sie die .swm-Datei als Wert des Parameters Räumliche Gewichtungsmatrix.

• Niedrige Ratenwerte lassen sich möglicherweise schwierig interpretieren. Verwenden Sie den Parameter Ratenmultiplikator, um die Raten zu skalieren oder die Raten pro spezieller Einheit der Grundgesamtheit zu berichten. Wenn z. B. der Wert von Ratenmultiplikator 10.000 ist, werden die Raten als Zahl pro 10.000 Personen berichtet.

• Wenn eine Methode mit räumlicher Glättung ausgewählt ist, wird jedes fokale Feature in die eigene Nachbarschaft einbezogen. Wenn beispielsweise der Parameter Nachbarschaftstyp auf den Wert Nächste Nachbarn (K) festgelegt ist und der Parameter Anzahl der Nachbarn den Wert 7 hat, verfügt jedes Feature über eine Nachbarschaft mit 8 Features. Zum Berechnen der Rate eines fokalen Features wird die gesamte Nachbarschaft verwendet.

• Wenn der Parameter Ratenmethode auf Lokale empirische Bayes-Rate, Lokal gewichtete Durchschnittsrate oder Lokal gewichtete Medianrate festgelegt ist, enthält die Ausgabe das Feld Number of Non-Null Neighbors. Dieses Feld enthält die Anzahl der Nachbarn, einschließlich des fokalen Features, dessen Parameter Feld mit Grundgesamtheit und Zählfeld keinen negativen oder NULL-Wert enthielten.

• Features mit dem Wert 0 im Parameter Feld mit Grundgesamtheit erhalten einen NULL-Bruttoraten-Wert.

• Wenn der Parameter Ratenmethode auf Lokal gewichtete Durchschnittsrate oder Lokal gewichtete Medianrate festgelegt ist, enthält die Ausgabe das Feld Fill Missing Value. Dieses Feld gibt an, ob für ein Feature mit einem negativen oder NULL-Wert von Zählfeld oder Feld mit Grundgesamtheit eine Rate angerechnet wurde.

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Eingabetabelle oder -Features	Die Tabelle oder die Features, die Zählfelder oder Felder mit Grundgesamtheit zum Berechnen von Raten enthalten.	Table View
Ratenfelder	Die Zählfelder oder Felder mit Grundgesamtheit, die zum Berechnen von Raten verwendet werden.	Value Table
Felder an Eingabe anhängen (optional)	Gibt an, ob Felder an das Eingabe-Dataset angehängt oder in einer Ausgabetabelle oder Ausgabe-Feature-Class gespeichert werden. Aktiviert: Die Felder werden an die Eingabe-Features angehängt. Dadurch werden die Eingabedaten geändert. Deaktiviert: Eine Ausgabetabelle oder Ausgabe-Feature-Class, die die Felder enthält, wird erstellt. Dies ist die Standardeinstellung.	Boolean
Ausgabetabelle oder Ausgabe-Features (optional)	Die Ausgabetabelle oder Ausgabe-Feature-Class, die die Raten enthält, und zusätzliche Felder zum Auswerten der Raten.	Feature Class; Table
Ratenmethode (optional)	Gibt die Methode an, die zum Berechnen von Raten verwendet wird. Bruttorate—Die Raten werden berechnet, indem die Werte in "Zählfeld" durch die Werte in "Feld mit Grundgesamtheit" dividiert werden. Dies ist die Standardeinstellung. Globale empirische Bayes-Rate—Die Raten sind der gewichtete Durchschnitt der Bruttorate und der globalen Durchschnittsrate. Die Gewichtung hängt von der Größe der Grundgesamtheit ab. Lokale empirische Bayes-Rate—Die Raten sind der gewichtete Durchschnitt der Bruttorate des fokalen Features und der gewichteten Durchschnittsrate seiner Nachbarschaft. Lokal gewichtete Durchschnittsrate—Die Raten sind die räumlich gewichtete Durchschnittsrate jedes Features und seiner Nachbarschaft. Lokal gewichtete Medianrate—Die Raten sind die räumlich gewichtete Medianrate jedes Features und seiner Nachbarschaft.	String
Wahrscheinlichkeitsverteilung	Gibt die Wahrscheinlichkeitsverteilung des Zählfeldes an. Poisson—Vom Zählfeld wird angenommen, dass es einer Poisson-Verteilung folgt. Dies ist die Standardeinstellung. Binomial—Vom Zählfeld wird angenommen, dass es einer Binomialverteilung folgt.	String
Nachbarschaftstyp (optional)	Gibt die Methode an, die zum Identifizieren der Nachbarn jedes Features verwendet wird. Entfernungsband—Zur Identifizierung von Nachbarn wird eine Schwellenwertentfernung angewendet. Jedes Feature, das sich innerhalb der Schwellenwertentfernung eines fokalen Features befindet, wird als Nachbar betrachtet. Wenn die Eingabe Punkt- oder Linien-Features enthält, ist dies die Standardeinstellung. Nur Kontiguitätskanten—Polygon-Features, die eine gemeinsame Kante mit einem Feature haben oder ein Feature überlappen, werden Nachbarn des Features. Benachbarte Kanten/Ecken—Features, die ein Feature überlappen, eine gemeinsame Kante oder einen gemeinsamen Stützpunkt mit einem Feature haben, sind Nachbarn des Features. Wenn die Eingabe Polygon-Features enthält, ist dies die Standardeinstellung. Nächste Nachbarn (K)—Jedem Feature wird die gleiche Anzahl an Nachbarn (k) zugewiesen. Die k nächsten Features an einem Feature werden dessen Nachbarn. Delaunay-Triangulation—Ausgehend von den Schwerpunkten der Features wird ein nicht überlappendes Netz aus Dreiecken erstellt. Jedes Feature entspricht einem Dreiecksknoten. Knoten, die über eine gemeinsame Kante verfügen, gelten als Nachbarn. Räumliche Gewichtungen aus Datei abrufen—Die räumlichen Beziehungen zwischen Features werden in einer Datei mit einer räumlichen Gewichtungsmatrix (.swm) definiert.	String
Entfernungsband (optional)	Die für die Suche nach Nachbarn verwendete Entfernung von den einzelnen Features. Alle Features innerhalb dieser Entfernung werden als Nachbarn einbezogen.	Linear Unit
Anzahl der Nachbarn (optional)	Die Anzahl der Nachbarn, die in die Nachbarschaft eines Features einbezogen werden.	Long
Räumliche Gewichtungsmatrix (optional)	Der Pfad und Dateiname der Datei mit räumlicher Gewichtungsmatrix, die die räumlichen Beziehungen zwischen Features definiert.	File
Lokales Gewichtungsschema (optional)	Gibt das Gewichtungsschema an, das bei der Berechnung lokaler Statistiken auf Nachbarn angewendet wird. Ungewichtet—Nachbarn werden nicht gewichtet. Dies ist die Standardeinstellung. Biquadrat—Nachbarn werden nach dem Biquadrat-Kernel-Schema gewichtet. Gaussian—Nachbarn werden nach dem Gauß'schen Kernel-Schema gewichtet.	String
Kernel-Bandbreite (optional)	Die Bandbreite des Biquadrats oder der Gauß'schen lokalen Gewichtungsschemas. Wird kein Wert bereitgestellt, wird er während der Verarbeitung geschätzt und als Geoverarbeitungsmeldung einbezogen.	Linear Unit
Ratenmultiplikator	Ein konstanter Wert, der mit den Raten multipliziert wird. Dieser Parameter kann zum Skalieren der Raten oder zum Berichten der Raten pro spezieller Einheit der Grundgesamtheit verwendet werden. Wenn z. B. der Wert auf 10.000 festgelegt ist, werden die Raten als Zahl pro 10.000 Personen berichtet.	Long

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Aktualisierte Eingabetabelle	Die aktualisierte Eingabetabelle.	Table View
Ausgabe-Layer-Gruppe	Wenn für den Parameter Eingabe-Tabelle oder -Features eine Feature-Class angegeben wurde, wird ein Gruppen-Layer mit einem Layer für jede im Parameter Ratenfelder angegebene Rate ausgegeben.	Group Layer

Python

arcpy.stats.CalculateRates(in_table, rate_fields, {append_to_input}, {out_table}, {rate_method}, probability_distribution, {neighborhood_type}, {distance_band}, {number_of_neighbors}, {weights_matrix_file}, {local_weighting_scheme}, {kernel_bandwidth}, rate_multiplier)

Name	Erläuterung	Datentyp
in_table	Die Tabelle oder die Features, die Zählfelder oder Felder mit Grundgesamtheit zum Berechnen von Raten enthalten.	Table View
rate_fields [[count_field, population_field],...]	Die Zählfelder oder Felder mit Grundgesamtheit, die zum Berechnen von Raten verwendet werden.	Value Table
append_to_input (optional)	Gibt an, ob Felder an das Eingabe-Dataset angehängt oder in einer Ausgabetabelle oder Ausgabe-Feature-Class gespeichert werden. APPEND—Die Felder werden an die Eingabe-Features angehängt. Dadurch werden die Eingabedaten geändert. NO_APPEND—Eine Ausgabetabelle oder Ausgabe-Feature-Class, die die Felder enthält, wird erstellt. Dies ist die Standardeinstellung.	Boolean
out_table (optional)	Die Ausgabetabelle oder Ausgabe-Feature-Class, die die Raten enthält, und zusätzliche Felder zum Auswerten der Raten.	Feature Class; Table
rate_method (optional)	Gibt die Methode an, die zum Berechnen von Raten verwendet wird. CRUDE_RATE—Die Raten werden berechnet, indem die Werte in "Zählfeld" durch die Werte in "Feld mit Grundgesamtheit" dividiert werden. Dies ist die Standardeinstellung. GLOBAL_EMPIRICAL_BAYES—Die Raten sind der gewichtete Durchschnitt der Bruttorate und der globalen Durchschnittsrate. Die Gewichtung hängt von der Größe der Grundgesamtheit ab. LOCAL_EMPIRICAL_BAYES—Die Raten sind der gewichtete Durchschnitt der Bruttorate des fokalen Features und der gewichteten Durchschnittsrate seiner Nachbarschaft. LOCALLY_WEIGHTED_AVERAGE—Die Raten sind die räumlich gewichtete Durchschnittsrate jedes Features und seiner Nachbarschaft. LOCALLY_WEIGHTED_MEDIAN—Die Raten sind die räumlich gewichtete Medianrate jedes Features und seiner Nachbarschaft.	String
probability_distribution	Gibt die Wahrscheinlichkeitsverteilung des Zählfeldes an. POISSON—Vom Zählfeld wird angenommen, dass es einer Poisson-Verteilung folgt. Dies ist die Standardeinstellung. BINOMIAL—Vom Zählfeld wird angenommen, dass es einer Binomialverteilung folgt.	String
neighborhood_type (optional)	Gibt die Methode an, die zum Identifizieren der Nachbarn jedes Features verwendet wird. DISTANCE_BAND—Zur Identifizierung von Nachbarn wird eine Schwellenwertentfernung angewendet. Jedes Feature, das sich innerhalb der Schwellenwertentfernung eines fokalen Features befindet, wird als Nachbar betrachtet. Wenn die Eingabe Punkt- oder Linien-Features enthält, ist dies die Standardeinstellung. CONTIGUITY_EDGES_ONLY—Polygon-Features, die eine gemeinsame Kante mit einem Feature haben oder ein Feature überlappen, werden Nachbarn des Features. CONTIGUITY_EDGES_CORNERS—Features, die ein Feature überlappen, eine gemeinsame Kante oder einen gemeinsamen Stützpunkt mit einem Feature haben, sind Nachbarn des Features. Wenn die Eingabe Polygon-Features enthält, ist dies die Standardeinstellung. K_NEAREST_NEIGHBORS—Jedem Feature wird die gleiche Anzahl an Nachbarn (k) zugewiesen. Die k nächsten Features an einem Feature werden dessen Nachbarn. DELAUNAY_TRIANGULATION—Ausgehend von den Schwerpunkten der Features wird ein nicht überlappendes Netz aus Dreiecken erstellt. Jedes Feature entspricht einem Dreiecksknoten. Knoten, die über eine gemeinsame Kante verfügen, gelten als Nachbarn. GET_SPATIAL_WEIGHTS_FROM_FILE—Die räumlichen Beziehungen zwischen Features werden in einer Datei mit einer räumlichen Gewichtungsmatrix (.swm) definiert.	String
distance_band (optional)	Die für die Suche nach Nachbarn verwendete Entfernung von den einzelnen Features. Alle Features innerhalb dieser Entfernung werden als Nachbarn einbezogen.	Linear Unit
number_of_neighbors (optional)	Die Anzahl der Nachbarn, die in die Nachbarschaft eines Features einbezogen werden.	Long
weights_matrix_file (optional)	Der Pfad und Dateiname der Datei mit räumlicher Gewichtungsmatrix, die die räumlichen Beziehungen zwischen Features definiert.	File
local_weighting_scheme (optional)	Gibt das Gewichtungsschema an, das bei der Berechnung lokaler Statistiken auf Nachbarn angewendet wird. UNWEIGHTED—Nachbarn werden nicht gewichtet. Dies ist die Standardeinstellung. BISQUARE—Nachbarn werden nach dem Biquadrat-Kernel-Schema gewichtet. GAUSSIAN—Nachbarn werden nach dem Gauß'schen Kernel-Schema gewichtet.	String
kernel_bandwidth (optional)	Die Bandbreite des Biquadrats oder der Gauß'schen lokalen Gewichtungsschemas. Wird kein Wert bereitgestellt, wird er während der Verarbeitung geschätzt und als Geoverarbeitungsmeldung einbezogen.	Linear Unit
rate_multiplier	Ein konstanter Wert, der mit den Raten multipliziert wird. Dieser Parameter kann zum Skalieren der Raten oder zum Berichten der Raten pro spezieller Einheit der Grundgesamtheit verwendet werden. Wenn z. B. der Wert auf 10.000 festgelegt ist, werden die Raten als Zahl pro 10.000 Personen berichtet.	Long

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
updated_table	Die aktualisierte Eingabetabelle.	Table View
output_layer_group	Wenn für den Parameter in_table eine Feature-Class angegeben wurde, wird ein Gruppen-Layer mit einem Layer für jede im Parameter rate_fields angegebene Rate ausgegeben.	Group Layer

Codebeispiel

CalculateRates: Beispiel 1 (Python-Fenster)

Das folgende Python-Skript veranschaulicht, wie die Funktion CalculateRates verwendet wird.

import arcpy
in_features = r"C:\Health.gdb\cancer_deaths"
out_features = r"C:\Health.gdb\cancer_rate"
rate_fields = "deaths_2024 population_2024; deaths_2023 population_2023"
rate_method = "Global Empirical Bayes"
distribution = "Poisson"
scaling_factor = 100000

arcpy.stats.CalculateRates(
    in_features, rate_fields, "NO_APPEND", out_features, rate_method,
    distribution, None, None, None, None, None, None, scaling_factor)

CalculateRates: Beispiel 2 (eigenständiges Skript)

Das folgende Python-Skript veranschaulicht, wie die Funktion CalculateRates verwendet wird.

import arcpy

arcpy.env.workspace = r"C:\Health.gdb"

in_features = "cancer_deaths"
out_features = "cancer_rate"
rate_fields = "deaths_2024 population_2024; deaths_2023 population_2023"
rate_method = "RAW_RATE"
scaling_factor = 100000

arcpy.stats.CalculateRates(
    in_features, rate_fields,"NO_APPEND", out_features, rate_method, None, 
    None, None, None, None, None, None, scaling_factor)

Umgebungen

Ausgabe-Koordinatensystem