# ABCDscores 7.0.0

Date: 2026-05-13

## New features

- 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`.


## Changes

- 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.

## Bug fixes

- 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`).



# ABCDscores 6.1.0

Date: 2025-11-30

## Changes

- Change maintainer to Le.
- Added citation.

## Bug fixes

- 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 used`ph_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.

# ABCDscores 6.0.1

Date: 2025-08-21

## New features

- 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.

## Bug fixes

- 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.

# ABCDscores 6.0.0

Date: 2025-06-27

## New features

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