2018-08-21, Max Wiebicke -- max.wiebicke@tu-dresden.de
Explanation of the data for the DEM benchmarks

structure:
dem_data 
- there is a folder for both simulations, the monotonic and the cyclic one
- similar structure:
-- positions: positions and radii of the spheres at the chosen output states
-- fabric:    contact orientations and forces at the chosen output states
-- macroscopic_response: 
--- triax.plot-data.txt:      the stress-strain data
--- triax.state.txt:          the stress-strain data for the chosen output states - 
                              indications in the file names are the following: unloading: a2, b, a1, . reloading: a1, b, a2, .
                              as listed in the fabric_tensor_spam_cyclic.py file (located in the image_analysis_scripts directory)
- exclude_contacts_bc.py:     accounting for the periodic boundary conditions -- exclude the contacts on the boundary of the DEM assembly, as they'll not appear in the image
- fabric_tensor_spam-dem.py:  python script for calculating the fabric tensor and the scalar anisotropy

image_analysis_scripts
- 1-image_preparation.py:     python script for the first part of the image analysis -- image preparation, binarisation, segmentation + labelling
- 2-contact_orientations.py:  python script for the second part of the image analysis -- contact detection, local thresholding for the refinement of the list, contact orientation
- fabric_tensor_spam.py:      python script for calculating the fabric tensor and the scalar anisotropy
