BrainVoyager Support

documentation overview

  • Increase font size
  • Default font size
  • Decrease font size

AutoIT - Automated GCM

Developed by Jasper van den Bosch

Rationale


The Granger Causality Mapping plugin for BrainVoyagerQX is controlled by a series of dialogs. Interacting with these dialogs may become somewhat repetitious when you want to compute a full design of maps for your experiment; i.e. a map for each volume-of-interest in your .voi file, each condition in your protocol files, and each functional run (as collected in a .mdm file). This automation tool written in the Windows scripting language AutoIT automates this interaction for you. 

Usage


In the .zip archive downloadable below you will find a manual, an executable (autoGCM.exe) and source files (*.au3). Users not familiar with autoIT should simply run the executable.

1. The script asks for a folder which should contain:

  • one or more MDM files (for the VTCs to use, design matrix files ignored). A separate map will be created for each .mdm file.
  • a VMR (to be able to start the plugin)
  • a VOI file (all of the containing VOI definitions will be used as seed regions).

2. The VTCs specified in the MDMs should have valid, linked PRT files! These will be used for the interval selection/condition specification. For now the script expects a fully symmetric design, i.e. each condition should appear in each protocol file.

3. A text document should pop-up and remain open with some debug output.

4. The resulting GCM files will be prefixed with "autoGCM_<date>_<time>_<mdm-filename>".

Testing


The script is tested this on two systems:

"Dev" system; Windows XP 32-bit, BVQX Version 1.10.2.1198. No apparent bugs here right now.

"Processing" system; a Windows XP 64-bit installation on a VirtualBox hardware-assisted virtual machine (on an Ubuntu 7.04 host), BVQX Version 1.10.4.1250. Here the script is currently unable to use the autoIT function "ControlClick" for these controls:

  • on the Link VTC dialog>Browse button
  • on the ROI analysis window> Load.. button

A workaround is to click these buttons manually as the script is running (only needed once), this however needs to be done within 15 seconds from when they appear.

  • The “Global Tools Log Page” context menu. This results in the script waiting a constant time (set to 20 minutes) before starting the next .mdm.

Note that the script is best compiled in 32bit, since the windows APPDATA environment constant than refers to the correct Program Files folder to find Brainvoyager (If installed in default location.) 

Download


version 0.2 supports multiple mdm's, e.g. for separate subject maps: