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)

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.

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.

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.

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')