Maverick/VirtualFamilyTxtToMhdCsv: Difference between revisions

From KitwarePublic
Jump to navigationJump to search
No edit summary
No edit summary
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
<h1><center><b>Maverick: VirtualFamilyTxtToMhdCsv</b></center></h1>
= Virtual Family =


For more information on the <b>Virtual Family</b>, please visit the IT'IS foundation website:
* [http://www.itis.ethz.ch/news-events/news/latest-news/ http://www.itis.ethz.ch/news-events/news/latest-news/]


= Introduction =
They have an outstanding collection of anatomical models that are available for scientific purposes:
* [http://www.itis.ethz.ch/services/anatomical-models/virtual-population/ http://www.itis.ethz.ch/services/anatomical-models/virtual-population/]


Use this program to import the Virtual Family's data into a format that can be read by Maverick and other ITK and VTK-based applications.
The models from the Virtual Population have been segmented based on the image data of volunteers.  Whole-body models that represent a broad range of ages, body shapes and sizes, and both genders are available.  The imaging resolution and segmentation details are excellent.  Users must agree to the terms and conditions to use those data, in order to respect the privacy of the volunteers.


The strength of this approach is that it creates the labelmap image file and the corresponding .csv (e.g., the tissue.csv file) that describes the values in the labelmap.
= Maverick =


== Background ==
[[Maverick]] and the application mentioned on this page is no longer available.   Interested people should contact the IT'IS foundation (above) for more information and consider the use of [http://www.slicer.org Slicer] for viewing medical images.
 
Each member of the virtual family is offered as a labelmap in multiple resolutions: 0.5mm,, 1mm, 2mm, and 5mm.  In addition to the raw data, a .txt file is associated with each image.  That .txt file lists certain information about the tissues present in the labelmap as well as the dimensions and spacing of the data.  This program converts the .txt files to associated .mhd and .csv files for Maverick applications.
 
== Operation ==
 
This utility program will convert a single .txt file from the virtual family to .mhd and .csv files that describe a labelmap and a tissue lookup table for that labelmap.
 
= Usage =
 
At this time this utility program is only available with a command-line interface.
 
Maverick/bin/VirtualFamilyTxtToMhdCsv <input.txt> <input.raw> <output.mhd> <output.csv>
 
The first argument is the path to the virtual family member's .txt file to be converted.
 
The second argument is the path to that member's raw labelmap data.  Note that the data will not be read or manipulated at this time.  The .mhd file created will merely point to it.  It is highly recommended that the .mhd, .txt, .raw, and .csv file be maintained in the same directory and moved in unison.
 
<em>Hint</em>: The .mhd files are text files.  Any text editor can be used to create or modify these files.    Additional MetaImage documentation is ONLINE.
 
= Use cases =
 
VirtualFamilyTxtToMhdCsv Duke_34y_v5_2mm.txt Duke_34y_v5_2mm.raw Duke.mhd Duke.csv
 
VirtualFamilyTxtToMhdCsv Ella_26y_V2_2mm.txt Ella_26y_V2_2mm.raw Ella.mhd Ella.csv
 
<em>WARNING</em> Maverick applications, in the current release, do not correctly process .mhd files. You must perform an additional step to convert these .mhd file into complete volumes that are stored as .mha files.  The imageMath command can perform that conversion:
 
imageMath Duke.mhd -W 3 Duke.mha
imageMath Ella.mhd -W 3 Ella.mha

Latest revision as of 13:48, 21 March 2012

Virtual Family

For more information on the Virtual Family, please visit the IT'IS foundation website:

They have an outstanding collection of anatomical models that are available for scientific purposes:

The models from the Virtual Population have been segmented based on the image data of volunteers. Whole-body models that represent a broad range of ages, body shapes and sizes, and both genders are available. The imaging resolution and segmentation details are excellent. Users must agree to the terms and conditions to use those data, in order to respect the privacy of the volunteers.

Maverick

Maverick and the application mentioned on this page is no longer available. Interested people should contact the IT'IS foundation (above) for more information and consider the use of Slicer for viewing medical images.

Retrieved from "https://public.kitware.com/Wiki/index.php?title=Maverick/VirtualFamilyTxtToMhdCsv&oldid=46344"