pupil-analysis 0.2.1

Spatial motion analysis program

Pseudopupil Analysis suite

Specialised spatial motion analysis software for Pupil Imsoft data.

In general, can be used for data that follows hierarchy

data_directory
├── specimen_01
│   ├── experiment_01
│   │   ├── image_001.tif
│   │   └── image_002.tif
│   └── ...
└── ...

Installing

There are two supported installation ways at the moment. On Windows, the stand-alone installer is probably the best option unless you are familiar with Python. On other platforms, use pip.

Installer on Windows (easiest)

A Windows installer that bundles together Pseudopupil Analysis suite and all its depencies, including a complete Python runtime, is provided at Releases.

The installer creates a start menu shorcut called Pupil Analysis, which can be used to launch the GUI.

To uninstall, use Add or Remove programs feature in Windows.

Using pip (the python standard way)

The latest version from PyPi can be installed with the command

pip install pupil-analysis

This should install all the required dependencies, except when on Windows, OpenCV may require Visual C++ Runtime 2015 to be installed.

Afterwards, to upgrade an existing installation to the latest version

pip install --upgrade pupil-analysis

In case of regressions, a specific version of the suite (for example 0.1.2) can be installed

pip install pupil-analysis==0.1.2

Finally, to open the GUI from Python

import pupilanalysis.tkgui as gui
gui.run()

or from command line

python -m pupilanalysis.tkgui

How to use

First, open your data directory. Next, select the regions of interest (ROIs) and then run measure movements. The ROIs and movements are saved on disk (C:\Users\USER\PupilAnalysis or /home/USER/.pupilanalysis), so these steps are needed only once per specimen.

After the initial steps you, can perform further analyses in the program or export the data by copy-pasting to your favourite spread sheet or plotting program.

Notes

This is still an early development version (expect rough edges).