Skip to contents

English | Deutsch

pksR stellt in R die Kreistabellen der Polizeilichen Kriminalstatistik (PKS) des Bundeskriminalamts (BKA) ab 2003 bereit: wie veröffentlicht oder harmonisiert auf einen Gebietsstand und eine Straftatenzuordnung, sodass sich Kreise über die Zeit vergleichen lassen.

Nicht zu verwechseln mit dem CRAN-Paket pks (probabilistische Wissensstrukturen).

Warum pksR

Das BKA veröffentlicht die Kreistabellen einmal im Jahr: bis 2012 als PDF-Jahrbücher, ab 2013 als Tabellen, jeweils mit eigenem Aufbau und eigenem Gebietsstand. Kreise wurden mehrfach zusammengelegt und geteilt (Sachsen-Anhalt 2007, Sachsen 2008, Mecklenburg-Vorpommern 2011, Göttingen 2016, Eisenach 2021), und Straftatenschlüssel ändern sich. pksR erledigt diese Arbeit einmal, offen und reproduzierbar:

  • Eine Tabelle für alle Jahre. Eine Zeile je Jahr, Kreis und Straftatenschlüssel, mit denselben Spalten und Datentypen in jedem Jahr.
  • Harmonisierte Gebietsstände. Fallzahlen werden mit den Umsteigeschlüsseln des BBSR (Bevölkerungs- oder Flächengewichte) auf einen Gebietsstand übertragen; Quoten werden danach neu berechnet, nie gemittelt.
  • Geprüfte Veröffentlichungen. Jede Datenveröffentlichung besteht vor der Veröffentlichung Konsistenzprüfungen (Bundessummen, Erhalt der Summen, Abdeckung, Plausibilität).
  • Herkunft. Jede Datei hat eine Version und eine SHA-256-Prüfsumme, und jede Zeile lässt sich auf die BKA-Datei zurückführen, aus der sie stammt.
  • Deutsch und Englisch. Meldungen, Bezeichnungen der Straftaten und Dokumentation in beiden Sprachen.

Stand

Das Paket ist in Entwicklung und noch nicht auf CRAN. Die erste Datenveröffentlichung, v2026.1 (Berichtsjahre 2003 bis 2025, Gebietsstand 2025), ist am 1. November 2026 erschienen (doi:10.5281/zenodo.23858429).

Installation

# install.packages("remotes")
remotes::install_github("ofurkancoban/pksR")

Erste Schritte

library(pksR)
options(pksR.lang = "de")   # Meldungen und Bezeichnungen auf Deutsch

# Straftaten insgesamt in allen Kreisen und Jahren, auf den neuesten Gebietsstand harmonisiert
insgesamt <- pks_get(offence = "insgesamt")

# Mehrere Straftaten auf einmal: per Kurzname, Straftatenschlüssel oder Bezeichnung
d <- pks_get(years = 2015:2025, offence = c("wohnungseinbruch", "730000", "Gewaltkriminalität"))

# Wie vom BKA veröffentlicht: jedes Jahr mit seinen eigenen Kreisen
veroeffentlicht <- pks_get(years = 2024:2025, harmonize_to = NULL)

# Auf den Gebietsstand 2016 harmonisiert, Flächengewichte für geteilte Kreise
d2016 <- pks_get(years = 2010:2015, harmonize_to = 2016, weights = "area")

# Eine feste Datenversion, für reproduzierbare Arbeiten
d <- pks_get(version = "2026.1", offence = "insgesamt")

Ohne Internet hilft das kleine Beispielpanel, das mit dem Paket ausgeliefert wird:

d <- pks_example()
pks_rates(d, per = 1000)   # Quoten je 1.000 Einwohner
pks_validate(d)            # Konsistenzprüfungen

Straftaten auswählen

offence nimmt für jedes Element eine der folgenden Formen:

Form Beispiel Ergebnis
Straftatenschlüssel "435*00" dieser Schlüssel
Kurzname, deutsch oder englisch "wohnungseinbruch", "residential_burglary" dieser Schlüssel
Vollständige Bezeichnung, in einer der beiden Sprachen "Wohnungseinbruchdiebstahl" dieser Schlüssel
Teil einer Bezeichnung "einbruch" alle passenden Schlüssel, mit einer Meldung, welche

Groß- und Kleinschreibung, Leerzeichen und Umlaute spielen keine Rolle, und ein genauer Schlüssel, Name oder eine genaue Bezeichnung hat immer Vorrang vor einem Teil. pks_offences() listet alle Schlüssel:

pks_offences("diebstahl")          # Suche nach Name oder Bezeichnung
pks_offences(lang = "en")          # englische Namen und Bezeichnungen

Einige häufige Kurznamen:

Schlüssel Deutsch Englisch
------ insgesamt total
****00 diebstahl theft
435*00 wohnungseinbruch residential_burglary
210000 raub robbery
892000 gewaltkriminalitaet violent_crime
674000 sachbeschaedigung criminal_damage
730000 rauschgiftdelikte drug_offences
899000 strassenkriminalitaet street_crime

Was die Daten enthalten

  • Jahre: 2003 bis 2025; neue Jahre fügt die Pipeline hinzu, sobald das BKA sie veröffentlicht.
  • Kreise: alle Landkreise und kreisfreien Städte, 400 im neuesten Gebietsstand; Berlin und Hamburg in jedem Jahr.
  • Straftaten: die 46 Straftatenschlüssel der Kreistabellen. Die Tabellen enthalten eine Auswahl von Schlüsseln, die sich über die Zeit ändert: 6 Schlüssel umfassen alle Jahre 2003 bis 2025, 37 Schlüssel die Jahre 2014 bis 2025.
  • Größen: Fälle, Versuche, Häufigkeitszahl (HZ, Fälle je 100.000 Einwohner), aufgeklärte Fälle, Aufklärungsquote und Tatverdächtige.

