Changelog

Adds instrument gh1 (GSED-HF, JAN 2023) to builtin_itemtable and builtin_itembank as part of key gsed2212
Adds example datasets: sample_sf, sample_lf and sample_hf
Adds vignette to calculate D-scores and DAZ dedicated to GSED instruments
Renames streams in gl1 instruments as: aa –> gm, bb –> lg, cc –> fm
Replaces item name gl1aad001 –> gl1gmd001, and so on

Rewrite calls to select() and pivot_longer() to conform to tidyselect 1.2.0 grammar

On 22021130, we found errors in the LF item order. Solves a documentation error. This error was introduced on May 30, 2022 and invalidates keys gsed2206 and gsed2208, as well as analyses that rely on correct LF item labels. Version 1.7.0 corrects these problems.
Item labels are taken from
- LF1, corrected using RedCAP comparisons from Phase_1_master_data_dictionary_V1.0_29_11_2022.xlsx;
- LF2, from GSED LF Item Guide_October22_FINAL_clean_27Nov22.docx and manually matched to LF1.
Rerun core 293_0 model, check edits, redocument, regenerate diagnostic plots, etc. Check that result is identical.
Refit full 818_6 model. In general better ICC’s, effect on D-score calculation is minor, six items were bad matches

Introduces new default key gsed2212
Introduces new instrument codes gs1 (GSED SF V1.0) and gl1 (GSED LF V1.0)
Updates gto labels with correct order
Set default key to gsed2212. This key repairs problems in gsed2206 and gsed2208.
get_labels() now returns the labels in the same order as items
Extends key gsed2212 with 18 ECDI items using Phase 1 validation data
Updates builtin_itemtable and builtin_itembank with correct LF item order
Redocuments upper anchor item

Solves bug that crashed dscore::count_mu_phase1(t) when t is a vector containing NAs
Adds example data set gsample with 10 cases with SF and LF scores
Adds order argument to get_itemnames()
Repairs an error in the sort_itemnames() example
Replaces bitwise by more elegant elementwise comparison in dscore.cpp
Removes the dependency on the sirt package

Solves a long-standing issue that led to severe incongruence between LF and SF at the earliest ages (<6M).
Adds two new keys (gsed2208 and 293_0) using the Phase 1 validation data for the GSED SF and GSED LF.
Sets 293_0 as the GSED core model and extended it to include the 818 items that fitted the previous model (“gsed2206”).
Adds a new reference (named phase1), based on LF and SF data from cohorts GSED-BGD, GSED-PAK and GSED-TZA studies.
**Changes the default key to gsed2208 and default population to “phase1”.**. If you want the old behavior, specifykey = “gsed1912”orkey = “gsed2206”to functions that accept thekeyargument (dscore(),dscore_posterior(),get_age_equivalent(),get_tau()`).

Many simplications and update to increase legibility and consistency.
Makes arguments of get_age_equivalent() and get_tau() consistent with dscore()
Adapts BCT functions to work with missing and out-of-range data
Adds support for phase1 reference to get_reference()
Adds support for BCT references in zad() and daz()
Adds count_mean_phase1() for setting prior mean equal to the GSED Phase 1 reference
Adds round 2 estimates to count_mean_phase1()
Prepares dscore() prior_mean functionality to deal with the to-be-implemented new reference as “phase1”
Adds count_mean_phase1() function
Adds 18 ECDI items to keys gsed2206 and 294_0
Initialise proper default population when key is 294_0.
Adds experimental key 294_0 to the builtin_itembank.
Adds a relevance argument to dscore() and dscore_posterior() to restrict calculation of D-scores to those items that have their tau within this relevance interval around the dynamic EAP estimate.
Repairs bug in builtin_itembank that inherits old (gsed1912) tau’s into new key (gsed2206) for instruments gto and gpa. As a consequence, D-score were incorrectly calculated when gto and gpa item names were used.
Repairs a bug in get_age_equivalent() that resulted in age interval estimates that were too narrow on the D-score scale.

Adds three new keys (gsed2206, lf2206 and sf2206) that incorporate Phase 1 validation data for the GSED SF, GSED LF and BSID.
Changes the default key to gsed2206. If you want the old behavior, specify key = "gsed1912" to functions that accept the key argument (dscore(), dscore_posterior(), get_age_equivalent(), get_tau()).
Extends builtin_itemtable with names and labels for gpa (SF), gto (LF) and gsd (novel SF) items.
Solves a long-standing issue #29 that gave different D-score under different transformation. This change affects solutions calculated with the metric = "logit" and transform parameters specified. The D-scores calculated under different transforms are now linear transformations of each other.

Updates tau estimates for Mullen items in itembank covering a much wider age range: 65 out of the 85 Mullen items from previous itembank version have new tau estimates; 20 items are removed.
Updates itembank with new Mullen items. There are 73 new Mullen items added to the new itembank. In total there are now 139 Mullen items in the itembank, estimates are based on PROVIDE and BAMBAM data.
Moves sources to organisation repository D-score/dscore for increased visibility

Adds equate groups translated from the ddata package to builtin_itemtable
Adds new itemtable_20200424.txt with minimal item definitions
Adds 522 missing items that were defined in the ddata package
Minimizes the data stored in builtin_itemtable
The get_itemtable() function gets a new argument decompose for adding info from decomposed item names
Solves warning from get_itemtable() when itemtable argument is specified

Uses explicit drop = TRUE to account for new behavior in tibble 3.0.0
Adds a facility to create a dynamic (on-the-fly) itemtable from specified item names in get_itemtable().

The default rounding is now 2 (D-score), 3 (DAZ). Fixed rounding are now 4 (age) and 4 (p) decimals.
There was a slight discrepancy in the calculation of DAZ between the dscore and clopus packages. The dscore package now first rounds the D-score and then calculate DAZ.
The dscore() function now automatically select the prior_mean = ".dutch" option when the user specifies key == "dutch". This change repair an error in the D-score calculation that occurs when only key == "dutch" was given.
The dscore() function now silently handles warnings that may result from taking the log of negative ages.

Hi, welcome to dscore 1.0.0! For the development history, see https://github.com/D-score/dscore
Added a NEWS.md file to track changes to the package.

dscore 1.8.1