You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+9-9Lines changed: 9 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -140,7 +140,7 @@ The glassesValidator GUI organizes recordings into a project folder. Each record
140
140
untouched when running glassesValidator. The glassesValidator project folder can furthermore contain a folder specifying the configuration
141
141
of the project. Such a configuration should be made if you used a poster different from the default (if no configuration folder is present,
142
142
the default settings are automatically used), and can be deployed with the `Deploy config` button in the GUI, or the
143
-
[`glassesValidator.config.deploy_validation_config()`](#glassesvalidatorconfig) call from Python.
143
+
[`glassesTools.validation.config.deploy_validation_config()`](#glassesvalidatorconfig) call from Python.
144
144
145
145
When not using the GUIand running glassesValidator using your own scripts, such a project folder organization isnot required. Working folders
146
146
for a recording can be placed anywhere, and a folder for a custom configuration, if used, can also be placed anywhere. The
@@ -156,10 +156,10 @@ During the importing and processing of a recording, a series of files are create
156
156
|`gazeData.tsv`|[`glassesValidator.preprocess`](#glassesvalidatorpreprocess) functions|[`glassesValidator.process.code_marker_interval`](#glassesvalidatorprocess), [`glassesValidator.process.gaze_to_plane`](#glassesvalidatorprocess)|Gaze data cast into the [glassesTools common format](https://github.com/dcnieho/glassesTools/blob/master/README.md#common-data-format) used by glassesValidator.|
157
157
|`frameTimestamps.tsv`|[`glassesValidator.preprocess`](#glassesvalidatorpreprocess) functions|[`glassesValidator.process.code_marker_interval`](#glassesvalidatorprocess), [`glassesValidator.process.detect_markers`](#glassesvalidatorprocess)|Timestamps for each frame in the scene camera video.|
158
158
|`calibration.xml`|[`glassesValidator.preprocess`](#glassesvalidatorpreprocess) functions|[`glassesValidator.process.detect_markers`](#glassesvalidatorprocess), [`glassesValidator.process.gaze_to_plane`](#glassesvalidatorprocess) (optional)|Camera calibration parameters for the scene camera.|
159
-
|`markerInterval.tsv`|[`glassesValidator.process.code_marker_interval`](#glassesvalidatorprocess)|[`glassesValidator.process.detect_markers`](#glassesvalidatorprocess) (optional), [`glassesValidator.process.gaze_to_plane`](#glassesvalidatorprocess) (optional), [`glassesValidator.process.classify_fixations`](#glassesvalidatorprocess), [`glassesValidator.process.assign_fixations`](#glassesvalidatorprocess)|File denoting the validation intervals to be processed. This is produced with the coding interface included with glassesValidator. Can be manually created or edited to override the coded intervals.|
160
-
|`pose.tsv`|[`glassesValidator.process.detect_markers`](#glassesvalidatorprocess)|[`glassesValidator.process.code_marker_interval`](#glassesvalidatorprocess) (optional), [`glassesValidator.process.gaze_to_plane`](#glassesvalidatorprocess), [`glassesValidator.process.classify_fixations`](#glassesvalidatorprocess)|File with information about poster pose w.r.t. the scene camera for each frame where the poster was detected.|
161
-
|`gazePlane.tsv`|[`glassesValidator.process.gaze_to_plane`](#glassesvalidatorprocess)|[`glassesValidator.process.code_marker_interval`](#glassesvalidatorprocess) (optional), [`glassesValidator.process.classify_fixations`](#glassesvalidatorprocess), [`glassesValidator.process.assign_fixations`](#glassesvalidatorprocess)|File with gaze data projected to the poster surface.|
162
-
|`fixations_interval_*.tsv`|[`glassesValidator.process.classify_fixations`](#glassesvalidatorprocess)|[`glassesValidator.process.calculate_data_quality`](#glassesvalidatorprocess)|Files containing the fixations classified for the gaze data projected to the validation plane, using [I2MC](https://link.springer.com/article/10.3758/s13428-016-0822-1).|
159
+
|`markerInterval.tsv`|[`glassesValidator.process.code_marker_interval`](#glassesvalidatorprocess)|[`glassesValidator.process.detect_markers`](#glassesvalidatorprocess) (optional), [`glassesValidator.process.gaze_to_plane`](#glassesvalidatorprocess) (optional), [`glassesValidator.process.classify_fixations`](#glassesvalidatorprocess), [`glassesValidator.process.assign_fixations`](#glassesvalidatorprocess), [`glassesValidator.process.calculate_data_quality`](#glassesvalidatorprocess)|File denoting the validation intervals to be processed. This is produced with the coding interface included with glassesValidator. Can be manually created or edited to override the coded intervals.|
160
+
|`pose.tsv`|[`glassesValidator.process.detect_markers`](#glassesvalidatorprocess)|[`glassesValidator.process.code_marker_interval`](#glassesvalidatorprocess) (optional), [`glassesValidator.process.gaze_to_plane`](#glassesvalidatorprocess)|File with information about poster pose w.r.t. the scene camera for each frame where the poster was detected.|
161
+
|`gazePlane.tsv`|[`glassesValidator.process.gaze_to_plane`](#glassesvalidatorprocess)|[`glassesValidator.process.code_marker_interval`](#glassesvalidatorprocess) (optional), [`glassesValidator.process.classify_fixations`](#glassesvalidatorprocess)|File with gaze data projected to the poster surface.|
162
+
|`fixations_interval_*.tsv`|[`glassesValidator.process.classify_fixations`](#glassesvalidatorprocess)|[`glassesValidator.process.assign_fixations`](#glassesvalidatorprocess), [`glassesValidator.process.calculate_data_quality`](#glassesvalidatorprocess)|Files containing the fixations classified for the gaze data projected to the validation plane, using [I2MC](https://link.springer.com/article/10.3758/s13428-016-0822-1).|
163
163
|`fixationAssignment.tsv`|[`glassesValidator.process.assign_fixations`](#glassesvalidatorprocess)|[`glassesValidator.process.calculate_data_quality`](#glassesvalidatorprocess)|File containing the time interval in the recording for each validation target for which the data quality measures should be calculated. These are determined by a procedure to match fixations to validation targets. Can be manually created or edited to override the episode in the recording used for each validation target.|
164
164
|`fixations_interval_*.png`|[`glassesValidator.process.classify_fixations`](#glassesvalidatorprocess)||Timeseries plot of the detected fixations on the validation plane.|
165
165
|`fixationAssignment_interval_*.png`|[`glassesValidator.process.assign_fixations`](#glassesvalidatorprocess)||x-y plot of the detected fixations on the validation plane and matching of fixations to validation targets.|
@@ -254,7 +254,7 @@ software before they can be imported into glassesValidator. These are:
254
254
## The poster
255
255
The default poster is available 1) [here](https://github.com/dcnieho/glassesValidator/blob/master/src/glassesValidator/config/poster/poster.pdf), 2) from the GUIwith the `Get poster
256
256
pdf` button, and3) can also be acquired from a Python script by calling
The default poster should be printed at A2 size, as defined
259
259
in the pdf file, andis designed to cover a reasonable field of view when participants view it at arms length (i.e., 20 x 17.5 deg
260
260
at 60 cm).
@@ -292,7 +292,7 @@ contains the following settings for the poster:
292
292
|`gridCols`|35.6102|Number of grid columns to draw if`showGrid`is`1`.|
293
293
|`gridRows`|30.3734|Number of grid rows to draw if`showGrid`is`1`.|
294
294
|`showAnnotations`|0|`0`or`1`. If `1`, text annotations informing about the size of grid cells and markers is printed on the poster below the marker arrangement.|
295
-
|`markerBorderBits`|1|Setting for border thickness of ArUco markers. Used by the glassesValidator tool when deploying a configuration and`glassesValidator.config.poster.deploy_marker_images()` function for generating the marker images that are placed on the poster by the [poster generation LaTeX file](https://github.com/dcnieho/glassesValidator/blob/master/src/glassesValidator/config/poster/poster.tex). Also used when detecting ArUco markers during recording processing.|
295
+
|`markerBorderBits`|1|Setting for border thickness of ArUco markers. Used by the glassesValidator tool when deploying a configuration and`glassesTools.validation.config.plane.deploy_marker_images()` function for generating the marker images that are placed on the poster by the [poster generation LaTeX file](https://github.com/dcnieho/glassesValidator/blob/master/src/glassesValidator/config/poster/poster.tex). Also used when detecting ArUco markers during recording processing.|
296
296
297
297
To check your custom configuration, you can generate a poster pdf using [the steps below](#steps-for-making-your-own-poster). Furthermore,
298
298
a png image showing the poster will be generated in the configuration folder when any of glassesValidator's processing steps are run.
@@ -311,10 +311,10 @@ file](/src/glassesValidator/config/validationSetup.txt) that are only used by th
311
311
312
312
### Steps for making your own poster
313
313
1. Deploy the default configuration using the `Deploy config` button in the GUI, or the
314
-
`glassesValidator.config.deploy_validation_config()` call from Python.
314
+
`glassesTools.validation.config.deploy_validation_config()` call from Python.
315
315
2. Edit the `validationSetup.txt` configuration fileand the `markerPositions.csv`and`targetPositions.csv` files in the
316
316
configuration folder to design the layout and look of the poster that you want. NB: if you edit the `markerBorderBits`
317
-
variable, you have to run the `glassesValidator.config.poster.deploy_marker_images()` to regenerate the marker images
317
+
variable, you have to run the `glassesTools.validation.config.plane.deploy_marker_images()` to regenerate the marker images
318
318
contained in the `all-markers` folder with the new border setting.
319
319
3. Compile the `markerBoard/board.tex` LaTeX filewith`pdfTex`, such as provided in the [TeX Live
0 commit comments