From 7ffac7246ee86ad6ee6972f8a6aae0d7795fe64a Mon Sep 17 00:00:00 2001
From: Taylor Salo <tsalo006@fiu.edu>
Date: Sun, 2 Aug 2020 11:59:10 -0400
Subject: [PATCH 1/5] Add run entity for beh data.

---
 .../07-behavioral-experiments.md                 | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/src/04-modality-specific-files/07-behavioral-experiments.md b/src/04-modality-specific-files/07-behavioral-experiments.md
index 71a7d941eb..2826e2bf0e 100644
--- a/src/04-modality-specific-files/07-behavioral-experiments.md
+++ b/src/04-modality-specific-files/07-behavioral-experiments.md
@@ -5,14 +5,14 @@ Template:
 ```Text
 sub-<label>/[ses-<label>/]
     beh/
-        sub-<label>[_ses-<label>]_task-<label>_events.tsv
-        sub-<label>[_ses-<label>]_task-<label>_events.json
-        sub-<label>[_ses-<label>]_task-<label>_beh.tsv
-        sub-<label>[_ses-<label>]_task-<label>_beh.json
-        sub-<label>[_ses-<label>]_task-<label>_physio.tsv.gz
-        sub-<label>[_ses-<label>]_task-<label>_physio.json
-        sub-<label>[_ses-<label>]_task-<label>_stim.tsv.gz
-        sub-<label>[_ses-<label>]_task-<label>_stim.json
+        sub-<label>[_ses-<label>]_task-<label>[_run-<index>]_events.tsv
+        sub-<label>[_ses-<label>]_task-<label>[_run-<index>]_events.json
+        sub-<label>[_ses-<label>]_task-<label>[_run-<index>]_beh.tsv
+        sub-<label>[_ses-<label>]_task-<label>[_run-<index>]_beh.json
+        sub-<label>[_ses-<label>]_task-<label>[_run-<index>]_physio.tsv.gz
+        sub-<label>[_ses-<label>]_task-<label>[_run-<index>]_physio.json
+        sub-<label>[_ses-<label>]_task-<label>[_run-<index>]_stim.tsv.gz
+        sub-<label>[_ses-<label>]_task-<label>[_run-<index>]_stim.json
 ```
 
 In addition to logs from behavioral experiments performed alongside imaging data

From 6e7cd76fce1431c19c7eee890baa09a9b4082b1c Mon Sep 17 00:00:00 2001
From: Taylor Salo <tsalo006@fiu.edu>
Date: Sun, 2 Aug 2020 11:59:20 -0400
Subject: [PATCH 2/5] Update entity table for beh data.

---
 src/99-appendices/04-entity-table.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/99-appendices/04-entity-table.md b/src/99-appendices/04-entity-table.md
index 5a36dd9059..8dbe0711f7 100644
--- a/src/99-appendices/04-entity-table.md
+++ b/src/99-appendices/04-entity-table.md
@@ -20,13 +20,13 @@ A general introduction to entities is given in the section on
 | dwi<br>(dwi bvec bval)                                                                         | REQUIRED      | OPTIONAL      |                | OPTIONAL      |                          |                | OPTIONAL                 | OPTIONAL      |                        |                |                     |                       |                 |                 |
 | fmap<br>(phasediff phase1 phase2 magnitude1 magnitude2 magnitude fieldmap)                     | REQUIRED      | OPTIONAL      |                | OPTIONAL      |                          |                |                          | OPTIONAL      |                        |                |                     |                       |                 |                 |
 | fmap<br>(epi)                                                                                  | REQUIRED      | OPTIONAL      |                | OPTIONAL      | OPTIONAL                 |                | REQUIRED                 | OPTIONAL      |                        |                |                     |                       |                 |                 |
