This repository is dedicated to post-processing raw data from various cognitive performance tests within E-Prime, including the Psychomotor Vigilance Task (PVT), Digit Symbol Substitution Test (DSST), and Serial Addition tests. Utilizing Python, Pandas, and the Streamlit framework, it offers a suite of scripts designed for an intuitive user interface, allowing for the efficient transformation of unprocessed test outputs into structured CSV formats.
Each script within this suite is tailored to a specific cognitive test, facilitating both individual and batch processing of test data. The scripts support various output options, including combined and separated outputs, providing flexibility for data analysis and research purposes.
CognitiveTestsProcessors.py
: Script that runs Streamlit application.
- PVT:
PVT_to_ZippedCSVs.py
: Packages multiple PVT test outputs into individual CSV files and zips them into a single file.PVT_to_CombinedCSV.py
: Combines multiple PVT test outputs into a single CSV file.
- DSST:
- Scripts for processing DSST test data will follow a similar pattern, focusing on extracting, transforming, and consolidating test results.
- Serial Addition Test:
serialAddition_to_ZippedCSVs.py
: Packages multiple PVT test outputs into individual CSV files and zips them into a single file.serialAddition_to_CombinedCSV.py
: Combines multiple PVT test outputs into a single CSV file.
- Ensure Python 3 and pip are installed on your system. Additionally, the Python libraries Pandas and Streamlit are required.
- Clone the repository:
git clone https://github.com/caddickzac/CognitiveTestsProcessors.git
cd CognitiveTestsProcessors
Install required dependencies:
pip install pandas streamlit
Each of the processing scripts are designed to run within the main Streamlit app. To operate the app navigate to the main directory and run the following command in your command line:
streamlit run CognitiveTestsProcessors.py
Follow the on-screen instructions to upload your text files and download the processed data.
Input files for each cognitive test must be text (.txt) files.