Reference prices: lookups by domain/category/unit & years (table vs single value)"

In tatooheene: Technology Appraisal Toolbox for Health Economic Evaluations in the Netherlands

knitr::opts_chunk$set(
  collapse = TRUE,
  comment = "#>",
  fig.width = 7, fig.height = 4.2,
  dpi = 120
)
library(tatooheene)
library(dplyr)
library(tidyr)
library(lifecycle)

What this vignette covers

• Where the reference prices live: tatooheene::df_ref_prices.

• How to use nl_ref_prices() to:

  • filter by domain, category, unit, short_unit

  • select one or multiple years (e.g., 2022 or c (2022, 2023) ),

  • choose currency ("EUR" or "INT\$"; PPP adjusted), and

  • return either a table or a single numeric value (with a printed label).

The function is r lifecycle::badge("experimental"). Column names reflect the CBS table embedded in df_ref_prices.

The underlying data

df_ref_prices %>%
  head()

Quick starts

1) Default: all filters = "all" -> table of all reference prices over all years

nl_ref_prices()

2) Specific year* & unit -> single value

nl_ref_prices(year = 2022, unit = "Emergency care")

3) Years values for a range of years

nl_ref_prices(year = 2022:2024, category = "Nursing")

4) Multiple selections return multiple columns

# nl_ref_prices(
#   year     = 2024,
#   category = "Nursing",
#   unit     = c("Nursing day excluding personnel costs, hospital",
#                "Nursing day including personnel costs, hospital")
# )

Error messages you might see

• "Year out of range …" You asked for a year outside the available year columns in df_ref_prices. Use a valid year or pass "all" for all years.

• "For output = "value_label", provide exactly one year and a single (category, unit) combination." Single value mode needs exactly one year and one (category, unit) (and, if used, a single domain) so that exactly one row remains.

tatooheene documentation built on Dec. 15, 2025, 5:06 p.m.