This AUTHOR_DATASET_readme.txt file was generated on 2021-05-31 by NGUYEN Nho Gia Hien


GENERAL INFORMATION

1. Title of Dataset: Simulation of sheared granular layers activated by fluid pressurization

2. Author Information
	A. Principal Investigator Contact Information
		Name: NGUYEN Nho Gia Hien
		Institution: GeoRessources, University of Lorraine, France
		Email: nngiahien@gmail.com

	B. Associate or Co-investigator Contact Information
		Name: SCHOLTÈS Luc
		Institution: University of Clermont Auvergne, France
		Email: luc.scholtes@uca.fr

3. Date of data collection (single date, range, approximate date): Not Available

4. Geographic location of data collection: Not available

5. Information about funding sources that supported the collection of the data: French PIA project “Lorraine Université d’Excellence”, reference ANR-15-IDEX-04-LUE


SHARING/ACCESS INFORMATION

1. Licenses/restrictions placed on the data: not specified

2. Links to publications that cite or use the data: https://doi.org/10.1002/essoar.10506504.1

3. Links to other publicly accessible locations of the data: https://github.com/hiennguyen-risu/MicromechanicsOfFaults

4. Links/relationships to ancillary data sets: Not available

5. Was data derived from another source? No
	A. If yes, list source(s): --


DATA & FILE OVERVIEW

1. File List: 
	a. RawData.zip: containt the raw data generated by the numerical simulation
	b. script01_ShearTest_demo.py: first stage of the numerical test
	c. script02_Fluid_demo.py: second stage of the numerical test

2. Relationship between files, if important: RawData.zip is the result produced by the scripts. The user can run the two scripts to obtain their own dataset.

3. Additional related data collected that was not included in the current data package: Not Available

4. Are there multiple versions of the dataset? No
	A. If yes, name of file(s) that was updated: 
		i. Why was the file updated? --
		ii. When was the file updated? --


METHODOLOGICAL INFORMATION

1. Description of methods used for collection/generation of data: 
The raw data is generated from numerical simulation by executing two python scripts in YADE software (https://yade-dem.org).

2. Methods for processing the data: 
The two python scripts is run in YADE software.
The raw data can be processed under any capable data analysis tool, such as Python, Matlab, Excel.

3. Instrument- or software-specific information needed to interpret the data: 
The script should be run under the open source DEM software YADE, version 2019. The complete source code and guide are found at https://yade-dem.org

4. Standards and calibration information, if appropriate: Not available

5. Environmental/experimental conditions: Not available

6. Describe any quality-assurance procedures performed on the data: The scripts are executed repeatedly to ensure the reproductibility of the method.

7. People involved with sample collection, processing, analysis and/or submission: Not availalble


DATA-SPECIFIC INFORMATION FOR: RawData.zip

1. Number of variables: 43

2. Number of cases/rows: ~63000

3. Variable List: 
Ek: kinetic energy
Nc: number of contacts
contactStress(ii): contact stress calculated by Love-Weber method (Pa)
deltaT: numerical time step (s)
elE: elastic energy, check https://yade-dem.org for full description
epsilon(ii): strain calculation
height: height of the sample, also known as the distance between the two plates (mm)
iter: simulation iteration (dimensionless time)
k: stiffness
p: fluid pressure (Pa)
plDE: plastic dissipation energy
poroF: porosity given by the fluid engine
porosity: manually calculated porosity
shEE: shear elastic energy, check https://yade-dem.org for full description
stress_upWall(i): stress components calculated on the boundary
unbF: unbalanced force, useful for verifying the static regime of the sample, check https://yade-dem.org for full description
vPln: vertical velocity of the plate (mm/s)
vPlt: horizontal velocity of the plate (mm/s)
velFx: permeability rate of on x-axis
velFy: permeability rate of on y-axis
velFz: permeability rate of on z-axis
volume: volume of the sample calculated from the periodic cell and two plates
xW: slip displacement (mm)
zN: coordination number
zNr: mechanical coordination number

4. Missing data codes: 
Not available

5. Specialized formats or other abbreviations used: 
Not available