From 7add189d0e3e65a943c989d1a55f2969b18b1c85 Mon Sep 17 00:00:00 2001
From: Remi Gau <remi_gau@hotmail.com>
Date: Sat, 22 Aug 2020 17:35:26 +0200
Subject: [PATCH] update doc

---
 docs/functions_description.md               | 24 +++++++++++++++++++--
 src/randomization/repeatShuffleConditions.m |  2 +-
 2 files changed, 23 insertions(+), 3 deletions(-)

diff --git a/docs/functions_description.md b/docs/functions_description.md
index f6eeda4..a19fb54 100644
--- a/docs/functions_description.md
+++ b/docs/functions_description.md
@@ -10,7 +10,7 @@
 	* 1.6. [eyeTracker](#eyeTracker)
 	* 1.7. [standByScreen](#standByScreen)
 	* 1.8. [waitForTrigger](#waitForTrigger)
-	* 1.9  [readAndFilterLogfile](#readAndFilterLogfile)
+	* 1.9. [readAndFilterLogfile](#readAndFilterLogfile)
 * 2. [Keyboard functions: response collection and aborting experiment](#Keyboardfunctions:responsecollectionandabortingexperiment)
 	* 2.1. [testKeyboards](#testKeyboards)
 	* 2.2. [getResponse](#getResponse)
@@ -19,6 +19,10 @@
 	* 3.1. [drawFixationCross](#drawFixationCross)
 * 4. [Drawing dots](#Drawingdots)
 * 5. [Drawing apertures](#Drawingapertures)
+* 6. [Randomization](#Randomization)
+	* 6.1. [shuffle](#shuffle)
+	* 6.2. [setTargetPositionInSequence](#setTargetPositionInSequence)
+	* 6.3. [repeatShuffleConditions](#repeatShuffleConditions)
 
 <!-- vscode-markdown-toc-config
 	numbering=true
@@ -74,7 +78,7 @@ It shows a basic one-page instruction stored in `cfg.task.instruction` and wait
 Counts a certain number of triggers coming from the mri/scanner before returning.
 Requires number of triggers to wait for.
 
-### 1.9 <a name='readAndFilterLogfile'></a>readAndFilterLogfile
+###  1.9. <a name='readAndFilterLogfile'></a>readAndFilterLogfile
 
 Displays in the command window part of the `*events.tsv` file filterd by an element (e.g. 'trigger'). It can take the last output produced (through `cfg`) or any output BIDS compatible (through file path).
 
@@ -125,3 +129,19 @@ Define the parameters of the fixation cross in `cfg` and `expParameters` and thi
 ##  4. <a name='Drawingdots'></a>Drawing dots
 
 ##  5. <a name='Drawingapertures'></a>Drawing apertures
+
+##  6. <a name='Randomization'></a>Randomization
+
+Functions that can be used to create random stimuli sequences.
+
+###  6.1. <a name='shuffle'></a>shuffle
+
+Is just there to replace the Shuffle function from PTB in case it is not in the path. Can be useful for testing or for continuous integration.
+
+###  6.2. <a name='setTargetPositionInSequence'></a>setTargetPositionInSequence
+
+For a sequence of length `seqLength` where we want to insert `nbTarget` targets, this will return `nbTarget` random position in that sequence and make sure that they are not in consecutive positions.
+
+###  6.3. <a name='repeatShuffleConditions'></a>repeatShuffleConditions
+
+Given `baseConditionVector`, a vector of conditions (coded as numbers), this will create a longer vector made of `nbRepeats` of this base vector and make sure that a given condition is not repeated one after the other.
diff --git a/src/randomization/repeatShuffleConditions.m b/src/randomization/repeatShuffleConditions.m
index aed482e..c4a2ba7 100644
--- a/src/randomization/repeatShuffleConditions.m
+++ b/src/randomization/repeatShuffleConditions.m
@@ -2,7 +2,7 @@
     % shuffledRepeats = repeatShuffleConditions(baseConditionVector, nbRepeats)
     %
     % given baseConditionVector, a vector of conditions (coded as numbers), this will
-    % create a longer vector made of nbRepeats of this base vector and makesure
+    % create a longer vector made of nbRepeats of this base vector and make sure
     % that a given condition is not repeated one after the other
 
     % TODO