Raten berechnen (Spatial Statistics)

Zusammenfassung

Berechnet rohe oder geglättete Raten. Die Methode "Globale empirische Bayes-Rate" glättet die Raten in Richtung einer globalen Referenzrate. Die Methoden "Lokale empirische Bayes-Rate", "Lokal gewichtete Durchschnittsrate" und "Lokal gewichtete Medianrate" verwenden lokale Nachbarn, um Raten räumlich zu glätten.

Informationen zur Funktionsweise von "Raten berechnen"

Verwendung

• Wenn der Wert des Parameters Eingabe-Features oder -Tabelle 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 die Nachbarschaften jedoch weiter 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 den Parameterwert Räumliche Gewichtungsmatrix.

• Wenn die Ratenwerte klein sind, sind sie eventuell schwer zu interpretieren. Verwenden Sie den Parameter Ratenmultiplikator, um die Raten zu skalieren oder um die Raten pro spezifischer Bevölkerungseinheit anzugeben. Wenn der Wert für den Ratenmultiplikator zum Beispiel 10.000 beträgt, werden die Raten als Zahl pro 10.000 Personen angegeben.

• Wenn eine räumliche Glättungsmethode gewählt wird, wird jedes fokale Feature in seine eigene Nachbarschaft aufgenommen. Wenn zum Beispiel für Nachbarschaftstyp der Wert Nächste Nachbarn (K) und für Anzahl der Nachbarn der Wert 7 ist, hat jedes Feature eine Nachbarschaft mit 8 Features. Die gesamte Nachbarschaft wird verwendet, um die Rate eines fokalen Features zu berechnen.

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

