Learn R Programming

ICD10gm

An R Package for Working with the German Modification of the International Statistical Classification of Diseases and Related Health Problems

About this Package

The ICD-10 classification of diseases and related health problems (ICD-10) is an international standard for the coding of health service data. In Germany, the Federal Institute for Drugs and Medical Devices releases a German Modification (ICD-10-GM) of the classification that forms a compulsory part of all remuneration claims in the ambulatory and hospital sectors.

This package was created to facilitate the analysis of data coded using the ICD-10-GM. In particular, it has the following aims:

  1. Provide convenient access to the extended ICD-10-GM metadata
  2. Identify and extract ICD-10 codes from character strings
  3. Facilitate the specification of ICD codes for analysis, utilising the ICD hierarchy (e.g. given the specification "A0" return all subcodes in the range "A01" to "A09")
  4. Enable the historization of ICD specifications by applying the automatic code transitions provided by DIMDI, identifying potentially problematic codes

ICD10gm is designed for use in the context of medical and health services research using routinely collected claims data. It is not suitable for use in operative coding as it does not include all relevant metadata (e.g. inclusion and exclusion notes and the detailed definitions of psychiatric diagnoses). The metadata provided in the ICD10gm package is not intended to replace the official documentation, which should always be consulted when specifying ICD codes for analysis.

Getting Started

The ICD10gm package can be installed from CRAN in the usual manner:

install.packages("ICD10gm")

Basic Use

The core functionality of the package is demonstrated in the accompanying vignette.

An introductory presentation in German was given at the AGENS Methodenworkshop 2021. The slides are available online and give a brief overview of the package rationale and suggested workflow. (use left/right arrows to navigate).

Copyright

Program code is released under the MIT license.

The underlying ICD-10-GM metadata is copyright of the Federal Institute for Drugs and Medical Devices. The source files are available free of charge from their Download Centre. I believe that their use in this package is compatible with the copyright restrictions. In particular:

  • The distribution of an "added-value product" derived from the original DIMDI classification files is expressly permitted.

  • Distribution of the original classification files is forbidden. Consequently, this package distributes only the code required to process these files. Those wishing to compile the data from scratch must download the files from the BfArM download centre and agree to the copyright restrictions.

  • The package does not modify the ICD-10-GM codes, texts or other metadata in any way other than to restructure the data into a convenient form.

  • The package does not contain any commercial advertising.

  • The source of the data is clearly stated, both here and in the package documentation.

Related Packages

The icd package on CRAN has similar aims but has a slightly different approach and focusses on the US version of the ICD-10 system. (This package has now been archived and is not currently available on CRAN).

Copy Link

Version

Install

install.packages('ICD10gm')

Monthly Downloads

309

Version

1.2.5

License

MIT + file LICENSE

Maintainer

Ewan Donnachie

Last Published

February 26th, 2023

Functions in ICD10gm (1.2.5)

icd_parse

Extract all ICD codes from a character vector
icd_search

Search ICD-10-GM labels for a string
is_icd_code

Test whether a string is a valid ICD code
icd_meta_transition

data.frame detailling the changes in ICD-10-GM codes between versions
icd_meta_codes

data.frame containing metadata for all ICD-10-GM codes
icd_showchanges

Show historical changes to selected ICD-10-GM codes
icd_showchanges_icd3

Show historical changes to selected three-digit ICD-10-GM codes
get_icd_history

Get ICD history metadata
icd_history

Historize a list of ICD codes to cover the specified years
icd_meta_blocks

data.frame containing metadata for the ICD-10-GM code blocks
icd_lookup

Lookup an ICD-10 code in R
icd_browse

Lookup a 3-digit ICD-10-GM code in the official BfArM browser
icd_expand

Expand list of ICD codes to include all possible subcodes
get_icd_labels

Get or query ICD-10 labels
charlson_sundararajan

Charlson Comorbidities (Sundararajan)
charlson_rcs

Charlson Comorbidities (Royal College of Surgeons)
icd_meta_chapters

data.frame containing metadata for the ICD-10-GM chapters