Recent changes to wiki

Home modified by Divya Pathak

Divya Pathak — Wed, 21 Oct 2026 18:50:38 -0000

--- v10
+++ v11
@@ -3,8 +3,7 @@

 **Welcome to the GCATS wiki!** 

-GCATS (Gamepad-based Continuous Affect Tracing System) captures self-reported affective ratings on a dual-axis valence-arousal grid using a
-gamepad thumbstick.
+GCATS (Gamepad-based Continuous Affect Tracing System) captures self-reported affective ratings on a dual-axis valence-arousal grid using a gamepad thumbstick.

 The application supports:

 - Continuous ratings during image, video, and audio stimuli.

Data Output modified by Divya Pathak

Divya Pathak — Wed, 21 Oct 2026 18:49:37 -0000

--- v1
+++ v2
@@ -1,9 +1,17 @@
+
+
+
+
+
+
+
 Each session writes three files in `data/`:


-    :::text
-    <participant>_S<session>_<timestamp>_raw.csv
-    <participant>_S<session>_<timestamp>_continuous.csv
-    <participant>_S<session>_<timestamp>_config.json
+```text
+<participant>_S<session>_<timestamp>_raw.csv
+<participant>_S<session>_<timestamp>_continuous.csv
+<participant>_S<session>_<timestamp>_config.json
+```

 ## CSV files

</timestamp></session></participant></timestamp></session></participant></timestamp></session></participant></timestamp></session></participant></timestamp></session></participant></timestamp></session></participant>

Media and Display modified by Divya Pathak

Divya Pathak — Wed, 21 Oct 2026 18:49:01 -0000

--- v2
+++ v3
@@ -1,22 +1,37 @@
-Images, videos, and audio files can be mixed in one session.
+## Images, videos, and audio files can be mixed in one session.

 ### Images

 Images are displayed for the configured image duration. With `original`, the
 image keeps its native aspect ratio and is scaled down only when necessary.

+
+
+
 ### Videos

 Videos are decoded by `ffpyplayer`. Embedded audio is played with the video,
 and frames are paced using their presentation timestamps.
+
+
+

 ### Audio

 Audio-only stimuli play through `ffpyplayer`. The upper area of the screen
 contains the affect grid; a progress bar appears below it.

+
+
+
 ## Media rectangle

 The selected aspect ratio is fitted inside the configured inner margins. The
 rating overlay is centered on the resulting media rectangle rather than on the
-full screen. The summary phase retains the same rectangle and margins.
+full screen. 
+
+
+
+The summary phase retains the same rectangle and margins.
+
+

Configuration modified by Divya Pathak

Divya Pathak — Wed, 21 Oct 2026 18:48:22 -0000

Home modified by Divya Pathak

Divya Pathak — Wed, 21 Oct 2026 18:46:54 -0000

--- v9
+++ v10
@@ -1,11 +1,12 @@
-**Welcome to the GCATS wiki!**
+

-**GCATS (Gamepad-based Continuous Affect Tracing System)** captures
-self-reported affective ratings on a dual-axis valence-arousal grid using a
+
+**Welcome to the GCATS wiki!** 
+
+GCATS (Gamepad-based Continuous Affect Tracing System) captures self-reported affective ratings on a dual-axis valence-arousal grid using a
 gamepad thumbstick.

 The application supports:
-

 - Continuous ratings during image, video, and audio stimuli.
 - Optional summary ratings before or after each stimulus; even has options for collecting only Summary Ratings.
 - Mixed media rating in one session.

Running a Session modified by Divya Pathak

Divya Pathak — Wed, 21 Oct 2026 18:44:32 -0000

--- v1
+++ v2
@@ -1,18 +1,28 @@
-Complete the setup pages in order:
+Complete the setup pages in the following order:


 1. **Startup** — verify packages and connect the gamepad.
-2. **Participant** — enter participant and session details.
-3. **Stimuli** — choose one file or a folder and set display options.
-4. **Protocol** — choose gaps, rating mode, and summary timing.
-5. **Configuration** — set the rating scale, sampling, appearance, and labels.
-6. **Controls** — select the thumbstick and confirmation button.
-7. **Dead-zone** — measure resting stick position and jitter.
-8. **Check** — verify stick direction and cursor movement.

-The session then runs fullscreen. Press **Escape** to stop early; data already
-written by the logger is retained.
+

