diff --git a/docs/source/images/AustinMan.png b/docs/source/images/AustinMan.png new file mode 100644 index 00000000..f2d0cb67 Binary files /dev/null and b/docs/source/images/AustinMan.png differ diff --git a/docs/source/images/AustinMan_head.png b/docs/source/images/AustinMan_head.png new file mode 100644 index 00000000..dfead7ca Binary files /dev/null and b/docs/source/images/AustinMan_head.png differ diff --git a/docs/source/user_libraries.rst b/docs/source/user_libraries.rst index dbbaab36..cc67d248 100644 --- a/docs/source/user_libraries.rst +++ b/docs/source/user_libraries.rst @@ -43,3 +43,63 @@ The antenna models can be accessed from within a block of Python code in your si :width: 600 px FDTD geometry mesh showing an antenna model similar to a MALA 1.2GHz antenna (skid removed for illustrative purposes). + + +AustinMan/Woman +=============== + +.. code-block:: python + + # This module is licensed under the Creative Commons Attribution-NonCommercial-NoDerivs 3.0 Unported License. + # To view a copy of this license, visit http://creativecommons.org/licenses/by-nc-nd/3.0/. + # + # Please use the attribution at http://web.corral.tacc.utexas.edu/AustinManEMVoxels/AustinMan/citing_the_model/index.html + +AustinMan and AustinWoman (http://bit.ly/AustinMan) are open source electromagnetic voxel models of the human body, which are developed by the Computational Electromagnetics Group (http://www.ece.utexas.edu/research/areas/electromagnetics-acoustics) at The University of Texas at Austin (http://www.utexas.edu). The models are based on data from the National Library of Medicine’s Visible Human Project (https://www.nlm.nih.gov/research/visible/visible_human.html). + +.. figure:: images/AustinMan_head.png + :width: 600 px + + FDTD geometry mesh showing the head of the AustinMan model. + +The AustinMan and AustinWoman models are not currently included in the user libraries sub-package, however they can be downloaded from http://bit.ly/AustinMan. + +The following whole body models are available. + +=========== ========== ================== +Model Resolution Dimensions (cells) +=========== ========== ================== +AustinMan 8x8x8mm^3 86x47x235 + 4x4x4mm^3 171x94x470 + 2x2x2mm^3 342x187x939 + 1x1x1mm^3 683x374x1877 +AustinWoman 8x8x8mm^3 86x47x217 + 4x4x4mm^3 171x94x433 + 2x2x2mm^3 342x187x865 + 1x1x1mm^3 +=========== ========== ================== + +To use the models with gprMax: + +* Download a HDF5 file (.h5) of AustinMan or AustinWoman at the resolution you wish to use. +* Download a text file of material descriptions for gprMax, either + + * `AustinManWoman_gprMax_materials.txt` for non-dispersive material properties at 900 MHz (http://niremf.ifac.cnr.it/tissprop/). + * `AustinManWoman_gprMax_materials_dispersive.txt` for dispersive material properties that feature a 3-pole Debye model (http://dx.doi.org/10.1109/LMWC.2011.2180371). Not all materials have a dispersive description. + +To insert either AustinMan or AustinWoman into a model use the `#geometry_objects_file`. For example, to insert a 2x2x2mm^3 AustinMan with the lower left corner 40mm from the origin of the domain, and using disperive material properties, use the command: + +.. code-block:: none + + #geometry_objects_file: 0.04 0.04 0.04 ../user_libs/AustinManWoman/AustinMan_v2.3_2x2x2.h5 ../user_libs/AustinManWoman/AustinManWoman_gprMax_materials_dispersive.txt + +For further information on the `#geometry_objects_file` see the section on object contruction commands in the :ref:`Input commands section `. + +.. figure:: images/AustinMan.png + :width: 600 px + + FDTD geometry mesh showing the AustinMan body model. + + + +