This directory contains the data used in the paper "Thermomechanics of 
dense granular materials: a particle-scale perspective", by Matthew R. Kuhn

The directory and its subdirtories contain the following:
1) the OVAL software that was used to run the simulations (in directory DEM/)
2) the input files for running the simulations (in directory DEM/)
3) the raw output from the simulations (in directory DEM/Output/)
4) the Octave files (in directory Octave/) that was used to process the
raw data in the directory DEM/Output/. The Octave/Matlab output of processed
data is placed in the subdirectory Output/
5) the Octave/Matlab output of processed data (in directory Data/)
6) the Gnuplot files that are used to create the paper's plots
(in directory Gnuplot/).  The data for these plots are in the Data/ directory

The DEM simulations were run with the software "OVAL".  Although you
you can use DEMPLA to run the simultions, it is probably simpler to
run the standalone OVAL code.  The OVAL code is located in the "DEM/"
directory.  The executable file is built from the following two files:
  oval-0.7.300.f
  common-0.7.300

The instructions for using OVAL are basically the same as those for the
software DEMPLA.  A PDF file of DEMPLA instructions can be found in either
of these two locations: 
  https://faculty.up.edu/kuhn/oval/dempla_0_2_6.pdf  (more recent)
or
  https://github.com/mrkuhn53/dempla/tree/master  (pdf in the doc folder)

Compiling the standalone OVAL source code inside the "DEM/" folder, using the
gcc compiler "gfortran":
  cd DEM
  gfortran -O3 -mtune=native -o oval oval-0.7.300.f

The input files for running the monotonic constant-p simulation are located
in the "DEM/Input/" folder
  The RunFile (one long filename):
    CIDC_const_p_A_Prefix1_100kPa_kn_12000_mu0.50_DEquil_Template_Frict_0.25_DBumpies-10648-6-06-08-064-c_Frict_0.05_LRforce_-0.20e-4-Int10-1-Nevada-D50
  The StartFile (another long filename):
    DEquil_Template_Frict_0.25_DBumpies-10648-6-06-08-064-c_Frict_0.05_LRforce_-0.20e-4-Int10-1-Nevada-D50

The raw output files (types A, B, BB, etc) are described in the PDF 
instructions. The raw output files are contained in the directory DEM/Output

The folder "Octave" contains the Octave (Matlab) code for analyzing the 
raw data of the OVAL simulation to create files of processed data from the
monotonic constant-p DEM output

The folder "Gnuplot" contains the Gnuplot script file for the paper's
plots
