README.Rmd

---
output: github_document
---

<!-- README.md is generated from README.Rmd. Please edit that file -->

```{r, include = FALSE}
knitr::opts_chunk$set(
  collapse = TRUE,
  comment = "#>",
  fig.path = "man/figures/README-",
  out.width = "100%"
)
```

# codeusage

<!-- badges: start -->

[![R-CMD-check](https://github.com/ebmdatalab/codeusage/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/ebmdatalab/codeusage/actions/workflows/R-CMD-check.yaml)

<!-- badges: end -->

The goal of `codeusage` is to make yearly summaries of **SNOMED Code Usage in Primary Care** and **ICD-10 and OPCS Code Usage in Secondary Care** in England, published by NHS Digital, available in R for research.
The interactive [Code Usage Explorer](https://milanwiedemann.shinyapps.io/codeusage/) dashboard provides different options to explore these datasets.  
The original data is available from NHS Digital at:

-   [SNOMED Code Usage in Primary Care](https://digital.nhs.uk/data-and-information/publications/statistical/mi-snomed-code-usage-in-primary-care)
-   [ICD-10 and OPCS Code Usage in Secondary Care](https://digital.nhs.uk/data-and-information/publications/statistical/hospital-admitted-patient-care-activity)

## Installation

You can install the development version of `codeusage` like so:

``` r
remotes::install_github("ebmdatalab/codeusage")
```

## Example

```{r load-pkg}
# Load codeusage package
library(codeusage)
```

### Dataset: SNOMED Code Usage in Primary Care in England

This is only a selection of the full dataset published by NHS Digital, for the data pre-processing see `/data-raw/snomed_code_usage.R`.

```{r snomed-usage}
# Return SNOMED code usage data
snomed_usage
```

### Dataset: ICD-10 Code Usage in Secondary Care in England

This is the total annual count of the Finished Consultant Episodes (FCE) listing each 4-character ICD-10 code either in primary or secondary diagnosis position in the Hospital Episode Statistics in England.

This is only a selection of the full dataset published by NHS Digital, for the data pre-processing see `/data-raw/icd10_usage.R`.

```{r icd10-usage}
# Return ICD-10 code usage data
icd10_usage
```

### Dataset: OPCS Code Usage in Secondary Care in England

This is the total annual count of each instance that each 4-character OPCS code is listed across all primary and secondary procedure positions in the Finished Consultant Episodes (FCE) of the Hospital Episode Statistics in England.

This is only a selection of the full dataset published by NHS Digital, for the data pre-processing see `/data-raw/opcs_usage.R`.

```{r opcs-usage}
# Return OPCS code usage data
opcs_usage
```