diff --git a/SFEM/README.md b/SFEM/README.md index 84ebb92dd849ba15b4da3addc22441551c653130..90fb2faef3a82f6fad88928b15626cb1730011fd 100644 --- a/SFEM/README.md +++ b/SFEM/README.md @@ -97,48 +97,16 @@ Instructions for Debian/Ubuntu based workstations are as follows. * [plotMC.py](./rnnRF/plotMC.py): vizualize the different force displacement curves of the MC simulations. * The script reads the simulations results saved in ```'rnnRF/results/RandField_And_GP_X.csv/'``` - - ### cellRF +* [80017_3_128.geo](./cellRF/80017_3_128.geo): geometry file of a lattice cell to be read by gmsh (www.gmsh.info). +* [80017_3_128.msh](./cellRF/80017_3_128.msh): mesh file of a lattice cell generated by gmsh (www.gmsh.info). +* [MaterialProperties.csv](./cellRF/MaterialProperties.csv) PA12 viscoelastic-viscoplastic properties, see [MOAMMM cell simulations](https://gitlab.uliege.be/moammm/moammmPublic/syntheticdata/sveresponses). +* [rve_solver.py](./cellRF/rve_solver.py): interface with cm3Libraries (http://www.ltas-cm3.ulg.ac.be/openSource.htm). +* [strainPath80017.csv](./cellRF/strainPath80017.csv): loading path applied on the cell, see [MOAMMM cell simulations](https://gitlab.uliege.be/moammm/moammmPublic/syntheticdata/sveresponses). +* [runthread.py](./cellRF/runthread.py): script to be run to simulate the cell loading case. Deterministic in this example. It requires cm3Libraries (http://www.ltas-cm3.ulg.ac.be/openSource.htm). -Loading paths are generated for three types of loadings: - -1. Random Walk paths with rate variant data points (RW). -2. Random Cyclic paths with rate variant data points (CR). -3. Random Cyclic paths with constant rate data points (CC). - -### rnnRF - -Random SVEs are generated for a selected lattice by varying either,the **strut radius** or the **volume fraction**. Geometrical parameters for lattices along with their description are as: - -| Parameter | Type | Description | -|:----------|:--------------:|:---------------------------------------------------------------------------------------| -| typeRand | String literal | Generation parameter for the selected lattice: 'a' for volume fraction, 'b' for radius | -| vf | List of floats | Bounds of volume fraction | -| rad | Int | Bounds for radius in mm | -| size | List of int | Bounds for cell size in mm. | -| cell_num | list if int | Periodicity of thr Cell. eg a 1x1x1 cell will be specified as [1, 1, 1] | - -### Material Properties - -A visco-elastic - visco-plastic constitutive model [^1] is adopted for data generation. 32 Material Parameters (Incorporating 8 Maxwell Branches) are identified using Bayesian Inference (BI) [^2] for polyamide 12 (PA-12) polymer. - -A realization of BI identified material properties, that are provides reliable numerical convergence is used for data generation. These Material parameters are specified in the last row of [PA.csv](./MaterialProperties/PA.csv) and can be selected using the following parameters: - -| Parameter | Type | Value | -|:----------|:--------------:|:------| -| mat | String literal | "PA" | -| mat_ver | Int | 6 | - -### Micro-Solver - -dG3D micro-solver routines for a macro cauchy continuum or strain gradient continuum can be selected by assigning ```solver``` the value of ```'rve_solver'``` or ```'HO_rve_solver'``` respectively. Furthermore if using higher order kinematics the ```HO``` flag must be set ```True```. - -### Storage Directories - -By default, the data is stored as specified in the [Structure of repository](#structure-of-repository). However these paths can be changed using ```load_dir``` and ```data_dir``` -## Data Generation +## Example of application Once the parameters are defined inside of the driver script, data can be generated. This process consists of three seperate steps: