Difference between revisions of "Allocating Memory in MIPAV"

From MIPAV
Jump to: navigation, search
(testing)
m
 
(46 intermediate revisions by 2 users not shown)
Line 1: Line 1:
=Allocating memory in MIPAV=
+
When you run MIPAV for the first time you must specify the amount of memory that you would like to allocate, so that MIPAV can take the full advantage of the memory resources available in your machine. For more information about user permissions, memory limits, and memory usage in different operation systems, refer to: [[FAQ: Understanding Memory]].
  
When you run MIPAV for the first time you must specify the amount of memory that you would like to allocate, so that MIPAV can take the full advantage of the memory resources available in your machine.
+
'''Note:''' [[FAQ: Understanding Memory | MIPAV’s memory allocation]] is a program-level feature and it affects all users of a given MIPAV installation. You can only change the amount of allocated memory, if you are running MIPAV using an administrative account.  
  
<div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 18pt; margin-right: 0pt; margin-top: 6pt; text-align: left; text-decoration: none; text-indent: -18pt; text-transform: none; vertical-align: baseline"><font color="#000000">  1 Select Help &gt; Memory allocation in the MIPAV window. The Change JavaRuntime Memory Allocation dialog box opens. See Figure 3.<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 18pt; margin-right: 0pt; margin-top: 6pt; text-align: left; text-decoration: none; text-indent: -18pt; text-transform: none; vertical-align: baseline"><font color="#000000"> 
+
== To allocate memory when installing MIPAV ==
2 Change the maximum heap size number so that it reflects the maximum amount of memory that should be allocated. <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"> In a Microsoft Windows system, you can specify a maximum to 1.2 or 1.3 Gb. If additional memory is needed, MIPAV allocates it until the memory reaches the maximum heap size that you specify.<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 18pt; margin-right: 0pt; margin-top: 6pt; text-align: left; text-decoration: none; text-indent: -18pt; text-transform: none; vertical-align: baseline"><font color="#000000"> 
+
3 Click OK to close the dialog box.<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">
+
  
'''Figure 3. Change Java-Runtime Memory Allocation dialog box '''
+
Refer to [[FAQ: Understanding Memory]].
{|-
+
[[Image:ChangeMemoryAllocation.jpg|center]]
+
|}<br clear="all" /><br />
+
  
 +
== To monitor memory usage ==
 +
[[File:MemoryUsage.jpg|400px|thumb|right|The Memory Monitor dialog box]]
  
You must restart of MIPAV for the changes to take effect. To exit MIPAV, select File &gt; Exit. Then, restart the software.
+
When MIPAV performs a function, such as visualizing an image file, it uses memory. When the function completes (i.e., the visualized image closed), you can manually free the memory so it can be used for another function. The first step is to view how much memory is currently being used and to free needlessly reserved memory. Then, if necessary, you may need to allocate additional memory.
  
==== To allocate additional memory ====
+
=== To determine how much memory is currently being used by MIPAV ===
  
The first step is to view how much memory is currently being used and to free needlessly reserved memory. Then, if necessary, you may need to allocate additional memory.
+
<ol>
 +
<li>Select Help &raquo; Memory Usage in the MIPAV window. The Memory Monitor dialog box appears. </li>
 +
<li>The Memory Monitor dialog box shows how much memory is allocated and how much memory has been used. The vertical bar on the right of the window displays a pictorial representation of the ratio of allocated memory or amount of memory used. The chart shows the memory usage for the past 3 minutes and 45 seconds. The chart is updated every second.</li>
 +
<li>If you want to constantly monitor your memory resources, you can leave the Memory Monitor dialog box open on your desktop. Otherwise, close it. </li>
 +
</ol>
  