-| beh<br>(events stim physio)                                                                    | REQUIRED      | OPTIONAL      | REQUIRED       |               |                          |                |                          |               |                        |                |                     |                       |                 |                 |
+| beh<br>(events stim physio)                                                                    | REQUIRED      | OPTIONAL      | REQUIRED       |               |                          |                |                          | OPTIONAL      |                        |                |                     |                       |                 |                 |
 | meg<br>                                                                                        | REQUIRED      | OPTIONAL      | REQUIRED       | OPTIONAL      |                          |                |                          | OPTIONAL      |                        |                |                     | OPTIONAL              |                 | OPTIONAL        |
 | eeg<br>                                                                                        | REQUIRED      | OPTIONAL      | REQUIRED       | OPTIONAL      |                          |                |                          | OPTIONAL      |                        |                |                     |                       |                 |                 |
 | ieeg<br>                                                                                       | REQUIRED      | OPTIONAL      | REQUIRED       | OPTIONAL      |                          |                |                          | OPTIONAL      |                        |                |                     |                       |                 |                 |
 | channels<br>(meg/eeg/ieeg)                                                                     | REQUIRED      | OPTIONAL      | REQUIRED       |               |                          |                |                          | OPTIONAL      |                        |                |                     |                       |                 |                 |
 | headshape<br>(meg)                                                                             | REQUIRED      | OPTIONAL      |                | OPTIONAL      |                          |                |                          |               |                        |                |                     |                       | OPTIONAL        |                 |
 | markers<br>(meg)                                                                               | REQUIRED      | OPTIONAL      | OPTIONAL       | OPTIONAL      |                          |                |                          |               |                        |                |                     |                       | OPTIONAL        |                 |
-| photo<br>(meg/eeg/ieeg)                                                                        | REQUIRED      | OPTIONAL      |                | OPTIONAL      |                          |                |                          |               |                        |                |                     |                       |                 |                 |        
+| photo<br>(meg/eeg/ieeg)                                                                        | REQUIRED      | OPTIONAL      |                | OPTIONAL      |                          |                |                          |               |                        |                |                     |                       |                 |                 |
 | electrodes<br>(eeg/ieeg)                                                                       | REQUIRED      | OPTIONAL      |                | OPTIONAL      |                          |                |                          |               |                        |                |                     |                       | OPTIONAL        |                 |
-| events<br>(meg/eeg/ieeg)                                                                       | REQUIRED      | OPTIONAL      | REQUIRED       |               |                          |                |                          | OPTIONAL      |                        |                |                     |                       |                 |                 |        
+| events<br>(meg/eeg/ieeg)                                                                       | REQUIRED      | OPTIONAL      | REQUIRED       |               |                          |                |                          | OPTIONAL      |                        |                |                     |                       |                 |                 |

From aec72a06fc4f7fa40d050e60c9a62ad2c0bb1d59 Mon Sep 17 00:00:00 2001
From: Taylor Salo <tsalo006@fiu.edu>
Date: Tue, 4 Aug 2020 14:22:59 -0400
Subject: [PATCH 3/5] Support acq and recording in behavioral-only data.

---
 .../07-behavioral-experiments.md                 | 16 ++++++++--------
 src/99-appendices/04-entity-table.md             |  3 ++-
 2 files changed, 10 insertions(+), 9 deletions(-)

diff --git a/src/04-modality-specific-files/07-behavioral-experiments.md b/src/04-modality-specific-files/07-behavioral-experiments.md
index 2826e2bf0e..da3d1a50bf 100644
--- a/src/04-modality-specific-files/07-behavioral-experiments.md
+++ b/src/04-modality-specific-files/07-behavioral-experiments.md
@@ -5,14 +5,14 @@ Template:
 ```Text
 sub-<label>/[ses-<label>/]
     beh/
-        sub-<label>[_ses-<label>]_task-<label>[_run-<index>]_events.tsv
-        sub-<label>[_ses-<label>]_task-<label>[_run-<index>]_events.json
-        sub-<label>[_ses-<label>]_task-<label>[_run-<index>]_beh.tsv
-        sub-<label>[_ses-<label>]_task-<label>[_run-<index>]_beh.json
-        sub-<label>[_ses-<label>]_task-<label>[_run-<index>]_physio.tsv.gz
-        sub-<label>[_ses-<label>]_task-<label>[_run-<index>]_physio.json
-        sub-<label>[_ses-<label>]_task-<label>[_run-<index>]_stim.tsv.gz
-        sub-<label>[_ses-<label>]_task-<label>[_run-<index>]_stim.json
+        sub-<label>[_ses-<label>]_task-<label>[_acq-<label>][_run-<index>]_events.tsv
+        sub-<label>[_ses-<label>]_task-<label>[_acq-<label>][_run-<index>]_events.json
+        sub-<label>[_ses-<label>]_task-<label>[_acq-<label>][_run-<index>]_beh.tsv
+        sub-<label>[_ses-<label>]_task-<label>[_acq-<label>][_run-<index>]_beh.json
+        sub-<label>[_ses-<label>]_task-<label>[_acq-<label>][_run-<index>][_recording-<label>]_physio.tsv.gz
+        sub-<label>[_ses-<label>]_task-<label>[_acq-<label>][_run-<index>][_recording-<label>]_physio.json
+        sub-<label>[_ses-<label>]_task-<label>[_acq-<label>][_run-<index>][_recording-<label>]_stim.tsv.gz
+        sub-<label>[_ses-<label>]_task-<label>[_acq-<label>][_run-<index>][_recording-<label>]_stim.json
 ```
 
 In addition to logs from behavioral experiments performed alongside imaging data
diff --git a/src/99-appendices/04-entity-table.md b/src/99-appendices/04-entity-table.md
index 8dbe0711f7..45db2479bb 100644
--- a/src/99-appendices/04-entity-table.md
+++ b/src/99-appendices/04-entity-table.md
@@ -20,7 +20,8 @@ A general introduction to entities is given in the section on
 | dwi<br>(dwi bvec bval)                                                                         | REQUIRED      | OPTIONAL      |                | OPTIONAL      |                          |                | OPTIONAL                 | OPTIONAL      |                        |                |                     |                       |                 |                 |
 | fmap<br>(phasediff phase1 phase2 magnitude1 magnitude2 magnitude fieldmap)                     | REQUIRED      | OPTIONAL      |                | OPTIONAL      |                          |                |                          | OPTIONAL      |                        |                |                     |                       |                 |                 |
 | fmap<br>(epi)                                                                                  | REQUIRED      | OPTIONAL      |                | OPTIONAL      | OPTIONAL                 |                | REQUIRED                 | OPTIONAL      |                        |                |                     |                       |                 |                 |
-| beh<br>(events stim physio)                                                                    | REQUIRED      | OPTIONAL      | REQUIRED       |               |                          |                |                          | OPTIONAL      |                        |                |                     |                       |                 |                 |
+| beh<br>(events)                                                                                | REQUIRED      | OPTIONAL      | REQUIRED       | OPTIONAL      |                          |                |                          | OPTIONAL      |                        |                |                     |                       |                 |                 |
+| beh<br>(stim physio)                                                                           | REQUIRED      | OPTIONAL      | REQUIRED       | OPTIONAL      |                          |                |                          | OPTIONAL      |                        |                | OPTIONAL            |                       |                 |                 |
 | meg<br>                                                                                        | REQUIRED      | OPTIONAL      | REQUIRED       | OPTIONAL      |                          |                |                          | OPTIONAL      |                        |                |                     | OPTIONAL              |                 | OPTIONAL        |
 | eeg<br>                                                                                        | REQUIRED      | OPTIONAL      | REQUIRED       | OPTIONAL      |                          |                |                          | OPTIONAL      |                        |                |                     |                       |                 |                 |
 | ieeg<br>                                                                                       | REQUIRED      | OPTIONAL      | REQUIRED       | OPTIONAL      |                          |                |                          | OPTIONAL      |                        |                |                     |                       |                 |                 |

