Skip to main content

Interface to Tobii eye trackers using Tobii Pro SDK

Project description

Downloads Citation Badge PyPI Latest Release image DOI

Usage instructions for using the Titta class (through its TittaMex and TittaPy interfaces) are found in the Titta documentation.

Working on the source

The enclosed Titta.sln file is to be opened and built with Visual Studio 2022 (last tested with version 17.8.4).

Building the mex files

Run makeTittaMex.m to build the mex file.

32-bit builds are no longer supported on Windows (they have never been on Linux). The last version of Titta/TittaMex supporting 32-bit Matlab is available here.

For building the Linux mex file the default gcc version 11.2.0 included with Ubuntu 22.04 was used. (The mex file currently does not build with gcc 9.3.0 provided in the mingw64 distribution that comes with Octave 6.4.0 on Windows.) For compatibility with an earlier version of Ubuntu, either install the right GLIBCXX version or recompile following the instructions here. See this issue for more information.

Required environment variables

Some environment variables must be set when working on the code or building it from Visual Studio. Here are the values i used (at the time of writing):

  • MATLAB_ROOT: C:\Program Files\MATLAB\R2023b
  • PYTHON_ROOT: C:\Program Files\PsychoPy

Dependencies

readerwriterqueue

readerwriterqueue located at deps/include/readerwriterqueue is required for compiling Titta. Make sure you clone the Titta repository including all submodules so that this dependency is available.

Tobii Pro SDK

To update the Tobii Pro C SDK used to build Titta against, you need to manually put the some files in the right place:

  1. The *.h include files are placed in \SDK_wrapper\deps\include
  2. The Windows Tobii_C_SDK\64\lib\tobii_research.lib link library is placed in \SDK_wrapper\deps\lib.
  3. The *.dll and *.so files are placed in the respective output directories, \SDK_wrapper\TittaMex\64\Windows and \SDK_wrapper\TittaMex\64\Linux, respectively.

PsychoPy and PyBind11

Please note that the code for the Python wrapper is currently not actively maintained and will not build as is now. However, assuming its updated, the following steps will build the code:

  1. Make sure the PsychoPy version you want to work with is installed.
  2. Make sure the PYTHON_ROOT environment variable is set to the location of your PsychoPy installation.
  3. Install PyBind11: in the root folder of your PsychoPy installation, execute python -m pip install pybind11. Alternatively, install pybind11 through a package manager like vcpkg.
  4. As per here, make sure you have the Python Development workload for visual studio installed. Note however that you can unselect the Python 3 installation, the web tools and the miniconda installation that it by default installs, as we will be using the PsychoPy installation's Python environment. Check the "Python native development tools" option.

Set up the Python environment for Visual Studio Python integration

Last, visual studio needs to be able to find your PsychoPy's Python environment. To do so, add a new Python environment, choose existing environment, and point it to the root of your PsychoPy install. In my case, that is C:\Program Files\PsychoPy.

Enabling native debugging

To be able to debug both the Python and C++ side of things with PsychoPy, you must install the debug symbols for the Python installation. This is done through the installer normally, but we don't have an option to do that with PyschoPy. So we have to add them manually. Here's how:

  1. For 64bit Python 3.8.10 (what I am using in the current example), navigate to this download location.
  2. Download all *_d.msi and *_pdb.msi files there (might be overkill, but better have them all).
  3. Open a cmd with admin privileges, navigate to your download location.
  4. Execute for each file a command like: core_d.msi TARGETDIR="C:\Program Files\PsychoPy", where the TARGETDIR is set to the location of your PsychoPy installation.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

TittaPy-1.3.2-cp313-cp313-win_amd64.whl (1.8 MB view details)

Uploaded CPython 3.13 Windows x86-64

TittaPy-1.3.2-cp313-cp313-manylinux_2_28_x86_64.whl (7.5 MB view details)

Uploaded CPython 3.13 manylinux: glibc 2.28+ x86-64

TittaPy-1.3.2-cp313-cp313-macosx_12_0_x86_64.whl (1.8 MB view details)

Uploaded CPython 3.13 macOS 12.0+ x86-64

TittaPy-1.3.2-cp312-cp312-win_amd64.whl (1.8 MB view details)

Uploaded CPython 3.12 Windows x86-64

TittaPy-1.3.2-cp312-cp312-manylinux_2_28_x86_64.whl (7.5 MB view details)

