Hi all,
* Looking for lots of help, but any advice or words of encouragement would be very appreciated. Would also be willing to discuss over Discord. *
I am looking for help for what currently feels like the impossible. I am an undergrad who has used a BIOPAC fnirs system (fnirs2000 - 18 optodes (2 short), 10 detectors, 4 sources, 16 optodes arranged 8X2 with odd-numbered optodes in the first row.) for my research and I have found that BIOPAC’s software (fNIRSoft) is not up to date with the preprocessing methods and data analysis that are currently being used. Thus, I am looking to convert our raw intensity data, currently stored in excel workbooks, into snirf files so that I can use these wonderful python tools to work with our data up to modern standards. I have taken a look at the following page for how to write snirf files (snirf/snirf_specification.md at master · fNIRS/snirf · GitHub), but an still confused. Up until this point, I have been trying to figure out this conversion on my own, but have not figured it out. Also, I have never used Python before attempting this (only have R experience), so there is that. Please excuse me at times for my lack of terminology and perhaps vague descriptions - any advice would be super helpful!
In the following paragraph, I will describe how our data is currently being stored.
fNIRSoft is capable of exporting data into excel files, tsv, and csv. I exported our data into excel files in which loads of information are stored in large excel workbooks. Each of our participants’ data are stored in separate workbooks (18 workbooks for 18 participants). Each workbook has the following excel sheets:
- Sheets 1-12 contain raw intensity data for each of the 12 conditions participants were exposed to, that is the entire recording was not exported, only blocks containing a baseline + exposure to conditions. Each sheet has 48 columns following this order: (OptodeX-730 | OptodeX-Ambient | OptodeX-850) x 12 optodes.
- Sheets 13-24 store time information (for each of the respective sheets 1-12) about when each sample was taken relative to the beginning of the experiment. This is to say that, there is a chunk of time missing between exposure to condition 1 and 2.
- Sheets 25-36 are duplicates for some reason. Each sheet contains timestamps for when manual markers were made.
- Sheets 37-62 contain some sheets with no information. Others contain information about amount of channels and optodes, current, gain, sampling rate (and it’s Std), total recording time, and recording start time.
- For whatever reason, sheets 37-62 are duplicated for each condition, so there are hundreds of sheets, but really sheets 63+ contain duplicate information.
- The only differences in these sheets across participants are their own measurements and timestamps for manual markers of course. Device settings stayed the same across participants.
- !! What we do not have that I know I should have
- 2d and 3d coordinates for sources and detectors. I have determined the 2d coordinates based on the fact that the distance between sources and each detector are 2.5 cm. As for the 3d coordinates of where the fNIRS device was placed on participants, I do not have that. What I can say though is that the device was placed centered at around the Fpz position.
- !! What information we do not have that I don’t know I should have
- Well…I don’t know. Is there any other details I should have to include regarding fnirs device specs or anything else?
- Cherry on top, I also have behavioral data I would like to eventually attach to these intensity data.
Overall, looking for help identifying what information goes where, what information I am missing and should have, and perhaps how I could automate extracting this information from each workbook ![]()
Currently using the most recent version of MNE and VS code on macOS Tahoe (Version 26.6.2).
Thank you!
Nico