New datasets: 'ADHD' and 'Boredom

DESCRIPTION

@@ -16,7 +16,8 @@ Authors@R: c(
     comment = c(ORCID = "0000-0002-9838-7308"))
   )
 Maintainer: Maarten Marsman <[email protected]>
-Description: Bayesian variable selection methods for analyzing the structure of a Markov Random Field model for a network of binary and/or ordinal variables. Details of the implemented methods can be found in: Marsman, van den Bergh, and Haslbeck (in press) <doi:10.31234/osf.io/ukwrf>.
+Description: Bayesian variable selection methods for analyzing the structure of a Markov Random Field model for a network of binary and/or ordinal variables. Details of the implemented methods can be found in: Marsman, van den Bergh, and Haslbeck (in press) <doi:10.31234/osf.io/ukwrf>. 
+Copyright: Includes datasets 'ADHD' and 'Boredom', which are licensed under CC-BY 4. See individual data documentation for license and citation.
 License: GPL (>= 2)
 URL: https://Bayesian-Graphical-Modelling-Lab.github.io/bgms/
 BugReports: https://github.com/Bayesian-Graphical-Modelling-Lab/bgms/issues

R/datasets.R

@@ -1,36 +1,36 @@
 #' Post-traumatic stress disorder symptoms of Wenchuan earthquake survivors
 #'
-#' A data set containing items measuring symptoms of posttraumatic stress 
-#' disorder (PTSD) \insertCite{McNallyEtAl_2015}{bgms}. Participants were 362 
-#' Chinese adults who survived the Wenchuan earthquake and lost at least one 
-#' child in the disaster. PTSD symptoms were reported using the civilian version 
-#' of the Posttraumatic Checklist, which consists of 17 items, each assessing 
-#' one of the DSM-IV symptoms of PTSD. Participants rated each item on a 
-#' five-point scale ranging from ``not at all'' to ``extremely'' to indicate how 
-#' much the symptom bothered them in the past month. 
-#' 
+#' A data set containing items measuring symptoms of posttraumatic stress
+#' disorder (PTSD) \insertCite{McNallyEtAl_2015}{bgms}. Participants were 362
+#' Chinese adults who survived the Wenchuan earthquake and lost at least one
+#' child in the disaster. PTSD symptoms were reported using the civilian version
+#' of the Posttraumatic Checklist, which consists of 17 items, each assessing
+#' one of the DSM-IV symptoms of PTSD. Participants rated each item on a
+#' five-point scale ranging from  "not at all" to "extremely" to indicate how
+#' much the symptom bothered them in the past month.
+#'
 #' @format A matrix with 362 rows and 17 columns:
 #' \describe{
-#'   \item{intrusion}{Repeated, disturbing memories, thoughts, or images of a 
+#'   \item{intrusion}{Repeated, disturbing memories, thoughts, or images of a
 #'   stressful experience from the past?}
-#'   \item{dreams}{Repeated, disturbing dreams of a stressful experience from 
+#'   \item{dreams}{Repeated, disturbing dreams of a stressful experience from
 #'   the past?}
-#'   \item{flash}{Suddenly acting or feeling as if a stressful experience were 
+#'   \item{flash}{Suddenly acting or feeling as if a stressful experience were
 #'   happening again (as if you were reliving it)?}
-#'   \item{upset}{Feeling very upset when something reminded you of a stressful 
+#'   \item{upset}{Feeling very upset when something reminded you of a stressful
 #'   experience from the past?}
-#'   \item{physior}{Having physical reactions (e.g., heart pounding, trouble 
-#'   breathing, sweating) when something reminded you of a stressful experience 
+#'   \item{physior}{Having physical reactions (e.g., heart pounding, trouble
+#'   breathing, sweating) when something reminded you of a stressful experience
 #'   from the past?}
-#'   \item{avoidth}{Avoiding thinking about or talking about a stressful 
+#'   \item{avoidth}{Avoiding thinking about or talking about a stressful
 #'   experience from the past or avoiding having feelings related to it?}
-#'   \item{avoidact}{Avoiding activities or situations because they reminded you 
+#'   \item{avoidact}{Avoiding activities or situations because they reminded you
 #'   of a stressful experience from the past?}