-## Rating modes
+2. **Participant** — enter the Rater's details. We shall be calling the raters as Participants from now on. Fields include participant ID, session details, Age (optional) and Gender. 
+
+
+
+
+
+
+ 
+
+3. **Stimuli** — choose the Stimuli that needs to be rated. Options include either one file or a folder. The software will automatically read the type (video, audio or images) and display the media length beside. Post this loading of stimuli, experimentors can choose the display settings from a preset menu in each field. _Presentation Order_ is the sequence in which you need the stimuli to be displayed, options include `random` and `sequential`. _Image Duration_ is only relevant for image type stimuli, this field is editable as text or use the arrows to increase or decrease the values. _Media Aspect Ratio_ choose between the avaiable aspect ratios which are calculated after the _Inner Margins_ are substracted from the full screen dimensions. So the software reads the full screen dimensions and after that equally substracts the inner margins and then in the chosen aspect ratio, draws the media rendering box. This box is where the stimuli will play. 
+
+
+
+
+
+
+ 
+
+4. **Protocol** — choose `Between Stimuli`, options include fixation cross and blank screen.  `Inter Stimulus Interval duration` (in case of a single stimuli, it governs the starting and end values), `Rating Mode`, and `Summary Rating Timing` which asks whether you want the summary rating to happen before the continuous rating or after the continuous rating.


 - **Continuous** records the changing rating during stimulus playback.
 - **Summary** records one confirmed rating.
@@ -20,3 +30,38 @@

 Summary ratings can be collected before or after the stimulus. The summary
 question can be customized in Configuration.
+
+
+
+5. **Configuration** — all the Fields in Configuration page have explanations below the fields. Please set the values accordingly. Irrespective of the gamepad scaling values that are chosen, the raw co-ordinates are also stored in a seperate file so that rescaling is possible later.
+
+
+
+
+
+
+
+
+
+
+ 

+
+6. **Controls** — select the thumbstick and confirmation button.
+
+
+
+7. **Dead-zone** — measure the resting stick position and jitter.
+
+
+
+
+
+
+
+ 
+
+8. **Check** — verify stick direction and cursor movement.
+
+
+
+The session then runs fullscreen. Press **Escape** to stop early; data already written by the logger is retained even for incomplete sessions.

Installation and Launch modified by Divya Pathak

Divya Pathak — Wed, 21 Oct 2026 18:43:26 -0000

--- v2
+++ v3
@@ -1,25 +1,35 @@
-## Requirements
+## Install and Run from the Source Code
+
+1. Install all the required packages for running the app 
+```bash
+pip install -r requirements.txt
+```
+2. Start the Application from the folder
+
+```bash
+python run_gcats.py
+```
+or
+
+```bash
+python -m gcats
+```
+### Requirements


 - Python 3.10 or newer.
 - A connected gamepad.
 - FFmpeg's `ffprobe` is optional and is used only to show media lengths.

-## Install
+## Windows Installer

-From the project folder:
+Please us [this link](https://gcats.sourceforge.io/) to download the latest release of the software that includes `GCATS-setup.exe`. Download and double click on it to Install the GCATS app.


-    :::bash
-    pip install -r requirements.txt
+

-## Start
+After successfull installation, Launch the Application and it displays a splash screen that laods the app. 


-    :::bash
-    python run_gcats.py
+

-The alternative module entry point is:
+On Startup page, the applications checks dependencies, and waits for a gamepad before showing the setup pages.


-    :::bash
-    python -m gcats
-
-The application displays a splash screen, checks dependencies, and waits for
-a gamepad before showing the setup pages.
+

Home modified by Divya Pathak

Divya Pathak — Wed, 21 Oct 2026 18:41:39 -0000

--- v8
+++ v9
@@ -11,3 +11,14 @@

 - Mixed media rating in one session.
 - Raw and resampled gamepad data polling and saving.
 - Portable configuration presets.
+
+## Wiki Pages! 
+
+- [Installation and Launch]
+- [Running a Session]
+- [Configuration]
+- [Media and Display]
+- [Data Output]
+- [Troubleshooting]
+- [Architecture]
+- [Contributing]

Home modified by Divya Pathak

Divya Pathak — Wed, 21 Oct 2026 18:39:43 -0000

Home modified by Divya Pathak

Divya Pathak — Wed, 21 Oct 2026 18:39:25 -0000