https://github.com/neuromodulation/perceive
This repository contains MATLAB code to extract data from the Medtronic Percept bidirectional brain computer interface device for adaptive deep brain stimulation.
https://github.com/neuromodulation/perceive
braincomputerinterface deepbrainstimulation percept
Last synced: 5 months ago
JSON representation
This repository contains MATLAB code to extract data from the Medtronic Percept bidirectional brain computer interface device for adaptive deep brain stimulation.
- Host: GitHub
- URL: https://github.com/neuromodulation/perceive
- Owner: neuromodulation
- License: apache-2.0
- Created: 2020-05-02T02:40:18.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2026-01-12T15:59:16.000Z (6 months ago)
- Last Synced: 2026-01-12T21:21:36.673Z (6 months ago)
- Topics: braincomputerinterface, deepbrainstimulation, percept
- Language: MATLAB
- Homepage: http://icneuromodulation.org
- Size: 316 MB
- Stars: 41
- Watchers: 5
- Forks: 22
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Perceive (MATLAB)
TUTORIAL:
addpath C:\code\perceive
perceive
https://github.com/neuromodulation/perceive
v0.2 Contributors Tomas Sieger, Wolf-Julian Neumann, Gerd Tinkhauser
v0.3 Contributor Jojo Vanhoecke
This is an open research tool that is not intended for clinical purposes.
## What's new?
Interactive GUI provides the possibility to convert percept.json files into BIDS-like structures,
including taks, acquistion, run and other handles.
# INPUT
perceive(files, sub, ses, extended)
## files:
All input is optional, you can specify files as cell or character array
(e.g. files = 'Report_Json_Session_Report_20200115T123657.json')
if files isn't specified or remains empty, it will automatically include
all files in the current working directory
if no files in the current working directory are found, a you can choose
files via the MATLAB uigetdir window.
## sub:
SubjectID: you can specify a subject ID for each file in case you want to follow an IRB approved naming scheme for file export
e.g. run perceive('Report_Json_Session_Report_20200115T123657.json',80) -> creates sub-080
e.g. run perceive('Report_Json_Session_Report_20200115T123657.json','080') -> also creates sub-080
e.g. run perceive('Report_Json_Session_Report_20200115T123657.json','Charite001') -> creates sub-Charite001
if unspecified or left empy, the subjectID will be created from
ImplantDate, first letter of disease type and target (e.g. sub-2020110DGpi)
## extended:
'Yes' or ''
If 'Yes': saves all created files in between and in different formats
default: ''
# OUTPUT
The script generates BIDS bids.neuroimaging.io/ inspired subject and session folders with the
ieeg format specifier.
All time series data are being exported as FieldTrip '.mat' files, as these require no additional dependencies for creation.
You can reformat with FieldTrip and SPM to MNE python and other formats (e.g. using fieldtrip2fiff([fullname '.fif'],data))
## Recording type output naming
Each of the FieldTrip data files correspond to a specific aspect of the Recording session:
LMTD = LFP Montage Time Domain - BrainSenseSurvey
IS = Indefinite Streaming - BrainSenseStreaming
CT = Calibration Testing - Calibration Tests
BSL = BrainSense LFP (2 Hz power average + stimulation settings)
BSTD = BrainSense Time Domain (250 Hz raw data corresponding to the BSL file)
## TODO:
ADD BATTERY DRAIN information per sesssion
ADD PATIENT SNAPSHOT EVENT READINGS
ADD CHRONIC DIAGNOSTIC READINGS
ADD Lead DBS Integration for electrode location