BrainVoyager v22.2

Plugins

Introduction 

Plugins provide a means to extend the computational capabilities of BrainVoyager. As a user, you benefit from additional features which may be provided by any plugin developer, i.e. programmers from Brain Innovation, colleagues at other universities and neuroimaging centers, or from programmers within your own research group. BrainVoyager exposes all major internal data structures to the C++/JavaScript plugin programmer allowing creation of new tools based on the software's powerful data handling and visualization capabilities. Since created plugins are embedded in the user interface, you can call the respective functions like any other routine in BrainVoyager.

Description 

When you click the Plugins menu, a list of all available C++/JavaScript plugins will be shown. BrtainVoyager automatically fills the Plugins menu with all plugins found in the "Plugins_32" (32-bit operating system, deprecated) or "Plugins_64" (64-bit operating system) subfolder within the "BVExtensions" folder. The "BVExtensions" folder contains also the "Scripts" subfolder and is located itself within your "Documents" folder. On Windows 7, 8.1 and 10, the "Documents" folder is located in "C:\Users\<USER>\Documents". On macOS and Linux, the "Documents" folder is located within your "Home" folder, i.e. "/Users/<USER>/Documents" on macOS and "/home/<USER>/Documents" on Linux. If the Documents folder is not already existing on your Linux system, it is created during installation of BrainVoyager. Note that the directory structure in newer Windows operating systems (7, 8.1, 10) is similar to the Linux and macOS folder layout.

Within the "Plugins" folder, all plugin files (shared libraries with the extension ".dll" on Windows, ".so" on Linux and ".dylib" on macOS) will be interrogated by BrainVoyager to provide a name and a short description of the provided function. The returned plugin name is shown in the Plugins menu. To see a description of the available plugins, click Description Of Plugins in the Plugins menu (see snapshot below). Note that many plugins provide their own documentation that is available via a link in the plugin description text; click this link to obtain detailled documentation about the operation of a plugin and of input parameters (if available). While the ICA routines in BrainVoyager are also implemented as plugins, they can be launched both from the Analysis and Plugins menu; note that the documentation of the ICA plugins is available in this User's Guide.

To start a plugin, simply click its name. BrainVoyager will then call the plugin code and takes back control when the plugin has finished its computations. Since BrainVoyager QX 2.1, plugins may also run interactively presenting rich GUI components to the user. In order to obtain a list of all available plugins made available through Brain Innovation, click the Plugins Web Page item in the Plugins or Help menu.

Note that besides C++ plugins, it is also possible to use (and write) Python plugins since BrainVoyger v20.


Copyright © 2021 Rainer Goebel. All rights reserved.