-#'   \item{amnesia}{Trouble remembering important parts of a stressful 
+#'   \item{amnesia}{Trouble remembering important parts of a stressful
 #'   experience from the past?}
 #'   \item{lossint}{Loss of interest in activities that you used to enjoy?}
 #'   \item{distant}{Feeling distant or cut off from other people?}
-#'   \item{numb}{Feeling emotionally numb or being unable to have loving 
+#'   \item{numb}{Feeling emotionally numb or being unable to have loving
 #'   feelings for those close to you?}
 #'   \item{future}{Feeling as if your future will somehow be cut short?}
 #'   \item{sleep}{Trouble falling or staying asleep?}
@@ -39,7 +39,7 @@
 #'   \item{hyper}{Being "super-alert" or watchful or on guard?}
 #'   \item{startle}{Feeling jumpy or easily startled?}
 #' }
-#' 
+#'
 #' @source \url{http://psychosystems.org/wp-content/uploads/2014/10/Wenchuan.csv}
 #'
 #' @docType data
@@ -55,3 +55,112 @@
 #' \insertAllCited{}
 #'
 NULL
+
+#' ADHD symptoms of children aged 6-8 years
+#'
+#' A data set containing items measuring symptoms of attention deficit
+#' hyperactivity disorder (ADHD) \insertCite{Silk_2019_ADHD}{bgms}
+#' Participants are a subsample from a community cohort, the Children's Attention
+#' Project (CAP); 355 children, aged 6-8 years, of which 146 were diagnosed with
+#' ADHD and 209 were not. ADHD symptoms were assessed during structured
+#' face-to-face interviews with the children's parents. The NIMH Diagnostic
+#' Interview Schedule for Children IV-DISC-iV \insertCite{Shaffer_2000_nimh}{bgms}
+#' contains a total of 18 symptoms, of which 9 Inattentive and 9
+#' Hyperactive/Impulsive. Each symptom was scored as either present (1) or
+#' absent (0), based on the parents' statements.
+#'
+#' @format A matrix with 355 rows and 19 columns. (I) and (HI) indicate Inattentive
+#' and Hyperactive/Impulsive symptoms, respectively.
+#' \describe{
+#'   \item{group}{1 = ADHD diagnosis, 0 = no ADHD diagnosis}
+#'   \item{avoid}{Often avoids, dislikes, or is reluctant to engage in tasks
+#'   that require sustained mental effort (I)}
+#'   \item{closeatt}{Often fails to give close attention to details or makes
+#'   careless mistakes in schoolwork, work, or other activities (I)}
+#'   \item{distract}{Is often easily distracted by extraneous stimuli (I)}
+#'   \item{forget}{Is often forgetful in daily activities (I)}
+#'   \item{instruct}{Often does not follow through on instructions and fails to
+#'   finish schoolwork, chores, or duties in the workplace (I)}
+#'   \item{listen}{Often does not seem to listen when spoken to directly
+#'   (I)}
+#'   \item{loses}{Often loses things necessary for tasks or activities (I)}
+#'   \item{org}{Often has difficulty organizing tasks and activities (I)}
+#'   \item{susatt}{Often has difficulty sustaining attention in tasks or play
+#'   activities (I)}
+#'   \item{blurts}{Often blurts out answers before questions have been completed
+#'   (HI)}
+#'   \item{fidget}{Often fidgets with hands or feet or squirms in seat
+#'   (HI)}
+#'   \item{interrupt}{Often interrupts or intrudes on others (HI)}
+#'   \item{motor}{Is often "on the go" or often acts as if "driven by a motor"
+#'   (HI)}
+#'   \item{quiet}{Often has difficulty playing or engaging in leisure activities
+#'   quietly (HI)}
+#'   \item{runs}{Often runs about or climbs excessively in situations in which
+#'   it is inappropriate (HI)}
+#'   \item{seat}{Often leaves seat in classroom or in other situations in which
+#'   remaining seated is expected (HI)}
+#'   \item{talks}{Often talks excessively (HI)}
+#'   \item{turn}{Often has difficulty awaiting turn (HI)}
+#' }
+#'
+#' @source \insertCite{Silk_2019_ADHD;textual}{bgms}. Data retrieved from \url{https://doi.org/10.1371/journal.pone.0211053.s004}.
+#' Licensed under the Creative Commons Attribution 4.0 International License (CC-BY 4.0). https://creativecommons.org/licenses/by/4.0/
+#'
+#' @docType data
+#'
+#' @keywords datasets
+#'
+#' @name ADHD
+#'
+#' @usage data("ADHD")
+#'
+#' @references
+#'
+#' \insertAllCited{}
+#'
+NULL
+
+#' Items measuring boredom proneness
+#'
+#' A dataset containing items measuring proneness to boredom. The dataset is a
+#' subset of the data from \insertCite{Martarelli_2023_Boredom;textual}{bgms},
+#' and contains the 8 items from the Short Boredom Proneness Scale (SBPS). Each
+#' item was scored on a 7-point Likert scale ranging from 1 ("strongly disagree")
+#' to 7 ("strongly agree"). The SBPS was administered either in English (the
+#' language of the original scale, by \insertCite{Struk_2015_boredom;textual}{bgms})
+#' or French (as translated by \insertCite{Martarelli_2023_Boredom;textual}{bgms}).
+#'
+#' @format A matrix with 986 rows and 9 columns:
+#' \describe{
+#'   \item{loose_ends}{I often find myself at “loose ends,” not knowing what to
+#'   do.}
+#'   \item{entertain}{I find it hard to entertain myself.}
+#'   \item{repetitive}{Many things I have to do are repetitive and monotonous.}
+#'   \item{stimulation}{It takes more stimulation to get me going than most
+#'   people.}
+#'   \item{motivated}{I don't feel motivated by most things that I do.}
+#'   \item{keep_interest}{In most situations, it is hard for me to find
+#'   something to do or see to keep me interested.}
+#'   \item{sit_around}{Much of the time, I just sit around doing nothing.}
+#'   \item{half_dead_dull}{Unless I am doing something exciting, even dangerous,
+#'   I feel half-dead and dull.}
+#' }
+#'
+#' @source \insertCite{Martarelli_2023_Boredom;textual}{bgms}. Data retrieved from \url{https://osf.io/qhux8}.
+#' Licensed under the Creative Commons Attribution 4.0 International License (CC-BY 4.0). https://creativecommons.org/licenses/by/4.0/
+#'
+#'
+#' @docType data
+#'
+#' @keywords datasets
+#'
+#' @name Boredom
+#'
+#' @usage data("Boredom")
+#'
+#' @references
+#'
+#' \insertAllCited{}
+#'
+NULL

