hurxan / biolink

Research logging tool for physiological data

BioLink

BioLink

A tool for synchronized psycho-physiological and behavioural data acquisition.
See the manual »

Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Contributing
5. Contact
6. Acknowledgments

About The Project

BioLink enables the integrated acquisition, synchronization and labelling of stimulus events acquired from observational data using PsychoPy, with data acquired using a Biosginals Kit.
The PLUX Bisognal Kits include devices and software. The devices are referred to as the “PLUX device” throughout this readme.
BioLink bridges a specific gap in the present range of PLUX Biosignals synchronization tools. Harmonized marking and labelling of stimulus events and physiological data is accomplished by synchronizing the timestamps of stimulus events with the physiological data in one timeline.
The raw data is stored unprocessed and can be analysed using any tool that supports the import of .txt files.
BioLink is a pure Python application, providing an easy to use graphical user interface (GTK3 based). It is distributed under LGPLv3 license.
For compatibility with PsychoPy, it is built using Python 2.7 32-Bit edition.

(back to top)

Built With

• Python 2.7
• PyGObject

(back to top)

Getting Started

Important

BioLink has been tested on Windows® 10.

Prerequisites

• Python 2.7
• PIP
• OpenSignals API for Python 2.7 (included inside the project)
• PyGObject

Installation

The following steps show how to set up BioLink on a Windows® platform, using the binary release of BioLink downloadable from github.

1. Clone the repo

   git clone https://github.com/hurxan/BioLink.git

2. Unpack the zip file in the desired installation directory.
3. Install Python 2.7 and PIP:
   • Python 2.7.9
   • PIP
4. Install PyGObject for Python 2.7 (https://sourceforge.net/projects/pygobjectwin32/)
5. Install missing dependencies via PIP
6. Pair PLUX device using its own USB dongle or via Bluetooth:
   • USB dongle connection is immediate and doesn't require any kind of setup.
   • Bluetooth pairing will require a PIN (123).
7. BioLink is started by launching (double-click) the file ‘start.bat’ in the unpacked BioLink directory.

Launching BioLink for the very first time can take up to a few minutes, as all the Python source code will be compiled at first run.

(back to top)

Usage

For more details about the usage of the software, please refer to the BioLink Manual

(back to top)

Contributing

Contributions are highly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

Acknowledgments

• Original Project by BioLinkJ