Randomization/Examples.md

@@ -197,6 +197,120 @@ If you want to have, e.g., always the same colored repetition next to each other
 | ... |
 
 
+
+# Using ``InOrder`` (potentially for multiple factors)
+``InOrder``
+
+* Color: {🟠, 🔵, 🟢} (``Mixing Order: InOrder``)
+* Number: {1, 2} (``Mixing Order: InOrder``)
+* Letter: {a, b, c} (``Mixing Order: Random``)
+
+<p>
+<details>
+<summary>StudySetup.json</summary>
+
+```
+{
+	"Phases": [
+		{
+			"Name": "Study",
+			"Factors": [
+				{
+					"FactorName": "Map",
+					"Levels": [
+						"/Game/Maps/StudyMap1"
+					],
+					"MixingOrder": "RandomOrder",
+					"Type": "Within",
+					"NonCombined": false,
+					"MapFactor": true
+				},
+				{
+					"FactorName": "TextColor",
+					"Levels": [
+						"Orange",
+						"Blue",
+						"Green"
+					],
+					"MixingOrder": "InOrder",
+					"Type": "Within",
+					"NonCombined": false
+				},
+				{
+					"FactorName": "Number",
+					"Levels": [
+						"1",
+						"2"
+					],
+					"MixingOrder": "InOrder",
+					"Type": "Within",
+					"NonCombined": false
+				},
+				{
+					"FactorName": "Letter",
+					"Levels": [
+						"a",
+						"b",
+						"c"
+					],
+					"MixingOrder": "RandomOrder",
+					"Type": "Within",
+					"NonCombined": false
+				}
+			],
+			"Dependent Variables": [
+				{
+					"Name": "Visibility",
+					"Required": true
+				},
+				{
+					"Name": "OtherData",
+					"Required": false
+				}
+			],
+			"Number Of Repetitions": 1,
+			"TypeOfRepetition": "SameOrder"
+		}
+	],
+	"PhasesToOrderRandomize": [],
+	"FadeConfig":
+	{
+		"StartFadedOut": true,
+		"FadeDuration": 2,
+		"FadeOutDuration": 1,
+		"FadeColor": "(R=0.000000,G=0.000000,B=0.000000,A=1.000000)"
+	},
+	"ExperimenterViewConfig":
+	{
+		"ShowHUD": true,
+		"ShowConditionsPanelByDefault": false,
+		"ShowExperimenterViewInSecondWindow": false,
+		"SecondWindowSizeX": 1920,
+		"SecondWindowSizeY": 1080,
+		"SecondWindowPosX": 1920,
+		"SecondWindowPosY": 0
+	},
+	"UseGazeTracker": "NotTracking"
+}
+```
+</details>
+</p>
+
+| participant # |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| 0 | 🟠 1 a | 🟠 1 b | 🟠 1 c | 🟠 2 a | 🟠 2 c | 🟠 2 b | 🔵 1 c | 🔵 1 a | 🔵 1 b | 🔵 2 c | 🔵 2 b | 🔵 2 a | 🟢 1 b | 🟢 1 c | 🟢 1 a | 🟢 2 b | 🟢 2 a | 🟢 2 c |
+| 1 | 🟠 1 a | 🟠 1 c | 🟠 1 b | 🟠 2 c | 🟠 2 a | 🟠 2 b | 🔵 1 c | 🔵 1 b | 🔵 1 a | 🔵 2 b | 🔵 2 c | 🔵 2 a | 🟢 1 b | 🟢 1 a | 🟢 1 c | 🟢 2 a | 🟢 2 b | 🟢 2 c |
+| 2 | 🟠 1 c | 🟠 1 a | 🟠 1 b | 🟠 2 c | 🟠 2 b | 🟠 2 a | 🔵 1 b | 🔵 1 c | 🔵 1 a | 🔵 2 b | 🔵 2 a | 🔵 2 c | 🟢 1 a | 🟢 1 b | 🟢 1 c | 🟢 2 a | 🟢 2 c | 🟢 2 b |
+| 3 | 🟠 1 c | 🟠 1 b | 🟠 1 a | 🟠 2 b | 🟠 2 c | 🟠 2 a | 🔵 1 b | 🔵 1 a | 🔵 1 c | 🔵 2 a | 🔵 2 b | 🔵 2 c | 🟢 1 a | 🟢 1 c | 🟢 1 b | 🟢 2 c | 🟢 2 a | 🟢 2 b |
+| 4 | 🟠 1 b | 🟠 1 c | 🟠 1 a | 🟠 2 b | 🟠 2 a | 🟠 2 c | 🔵 1 a | 🔵 1 b | 🔵 1 c | 🔵 2 a | 🔵 2 c | 🔵 2 b | 🟢 1 c | 🟢 1 a | 🟢 1 b | 🟢 2 c | 🟢 2 b | 🟢 2 a |
+| 5 | 🟠 1 b | 🟠 1 a | 🟠 1 c | 🟠 2 a | 🟠 2 b | 🟠 2 c | 🔵 1 a | 🔵 1 c | 🔵 1 b | 🔵 2 c | 🔵 2 a | 🔵 2 b | 🟢 1 c | 🟢 1 b | 🟢 1 a | 🟢 2 b | 🟢 2 c | 🟢 2 a |
+| 6 | 🟠 1 a | 🟠 1 b | 🟠 1 c | 🟠 2 a | 🟠 2 c | 🟠 2 b | 🔵 1 c | 🔵 1 a | 🔵 1 b | 🔵 2 c | 🔵 2 b | 🔵 2 a | 🟢 1 b | 🟢 1 c | 🟢 1 a | 🟢 2 b | 🟢 2 a | 🟢 2 c |
+| ... |
+
+Notice that the first ``inOrder`` factor ``Color`` is kept in order for all participants. ``Number``, however, while being kept in order for each level of ``Color``, jumps back and forth over the entire run.
+
+
+
 # Combining ``EnBlock``, ``InOrder`` and ``Random``
 If you want to have, e.g., always the same colored repetition next to each other, you can you ``EnBlock``