aboutsummaryrefslogtreecommitdiff
path: root/docs/user_guide/eye_tracking_context
diff options
context:
space:
mode:
authorThéo de la Hogue2024-09-04 13:56:36 +0200
committerThéo de la Hogue2024-09-04 13:56:36 +0200
commitbe8a44033bd490ea7f4ddb1514a9cc2888affb88 (patch)
tree3274e4157e4618749d70c8cd1788ee3644b0aaca /docs/user_guide/eye_tracking_context
parent08c48347a140becc5e4b60e03f2979305166a079 (diff)
downloadargaze-be8a44033bd490ea7f4ddb1514a9cc2888affb88.zip
argaze-be8a44033bd490ea7f4ddb1514a9cc2888affb88.tar.gz
argaze-be8a44033bd490ea7f4ddb1514a9cc2888affb88.tar.bz2
argaze-be8a44033bd490ea7f4ddb1514a9cc2888affb88.tar.xz
Improving CVS file parsing. Documenting CSV file support.
Diffstat (limited to 'docs/user_guide/eye_tracking_context')
-rw-r--r--docs/user_guide/eye_tracking_context/configuration_and_execution.md1
-rw-r--r--docs/user_guide/eye_tracking_context/context_modules/file.md35
2 files changed, 36 insertions, 0 deletions
diff --git a/docs/user_guide/eye_tracking_context/configuration_and_execution.md b/docs/user_guide/eye_tracking_context/configuration_and_execution.md
index 100ab5e..3deeb57 100644
--- a/docs/user_guide/eye_tracking_context/configuration_and_execution.md
+++ b/docs/user_guide/eye_tracking_context/configuration_and_execution.md
@@ -7,6 +7,7 @@ The [utils.contexts module](../../argaze.md/#argaze.utils.contexts) provides rea
* [Tobii Pro Glasses 3](context_modules/tobii_pro_glasses_3.md) data capture context,
* [Pupil Labs Invisible](context_modules/pupil_labs_invisible.md) data capture context,
* [Pupil Labs Neon](context_modules/pupil_labs_neon.md) data capture context,
+* [File](context_modules/file.md) data playback contexts,
* [OpenCV](context_modules/opencv.md) window cursor position capture and movie playback,
* [Random](context_modules/random.md) gaze position generator.
diff --git a/docs/user_guide/eye_tracking_context/context_modules/file.md b/docs/user_guide/eye_tracking_context/context_modules/file.md
new file mode 100644
index 0000000..8a66b83
--- /dev/null
+++ b/docs/user_guide/eye_tracking_context/context_modules/file.md
@@ -0,0 +1,35 @@
+File
+======
+
+ArGaze provides a ready-made contexts to read data from various file format.
+
+To select a desired context, the JSON samples have to be edited and saved inside an [ArContext configuration](../configuration_and_execution.md) file.
+Notice that the *pipeline* entry is mandatory.
+
+```json
+{
+ JSON sample
+ "pipeline": ...
+}
+```
+
+Read more about [ArContext base class in code reference](../../../argaze.md/#argaze.ArFeatures.ArContext).
+
+## CSV
+
+::: argaze.utils.contexts.File.CSV
+
+### JSON sample
+
+```json
+{
+ "argaze.utils.contexts.File.CSV": {
+ "name": "CSV file data playback",
+ "path": "./src/argaze/utils/demo/gaze_positions.csv",
+ "timestamp_column": "Timestamp (ms)",
+ "x_column": "Gaze Position X (px)",
+ "y_column": "Gaze Position Y (px)",
+ "pipeline": ...
+ }
+}
+```