The files contained within this folder are briefly described below. All files are related to
"An investigation into the minimum number of tissue groups required for 7T in-silico parallel
transmit electromagnetic safety simulations in the human head" (Matthijs H.S. de Buck, Peter
Jezzard, Hongbae Jeong, and Aaron T. Hess, 2020).

------------------------------------

*** Duke/Ella/Thelonious - Full model ***
These folder contain the following data for the simulation results for the full (=reference) model
for Duke, Ella, and Thelonious from the IT'IS database:
- Q-matrix for each voxel
- The corresponding voxel locations (in meters from the center, (x,y,z), using the Sim4Life coordinate system)
- Dielectric properties of all tissue types (e.g. the mapping in the case of clustered segmentation).

The dielectric properties ('cond_perm_dens mapping') consist of five columns, from left to right:
conductivity (S/m), rel. permittivity (eps_0), mass density (kg/L), clustered tissue name, original tissue name

*** Duke/Ella/Thelonious - 4 clusters plus air ***
The same as above, except the simulations which the data are generated from are carried out using
the clustered segmentation referred to as '4 clusters plus air' in the manuscript.

*** process_Q_matrices.py ***
A short Python script to import and process sets of Q-matrix and voxel location-files, as they can be
found in the folders described above. The script computes the overall maximum 10gSAR for all voxels in the
model (best on the eigenvalue decomposition of the matrices) and the CP-mode maximum 10gSAR in the model.

*** Coil Model ***
Contains the Sim4Life-based 8-channel pTx coil which was used for all simulations (and is also
required for running the python-based simulation pipeline).

*** Sim4Life simulations ***
The full Sim4Life simulation pipeline which was used for all simulations, with some required helper
files (64configs.xlsx, 64configs_angles.xlsx, database_tissues_names-dens-cond-perm-volume.txt)
which are required for the simulation pipeline. More detailed information on the pipeline is given
at the top of the .py-file. Note: this pipeline is designed to run within Sim4Life and using
models from the IT'IS database, so access to licenses for both is required to be able to run the 
script. In the presented form, it is set up to run simulations using the 4 clusters plus air model,
but it can easily be adapted to run simulations using the different segmentations discussed in
the paper.

*** Random pTx-configurations ***
This folder contains the 500 random, normalized (to the power = abs(config)**2 = 1) pTx
configurations used in the paper. The configurations are sorted by their resulting maximum
10gSAR in the original Duke model (lowest index = highest SAR).
The python script 'run_configs' is a helper file to import the 500 configs and compute their
SAR-values for a certain set of Q-matrices.

------------------------------------

For any questions or comments, please contact Matthijs de Buck (matthijs.debuck@ndcn.ox.ac.uk)