___________________________________________________________________________________________________________________ *Adaptive Composite Complex Span (ACCES)* Main Script ___________________________________________________________________________________________________________________ Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC Date: 05-29-2019 last updated: 03-24-2022 by K.Borchert (katjab@millisecond.com) for Millisecond Software LLC Script Copyright © 03-24-2022 Millisecond Software ___________________________________________________________________________________________________________________ BACKGROUND INFO ___________________________________________________________________________________________________________________ This script implements the Adaptive Composite Complex Span Test (ACCES); an adaptive test of working memory with visuospatial ("symmetry span test"), mathematical ("operation span test") and verbal subtests ("reading span test"). The ACCES was developed by Gonthier et al (2018). According to the authors "the test presents a fixed number of trials to all participants, allows for partial credit scoring, and can be used with children regardless of ability level. The ACCES demonstrated satisfying psychometric properties in a sample of 268 children aged 8–13 years." (p.910) All materials for the ACCES – including the stimuli, an open source implementation of the task script under PsychoPy (Peirce, 2007), and all validation data – can be accessed via the Open Science Framework platform at https://osf.io/bk7pm/. Reference: Gonthier, C., Thomassin, N., & Roulin, J.-L. (2016). The Composite Complex Span : French validation of a short working memory task. Behavior Research Methods, 48(1), 233-242. doi:10.?3758/?s13428-015-0566-3 Gonthier C, Aubry A, Bourdin B. (2018). Measuring working memory capacity in children using adaptive tasks: Example validation of an adaptive complex span. Behav Res Methods. Jun;50(3):910-921. doi: 10.3758/s13428-017-0916-4. PMID: 28643158. ___________________________________________________________________________________________________________________ TASK DESCRIPTION ___________________________________________________________________________________________________________________ This script is batch script that calls the following scripts in order: 1. acces_intro.iqx: this script provides the general intro information for the ACCES test in English and runs a short demographic survey (can be turned off via parameters.runDemographicSurvey) under section Editable Parameters below. This script generates one data files: acces_demographics.iqdat (collects raw data of demographic survey) 2. acces_rspan.iqx: this script runs the RSPAN (Reading Span) subtest of the ACCES test. This script generates two data files: "acces_rspan_raw.iqdat" : collects the raw data "acces_rspan_summary.iqdat": stores the summary data Detailed Explanations of the data files as well as procedural information can be found in the User Manual of script "acces_rspan.iqx" Note: script acces_rspan.iqx can be skipped if parameters.run_RSPAN is set to false under section Editable Parameters below. 2. acces_sspan.iqx: this script runs the SSPAN (Symmetry Span) subtest of the ACCES test. This script generates two data files: "acces_sspan_raw.iqdat" : collects the raw data "acces_sspan_summary.iqdat": stores the summary data Detailed Explanations of the data files as well as procedural information can be found in the User Manual of script "acces_sspan.iqx" Note: script acces_sspan.iqx can be skipped if parameters.run_SSPAN is set to false under section Editable Parameters below. 3. acces_ospan.iqx: this script runs the OSPAN (Operation Span) subtest of the ACCES test. This script generates two data files: "acces_ospan_raw.iqdat" : collects the raw data "acces_ospan_summary.iqdat": stores the summary data Detailed Explanations of the data files as well as procedural information can be found in the User Manual of script "acces_ospan.iqx" Note: script acces_rspan.iqx can be skipped if parameters.run_OSPAN is set to false under section Editable Parameters below. 4. acces_finish.iqx: this script presents the final instruction pages for the ACCES test and stores the main performance data of the three subtests (RSPAN, SSPAN, OSPAN) as well as a composite WMC score in one common data file. Detailed Explanations of the data file can be found in the User Manual of script "acces_finish.iqx". ___________________________________________________________________________________________________________________ DURATION ___________________________________________________________________________________________________________________ the default set-up of the script takes appr. 30 minutes to complete ___________________________________________________________________________________________________________________ DATA FILE INFORMATION ___________________________________________________________________________________________________________________ See individual batch scripts (USER MANUALS) for detailed information on all data files generated: "acces_intro.iqx" "acces_rspan.iqx" "acces_sspan.iqx" "acces_ospan.iqx" "acces_finish.iqx" ___________________________________________________________________________________________________________________ EXPERIMENTAL SET-UP ___________________________________________________________________________________________________________________ All procedural information can found in the USER MANUALS of the following scripts: RSPAN: acces_rspan.iqx SSPAN: acces_sspan.iqx OSPAN: acces_ospan.iqx ___________________________________________________________________________________________________________________ STIMULI ___________________________________________________________________________________________________________________ See USER MANUALS of the following scripts: RSPAN: acces_rspan.iqx SSPAN: acces_sspan.iqx OSPAN: acces_ospan.iqx ___________________________________________________________________________________________________________________ INSTRUCTIONS ___________________________________________________________________________________________________________________ Instructions are not original to Gonthier et al, 2018 but borrow heavily from the French instructions generously provided by Gonthier et al's published material. The instructions in this script are provided by Millisecond Software as htm/html pages and can be edited by changing the provided htm/html files. To edit htm/html-files: open the respective documents in simple Text Editors such as TextEdit (Mac) or Notepad (Windows). See individual scripts for more detail. ___________________________________________________________________________________________________________________ EDITABLE CODE ___________________________________________________________________________________________________________________ check below for (relatively) easily editable parameters, stimuli, instructions etc. Keep in mind that you can use this script as a template and therefore always "mess" with the entire code to further customize your experiment. The parameters you can change are: /runDemographicSurvey = true true = script acces_demographics.iqx is run; false = script acces_demographics.iqx is skipped /run_RSPAN = true true = script acces_rspan.iqx is run; false = script acces_rspan.iqx is skipped /run_SSPAN = true true = script acces_sspan.iqx is run; false = script acces_sspan.iqx is skipped /run_OSPAN = true true = script acces_ospan.iqx is run; false = script acces_ospan.iqx is skipped ___________________________________________________________________________________________________________________ *Adaptive Composite Complex Span (ACCES)* General Intro + Demographic Survey ___________________________________________________________________________________________________________________ Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC Date: 05-29-201904 last updated: 03-24-2022 by K.Borchert (katjab@millisecond.com) for Millisecond Software LLC Script Copyright © 03-24-2022 Millisecond Software ___________________________________________________________________________________________________________________ BACKGROUND INFO ___________________________________________________________________________________________________________________ This script implements the Adaptive Composite Complex Span Test (ACCES); an adaptive test of working memory with visuospatial ("symmetry span test"), mathematical ("operation span test") and verbal subtests ("reading span test"). The ACCES was developed by Gonthier et al (2018). According to the authors "the test presents a fixed number of trials to all participants, allows for partial credit scoring, and can be used with children regardless of ability level. The ACCES demonstrated satisfying psychometric properties in a sample of 268 children aged 8–13 years." (p.910) All materials for the ACCES – including the stimuli, an open source implementation of the task script under PsychoPy (Peirce, 2007), and all validation data – can be accessed via the Open Science Framework platform at https://osf.io/bk7pm/. Reference: Gonthier, C., Thomassin, N., & Roulin, J.-L. (2016). The Composite Complex Span : French validation of a short working memory task. Behavior Research Methods, 48(1), 233-242. doi:10.?3758/?s13428-015-0566-3 Gonthier C, Aubry A, Bourdin B. (2018). Measuring working memory capacity in children using adaptive tasks: Example validation of an adaptive complex span. Behav Res Methods. Jun;50(3):910-921. doi: 10.3758/s13428-017-0916-4. PMID: 28643158. ___________________________________________________________________________________________________________________ TASK DESCRIPTION ___________________________________________________________________________________________________________________ This script presents the general intro to the ACCES test as well as a short demographic survey of the ACCES test. Grade level information is used to calculate z-scores and percentiles (based on norms published by Gonthier et al, 2018). ___________________________________________________________________________________________________________________ DURATION ___________________________________________________________________________________________________________________ the default set-up of the script takes < 1 minute to complete ___________________________________________________________________________________________________________________ DATA FILE INFORMATION ___________________________________________________________________________________________________________________ The default data stored in the data files are: (1) Raw data file: 'acces_demographics.iqdat' date, time: date and time script was run with the current group/subjectnumber subject, group, session: with the current subject/groupnumber/session id build: the Inquisit build q*_response: response given q*_latency: how much time (in ms) the participant spent on the surveypage with this particular question (the last time this particular surveypage was visited) * separate data files: to change to one data file for all participants (on Inquisit Lab only), go to section "DATA" and follow further instructions ___________________________________________________________________________________________________________________ EDITABLE CODE ___________________________________________________________________________________________________________________ check below for (relatively) easily editable parameters, stimuli, instructions etc. Keep in mind that you can use this script as a template and therefore always "mess" with the entire code to further customize your experiment. The parameters you can change are: see below ___________________________________________________________________________________________________________________ *Adaptive Composite Complex Span Test (ACCES)* Subtest: Reading Span Test (RSPAN) ___________________________________________________________________________________________________________________ Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC Date: 05-29-201904 last updated: 11-06-2023 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC Script Copyright © 11-06-2023 Millisecond Software ___________________________________________________________________________________________________________________ BACKGROUND INFO ___________________________________________________________________________________________________________________ This script implements the Reading Span Test subtest of the Adaptive Composite Complex Span Test (ACCES); an adaptive test of working memory with visuospatial ("symmetry span test"), mathematical ("operation span test") and verbal subtests ("reading span test"). The ACCES was developed by Gonthier et al (2018). According to the authors "the test presents a fixed number of trials to all participants, allows for partial credit scoring, and can be used with children regardless of ability level. The ACCES demonstrated satisfying psychometric properties in a sample of 268 children aged 8–13 years." (p.910) All materials for the ACCES – including the stimuli, an open source implementation of the task script under PsychoPy (Peirce, 2007), and all validation data – can be accessed via the Open Science Framework platform at https://osf.io/bk7pm/. Norms in this script (based on grade level) use the data provided by Gonthier et al (2018) collected with a sample of French students. Reference: Gonthier, C., Thomassin, N., & Roulin, J.-L. (2016). The Composite Complex Span: French validation of a short working memory task. Behavior Research Methods, 48(1), 233-242. doi:10.?3758/?s13428-015-0566-3 Gonthier C, Aubry A, Bourdin B. (2018). Measuring working memory capacity in children using adaptive tasks: Example validation of an adaptive complex span. Behav Res Methods. Jun;50(3):910-921. doi: 10.3758/s13428-017-0916-4. PMID: 28643158. ___________________________________________________________________________________________________________________ TASK DESCRIPTION ___________________________________________________________________________________________________________________ Participants work on 6 reading span test trials. Levels for each trial (after the first) are adapted based on performance. Reading Span Test: a dual task involving the evaluation of simple sentences while also recalling a sequence of digits for a later recall test: Evaluation of Sentence -> Digit Learning -> Evaluation of Sentence -> Digit Learning.....-> Digit Recall The number of 'sentence-evaluations/digit learning' combos depends on the level of difficulty (=span size) of the current test trial. All participants start at level 4. Depending on performance they move up, stay on the same level, or go down a level. The lowest level tested is level 2; the highest level tested is level 8. The task provides 3 practice session before the actual 6 test trials are run: Practice 1: training of the digit recall task Practice 2: training of the sentence evaluation task Practice 3: dual training of the combined task ___________________________________________________________________________________________________________________ DURATION ___________________________________________________________________________________________________________________ the default set-up of the script takes appr. 9 minutes to complete ___________________________________________________________________________________________________________________ DATA FILE INFORMATION ___________________________________________________________________________________________________________________ The default data stored in the data files are: (1) Raw data file: 'acces_rspan_raw*.iqdat' (a separate file for each participant)* build: The specific Inquisit version used (the 'build') that was run computer.platform: the platform the script was run on (win/mac/ios/android) date, time: date and time script was run subject, group, with the current subject/groupnumber session: with the current session id blockcode, blocknum: the name and number of the current block (built-in Inquisit variable) trialcode, trialnum: the name and number of the currently recorded trial (built-in Inquisit variable) Note: trialnum is a built-in Inquisit variable; it counts all trials run; even those that do not store data to the data file such as feedback trials. Thus, trialnum may not reflect the number of main trials run per block. age: the entered age of the participant gradeLevel: the entered grade level of the participant gender: the entered gender of the participant phase: stores the name of the current task phase RoundCount: counts the rounds ("trials") run in the current phase currentLevel: stores the levelspansize tested in the current round *************************************** Processing Task Variables: *************************************** ProcessingTaskProblem: stores the current processing task problem (e.g. sentence evaluation) presented correctResponse: stores the correct response to the current processing task problem (TRUE vs. FALSE) processingTaskResponse: stores the given response to the current processing task problem (TRUE vs. FALSE) processingTaskACC: stores the accuracy of the processing task response 1 = correct 0 = error processingTaskCumACC: stores the number of correct processing task responses *************************************** Memory Task Variables: *************************************** stim: stores the current recall stim (e.g. digit) presented currentStims: stores the collected recall stims of the current round in the order presented recallResponse: stores the recall stims of the current round in the order selected on the recall matrix numberStimsRecalled: stores the number of correctly recalled stims of the current round Total_StimsRecalled: stores the total number of correctly recalled stims during the current task stimulusitem: the presented stimuli in order of trial presentation of the currently recorded trial response: the participant's response (scancode of response buttons) of the currently recorded trial correct: accuracy of response: 1 = correct response; 0 = otherwise of the currently recorded trial latency: the response latency (in ms) of the current trial (2) Summary data file: 'acces_rspan_summary*.iqdat' (a separate file for each participant)* inquisit.version: Inquisit version run computer.platform: the platform the script was run on (win/mac/ios/android) startDate: date script was run startTime: time script was started subjectid: assigned subject id number groupid: assigned group id number sessionid: assigned session id number elapsedTime: time it took to run script (in ms); measured from onset to offset of script completed: 0 = script was not completed (prematurely aborted); 1 = script was completed (all conditions run) age: the entered age of the participant gradeLevel: the entered grade level of the participant gender: the entered gender of the participant rs_duration_ins: the RSPAN task duration in seconds rs_Total_StimsRecalled: the total number of digits recalled across all 6 RSPAN test rounds rs_zScore: the calculated z-score of the total number of recalled digits across all 6 RSPAN test rounds rs_percentile: the calculated percentile of the z-score of the total number of recalled digits across all 6 RSPAN test trials Note: mean and standard deviation used to calculate z-scorespercentile ranks are based on published data by Gonthier et al (2018) using a sample of French students. For more detail see Gonthier et al (2018). list.rs_processingACC_overall.mean: the mean proportion correct Processing Task ('sentence problems') performance across all 6 RSPAN test rounds rs_processingTaskFlag: 1 = the mean proportion correct RSPAN Processing Task ('sentence problems') performance is below 70% correct (RSPAN performance is flagged) 0 = otherwise (RSPAN performance is not flagged) list.rs_currentLevels.mean: the average RSPAN span size worked on list.rs_currentLevels.minimum: the minimum RSPAN span size worked on (lowest possible span size tested: 2) list.rs_currentLevels.maximum: the maximum RSPAN span size worked on (highest possible span size tested: 8) rs_Level2Count: number of times span size 2 was run during the RSPAN rs_Level3Count: number of times span size 3 was run during the RSPAN rs_Level4Count: number of times span size 4 was run during the RSPAN rs_Level5Count: number of times span size 5 was run during the RSPAN rs_Level6Count: number of times span size 6 was run during the RSPAN rs_Level7Count: number of times span size 7 was run during the RSPAN rs_Level8Count: number of times span size 8 was run during the RSPAN *************************************** RSPAN Descriptive Statistics by Round: *************************************** rs_level_Round1: RSPAN span size tested during Round 1 (by default: 4) rs_problemCumACC_Round1: number of correctly answered RSPAN Processing Task ('sentence evaluation task') problems during Round 1 rs_processingACC_Round1: proportion correct RSPAN Processing Task ('sentence evaluation task') performance during Round 1 rs_stims_Round1: the presented RSPAN recall stims ('digits') during Round 1 (in the order presented) rs_recallResponse_Round1: the recalled RSPAN stims ('digits') during Round 1 (in the order selected) rs_numberStimsRecalled_Round1: the number of correctly recalled RSPAN stims ('digits') during Round 1 rs_level_Round2: RSPAN span size tested during Round 2 rs_problemCumACC_Round2: number of correctly answered RSPAN Processing Task ('sentence evaluation task') problems during Round 2 rs_processingACC_Round2: proportion correct RSPAN Processing Task ('sentence evaluation task') performance during Round 2 rs_stims_Round2: the presented RSPAN recall stims ('digits') during Round 2 (in the order presented) rs_recallResponse_Round2: the recalled RSPAN stims ('digits') during Round 2 (in the order selected) rs_numberStimsRecalled_Round2: the number of correctly recalled RSPAN stims ('digits') during Round 2 rs_level_Round3: RSPAN span size tested during Round 3 rs_problemCumACC_Round3: number of correctly answered RSPAN Processing Task ('sentence evaluation task') problems during Round 3 rs_processingACC_Round3: proportion correct RSPAN Processing Task ('sentence evaluation task') performance during Round 3 rs_stims_Round3: the presented RSPAN recall stims ('digits') during Round 3 (in the order presented) rs_recallResponse_Round3: the recalled RSPAN stims ('digits') during Round 3 (in the order selected) rs_numberStimsRecalled_Round3: the number of correctly recalled RSPAN stims ('digits') during Round 3 rs_level_Round4: RSPAN span size tested during Round 4 rs_problemCumACC_Round4: number of correctly answered RSPAN Processing Task ('sentence evaluation task') problems during Round 4 rs_processingACC_Round4: proportion correct RSPAN Processing Task ('sentence evaluation task') performance during Round 4 rs_stims_Round4: the presented RSPAN recall stims ('digits') during Round 4 (in the order presented) rs_recallResponse_Round4: the recalled RSPAN stims ('digits') during Round 4 (in the order selected) rs_numberStimsRecalled_Round4: the number of correctly recalled RSPAN stims ('digits') during Round 4 rs_level_Round5: RSPAN span size tested during Round 5 rs_problemCumACC_Round5: number of correctly answered RSPAN Processing Task ('sentence evaluation task') problems during Round 5 rs_processingACC_Round5: proportion correct RSPAN Processing Task ('sentence evaluation task') performance during Round 5 rs_stims_Round5: the presented RSPAN recall stims ('digits') during Round 5 (in the order presented) rs_recallResponse_Round5: the recalled RSPAN stims ('digits') during Round 5 (in the order selected) rs_numberStimsRecalled_Round5: the number of correctly recalled RSPAN stims ('digits') during Round 5 rs_level_Round6: RSPAN span size tested during Round 6 rs_problemCumACC_Round6: number of correctly answered RSPAN Processing Task ('sentence evaluation task') problems during Round 6 rs_processingACC_Round6: proportion correct RSPAN Processing Task ('sentence evaluation task') performance during Round 6 rs_stims_Round6: the presented RSPAN recall stims ('digits') during Round 6 (in the order presented) rs_recallResponse_Round6: the recalled RSPAN stims ('digits') during Round 6 (in the order selected) rs_numberStimsRecalled_Round6: the number of correctly recalled RSPAN stims ('digits') during Round 6 ******************************* RSPAN Training Performance: ******************************* rs_spanTaskTrainingCount: the number of times the RSPAN span task training was run (RSPAN practice 1) rs_processingTaskTrainingCount: the number of times the RSPAN processing task training was run (RSPAN practice 2) rs_dualTaskTrainingCount: the number of times the RSPAN span task training was run (RSPAN practice 3) ******************************* RSPAN Processing Task duration: ******************************* rs_processingTaskMaxDuration: the maximum duration (in ms) that RSPAN processing Task problems ('sentence problems') are presented during the Dual Task Training block (=practice3) and the actual Test rounds. This duration was calculated based on the Median Processing Task Duration during the Processing Task Training (=practice2): 'RS ProcessingTask medianRT' + 2.5 x 'RS Processing Task MAD RT' rs_processingRT_median: the median response latency answering RSPAN processing task problems ('sentence problems') during practice2 rs_processingRT_MAD: Median Absolute Deviation (MAD) of response latencies answering RSPAN processing task problems during practice2 * separate data files: to change to one data file for all participants (on Inquisit Lab only), go to section "DATA" and follow further instructions ___________________________________________________________________________________________________________________ EXPERIMENTAL SET-UP ___________________________________________________________________________________________________________________ Note: level = span size 4 phases: PHASE 1: Practice 1 -Digit Recall Training ("Memory Task") Participants work on 2 trials (level 2, followed by level 3) with a fixed set of stimuli for each round. During this phase, they only work on the digit recall task (no sentences are presented) Trial Sequence: blank (700ms)->Start Fixation Cross (presented for 1200ms) -> blank (for 500ms) -> Digit (800ms) -> Blank (800ms) -> Digit (800ms) -> Blank (800ms) -> .......-> Blank (700ms) -> Recall Screen (as long as needed, corrections possible) -> Feedback (3000ms) At the end of Practice1, recall performance is analyzed and the practice block is repeated IF mean recall performance is under 70% correct. (recall performance: the number of digits correctly recalled in the exact position of presentation) PHASE 2: Practice 2 - Sentence Evaluation Training ("Processing Task") Participants work on 10 sentences (e.g. "Fish live on land") and evaluate them to be 'true' or 'false'. The sentences are the same for each participant and are presented in fixed order. No digit recall task is run. Trial Sequence: blank (700ms)->Start Fixation Cross (presented for 1200ms) -> blank (for 500ms) -> Sentence (max. 8000ms) -> Feedback (3000ms) -> Blank (150ms) -> Sentence (max. 8000ms) -> Feedback (3000ms).... At the end of this practice round, evaluation performance is analyzed and the practice block is repeated if the proportion correctly evaluated sentences is under 70% correct. Furthermore, the duration of the sentence presentation for the test trials is calculated: median time (in ms) the problems were answered + 2.5 x Median Absolute Deviation (MAD). (Range: 2000ms - 8000ms) PHASE 3: Practice 3 - Dual Task Training Participants work on 2 combined trials (level 2, level 3). The stimuli are the same for all participants and are presented in fixed order. Trial Sequence: blank (700ms)->Start Fixation Cross (presented for 1200ms) -> blank (for 500ms) -> Sentence (calculated presentation time during practice 2) -> Blank (150ms) -> Digit (800ms) -> Blank (800ms) -> Sentence (calculated presentation time during practice 2) -> Blank (150ms) -> Digit (800ms) -> Blank (800ms) -> ..... Digit (800ms) -> Blank (700ms) -> Recall Screen At the end of this practice round, performance is analyzed and feedback is provided. PHASE 4: Test (Dual Task) Participants work on 6 combined trials (starting level = 4; levels are adjusted based on performance thereafter). Each trial (1-6) presents the stimuli from the same stimuli lists in the same order (though not all participants will work on all the possible stimuli of a particular trial as this is level dependent). No more feedback is provided. Trial Sequence: blank (700ms)->Start Fixation Cross (presented for 1200ms) -> blank (for 500ms) -> Sentence (calculated presentation time during practice 2) -> Blank (150ms) -> Digit (800ms) -> Blank (800ms) -> Sentence (calculated presentation time during practice 2) -> Blank (150ms) -> Digit (800ms) -> Blank (800ms) -> ..... Digit (800ms) -> Blank (700ms) -> Recall Screen During each round, the computer calculates a. processing task performance (here: sentence evaluation performance) b. recall performance - the number of correctly recalled digits - the total number of correctly recalled digits At the end of each round, the next level is determined based on recall performance: 1. levels goes down by 1 for recall performance less than 60% 2. levels stay the same for 60% <= recall performance < 100% 3. levels go up by 1 for perfect recall performance (100% correct) ___________________________________________________________________________________________________________________ STIMULI ___________________________________________________________________________________________________________________ All original French stimuli are provided by Gonthier et al (2018) All materials for the ACCES – including the stimuli, an open source implementation of the task script under PsychoPy (Peirce, 2007), and all validation data – can be accessed via the Open Science Framework platform at https://osf.io/bk7pm/. IMPORTANT NOTE: This script uses English sentences provided by Millisecond Software. The sentences are similar to the original French ones by Gonthier et al (2018); however, they are untested. The sentences can easily be exchanged under section Editable Stimuli. ___________________________________________________________________________________________________________________ INSTRUCTIONS ___________________________________________________________________________________________________________________ Instructions are modelled after the ones used in the e-prime script provided by Gonthier et al (2018). The instructions in this script are provided by as htm/html pages and can be edited by changing the provided htm/html files. To edit htm/html-files: open the respective documents in simple Text Editors such as TextEdit (Mac) or Notepad (Windows). Note: in order for the instructions to reflect alternative parameter settings, some of the conditionalized code used in the htm files can be found in the script itself. ___________________________________________________________________________________________________________________ EDITABLE CODE ___________________________________________________________________________________________________________________ check below for (relatively) easily editable parameters, stimuli, instructions etc. Keep in mind that you can use this script as a template and therefore always "mess" with the entire code to further customize your experiment. The parameters you can change are: see below ___________________________________________________________________________________________________________________ *Adaptive Composite Complex Span Test (ACCES)* Subtest: Symmetry Span Test (SSPAN) ___________________________________________________________________________________________________________________ Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC Date: 05-29-201904 last updated: 05-02-2024 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC Script Copyright © 05-02-2024 Millisecond Software ___________________________________________________________________________________________________________________ BACKGROUND INFO ___________________________________________________________________________________________________________________ This script implements the Symmetry Span test subtest of the Adaptive Composite Complex Span Test (ACCES); an adaptive test of working memory with visuospatial ("symmetry span test"), mathematical ("operation span test") and verbal subtests ("reading span test") for children ages 8-13. The ACCES was developed by Gonthier et al (2018). According to the authors "the test presents a fixed number of trials to all participants, allows for partial credit scoring, and can be used with children regardless of ability level. The ACCES demonstrated satisfying psychometric properties in a sample of 268 children aged 8–13 years." (p.910) All materials for the ACCES – including the stimuli, an open source implementation of the task script under PsychoPy (Peirce, 2007), and all validation data – can be accessed via the Open Science Framework platform at https://osf.io/bk7pm/. Norms in this script (based on grade level) use the data provided by Gonthier et al (2018) collected with a sample of French students. Reference: Gonthier, C., Thomassin, N., & Roulin, J.-L. (2016). The Composite Complex Span: French validation of a short working memory task. Behavior Research Methods, 48(1), 233-242. doi:10.?3758/?s13428-015-0566-3 Gonthier C, Aubry A, Bourdin B. (2018). Measuring working memory capacity in children using adaptive tasks: Example validation of an adaptive complex span. Behav Res Methods. Jun;50(3):910-921. doi: 10.3758/s13428-017-0916-4. PMID: 28643158. ___________________________________________________________________________________________________________________ TASK DESCRIPTION ___________________________________________________________________________________________________________________ Participants work on 6 symmetry span test trials. Levels for each trial (after the first) are adapted based on performance. Symmetry Span Test: a dual task involving the evaluation of simple symmetry problems while also trying to remember spatial location in a 4x4 matrix: Evaluation of Symmetry Problem -> Matrix Position Learning -> .....-> Matrix Positions Recall The number of 'symmetry-evaluations/spatial position learning' combos depends on the level of difficulty (=span size) of the current test trial. All participants start at level 4. Depending on performance they move up, stay on the same level, or go down a level. The lowest level tested is level 2; the highest level tested in the SSPAN is level 7. The task provides 3 practice session before the actual 6 test trials are run: Practice 1: training of the spatial location recall task Practice 2: training of the symmetry evaluation task Practice 3: dual training of the combined task ___________________________________________________________________________________________________________________ DURATION ___________________________________________________________________________________________________________________ the default set-up of the script takes appr. 9 minutes to complete ___________________________________________________________________________________________________________________ DATA FILE INFORMATION ___________________________________________________________________________________________________________________ The default data stored in the data files are: (1) Raw data file: 'acces_sspan_raw*.iqdat' (a separate file for each participant)* build: The specific Inquisit version used (the 'build') that was run computer.platform: the platform the script was run on (win/mac/ios/android) date, time: date and time script was run subject, group, with the current subject/groupnumber session: with the current session id blockcode, blocknum: the name and number of the current block (built-in Inquisit variable) trialcode, trialnum: the name and number of the currently recorded trial (built-in Inquisit variable) Note: trialnum is a built-in Inquisit variable; it counts all trials run; even those that do not store data to the data file such as feedback trials. Thus, trialnum may not reflect the number of main trials run per block. age: the entered age of the participant gradeLevel: the entered grade level of the participant gender: the entered gender of the participant phase: stores the name of the current task phase RoundCount: counts the rounds ("trials") run in the current phase currentLevel: stores the levelspansize tested in the current round *************************************** Processing Task Variables: *************************************** ProcessingTaskProblem: stores the current processing task problem (e.g. symmetry evaluation) presented correctResponse: stores the correct response to the current processing task problem (TRUE vs. FALSE) processingTaskResponse: stores the given response to the current processing task problem (TRUE vs. FALSE) processingTaskACC: stores the accuracy of the processing task response 1 = correct 0 = error processingTaskCumACC; stores the number of correct processing task responses *************************************** Memory Task Variables: *************************************** stim: stores the current recall stim (e.g. Matrix position) presented currentStims: stores the collected recall stims of the current round in the order presented recallResponse: stores the recall stims of the current round in the order selected on the recall matrix numberStimsRecalled: stores the number of correctly recalled stims of the current round Total_StimsRecalled: stores the total number of correctly recalled stims during the current task stimulusitem: the presented stimuli in order of trial presentation of the currently recorded trial response: the participant's response (scancode of response buttons) of the currently recorded trial correct: accuracy of response: 1 = correct response; 0 = otherwise of the currently recorded trial latency: the response latency (in ms) of the current trial (2) Summary data file: 'acces_sspan_summary*.iqdat' (a separate file for each participant)* inquisit.version: Inquisit version run computer.platform: the platform the script was run on (win/mac/ios/android) startDate: date script was run startTime: time script was started subjectid: assigned subject id number groupid: assigned group id number sessionid: assigned session id number elapsedTime: time it took to run script (in ms); measured from onset to offset of script completed: 0 = script was not completed (prematurely aborted); 1 = script was completed (all conditions run) age: the entered age of the participant gradeLevel: the entered grade level of the participant gender: the entered gender of the participant ss_duration_ins: the SSPAN task duration in seconds ss_Total_StimsRecalled: the total number of matrix positions recalled across all 6 SSPAN test rounds ss_zScore: the calculated z-score of the total number of recalled matrix positions across all 6 SSPAN test rounds ss_percentile: the calculated percentile of the z-score of the total number of recalled matrix positions across all 6 SSPAN test trials Note: mean and standard deviation used to calculate z-scorespercentile ranks are based on published data by Gonthier et al (2018) using a sample of French students. For more detail see Gonthier et al (2018). list.ss_processingACC_overall.mean: the mean proportion correct Processing Task ('symmetry problems') performance across all 6 SSPAN test rounds ss_processingTaskFlag: 1 = the mean proportion correct SSPAN Processing Task ('symmetry problems') performance is below 70% correct (SSPAN performance is flagged) 0 = otherwise (SSPAN performance is not flagged) list.ss_currentLevels.mean: the average SSPAN span size worked on list.ss_currentLevels.minimum: the minimum SSPAN span size worked on (lowest possible span size tested: 2) list.ss_currentLevels.maximum: the maximum SSPAN span size worked on (highest possible span size tested: 8) ss_Level2Count: number of times span size 2 was run during the SSPAN ss_Level3Count: number of times span size 3 was run during the SSPAN ss_Level4Count: number of times span size 4 was run during the SSPAN ss_Level5Count: number of times span size 5 was run during the SSPAN ss_Level6Count: number of times span size 6 was run during the SSPAN ss_Level7Count: number of times span size 7 was run during the SSPAN ss_Level8Count: number of times span size 8 was run during the SSPAN *************************************** SSPAN Descriptive Statistics by Round: *************************************** ss_level_Round1: SSPAN span size tested during Round 1 (by default: 4) ss_problemCumACC_Round1: number of correctly answered SSPAN Processing Task ('symmetry evaluation task') problems during Round 1 ss_processingACC_Round1: proportion correct SSPAN Processing Task ('symmetry evaluation task') performance during Round 1 ss_stims_Round1: the presented SSPAN recall stims ('matrix positions') during Round 1 (in the order presented) ss_recallResponse_Round1: the recalled SSPAN stims ('matrix positions') during Round 1 (in the order selected) ss_numberStimsRecalled_Round1: the number of correctly recalled SSPAN stims ('matrix positions') during Round 1 ss_level_Round2: SSPAN span size tested during Round 2 ss_problemCumACC_Round2: number of correctly answered SSPAN Processing Task ('symmetry evaluation task') problems during Round 2 ss_processingACC_Round2: proportion correct SSPAN Processing Task ('symmetry evaluation task') performance during Round 2 ss_stims_Round2: the presented SSPAN recall stims ('matrix positions') during Round 2 (in the order presented) ss_recallResponse_Round2: the recalled SSPAN stims ('matrix positions') during Round 2 (in the order selected) ss_numberStimsRecalled_Round2: the number of correctly recalled SSPAN stims ('matrix positions') during Round 2 ss_level_Round3: SSPAN span size tested during Round 3 ss_problemCumACC_Round3: number of correctly answered SSPAN Processing Task ('symmetry evaluation task') problems during Round 3 ss_processingACC_Round3: proportion correct SSPAN Processing Task ('symmetry evaluation task') performance during Round 3 ss_stims_Round3: the presented SSPAN recall stims ('matrix positions') during Round 3 (in the order presented) ss_recallResponse_Round3: the recalled SSPAN stims ('matrix positions') during Round 3 (in the order selected) ss_numberStimsRecalled_Round3: the number of correctly recalled SSPAN stims ('matrix positions') during Round 3 ss_level_Round4: SSPAN span size tested during Round 4 ss_problemCumACC_Round4: number of correctly answered SSPAN Processing Task ('symmetry evaluation task') problems during Round 4 ss_processingACC_Round4: proportion correct SSPAN Processing Task ('symmetry evaluation task') performance during Round 4 ss_stims_Round4: the presented SSPAN recall stims ('matrix positions') during Round 4 (in the order presented) ss_recallResponse_Round4: the recalled SSPAN stims ('matrix positions') during Round 4 (in the order selected) ss_numberStimsRecalled_Round4: the number of correctly recalled SSPAN stims ('matrix positions') during Round 4 ss_level_Round5: SSPAN span size tested during Round 5 ss_problemCumACC_Round5: number of correctly answered SSPAN Processing Task ('symmetry evaluation task') problems during Round 5 ss_processingACC_Round5: proportion correct SSPAN Processing Task ('symmetry evaluation task') performance during Round 5 ss_stims_Round5: the presented SSPAN recall stims ('matrix positions') during Round 5 (in the order presented) ss_recallResponse_Round5: the recalled SSPAN stims ('matrix positions') during Round 5 (in the order selected) ss_numberStimsRecalled_Round5: the number of correctly recalled SSPAN stims ('matrix positions') during Round 5 ss_level_Round6: SSPAN span size tested during Round 6 ss_problemCumACC_Round6: number of correctly answered SSPAN Processing Task ('symmetry evaluation task') problems during Round 6 ss_processingACC_Round6: proportion correct SSPAN Processing Task ('symmetry evaluation task') performance during Round 6 ss_stims_Round6: the presented SSPAN recall stims ('matrix positions') during Round 6 (in the order presented) ss_recallResponse_Round6: the recalled SSPAN stims ('matrix positions') during Round 6 (in the order selected) ss_numberStimsRecalled_Round6: the number of correctly recalled SSPAN stims ('matrix positions') during Round 6 *************************************** SSPAN Training Performance: *************************************** ss_spanTaskTrainingCount: the number of times the SSPAN span task training was run (SSPAN practice 1) ss_processingTaskTrainingCount: the number of times the SSPAN processing task training was run (SSPAN practice 2) ss_dualTaskTrainingCount: the number of times the SSPAN span task training was run (SSPAN practice 3) *************************************** SSPAN Processing Task duration: *************************************** ss_processingTaskMaxDuration: the maximum duration (in ms) that SSPAN processing Task problems ('symmetry problems') are presented during the Dual Task Training block (=practice3) and the actual Test rounds. This duration was calculated based on the Median Processing Task Duration during the Processing Task Training (=practice2): 'SS ProcessingTask medianRT' + 2.5 x 'SS Processing Task MAD RT' ss_processingRT_median: the median response latency answering SSPAN processing task problems ('symmetry problems') during practice2 ss_processingRT_MAD: Median Absolute Deviation (MAD) of response latencies answering SSPAN processing task problems during practice2 * separate data files: to change to one data file for all participants (on Inquisit Lab only), go to section "DATA" and follow further instructions ___________________________________________________________________________________________________________________ EXPERIMENTAL SET-UP ___________________________________________________________________________________________________________________ Note: level = span size 4 phases: PHASE 1: Practice 1 -Matrix position Recall Training ("Memory Task") Participants work on 2 trials (level 2, followed by level 3) with a fixed set of stimuli for each round. During this phase, they only work on the Matrix position Recall task (no symmetry problems are presented) Trial Sequence: blank (700ms)->Start Fixation Cross (presented for 1200ms) -> blank (for 500ms) -> Matrix position (800ms) -> Blank (800ms) -> Matrix position (800ms) -> Blank (800ms) -> .......-> Blank (700ms) -> Recall Screen (as long as needed, corrections possible) -> Feedback (3000ms) At the end of Practice1, recall performance is analyzed and the practice block is repeated IF mean recall performance is under 70% correct. (recall performance: the number of Matrix positions correctly recalled in the exact position of presentation) PHASE 2: Practice 2 - Symmetry Problem Evaluation Training ("Processing Task") Participants work on 10 Symmetry Problems and evaluate them to be 'true' (when symmetric) or 'false' (when asymmetric). The Symmetry Problems are the same for each participant and are presented in fixed order. No Matrix position Recall task is run. Trial Sequence: blank (700ms)->Start Fixation Cross (presented for 1200ms) -> blank (for 500ms) -> Symmetry Problem (max. 8000ms) -> Feedback (3000ms) -> Blank (150ms) -> Symmetry Problem (max. 8000ms) -> Feedback (3000ms).... At the end of this practice round, symmetry performance is analyzed and the practice block is repeated if the proportion correctly evaluated Symmetry Problems is under 70% correct. Furthermore, the duration of the symmetry problem presentation for the test trials is calculated: median time (in ms) the problems were answered + 2.5 x Median Absolute Deviation (MAD). (Range: 2000ms - 8000ms) PHASE 3: Practice 3 - Dual Task Training Participants work on 2 combined trials (level 2, level 3). The stimuli are the same for all participants and are presented in fixed order. Trial Sequence: blank (700ms)->Start Fixation Cross (presented for 1200ms) -> blank (for 500ms) -> Symmetry Problem (calculated presentation time during practice 2) -> Blank (150ms) -> Matrix position (800ms) -> Blank (800ms) -> Symmetry Problem (calculated presentation time during practice 2) -> Blank (150ms) -> Matrix position (800ms) -> Blank (800ms) -> ..... Matrix position (800ms) -> Blank (700ms) -> Recall Screen At the end of this practice round, performance is analyzed and feedback is provided. PHASE 4: Test (Dual Task) Participants work on 6 combined trials (starting level = 3; levels are adjusted based on performance thereafter). Each trial (1-6) presents the stimuli from the same stimuli lists in the same order (though not all participants will work on all the possible stimuli of a particular trial as this is level dependent). No more feedback is provided. Trial Sequence: blank (700ms)->Start Fixation Cross (presented for 1200ms) -> blank (for 500ms) -> Symmetry Problem (calculated presentation time during practice 2) -> Blank (150ms) -> Matrix position (800ms) -> Blank (800ms) -> Symmetry Problem (calculated presentation time during practice 2) -> Blank (150ms) -> Matrix position (800ms) -> Blank (800ms) -> ..... Matrix position (800ms) -> Blank (700ms) -> Recall Screen During each round, the computer calculates a. processing task performance (here: symmetry performance) b. recall performance - the number of correctly recalled Matrix positions - the total number of correctly recalled Matrix positions At the end of each round, the next level is determined based on recall performance: 1. levels goes down by 1 for recall performance less than 60% 2. levels stay the same for 60% <= recall performance < 100% 3. levels go up by 1 for perfect recall performance (100% correct) ___________________________________________________________________________________________________________________ STIMULI ___________________________________________________________________________________________________________________ All stimuli are provided by Gonthier et al (2018) All materials for the ACCES – including the stimuli, an open source implementation of the task script under PsychoPy (Peirce, 2007), and all validation data – can be accessed via the Open Science Framework platform at https://osf.io/bk7pm/. ___________________________________________________________________________________________________________________ INSTRUCTIONS ___________________________________________________________________________________________________________________ Instructions are modelled after the ones used in the e-prime script provided by Gonthier et al (2018). The instructions in this script are provided by as htm/html pages and can be edited by changing the provided htm/html files. To edit htm/html-files: open the respective documents in simple Text Editors such as TextEdit (Mac) or Notepad (Windows). Note: in order for the instructions to reflect alternative parameter settings, some of the conditionalized code used in the htm files can be found in the script itself. ___________________________________________________________________________________________________________________ EDITABLE CODE ___________________________________________________________________________________________________________________ check below for (relatively) easily editable parameters, stimuli, instructions etc. Keep in mind that you can use this script as a template and therefore always "mess" with the entire code to further customize your experiment. The parameters you can change are: see below ___________________________________________________________________________________________________________________ *Adaptive Composite Complex Span Test (ACCES)* Subtest: Operation Span Test (OSPAN) ___________________________________________________________________________________________________________________ Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC Date: 05-29-201904 last updated: 11-06-2023 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC Script Copyright © 11-06-2023 Millisecond Software ___________________________________________________________________________________________________________________ BACKGROUND INFO ___________________________________________________________________________________________________________________ This script implements the Operation Span test subtest of the Adaptive Composite Complex Span Test (ACCES); an adaptive test of working memory with visuospatial ("symmetry span test"), mathematical ("operation span test") and verbal subtests ("reading span test"). The ACCES was developed by Gonthier et al (2018). According to the authors "the test presents a fixed number of trials to all participants, allows for partial credit scoring, and can be used with children regardless of ability level. The ACCES demonstrated satisfying psychometric properties in a sample of 268 children aged 8–13 years." (p.910) All materials for the ACCES – including the stimuli, an open source implementation of the task script under PsychoPy (Peirce, 2007), and all validation data – can be accessed via the Open Science Framework platform at https://osf.io/bk7pm/. Norms in this script (based on grade level) use the data provided by Gonthier et al (2018) collected with a sample of French students. Reference: Gonthier, C., Thomassin, N., & Roulin, J.-L. (2016). The Composite Complex Span: French validation of a short working memory task. Behavior Research Methods, 48(1), 233-242. doi:10.?3758/?s13428-015-0566-3 Gonthier C, Aubry A, Bourdin B. (2018). Measuring working memory capacity in children using adaptive tasks: Example validation of an adaptive complex span. Behav Res Methods. Jun;50(3):910-921. doi: 10.3758/s13428-017-0916-4. PMID: 28643158. ___________________________________________________________________________________________________________________ TASK DESCRIPTION ___________________________________________________________________________________________________________________ Participants work on 6 operation span test trials. Levels for each trial (after the first) are adapted based on performance. Operation Span Test: a dual task involving the evaluation of simple math problems (e.g. '2 + 2 = 5') while also studying letters for a later recall test: Evaluation of Math Problem -> Letter Learning -> Evaluation of Math Problem -> Letter Learning.....-> Letter Recall The number of 'Math-evaluations/Letter learning' combos depends on the level of difficulty (=span size) of the current test trial. All participants start at level 4. Depending on performance they move up, stay on the same level, or go down a level. The lowest level tested is level 2; the highest level tested is level 8. The task provides 3 practice session before the actual 6 test trials are run: Practice 1: training of the letter recall task Practice 2: training of the math evaluation task Practice 3: dual training of the combined task ___________________________________________________________________________________________________________________ DURATION ___________________________________________________________________________________________________________________ the default set-up of the script takes appr. 9 minutes to complete ___________________________________________________________________________________________________________________ DATA FILE INFORMATION ___________________________________________________________________________________________________________________ The default data stored in the data files are: (1) Raw data file: 'acces_ospan_raw*.iqdat' (a separate file for each participant)* build: The specific Inquisit version used (the 'build') that was run computer.platform: the platform the script was run on (winmaciosandroid) date, time: date and time script was run subject, group: with the current subject/groupnumber session: with the current session id blockcode, blocknum: the name and number of the current block (built-in Inquisit variable) trialcode, trialnum: the name and number of the currently recorded trial (built-in Inquisit variable) Note: trialnum is a built-in Inquisit variable; it counts all trials run; even those that do not store data to the data file such as feedback trials. Thus, trialnum may not reflect the number of main trials run per block. age: the entered age of the participant gradeLevel: the entered grade level of the participant gender: the entered gender of the participant phase: stores the name of the current task phase RoundCount: counts the rounds ("trials") run in the current phase currentLevel: stores the levelspansize tested in the current round *************************************** Processing Task Variables: *************************************** ProcessingTaskProblem: stores the current processing task problem (e.g. math problem) presented correctResponse: stores the correct response to the current processing task problem (TRUE vs. FALSE) processingTaskResponse: stores the given response to the current processing task problem (TRUE vs. FALSE) processingTaskACC: stores the accuracy of the processing task response 1 = correct 0 = error processingTaskCumACC: stores the number of correct processing task responses *************************************** Memory Task Variables: *************************************** stim: stores the current recall stim (e.g. letter) presented currentStims: stores the collected recall stims of the current round in the order presented recallResponse: stores the recall stims of the current round in the order selected on the recall matrix numberStimsRecalled: stores the number of correctly recalled stims of the current round Total_StimsRecalled: stores the total number of correctly recalled stims during the current task stimulusitem: the presented stimuli in order of trial presentation of the currently recorded trial response: the participant's response of the currently recorded trial correct: accuracy of response: 1 = correct response; 0 = otherwise of the currently recorded trial latency: the response latency (in ms) of the current trial (2) Summary data file: 'acces_ospan_summary*.iqdat' (a separate file for each participant)* inquisit.version: Inquisit version run computer.platform: the platform the script was run on (win/mac/ios/android) startDate: date script was run startTime: time script was started subjectid: assigned subject id number groupid: assigned group id number sessionid: assigned session id number elapsedTime: time it took to run script (in ms); measured from onset to offset of script completed: 0 = script was not completed (prematurely aborted); 1 = script was completed (all conditions run) age: the entered age of the participant gradeLevel: the entered grade level of the participant gender: the entered gender of the participant os_duration_ins: the OSPAN task duration in seconds os_Total_StimsRecalled: the total number of letters recalled across all 6 OSPAN test rounds os_zScore: the calculated z-score of the total number of recalled letters across all 6 OSPAN test rounds os_percentile: the calculated percentile of the z-score of the total number of recalled letters across all 6 OSPAN test trials Note: mean and standard deviation used to calculate z-scorespercentile ranks are based on published data by Gonthier et al (2018) using a sample of French students. For more detail see Gonthier et al (2018). list.os_processingACC_overall.mean: the mean proportion correct Processing Task ('math problems') performance across all 6 OSPAN test rounds os_processingTaskFlag: 1 = the mean proportion correct OSPAN Processing Task ('math problems') performance is below 70% correct (OSPAN performance is flagged) 0 = otherwise (OSPAN performance is not flagged) list.os_currentLevels.mean: the average OSPAN span size worked on list.os_currentLevels.minimum: the minimum OSPAN span size worked on (lowest possible span size tested: 2) list.os_currentLevels.maximum: the maximum OSPAN span size worked on (highest possible span size tested: 8) os_Level2Count: number of times span size 2 was run during the OSPAN os_Level3Count: number of times span size 3 was run during the OSPAN os_Level4Count: number of times span size 4 was run during the OSPAN os_Level5Count: number of times span size 5 was run during the OSPAN os_Level6Count: number of times span size 6 was run during the OSPAN os_Level7Count: number of times span size 7 was run during the OSPAN os_Level8Count: number of times span size 8 was run during the OSPAN *************************************** OSPAN Descriptive Statistics by Round: *************************************** os_level_Round1: OSPAN span size tested during Round 1 (by default: 4) os_problemCumACC_Round1: number of correctly answered OSPAN Processing Task ('math task') problems during Round 1 os_processingACC_Round1: proportion correct OSPAN Processing Task ('math task') performance during Round 1 os_stims_Round1: the presented OSPAN recall stims ('letters') during Round 1 (in the order presented) os_recallResponse_Round1: the recalled OSPAN stims ('letters') during Round 1 (in the order selected) os_numberStimsRecalled_Round1: the number of correctly recalled OSPAN stims ('letters') during Round 1 os_level_Round2: OSPAN span size tested during Round 2 os_problemCumACC_Round2: number of correctly answered OSPAN Processing Task ('math task') problems during Round 2 os_processingACC_Round2: proportion correct OSPAN Processing Task ('math task') performance during Round 2 os_stims_Round2: the presented OSPAN recall stims ('letters') during Round 2 (in the order presented) os_recallResponse_Round2: the recalled OSPAN stims ('letters') during Round 2 (in the order selected) os_numberStimsRecalled_Round2: the number of correctly recalled OSPAN stims ('letters') during Round 2 os_level_Round3: OSPAN span size tested during Round 3 os_problemCumACC_Round3: number of correctly answered OSPAN Processing Task ('math task') problems during Round 3 os_processingACC_Round3: proportion correct OSPAN Processing Task ('math task') performance during Round 3 os_stims_Round3: the presented OSPAN recall stims ('letters') during Round 3 (in the order presented) os_recallResponse_Round3: the recalled OSPAN stims ('letters') during Round 3 (in the order selected) os_numberStimsRecalled_Round3: the number of correctly recalled OSPAN stims ('letters') during Round 3 os_level_Round4: OSPAN span size tested during Round 4 os_problemCumACC_Round4: number of correctly answered OSPAN Processing Task ('math task') problems during Round 4 os_processingACC_Round4: proportion correct OSPAN Processing Task ('math task') performance during Round 4 os_stims_Round4: the presented OSPAN recall stims ('letters') during Round 4 (in the order presented) os_recallResponse_Round4: the recalled OSPAN stims ('letters') during Round 4 (in the order selected) os_numberStimsRecalled_Round4: the number of correctly recalled OSPAN stims ('letters') during Round 4 os_level_Round5: OSPAN span size tested during Round 5 os_problemCumACC_Round5: number of correctly answered OSPAN Processing Task ('math task') problems during Round 5 os_processingACC_Round5: proportion correct OSPAN Processing Task ('math task') performance during Round 5 os_stims_Round5: the presented OSPAN recall stims ('letters') during Round 5 (in the order presented) os_recallResponse_Round5: the recalled OSPAN stims ('letters') during Round 5 (in the order selected) os_numberStimsRecalled_Round5: the number of correctly recalled OSPAN stims ('letters') during Round 5 os_level_Round6: OSPAN span size tested during Round 6 os_problemCumACC_Round6: number of correctly answered OSPAN Processing Task ('math task') problems during Round 6 os_processingACC_Round6: proportion correct OSPAN Processing Task ('math task') performance during Round 6 os_stims_Round6: the presented OSPAN recall stims ('letters') during Round 6 (in the order presented) os_recallResponse_Round6: the recalled OSPAN stims ('letters') during Round 6 (in the order selected) os_numberStimsRecalled_Round6: the number of correctly recalled OSPAN stims ('letters') during Round 6 *************************************** OSPAN Training Performance: *************************************** os_spanTaskTrainingCount: the number of times the OSPAN span task training was run (OSPAN practice 1) os_processingTaskTrainingCount: the number of times the OSPAN processing task training was run (OSPAN practice 2) os_dualTaskTrainingCount: the number of times the OSPAN span task training was run (OSPAN practice 3) *************************************** OSPAN Processing Task duration: *************************************** os_processingTaskMaxDuration: the maximum duration (in ms) that OSPAN processing Task problems ('math problems') are presented during the Dual Task Training block (=practice3) and the actual Test rounds. This duration was calculated based on the Median Processing Task Duration during the Processing Task Training (=practice2): 'OS ProcessingTask medianRT' + 2.5 x 'OS Processing Task MAD RT' os_processingRT_median: the median response latency answering OSPAN processing task problems ('math problems') during practice2 os_processingRT_MAD: Median Absolute Deviation (MAD) of response latencies answering OSPAN processing task problems during practice2 * separate data files: to change to one data file for all participants (on Inquisit Lab only), go to section "DATA" and follow further instructions ___________________________________________________________________________________________________________________ EXPERIMENTAL SET-UP ___________________________________________________________________________________________________________________ Note: level = span size 4 phases: PHASE 1: Practice 1 -Letter Recall Training ("Memory Task") Participants work on 2 trials (level 2, followed by level 3) with a fixed set of stimuli for each round. During this phase, they only work on the letter recall task (no math problems are presented) Trial Sequence: blank (700ms)->Start Fixation Cross (presented for 1200ms) -> blank (for 500ms) -> Letter (800ms) -> Blank (800ms) -> Letter (800ms) -> Blank (800ms) -> .......-> Blank (700ms) -> Recall Screen (as long as needed, corrections possible) -> Feedback (3000ms) At the end of Practice1, recall performance is analyzed and the practice block is repeated IF mean recall performance is under 70% correct. (recall performance: the number of letters correctly recalled in the exact position of presentation) PHASE 2: Practice 2 - Math Statement Evaluation Training ("Processing Task") Participants work on 10 math statements (e.g. "2 + 2 = 6") and evaluate them to be 'true' or 'false'. The math statements are the same for each participant and are presented in fixed order. No letter recall task is run. Trial Sequence: blank (700ms)->Start Fixation Cross (presented for 1200ms) -> blank (for 500ms) -> Math Statement (max. 8000ms) -> Feedback (3000ms) -> Blank (150ms) -> Math Statement (max. 8000ms) -> Feedback (3000ms).... At the end of this practice round, evaluation performance is analyzed and the practice block is repeated if the proportion correctly evaluated math statements is under 70% correct. Furthermore, the duration of the math problem presentation for the test trials is calculated: median time (in ms) the problems were answered + 2.5 x Median Absolute Deviation (MAD). (Range: 2000ms - 8000ms) PHASE 3: Practice 3 - Dual Task Training Participants work on 2 combined trials (level 2, level 3). The stimuli are the same for all participants and are presented in fixed order. Trial Sequence: blank (700ms)->Start Fixation Cross (presented for 1200ms) -> blank (for 500ms) -> Math Statement (calculated presentation time during practice 2) -> Blank (150ms) -> Letter (800ms) -> Blank (800ms) -> Math Statement (calculated presentation time during practice 2) -> Blank (150ms) -> Letter (800ms) -> Blank (800ms) -> ..... Letter (800ms) -> Blank (700ms) -> Recall Screen -> Summary Feedback (3000ms) PHASE 4: Test (Dual Task) Participants work on 6 combined trials (starting level = 4; levels are adjusted based on performance thereafter). Each trial (1-6) presents the stimuli from the same stimuli lists in the same order (though not all participants will work on all the possible stimuli of a particular trial as this is level dependent). No more feedback is provided. Trial Sequence: blank (700ms)->Start Fixation Cross (presented for 1200ms) -> blank (for 500ms) -> Math Statement (calculated presentation time during practice 2) -> Blank (150ms) -> Letter (800ms) -> Blank (800ms) -> Math Statement (calculated presentation time during practice 2) -> Blank (150ms) -> Letter (800ms) -> Blank (800ms) -> ..... Letter (800ms) -> Blank (700ms) -> Recall Screen During each round, the computer calculates a. processing task performance (here: math performance) b. recall performance - the number of correctly recalled letters - the total number of correctly recalled letters At the end of each round, the next level is determined based on recall performance: 1. levels goes down by 1 for recall performance less than 60% 2. levels stay the same for 60% <= recall performance < 100% 3. levels go up by 1 for perfect recall performance (100% correct) ___________________________________________________________________________________________________________________ STIMULI ___________________________________________________________________________________________________________________ All stimuli are provided by Gonthier et al (2018) All materials for the ACCES – including the stimuli, an open source implementation of the task script under PsychoPy (Peirce, 2007), and all validation data – can be accessed via the Open Science Framework platform at https://osf.io/bk7pm/. ___________________________________________________________________________________________________________________ INSTRUCTIONS ___________________________________________________________________________________________________________________ Instructions are modelled after the ones used in the e-prime script provided by Gonthier et al (2018). The instructions in this script are provided by as htm/html pages and can be edited by changing the provided htm/html files. To edit htm/html-files: open the respective documents in simple Text Editors such as TextEdit (Mac) or Notepad (Windows). Note: in order for the instructions to reflect alternative parameter settings, some of the conditionalized code used in the htm files can be found in the script itself. ___________________________________________________________________________________________________________________ EDITABLE CODE ___________________________________________________________________________________________________________________ check below for (relatively) easily editable parameters, stimuli, instructions etc. Keep in mind that you can use this script as a template and therefore always "mess" with the entire code to further customize your experiment. The parameters you can change are (see below): ___________________________________________________________________________________________________________________ *Adaptive Composite Complex Span (ACCES)* Finish Script of the ACCES Test ___________________________________________________________________________________________________________________ Script Author: Katja Borchert, Ph.D. (katjab@millisecond.com) for Millisecond Software, LLC Date: 05-29-201904 last updated: 06-26-2024 by K. Borchert (katjab@millisecond.com) for Millisecond Software, LLC Script Copyright © 06-26-2024 Millisecond Software ___________________________________________________________________________________________________________________ BACKGROUND INFO ___________________________________________________________________________________________________________________ This script is run as a final data saving script for the acces.iqx, Millisecond Software's implementation of the Adaptive Composite Complex Span Test (ACCES); an adaptive test of working memory with visuospatial ("symmetry span test"), mathematical ("operation span test") and verbal subtests ("reading span test"). The ACCES was developed by Gonthier et al (2018). According to the authors "the test presents a fixed number of trials to all participants, allows for partial credit scoring, and can be used with children regardless of ability level. The ACCES demonstrated satisfying psychometric properties in a sample of 268 children aged 8–13 years." (p.910) All materials for the ACCES – including the stimuli, an open source implementation of the task script under PsychoPy (Peirce, 2007), and all validation data – can be accessed via the Open Science Framework platform at https://osf.io/bk7pm/. Reference: Gonthier, C., Thomassin, N., & Roulin, J.-L. (2016). The Composite Complex Span : French validation of a short working memory task. Behavior Research Methods, 48(1), 233-242. doi:10.?3758/?s13428-015-0566-3 Gonthier C, Aubry A, Bourdin B. (2018). Measuring working memory capacity in children using adaptive tasks: Example validation of an adaptive complex span. Behav Res Methods. Jun;50(3):910-921. doi: 10.3758/s13428-017-0916-4. PMID: 28643158. ___________________________________________________________________________________________________________________ TASK DESCRIPTION ___________________________________________________________________________________________________________________ This script is run as the last script in a batch of subtests for the ACCES test. It informs participants that the testing is now completed and stores the main performance data of all three subtests to a separate data file. ___________________________________________________________________________________________________________________ DATA FILE INFORMATION ___________________________________________________________________________________________________________________ The default data stored in the data files are: (1) Raw data file: 'acces_finish_raw*.iqdat' (a separate file for each participant)* build: The specific Inquisit version used (the 'build') that was run computer.platform: the platform the script was run on (win/mac/ios/android) date, time: date and time script was run subject, group: with the current subject/groupnumber session: with the current session id runDemographicSurvey true = script acces_demographics.iqx was set to run; false = script acces_demographics.iqx was skipped run_RSPAN true = script acces_rspan.iqx was set to run run; false = script acces_rspan.iqx was skipped run_SSPAN true = script acces_sspan.iqx was set to run run; false = script acces_sspan.iqx was skipped run_OSPAN true = script acces_ospan.iqx was set to run; false = script acces_ospan.iqx was set to skipped age: the entered age of the participant gradeLevel: the entered grade level of the participant gender: the entered gender of the participant WMC: the average of the standardized recall scores of the three subtests (RSPAN, SSPAN, OSPAN) Notes: 1. the score is only computed if all three subtests provided a standardized z-score of the recall scores 2. the z-scores of the individual subtests are generated based on the norms provided by Ganthier et al (2018) which may not be applicable for the sample of participants tested with this script. 3. the WMC score is generated regardless of performance on the processing tasks of the three subtest. check below if any of the processing tasks performances were flagged due to low performance. (-> RS ProcessingTask Flag/ SS ProcessingTask Flag / OS ProcessingTask Flag) *************** RSPAN DATA *************** rs_Total_StimsRecalled: the total number of digits recalled across all 6 RSPAN test rounds rs_zScore: the calculated z-score of the total number of recalled digits across all 6 RSPAN test rounds rs_percentile: the calculated percentile of the z-score of the total number of recalled digits across all 6 RSPAN test trials Note: mean and standard deviation used to calculate z-scores/percentile ranks are based on published data by Gonthier et al (2018) using a sample of French students. For more detail see Gonthier et al (2018). rs_processingACC: the mean proportion correct Processing Task ('sentence evaluations') performance across all 6 RSPAN test rounds rs_processingTaskFlag: 1 = the mean proportion correct RSPAN Processing Task ('sentence evaluations') performance is below 70% correct (RSPAN performance is flagged) 0 = otherwise (RSPAN performance is not flagged) *************** SSPAN DATA *************** ss_Total_StimsRecalled,: the total number of Matrix positions recalled across all 6 SSPAN test rounds ss_zScore: the calculated z-score of the total number of recalled Matrix positions across all 6 SSPAN test rounds ss_percentile: the calculated percentile of the z-score of the total number of recalled Matrix positions across all 6 SSPAN test trials Note: mean and standard deviation used to calculate z-scores/percentile ranks are based on published data by Gonthier et al (2018) using a sample of French students. For more detail see Gonthier et al (2018). ss_processingACC: the mean proportion correct Processing Task ('symmetry problems') performance across all 6 SSPAN test rounds ss_processingTaskFlag: 1 = the mean proportion correct SSPAN Processing Task ('symmetry problems') performance is below 70% correct (SSPAN performance is flagged) 0 = otherwise (SSPAN performance is not flagged) *************** OSPAN DATA *************** os_Total_StimsRecalled: the total number of letters recalled across all 6 OSPAN test rounds os_zScore: the calculated z-score of the total number of recalled letters across all 6 OSPAN test rounds os_percentile: the calculated percentile of the z-score of the total number of recalled letters across all 6 OSPAN test trials Note: mean and standard deviation used to calculate z-scores/percentile ranks are based on published data by Gonthier et al (2018) using a sample of French students. For more detail see Gonthier et al (2018). os_processingACC: the mean proportion correct Processing Task ('math problems') performance across all 6 OSPAN test rounds os_processingTaskFlag: 1 = the mean proportion correct OSPAN Processing Task ('math problems') performance is below 70% correct (OSPAN performance is flagged) 0 = otherwise (OSPAN performance is not flagged) * separate data files: to change to one data file for all participants (on Inquisit Lab only), go to section "DATA" and follow further instructions ___________________________________________________________________________________________________________________ EXPERIMENTAL SET-UP ___________________________________________________________________________________________________________________ This script runs one trial that provides finish-instructions to the ACCES test. ___________________________________________________________________________________________________________________ INSTRUCTIONS ___________________________________________________________________________________________________________________ provided by Millisecond Software in file "acces_testend.htm" Instructions are not original to the task. They are provided by Millisecond Software as htm/html pages and can be edited by changing the provided htm/html files. To edit htm/html-files: open the respective documents in simple Text Editors such as TextEdit (Mac) or Notepad (Windows).