<div style="font-style: normal; margin-bottom: 6pt; margin-left: 0pt; margin-right: 0pt; margin-top: 14pt; 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">To determine how much memory is currently being used by MIPAV</font>'''</span><br /></font>'''</div><div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 18pt; margin-right: 0pt; margin-top: 6pt; text-align: left; text-decoration: none; text-indent: -18pt; text-transform: none; vertical-align: baseline"><font color="#000000">  1 Select Help &gt; Memory Usage in the MIPAV window. The Memory Monitor dialog box appears (Figure 4). <br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 18pt; margin-right: 0pt; margin-top: 6pt; text-align: left; text-decoration: none; text-indent: 0pt; text-transform: none; vertical-align: baseline"><font color="#000000"> When MIPAV performs a function, such as visualizing an image file, it uses memory. When the function completes (i.e., the visualized image closed), you can manually free the memory so it can be used for another function.<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 18pt; margin-right: 0pt; margin-top: 6pt; text-align: left; text-decoration: none; text-indent: 0pt; text-transform: none; vertical-align: baseline"><font color="#000000"> The Memory Monitor dialog box shows how much memory is allocated and how much memory has been used. The vertical bar on the right of the window displays a pictorial representation of the ratio of allocated memory or amount of memory used. The chart shows the memory usage for the past 3 minutes and 45 seconds. The chart is updated every second.<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 18pt; margin-right: 0pt; margin-top: 6pt; text-align: left; text-decoration: none; text-indent: 0pt; text-transform: none; vertical-align: baseline"><font color="#000000"> If you want to constantly monitor your memory resources, you can leave the Memory Monitor dialog box open on your desktop. Otherwise, close it. <br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 18pt; margin-right: 0pt; margin-top: 6pt; text-align: left; text-decoration: none; text-indent: -18pt; text-transform: none; vertical-align: baseline"><font color="#000000">  2 Click Free memory to free memory.<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">
+
To figure out how much memory you actually need, refer to [[FAQ: Understanding Memory#MemoryNeeded | How much memory does MIPAV require to run?]]
''' Figure 4. Memory Monitor dialog box'''<br />
+
  
<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"> <br clear="all" />
+
== To manually free memory ==
  
[[Image:MemoryMonitorDialogBox.jpg|center]]
+
[[File:GarbageCollector.jpg|frameless]] As Java-based programs run, they often leave old variables, objects, or constructors in memory. For instance, if you delineate a VOI, the coordinates of the contours may remain in memory even after you close the image. Java provides a method called the ''garbage collector'' (or ''memory recycling'') that automatically freeing objects that are no longer referenced by the program and clears all unnecessarily reserved memory. Generally, the software does this automatically when free memory becomes very limited. However, you can run the garbage collector at any time to free memory by clicking the Garbage Collector button on the main MIPAV window. You can also free memory in the Memory Monitor dialog box by clicking the Free Memory button.<br />
  
  
<br />
+
== To allocate additional memory ==
 +
[[File:MemoryAllocation.jpg|429px|thumb|right| The Change java-runtime Memory Allocation dialog box]]
  
If you need more memory, you can allocate virtual memory or disk swap space if there is free space on your hard drive. For instructions on how to do this, refer to the documentation for your system. If you cannot assign more virtual memory or disk swap space, you may need to install additional memory.
+
=== For Windows users: ===
  
<div style="font-style: normal; margin-bottom: 6pt; margin-left: 0pt; margin-right: 0pt; margin-top: 14pt; text-align: left; text-decoration: none; text-indent: 0pt; text-transform: none; vertical-align: baseline">'''<font color="#000000"> To manually free the memory<br /></font>'''</div>
+
<ol>
 +
<li> Select Help &raquo; Memory allocation in the MIPAV window. The Change JavaRuntime Memory Allocation dialog box opens.</li>
 +
<li>Change the maximum heap size number so that it reflects the maximum amount of memory that should be allocated. In a Microsoft Windows 32 system, you can specify a maximum of 1.3 Gb. </li>
 +
<li>Click OK to close the dialog box.</li>
 +
<li>Restart  MIPAV for the changes to take effect. To exit MIPAV, select File &raquo; Exit. Then, restart the software.</li>
 +
</ol>
  
As Java-based programs run, they often leave old variables, objects, or constructors in memory. For instance, if you delineate a VOI, the coordinates of the contours may remain in memory even after you close the image. Java provides a method called the <span style="font-weight: normal; text-decoration: none; text-transform: none; vertical-align: baseline">''<font color="#000000">garbage collector</font>''</span> (or <span style="font-weight: normal; text-decoration: none; text-transform: none; vertical-align: baseline">''<font color="#000000">memory recycling</font>''</span>) that automatically freeing objects that are no longer referenced by the program and clears all unnecessarily reserved memory. Generally, the software does this automatically when free memory becomes very limited. However, you can run the garbage collector at any time to free memory by clicking the Memory Usage button. Refer to Figure 5.
+
Now, when additional memory is needed, MIPAV allocates it until the memory reaches the maximum heap size that you specify.
  
<div style="font-style: normal; margin-bottom: 6pt; margin-left: 0pt; margin-right: 0pt; margin-top: 14pt; text-align: left; text-decoration: none; text-indent: 0pt; text-transform: none; vertical-align: baseline">'''<font color="#000000"> To allocate additional memory, <br /></font>'''</div>
+
=== For Linux users: ===
 +
Refer to [[FAQ: Understanding Memory]].
  
Repeat the steps described in "Allocating memory in MIPAV".
+
=== For Mac OS users: ===
 +
Refer to [[FAQ: Understanding Memory]].
  
<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">
 
'''Figure 5. Running the garbage collector to free the memory in MIPAV'''
 
[[Image:MemoryUsageBut.jpg]]
 
  
 +
=== If you need even more memory ===
  
<br />
+
You can allocate virtual memory or disk swap space if there is free space on your hard drive. For instructions on how to do this, refer to the documentation for your system. If you cannot assign more virtual memory or disk swap space, you may need to install additional memory.
  
== Opening and loading image files ==
+
=== Memory limitations ===
  
<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 displays images in windows, or frames, that you can move or arrange around the desktop (Figure 6). You can display as many image datasets as needed as long as your computer has enough allocated memory.<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> The amount of memory required depends on the number of image datasets that are open and the size of each image file. For more information, refer to "Managing memory resources".<br />
+
Refer to [[FAQ: Understanding Memory]].
  
You can either open or load an image file. When you <span style="font-weight: normal; text-decoration: none; text-transform: none; vertical-align: baseline">''<font color="#000000">open</font>''</span> an image file, MIPAV displays the image in a new image window. <span style="font-weight: normal; text-decoration: none; text-transform: none; vertical-align: baseline">''<font color="#000000">Loading</font>''</span> an image file imports the file into an image window in which another image file is open. In other words, two image files share a common image window.
 
  
==== Understanding image windows ====
+
=== For more information ===
 +
Refer to: [[FAQ: Understanding Memory]].
  
An <span style="font-weight: normal; text-decoration: none; text-transform: none; vertical-align: baseline">''<font color="#000000">image window</font>''</span> Figure 6 consists of a title bar and an image itself.
+
== See also: ==
 +
*[[Opening and loading image files]]
 +
*[[MIPAV toolbars]]
 +
*[[Displaying MIPAV Toolbars]]
 +
*[[Displaying images]]
  
'''Figure 6. An image window'''<br />
+
[[Category:Help]]
 
+
[[Category: Getting started]]
[[Image:QuickStart_ImageWindow.jpg|center]]
+
 
+
The title bar displays:
+
*the image file name, e.g. "3DHead";<br />
+
*the number of the current slice and the total number of slices in the dataset, e.g. 62/124;<br />
+
*the magnification level, e.g. M:1.0.<br />
+
*The number of the current slice is also shown in the lower left corner of the image.<br />
+
 
+
You can move an image window around your desktop by clicking the title bar and dragging the window to a new location.<br />
+
 
+
Sometimes, depending on the view, a toolbar or menu bar also appears in the image window. For example, the image window using the<span style="font-weight: normal; text-decoration: none; text-transform: none; vertical-align: baseline">''<font color="#000000"> light box view</font>''</span> contains a toolbar and menu bar. See also [["Displaying images using the lightbox view"]].
+
 
+
==== Image A and Image B ====
+
 
+
<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"> In MIPAV, the first image opened in an image window (see "Understanding image windows")") is referred to as <span style="font-weight: normal; text-decoration: none; text-transform: none; vertical-align: baseline">''<font color="#000000">Image A</font>''</span>. When you load, or import, a second image in the same window, MIPAV refers to the second image as <span style="font-weight: normal; text-decoration: none; text-transform: none; vertical-align: baseline">''<font color="#000000">Image B</font>''</span>. <br /></font></div>
+
 
+
=== Supported formats ===
+
 
+
You can use MIPAV to open or load files of a variety of medical and generic graphics and multimedia file formats. Table 1 lists the format, extension, and whether MIPAV can read or write files of a particular format. The <span style="font-weight: normal; text-decoration: none; text-transform: none; vertical-align: baseline">''<font color="#000000">extension</font>''</span>, which is the last few characters of a file name including the period, indicates the file format. For example, in the file name <span style="font-weight: normal; text-decoration: none; text-transform: none; vertical-align: baseline">''<font color="#000000">DOE255.ima</font>''</span>, the extension <span style="font-weight: normal; text-decoration: none; text-transform: none; vertical-align: baseline">''<font color="#000000">.ima</font>''</span> indicates that the file is stored in DICOM format. In the table, the Read column indicates that MIPAV can display image files of a particular format. When a file is read, it is stored in main memory so that MIPAV can access it. The Write column means that MIPAV can copy the data from the memory to a storage destination, such as your hard disk. In this context, <span style="font-weight: normal; text-decoration: none; text-transform: none; vertical-align: baseline">''<font color="#000000">write</font>''</span> is synonymous with <span style="font-weight: normal; text-decoration: none; text-transform: none; vertical-align: baseline">''<font color="#000000">save</font>''</span>.
+
 
+
<div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; 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"> For more information on file formats, the list of supported formats and other information, refer to Chapter 4 in the ''MIPAV User's Guide''.
+
 
+
====testing====
+
{| border="1" cellpadding="5"
+
|+  <div class="TableTitle">'''Table 1.File formats that MIPAV can read and write'''</div>
+
|- bgcolor="#CCCCCC"
+
!
+
File format
+
!
+
Extencion
+
!
+
Supports
+
!
+
Open
+
!
+
Save
+
!
+
Does not support
+
|-
+
|
+
AFNI
+
|
+
header HEAD, data BRIK
+
|
+
See [MIPAV_AppCSupportedFormats.html#1330966 "AFNI" ]
+
|
+
Y
+
|
+
Y[#1330166 <sup>1</sup>]
+
|
+
 
+
|-
+
|
+
[http://www.mayo.edu/bir/PDF/ANALYZE75.pdf Analyze ]
+
|
+
header HDR, data IMG
+
|
+
See [MIPAV_AppCSupportedFormats.html#1259280 "Analyze files" ]
+
|
+
Y
+
|
+
Y
+
|
+
TBD
+
|-
+
|
+
Apple Macintosh
+
|
+
PICT
+
|
+
TBD.
+
|
+
Y
+
|
+
Y
+
|
+
 
+
|-
+
|
+
ASCII text
+
|
+
TXT
+
|
+
MIPAV defined ascii text surface format. The text surface file records the triangle mesh vertices, normal and connectivity.
+
|
+
Y
+
|
+
Y
+
|
+
 
+
|-
+
|
+
Audio Video Interleave
+
|
+
AVI
+
|
+
Uncompressed RLE8
+
 
+
See [MIPAV_AppCSupportedFormats.html#1331497 "Audio Video Interleave (AVI) files" ]
+
|
+
Y
+
|
+
Y[#1330210 <sup>2</sup>]
+
|
+
TBD
+
|-
+
|
+
BFLOAT
+
|
+
BFLOAT
+
|
+
TBD.
+
|
+
Y
+
|
+
Y
+
|
+
 
+
|-
+
|
+
[http://imaging.mrc-cbu.cam.ac.uk/imaging/FormatBruker Bruker]
+
|
+
d3pro, reco, acqp, 2dseq
+
|
+
See [MIPAV_AppCSupportedFormats.html#1259300 "Bruker data format" ]
+
|
+
Y
+
|
+
Y
+
|
+
TBD
+
|-
+
|
+
Cheschire
+
|
+
IMC, IMG
+
|
+
TBD
+
|
+
Y
+
|
+
Y
+
|
+
TBD
+
|-
+
|
+
Cheschire Overlay
+
|
+
OLY
+
|
+
TBD
+
|
+
Y
+
|
+
N
+
|
+
 
+
|-
+
|
+
[http://www.leadtools.com/SDK/Raster/Formats/Raster-Format-DICOM.htm DICOM 2.0]
+
|
+
DCM, IMA
+
|
+
See [MIPAV_AppCSupportedFormats.html#1259305 "Digital Imaging and Communications in Medicine (DICOM) files" ]
+
|
+
Y
+
|
+
Y
+
|
+
TBD
+
|-
+
|
+
DM3
+
|
+
DM3
+
|
+
TBD
+
|
+
 
+
|
+
 
+
|
+
 
+
|-
+
|
+
[http://heasarc.gsfc.nasa.gov/docs/heasarc/fits.html FITS]
+
|
+
FTS
+
|
+
See [MIPAV_AppCSupportedFormats.html#1259307 "FITS" ]
+
|
+
Y
+
|
+
Y
+
|
+
TBD
+
|-
+
|
+
FreeSurfer surface
+
|
+
[http://wideman-one.com/gw/brain/fs/surfacefileformats.htm ASCII, ASC]
+
|
+
See [MIPAV_AppCSupportedFormats.html#1259310 "FreeSurfer image and surface files" ]
+
|
+
Y
+
|
+
Y
+
|
+
TBD
+
|-
+
|
+
FreeSurfer image
+
|
+
COR
+
|
+
INFO for the header file and NNN for each slice where NN is the number of the slice
+
|
+
Y
+
|
+
Y
+
|
+
TBD
+
|-
+
|
+
[http://www.dclunie.com/medical-image-faq/html/part3.html GE - Genesis 5X and LX]
+
|
+
SIG
+
|
+
See [MIPAV_AppCSupportedFormats.html#1259314 "GE - Genesis 5X and LX" ]
+
|
+
Y
+
|
+
Y
+
|
+
TBD
+
|-
+
|
+
GE Signa 4.x
+
|
+
GEDNO
+
|
+
TBD
+
|
+
Y
+
|
+
N
+
|
+
TBD
+
|-
+
|
+
[http://en.wikipedia.org/wiki/Image_Cytometry_Standard Image Cytometry Standard]
+
|
+
ICS,
+
 
+
IDS
+
|
+
See [MIPAV_AppCSupportedFormats.html#1259321 "ICS (Image Cytometry Standard)" ]
+
|
+
Y
+
|
+
Y
+
|
+
TBD
+
|-
+
|
+
[http://www.keston.com/Interfile/interfile.htm Interfile]
+
|
+
HDR
+
|
+
TBD
+
|
+
Y
+
|
+
Y
+
|
+
TBD
+
|-
+
|
+
Laser Scanning Microscope (Zeiss)
+
|
+
LSM
+
|
+
See [MIPAV_AppCSupportedFormats.html#1259334 "Laser Scanning Microscope (Zeiss)" ]
+
|
+
Y
+
|
+
N
+
|
+
TBD
+
|-
+
|
+
LIFF
+
|
+
LIFF
+
|
+
See [MIPAV_AppCSupportedFormats.html#1259338 "LIFF" ]
+
|
+
 
+
|
+
 
+
|
+
TBD
+
|-
+
|
+
Magnetron Vision
+
|
+
IMA
+
|
+
TBD
+
|
+
Y
+
|
+
Y
+
|
+
 
+
|-
+
|
+
MAP
+
|
+
MAP
+
|
+
TBD
+
|
+
Y
+
|
+
N
+
|
+
 
+
|-
+
|
+
Medical Image Network Common Data Form (including ROIs)
+
|
+
MNC
+
|
+
See [MIPAV_AppCSupportedFormats.html#1259341 "Medical Image NetCDF (MINC) files" ]
+
|
+
Y
+
|
+
Y
+
|
+
TBD
+
|-
+
|
+
MEDIVISION
+
|
+
BIN
+
|
+
TBD
+
|
+
Y
+
|
+
Y
+
|
+
TBD
+
|-
+
|
+
MetaMorph Stack
+
|
+
STK
+
|
+
TBD
+
|
+
Y
+
|
+
Y
+
|
+
TBD
+
|-
+
|
+
Medical Research Council
+
|
+
MRC
+
|
+
See [MIPAV_AppCSupportedFormats.html#1259345 "Medical Research Council (MRC)" ]
+
|
+
Y
+
|
+
Y
+
|
+
TBD
+
|-
+
|
+
MGH/MGZ volume format
+
|
+
MGH,
+
 
+
MGZ
+
|
+
MGH for uncompressed storage; MGZ or.MGH.GZ for compressed storage
+
|
+
Y
+
|
+
Y
+
|
+
TBD
+
|-
+
|
+
MICRO-CAT (LOG)
+
|
+
LOG,
+
 
+
CT
+
|
+
See [MIPAV_AppCSupportedFormats.html#1259347 "MICRO-CAT" ]
+
|
+
 
+
|
+
 
+
|
+
TBD
+
|-
+
|
+
MINC 1.0, 2.0
+
|
+
MNC
+
|
+
See [MIPAV_AppCSupportedFormats.html#1259341 "Medical Image NetCDF (MINC) files" ]
+
|
+
Y
+
|
+
Y
+
|
+
 
+
|-
+
| rowspan="1" colspan="6" |
+
MIPAV-specific file formats
+
|-
+
|
+
MIPAV LUT
+
|
+
LUT
+
|
+
See [MIPAV_AppCSupportedFormats.html#1259356 "MIPAV (LUT) files" ]
+
|
+
 
+
|
+
 
+
|
+
 
+
|-
+
|
+
MIPAV MTX
+
|
+
MTX
+
|
+
See [MIPAV_AppCSupportedFormats.html#1259359 "MIPAV (MTX) files" ]
+
|
+
 
+
|
+
 
+
|
+
 
+
|-
+
|
+
MIPAV PLT
+
|
+
PLT
+
|
+
See [MIPAV_AppCSupportedFormats.html#1259365 "MIPAV (PLT) files" ]
+
|
+
 
+
|
+
 
+
|
+
 
+
|-
+
|
+
MIPAV SUR
+
|
+
SUR
+
|
+
See [MIPAV_AppCSupportedFormats.html#1342166 "MIPAV (SUR) files" ]
+
|
+
 
+
|
+
 
+
|
+
 
+
|-
+
|
+
MIPAV TXT
+
|
+
TXT
+
|
+
See also [MIPAV_AppCSupportedFormats.html#1343221 "MIPAV text file format" on page 583]
+
|
+
 
+
|
+
 
+
|
+
 
+
|-
+
|
+
MIPAV VOI
+
|
+
VOI, XML
+
|
+
See [MIPAV_AppCSupportedFormats.html#1259371 "MIPAV (VOI) files" ]
+
|
+
 
+
|
+
 
+
|
+
 
+
|-
+
|
+
MIPAV XML
+
|
+
XML
+
|
+
Full support, see [MIPAV_AppCSupportedFormats.html#1259376 "MIPAV XML" ]
+
|
+
 
+
|
+
 
+
|
+
N/A
+
|-
+
| rowspan="1" colspan="6" |
+
End of MIPAV-specific file formats
+
|-
+
|
+
MRC
+
|
+
MRC
+
|
+
TBD
+
|
+
Y
+
|
+
Y
+
|
+
 
+
|-
+
|
+
Nearly Raw Raster Data (NRRD)
+
| rowspan="1" colspan="2" |
+
1 file with extension of.NRRD or 2 files with extension of.NHDR for header file and.RAW,.TXT,.HEX,.RAW.GZ, or.RAW.BZ2 for data file
+
|
+
Y
+
|
+
Y
+
|
+
 
+
|-
+
|
+
NIFTI
+
|
+
2 files with header HDR and data IMG; or a single file.NII
+
|
+
See [MIPAV_AppCSupportedFormats.html#1259382 "NIFTI" ]
+
|
+
Y
+
|
+
Y
+
|
+
 
+
|-
+
|
+
OSM
+
|
+
WU
+
|
+
TBD
+
|
+
 
+
|
+
 
+
|
+
 
+
|-
+
|
+
Optical Coherence Tomography
+
|
+
TMG
+
|
+
TBD
+
|
+
Y
+
|
+
Y
+
|
+
 
+
|-
+
|
+
Phillips
+
|
+
PAR and PARV2 for header files and REC and FREC for data files
+
|
+
PAR and PARV2 for header files and REC and FREC for data files
+
 
+
See [MIPAV_AppCSupportedFormats.html#1332108 "Phillips PAR/REC" ]
+
|
+
Y
+
|
+
Y
+
|
+
TBD
+
|-
+
|
+
PICT
+
|
+
PICT
+
|
+
Encoding of black and white images as bitmap mode PICTs. Encodes grayscale images from 2 to 8-bits as palette mode (PICT format does not have grayscale mode). Encodes palette images as palette mode PICTS, encodes other images as a 24-bit 3 component directed bits PICT.
+
 
+
Decoding of black and white and up to (and including) 32-bit color PICT images. Also supports the decoding of compressed PICT images.
+
|
+
Y
+
|
+
Y
+
|
+
N/A
+
|-
+
|
+
Polygon File Format or Stanford Triangle Format
+
|
+
PLY
+
|
+
See [MIPAV_AppCSupportedFormats.html#1342572 "Polygon File Format" on page 587]
+
|
+
Y
+
|
+
Y
+
|
+
 
+
|-
+
|
+
[http://en.wikipedia.org/wiki/QuickTime QuickTime]
+
|
+
QT
+
|
+
See [MIPAV_AppCSupportedFormats.html#1259408 "QuickTime-Apple" ]
+
|
+
Y
+
|
+
Y
+
|
+
TBD
+
|-
+
|
+
[http://en.wikipedia.org/wiki/RAW_image_forma RAW]
+
|
+
RAW
+
|
+
See [MIPAV_AppCSupportedFormats.html#1259413 "Raw data files" ]
+
|
+
Y
+
|
+
Y
+
|
+
TBD
+
|-
+
|
+
Siemens CT
+
|
+
 
+
|
+
Old Siemens Somatom CT format (DR3)
+
|
+
Y
+
|
+
Y
+
|
+
TBD
+
|-
+
|
+
[http://www.faqs.org/faqs/medical-image-faq/part4/ Siemens - Magnetom Vision]
+
|
+
IMA
+
|
+
See [MIPAV_AppCSupportedFormats.html#1259422 "Siemens - Magnetom Vision" ]
+
|
+
Y
+
|
+
Y
+
|
+
TBD
+
|-
+
|
+
Siemens MicroCAT
+
|
+
LOG, CT
+
|
+
See also [MIPAV_AppCSupportedFormats.html#1259347 "MICRO-CAT" ]
+
|
+
Y
+
|
+
Y
+
|
+
 
+
|-
+
|
+
SPM
+
|
+
SPM
+
|
+
TBD
+
|
+
Y
+
|
+
Y
+
|
+
 
+
|-
+
|
+
STL
+
|
+
STLA, STLB
+
|
+
See also [MIPAV_AppCSupportedFormats.html#1341589 "STL (ASCII and Binary)" on page 590]
+
|
+
Y
+
|
+
Y
+
|
+
 
+
|-
+
|
+
Truevision Graphics Adapter
+
|
+
[http://en.wikipedia.org/wiki/Truevision_TGA TGA, VST, VDA, ICB, TPIC]
+
|
+
Encodes index color images in an uncompressed TGA palette format; encodes other images in an uncompressed 24-bit TGA format.
+
 
+
Decodes black and white, palette, true color uncompressed images. Decodes 16-bit, 24-bit, and 32-bit true color variants (can include loading of alpha channel).
+
|
+
Y
+
|
+
Y
+
|
+
N/A
+
|-
+
|
+
Washington University OSM dataset Structure
+
|
+
WU
+
|
+
TBD
+
|
+
Y
+
|
+
Y
+
|
+
TBD
+
|-
+
| rowspan="1" colspan="6" |
+
Common raster file formats
+
|-
+
|
+
Adobe Photoshop
+
|
+
PSD
+
|
+
Encoding of bitmap, grayscale, RGB, and index mode images. Also supports the encoding of RLE compression for all image variants.
+
 
+
Decoding of Adobe Photoshop v 2.5 images (and above) with the following modes: bitmap, grayscale, palette, and RGB.
+
|
+
Y
+
|
+
Y
+
|
+
Alpha saving
+
|-
+
|
+
[http://www.aecom.yu.edu/aif/instructions/BioRad_instructions/formattradiance.htm BIORAD]
+
|
+
PIC
+
|
+
See [MIPAV_AppCSupportedFormats.html#1259296 "BIORAD" ]
+
|
+
Y
+
|
+
Y
+
|
+
TBD
+
|-
+
|
+
[http://webstyleguide.com/graphics/gifs.html Graphics Interchange File]
+
|
+
GIF
+
|
+
Decoding of interlaced images and images with a transparency information set. See also [MIPAV_AppCSupportedFormats.html#1259318 "Graphics Interchange Format (GIF) files" ]
+
|
+
Y
+
|
+
N
+
|
+
Encoding of a GIF file
+
 
+
Decoding of multiframe GIFs using the multiframe load mechanism
+
|-
+
|
+
Joint Photographics Experts Group
+
|
+
[http://www.scantips.com/basics9j.html JPEG, JPG, JFIF, JFI]
+
|
+
See [MIPAV_AppCSupportedFormats.html#1259331 "Joint Photographic Experts Group (JPEG/JFIF) files" ]
+
|
+
Y
+
|
+
Y
+
|
+
TBD
+
|-
+
|
+
Microsoft Windows Bitmap
+
|
+
BMP, DIB
+
| rowspan="3" colspan="1" |
+
Encoding of Index Color Model images as uncompressed BMP palette formats. Other Color Model images are encoded as uncompressed 24-bit BMP formatted files.
+
 
+
Decoding of BMP version 2.x through 4.x files. Also supports the encoding of OS/2 variant files. Supports the encoding of true color and palette images, as well as Run-Length Encoding 8 (RLE8) and RLE4 images. See [MIPAV_AppCSupportedFormats.html#1259350 "Microsoft Windows Bitmap (BMP) files" ]
+
|
+
Y
+
|
+
Y
+
|
+
Decoding of old versions of BMP files (prior to version 2.x)
+
|-
+
|
+
Microsoft Windows Cursor
+
|
+
CUR
+
|
+
Y
+
|
+
Y
+
|
+
 
+
|-
+
|
+
Microsoft Windows icon
+
|
+
ICO
+
|
+
Y
+
|
+
Y
+
|
+
 
+
|-
+
|
+
PC Paintbrush File Format
+
|
+
[http://www.fileformat.info/format/pcx/ PCX, DCX, PCC]
+
|
+
Encoding of PCX files including uncompressed and RLE-compressed support.
+
 
+
Full support for decoding of PCX files. See [MIPAV_AppCSupportedFormats.html#1259396 "PC Paintbrush (PCX) files" ]
+
|
+
Y
+
|
+
Y
+
|
+
N/A
+
|-
+
|
+
[http://en.wikipedia.org/wiki/PNG Portable Network Graphic Format ]
+
|
+
PNG
+
|
+
Encodes index images as palette PNG images. Also encodes grayscale formatted images (which include grayscale and direct color) with bit masks saved in grayscale file format. Direct color and RGB are encoded as RGB images with an alpha mask (if mask is available from the image). 16-bit depth images are truncated to 8-bit depth when the image is loaded.
+
 
+
Decoding of palette, grayscale, and true color images. Also supports the transparency chunk for palette based images.
+
|
+
Y
+
|
+
Y
+
|
+
Some extension chunks (such as ALPHA)
+
|-
+
|
+
Sun Raster
+
|
+
RS, RAS
+
|
+
Encodes 8-bit index color images with or without RLE compression or RGB format for other color models.
+
 
+
Decoding of 4, 8, 16, 24, and 32-bit images. Supports the decoding of the old, standard, byte encoded, RGB, TIFF, and IFF format type. See [MIPAV_AppCSupportedFormats.html#1259426 "Sun Raster (RS) files" ]
+
|
+
 
+
|
+
 
+
|
+
Decoding of RAW color map or experimental type images
+
|-
+
|
+
TARGA
+
|
+
TGA
+
|
+
See also [MIPAV_AppCSupportedFormats.html#1339888 "TARGA" on page 591]
+
|
+
Y
+
|
+
Y
+
|
+
 
+
|-
+
|
+
Tag Image File Format
+
|
+
TIF, TIFF
+
|
+
See also [MIPAV_AppCSupportedFormats.html#1259429 "Tag Image File Format (TIFF) files" ]
+
|
+
Y
+
|
+
Y
+
|
+
Tiled
+
|-
+
|
+
X BitMap
+
|
+
XBM
+
|
+
Encoding of 2-color XBM images.
+
 
+
Fully supports the decoding of XBM formatted files.
+
|
+
 
+
|
+
 
+
|
+
N/A
+
|-
+
|
+
X PixMap
+
|
+
XPM
+
|
+
Encoding of XPM palette images.
+
 
+
Fully supports the decoding of XPM formatted files.
+
|
+
Y
+
|
+
Y
+
|
+
Decoding of image files with 3 or more characters per pixel/voxel
+
|-
+
| rowspan="1" colspan="6" |
+
End of common raster file formats
+
|-
+
| rowspan="1" colspan="6" |
+
Surface description file formats
+
|-
+
|
+
ASCII text
+
|
+
TXT
+
|
+
 
+
|
+
Y
+
|
+
Y
+
|
+
 
+
|-
+
|
+
ASCII Poly
+
|
+
POLY
+
|
+
See also [MIPAV_AppCSupportedFormats.html#1340689 "POLY" ]
+
|
+
Y
+
|
+
Y
+
|
+
 
+
|-
+
|
+
ASCII PLY
+
|
+
PLY
+
|
+
See also [MIPAV_AppCSupportedFormats.html#1342572 "Polygon File Format" on page 587]
+
|
+
 
+
|
+
 
+
|
+
 
+
|-
+
|
+
ASCII STL
+
|
+
STL
+
|
+
See also [MIPAV_AppCSupportedFormats.html#1341589 "STL (ASCII and Binary)" ]
+
|
+
Y
+
|
+
Y
+
|
+
 
+
|-
+
|
+
Binary STL
+
|
+
STLB
+
|
+
See also [MIPAV_AppCSupportedFormats.html#1341589 "STL (ASCII and Binary)" ]
+
|
+
Y
+
|
+
Y
+
|
+
 
+
|-
+
|
+
Legacy VTK
+
|
+
VTK
+
|
+
See also [MIPAV_AppCSupportedFormats.html#1341644 "Legacy VTK" ]
+
|
+
Y
+
|
+
Y
+
|
+
 
+
|-
+
|
+
MIPAV TXT
+
|
+
TXT
+
|
+
See also [MIPAV_AppCSupportedFormats.html#1343221 "MIPAV text file format" on page 583]
+
|
+
Y
+
|
+
Y
+
|
+
 
+
|-
+
|
+
MIPAV surface files
+
|
+
SUR
+
|
+
See also [MIPAV_AppCSupportedFormats.html#1342166 "MIPAV (SUR) files" ]
+
|
+
Y
+
|
+
Y
+
|
+
 
+
|-
+
|
+
VRML
+
|
+
WRL
+
|
+
See also [MIPAV_AppCSupportedFormats.html#1341826 "VRML" ]
+
|
+
Y
+
|
+
Y
+
|
+
 
+
|-
+
|
+
VTK XML
+
|
+
VTP
+
|
+
See also [MIPAV_AppCSupportedFormats.html#1341809 "VTK XML surface" ]
+
|
+
Y
+
|
+
Y
+
|
+
 
+
|-
+
|
+
XML surface
+
|
+
XML
+
|
+
See also [MIPAV_AppCSupportedFormats.html#1343346 "XML surface" ]
+
|
+
Y
+
|
+
Y
+
|
+
 
+
|}
+
 
+
{|
+
|
+
<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"> [#1330167 <sup>1</sup>]MIPAV does not save extra information with the AFNI file. It only does the "bare minimum."<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"> [#1330214 <sup>2</sup>]AVIs are saved with encoding options: run-length, MPEG, MPEG-4, QuickTime. However, MIPAV requires the Java Media Framework, which is installed with MIPAV.<br /></font></div>
+
|}
+
 
+
==== Image Browser ====
+
 
+
<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"> <span style="font-style: normal; font-weight: normal; text-decoration: none; text-transform: none; vertical-align: baseline"><font color="#000000">
+
 
+
{| border="1" cellpadding="5"
+
|+
+
|-
+
| rowspan="1" colspan="2" |
+
You can select the image formats to display using the File &gt; Open Image(A) &gt; Image Browser menu. This opens the <span style="font-style: normal; text-decoration: none; text-transform: none; vertical-align: baseline">'''<font color="#000000">Choose Image Filter dialog box</font>'''</span>. In this dialog box, use the check boxes to select the image types which you would like to use in MIPAV.
+
| rowspan="2" colspan="1" |
+
<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"> <br clear="all" />{| align="center"
+
|
+
[[Image:ChooseImageFilter.jpg]]
+
|}<br clear="all" /><br /></font></div>
+
|-
+
|
+
Select All
+
|
+
Selects all image types.
+
|-
+
|
+
Clear
+
| rowspan="1" colspan="2" |
+
Removes selection.
+
|-
+
|
+
<span style="font-style: normal; text-decoration: none; text-transform: none; vertical-align: baseline">'''<font color="#000000">OK</font>'''</span>
+
| rowspan="1" colspan="2" |
+
Applies the image type selection to MIPAV.
+
|-
+
|
+
<span style="font-style: normal; text-decoration: none; text-transform: none; vertical-align: baseline">'''<font color="#000000">Cancel</font>'''</span>
+
| rowspan="1" colspan="2" |
+
Disregards any changes you made in this dialog box and closes the dialog box.
+
|-
+
| rowspan="1" colspan="3" |
+
<div style="font-style: normal; margin-bottom: 3pt; 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"> Figure 7. Choose Image Filter dialog box<br /></font>'''</div>
+
|}
+
 
+
</font></span><br /></font></div>
+
 
+
=== Opening image files ===
+
 
+
<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 <span style="font-style: normal; text-decoration: none; text-transform: none; vertical-align: baseline">'''<font color="#000000">Open Image A from disk</font>'''</span> menu allows you to open an image which is stored on your hard drive (or network drive).<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">
+
 
+
{| border="1" cellpadding="5"
+
|+ <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 8. FIle &gt; Open menu <br /></font>'''</div>
+
|-
+
|
+
<div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 0pt; margin-right: 0pt; margin-top: 1pt; text-align: left; text-decoration: none; text-indent: 0pt; text-transform: none; vertical-align: baseline"><font color="#000000"> <br clear="all" />{| align="center"
+
|
+
[[Image:MIPAV_QS_OpenFile.jpg]]
+
|}<br clear="all" /><br /></font></div>
+
|}
+
 
+
<br /></font></div><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 <span style="font-style: normal; text-decoration: none; text-transform: none; vertical-align: baseline">'''<font color="#000000">Open Image A </font>'''</span>menu ([MIPAV_QuickStart.html#2389196 Figure 8]) provides you with additional options such as to open a single image file, or image sequence, or Leica series images - the images that were taken on a Leica microscope. You can also call Create Blank Image to create a blank image (refer to [MIPAV_QuickStart.html#1046617 "Creating new images" on page 41]).<br /></font></div><div style="font-style: normal; margin-bottom: 6pt; margin-left: 0pt; margin-right: 0pt; margin-top: 14pt; text-align: left; text-decoration: none; text-indent: 0pt; text-transform: none; vertical-align: baseline">'''<font color="#000000"> To open an image file or multifiles <br /></font>'''</div>
+
 
+
An option on the Open Image dialog box ([MIPAV_QuickStart.html#2389196 Figure 8]), which appears after you select File &gt; Open Image(A), is <span style="font-style: normal; text-decoration: none; text-transform: none; vertical-align: baseline">'''<font color="#000000">Open as multifile</font>'''</span>. This option lets you open the image as a <span style="font-weight: normal; text-decoration: none; text-transform: none; vertical-align: baseline">''<font color="#000000">multifile</font>''</span>.
+
 
+
<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-weight: normal; text-decoration: none; text-transform: none; vertical-align: baseline">''<font color="#000000">Multifiles</font>''</span> are image datasets that are composed of multiple files.<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 18pt; margin-right: 0pt; margin-top: 6pt; text-align: left; text-decoration: none; text-indent: -18pt; text-transform: none; vertical-align: baseline"><font color="#000000">  1 Select File &gt; Open Image(A) from disk. The Open Image dialog box ([MIPAV_QuickStart.html#2614455 Figure 9]) opens.<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 18pt; margin-right: 0pt; margin-top: 6pt; text-align: left; text-decoration: none; text-indent: -18pt; text-transform: none; vertical-align: baseline"><font color="#000000">  2 Navigate to the directory where the file is stored. <br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 18pt; margin-right: 0pt; margin-top: 6pt; text-align: left; text-decoration: none; text-indent: -18pt; text-transform: none; vertical-align: baseline"><font color="#000000">  3 Select an image file.<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 18pt; margin-right: 0pt; margin-top: 6pt; text-align: left; text-decoration: none; text-indent: -18pt; text-transform: none; vertical-align: baseline"><font color="#000000">  4 To open the image file as a multifile, select the <span style="font-style: normal; text-decoration: none; text-transform: none; vertical-align: baseline">'''<font color="#000000">Open as multifile</font>'''</span> box.<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 18pt; margin-right: 0pt; margin-top: 6pt; text-align: left; text-decoration: none; text-indent: 0pt; text-transform: none; vertical-align: baseline"><font color="#000000"> The name of the image appears in File Name.<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">
+
 
+
{| border="1" cellpadding="5"
+
|+ <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 9. Open as Multifile option<br /></font>'''</div>
+
|-
+
|
+
<div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 0pt; margin-right: 0pt; margin-top: 1pt; text-align: left; text-decoration: none; text-indent: 0pt; text-transform: none; vertical-align: baseline"><font color="#000000"> <br clear="all" />{| align="center"
+
|
+
[[Image:OpenAsMultifile.jpg]]
+
|}<br clear="all" /><br /></font></div>
+
|}
+
 
+
<br /></font></div><div style="font-style: normal; margin-bottom: 6pt; margin-left: 0pt; margin-right: 0pt; margin-top: 14pt; text-align: left; text-decoration: none; text-indent: 0pt; text-transform: none; vertical-align: baseline">'''<font color="#000000"> If you can't find the image, <br /></font>'''</div>
+
 
+
check the files types listed in Files of Type (showing in [MIPAV_QuickStart.html#2614455 Figure 9]) near the bottom of the dialog box. If the file type you are looking for does not appear in Files of Type, select All Files or All.
+
 
+
<div style="font-style: normal; margin-bottom: 6pt; margin-left: 0pt; margin-right: 0pt; margin-top: 14pt; text-align: left; text-decoration: none; text-indent: 0pt; text-transform: none; vertical-align: baseline">'''<font color="#000000"> To form a 4D dataset in Analyze format, <br /></font>'''</div>
+
 
+
use <span style="font-style: normal; text-decoration: none; text-transform: none; vertical-align: baseline">'''<font color="#000000">Open as multifile</font>'''</span> to open a series of individual 3D Analyze, formatted, consecutively ordered images.For example, you can use Open as multifile to open an array of TIFF, JPEG, BMP, etc., files if their file names meet the following format: <span style="font-weight: normal; text-decoration: none; text-transform: none; vertical-align: baseline">''<font color="#000000">f</font>''</span><span style="font-weight: normal; text-decoration: none; text-transform: none; vertical-align: baseline">''<font color="#000000">oo</font>''</span>_001.<span style="font-weight: normal; text-decoration: none; text-transform: none; vertical-align: baseline">''<font color="#000000">tiff</font>''</span>, <span style="font-weight: normal; text-decoration: none; text-transform: none; vertical-align: baseline">''<font color="#000000">foo</font>''</span>_002.<span style="font-weight: normal; text-decoration: none; text-transform: none; vertical-align: baseline">''<font color="#000000">tiff</font>''</span>, <span style="font-weight: normal; text-decoration: none; text-transform: none; vertical-align: baseline">''<font color="#000000">foo</font>''</span>_003, etc. where <span style="font-weight: normal; text-decoration: none; text-transform: none; vertical-align: baseline">''<font color="#000000">foo</font>''</span> is the name of the file.
+
 
+
<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"> <br /></font></div>
+
 
+
=== MIPAV window ===
+
 
+
After the first image is opened, the MIPAV window changes. It includes more menus, the title bar displays more information, and tool bars appear. Because the MIPAV window is context sensitive, it displays or hides commands on the menus depending on the characteristics of the image file that is opened. If you opened a dataset file that contains more than one image, an <span style="font-weight: normal; text-decoration: none; text-transform: none; vertical-align: baseline">''<font color="#000000">image slice slider</font>''</span> also appears. Refer to [MIPAV_QuickStart.html#1020845 Figure 10].
+
 
+
<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">
+
 
+
{| border="1" cellpadding="5"
+
|+ <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 10. Expanded MIPAV window showing toolbars, image slider, and more menus after the first image is opened. See also [MIPAV_QuickStart.html#2693414 "MIPAV toolbars" on page 21]<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"> <br clear="all" />{| align="center"
+
|
+
[[Image:ExpandedMIPAVWindow.jpg]]
+
|}<br clear="all" /><br /></font></div>
+
|}
+
 
+
<br /></font></div>
+
 
+
If you prefer for MIPAV to use the style of Open and Save dialog boxes that are used by the operating system (e.g., Microsoft Windows, Unix, or Apple) on your computer, read the section on [MIPAV_QuickStart.html#1013570 "Using platform-specific Open and Save dialog boxes" on page 74].
+
 
+
=== Loading image files ===
+
 
+
<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"> When you <span style="font-weight: normal; text-decoration: none; text-transform: none; vertical-align: baseline">''<font color="#000000">load</font>''</span> an image file, MIPAV imports it into an existing image window. The loaded image shares the same window with another image file. Loading a file allows you to compare two datasets. <br /></font></div><div style="font-style: normal; margin-bottom: 6pt; margin-left: 0pt; margin-right: 0pt; margin-top: 14pt; text-align: left; text-decoration: none; text-indent: 0pt; text-transform: none; vertical-align: baseline">'''<font color="#000000"> To load an image file<br /></font>'''</div><div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 18pt; margin-right: 0pt; margin-top: 6pt; text-align: left; text-decoration: none; text-indent: -18pt; text-transform: none; vertical-align: baseline"><font color="#000000">  1 Open the first image by selecting File &gt; Open Image(A) from disk. The image appears in an image window. <br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 18pt; margin-right: 0pt; margin-top: 6pt; text-align: left; text-decoration: none; text-indent: -18pt; text-transform: none; vertical-align: baseline"><font color="#000000">  2 Select the title bar of the image window (in this case, the image that you just opened) in which you want to load another image. <br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 18pt; margin-right: 0pt; margin-top: 6pt; text-align: left; text-decoration: none; text-indent: -18pt; text-transform: none; vertical-align: baseline"><font color="#000000">  3 Select one of the following: <br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 36pt; margin-right: 0pt; margin-top: 6pt; text-align: left; text-decoration: none; text-indent: -12pt; 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">File &gt; Load Image (B) &gt; From Frame</font>'''</span> to load another image dataset from an already opened image dataset;<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 36pt; margin-right: 0pt; margin-top: 6pt; text-align: left; text-decoration: none; text-indent: -12pt; 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">File &gt; Load Image (B) &gt; From File</font>'''</span> to load another image dataset;<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 36pt; margin-right: 0pt; margin-top: 6pt; text-align: left; text-decoration: none; text-indent: -12pt; 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">File &gt; Load Image (B) &gt; Create a Blank Image </font>'''</span>to create a blank image.<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 18pt; margin-right: 0pt; margin-top: 6pt; text-align: left; text-decoration: none; text-indent: -18pt; text-transform: none; vertical-align: baseline"><font color="#000000">  4 If you chose Image (B) from File, the Open dialog box appears, see [MIPAV_QuickStart.html#2614455 Figure 9]. Select the image file you want to load, and click OK.<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 18pt; margin-right: 0pt; margin-top: 6pt; text-align: left; text-decoration: none; text-indent: 0pt; text-transform: none; vertical-align: baseline"><font color="#000000"> If MIPAV does not recognize the type of file based on its extension, the Choose Image Filter dialog box opens (see also [MIPAV_QuickStart.html#2697974 "Image Browser" on page 16]). Here, select the file type and click OK.<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 18pt; margin-right: 0pt; margin-top: 6pt; text-align: left; text-decoration: none; text-indent: 0pt; text-transform: none; vertical-align: baseline"><font color="#000000"> As the image file is loading, a pop-up window appears with the status. When the image file finishes loading, it appears in the image window. At this point, take note of several changes:<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 36pt; margin-right: 0pt; margin-top: 6pt; text-align: left; text-decoration: none; text-indent: -12pt; text-transform: none; vertical-align: baseline"><font color="#000000">  MIPAV pseudo-color was applied to the images in the image frame. The pseudo-color indicates that two images are loaded in the same image frame.<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 36pt; margin-right: 0pt; margin-top: 6pt; text-align: left; text-decoration: none; text-indent: -12pt; text-transform: none; vertical-align: baseline"><font color="#000000">  In the MIPAV window, the Active Image and Alphablending slider appears. The slider allows you to control which image is displayed in the foreground of the window. The image in the foreground is the <span style="font-weight: normal; text-decoration: none; text-transform: none; vertical-align: baseline">''<font color="#000000">active image</font>''</span>. You can adjust the translucency of the alpha channels in each image using the technique.<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 18pt; margin-right: 0pt; margin-top: 6pt; text-align: left; text-decoration: none; text-indent: -18pt; text-transform: none; vertical-align: baseline"><font color="#000000">  5 If you chose Image (B) from Frame, the Load Image onto &lt;file name&gt; ([MIPAV_QuickStart.html#2754711 Figure 11]) opens. Select one of the images in Set as Image (B), and then click OK. The image is loaded onto the first image file.<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> The abbreviations <span style="font-weight: normal; text-decoration: none; text-transform: none; vertical-align: baseline">''<font color="#000000">(A)</font>''</span> or <span style="font-weight: normal; text-decoration: none; text-transform: none; vertical-align: baseline">''<font color="#000000">(B)</font>''</span> appear after some commands. <span style="font-weight: normal; text-decoration: none; text-transform: none; vertical-align: baseline">''<font color="#000000">(A)</font>''</span>, which is the abbreviation for "Image A," indicates that the option is applied to the first image opened in an image window. <span style="font-weight: normal; text-decoration: none; text-transform: none; vertical-align: baseline">''<font color="#000000">(B)</font>''</span>, which is the abbreviation for "Image B," indicates that the option is applied to second image loaded in the image window. For example, if you select Close Image (B), MIPAV closes the second image (Image B) that was loaded in the image window.<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"> <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">
+
 
+
{| border="1" cellpadding="5"
+
|+ <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 11. After loading an Image B, the Active Image and Alphablending slider appears in the main MIPAV window. The slider allows you to control which image is displayed in the foreground of the window<br /></font>'''</div>
+
|-
+
|
+
<div style="font-style: normal; font-weight: normal; margin-bottom: 0pt; margin-left: 0pt; margin-right: 0pt; margin-top: 1pt; text-align: left; text-decoration: none; text-indent: 0pt; text-transform: none; vertical-align: baseline"><font color="#000000"> <br clear="all" />{| align="center"
+
|
+
[[Image:MIPAV_QuickStart181.gif]]
+
|}<br clear="all" /><br /></font></div>
+
|}
+
 
+
<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> MIPAV recognizes files types by the file extension. For example, if you select an image named "Smith.tiff", MIPAV tries to open the file as a TIFF file. If that image is actually a <span style="font-weight: normal; text-decoration: none; text-transform: none; vertical-align: baseline">''<font color="#000000">JPEG</font>''</span> file and mistakenly has the <span style="font-weight: normal; text-decoration: none; text-transform: none; vertical-align: baseline">''<font color="#000000">TIFF</font>''</span> extension, MIPAV fails to open the file.<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"> <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"> <br /></font></div>
+
 
+
[[MIPAV toolbars]]
+

Latest revision as of 18:38, 25 April 2012

When you run MIPAV for the first time you must specify the amount of memory that you would like to allocate, so that MIPAV can take the full advantage of the memory resources available in your machine. For more information about user permissions, memory limits, and memory usage in different operation systems, refer to: FAQ: Understanding Memory.

Note: MIPAV’s memory allocation is a program-level feature and it affects all users of a given MIPAV installation. You can only change the amount of allocated memory, if you are running MIPAV using an administrative account.

To allocate memory when installing MIPAV

Refer to FAQ: Understanding Memory.

To monitor memory usage

The Memory Monitor dialog box

When MIPAV performs a function, such as visualizing an image file, it uses memory. When the function completes (i.e., the visualized image closed), you can manually free the memory so it can be used for another function. The first step is to view how much memory is currently being used and to free needlessly reserved memory. Then, if necessary, you may need to allocate additional memory.

To determine how much memory is currently being used by MIPAV

  1. Select Help » Memory Usage in the MIPAV window. The Memory Monitor dialog box appears.
  2. The Memory Monitor dialog box shows how much memory is allocated and how much memory has been used. The vertical bar on the right of the window displays a pictorial representation of the ratio of allocated memory or amount of memory used. The chart shows the memory usage for the past 3 minutes and 45 seconds. The chart is updated every second.
  3. If you want to constantly monitor your memory resources, you can leave the Memory Monitor dialog box open on your desktop. Otherwise, close it.

To figure out how much memory you actually need, refer to How much memory does MIPAV require to run?

To manually free memory

GarbageCollector.jpg As Java-based programs run, they often leave old variables, objects, or constructors in memory. For instance, if you delineate a VOI, the coordinates of the contours may remain in memory even after you close the image. Java provides a method called the garbage collector (or memory recycling) that automatically freeing objects that are no longer referenced by the program and clears all unnecessarily reserved memory. Generally, the software does this automatically when free memory becomes very limited. However, you can run the garbage collector at any time to free memory by clicking the Garbage Collector button on the main MIPAV window. You can also free memory in the Memory Monitor dialog box by clicking the Free Memory button.


To allocate additional memory

The Change java-runtime Memory Allocation dialog box

For Windows users:

  1. Select Help » Memory allocation in the MIPAV window. The Change JavaRuntime Memory Allocation dialog box opens.
  2. Change the maximum heap size number so that it reflects the maximum amount of memory that should be allocated. In a Microsoft Windows 32 system, you can specify a maximum of 1.3 Gb.
  3. Click OK to close the dialog box.
  4. Restart MIPAV for the changes to take effect. To exit MIPAV, select File » Exit. Then, restart the software.

Now, when additional memory is needed, MIPAV allocates it until the memory reaches the maximum heap size that you specify.

For Linux users:

Refer to FAQ: Understanding Memory.

For Mac OS users:

Refer to FAQ: Understanding Memory.


If you need even more memory

You can allocate virtual memory or disk swap space if there is free space on your hard drive. For instructions on how to do this, refer to the documentation for your system. If you cannot assign more virtual memory or disk swap space, you may need to install additional memory.

Memory limitations

Refer to FAQ: Understanding Memory.


For more information

Refer to: FAQ: Understanding Memory.

See also: