This page contains instructions and information about the new eyeris system. To see more about its continuing development in conjunction with DDPI-MK2, see the page DDPI-MK2.
Note that Eyeris is still in development and requires testing and user feedback as of Fall 2020. Expect this page and all linked pages to be continuously updated.
Table of contents:
Contents
Eyeris resources
To best communicate with Fabrizio about eyeris, use the following services. Note that Fabrizio's servers are only available 7am-1am.
Documentation and discussions: https://confluence.santinidesigns.com/
GIT repos: https://bitbucket.santinidesigns.com/
To report bugs and feature requests: https://jira.santinidesigns.com,
- Log in info: username: aplab, pw: Qebgcsft2020!
Fabrizio is also the lab's Slack (specifically the #eyeris channel) for quick questions and clarifications.
Instructions for Experiment Development
Remote Buiding Instructions.pdf
While Eyeris is still in development follow the instructions on https://confluence.santinidesigns.com/display/EYER/APLab%3A+Experiment+Development+Instructions
This page describes how to develop an experiment in EyeRIS version 18.9.2 (updated September 11, 2020) while many features are still missing or currently unstable in EyeRIS. As these features become available, users may revert back to the intended instructions (starting at the page Getting Started). The method described here requires the developer to be on an eyeris-debug machine (i.e. no eye tracking hardware). In this way, experiment development is very similar to old-eyeris.
Attached is a power point that goes through the similarities and differences of EyerisM and new Eyeris EyerisMtoNewEyerisPPT.pptx
To view the eis_data structure that is output from an experiment visit EIS_DATA Structure
Example Experiments
Free Viewing experiment. Shows a fixation marker then a series of images for subject to freely view. https://gitlab.com/jintoy/freeview_eyeris_test
Simple task showing graphics usage. https://gitlab.com/ealicic/new-eyeris-testing/-/tree/master/Experiments/new_task
A full experiment in the old style - Corrugation discrimination experiment (monocular and binocular modes): https://gitlab.com/jintoy/eyeris-corrugationdiscrimination
Automatic Calibration: https://bitbucket.santinidesigns.com/projects/EYER/repos/system_tasks/browse/calibration/automatic_calibration_h2
Computers
Eyeris Machines for development:
- Development machine -- Located in first office (258A)
- -- ID:
TeamViewer: 463 711 580 AnyDesk: neweyerisdebug@ad OR 425267922
- -- PW: Qeb...2020
- -- ID:
- Please reserve time on the Eyeris Machine Scheduling calendar when you want to use or connect to this machine.
Insight and CLion Machines
- Insight and CLion station -- Located in the main lab space hall, closest to coil room
- -- ID:
TeamViewer: 158 973 142 AnyDesk: aplab-insight@ad
- -- PW: Qeb...2020
- -- ID:
Note that you can install and use Insight from any windows machine that is on the campus network or BCS-VPN on the campus network. See https://confluence.santinidesigns.com/display/EYER/Getting+Started for instructions to install Insight and CLion on your own machine.
Eyeris Machines for data collection:
- Binocular ddpi machine -- Located in binocular ddpi room
- Monocular ddpi machine -- Located in monocular ddpi room
EyeRIS Devices
- Sources, Stages, and other peripherals
Analog Acquisition Source (GS16AISS16AO2)
Git repo for GS16AISS16AO2 Source
Photocell
Photocell Usage Guide.pdf January 10, 2022 updates by Janis:
- both the monitor stream source and analog source need to be changed
to activate the i/o box in the command line is aa_start
Known Bug
MAC 12/16/2021
The timings field of each eis_data.analog_data.monitor and eis_data.eye_data are organized differently re: spf and spd. This is a know bug, which isn't a problem as long as those who are analyzing the data understand it.
For sync of the the EEG and monitor and eye data, I am now writing a fair bit of code that takes the timings fields as is, i.e. if this bug gets fixed in the future, my code will break. Please let me know if this changes.
Also, here is a link to confluence where Sam explains some of the timing things in EyeRIS: https://confluence.santinidesigns.com/display/EYER/New+Eyeris+.mat+output+variable+details
Digital Output
Git repo for digital output wrapper
Serial Output
APLab: Common Codes to add to shared libraries and Feature Requests
Created Dec 21, 2021
Common Codes / Shared Libraries
These tasks are common to all or many experiments
- nine-pt-grid
- online filters for stabilization (a la CStabilizer in old eyeris). includes JI's implementation of CStabilizer and SM's implementation of FIR Butterworth
- common graphics: fixation crosses, gabor and grating shaders, apertures ...
Calibration: Consolidation and Requests
The autocalibration and manual calibration should have the following modes as options:
Operational Modes:
- Monocular
- Right eye only (default)
- Left eye only
- Binocular
- Non-Stereo (i.e. each eye views the same nine pt grid)
- Stereo (i.e. each eye has a separate nine pt grid, with the central location of each grid determined by an (x, y) offset)
General Features:
- spacing of grid points determined by visual angles (arcmin) [currently these are determined by pixels]
- offset center of grid, for example, for a peripheral fixation location
- option to use cross solid polygons as fixation markers (default) or a loaded image
- option to show 9-pt grids through aperture [currently only an option in manual and stereo calibration]
- making the default background color 128, 128, 128 (or 127,127,127)