inst/REFERENCES.bib

@@ -1,14 +1,11 @@
-@ARTICLE{miller2018mixture,
-  title={Mixture models with a prior on the number of components},
-  author={Miller, Jeffrey W and Harrison, Matthew T},
-  journal={Journal of the American Statistical Association},
-  volume={113},
-  number={521},
-  pages={340--356},
-  year={2018},
-  doi = {10.1080/01621459.2016.1255636},
-  publisher={Taylor \& Francis}
-}
+@article{ContrerasEtAl_2019,
+	author = {Contreras, A. and Nieto, I. and Valiente, C. and Espinosa, R. and Vazquez, C.},
+	doi = {10.1159/000497425},
+	journal = {Psychotherapy and Psychosomatics},
+	pages = {71--83},
+	title = {The study of psychopathology from the network analysis perspective: {A} systematic review.},
+	volume = {88},
+	year = {2019}}
 
 @article{Dahl2009,
   author       = {David B. Dahl},
@@ -32,22 +29,14 @@ @article{GengEtAl_2019
   doi = {10.1080/01621459.2018.1458618},
   year={2019}}
 
-@article{SekulovskiEtAl_2024,
-	author = {Sekulovski, N. and Keetelaar, S. and Huth, K. B. S. and Wagenmakers, Eric-Jan and {van }Bork, R. and {van den }Bergh, D. and Marsman, M.},
-	doi = {10.1080/00273171.2024.2345915},
-	journal = {Multivariate Behavioral Research},
-	pages = {913--933},
-	title = {Testing conditional independence in psychometric networks: {A}n analysis of three {B}ayesian methods},
-	volume = {59},
-	year = {2024},
-	bdsk-url-1 = {https://doi.org/10.1080/00273171.2024.2345915}}
-
-@book{Lauritzen2004,
-	address = {Oxford},
-	author = {Lauritzen, {S. L.}.},
-	publisher = {Oxford University Press},
-	title = {Graphical Models},
-	year = {2004}}
+@article{HuthEtAl_2023_intro,
+	author = {Huth, K. and {de Ron}, J. and Goudriaan, A. E. and Luigjes, K. and Mohammadi, R. and {van Holst}, R. J. and Wagenmakers, {E.-J.} and Marsman, M.},
+	journal = {Advances in {M}ethods and {P}ractices in {P}sychological {S}cience},
+	title = {Bayesian analysis of cross-sectional networks: {A} tutorial in {R} and {JASP}},
+	volume = {6},
+	pages = {1--18},
+    doi = {10.1177/25152459231193334},
+	year = {2023}}
 
 @book{KindermannSnell1980,
 	address = {Providence},
@@ -58,14 +47,25 @@ @book{KindermannSnell1980
 	volume = {1},
 	year = {1980}}
 
-@article{ContrerasEtAl_2019,
-	author = {Contreras, A. and Nieto, I. and Valiente, C. and Espinosa, R. and Vazquez, C.},
-	doi = {10.1159/000497425},
-	journal = {Psychotherapy and Psychosomatics},
-	pages = {71--83},
-	title = {The study of psychopathology from the network analysis perspective: {A} systematic review.},
-	volume = {88},
-	year = {2019}}
+@book{Lauritzen2004,
+	address = {Oxford},
+	author = {Lauritzen, {S. L.}.},
+	publisher = {Oxford University Press},
+	title = {Graphical Models},
+	year = {2004}}
+
+@article{Martarelli_2023_Boredom,
+  title={A Trait-Based Network Perspective on the Validation of the French Short Boredom Proneness Scale},
+  author={Martarelli, Chiara S. and Baillifard, Alexandre and Audrin, Catherine},
+  journal={European Journal of Psychological Assessment},
+  volume={39},
+  number={6},
+  pages={390--399},
+  year={2023},
+  month={Nov},
+  doi={10.1027/1015-5759/a000718},
+  publisher={Hogrefe}
+}
 
 @article{MarsmanRhemtulla_2022_SIintro,
 	author = {Marsman, M. and Rhemtulla, M.},
@@ -76,24 +76,6 @@ @article{MarsmanRhemtulla_2022_SIintro
 	volume = {87},
 	year = {2022}}
 
-@article{RobinaughEtAl_2020,
-	author = {Robinaugh, D. J. and Hoekstra, R. H. A. and Toner, E. R. and Borsboom, D.},
-	doi = {10.1017/S0033291719003404},
-	journal = {Psychological Medicine},
-	pages = {353--366},
-	title = {The network approach to psychopathology: {A} review of the literature 2008--2018 and an agenda for future research},
-	volume = {50},
-	year = {2020}}
-
-@article{McNallyEtAl_2015,
-	author = {{McNally}, R. J. and Robinaugh, D. J. and Wu, G. W. Y. and Wang, L. and Deserno, M. K. and Borsboom, D.},
-	doi = {10.1177/2167702614553230},
-	journal = {Clinical Psychological Science},
-	volume = {6},
-	pages = {836--849},
-	title = {Mental disorders as causal systems: {A} network approach to posttraumatic stress disorder},
-	year = {2015}}
-
 @article{MarsmanVandenBerghHaslbeck_2024,
 	author = {Marsman, M. and {van den} Bergh, D. and Haslbeck, J. M. B.},
 	journal = {Psychometrika},
@@ -107,14 +89,45 @@ @article{MarsmanWaldorpSekulovskiHaslbeck_2024
 	note = {OSF preprint},
 	year = {2024}}
 
-@article{HuthEtAl_2023_intro,
-	author = {Huth, K. and {de Ron}, J. and Goudriaan, A. E. and Luigjes, K. and Mohammadi, R. and {van Holst}, R. J. and Wagenmakers, {E.-J.} and Marsman, M.},
-	journal = {Advances in {M}ethods and {P}ractices in {P}sychological {S}cience},
-	title = {Bayesian analysis of cross-sectional networks: {A} tutorial in {R} and {JASP}},
+@article{McNallyEtAl_2015,
+	author = {{McNally}, R. J. and Robinaugh, D. J. and Wu, G. W. Y. and Wang, L. and Deserno, M. K. and Borsboom, D.},
+	doi = {10.1177/2167702614553230},
+	journal = {Clinical Psychological Science},
 	volume = {6},
-	pages = {1--18}
-  doi = {10.1177/25152459231193334},
-	year = {2023}}
+	pages = {836--849},
+	title = {Mental disorders as causal systems: {A} network approach to posttraumatic stress disorder},
+	year = {2015}}
+
+@article{Miller2018mixture,
+  title={Mixture models with a prior on the number of components},
+  author={Miller, Jeffrey W and Harrison, Matthew T},
+  journal={Journal of the American Statistical Association},
+  volume={113},
+  number={521},
+  pages={340--356},
+  year={2018},
+  doi = {10.1080/01621459.2016.1255636},
+  publisher={Taylor \& Francis}
+}
+
+@article{RobinaughEtAl_2020,
+	author = {Robinaugh, D. J. and Hoekstra, R. H. A. and Toner, E. R. and Borsboom, D.},
+	doi = {10.1017/S0033291719003404},
+	journal = {Psychological Medicine},
+	pages = {353--366},
+	title = {The network approach to psychopathology: {A} review of the literature 2008--2018 and an agenda for future research},
+	volume = {50},
+	year = {2020}}
+
+@article{SekulovskiEtAl_2024,
+	author = {Sekulovski, N. and Keetelaar, S. and Huth, K. B. S. and Wagenmakers, Eric-Jan and {van }Bork, R. and {van den }Bergh, D. and Marsman, M.},
+	doi = {10.1080/00273171.2024.2345915},
+	journal = {Multivariate Behavioral Research},
+	pages = {913--933},
+	title = {Testing conditional independence in psychometric networks: {A}n analysis of three {B}ayesian methods},
+	volume = {59},
+	year = {2024},
+	bdsk-url-1 = {https://doi.org/10.1080/00273171.2024.2345915}}
 
 @article{SekulovskiEtAl_2025,
 	author = {Sekulovski, N. and Arena, G. and Friel, N. and Marsman, M.},
@@ -123,3 +136,38 @@ @article{SekulovskiEtAl_2025
 	note = {OSF preprint},
 	year = {2025}}
 
+@article{Shaffer_2000_nimh,
+  title={NIMH Diagnostic Interview Schedule for Children Version IV (NIMH DISC-IV): description, differences from previous versions, and reliability of some common diagnoses},
+  author={Shaffer, David and Fisher, Peter and Lucas, Christopher P. and Dulcan, Mina K. and Schwab-Stone, Mary E.},
+  journal={Journal of the American Academy of Child \& Adolescent Psychiatry},
+  volume={39},
+  pages={28--38},
+  year={2000},
+  doi={10.1097/00004583-200001000-00014},
+  publisher={Elsevier},
+  note={PMID: 10638065}
+}
+
+@article{Silk_2019_ADHD,
+  title={A network analysis approach to ADHD symptoms: More than the sum of its parts},
+  author={Silk, Timothy J. and Malpas, Charles B. and Beare, Richard and Efron, Daryl and Anderson, Vicki and Hazell, Philip and Jongeling, Ben and Nicholson, Jan M. and Sciberras, Emma},
+  journal={PLOS ONE},
+  volume={14},
+  number={1},
+  pages={e0211053},
+  year={2019},
+  doi={10.1371/journal.pone.0211053},
+  publisher={Public Library of Science}
+}
+
+@article{Struk_2015_boredom,
+  title={A Short Boredom Proneness Scale: Development and Psychometric Properties},
+  author={Struk, Anastasia A. and Carriere, Jonathan S. A. and Cheyne, J. Allan and Danckert, James},
+  journal={Assessment},
+  volume={24},
+  number={3},
+  pages={346--359},
+  year={2015},
+  doi={10.1177/1073191115609996},
+  publisher={SAGE Publications}
+}