Difference between revisions of "Introducing MIPAV"

From MIPAV
Jump to: navigation, search
(Introducing MIPAV)
m
 
(46 intermediate revisions by 2 users not shown)
Line 1: Line 1:
=Introducing MIPAV=
+
<div id="IntroducingMipav"></div>
 +
== Introducing MIPAV ==
 +
[[File:MipavSplash.gif|158px|thumb|right|MIPAV]]
  
In this chapter . . .<br />
+
[http://en.wikipedia.org/wiki/Medical_imaging Imaging] is essential to medical research and clinical practice. Biologists study cells and generate three-dimensional (3D) confocal microscopy datasets; virologists generate 3D reconstructions of viruses from micrographs. Radiologists identify and quantify tumors from [http://en.wikipedia.org/wiki/Magnetic_resonance_imaging Magnetic Resonance Imaging (MRI)] and [http://en.wikipedia.org/wiki/X-ray_computed_tomography Computed Tomography (CT)] scans.
*[[Platform independence]]
+
*Supported image types
+
*Visualization of images
+
*Extensibility with Java plug-ins
+
*Sampling of MIPAV's features
+
  
Imaging is essential to medical research and clinical practice. Biologists study cells and generate three-dimensional (3D) confocal microscopy datasets; virologists generate 3D reconstructions of viruses from micrographs. Radiologists identify and quantify tumors from Magnetic Resonance Imaging (MRI) and Computed Tomography (CT) scans.
+
Neuroscientists detect regional metabolic brain activity from [http://en.wikipedia.org/wiki/Positron_emission_tomography Positron Emission Tomography (PET)] and [http://en.wikipedia.org/wiki/Functional_magnetic_resonance_imaging functional MRI (fMRI)] scans. Analysis of these diverse image datasets require sophisticated quantification and visualization tools. Until recently, 3D visualization and quantitative analysis of an image dataset could only be performed on expensive [http://en.wikipedia.org/wiki/Unix UNIX workstations] with customized software.
 
+
Neuroscientists detect regional metabolic brain activity from Positron Emission Tomography (PET) and functional MRI (fMRI) scans. Analysis of these diverse image datasets require sophisticated quantification and visualization tools. Until recently, 3D visualization and quantitative analysis of an image dataset could only be performed on expensive UNIX workstations with customized software.
+
  
 
Because of technological advancements, medical image visualization and analysis can now be performed on an inexpensive desktop computer that is equipped with the appropriate software applications.
 
Because of technological advancements, medical image visualization and analysis can now be performed on an inexpensive desktop computer that is equipped with the appropriate software applications.
  
<div style="font-style: normal; font-weight: normal; margin-bottom: 6pt; margin-left: 0pt; margin-right: 0pt; margin-top: 0pt; text-align: left; text-decoration: none; text-indent: 0pt; text-transform: none; vertical-align: baseline"><font color="#000000"> This <span style="font-weight: normal; text-decoration: none; text-transform: none; vertical-align: baseline">''<font color="#000000">User's Guide</font>''</span> explains how to use one of these software applications: Medical Image Processing, Analysis, and Visualization (MIPAV). Researchers use MIPAV to extract quantitative information from image datasets of various medical image modalities. The MIPAV application can run on virtually any platform, including Microsoft Windows, Solaris, and the Macintosh Operating System (Mac OS). <br /></font></div>
+
This [[Introducing MIPAV | Getting Started guide]] explains how to use one of these software applications: [http://mipav.cit.nih.gov/index.php|Medical Image Processing, Analysis, and Visualization] (MIPAV). Researchers use MIPAV to extract quantitative information from image datasets of various medical image modalities. The MIPAV application can run on virtually any platform, including [http://windows.microsoft.com/en-US/windows/home Microsoft Windows], [http://en.wikipedia.org/wiki/Solaris_%28operating_system%29 Solaris], and the [http://en.wikipedia.org/wiki/Mac_OS Macintosh Operating System (Mac OS)]. <br />
  
This chapter provides information on the characteristics of the product:
+
MIPAV installation program can be downloaded from MIPAV web site - <span style="font-style: normal; text-transform: none; vertical-align: baseline"><u>'''<font color="#000000">http://mipav.cit.nih.gov</font>'''</u></span>
  
<div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 24pt; margin-right: 0pt; margin-top: 5pt; text-align: left; text-decoration: none; text-indent: -24pt; text-transform: none; vertical-align: baseline"><font color="#000000">  Platform independence<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 24pt; margin-right: 0pt; margin-top: 0pt; text-align: left; text-decoration: none; text-indent: -24pt; text-transform: none; vertical-align: baseline"><font color="#000000">  Supported image types<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 24pt; margin-right: 0pt; margin-top: 0pt; text-align: left; text-decoration: none; text-indent: -24pt; text-transform: none; vertical-align: baseline"><font color="#000000">  Ability to visualize image datasets of two or more dimensions<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 24pt; margin-right: 0pt; margin-top: 0pt; text-align: left; text-decoration: none; text-indent: -24pt; text-transform: none; vertical-align: baseline"><font color="#000000">  Volume of interest (VOI) segmentation and analysis methods<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 24pt; margin-right: 0pt; margin-top: 0pt; text-align: left; text-decoration: none; text-indent: -24pt; text-transform: none; vertical-align: baseline"><font color="#000000">  Ability to accommodate customized user-created plug-ins<br /></font></div>
+
<div id="MipavPlatformIndependence"></div>
  
 
== Platform independence ==
 
== Platform independence ==
 +
Much research at NIH requires the segmentation, quantification, and visualization of 2D, 3D, and 4D image datasets. Researchers analyze images of varied imaging modalities, such as microscopy, microarray data, X-ray, CT, MRI, fMRI, and PET. Factors such as personal preference, data requirements, software limitations, and precedent have led to a heterogeneous distribution of computer platforms, among which are personal computers executing Windows or Linux, Macintoshes, and workstations by SGI, Sun Microsystems, or Hewlett-Packard. To analyze an image dataset, researchers may use several software applications. If each software application is platform specific, researchers may need access to several platforms to analyze a single image dataset. This often reduces efficiency while simultaneously increasing lab costs. MIPAV has been designed to help researchers increase efficiency and reduce costs by providing them with a flexible tool that can operate on virtually any platform. Researchers can use MIPAV by itself or in concert with other image processing and visualization tools.
 +
 +
 +
The MIPAV application is platform independent because it is written in [http://www.java.com/en/ Java], which is an object-oriented, interpreted, programming language that was developed by [http://en.wikipedia.org/wiki/Sun_Microsystems Sun Microsystems]. Java source code is compiled into the bytecode, which is machine-level code that is compiled specifically for the [http://en.wikipedia.org/wiki/Java_virtual_machine Java Virtual Machine (JVM)]. There are versions of the Java VM for different platforms. The same program (bytecode) can run on any of those versions. If researchers run a Java program on a Windows platform, the bytecode is interpreted by the Java VM that has been specifically designed for the particular Windows platform. If the same program is run on a Solaris platform; the bytecode is then interpreted by the Java VM that was specifically designed for the Solaris platform.
 +
 +
'''Note:''' The correct version of the Java VM can be downloaded from the MIPAV web site <span style="font-style: normal; text-transform: none; vertical-align: baseline"><u>'''<font color="#000000">http://mipav.cit.nih.gov</font>'''</u></span> along with the MIPAV installation program.
 +
 +
<div id="MipavCapabilities"></div>
 +
 +
== Understanding MIPAV capabilities ==
 +
 +
<div id="SupportedImagetypes"></div>
 +
=== Supported image types ===
 +
 +
Before image dataset analysis and quantification can be performed, an application must be able to read and write image datasets in industry-standard formats. Conformance to accepted standards, such as DICOM, ensures compatibility with present and future applications and medical equipment. This protects researchers' investment in hardware and provides flexibility in reaching their goals.<br />
 +
 +
MIPAV supports over 20 different industry-standard image formats including: DICOM, TIFF, Analyze, and RAW (a complete list appears in [[Supported Formats#SupportedFormats|Supported formats]]). MIPAV reads and writes images in both big and little endian formats.
 +
 +
See also: [[Supported Formats]].
  
<div style="font-style: normal; font-weight: normal; margin-bottom: 6pt; margin-left: 0pt; margin-right: 0pt; margin-top: 0pt; text-align: left; text-decoration: none; text-indent: 0pt; text-transform: none; vertical-align: baseline"><font color="#000000"> Much research at NIH requires the segmentation, quantification, and visualization of 2D, 3D, and 4D image datasets. Researchers analyze images of varied imaging modalities, such as microscopy, microarray data, X-ray, CT, MRI, fMRI, and PET. Factors such as personal preference, data requirements, software limitations, and precedent have led to a heterogeneous distribution of computer platforms, among which are personal computers executing Windows or Linux, Macintoshes, and workstations by SGI, Sun Microsystems, or Hewlett-Packard. To analyze an image dataset, researchers may use several software applications. If each software application is platform specific, researchers may need access to several platforms to analyze a single image dataset. This often reduces efficiency while simultaneously increasing lab costs. MIPAV has been designed to help researchers increase efficiency and reduce costs by providing them with a flexible tool that can operate on virtually any platform. Researchers can use MIPAV by itself or in concert with other image processing and visualization tools.<br /></font></div>
+
=== Visualization of images ===
  
The MIPAV application is platform independent because it is written in Java, which is an object-oriented, interpreted, programming language that was developed by Sun Microsystems. Java source code is compiled into the bytecode, which is machine-level code that is compiled specifically for the Java Virtual Machine (VM). There are versions of the Java VM for different platforms. The same program (bytecode) can run on any of those versions. If researchers run a Java program on a Windows 2000 platform, the bytecode is interpreted by the Java VM that has been specifically designed for the Windows 2000 platform. If the same program is run on a Solaris platform; the bytecode is then interpreted by the Java VM that was specifically designed for the Solaris platform.
+
The visualization of datasets with two or more dimensions is an important aspect of image dataset analysis and research. The ability to visualize the orientation, locality, or progression (time) of structures in clinical and nonclinical datasets can be vital to researchers. Confocal microscopy, CT, and MRI are examples of imaging modalities that are comprised of multiple adjacent cross-sectional image datasets that can be combined to form a 3D volume dataset. MIPAV allows researchers to visualize datasets using a variety of presentation formats, including lightbox, triplanar, cine, and animate. Once researchers display the image dataset, they can adjust the lookup table (LUT), apply prepackaged pseudo-color LUTs to highlight structures of interest, control the magnification level, adjust the transfer function, and more. <br />
  
<div style="font-style: normal; font-weight: normal; margin-bottom: 5pt; margin-left: 0pt; margin-right: 0pt; margin-top: 5pt; text-align: left; text-decoration: none; text-indent: 0pt; text-transform: none; vertical-align: baseline"><font color="#000000"> <span style="font-style: normal; text-decoration: none; text-transform: none; vertical-align: baseline">'''<font color="#000000">Note:</font>'''</span> The correct version of the Java VM can be downloaded from the MIPAV web site <span style="font-style: normal; text-transform: none; vertical-align: baseline"><u>'''<font color="#000000">http://mipav.cit.nih.gov</font>'''</u></span> along with the MIPAV installation program.<br /></font></div>
+
=== Volume of interest (VOI) segmentation and analysis ===
  
== Supported image types ==
+
Another significant research activity is the quantification of data from image datasets. Although the visualization of image data is important, the actual quantification of the data is typically required to evaluate the researchers' hypothesis. Researchers must be able to identify regions-of-interest (ROIs) and  [[Delineating volumes of interest (VOIs)| volumes of interest (VOIs)]].
  
<div style="font-style: normal; font-weight: normal; margin-bottom: 6pt; margin-left: 0pt; margin-right: 0pt; margin-top: 0pt; text-align: left; text-decoration: none; text-indent: 0pt; text-transform: none; vertical-align: baseline"><font color="#000000"> Before image dataset analysis and quantification can be performed, an application must be able to read and write image datasets in industry-standard formats. Conformance to accepted standards, such as DICOM, ensures compatibility with present and future applications and medical equipment. This protects researchers' investment in hardware and provides flexibility in reaching their goals.<br /></font></div>
+
'''Note:''' An ROI is used in the context of 2D image datasets. VOI usually describes the analysis of volume data for datasets with more than two dimensions. This document uses the term VOI to represent both ROI and VOI.
  
MIPAV supports over 20 different industry-standard image formats including: DICOM, TIFF, Analyze, and RAW (a complete list appears in [[Appendix C: "Supported formats" ]]. MIPAV reads and writes images in both big and little endian formats.
+
'''[[Delineating volumes of interest (VOIs)| Image segmentation]]''' is the process of identifying connected regions of images as members of a common group. In the medical field, physicians must routinely identify (i.e., segment) structures in medical image datasets to facilitate the treatment of patients. For example, many researchers who study the brain are interested in the segmentation of gray matter, white matter, and cerebrospinal fluid in MR images. The quantification of important attributes, such as volume, of various tissue types enables researchers to better understand, diagnose, monitor, and treat neurobehavioral disorders.
  
== Visualization of images ==
+
There is a multitude of image dataset segmentation methods; the choice of segmentation algorithm depends on the image data type and task. Automatic segmentation methods are desirable because they require little user interaction, which is subject to operator error and subjectivity. However, in practice automatic methods sometimes fail and require manual VOI correction (adjustment of the boundary that identifies the region). In MIPAV, researchers have the choice to segment VOIs automatically, semi-automatically, and manually. [[Delineating volumes of interest (VOIs)| Contours]] can be manually edited, grouped, and copied to other slices in the dataset. MIPAV also offers a variety of [[Segmenting Images Using Contours and Masks| mask-generation methods]]. Researchers can manually [[Segmenting Images Using Contours and Masks: Advanced paint and Power Paint tools|paint a mask]] or use one or a combination of [[Using MIPAV Algorithms#MipavAlgorithms|segmentation algorithms]].
  
<div style="font-style: normal; font-weight: normal; margin-bottom: 6pt; margin-left: 0pt; margin-right: 0pt; margin-top: 0pt; text-align: left; text-decoration: none; text-indent: 0pt; text-transform: none; vertical-align: baseline"><font color="#000000"> The visualization of datasets with two or more dimensions is an important aspect of image dataset analysis and research. The ability to visualize the orientation, locality, or progression (time) of structures in clinical and nonclinical datasets can be vital to researchers. Confocal microscopy, CT, and MRI are examples of imaging modalities that are comprised of multiple adjacent cross-sectional image datasets that can be combined to form a 3D volume dataset. MIPAV allows researchers to visualize datasets using a variety of presentation formats, including lightbox, triplanar, cine, and animate. Once researchers display the image dataset, they can adjust the lookup table (LUT), apply prepackaged pseudo-color LUTs to highlight structures of interest, control the magnification level, adjust the transfer function, and more. <br /></font></div>
+
MIPAV also allows researchers to perform [[Calculating VOI statistics | statistical calculations on masked and contoured VOIs]]. Statistical results can be saved to an ASCII text file and imported to another program, as needed.
  
== Volume of interest (VOI) segmentation and analysis ==
+
<div id="JavaPlugIns"></div>
 +
=== Extensibility with Java plug-ins ===
  
<div style="font-style: normal; font-weight: normal; margin-bottom: 6pt; margin-left: 0pt; margin-right: 0pt; margin-top: 0pt; text-align: left; text-decoration: none; text-indent: 0pt; text-transform: none; vertical-align: baseline"><font color="#000000"> Another significant research activity is the quantification of data from image datasets. Although the visualization of image data is important, the actual quantification of the data is typically required to evaluate the researchers' hypothesis. Researchers must be able to identify regions-of-interest (ROIs) and/or volumes-of-interest (VOIs).<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 5pt; margin-left: 0pt; margin-right: 0pt; margin-top: 5pt; text-align: left; text-decoration: none; text-indent: 0pt; text-transform: none; vertical-align: baseline"><font color="#000000"> <span style="font-style: normal; text-decoration: none; text-transform: none; vertical-align: baseline">'''<font color="#000000">Note:</font>'''</span> An ROI is used in the context of 2D image datasets. VOI usually describes the analysis of volume data for datasets with more than two dimensions. This document uses the term VOI to represent both ROI and VOI.<br /></font></div>
+
A typical analysis and visualization application can be designed to meet a broad range of researcher requirements. Many components of image dataset processing, analysis, and visualization techniques are general and can be applied to many types of data. However, many datasets also require unique functionality to meet special requirements. MIPAV allows researchers, who have the programming resources, to add a customized Java plug-in to the application. To program a plug-in, researchers must have a strong understanding of the underlying structure of the application's software design.
  
<span style="font-weight: normal; text-decoration: none; text-transform: none; vertical-align: baseline">''<font color="#000000">Image segmentation</font>''</span> is the process of identifying connected regions of images as members of a common group. In the medical field, physicians must routinely identify (i.e., segment) structures in medical image datasets to facilitate the treatment of patients. For example, many researchers who study the brain are interested in the segmentation of gray matter, white matter, and cerebrospinal fluid in MR images. The quantification of important attributes, such as volume, of various tissue types enables researchers to better understand, diagnose, monitor, and treat neurobehavioral disorders.
+
The [[Developing Plugin Programs]] chapter offers the information on how to add and remove plug-ins from the MIPAV application. It also indicates the statements that must be included in the source code to allow the plug-in to interface properly with MIPAV. However, in-depth information is not included in this guide. If you need more information, check the MIPAV web site <span style="font-style: normal; text-transform: none; vertical-align: baseline"><u>'''<font color="#000000">http://mipav.cit.nih.gov</font>'''</u></span> for the e-mail address for technical support.
  
There are a multitude of image dataset segmentation methods; the choice of segmentation algorithm depends on the image data type and task. Automatic segmentation methods are desirable because they require little user interaction, which is subject to operator error and subjectivity. However, in practice automatic methods sometimes fail and require manual VOI correction (adjustment of the boundary that identifies the region). Thus, in MIPAV, researchers have the choice to automatically, semiautomatically, and manually segment VOIs. Contours can be manually edited, grouped, and copied to other slices in the dataset. MIPAV also offers a variety of mask-generation methods. Researchers can manually paint a mask or use one of several algorithms.
+
See also: [[Developing new tools using the API]].
  
MIPAV also allows researchers to perform statistical calculations on masked and contoured VOIs. Statistical results can be saved to an ASCII text file and imported to another program, as needed.
+
<div id="MipavFeatures"></div>
  
== Extensibility with Java plug-ins ==
+
=== Sampling of MIPAV's features ===
 +
MIPAV provides ready-made, general-purpose tools that meet the majority of requirements of many researchers. Researchers can use MIPAV to perform a variety of tasks. The following list shows a sampling of the tasks that researchers can performed with the program. For more information, refer to the MIPAV web site: [http://mipav.cit.nih.gov/documentation.php http://mipav.cit.nih.gov/documentation.php].
  
<div style="font-style: normal; font-weight: normal; margin-bottom: 6pt; margin-left: 0pt; margin-right: 0pt; margin-top: 0pt; text-align: left; text-decoration: none; text-indent: 0pt; text-transform: none; vertical-align: baseline"><font color="#000000"> A typical analysis and visualization application can be designed to meet a broad range of researcher requirements. Many components of image dataset processing, analysis, and visualization techniques are general and can be applied to many types of data. However, many datasets also require unique functionality to meet special requirements. MIPAV allows researchers, who have the programming resources, to add a customized Java plug-in to the application. To program a plug-in, researchers must have a strong understanding of the underlying structure of the application's software design.<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 5pt; margin-left: 0pt; margin-right: 0pt; margin-top: 5pt; text-align: left; text-decoration: none; text-indent: 0pt; text-transform: none; vertical-align: baseline"><font color="#000000"> <span style="font-style: normal; text-decoration: none; text-transform: none; vertical-align: baseline">'''<font color="#000000">Note:</font>'''</span> This <span style="font-weight: normal; text-decoration: none; text-transform: none; vertical-align: baseline">''<font color="#000000">User's Guide</font>''</span> presents information on how to add and remove plug-ins from the MIPAV application. It also indicates the statements that must be included in the source code to allow the plug-in to interface properly with MIPAV. However, in-depth information is not included in this guide. If you need more information, check the MIPAV web site <span style="font-style: normal; text-transform: none; vertical-align: baseline"><u>'''<font color="#000000">http://mipav.cit.nih.gov</font>'''</u></span> for the e-mail address for technical support (Figure 1).<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 0pt; margin-right: 0pt; margin-top: 0pt; text-align: left; text-decoration: none; text-indent: 0pt; text-transform: none; vertical-align: baseline"><font color="#000000">
+
*[[Displaying images | Visualize files]] and [[Creating new images |create new image dataset files]]
 +
*[[Displaying images | View and modify the attributes of image datasets]], including [[Working with DICOM Images | DICOM]] and [[Delineating volumes of interest (VOIs)| volumes of interest (VOI) information]]
 +
*Adjust the [[Displaying images | display of an image dataset file]] and [[Displaying images#AdjustingMagnification|adjust magnification]] settings
 +
*[[Working with DICOM Images | View DICOM overlays]] and protect patient privacy using the [[Protecting patient privacy using Anonymize| anonymize feature]]
 +
*[[Sending and retrieving DICOM images| Send and receive image dataset files to and from databases via DICOM-compliant servers]] 
 +
*[[Delineating volumes of interest (VOIs)|Contour VOIs]] using manual, semi-automatic, and automatic methods
 +
*[[Reviewing VOI statistics|Generate graphs and calculate statistics on VOIs]]
 +
*[[Changing Image Contrast#PredefinedLut| Generate and adjust histograms and Look up tables (LUT)]] using customized or preset options
 +
*Run sophisticated, predefined [http://mipav.cit.nih.gov/documentation/userguide/Vol2Algorithms.pdf algorithms] and [[Customizing MIPAV | generate logs]]
 +
*[[Changing Image Contrast#ComparingImages | Blend two image datasets and adjust opacity levels of the alpha channels so overlapping areas can be studied]]
 +
*[[Developing Plugin Programs | Create new plug-ins]] to further customize the analysis of data
 +
*[[Saving and printing images | Save transformation]], [[Changing Image Contrast | LUT]], and [[Delineating volumes of interest (VOIs)|VOI data]], and apply them to other image datasets
 +
*[[Saving and printing images | Print image dataset files]], [[Reviewing VOI statistics| intensity profiles]], statistical data, algorithmic logs, and [[Customizing MIPAV | debugging log data]]
  
{| border="1" cellpadding="5"
+
== See also: ==
|+ <div style="font-style: normal; margin-bottom: 3pt; margin-left: 0pt; margin-right: 0pt; margin-top: 9pt; text-align: left; text-decoration: none; text-indent: 0pt; text-transform: none; vertical-align: baseline">'''<font color="#000000"> Figure 1. MIPAV home page<br /></font>'''</div>
+
*[http://mipav.cit.nih.gov MIPAV web site]
|-
+
*[http://mipav.cit.nih.gov/wiki/index.php/Main_Page MIPAV WIKI]
|
+
*[[Getting Started Quickly with MIPAV]]
[[Image:MIPAV_HOmewebpage.jpg]]
+
*[[Installing mipav|Installing MIPAV]]
|}
+
*[[MIPAV system requirements]]
 +
*[[Installing mipav|Installing MIPAV]]
 +
*[[Installing mipav#MipavUpgrade|Upgrading MIPAV]]
 +
*[[Installing mipav#MipavUninstall|Uninstalling MIPAV]]
 +
*[[Quitting MIPAV]]
 +
*[[MIPAV mailing list]]
 +
*[[Technical Support]]
 +
*[[Installing mipav#MipavNews|Viewing MIPAV News and Updates]]
 +
*[[Developing new tools using the API]]
 +
*[[Supported Formats]]
  
== Sampling of MIPAV's features ==
 
  
<div style="font-style: normal; font-weight: normal; margin-bottom: 6pt; margin-left: 0pt; margin-right: 0pt; margin-top: 0pt; text-align: left; text-decoration: none; text-indent: 0pt; text-transform: none; vertical-align: baseline"><font color="#000000"> MIPAV provides ready-made, general-purpose tools that meet the majority of requirements of many researchers. Researchers can use MIPAV to perform a variety of tasks. The following list shows a sampling of the tasks that researchers can performed with the program. These tasks and others are addressed in volumes 1 and 2 of this <span style="font-weight: normal; text-decoration: none; text-transform: none; vertical-align: baseline">''<font color="#000000">User's Guide.</font>''</span><br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 24pt; margin-right: 0pt; margin-top: 5pt; text-align: left; text-decoration: none; text-indent: -24pt; text-transform: none; vertical-align: baseline"><font color="#000000">  Visualize files and create new image dataset files<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 24pt; margin-right: 0pt; margin-top: 5pt; text-align: left; text-decoration: none; text-indent: -24pt; text-transform: none; vertical-align: baseline"><font color="#000000">  View and modify the attributes of an image dataset, including DICOM and VOI information<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 24pt; margin-right: 0pt; margin-top: 5pt; text-align: left; text-decoration: none; text-indent: -24pt; text-transform: none; vertical-align: baseline"><font color="#000000">  Adjust the display of an image dataset file and adjust magnification settings<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 24pt; margin-right: 0pt; margin-top: 5pt; text-align: left; text-decoration: none; text-indent: -24pt; text-transform: none; vertical-align: baseline"><font color="#000000">  View DICOM overlays and protect patient privacy using the anonymize feature<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 24pt; margin-right: 0pt; margin-top: 5pt; text-align: left; text-decoration: none; text-indent: -24pt; text-transform: none; vertical-align: baseline"><font color="#000000">  Send and receive image dataset files to and from databases via DICOM-compliant servers <br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 24pt; margin-right: 0pt; margin-top: 5pt; text-align: left; text-decoration: none; text-indent: -24pt; text-transform: none; vertical-align: baseline"><font color="#000000">  Contour VOIs using manual, semi-automatic, and automatic methods<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 24pt; margin-right: 0pt; margin-top: 5pt; text-align: left; text-decoration: none; text-indent: -24pt; text-transform: none; vertical-align: baseline"><font color="#000000">  Generate graphs and calculate statistics on VOIs<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 24pt; margin-right: 0pt; margin-top: 5pt; text-align: left; text-decoration: none; text-indent: -24pt; text-transform: none; vertical-align: baseline"><font color="#000000">  Generate and adjust histograms and LUTs using customized or preset options<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 24pt; margin-right: 0pt; margin-top: 5pt; text-align: left; text-decoration: none; text-indent: -24pt; text-transform: none; vertical-align: baseline"><font color="#000000">  Run sophisticated, predefined algorithms, and generate logs<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 24pt; margin-right: 0pt; margin-top: 5pt; text-align: left; text-decoration: none; text-indent: -24pt; text-transform: none; vertical-align: baseline"><font color="#000000">  Blend two image datasets and adjust opacity levels of the alpha channels so overlapping areas can be studied<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 24pt; margin-right: 0pt; margin-top: 5pt; text-align: left; text-decoration: none; text-indent: -24pt; text-transform: none; vertical-align: baseline"><font color="#000000">  Create new plug-ins to further customize the analysis of data<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 24pt; margin-right: 0pt; margin-top: 5pt; text-align: left; text-decoration: none; text-indent: -24pt; text-transform: none; vertical-align: baseline"><font color="#000000">  Save transformation, LUT, and VOI data, and apply them to other image datasets<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 24pt; margin-right: 0pt; margin-top: 5pt; text-align: left; text-decoration: none; text-indent: -24pt; text-transform: none; vertical-align: baseline"><font color="#000000">  Print image dataset files, intensity profiles, statistical data, algorithmic logs, and debugging log data<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 24pt; margin-right: 0pt; margin-top: 5pt; text-align: left; text-decoration: none; text-indent: -24pt; text-transform: none; vertical-align: baseline"><font color="#000000">  Create black and white, grayscale, and pseudo-color masks<br /></font></div>
+
[[Category:Help]]
 +
[[Category: Getting started]]

Latest revision as of 12:52, 11 March 2013

Introducing MIPAV

MIPAV

Imaging is essential to medical research and clinical practice. Biologists study cells and generate three-dimensional (3D) confocal microscopy datasets; virologists generate 3D reconstructions of viruses from micrographs. Radiologists identify and quantify tumors from Magnetic Resonance Imaging (MRI) and Computed Tomography (CT) scans.

Neuroscientists detect regional metabolic brain activity from Positron Emission Tomography (PET) and functional MRI (fMRI) scans. Analysis of these diverse image datasets require sophisticated quantification and visualization tools. Until recently, 3D visualization and quantitative analysis of an image dataset could only be performed on expensive UNIX workstations with customized software.

Because of technological advancements, medical image visualization and analysis can now be performed on an inexpensive desktop computer that is equipped with the appropriate software applications.

This Getting Started guide explains how to use one of these software applications: Image Processing, Analysis, and Visualization (MIPAV). Researchers use MIPAV to extract quantitative information from image datasets of various medical image modalities. The MIPAV application can run on virtually any platform, including Microsoft Windows, Solaris, and the Macintosh Operating System (Mac OS).

MIPAV installation program can be downloaded from MIPAV web site - http://mipav.cit.nih.gov

Platform independence

Much research at NIH requires the segmentation, quantification, and visualization of 2D, 3D, and 4D image datasets. Researchers analyze images of varied imaging modalities, such as microscopy, microarray data, X-ray, CT, MRI, fMRI, and PET. Factors such as personal preference, data requirements, software limitations, and precedent have led to a heterogeneous distribution of computer platforms, among which are personal computers executing Windows or Linux, Macintoshes, and workstations by SGI, Sun Microsystems, or Hewlett-Packard. To analyze an image dataset, researchers may use several software applications. If each software application is platform specific, researchers may need access to several platforms to analyze a single image dataset. This often reduces efficiency while simultaneously increasing lab costs. MIPAV has been designed to help researchers increase efficiency and reduce costs by providing them with a flexible tool that can operate on virtually any platform. Researchers can use MIPAV by itself or in concert with other image processing and visualization tools.


The MIPAV application is platform independent because it is written in Java, which is an object-oriented, interpreted, programming language that was developed by Sun Microsystems. Java source code is compiled into the bytecode, which is machine-level code that is compiled specifically for the Java Virtual Machine (JVM). There are versions of the Java VM for different platforms. The same program (bytecode) can run on any of those versions. If researchers run a Java program on a Windows platform, the bytecode is interpreted by the Java VM that has been specifically designed for the particular Windows platform. If the same program is run on a Solaris platform; the bytecode is then interpreted by the Java VM that was specifically designed for the Solaris platform.

Note: The correct version of the Java VM can be downloaded from the MIPAV web site http://mipav.cit.nih.gov along with the MIPAV installation program.

Understanding MIPAV capabilities

Supported image types

Before image dataset analysis and quantification can be performed, an application must be able to read and write image datasets in industry-standard formats. Conformance to accepted standards, such as DICOM, ensures compatibility with present and future applications and medical equipment. This protects researchers' investment in hardware and provides flexibility in reaching their goals.

MIPAV supports over 20 different industry-standard image formats including: DICOM, TIFF, Analyze, and RAW (a complete list appears in Supported formats). MIPAV reads and writes images in both big and little endian formats.

See also: Supported Formats.

Visualization of images

The visualization of datasets with two or more dimensions is an important aspect of image dataset analysis and research. The ability to visualize the orientation, locality, or progression (time) of structures in clinical and nonclinical datasets can be vital to researchers. Confocal microscopy, CT, and MRI are examples of imaging modalities that are comprised of multiple adjacent cross-sectional image datasets that can be combined to form a 3D volume dataset. MIPAV allows researchers to visualize datasets using a variety of presentation formats, including lightbox, triplanar, cine, and animate. Once researchers display the image dataset, they can adjust the lookup table (LUT), apply prepackaged pseudo-color LUTs to highlight structures of interest, control the magnification level, adjust the transfer function, and more.

Volume of interest (VOI) segmentation and analysis

Another significant research activity is the quantification of data from image datasets. Although the visualization of image data is important, the actual quantification of the data is typically required to evaluate the researchers' hypothesis. Researchers must be able to identify regions-of-interest (ROIs) and volumes of interest (VOIs).

Note: An ROI is used in the context of 2D image datasets. VOI usually describes the analysis of volume data for datasets with more than two dimensions. This document uses the term VOI to represent both ROI and VOI.

Image segmentation is the process of identifying connected regions of images as members of a common group. In the medical field, physicians must routinely identify (i.e., segment) structures in medical image datasets to facilitate the treatment of patients. For example, many researchers who study the brain are interested in the segmentation of gray matter, white matter, and cerebrospinal fluid in MR images. The quantification of important attributes, such as volume, of various tissue types enables researchers to better understand, diagnose, monitor, and treat neurobehavioral disorders.

There is a multitude of image dataset segmentation methods; the choice of segmentation algorithm depends on the image data type and task. Automatic segmentation methods are desirable because they require little user interaction, which is subject to operator error and subjectivity. However, in practice automatic methods sometimes fail and require manual VOI correction (adjustment of the boundary that identifies the region). In MIPAV, researchers have the choice to segment VOIs automatically, semi-automatically, and manually. Contours can be manually edited, grouped, and copied to other slices in the dataset. MIPAV also offers a variety of mask-generation methods. Researchers can manually paint a mask or use one or a combination of segmentation algorithms.

MIPAV also allows researchers to perform statistical calculations on masked and contoured VOIs. Statistical results can be saved to an ASCII text file and imported to another program, as needed.

Extensibility with Java plug-ins

A typical analysis and visualization application can be designed to meet a broad range of researcher requirements. Many components of image dataset processing, analysis, and visualization techniques are general and can be applied to many types of data. However, many datasets also require unique functionality to meet special requirements. MIPAV allows researchers, who have the programming resources, to add a customized Java plug-in to the application. To program a plug-in, researchers must have a strong understanding of the underlying structure of the application's software design.

The Developing Plugin Programs chapter offers the information on how to add and remove plug-ins from the MIPAV application. It also indicates the statements that must be included in the source code to allow the plug-in to interface properly with MIPAV. However, in-depth information is not included in this guide. If you need more information, check the MIPAV web site http://mipav.cit.nih.gov for the e-mail address for technical support.

See also: Developing new tools using the API.

Sampling of MIPAV's features

MIPAV provides ready-made, general-purpose tools that meet the majority of requirements of many researchers. Researchers can use MIPAV to perform a variety of tasks. The following list shows a sampling of the tasks that researchers can performed with the program. For more information, refer to the MIPAV web site: http://mipav.cit.nih.gov/documentation.php.

See also: