Difference between revisions of "Getting Started Quickly with MIPAV"

From MIPAV
Jump to: navigation, search
(Created page with '{| width="331" align="right" | [MIPAV_titleVolume1.html TOC ] | [MIPAV_Installing.html PREV ] | [MIPAV_ImageBasics.html [[Image:navnext...')
 
 
(92 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{| width="331" align="right"
+
== Getting Started Quickly with MIPAV ==
|
+
[[File:MipavSplash.gif|158px|thumb|right|MIPAV]]
[MIPAV_titleVolume1.html [[Image:navtoc.gif|TOC]] ]
+
|
+
[MIPAV_Installing.html [[Image:navprev.gif|PREV]] ]
+
|
+
[MIPAV_ImageBasics.html [[Image:navnext.gif|NEXT]] ]
+
|
+
[MIPAV_Glossary.html [[Image:navidx.gif|INDEX]] ]
+
|}
+
  
[[Image:wwplogo.gif|Put your logo here!]]
+
This [http://mipav.cit.nih.gov/wiki/index.php/Main_Page#Documentation MIPAV WIKI] provides information to help you get started quickly using MIPAV. It explains basic tasks, such as starting and ending the program, opening and loading images, creating new images, and saving and printing images. In addition, it discusses how to create volumes of interest (VOIs), how to compare images using alphablending, and how to customize the program.
  
----
+
Sample images to start with MIPAV can be found here [[Sample images]].
<blockquote><div style="font-style: normal; margin-bottom: 0pt; margin-left: 0pt; margin-right: 0pt; margin-top: 24pt; text-align: right; text-decoration: none; text-indent: 0pt; text-transform: none; vertical-align: baseline">'''<font color="#000000"> 2 <br /></font>'''</div><div style="font-style: normal; margin-bottom: 600pt; margin-left: 0pt; margin-right: 0pt; margin-top: 0pt; text-align: right; text-decoration: none; text-indent: 0pt; text-transform: none; vertical-align: baseline">'''<font color="#000000"> Getting Started Quickly with MIPAV<br /></font>'''</div><div style="font-style: normal; margin-bottom: 6pt; margin-left: 6pt; margin-right: 6pt; margin-top: 6pt; text-align: left; text-decoration: none; text-indent: 0pt; text-transform: none; vertical-align: baseline">'''<font color="#0023a9"> <span style="font-style: normal; text-decoration: none; text-transform: none; vertical-align: baseline">'''<font color="#0023a9">In this section. . .</font>'''</span><br /></font>'''</div><div style="font-style: normal; font-weight: normal; margin-bottom: 1pt; margin-left: 18pt; margin-right: 6pt; margin-top: 0pt; text-align: left; text-decoration: none; text-indent: -12pt; text-transform: none; vertical-align: baseline"><font color="#0023a9"> [MIPAV_QuickStart.html#2709123 "Starting MIPAV" on page 9]<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 1pt; margin-left: 18pt; margin-right: 6pt; margin-top: 0pt; text-align: left; text-decoration: none; text-indent: -12pt; text-transform: none; vertical-align: baseline"><font color="#0023a9"> [MIPAV_QuickStart.html#2605340 "Managing memory resources" on page 10]<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 1pt; margin-left: 18pt; margin-right: 6pt; margin-top: 0pt; text-align: left; text-decoration: none; text-indent: -12pt; text-transform: none; vertical-align: baseline"><font color="#0023a9"> [MIPAV_QuickStart.html#1009652 "Opening and loading image files" on page 13]<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 1pt; margin-left: 18pt; margin-right: 6pt; margin-top: 0pt; text-align: left; text-decoration: none; text-indent: -12pt; text-transform: none; vertical-align: baseline"><font color="#0023a9"> [MIPAV_QuickStart.html#1010837 "Selecting views" on page 25]<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 1pt; margin-left: 18pt; margin-right: 6pt; margin-top: 0pt; text-align: left; text-decoration: none; text-indent: -12pt; text-transform: none; vertical-align: baseline"><font color="#0023a9"> [MIPAV_QuickStart.html#1011097 "Adjusting magnification" on page 28]<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 1pt; margin-left: 18pt; margin-right: 6pt; margin-top: 0pt; text-align: left; text-decoration: none; text-indent: -12pt; text-transform: none; vertical-align: baseline"><font color="#0023a9"> [MIPAV_QuickStart.html#1011400 "Improving contrast, adding color, etc." on page 32]<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 1pt; margin-left: 18pt; margin-right: 6pt; margin-top: 0pt; text-align: left; text-decoration: none; text-indent: -12pt; text-transform: none; vertical-align: baseline"><font color="#0023a9"> [MIPAV_QuickStart.html#1011935 "Comparing images using alphablending" on page 40]<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 1pt; margin-left: 18pt; margin-right: 6pt; margin-top: 0pt; text-align: left; text-decoration: none; text-indent: -12pt; text-transform: none; vertical-align: baseline"><font color="#0023a9"> [MIPAV_QuickStart.html#1046617 "Creating new images" on page 41]<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 1pt; margin-left: 18pt; margin-right: 6pt; margin-top: 0pt; text-align: left; text-decoration: none; text-indent: -12pt; text-transform: none; vertical-align: baseline"><font color="#0023a9"> [MIPAV_QuickStart.html#1012110 "Delineating volumes of interest (VOIs)" on page 44]<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 1pt; margin-left: 18pt; margin-right: 6pt; margin-top: 0pt; text-align: left; text-decoration: none; text-indent: -12pt; text-transform: none; vertical-align: baseline"><font color="#0023a9"> [MIPAV_QuickStart.html#2666426 "Annotating images with text" on page 48]<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 1pt; margin-left: 18pt; margin-right: 6pt; margin-top: 0pt; text-align: left; text-decoration: none; text-indent: -12pt; text-transform: none; vertical-align: baseline"><font color="#0023a9"> [MIPAV_QuickStart.html#2212804 "Calculating VOI statistics" on page 50]<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 1pt; margin-left: 18pt; margin-right: 6pt; margin-top: 0pt; text-align: left; text-decoration: none; text-indent: -12pt; text-transform: none; vertical-align: baseline"><font color="#0023a9"> [MIPAV_QuickStart.html#1013028 "Modifying image resolutions" on page 59]<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 1pt; margin-left: 18pt; margin-right: 6pt; margin-top: 0pt; text-align: left; text-decoration: none; text-indent: -12pt; text-transform: none; vertical-align: baseline"><font color="#0023a9"> [MIPAV_QuickStart.html#1013075 "Generating graphs (intensity profiles)" on page 59]<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 1pt; margin-left: 18pt; margin-right: 6pt; margin-top: 0pt; text-align: left; text-decoration: none; text-indent: -12pt; text-transform: none; vertical-align: baseline"><font color="#0023a9"> [MIPAV_QuickStart.html#1691879 "Saving and printing images" on page 62]<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 1pt; margin-left: 18pt; margin-right: 6pt; margin-top: 0pt; text-align: left; text-decoration: none; text-indent: -12pt; text-transform: none; vertical-align: baseline"><font color="#0023a9"> [MIPAV_QuickStart.html#1013439 "Customizing MIPAV" on page 68]<br /></font></div><div style="font-style: normal; font-weight: normal; margin-bottom: 1pt; margin-left: 6pt; margin-right: 6pt; margin-top: 0pt; text-align: left; text-decoration: none; text-indent: 0pt; text-transform: none; vertical-align: baseline"><font color="#0023a9"> [MIPAV_QuickStart.html#1014458 "Quitting MIPAV" on page 84]<br /></font></div>
+
  
This chapter provides information to help you get started quickly using MIPAV. It explains basic tasks, such as starting and ending the program, opening and loading images, creating new images, and saving and printing images. In addition, it discusses how to create volumes of interest (VOIs), how to compare images using alphablending, and how to customize the program.
+
See also: [http://mipav.cit.nih.gov/pubwiki/index.php?title=MIPAV_change_list&oldid=39297 MIPAV change list].
 +
 
 +
=== [http://mipav.cit.nih.gov/wiki/index.php/Main_Page#Documentation Contents] ===
 +
*[[Introducing MIPAV]]
 +
*[[MIPAV mailing list]]
 +
*[[Installing mipav#MipavNews|Viewing MIPAV News and Updates]]
 +
*[[Supported Formats]]
 +
*[[FAQ: Understanding Image Basics#FilesExtensions | Image files supported by MIPAV]]
 +
*[[Installing mipav|Installing MIPAV]]
 +
*[[MIPAV system requirements]]
 +
*[[Installing mipav|Installing MIPAV]]
 +
*[[Installing mipav#MipavUpgrade|Upgrading MIPAV]]
 +
*[[Installing mipav#MipavUninstall|Uninstalling MIPAV]]
 +
*[[Quitting MIPAV]]
 +
*[[Allocating Memory in MIPAV]]
 +
*[[Opening and loading image files]]
 +
*[[MIPAV toolbars]]
 +
*[[Displaying MIPAV Toolbars]]
 +
*[[Displaying images]]
 +
*[[Modifying image resolutions]]
 +
*[[Changing Image Contrast]]
 +
*[[Creating new images]]
 +
*[[Saving and printing images]]
 +
*[[Delineating volumes of interest (VOIs)| Volumes of Interest]]
 +
*[[ImageJ | Working with ImageJ]]
 +
*[[Customizing MIPAV]]
 +
*[[Developing new tools using the API]]
 +
*[[Technical Support | Contacting MIPAV support]]
 +
 
 +
Back to [http://mipav.cit.nih.gov/wiki/index.php/Main_Page#Documentation MIPAV WIKI]
 +
<div id="StartingMIPAV"></div>
  
 
== Starting MIPAV ==
 
== Starting MIPAV ==
 
+
[[File:MIPAV_FirstAppear.jpg|450px|thumb|left|MIPAV: Main and Output windows]]
<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"> Starting MIPAV differs depending on your platform. To begin a MIPAV session, do the following:<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">
+
Starting MIPAV differs depending on your platform. To begin a MIPAV session, do the following:<br />
  
 
{| border="1" cellpadding="5"
 
{| border="1" cellpadding="5"
Line 30: Line 51:
 
|-
 
|-
 
|
 
|
<div class="CellBody">Windows 95, 98, 2000, NT, XP</div>
+
<div class="CellBody">Windows 95, 98, 2000, NT, XP, Vista</div>
 
|
 
|
 
<div class="CellBody">Select Start &gt; Programs &gt; mipav &gt; mipav.</div>
 
<div class="CellBody">Select Start &gt; Programs &gt; mipav &gt; mipav.</div>
Line 37: Line 58:
 
<div class="CellBody">Linux</div>
 
<div class="CellBody">Linux</div>
 
|
 
|
<div class="CellBody">Open a shell. Go to the directory where you downloaded the installer. At the prompt, type <span style="font-style: normal; text-decoration: none; text-transform: none; vertical-align: baseline">'''<font color="#000000">sh ./installMIPAV.bin</font>'''</span>. </div>
+
<div class="CellBody">Open a shell. Go to the directory where you installed MIPAV, or the location you choose for the MIPAV links. At the prompt, type <span style="font-style: normal; text-decoration: none; text-transform: none; vertical-align: baseline">'''<font color="#000000">./mipav</font>'''</span>. </div>
 
|-
 
|-
 
|
 
|
 
<div class="CellBody">Mac Operating System (OSX)</div>
 
<div class="CellBody">Mac Operating System (OSX)</div>
 
|
 
|
<div class="CellBody">Unzip the installer (StuffIt expander may open automatically). Double-click the installer icon on your desktop.</div>
+
<div class="CellBody">Unzip the installer. Double-click the installer icon on your desktop.</div>
 
|-
 
|-
 
|
 
|
Line 50: Line 71:
 
|}
 
|}
  
<br /></font></div>
 
  
Both the main Medical Image Processing, Analysis, &amp; Visualization (MIPAV) window and the Output window ([MIPAV_QuickStart.html#2605281 Figure 2]) appear on your desktop. You can access most of MIPAV's features from the main menu bar.
 
  
<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">
+
Both the main Medical Image Processing, Analysis, &amp; Visualization (MIPAV) window and the Output window appear on your desktop. You can access most of [[Introducing MIPAV | MIPAV's features]] from [[Customizing MIPAV | the main menu bar]].
 +
 
 +
<div id="MipavMainWindow"></div>
 +
=== Main and Output windows options===
  
 
{| border="1" cellpadding="5"
 
{| 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 2. MIPAV-Main and Output windows <br /></font>'''</div>
+
|+ '''The Output window menu options'''<br />
|-
+
| rowspan="1" colspan="2" |
+
<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:MIPAV_FirstAppear.jpg]]
+
|}<br clear="all" /><br /></font></div>
+
|-
+
| rowspan="1" colspan="2" |
+
<div class="CellBody">The Output window menu options</div>
+
|-
+
|
+
<div class="CellBody"><span style="font-style: normal; text-decoration: none; text-transform: none; vertical-align: baseline">'''<font color="#000000">File</font>'''</span></div>
+
|
+
<div class="CellBody"><span style="font-style: normal; text-decoration: none; text-transform: none; vertical-align: baseline">'''<font color="#000000">Save Messages</font>'''</span>-Saves all of the messages displayed on the currently open page (e.g., Global Data page, Data page, or Debug page). When you select this command, the Save dialog box opens.</div> <div class="CellBody"><span style="font-style: normal; text-decoration: none; text-transform: none; vertical-align: baseline">'''<font color="#000000">Add tab</font>'''</span>- Adds a new tab to the Output window. When you select this option, the Add Tab dialog box opens. In this dialog box, enter the name for the new tab and press OK.</div>
+
|-
+
| rowspan="4" colspan="1" |
+
<div class="CellBody"><span style="font-style: normal; text-decoration: none; text-transform: none; vertical-align: baseline">'''<font color="#000000">Edit</font>'''</span></div>
+
| rowspan="4" colspan="1" |
+
<div class="CellBody"><span style="font-style: normal; text-decoration: none; text-transform: none; vertical-align: baseline">'''<font color="#000000">Clear messages</font>'''</span>-Clears all of the messages that are displayed on the currently open page. Be sure that you want to use this command. There is no undo!</div> <div class="CellBody"><span style="font-style: normal; text-decoration: none; text-transform: none; vertical-align: baseline">'''<font color="#000000">Copy</font>'''</span>-Copies the selected text on the currently open page.</div> <div class="CellBody"><span style="font-style: normal; text-decoration: none; text-transform: none; vertical-align: baseline">'''<font color="#000000">Cut</font>'''</span>-Removes the selected text from the currently open page.</div> <div class="CellBody"><span style="font-style: normal; text-decoration: none; text-transform: none; vertical-align: baseline">'''<font color="#000000">Select All</font>'''</span>-Selects all of the text on the currently open page.</div>
+
|-
+
 
|-
 
|-
 +
|'''File'''||
 +
'''Save Messages'''-Saves all of the messages displayed on the currently open page (e.g., Global Data page, Data page, or Debug page). When you select this command, the Save dialog box opens.
 +
'''Add tab'''- Adds a new tab to the Output window. When you select this option, the Add Tab dialog box opens. In this dialog box, enter the name for the new tab and press OK.
 
|-
 
|-
 +
|'''Edit'''
 +
|'''Clear messages'''-Clears all of the messages that are displayed on the currently open page. Be sure that you want to use this command. There is no undo!
 +
'''Copy'''-Copies the selected text on the currently open page. <br />
 +
'''Cut'''-Removes the selected text from the currently open page. <br />
 +
'''Select All'''-Selects all of the text on the currently open page.<br />
 
|-
 
|-
 
| rowspan="1" colspan="2" |
 
| rowspan="1" colspan="2" |
<div class="CellBody">The Output window toolbar</div>
+
'''The Output window toolbar'''
 
|-
 
|-
 
|
 
|
Line 105: Line 115:
 
|-
 
|-
 
|
 
|
<div class="CellBody">Remove selected tab</div>
+
<div class="CellBody">'''Remove selected tab'''</div>
 
|
 
|
 
<div class="CellBody">Removes selected tab from the output window.</div>
 
<div class="CellBody">Removes selected tab from the output window.</div>
 
|-
 
|-
 
| rowspan="1" colspan="2" |
 
| rowspan="1" colspan="2" |
<div class="CellBody">The Output window default tabs</div>
+
<div class="CellBody">'''The Output window default tabs'''</div>
 
|-
 
|-
 
|
 
|
Line 123: Line 133:
 
|}
 
|}
  
<br /></font></div>
+
<br />
  
 
After starting MIPAV, you can open and load image files, create new images, access DICOM images, customize MIPAV, and end the session.
 
After starting MIPAV, you can open and load image files, create new images, access DICOM images, customize MIPAV, and end the session.
 +
 +
<div id="ManagingMemoryResources"></div>
  
 
== Managing memory resources ==
 
== Managing memory resources ==
  
<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<span style="font-style: normal; font-weight: normal; text-decoration: none; text-transform: none; vertical-align: baseline"><font color="#0000ff"> </font></span>requires at least 35 Mb of random access memory (RAM). Additional memory is needed to correctly display image files and to quantify the data. To determine the amount of additional memory needed, multiply the size of the image file that you want to display by 10. Thus, if an image file is 2 Mb, you must allocate an additional 20 Mb of RAM (in addition to the base of 35 Mb) for it to display correctly. Because memory requirements fluctuate depending on the size and number of image files open, it may be necessary to allocate additional memory during a session. <br /></font></div>
+
MIPAV requires at least 35 Mb of random access memory (RAM). Additional memory is needed to correctly display image files and to quantify the data. To determine the amount of additional memory needed, multiply the size of the image file that you want to display by 10. Thus, if an image file is 2 Mb, you must allocate an additional 20 Mb of RAM (in addition to the base of 35 Mb) for it to display correctly. Because memory requirements fluctuate depending on the size and number of image files open, it may be necessary to allocate additional memory during a session. Refer to [[FAQ: Understanding Memory]] for more examples on required memory calculations.
 +
 
 +
For more information, refer to: [[Allocating Memory in MIPAV]] and [[FAQ: Understanding Memory]].
 +
 
 +
== See also: ==
 +
*[[Sample images]]
 +
*[[Allocating Memory in MIPAV]]
 +
*[[Opening and loading image files]]
 +
*[[MIPAV toolbars]]
 +
*[[Displaying images]]
 +
*[[FAQ: Understanding Memory]]
 +
*[[FAQ: Customizing MIPAV]]
 +
*[[FAQ: Understanding Image Basics]]
 +
*[[FAQ: Understanding Changes in MIPAV]]
  
[[Allocating Memory in MIPAV]]
+
[[Category: Help]]
 +
[[Category: Getting started]]

Latest revision as of 14:33, 4 June 2015

Getting Started Quickly with MIPAV

MIPAV

This MIPAV WIKI provides information to help you get started quickly using MIPAV. It explains basic tasks, such as starting and ending the program, opening and loading images, creating new images, and saving and printing images. In addition, it discusses how to create volumes of interest (VOIs), how to compare images using alphablending, and how to customize the program.

Sample images to start with MIPAV can be found here Sample images.

See also: MIPAV change list.

Contents

Back to MIPAV WIKI

Starting MIPAV

MIPAV: Main and Output windows

Starting MIPAV differs depending on your platform. To begin a MIPAV session, do the following:

If your platform is . . .
Then . . .
Windows 95, 98, 2000, NT, XP, Vista
Select Start > Programs > mipav > mipav.
Linux
Open a shell. Go to the directory where you installed MIPAV, or the location you choose for the MIPAV links. At the prompt, type ./mipav.
Mac Operating System (OSX)
Unzip the installer. Double-click the installer icon on your desktop.
Unix OS (Sun Solaris, OS/2 Warp, and others
In a shell tool, command tool, or terminal window, go to the directory where you installed MIPAV. At the prompt, type
./mipav.


Both the main Medical Image Processing, Analysis, & Visualization (MIPAV) window and the Output window appear on your desktop. You can access most of MIPAV's features from the main menu bar.

Main and Output windows options

The Output window menu options
File

Save Messages-Saves all of the messages displayed on the currently open page (e.g., Global Data page, Data page, or Debug page). When you select this command, the Save dialog box opens. Add tab- Adds a new tab to the Output window. When you select this option, the Add Tab dialog box opens. In this dialog box, enter the name for the new tab and press OK.

Edit Clear messages-Clears all of the messages that are displayed on the currently open page. Be sure that you want to use this command. There is no undo!

Copy-Copies the selected text on the currently open page.
Cut-Removes the selected text from the currently open page.
Select All-Selects all of the text on the currently open page.

The Output window toolbar

Save Results
Saves all of the messages displayed on the currently open page. When you select this command, the Save dialog box opens.
Copy
Copies the selected text on the currently open page.
Paste
Pastes copied text into the currently open page at the cursor point.
Cut
Removes the selected text from the currently open page.
Remove selected tab
Removes selected tab from the output window.
The Output window default tabs
Data tab
Displays messages that apply to the currently active image.
Debug tab
Displays debugging information for the currently selected image.


After starting MIPAV, you can open and load image files, create new images, access DICOM images, customize MIPAV, and end the session.

Managing memory resources

MIPAV requires at least 35 Mb of random access memory (RAM). Additional memory is needed to correctly display image files and to quantify the data. To determine the amount of additional memory needed, multiply the size of the image file that you want to display by 10. Thus, if an image file is 2 Mb, you must allocate an additional 20 Mb of RAM (in addition to the base of 35 Mb) for it to display correctly. Because memory requirements fluctuate depending on the size and number of image files open, it may be necessary to allocate additional memory during a session. Refer to FAQ: Understanding Memory for more examples on required memory calculations.

For more information, refer to: Allocating Memory in MIPAV and FAQ: Understanding Memory.

See also: