Size of the representative volume¶
How large must a volume be to represent a random medium? morphoGen answers with the statistical method of Kanit et al. (2003) and Dirrenberger et al. (2014): the variance of a property over realizations of several sizes follows the generalized scaling law D²(V) = K V^-γ, from which come the RVE sizes with confidence intervals, for a precision and a number of realizations, the discrepancy between boundary conditions and the isotropy. Realizations run in parallel on a workstation and as job arrays on clusters (parallel and cluster runs). The tutorial compares spheres, whose correlations are short, with fibres on Poisson lines, whose correlations never stop.
The method¶
Two methods: the ensemble method (realizations at several sizes) and the window method (sub-volumes of one large sample, or of any scalar field; the stiffness and conductivity tensors of the windows of one periodic realization, their mean mutual energies by FFT; tilings shifted around a periodic sample, their variances pooled within the tilings).
Statistics, per property and boundary condition: means and intervals, relative errors, fit of K and γ (free or imposed), RVE sizes and the number of objects (fibres, grains) they contain, bootstrap confidence intervals, discrepancy between conditions.
Every physical quantity: the scalar properties and tensors of each physics, the named results of the couplings and of the harmonic properties (
piezoelectric.e33,dynamic_stiffness.shear_loss_1,poroelastic.biot_coefficient), and the quantities of nonlinear loading paths (a stress at a time, the strength, the work of fracture).Reports in Markdown, LaTeX and JSON, with figures.
Results of other codes: the fit of external tables, e.g. apparent moduli computed with another FE/FFT code.
A study¶
The template rve_poisson_fibers_fe is the study of Dirrenberger et al. (2014) on fibres
on Poisson lines, by finite elements:
morphogen template rve_poisson_fibers_fe -o study.yaml # or rve_poisson_fibers (morphology)
morphogen run study.yaml
The run writes:
results.csv: one row per realization (measures and apparent properties);homogenization.csv: one row per realization, property and boundary condition;rve_report.md,rve_report.texandrve_report.json: for each property and condition, the statistics per size, K, γ (free and imposed), R², the RVE sizes for each (ε_rel, n) with confidence intervals, the discrepancy between conditions, the isotropy criteria and the bounds;when the homogenization computes the
stiffness, for each condition and size the mean stiffness C̄_ij and its compliance S_ij = C̄⁻¹ (the inverse of the mean C, not the mean of the inverses), each component ± 2 standard deviations, and the RVE size of each component (Voigt order 11 22 33 23 31 12, engineering shears): in the report, inrve_stiffness.csv(one row per condition and size:C11…C66,S11…S66,C11_std…) and inrve_stiffness_<bc>.png;figures per property.
To analyse apparent properties computed elsewhere (CSV with a volume column, one
row per realization; --group-by splits the rows by boundary condition):
morphogen fit fe_results.csv --property k_app mu_app --group-by bc --gamma 0.6667 \
--eps 0.01 0.05 --n 1 10 -o report/
Nonlinear responses are analysed in the same way: rve.properties may name quantities
of the curves of the loading paths, <path>.<quantity> at the end of the path or
<path>.<quantity>@<time> at the end of one of its steps (tension.S11@3: the stress
of the path tension at the time 3; also TS11 in finite strains, p, or the mean of
a phase, S11_1), followed by a boundary condition to keep only that one
(tension.S11@3.periodic). The template rve_crystal_plasticity_fft, after Yang et al.
(2019), compares the RVE sizes of the elastic moduli of a polycrystal with those of its
stress at 0.1, 0.3 and 1 % of a tension (crystal plasticity, nonlinear FFT solver):
morphogen template rve_crystal_plasticity_fft -o study.yaml && morphogen run study.yaml
morphogen fit out/rve_crystal_plasticity_fft --property tension.S11@3 # again, from the files
The template rve_multiphysics gives the RVE sizes of several physics at once.