From 63ef5c8e5b6acb7a3701ac835b91d21ec7648542 Mon Sep 17 00:00:00 2001
From: Chris Markiewicz <effigies@gmail.com>
Date: Thu, 22 Aug 2024 12:34:29 -0400
Subject: [PATCH] [ENH] Provide baseline definition for behavioral files

---
 src/modality-specific-files/behavioral-experiments.md | 10 ++++++++++
 src/schema/rules/tabular_data/task.yaml               | 10 ++++++++++
 2 files changed, 20 insertions(+)

diff --git a/src/modality-specific-files/behavioral-experiments.md b/src/modality-specific-files/behavioral-experiments.md
index b27592cad4..70fa5ae3a6 100644
--- a/src/modality-specific-files/behavioral-experiments.md
+++ b/src/modality-specific-files/behavioral-experiments.md
@@ -30,6 +30,16 @@ that do not include the mandatory `onset` and `duration` columns
 MAY be included,
 but MUST be labeled `_beh.tsv` rather than `_events.tsv`.
 
+The following OPTIONAL columns are pre-defined for behavioral data files:
+
+<!-- This block generates a columns table.
+The definitions of these fields can be found in
+  src/schema/rules/tabular_data/*.yaml
+and a guide for using macros can be found at
+ https://github.com/bids-standard/bids-specification/blob/master/macros_doc.md
+-->
+{{ MACROS___make_columns_table("task.Behavioral") }}
+
 ## Sidecar JSON (`*_beh.json`)
 
 In addition to the metadata that is either:
diff --git a/src/schema/rules/tabular_data/task.yaml b/src/schema/rules/tabular_data/task.yaml
index 0ca01afe25..282f063112 100644
--- a/src/schema/rules/tabular_data/task.yaml
+++ b/src/schema/rules/tabular_data/task.yaml
@@ -19,3 +19,13 @@ TaskEvents:
   initial_columns:
     - onset
     - duration
+
+Behavioral:
+  selectors:
+    - suffix == "beh"
+  columns:
+    trial_type: optional
+    response_time: optional
+    HED: optional
+    stim_file: optional
+  additional_columns: allowed