Skip to content

Commit 0dff8f7

Browse files
committed
some more readme fixes
1 parent d18260c commit 0dff8f7

File tree

1 file changed

+9
-9
lines changed

1 file changed

+9
-9
lines changed

README.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -140,7 +140,7 @@ The glassesValidator GUI organizes recordings into a project folder. Each record
140140
untouched when running glassesValidator. The glassesValidator project folder can furthermore contain a folder specifying the configuration
141141
of the project. Such a configuration should be made if you used a poster different from the default (if no configuration folder is present,
142142
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.
144144
145145
When not using the GUI and running glassesValidator using your own scripts, such a project folder organization is not required. Working folders
146146
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
156156
|`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.|
157157
|`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.|
158158
|`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).|
163163
|`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.|
164164
|`fixations_interval_*.png`|[`glassesValidator.process.classify_fixations`](#glassesvalidatorprocess)||Timeseries plot of the detected fixations on the validation plane.|
165165
|`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:
254254
## The poster
255255
The default poster is available 1) [here](https://github.com/dcnieho/glassesValidator/blob/master/src/glassesValidator/config/poster/poster.pdf), 2) from the GUI with the `Get poster
256256
pdf` button, and 3) can also be acquired from a Python script by calling
257-
`glassesValidator.config.poster.deploy_default_pdf()`.
257+
`glassesTools.validation.config.plane.deploy_default_pdf()`.
258258
The default poster should be printed at A2 size, as defined
259259
in the pdf file, and is designed to cover a reasonable field of view when participants view it at arms length (i.e., 20 x 17.5 deg
260260
at 60 cm).
@@ -292,7 +292,7 @@ contains the following settings for the poster:
292292
|`gridCols`|35.6102|Number of grid columns to draw if `showGrid` is `1`.|
293293
|`gridRows`|30.3734|Number of grid rows to draw if `showGrid` is `1`.|
294294
|`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.|
296296
297297
To check your custom configuration, you can generate a poster pdf using [the steps below](#steps-for-making-your-own-poster). Furthermore,
298298
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
311311
312312
### Steps for making your own poster
313313
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.
315315
2. Edit the `validationSetup.txt` configuration file and the `markerPositions.csv` and `targetPositions.csv` files in the
316316
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
318318
contained in the `all-markers` folder with the new border setting.
319319
3. Compile the `markerBoard/board.tex` LaTeX file with `pdfTex`, such as provided in the [TeX Live
320320
distribution](https://www.tug.org/texlive/).

0 commit comments

Comments
 (0)