Alle Spalten beschreibt vignette("pksR-de").

Was zu beachten ist

  • 2003 bis 2012 stammen aus PDF-Jahrbüchern, die Quoten und Einwohnerzahlen, aber keine Fallzahlen enthalten. Die Fallzahlen dieser Jahre sind abgeleitet (hz * population / 1e5) und mit estimated = TRUE gekennzeichnet.
  • Geteilte Kreise sind Schätzungen: Die Gewichte unterstellen, dass sich die Fälle wie die Einwohner (oder wie die Fläche) verteilen. Solche Zeilen tragen estimated = TRUE; Zusammenlegungen sind exakt. pks_compare_weights() zeigt, wie stark sich ein Panel zwischen Bevölkerungs- und Flächengewichten ändert.
  • Brüche: Straftatendefinitionen, Gesetze und Erfassungspraxis ändern sich. Vor jeder Zeitreihe pks_breaks() prüfen.
  • Harmonisierte Daten sind veränderte Daten, keine amtlichen Zahlen des BKA.

Sprachen

options(pksR.lang = "de") stellt Meldungen und Bezeichnungen der Straftaten auf Deutsch um, options(pksR.lang = "en") auf Englisch; sonst gilt die Sprache der R-Sitzung. pks_get() und pks_offences() nehmen außerdem lang = "de" oder lang = "en". Jede Hilfeseite hat einen Abschnitt „Deutsch“.

Dokumentation

Die Website des Pakets enthält die Referenz und drei Artikel, jeweils auf Deutsch und Englisch:

Artikel Deutsch Englisch
Erste Schritte pksR-de pksR
Harmonisierung: Methoden, Annahmen und Sensitivität harmonization-de harmonization
Herkunft und Prüfung der Daten provenance-de provenance

Datenveröffentlichungen und Cache

Die Daten erstellt pksR-data, eine Pipeline, die die Originaldateien des BKA herunterlädt, auswertet, harmonisiert und prüft und jedes Ergebnis als GitHub-Veröffentlichung bereitstellt.

  • Jede Veröffentlichung hat eine Version (2026.1, 2026.2, …) und ändert sich nie; Korrekturen erscheinen als neue Version. pks_versions() listet sie, pks_manifest() zeigt die Dateien einer Veröffentlichung.
  • pks_get() lädt nur die gewünschten Jahre und prüft jede Datei gegen die SHA-256-Prüfsumme im Manifest der Veröffentlichung.
  • Downloads liegen im Cache unter tools::R_user_dir("pksR", "cache"); pks_cache_info() und pks_cache_clear() verwalten ihn.
  • Jedes Ergebnis trägt seine Herkunft als Attribute: data_version, retrieved_at, boundary_year, weights und source_urls.

Zitieren

Bitte zitieren Sie das Paket, die Datenversion und die Quellen. pks_cite() liefert alle Einträge, auch als BibTeX:

pks_cite()
pks_cite(version = "2026.1")

Jede Datenveröffentlichung ist auf Zenodo archiviert. Die Konzept-DOI 10.5281/zenodo.23858428 führt immer zur neuesten Version; zitieren Sie die DOI der verwendeten Version, für 2026.1 10.5281/zenodo.23858429.

Quellen und Nutzungsbedingungen

Der Code des Pakets steht unter der MIT-Lizenz. Für die Daten gelten die Bedingungen ihrer Quellen:

  • PKS-Tabellen: Bundeskriminalamt, Datenlizenz Deutschland, Namensnennung, Version 2.0. Quellenvermerk: „PKS Bundeskriminalamt“, Berichtsjahr, Version.
  • Umsteigeschlüssel: Bundesinstitut für Bau-, Stadt- und Raumforschung (BBSR), Datenlizenz Deutschland, Namensnennung, Version 2.0. Quellenvermerk: „BBSR Bonn“.
  • Gebietsänderungen der Gemeinden: Statistisches Bundesamt (Destatis), Gemeindeverzeichnis.
  • Logo: Deutschland als Fingerabdruck, gezeichnet von den PKS-Daten 2025 (PKS Bundeskriminalamt 2025). Die Linien sind Höhenlinien der Häufigkeitszahl der Straftaten insgesamt, über etwa 45 km geglättet; jede Linie liegt etwa 1,7 Prozent über der vorherigen und ist von Gelb (niedrig) bis Rot (hoch) eingefärbt. Es ist ein Porträt des regionalen Musters, keine Kreiskarte. Kreisgeometrien: © BKG (2025) dl-de/by-2-0, Datenquellen; VG250 zum 1. Januar 2020, verändert: Eisenach mit dem Wartburgkreis zusammengelegt (2021), geglättet und als Höhenlinien gezeichnet. Erstellt mit data-raw/logo.R.

Verwandte Pakete

  • inkaR: Regionalindikatoren des BBSR (INKAR), etwa Bevölkerung und wirtschaftliche Kovariaten für dieselben Kreise.
  • ags: Umsteigeschlüssel des BBSR für deutsche Kreisschlüssel.

Mitwirken

Fehlermeldungen und Vorschläge sind im Issue-Tracker willkommen. Probleme mit den Daten selbst (ein falscher Wert, ein fehlender Kreis) gehören am besten in die Issues von pksR-data. Hinweise für Pull Requests stehen im Leitfaden, geplante Arbeiten in der Roadmap (Englisch).

Autor

Ömer Furkan Çoban