MRIcro

About

MRIcro is a 3D viewer and volume renderer for medical images. It is designed for NIfTI format images (popular with neuroimaging scientists) but can typically view images in many popular 3D raster formats including BioRad PIC, DICOM, NRRD, MGZ/MGH, AFNI BRIK, ITK MHA format images.

Versions

• 1.8.2 (build 182, 6-April-2016) Initial GitHub release
• 1.8.6 (build 186, 6-June-2016) Updated to XCode 7.3, updated dcm2niix
• 1.8.7 (build 187, 21-September-2016) Updated dcm2niix
• 1.9.0 (build 190, 29-January-2021) Apple Silicon support
• 1.9.1 (build 191, 9-March-2021) XCode 12.4

Requirements, Downloading and Installation

This software is a universal binary that runs natively on both Intel (x86-64) and Apple Silicon (arm64) CPUs. Users of other operating systems should consider the more powerful MRIcroGL. Users with older versions of macOS should consider MRIcron. The software uses the computers graphics card, so computers with better cards and drivers will be able to view higher resolution images as described in the troubleshooting section.

• Click here to get a compiled copy.
• Click here for NITRC page
• Also available in the AppStore.

Supported Formats

This software can display the following formats: NIfTI (.nii, .nii.gz, .hdr/.img), Bio-Rad Pic (.pic), NRRD (.nhdr, .nrrd), Philips (.par/.rec), ITK MetaImage (.mhd, .mha), ECAT (.v), DeltaVision (.dv), AFNI (.head/.brik), Freesurfer (.mgh, .mgz), and DICOM (extensions vary).

Getting Started

To load an image, you can drag the image to the application icon, drag the image to an open window, or use the File/Open command. The software also provides a File/OpenRecent menu item for reloading images. You can view multiple images simultaneously. Here are some simple commands for adjusting the view:

• Toolbar adjustments (you can hide or show the toolbar with the View menu)
• The “Color Scheme” pulldown menu allows you to adjust the colors used to display image intensity. Initially, this is set to black-white, but you have many options such as blue-green.
• The “Darkest” and “Brightest” number values allow you to display the range for image intensity. For example, in Figure 2 the color range for the blue-green overlay is from 2 to 5.
• The “I”nformation button displays basic information about your image (e.g. image resolution).
• The “View” pull down menu allows you to set whether you want to see only 2D slices, only 3D renderings or both (the default).
• Mouse/Touchpad adjustments
• Click on any location on a 2D slice to jump to that location.
• Drag the 3D rendering to rotate the object.
• Roll the scroll wheel up and down (or pull two fingers up and down on a touch pad) to adjust the clipping depth of the 3D rendering (for example, in Figure 2 we have clipped the top of the brain from the rendering).
• Right-click and drag over the 3D rendering to adjust the position of the clipping plane (for example, in Figure 2 we have set the clip plane to remove the top of the head).
• If you have an overlay loaded (described below), right-click and drag over the 2D slices to adjust the transparency of the overlay.
• If you have a 4D dataset loaded (described below), roll the scroll wheel left and right (or swipe left and right with two fingers) to adjust which volume is displayed.
• Menu adjustments
• The View/RemoveHaze command removes ‘dust’ from the air around an object (described below).
• The View/ChangeBackground switches the background between black and white.
• The Window/YokeWindows option allows you to link different images so they display the same location.

Tutorial 1: Viewing a MRI scan

MRIcro can view images in many medical imaging formats. You can display an image by dragging-and-dropping the file or using the File/Open menu item. The File/OpenStandard and File/OpenAtlas menus open images included with the software, which is ideal for a simple tutorial.