Uploaded CPython 3.12 manylinux: glibc 2.28+ x86-64

TittaPy-1.3.2-cp312-cp312-macosx_12_0_x86_64.whl (1.8 MB view details)

Uploaded CPython 3.12 macOS 12.0+ x86-64

TittaPy-1.3.2-cp311-cp311-win_amd64.whl (1.8 MB view details)

Uploaded CPython 3.11 Windows x86-64

TittaPy-1.3.2-cp311-cp311-manylinux_2_28_x86_64.whl (7.5 MB view details)

Uploaded CPython 3.11 manylinux: glibc 2.28+ x86-64

TittaPy-1.3.2-cp311-cp311-macosx_12_0_x86_64.whl (1.8 MB view details)

Uploaded CPython 3.11 macOS 12.0+ x86-64

TittaPy-1.3.2-cp310-cp310-win_amd64.whl (1.8 MB view details)

Uploaded CPython 3.10 Windows x86-64

TittaPy-1.3.2-cp310-cp310-manylinux_2_28_x86_64.whl (7.5 MB view details)

Uploaded CPython 3.10 manylinux: glibc 2.28+ x86-64

TittaPy-1.3.2-cp310-cp310-macosx_12_0_x86_64.whl (1.8 MB view details)

Uploaded CPython 3.10 macOS 12.0+ x86-64

TittaPy-1.3.2-cp39-cp39-win_amd64.whl (1.7 MB view details)

Uploaded CPython 3.9 Windows x86-64

TittaPy-1.3.2-cp39-cp39-manylinux_2_28_x86_64.whl (7.5 MB view details)

Uploaded CPython 3.9 manylinux: glibc 2.28+ x86-64

TittaPy-1.3.2-cp39-cp39-macosx_12_0_x86_64.whl (1.8 MB view details)

Uploaded CPython 3.9 macOS 12.0+ x86-64

TittaPy-1.3.2-cp38-cp38-win_amd64.whl (1.8 MB view details)

Uploaded CPython 3.8 Windows x86-64

TittaPy-1.3.2-cp38-cp38-manylinux_2_28_x86_64.whl (7.5 MB view details)

Uploaded CPython 3.8 manylinux: glibc 2.28+ x86-64

TittaPy-1.3.2-cp38-cp38-macosx_12_0_x86_64.whl (1.8 MB view details)

Uploaded CPython 3.8 macOS 12.0+ x86-64

File details

Details for the file TittaPy-1.3.2-cp313-cp313-win_amd64.whl.

File metadata

  • Download URL: TittaPy-1.3.2-cp313-cp313-win_amd64.whl
  • Upload date:
  • Size: 1.8 MB
  • Tags: CPython 3.13, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for TittaPy-1.3.2-cp313-cp313-win_amd64.whl
Algorithm Hash digest
SHA256 93038adebc311b1814e1ca210e75061c48d450a43581804479ffe991c6ec0ba3
MD5 7d7d7a621801c502d1dc52676e4e7a4d
BLAKE2b-256 1619462d05cf76d90c0df9a3b5a0db85808ad4ae665eca0185b4c4806d9512dc

See more details on using hashes here.

File details

Details for the file TittaPy-1.3.2-cp313-cp313-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for TittaPy-1.3.2-cp313-cp313-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 6ceeb80b8da6a10e4abda65a524e364392fb05c846a3873edb698e3caaf78841
MD5 b31956fccbd3a4c68694393228149969
BLAKE2b-256 a70c24b2e43022c8dfba43b71490a1870af3da4536d45864e04dad0b5e400d16

See more details on using hashes here.

File details

Details for the file TittaPy-1.3.2-cp313-cp313-macosx_12_0_x86_64.whl.

File metadata

File hashes

Hashes for TittaPy-1.3.2-cp313-cp313-macosx_12_0_x86_64.whl
Algorithm Hash digest
SHA256 37a9a5238253ee6babae38c745f5cf0aabf5a82d730567a5d75f0da0927529d6
MD5 566afeab5756d2ccef5a2681ac269e97
BLAKE2b-256 8295d5f87ac4e6e47cb3e318399ffb58499b8997190dc7cd226755a5f0809498

See more details on using hashes here.

File details

Details for the file TittaPy-1.3.2-cp312-cp312-win_amd64.whl.

