BrainVoyager 24.2.5 |
|---|
| This minor patch release provides improvements and bug fixes. |
Enhancements |
|---|
| Across-Run Motion Correction .SDM Files | When using the new (24.2) across-run motion correction approach, the within-run motion parameters were saved in a '_3DMC.sdm' file, e.g. for use as confound predictors. While the across-run time courses do not add additional time course information (each volume gets the same across-run motion offset parameters), the "full" parameters to a target run might be of interest. From this version onwards, two .SDM files are saved after across-run motion correction, one with the pure within-run parameters ('_with-run-3DMC.sdm') and one with the full across-run parameters ('_across-run-3DMC.sdm'). |
| Protocol TSVs with 4th Column | When converting TSV files into BrainVoyager protocol (PRT) files, usually when importing NIfTI BIDS data, TSV files with more than 3 columns were ignored. Now such files are supported and the first 3 columns are interpreted as before as 'onset', 'duration' and 'condition'. The 4th column is interpreted as containing parametric weights in case that the column title name contains one of the (sub-)strings “param”, “weight”, “rating". If this is the case, the 4th column is read; in case of non-numerical entries (strings), they are converted to value '1.0'. All other columns beyond column 4 are ignored. It is also possible to load a TSV file directly via the ‘File -> Open TSV’ menu; in case the encountered header labels of the first 3 columns indicate that the TSV represents a protocol file, the “Save as PRT” button will appear in the presented 'Table' dialog. In case of more than 3 columns, the program will ask whether the 4th column should be used as parametric weighs or whether the column should be ignored. |
| Label Drawing Mode | Label drawing was started often automatically, which could interfere with other usage scenarios. It can now directly turned on and off using the new 'Enable Label Drawing' ("Start/Stop") button in the toolbar of the 'Zoom View' panel (besides using the 'Enable' button in the 'Volumes-Of-Interest' dialog). Keeping the option off when no drawing is intended, the Zoom View can be used to view / inspect VMRs with any linked files, for example to show volume time courses (if VTC linked to VMR) with CMD/CTRL-click on a voxel in the 'Zoom View' in case that a VTC file is attached to the VMR document. Also tooltips are shown in the label drawing 'off' mode, and clicking on a voxel (or moving the mouse cursor while holding the left mouse button) sets the cross at the corresponding location in the VMR view. When turning on label drawing by clicking the new "Start/Stop" button", a VOI will be auto-defined for drawing if no VOI is currently available (empty VOIs list in the 'Volumes-Of-Interest" dialog. |
| Saving SDM without Constant | When saving predictors to disk in the 'Single Study General Linear Model' dialog, the program adds a constant confound by default. For some applications it is useful to save predictors without an added constant, which can now be done by turning off the 'Implicitg definition of constant' option in the 'Masking / Options' tab of the 'Single Study GLM Options' dialog. An example case might be reading in motion parameters, z standardizing them, and saving them back as 6 predictors (withotu a constant confound) to disk. |
| Editing Multiple VOIs | When clicking the 'Edit' button in the 'Volumes-Of-Interest (VOIs)' dialog while having selected more than one VOI, a new 'Edit Multiple VOIs' dialog appears, which can be used to assign a specified color to all selected VOIs. It also allows to to add a text string at the begin ('Prepend' field) or end ('Append' field) of the name of each VOI. The latter is, for example, useful to add a label of the brain hemisphere (e.g., "left" or "right") to all selected VOIs. |
| VOI Number in Tooltip | When hovering with the mouse cursor over a displayed VOI, the appearing tooltip now shows the number of the VOI in front of the VOI name. |
| Zooming in the 3D Viewer | Besides pressing and moving two mouse buttons to zoom in and out in the 3D viewer, it is now also possible to rotate the mouse wheel to zoom in (forward movement) or out (backward movement). On trackpads (of Apple computers), this also makes it possible to use two fingers to zoom in and out by moving the fingers forward and backwards. |
| Appearance on macOS | The appearance on macOS 26 now follows the 'Tahoe' style when turning on the 'OS theme' option in the 'Display theme' field of the 'GUI' tab in the 'Settings' dialog. Appearance improvements have been made especially for the GUI elements (side toolbar, panels) in the '3D Viewer', which still works best in dark mode (macOS and BV theme) but now also supports light mode. |
Bug Fixes |
|---|
| NIfTI Reading Memory Leak | When opening compressed (.gz) NIfTI files, some memory was not made available that was allocated during reading. When opening many NIfTI files this memory leak could force one to close BrainVoyager. This issue has been fixed. |
| Exporting Label Volumes | When using the new (24.2) label volume export function in the Regions-Of-Interest dialog, a proper orientation matrix was not stored in the exported NIfTI files (anatomy and segmentation label file). When loading the exported files in e.g. ITK-Snap, the orthographic views did not match the displayed orientation labels. This issue has been fixed by saving a proper orientation matrix for display. |
| Smoothing VTC with Negative Values | In case that float VTC files with negative values were postprocessed using spatial smoothing, the negative values were not processed correctly. This issue has been fixed. |