Metadata Processing for the German Modification of the ICD-10 Coding System

Provides convenient access to the German modification of the International Classification of Diagnoses, 10th revision (ICD-10-GM). It provides functionality to aid in the identification, specification and historisation of ICD-10 codes. Its intended use is the analysis of routinely collected data in the context of epidemiology, medical research and health services research. The underlying metadata are released by the German Institute for Medical Documentation and Information <>, and are redistributed in accordance with their license.

Travis build status CRAN status DOI

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 German Instutite of Medical Documentation and Information (DIMDI) 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 DIMDI documentation, which should always be consulted when specifying ICD codes for analysis.

Getting Started

The package is not (yet) available from CRAN but can be installed from github as follows:

# Install the devtools package if not already installed
if (!("devtools" %in% .packages(all.available=TRUE))) install.package("devtools")
# Install ICD10gm package from github

Basic Use

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


Program code is released under the MIT license.

The underlying ICD-10-GM metadata is copyright of the German Instutite of Medical Documentation and Information (DIMDI). The source files are available free of charge from the DIMDI 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 DIMDI 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.


ICD10gm 1.0.3

CRAN resubmission:

  • The Description has been changed according to CRAN guidelines (Deleted "The ICD10gm package")
  • Examples have been added to the Rd files
  • Vignette no longer evaluates web-scraping example
  • Further minor improvements to documentation

Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.


1.2.2 by Ewan Donnachie, 6 months ago,

Report a bug at

Browse source code at

Authors: Ewan Donnachie [aut, cre]

Documentation:   PDF Manual  

MIT + file LICENSE license

Imports magrittr, dplyr, purrr, tidyr, tidyselect, stringi, rlang, tibble

Suggests testthat, knitr, rmarkdown, rvest

See at CRAN