Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add correct link to eye camera position #699

Merged
merged 2 commits into from
Dec 2, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion core/best-practices/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -70,7 +70,7 @@
**A.** False negatives - Actual fixations are not being detected, e.g. due to maximum dispersion too
low; minimum duration too high
**B.** False positives - Multiple actual fixations including their connecting eye movement
(e.g. saccades) are being detected as a single fixation, e.g. due to maximum dispersion too high

Check warning on line 73 in core/best-practices/index.md

View workflow job for this annotation

GitHub Actions / ✍️ Check spelling

Unknown word (saccades)
**C.** Too many consecutive true positives that could be grouped to a single fixation, e.g. due to
maximum duration too low, or maximum dispersion too low

Expand All @@ -80,7 +80,7 @@
classified fixations.

1. A seated person fixates a static target. Their head is mostly stationary. Only small compensatory
eye rotations are needed to keep the target stabilised on the fovea. Fixations are long.

Check warning on line 83 in core/best-practices/index.md

View workflow job for this annotation

GitHub Actions / ✍️ Check spelling

Unknown word (stabilised)

In this task, setting maximum duration too low could lead to type C errors. If a fixation lasts 400ms,
filtering with a maximum duration of 200ms will classify two fixations instead of one. Ensure the maximum
Expand All @@ -94,7 +94,7 @@
(type B error). Ensure the minimum duration is appropriate for the viewing task.

3. A dynamic environment where a walking person gazes at a sign. Their head is moving considerably when
compared to the previous tasks. Larger compensatory eye rotations are needed to stabilise the region of

Check warning on line 97 in core/best-practices/index.md

View workflow job for this annotation

GitHub Actions / ✍️ Check spelling

Unknown word (stabilise)
interest on the fovea due to cyclic movements of the head and forward progression. The recorded gaze points
are dispersed over a greater area (this is an inherent issue with detecting fixations in scene camera space
instead of the real world).
Expand Down Expand Up @@ -122,7 +122,7 @@
### Pupil Detection and Blinks
It is worth noting that poor pupil detection in general can lead to false negatives. In such instances, adjusting the
thresholds can make it easier to detect blinks, but also increases the chance of false positives. It is worth taking the
time to ensure an optimal setup with regards to [eye camera positioning](/#_3-check-pupil-detection) and
time to ensure an optimal setup with regards to [eye camera positioning](/getting-started/#_3-check-pupil-detection) and
[2d detector settings](/software/pupil-capture/#fine-tuning-pupil-detection) so that the pupils are well-detected
when the eyes are open.

Expand All @@ -147,10 +147,10 @@
### 1. Lab Streaming Layer (LSL)
We maintain a [Plugin for LSL](https://github.com/labstreaminglayer/App-PupilLabs/tree/master/pupil_capture) that
publishes gaze data in real-time using the [LSL framework](https://labstreaminglayer.readthedocs.io/info/intro.html).
This enables unified and time-synchronised collection of measurements with other

Check warning on line 150 in core/best-practices/index.md

View workflow job for this annotation

GitHub Actions / ✍️ Check spelling

Unknown word (synchronised)
[LSL supported devices](https://labstreaminglayer.readthedocs.io/info/supported_devices.html).

The plugin synchronizes Capture's own clock, Pupil Time, with the pylsl.local_clock(). This allows the recording of

Check warning on line 153 in core/best-practices/index.md

View workflow job for this annotation

GitHub Actions / ✍️ Check spelling

Unknown word (pylsl)
native Capture timestamps and removes the necessity of manually synchronizing timestamps after the effect, which makes
for an accurate and easy to implement solution.

Expand All @@ -169,8 +169,8 @@
[This script](https://github.com/pupil-labs/pupil-helpers/blob/master/python/remote_annotations.py) demonstrates how you
can send remote annotations over the network.

## Pupillometry

Check warning on line 172 in core/best-practices/index.md

View workflow job for this annotation

GitHub Actions / ✍️ Check spelling

Unknown word (Pupillometry)
[Pupillometry](https://doi.org/10.1002/wcs.1323) is the study of temporal changes in pupil diameter in response to

Check warning on line 173 in core/best-practices/index.md

View workflow job for this annotation

GitHub Actions / ✍️ Check spelling

Unknown word (Pupillometry)
external light stimuli and/or cognitive processing. Pupil Core reports pupil diameter in mm provided by the
[pye3d](/developer/pye3d/#pye3d-pupil-detection) model: `diameter_3d`, and in pixels as observed in the eye
videos: `diameter`.
Expand Down Expand Up @@ -210,7 +210,7 @@
One solution to prevent 'Model Adjustment Error' is to freeze the model, which is available as a toggle in the eye windows.
You should only freeze the model when it is well-fitting as per the description above. Pupil size errors due to
'Actual Headset Slippage' can only be avoided by eliminating headset slippage, which should be a key aim when performing
pupillometry in general, and especially when freezing the model.

Check warning on line 213 in core/best-practices/index.md

View workflow job for this annotation

GitHub Actions / ✍️ Check spelling

Unknown word (pupillometry)

:::tip
You can also freeze the model when running
Expand Down
13 changes: 13 additions & 0 deletions package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Loading