csdata

Overview

csdata ships preformatted structural data for Norway:

• geographic codes and display names;
• the hierarchy that links city districts to municipalities, counties and regions;
• yearly population counts by age and sex;
• the proportional weights that move historical figures onto current municipal borders.

The package bundles each dataset and returns it as a data.table. No call reaches the network. Boundaries follow the 2024 administrative borders. border = 2024 is the only accepted value.

Installation

install.packages("csdata")

# development version
# # remotes::install_github("niphr/csdata")
install.packages("csdata", repos = c('https://niphr.r-universe.dev', 'https://cloud.r-project.org'))

Quick start

library(csdata)

pop <- nor_population_by_age_cats(
  cats = list(children = 0:17, adults = 18:66, seniors = 67:105)
)
pop[location_code == "nation_nor" & calyear == 2024]

Which function do I want?

I need	Call
Codes, display names and presentation order for each geographic unit	nor_locations_names()
A mapping from one geographic level to another	nor_locations_hierarchy_from_to()
Weights that convert figures from older municipal borders to 2024	nor_locations_redistricting()
Population counts aggregated into age bands I define	nor_population_by_age_cats()
Those counts split into male and female	nor_population_by_sex_age_cats()
The granularity label carried by a location code	location_code_to_granularity_geo()
That label written onto a data.table as a column	add_granularity_geo_to_data_set()
To read or set the package-wide default border year	config, set_config()

Documentation

The reference index and the three articles live at https://niphr.github.io/csdata/. Start with the csdata article for the coding conventions. Then read locations_norway for the geographic reference table, and population_norway for the population series. Offline, run help(package = "csdata").