BrainVoyager v23.0

Creating Anatomical Documents

Essential document types can be created from scanner data using the Create Document Wizard dialog (see below) that can be invoked using the New Document Wizard icon in the main toolbar or by using the New Document Wizard item in the File menu. For special cases requiring more flexible options, one can also use the Create Document fom MRI Data dialog that can be invoked using the New Document icon or the New Document item in the File menu. When creating and analyzing several documents belonging to a larger project, it is recommended to create documents using the Data Analysis Manager. When creating 3D anatomical documents, it is also recommended to anonymize and deface DICOM files, which need to be performed in the present version of BrainVoyager before creating documents (created anatomical documents can also be defaced later). It is planned to integrate anonymization and defacing of DICOM files in the Create Document Wizard in a subsequent release.

The screenshot above shows the first Introduction page of the Create Document Wizard presenting text stating that four basic document types can be created, namely functional (4D) MRI projects, called FMR in BrainVoyager, slice-based inplane anatomical documents (AMR in BrainVoyager), 3D high-resolution anatomical documents (VMR in BrainVoyager) and diffusion-weighted documents (DMR in BrainVoyager). For functional MRI data analysis, FMR and VMR are the two important document types described here. The creation of DMR documents is described in chapter Diffusion-Weighted Imaging Analysis. AMR documents help to visualize the anatomy of the brain in the same slice orientations than those recorded by FMR projects but inplane anatomicals are less used nowadays than in the early years of fMRI when high-resolution 3D MRI data sets were not regularly acquired.

After clicking the Next button, the wizard presents the Document Type page that can be used to select one of the described document types in the Document Type field. When selecting a document type, the Description field describes the purpose of the respective document type. In case one wants to correct or change selections made at some point while walking through the wizard, the Back button can be used to go to an earlier stage. The Cancel button can also be used to quit the dialog without creating the document.

In order to create a high-resolution 3D anatomical document from scanner files created during a scanning session, the VMR document type needs to be selected in the Document type field. 3D anatomical data are usually T1 weighted scans with a high, typically 1 mm, resolution in all 3 dimensions, After clicking the Next button, the scanner data format can be selected on the Raw Data Format page of the wizard.

In the screenshot above, the most usual scanner data type "DICOM" is selected as default in the Data format field. In order to select the DICOM files from which the VMR document should be created, the Select Data Location page will appear after clicking the Next button (see below).

The Document name text field suggests the name "untitled" for the to-be-created VMR document, which should be changed. It is suggested to provide names that follow the BIDS specification as is also done when using the Data Analysis Manager to create documents.

Note. Since version 22.0 of BrainVoyager, the Create Document Wizard allows to create documents in NIfTI format and to store it in BIDS project folders. If you use this option (see below), the name can be kept here as "untitled".

Since the example data used here is from the first subject in the first scanning session, the name "sub-01_ses-01_T1w" has been entered (see green arrow above). In order to select the scanned DICOM files, the Browse button on the right side of the Data location field is used to invoke a standard File Open dialog. In this dialog, any file inside the directory containing the data can be selected. In the screenshot above, a DICOM file has been selected. After selection of a file, the Open button should be clicked, which will start a process that analyzes the contents in the selected directory.

Note. In this step it is only important that the directory containing the data is selected. It does NOT matter WHICH file is selected inside that folder, which can be even a non-DICOM file. The files inside the selected folder will be analyzed and the result will be presented subsequently for the actual scanner data selection (see below).

After analyzing the contents in the selected directory, the result is presented in the Source Files of Scans dialog. This dialog does not show individual DICOM files but one entry per scan corresponding to the various DICOM "series". The screenshot above shows that the program found 3 MRI series in the directory shown in the Directory inspected for DICOM data field. The program also classifies the DICOM series found according to the document type that is likely matching the respective files on disk. Here it assigns the AMR document type to the first series (actually a "scout scan" with three orthognal slice images), a VMR document and a FMR document. Since we are creatign a VMR document, the second entry needs to be selected if not done automatically.