• Choose File/OpenStandard/Chris_T1.nii.gz this should display and image of the brain.
• Note that if you click on the image at different locations, you will change the position of the slices and crosshairs.
• The following controls are on the toolbar. If you do not see the toolbar, choose the View/ShowToolbar menu item. You can choose View/CustomizeToolbar to change the items on the toolbar. Below we consider the default items, as listed from left to right.
• The "View" pull down menu lets you select between different 3D and 2D displays. For example if you choose "Axial" you will see a [https://en.wikipedia.org/wiki/Anatomical_plane horizontal] slice through the image.
• The "i" button displays information about the image, including its dimensions and spatial resolution.
• The layer menu only lists one layer (the T1 scan we loaded as the background). The function of this widget is described in the overlay demo.
• The color scheme menu allows you to set a color mapping for the image. By default, this is a grayscale "Black-white". For this T1 scan, air and water (CSF) is dark, while fat is bright, with gray matter and muscle falling between these two extremes. If you select the "Winter" color scheme you will see that the colors go from blue to green instead of black to white.
• The darkest and brightest values allow us to set the range for our color scheme. By default, the T1 scan loaded with a range of 0 and 140. Thus, any voxel darker than zero will be transparent, while a value of zero will appear as the darkest color of our color scheme, while values brighter than 140 will appear in the darkest color of our color scheme.

Tutorial 2: Viewing a CT scan

Computerized Axial Tomography (CT or CAT) uses XRays to acquire images. Since bones attenuate XRays, this is an excellent modality for visualizing bones (whereas bone has little hydrogen, so it is harder to observer with MRI scans). Another nice feature of CT scans is that the intensity of the voxels is calibrated: air will always have a value of around -1000, water will be around 0 and bone near +1000. MRIcro leverages this fact with special color schemes with names that begin with "CT". These color schemes set both the color and the intensity range (the darkest and brightest values) to help display tissues.

• Choose File/OpenStandard and select the image "CT_abdomen.nii.gz". Note the brightest and darkest values are set to the range -1024..+750, providing a contrast and brightness that covers the full dynamic range of the image.
• Select the Color Scheme pulldown menu in the toolbar and choose "CT kidneys". Note that the brightest and darkest range is now from +114 to +302. Most of the soft tissue is now invisible, revealing the kidneys (in red) and the bones (in white). This CT scan used a gadolinium contrast agent, which is absorbed by the kidneys.
• Choose the "CT airways" color scheme. Now the image contrast is set from -643 to -235. This color scheme highlights the boundary between air and soft tissue, revealing the lungs.

Tutorial 3: Loading a DICOM series

Most medical images are initially stored in the industry standard DICOM format (though scientists like to save them to simpler formats like NIfTI). One issue is that 3D images are typically stored as hundreds of separate 2D slices, just like a 3D loaf of bread is composed of many 2D slices. This poses a challenge for users of macOS, where the operating system only allows an application to open files that the user has explicitly selected. Consider a DICOM image with 2 slices: "a.dcm" and "b.dcm". If a user drags the file "a.dcm" to a viewer, the viewer does not have permission to open the associated file "b.dcm". This is further complicated by the fact that DICOM filenames do not end with a simple extension like ".dcm", but have unique but complicated numeric names. Therefore, to view DICOMs you need to select all the files.

• To complete this tutorial, you will need some DICOM files. You can download this UIH dataset by pressing the Code button and choosing to download the zip file. You will want to extract the zip file.
• Go to a folder with many DICOM files. For this example, select the 192 files in the t1_gre_fsp_3d_sag__132750 folder. Drag all the DICOM images and drop their icons onto MRIcro (either an open window or its icon in the dock).
• Note that the images load. If you are displaying a 3D view, you might notice that the surface appears a bit hazy. This is easiest to see if you are viewing images with a white background (the Preferences window allows you to select a white or black background color).
• You can choose the View/RemoveHaze menu item to remove noisy dark voxels. This can make it easier to observe the surface of an object, as shown in the images below.

Tutorial 4: Loading overlays

We often want to compare the alignment of two scans, or to view one scan (like a statistical map) on top of another image (for example, a high resolution anatomical scan). One option is to open two windows of MRIcro, and open a separate image in each. If you have "Yoke windows" selected in the "Window" menu, clicking on the 2D image of one window will show you the corresponding locations of both images (the crosshairs will show the same location). You can also ope