Skip to content

Latest commit

 

History

History
65 lines (52 loc) · 6.66 KB

Readme.md

File metadata and controls

65 lines (52 loc) · 6.66 KB
Raw

Voxel Model Phantoms

There are 2 main sources for the models in this project.

  1. AustinMan & AustinWoman: The University of Texas: AustinMan and AustinWoman
  2. Alvar: Aalto University https://version.aalto.fi/gitlab/ilaakso/alvar
  3. Taro & Hanako: NICT Biomedical EMC https://bioemc.net/bio/en-data-offer/?page_id=27
  4. All others: Helmholtz Zentrum München Virtual Human Database (not available anymore)

List of all available Phantoms

The following table gives an overview over the properties of the different models. The upper 12 are available from the Helmholtz Zentrum München and the last two from the University of Texas.

Name Import Available Sex Age Size (cm) Weight (kg) Resolution
Baby ✖️ W 8w 57 4.2
Child ✖️ W 7 115 21.7
Jo ✖️ W 8 130 34
Helga ✔️ W 26 170 81 $(0.98\cdot 0.98\cdot 10)mm^3 $
Irene ✔️ W 32 163 51 $ (1.875\cdot 1.875\cdot 5)mm^3$
VisibleHuman ✔️ M 38 180 103 $(0.91 \cdot 0.94 \cdot 5) mm^3$
Golem (only Small Intestine labeled, w/o the contents) ✔️ M 38 176 69 $(2.08 \cdot 2.08 \cdot 8) mm^3$
Donna ✔️ W 40 170 70 $(1.875 \cdot 1.875 \cdot 10) mm^3$
Frank 1 ✔️ M 48 n.A. n.A. $ (0.742188\cdot 0.742188\cdot 5)mm^3$ 3D Model not complete.
Katja 2 ✔️ W n.A. n.A. n.A. $ (1.775\cdot 1.775\cdot 4.84)mm^3$
ADAM ✖️ M n.A. n.A. n.A. $(1.6 \cdot 1.6\cdot 2)mm^3$
EVA ✖️ W n.A. n.A. n.A.
AustinMan ✔️ ✔️ ✖️ ✖️ M 38 180 106.2 $(1\cdot 1\cdot 1)mm^3, (2\cdot 2\cdot 2)mm^3, (4\cdot 4\cdot 4)mm^3, (8\cdot 8\cdot 8)mm^3$
AustinWoman ✔️ ✔️ ✖️ ✖️ W 59 173 84.8 $(1\cdot 1\cdot 1)mm^3, (2\cdot 2\cdot 2)mm^3, (4\cdot 4\cdot 4)mm^3, (8\cdot 8\cdot 8)mm^3$
Alvar ✔️ M - 176 72 $(0.512\cdot 0.512\cdot 0.512)mm^3$
Taro ✔️ M 22 173 65 $(2\cdot 2\cdot 2)mm^3$
Hanako ✔️ W 22 160 53 $(2\cdot 2\cdot 2)mm^3$

Import and Usage of Voxel Model Phantoms

For all Phantoms with a ✔️ in the column "Import Available" a script ImportXY.py can be found in this folder. Only the path to the actual model needs to be replaced by the respective location of the (unzipped) model, e.g. from the Virtual Human Database or the AustinMan/Woman website.

Import

  1. Download the desired voxel model and unzip it, e.g. Donna.
  2. Change the path in the corresponding import script.
  3. Run the import script, e.g. python ImportDonna.py. This may take some time, especially the generation of the 3D surface.
  4. Copy the resulting file, e.g. Donna.VoxelModel, to a known folder

After importing all the models, the possible receiver locations on the abdominal surface need to be added. This is done by running add_receiver_locations_clustering.py. This script will automatically determine the possible receiver locations on the abdominal surface and cluster them to 16 clusters. Before running that script the working_directory of the VoxelModel needs to be set as explained below.

Usage

To use the VoxelModel, before any model can be loaded the working directory needs to be set. The following example shows the basic usage:

import os

from LayerModel_lib import VoxelModel
VoxelModel.working_directory = os.path.join('..', 'Phantoms')

# load the voxel model of Donna 
vm = VoxelModel('Donna')

Footnotes

  1. The model Frank is not complete in the transverse plane i.e., parts of the abdomen are cut off. ↩

  2. Katja is pregnant and for some reason the fat tissue is labeled as body fluid. ↩