After accepting the selected DICOM series, the Select Data Location page is updated reflecting the chosen scan data by filling the Data location entry with the first DICOM file of the selected series and by showing the dimensions of the individual slices (usually stored in separate DICOM files) in the Detected image resolution field. The program also presents a DICOM Header window showing important (but not exhaustive) fields of the extensive DICOM header from the first DICOM file read from disk. More details about how BrainVoyager uses some of these fields can be found in topic Coordinate Systems

After the Next button is clicked, the wizard presents the Number of Slices page showing the number of slices (and usually the number of files on disk) that make up the data for the 3D anatoical VMR document. The value in the Number of slices field (here: 192) need not to be changed (except in case one wants to read only part of the data) and is shown for information and verification whether the number fits expectations. The page can be accepted by clicking the Next button.

Note. Since version 22.0 of BrainVoyager, a new Target Location page is shown (see screenshot above) prior to the Summary page (see below). On the new target location page one can chose to create a NIfTI file (with associated sidecar files) as output instead of the standard BrainVoyager format. If a BrainVoyager or NIfTI output is chosen but not the BIDS option, the page also allows to specify a target folder where the created document (and associated files) are stored. As default, the directory shown in the Target folder field is the same as where the DICOM files have been found. In order to not mix the raw data location with the location of created documents, it is recommended to chose a folder that is different from the source DICOM files using the Browse button on the right side of the Target folder field. If the NIfTI and BIDS option is chosen, the created files can furthermore be named according to the BIDS standard and stored inside an existing or new BIDS project folder. These NIfTI and BIDS options are very useful since the BIDS-compatible folder hierarchy can be shared more easily with colleagues or public repositories; NIfTI files can also easily be used as the starting point for project-level data analysis pipelines with the Data Analysis Manager (see topic Import NIfTI Document Workflow). When chosing to create a NIfTI file with BIDS naming convention and to store it in an (existing or new) BIDS project folder, one needs to specify the subject and session to which the anatomical dataset belongs using the Subject ID and Session ID spin boxes. The resulting file name is previewed in the File name text field. Futhermore, one needs to specify whether the dataset should be stored in an existing project or a new project. An existing project can be chosen from the Add to project box, which shows all projects (sub-folders) currently existing in the standard projects folder. The projects folder can also be changed by using the Select (...) icon on the right side of the In directory field. If one wants to store the NIfTI data in a new BIDS project, the New option needs to be turned on and a top-level project folder name need to be entered in the New Project text field on the right side of the New option. When all settings have been made, one can proceed to the Summary page using the Next button.

The final page presented by the wizard before creating the document is the Summary page, which can be used to review the assembled and entered information. The page also allows to specify a target folder where the created document (and associated files) are stored. As default, the directory shown in the Target folder field is the same as where the DICOM files have been found. In order to not mix the raw data location with the location of created documents, it is recommended to chose a folder that is different from the source DICOM files using the Browse button on the right side of the Target folder field. When clicking the Finish button, the 3D anatomical project will be created as a VMR BrainVoyager document by assembling the individual DICOM files in a common data structrue and by storing relevant information from the DICOM header in the header of the resulting VMR (and V16) file. Note that the Summary page looks different in case one has chosen to store the data in NIfTI / BIDS format in the Target Location page (see above) and the DICOM files are assembled and stored in a NIfTI file plus a JSON sidecar file. If information is verified, one can proceed by clicking the Finish button.

After clicking the Finish button, the 3D anatomical VMR document is created and will be displayed in BrainVoyager's mutli-document area (see screenshto above showing the new document in tabbed mode). If the VMR is not oriented in BrainVoyager's standard sagittal orientation, the program will offer to re-orient the data, which should be usually accepted. In case that the voxel resolution is not isotropic (the same in all dimensions) or not 1.0 millimeters, the program will also suggest to rescale the volume accordingly. This should be usually accepted except in case that one wants to use a specific resolution, e.g. for high-resolution (sub-millimeter) data analysis. As can be seen in the example document above, the created document exhibits intensity inhomogeneities that can be substantially reduced by using the intensity inhomogeneity correction tool.


Copyright © 2023 Rainer Goebel. All rights reserved.