# Introduction to covidnor

covidnor cleans and merges the publicly available datasets on COVID-19 in Norway into analysis-ready datasets.

The following data are provided in this package:

- case numbers
- ICU/hospital admissions
- testing
- vaccinations

The overall data is stored as `total`, and has 419k rows. More information on what variables and specifications are available, and how to extract specifications you want can be found here.

## Getting started

Instead of working directly on `total` data, you might want to use a certain combination of time, location, outcome. We recommend using the data.table syntax for data filtering and subsetting.

For example, to get weekly Covid cases and hospital admissions as main cause for Norway:

    # load total data (419k rows)
    totaldata <- covidnor::total_b2020

    # get weekly cases (confirmed) and hospitalisation for Norway
    case_hosp <- totaldata[granularity_time == 'isoyearweek' &
                         granularity_geo == 'nation',
                       .(date,
                         location_name,
                         cases = cases_by_testdate_n,
                         hospital_adm = hospital_admissions_main_cause_n)]
    case_hosp
    #>            date location_name cases hospital_adm
    #>   1: 2022-11-13         Norge   534           60
    #>   2: 2022-11-06         Norge   876          174
    #>   3: 2022-10-30         Norge   780          151
    #>   4: 2022-10-23         Norge   561          120
    #>   5: 2022-10-16         Norge   499          117
    #>  ---
    #> 139: 2020-03-22         Norge  1438          188
    #> 140: 2020-03-15         Norge  1215           50
    #> 141: 2020-03-08         Norge   217            2
    #> 142: 2020-03-01         Norge    30            0
    #> 143: 2020-02-23         Norge     1            0

For more details, please refer to the vignette and data documentation.

Several of CSIDS packages (csstyle, csalert) make use of `covidnor` data. You can read the following documentation to find out more,

- Epicurves in `cstyle`,
- Short term trend for COVID cases in `csalert`.

### Background

This package curates publicly available COVID-19 data in Norway between 2020-04-24 to 2022-11-14. The original data repository (`surveillance_data`) which automatically published machine-friendly COVID-19 data updates on weekdays at 13:15 can be accessed here. The original repository was archived by Sykdomspulsen team at the Norwegian Institute of Public Health due to lack of funding.