• Features mit einem Wert von 0 im Feld mit Grundgesamtheit erhalten einen Bruttoraten-NULL-Wert.

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

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Eingabe-Features oder -Tabelle	Die Tabelle oder Features, die die Zählfelder und Felder mit Grundgesamtheit zur Berechnung der Raten enthalten.	Table View
Ratenfelder	Die Zählfelder und Felder mit Grundgesamtheit zur Berechnung der Raten.	Value Table
Felder an Eingabedaten anhängen (optional)	Gibt an, ob die Felder an das Eingabe-Dataset angehängt oder in einer Ausgabe-Tabelle oder -Feature-Class gespeichert werden sollen. Aktiviert: Felder werden an die Eingabe-Features angehängt. Damit werden die Eingabedaten geändert. Deaktiviert: Eine Ausgabetabelle oder -Feature-Class, die die Felder enthält, wird erstellt. Dies ist die Standardeinstellung.	Boolean
Ausgabe-Features oder -Tabelle (optional)	Die Ausgabetabelle oder -Feature-Class, die die Raten enthält, und weitere Felder, mit denen die Raten ausgewertet werden.	Feature Class; Table
Ratenmethode (optional)	Gibt die Methode an, die zum Berechnen der Raten verwendet wird. Bruttorate—Die Raten werden berechnet, indem die Werte der Zählfelder durch die Werte der Felder mit Grundgesamtheit geteilt werden. Dies ist die Standardeinstellung. Globale empirische Bayes-Rate—Die Raten sind der gewichtete Durchschnitt der Bruttorate und die globale Durchschnittsrate. Die Gewichtung hängt von der Größe der Population des Features ab. Lokale empirische Bayes-Rate—Die Raten sind der gewichtete Durchschnitt der Bruttorate des fokalen Features sowie die gewichtete Durchschnittsrate seiner Nachbarschaft. Lokal gewichtete Durchschnittsrate—Die Rate ist die räumlich gewichtete Durchschnittsrate jedes Features und seiner Nachbarschaft. Lokal gewichtete Medianrate—Die Rate ist die räumlich gewichtete Medianrate jedes Features und seiner Nachbarschaft.	String
Wahrscheinlichkeitsverteilung	Gibt die Wahrscheinlichkeitsverteilung des Zählfeldes an. Poisson—Es wird angenommen, dass das Zählfeld einer Poisson-Verteilung folgt. Dies ist die Standardeinstellung. Binomial—Es wird angenommen, dass das Zählfeld einer Binomialverteilung folgt.	String
Nachbarschaftstyp (optional)	Gibt die Methode an, die zum Identifizieren der Nachbarn jedes Features verwendet wird. Entfernungsband—Eine Schwellenwertentfernung wird zur Identifizierung von Nachbarn 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 benachbarte Kanten—Polygon-Features, die eine gemeinsame Kante mit einem Feature haben oder ein Feature überlappen, werden Nachbarn dieses Features. Benachbarte Kanten/Ecken—Features, die ein Feature überlappen, eine gemeinsame Kante oder einen gemeinsamen Stützpunkt mit einem Feature haben, sind Nachbarn dieses Features. Wenn die Eingabe Polygon-Features enthält, ist dies die Standardeinstellung. Nächste Nachbarn (K)—Jedem Feature wird die gleiche Anzahl von Nachbarn (K) zugewiesen. Die nächsten K Features eines Features werden dessen Nachbarn. Delaunay-Triangulation—Erstellt ausgehend von den Schwerpunkten der Features ein nicht überlappendes Netz aus Dreiecken. 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 sind in einer räumlichen Gewichtungsmatrix-Datei (.swm) definiert.	String
Entfernungsband (optional)	Die Entfernung von jedem Feature, die für die Suche nach Nachbarn relevant ist. Alle Features innerhalb dieser Entfernung werden als Nachbarn aufgenommen.	Linear Unit
Anzahl der Nachbarn (optional)	Die Anzahl der Nachbarn, die in die Nachbarschaft eines Features aufgenommen werden.	Long
Räumliche Gewichtungsmatrix (optional)	Der Pfad und Dateiname der räumlichen Gewichtungsmatrix-Datei, die die räumlichen Beziehungen zwischen den Features definiert.	File
Lokales Gewichtungsschema (optional)	Gibt das Gewichtungsschema an, das bei der Berechnung der lokalen Statistiken auf die Nachbarn angewendet wird. Ungewichtet—Nachbarn werden nicht gewichtet. Dies ist die Standardeinstellung. Biquadrat—Nachbarn werden unter Verwendung eines Biquadrat-Kernel-Schemas gewichtet. Gauß—Nachbarn werden mit einem Gaußschen Kernel-Schema gewichtet.	String
Kernel-Bandbreite (optional)	Die Bandbreite der Biquadrat- oder lokalen Gaußschen Gewichtungsschemas. Wenn kein Wert angegeben wird, wird dieser während der Verarbeitung geschätzt und als Geoverarbeitungsmeldung aufgenommen.	Linear Unit
Ratenmultiplikator	Ein konstanter Wert, der mit den Raten multipliziert wird. Mit diesem Parameter können Sie die Raten skalieren oder die Raten pro spezifischer Bevölkerungseinheit angeben. Wenn der Wert zum Beispiel 10.000 beträgt, werden die Raten als Zahl pro 10.000 Personen angegeben.	Long

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Aktualisierte Eingabetabelle	Die aktualisierte Eingabetabelle.	Table View
Ausgabe-Layer-Gruppe	Wenn für den Parameter Eingabe-Features oder -Tabelle eine Feature-Class angegeben ist, 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 Features, die die Zählfelder und Felder mit Grundgesamtheit zur Berechnung der Raten enthalten.	Table View
rate_fields [[count_field, population_field],...]	Die Zählfelder und Felder mit Grundgesamtheit zur Berechnung der Raten.	Value Table
append_to_input (optional)	Gibt an, ob die Felder an das Eingabe-Dataset angehängt oder in einer Ausgabe-Tabelle oder -Feature-Class gespeichert werden sollen. APPEND—Felder werden an die Eingabe-Features angehängt. Damit werden die Eingabedaten geändert. NO_APPEND—Eine Ausgabetabelle oder -Feature-Class, die die Felder enthält, wird erstellt. Dies ist die Standardeinstellung.	Boolean
out_table (optional)	Die Ausgabetabelle oder -Feature-Class, die die Raten enthält, und weitere Felder, mit denen die Raten ausgewertet werden.	Feature Class; Table
rate_method (optional)	Gibt die Methode an, die zum Berechnen der Raten verwendet wird. CRUDE_RATE—Die Raten werden berechnet, indem die Werte der Zählfelder durch die Werte der Felder mit Grundgesamtheit geteilt werden. Dies ist die Standardeinstellung. GLOBAL_EMPIRICAL_BAYES—Die Raten sind der gewichtete Durchschnitt der Bruttorate und die globale Durchschnittsrate. Die Gewichtung hängt von der Größe der Population des Features ab. LOCAL_EMPIRICAL_BAYES—Die Raten sind der gewichtete Durchschnitt der Bruttorate des fokalen Features sowie die gewichtete Durchschnittsrate seiner Nachbarschaft. LOCALLY_WEIGHTED_AVERAGE—Die Rate ist die räumlich gewichtete Durchschnittsrate jedes Features und seiner Nachbarschaft. LOCALLY_WEIGHTED_MEDIAN—Die Rate ist die räumlich gewichtete Medianrate jedes Features und seiner Nachbarschaft.	String
probability_distribution	Gibt die Wahrscheinlichkeitsverteilung des Zählfeldes an. POISSON—Es wird angenommen, dass das Zählfeld einer Poisson-Verteilung folgt. Dies ist die Standardeinstellung. BINOMIAL—Es wird angenommen, dass das Zählfeld einer Binomialverteilung folgt.	String
neighborhood_type (optional)	Gibt die Methode an, die zum Identifizieren der Nachbarn jedes Features verwendet wird. DISTANCE_BAND—Eine Schwellenwertentfernung wird zur Identifizierung von Nachbarn 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 dieses Features. CONTIGUITY_EDGES_CORNERS—Features, die ein Feature überlappen, eine gemeinsame Kante oder einen gemeinsamen Stützpunkt mit einem Feature haben, sind Nachbarn dieses Features. Wenn die Eingabe Polygon-Features enthält, ist dies die Standardeinstellung. K_NEAREST_NEIGHBORS—Jedem Feature wird die gleiche Anzahl von Nachbarn (K) zugewiesen. Die nächsten K Features eines Features werden dessen Nachbarn. DELAUNAY_TRIANGULATION—Erstellt ausgehend von den Schwerpunkten der Features ein nicht überlappendes Netz aus Dreiecken. 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 sind in einer räumlichen Gewichtungsmatrix-Datei (.swm) definiert.	String
distance_band (optional)	Die Entfernung von jedem Feature, die für die Suche nach Nachbarn relevant ist. Alle Features innerhalb dieser Entfernung werden als Nachbarn aufgenommen.	Linear Unit
number_of_neighbors (optional)	Die Anzahl der Nachbarn, die in die Nachbarschaft eines Features aufgenommen werden.	Long
weights_matrix_file (optional)	Der Pfad und Dateiname der räumlichen Gewichtungsmatrix-Datei, die die räumlichen Beziehungen zwischen den Features definiert.	File
local_weighting_scheme (optional)	Gibt das Gewichtungsschema an, das bei der Berechnung der lokalen Statistiken auf die Nachbarn angewendet wird. UNWEIGHTED—Nachbarn werden nicht gewichtet. Dies ist die Standardeinstellung. BISQUARE—Nachbarn werden unter Verwendung eines Biquadrat-Kernel-Schemas gewichtet. GAUSSIAN—Nachbarn werden mit einem Gaußschen Kernel-Schema gewichtet.	String
kernel_bandwidth (optional)	Die Bandbreite der Biquadrat- oder lokalen Gaußschen Gewichtungsschemas. Wenn kein Wert angegeben wird, wird dieser während der Verarbeitung geschätzt und als Geoverarbeitungsmeldung aufgenommen.	Linear Unit
rate_multiplier	Ein konstanter Wert, der mit den Raten multipliziert wird. Mit diesem Parameter können Sie die Raten skalieren oder die Raten pro spezifischer Bevölkerungseinheit angeben. Wenn der Wert zum Beispiel 10.000 beträgt, werden die Raten als Zahl pro 10.000 Personen angegeben.	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 ist, 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

Lizenzinformationen

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