/NeuropsyNorms

An R package for computing neuropsychological normative data

Primary LanguageRMIT LicenseMIT

NeuropsyNorms

The NeuropsyNorms package aims to facilitate and expedite the computation of normative data for neuropsychological assessments. It is an open-source software that is still in its preliminary stages. In the spirit of open science, this project is open to contributors from different disciplines (e.g., neuropsychologists, neuroscientists, psychologists, statisticians). If that sounds like you, feel free to open an issue on this repository or drop an email!

Some future directions

  • User interface/app form for clinicians not familiar with R
  • Increase normative database
  • Graphical functionalities

Functionality

NeuropsyNorms computes norms for:

  • Trail Making Test (TMT) tmt_norms
  • Colour Trails Test (CTT) ctt_norms
  • Symbol Digit Modalities Test (SDMT) sdmt_norms
  • Controlled Oral Word Association Test (COWAT) cowat_norms
  • Brief Visuospatial Memory Test-Revised (BVMT-R) bvmtr_norms
  • Rey Auditory Verbal Learning Test (RAVLT) ravlt_norms
  • California Verbal Learning Test (CVLT) - short form only for now cvlt_norms
  • Repeatable Battery for the Assessment of Neuropsychological Status (RBANS) rbans_norms
  • Victoria Stroop (VST) vst_norms

Workflow

Each function has a set of parameters pertaining to:

  • Demographic information related to the patient/client: This includes education and age (both in years) and male (TRUE or FALSE for female).
  • source referring to the normative sample that norms should be based on e.g., Tombaugh2004_Canada for Tombaugh et al. (2004) TMT norms
  • scores specific to the test in question e.g., trailsA and trailsB for respective Trails A and B performance in seconds; t1, t2, t3,... delayed_recall arguments for RAVLT measures

Normative Samples

A secondary aim is to increase awareness about the nature of the normative samples that neuropsychological assessments are based on. Every time you run a line of code to compute normative data, information about the reference group (i.e., sample size, language of test administration, age range, education) is printed.

You can find a compilation of the normative studies used in this package here.

Demonstration

First, you'll need to have the following downloaded:

Then, run the following commands in your R console:

# Install and load necessary packages
install.packages("devtools")
library(devtools)
library(NeuropsyNorms)

# Compute norms
tmt_norms(education=10, age=55, trailsA=30, trailsB=40, source="Tombaugh2004_Canada")

This gives the following output:

[1] "Tombaugh (2004) study ``N`` = 911 in English-speaking individuals residing in Canada aged between 18 - 89, of education (in years) of 0-12 and >12. Tests were administered in English. Scores are age-adjusted for persons between ages 18 - 54, and both age- and education-adjusted for ages 55-89."
        Raw Scores  Z-scores    Descriptor
TrailsA         30 0.4661792       Average
TrailsB         40 2.0345731 Very Superior

See example_script.R for a reproducible script.