physiopy / phys2bids

Python3 library to format physiological files in BIDS. At the moment, it supports Acqknowledge and Labchart. BrainHack participants, check the issues with the BrainHack labels!
https://phys2bids.readthedocs.io
Apache License 2.0
65 stars 45 forks source link

Improve documentation of physio setups #277

Open tsalo opened 4 years ago

tsalo commented 4 years ago

Detailed Description

Currently, there is some information about common setups in the Best Practices page. However, I think it would be very helpful to (1) get more specific about different overall setups and their strengths/weaknesses, (2) reorganize the documentation to distinguish the general setup and modality-specific hardware, and (3) maybe add basic diagrams. Diagrams would be a bit of work, but I think they'd be very helpful for new folks.

Tagging @CesarCaballeroGaudes @smoia @RayStick @sangfrois.

Context / Motivation

When FIU first started working on installing BioPac, none of us knew that you could have a T-splitter to directly send the trigger signal from the scanner to both the task computer and the physio computer, so we ultimately chose to feed the existing trigger signal going to the task computer through to the physio computer via a parallel port and using our task scripts. We only learned recently how that was suboptimal.

The phys2bids site is a great opportunity to provide all of the documentation necessary to at least know what questions new folks should be asking their scanner or physio hardware support teams. Information about costs would also help folks figure out what the best solution is for their facility, based on their current hardware and budget.

Possible Implementation

Not so much an "implementation" as a list of things I think we should cover:

RayStick commented 4 years ago

I think this is a great initiative. It will take time to cover all this, and summarize it well, so I won't promise to do that anytime soon, but I've flagged this as something I can contribute to.