Changelog • ABCDscores

ABCDscores 7.0.0

Date: 2026-05-13

Added KSADS parent and youth summary scores for mental health and substance-use symptom domains (mh_p_ksads, mh_y_ksads, su_p_ksads, su_y_ksads).
Added family history summary scores for combining checkbox style endorsements into binary items endorsement and combined parent scores (mh_p_famhx).
Added medication category and estimated-use flag scores using RxNorm-based medication mappings (ph_p_meds, ph_y_meds, ph_p_dhx).
Added SU summary scores across multiple measures for lifetime use, onset age, and onset event and TLFB lifetime total-dose summary scores updates (su_y_dyn, su_y_stc, su_y_tlfb).
Added Prodromal Psychosis Scale / SIPS distress, severity, persistence, count, first-event, and ever-event scores (mh_y_pps, mh_y_ppsss).
Added UCLA Loneliness Scale summary scores (fc_y_lone).
Added combined unit scores for parent height and birthweght (ph_p_anthr, ph_p_dhx).
Added Native American Acculturation mean scores (fc_y_na, ab_p_demo__ntvam).
Added Fitbit summary scores for file-based data on activity and sleep at the daily and weekly level, such as means, durations, and counts.
Added vignettes (Articles) for Family History (FAMHX) summary scores, Medication use and history, Static and Dynamic Substance Use (SDSU) summary scores, and Computing Daily and Weekly Fitbit Scores.

Added documentation for installing from release tarballs.
Reorganized substance-use score files and updated generated help files.
Removed count validation threshold (max_na) from mh_p_ple_count and mh_y_ple_count, so scores are now computed regardless of the number of missing items.

Fixed mh_y_ysr scoring, where three obsolete variables were still included and the missingness thresholds used outdated criteria. The total score now uses 102 items with a maximum of 5 missing items, subscales use the updated 20% missing-item threshold, and T-score functions apply the same validation logic before returning a score.
Fixed non-response handling in MH and FC scores. Values of 777 are now excluded from mh_y_peq, fc_y_fes, fc_y_vs, fc_y_pnh, fc_y_psb, and fc_y_srpf; values of 777 and 999 are now excluded from fc_p_fes, fc_p_vs, and fc_p_psb; unnecessary exclusion criteria were removed from fc_y_vs__famil scores.
Fixed compute_ph_y_mctq__sd_count school-data handling to replace NAs with 0 when no school/work days endorsed and numeric.
Fixed physical-health arithmetic where factor or character inputs could be used directly in numeric calculations. Birthweight, OTBI age, and parent height computations now coerce source variables to numeric before arithmetic or comparisons.
Fixed EATQ mean computations where redundant recode_levels() calls could alter values before computing means. The unwanted recoding step was removed.
Missingnes criteria was adjust for Life Events measures (mh_y_ple, mh_p_ple).

CRAN release: 2025-11-25

Date: 2025-11-30

Fixed an error in the following utility functions: ss_sum, ss_mean, ss_max, ss_count_cond, ss_mean_pos. Fix: If input columns are factors, coerce them to numeric (factor -> character -> numeric) prior to computing the summary statistic. Previously, the coercion was inaccurate (factor -> numeric), converting the levels to numbers and not the displayed labels. For example, non-responses such as 777 (displayed label) could be level 6 for a factor / ordinal column. NOTE: This bug did not affect computed summary scores in 6.0.
Fixed a bug in the compute_ph_y_mctq__fd__sleep__mid 24h and 36h where incorrectly usedph_y_mctq__sd__sleep_dur than ph_y_mctq__sd__sleep_period.
Fixed a bug in the compute_ph_y_mctq__fd__sleep__mid 24h and 36h where incorrectly used ph_y_mctq__fd__sleep_dur than ph_y_mctq__fd__sleep_period.
Fixed a bug in the ph_y_mctq__sleep_loss where incorrectly used ph_y_mctq__*__sleep_dur than ph_y_mctq__*__sleep_period.
Fixed compute_ph_y_mctq__sd_count to handle missing variables. ph_y_mctq__school_001__v01 and ph_y_mctq__school_001__01__v1 were required by the function but not available before 7.0.0. Now, before package version 7.0.0, if these variables are missing, the function will create them internally and fill them with NA values. After 7.0.0, these variables are expected to be present.

CRAN release: 2025-09-11

Date: 2025-08-21

Added ph_ph_sds (Sleep Disturbance Scale) scores.
Improved documentation of summary scores by providing information
about excluded values, validation criteria, and other notes for all scores.

Fixed an error in the computation of all 3mo TLFB summary scores where incorrectly 60 instead of 90 days were used to compute the scores.

Date: 2025-06-27

The initial release of the ABCDscores package. This version is accompanied with the ABCD 6.0 data release.