From d92b97296a54f0fb35db04daf4ea87836f7f2353 Mon Sep 17 00:00:00 2001
From: Taylor Salo <tsalo006@fiu.edu>
Date: Tue, 4 Aug 2020 14:23:15 -0400
Subject: [PATCH 4/5] Add beh suffix under beh datatype.

---
 src/99-appendices/04-entity-table.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/99-appendices/04-entity-table.md b/src/99-appendices/04-entity-table.md
index 45db2479bb..e460e28488 100644
--- a/src/99-appendices/04-entity-table.md
+++ b/src/99-appendices/04-entity-table.md
@@ -20,7 +20,7 @@ A general introduction to entities is given in the section on
 | dwi<br>(dwi bvec bval)                                                                         | REQUIRED      | OPTIONAL      |                | OPTIONAL      |                          |                | OPTIONAL                 | OPTIONAL      |                        |                |                     |                       |                 |                 |
 | fmap<br>(phasediff phase1 phase2 magnitude1 magnitude2 magnitude fieldmap)                     | REQUIRED      | OPTIONAL      |                | OPTIONAL      |                          |                |                          | OPTIONAL      |                        |                |                     |                       |                 |                 |
 | fmap<br>(epi)                                                                                  | REQUIRED      | OPTIONAL      |                | OPTIONAL      | OPTIONAL                 |                | REQUIRED                 | OPTIONAL      |                        |                |                     |                       |                 |                 |
-| beh<br>(events)                                                                                | REQUIRED      | OPTIONAL      | REQUIRED       | OPTIONAL      |                          |                |                          | OPTIONAL      |                        |                |                     |                       |                 |                 |
+| beh<br>(beh events)                                                                            | REQUIRED      | OPTIONAL      | REQUIRED       | OPTIONAL      |                          |                |                          | OPTIONAL      |                        |                |                     |                       |                 |                 |
 | beh<br>(stim physio)                                                                           | REQUIRED      | OPTIONAL      | REQUIRED       | OPTIONAL      |                          |                |                          | OPTIONAL      |                        |                | OPTIONAL            |                       |                 |                 |
 | meg<br>                                                                                        | REQUIRED      | OPTIONAL      | REQUIRED       | OPTIONAL      |                          |                |                          | OPTIONAL      |                        |                |                     | OPTIONAL              |                 | OPTIONAL        |
 | eeg<br>                                                                                        | REQUIRED      | OPTIONAL      | REQUIRED       | OPTIONAL      |                          |                |                          | OPTIONAL      |                        |                |                     |                       |                 |                 |

From 910cf7e00760f6b089ef5603a12eddbdfeb37fc9 Mon Sep 17 00:00:00 2001
From: Taylor Salo <tsalo006@fiu.edu>
Date: Wed, 5 Aug 2020 12:26:01 -0400
Subject: [PATCH 5/5] Describe acq entity for behavioral data.

---
 src/04-modality-specific-files/07-behavioral-experiments.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/src/04-modality-specific-files/07-behavioral-experiments.md b/src/04-modality-specific-files/07-behavioral-experiments.md
index da3d1a50bf..0f2435ac53 100644
--- a/src/04-modality-specific-files/07-behavioral-experiments.md
+++ b/src/04-modality-specific-files/07-behavioral-experiments.md
@@ -26,3 +26,9 @@ as for tasks performed during MRI, electrophysiological or other neural recordin
 Additionally, events files that do not include the mandatory `onset` and
 `duration` columns can still be included, but should be labeled `_beh.tsv`
 rather than `_events.tsv`.
+
+The OPTIONAL `acq-<label>` key/value pair corresponds to a custom label to
+distinguish different conditions present during multiple runs of the same task.
+For example, if a study includes runs of an n-back task, with deep brain
+stimulation turned on or off, the data files may be labelled
+`sub-01_task-nback_acq-dbson_beh.tsv` and `sub-01_task-nback_acq-dbsoff_beh.tsv`.