This is an old revision of the document!
NeuroElf is a Matlab-based toolbox for working with neuro-imaging data. Please be aware that NeuroElf was and is not meant as a replacement for any of the more traditional and full-fledged neuro-imaging tools (such as BrainVoyager QX, SPM, AFNI, FSL, FreeSurfer, …), but rather meant to be used in addition to those, as it augments some of their functionality, facilitating a few of the tasks that might otherwise be more difficult to achieve for those researchers who are not as familiar with coding their own routines in Matlab.
Core elements of the toolbox's functionality are
a flexible file handling class, xff
, which gives the user read and write access to the formats used by the above mentioned programs, and also makes certain “methods” available, with which these objects can be manipulated and the data be made available for various purposes
element handling class, xfigure
, that ameliorates some of the issues I encountered while working with Matlab's uicontrols (such as applying changes to groups of elements and facilitate the somewhat cumbersome access to GUI
a configuration file handling class, xini
, allowing to store configuration settings in human readable form (as an alternative to MAT files)
as well as transimg
, a class that allows stacking layers of image data for combination to images
, an implementation allowing to work with large files without having to read their entire contents into memory
On top of this “core” functionality operates a GUI that allows the user to access some of the functionality of the core elements via dialogs and forms. In particular it is able to visualize voxel- and surface-based objects, to compute (in a limited capacity) and display statistical results, and create tables and screenshots of those.
Additionally, some automatization routines (e.g. a small UI for batching preprocessing of multiple subjects using the functionality of SPM5/8), analysis functionality (e.g. robust regression of second-level neuroimaging data), as well as some further visualization capabilities (e.g. display of VOI-based averaged trial-locked BOLD responses) are provided.
Given that Matlab's syntax has changed over the years, and some features are not available in very old versions, currently NeuroElf runs (to the best of my knowledge) under the following environments:
Microsoft Windows (tested under Windows XP and Windows 7), using Matlab Version v7.5 (R2007b) and onwards
Linux (tested under S.u.S.E. Linux 11.2, 64-bit edition as well as Ubuntu 10, 32-bit edition), using Matlab Version v7.5 (R2007b) and onwards
Mac OSX (tested under Mac OSX 10.5 and 10.6 on an iMac with 64-bit support as well as a OSX 10.4 PPC PowerMac), using Matlab Version v7.5 (R2007b) and onwards
additionally, NeuroElf v0.9c recently added (basic) support for GNU Octave
, starting with version v3.4.0 (currently available for Intel-based Macs and as source code); please note that no GUI elements currently work under GNU Octave!
(a restriction hopefully going away for future Octave versions…)