File metadata

  • Download URL: TittaPy-1.3.2-cp312-cp312-win_amd64.whl
  • Upload date:
  • Size: 1.8 MB
  • Tags: CPython 3.12, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for TittaPy-1.3.2-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 bd26912b7f93ddb905617b384bd076274584568732c7fd915c117de0d0b4306e
MD5 27fc2aff85db7f89f59df9caaf698a30
BLAKE2b-256 a0b74ce53c484484c55874b027f7773641ba7dd2aaa1a412b20c0fd596387c8b

See more details on using hashes here.

File details

Details for the file TittaPy-1.3.2-cp312-cp312-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for TittaPy-1.3.2-cp312-cp312-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 15a7044f608051157571072b7c321a3c8baa41dd9577169d0b7bc6f185140e3f
MD5 d4d5c4e30970ab4159545ecac6cfa4dd
BLAKE2b-256 2bb6a714069942614a4b50ad175357ebbeffe6e5724b4b4b82855c1d3ed0e6c3

See more details on using hashes here.

File details

Details for the file TittaPy-1.3.2-cp312-cp312-macosx_12_0_x86_64.whl.

File metadata

File hashes

Hashes for TittaPy-1.3.2-cp312-cp312-macosx_12_0_x86_64.whl
Algorithm Hash digest
SHA256 337624d26d5ef55b3823455fc0dcd2f9c0936b981995c79bb28dc17a1672c27e
MD5 9fe4d3f8ef292bb3b3ccc51e0aa483e9
BLAKE2b-256 a68aebe9df9286f081f676208fcb6b3c3052d79e88924af757f8387b45ed05ee

See more details on using hashes here.

File details

Details for the file TittaPy-1.3.2-cp311-cp311-win_amd64.whl.

File metadata

  • Download URL: TittaPy-1.3.2-cp311-cp311-win_amd64.whl
  • Upload date:
  • Size: 1.8 MB
  • Tags: CPython 3.11, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for TittaPy-1.3.2-cp311-cp311-win_amd64.whl
Algorithm Hash digest
SHA256 aad66b22168317aef86122f5f75be2e90ac78fdb35e3cc2469233e8431d165c5
MD5 393bd73f5bce3771589c1a51e66d616d
BLAKE2b-256 7675868f6798cef0cdae19fd7003f005984a9131158e627c8f151453e05324e9

See more details on using hashes here.

File details

Details for the file TittaPy-1.3.2-cp311-cp311-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for TittaPy-1.3.2-cp311-cp311-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 af91deef3934c3ec45c61e445f8364ddc04340c23ceff3a763cf7b4e44b0bf37
MD5 639594159e0e50d4607485e0e7a44ba4
BLAKE2b-256 78cd38599f0404caad4ff8b2fea8a48d6785eb26621cb3601c8e51fb55c50844

See more details on using hashes here.

File details

Details for the file TittaPy-1.3.2-cp311-cp311-macosx_12_0_x86_64.whl.

File metadata

File hashes

Hashes for TittaPy-1.3.2-cp311-cp311-macosx_12_0_x86_64.whl
Algorithm Hash digest
SHA256 a452787efe9a56119280b58b6859ed73559c9db0f726e7387607b82d3ddb3a7e
MD5 e0bf083b875ba8bb1cda595714b7a25c
BLAKE2b-256 cc77440941e175ed44ee42574ab2f31038d49505dd1518b3a776eafd56dee5b7

See more details on using hashes here.

File details

Details for the file TittaPy-1.3.2-cp310-cp310-win_amd64.whl.

File metadata

  • Download URL: TittaPy-1.3.2-cp310-cp310-win_amd64.whl
  • Upload date:
  • Size: 1.8 MB
  • Tags: CPython 3.10, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for TittaPy-1.3.2-cp310-cp310-win_amd64.whl
Algorithm Hash digest
SHA256 43f75dba48905c15faed2951f10f5e68f81f595374036b073a5a033c80c131af
MD5 b78e0534f598266b1bc24d3c8697937f
BLAKE2b-256 c1001015f957ca15a58eed7533d76d33442882846485db3d5c00c0276284a76f

See more details on using hashes here.

File details

Details for the file TittaPy-1.3.2-cp310-cp310-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for TittaPy-1.3.2-cp310-cp310-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 21f6a82c6cfa50441d67da1e759b49b91c604cdad43c3ae7374dbb0ead1a688e
MD5 aaa523f7853d1f6b268754fd4e30ab1d
BLAKE2b-256 7dfaec595ff57730a2dd18f5e8623301854c42364cc0ba7894b5a4849ba8e3d2

See more details on using hashes here.

File details

Details for the file TittaPy-1.3.2-cp310-cp310-macosx_12_0_x86_64.whl.

File metadata

File hashes

Hashes for TittaPy-1.3.2-cp310-cp310-macosx_12_0_x86_64.whl
Algorithm Hash digest
SHA256 2f8bed079ac102fc21489a02d5b6852b4584b0d1d016f4e3af04b016583c188f
MD5 9f797e6d041348faf31bb89276a54212
BLAKE2b-256 2568cf9db8046a83c00b31b664fb9face4a18dd1d870b9a8c115b78cb1afcd03

See more details on using hashes here.

File details

Details for the file TittaPy-1.3.2-cp39-cp39-win_amd64.whl.

File metadata

  • Download URL: TittaPy-1.3.2-cp39-cp39-win_amd64.whl
  • Upload date:
  • Size: 1.7 MB
  • Tags: CPython 3.9, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for TittaPy-1.3.2-cp39-cp39-win_amd64.whl
Algorithm Hash digest
SHA256 cdd30e9836cff36c2caeb54ff5ba2bd898eab89c7a710e51baa459d167c30552
MD5 7baa97b4a38fd97bfe5dffca3ccc0453
BLAKE2b-256 5573d9cd20c73810e3de8fc4c6792d82535dc16876faa23ef734a35b283fd30a

See more details on using hashes here.

File details

Details for the file TittaPy-1.3.2-cp39-cp39-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for TittaPy-1.3.2-cp39-cp39-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 458bfdb55ef52f19a35f848413a0a2a5aa99789d6377316bbeb746c17b2d09d2
MD5 bbf8c9c50a19a0015626335ae652cdb7
BLAKE2b-256 dd9dd737c95e1a1eeecc8678438c7b9baff2c3110a1099e260e74a8199fa67f6

See more details on using hashes here.

File details

Details for the file TittaPy-1.3.2-cp39-cp39-macosx_12_0_x86_64.whl.

File metadata

File hashes

Hashes for TittaPy-1.3.2-cp39-cp39-macosx_12_0_x86_64.whl
Algorithm Hash digest
SHA256 68e0460fee0c378add2563cf3987dd40ed2a3cfe7875c60fb84c5aee1cb283df
MD5 aaccb7f5e08c10396af876104e973ff2
BLAKE2b-256 9abf9eed842a51dfcb339b2ace7fa9cc55455fb5f61fa38caa7135c3ad5a20b4

See more details on using hashes here.

File details

Details for the file TittaPy-1.3.2-cp38-cp38-win_amd64.whl.

File metadata

  • Download URL: TittaPy-1.3.2-cp38-cp38-win_amd64.whl
  • Upload date:
  • Size: 1.8 MB
  • Tags: CPython 3.8, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for TittaPy-1.3.2-cp38-cp38-win_amd64.whl
Algorithm Hash digest
SHA256 f21b9524b71ecaecfa03bf4ca28384b380a8e42d5dceb51323ae03e12df8ba5a
MD5 ff9b1543415b90e8dbf8327a68f01b87
BLAKE2b-256 2c3795e62a9cee45272bfa804035ac633ab28edac1a6876a60bb655d34b1f212

See more details on using hashes here.

File details

Details for the file TittaPy-1.3.2-cp38-cp38-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for TittaPy-1.3.2-cp38-cp38-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 97afca9e080b200832e0e0f0aa7c406e5927f52db071dc1f77cb94b801c77ca9
MD5 34288cd5c5a41653ce82066570073e87
BLAKE2b-256 48ba9bc809a2fa1b48e820e385a7755e5c878135b392f39f960414c84a581da2

See more details on using hashes here.

File details

Details for the file TittaPy-1.3.2-cp38-cp38-macosx_12_0_x86_64.whl.

File metadata

File hashes

Hashes for TittaPy-1.3.2-cp38-cp38-macosx_12_0_x86_64.whl
Algorithm Hash digest
SHA256 ff09f3c8b716927587390c55b87b4c6e4f2e5373718a82130e7ea3d173aa3872
MD5 9cd5d3bab2f886111ec634a73ca0fe93
BLAKE2b-256 c76445de8e3ad075a2e4703979e934e0b775fb88afaf6d3adbe976f6a78b4ff5

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page