morphogen.rve

Statistical size of the representative volume element (RVE).

  • morphogen.rve.scaling: point variance, ensemble statistics, scaling law D_Z^2(V) = K V^-gamma, RVE volume and number of realizations, window method.

  • morphogen.rve.study: analysis of several properties and boundary conditions following Dirrenberger et al. (2014): intervals, relative errors, fitted and imposed exponents, RVE sizes with bootstrap intervals, isotropy, discrepancy between boundary conditions; the mean stiffness and compliance per volume of each boundary condition (TensorStatistics: Cbar, S = Cbar^-1, the standard deviation of each component, their RVE sizes).

  • morphogen.rve.windows: the window method for tensors, the stiffness and the conductivity of the windows of one periodic realization solved once per unit load by the FFT solver (WindowTensors: their mean mutual energies), and their statistics.

  • morphogen.rve.report: Markdown, LaTeX and JSON reports, figures, the table of the mean tensors per volume (rve_stiffness.csv).

Public names

  • ScalingLaw — D_Z^2(V) = K V^(-gamma), fitted in log-log coordinates.

  • Series — Realizations of a property (under one boundary condition) at several volumes.

  • SeriesAnalysis — Results of the analysis of one series (see the module documentation).

  • SizeStatistics — Ensemble statistics of a property for several sample sizes.

  • StudyOptions — Settings of the analysis.

  • StudyReport — Analyses of all the series of a study, with cross-series results, and the mean stiffness and compliance per volume of each boundary condition (tensors).

  • TensorStatistics — The mean stiffness and compliance per volume of the realizations of one boundary condition (see the module documentation), or of the windows of one realization (method="windows", morphogen.rve.windows); the conductivity and its resistivity likewise (property="conductivity_tensor").

  • WindowTensors — The tensors of the windows of one realization (see the module documentation).

  • analyze_series — Analysis of one series (statistics, fits, RVE sizes, isotropy, bootstrap).

  • analyze_statistics — Analysis of precomputed statistics (e.g. the window method; no bootstrap).

  • analyze_study — Analyse every series and compare the boundary conditions; tensors: the mean stiffness and compliance per volume (tensors_from_rows()) joining the report.

  • discrepancy — D(Z) = (Zmax - Zmin) / Zmin between boundary conditions, per volume (eq. 69).

  • ensemble_statistics — Group values by volume: mean and unbiased variance per size.

  • fit_scaling_law — Least-squares fit of log D^2 = log K - gamma log V (gamma free or imposed).

  • fit_statistics — The scaling law of the variance with the volume (fit_scaling_law()) fitted to the statistics of a study by size, gamma given or fitted, within volume_range.

  • is_tensor — Whether a property asked of a study names a tensor (TENSOR_PROPERTIES): stiffness or stiffness.<bc> (conductivity_tensor, conductivity_tensor.<bc>), whereas stiffness.<bc>.C44 is the series of one of its components.

  • point_variance — D_Z^2 = p (1 - p) (Z1 - Z0)^2 of a two-phase medium (p: fraction of phase 1).

  • point_variance_multiphase — D_Z^2 = sum_i P_i (Z_i - Zbar)^2 (Yang et al. 2019, eq. 19).

  • rve_table — RVE volume and edge for each pair (eps_rel, n): the edge of a cube, V^(1/3), or of a square of area V (dimension = 2), V^(1/2).

  • rve_volume_classic — V_RVE = 4 D_Z^2 A3 / (eps^2 Zbar^2 n) (Kanit et al. 2003).

  • series_from_rows — Series of a results table.

  • tensor_statistics — The mean stiffness and compliance per volume of realizations (TensorStatistics): tensors their apparent stiffnesses (k x 6 x 6, or k x 3 x 3 in the plane; Voigt order 11 22 33 23 31 12, engineering shears; or their conductivities, k x 3 x 3, prop="conductivity_tensor") at their volumes; options those of the study (gamma, range of the fits, precisions), its components analysed without bootstrap.

  • tensors_from_rows — The mean stiffness and compliance per volume (tensor_statistics()) of each boundary condition whose stiffness the rows of results hold, in the columns stiffness.<bc>.C11 … C66 of the runs (the upper triangle; C11 … C33 in the plane). properties: the tensors kept, stiffness or stiffness.<bc> (None: all).

  • window_statistics — Window method: statistics of the mean over non-overlapping cubic sub-volumes.

  • window_tensors — The tensors of the windows of a periodic voxel image (see the module documentation): property stiffness (six unit strains; three in the plane of a planar image) or conductivity_tensor (three unit gradients), solved once each by the FFT solver (tol, maxiter, device; crystals turned by the orientations of their grains, see make_problem()), then averaged over the windows of each edge of window_sizes (voxels): of the tiling from the origin, or with shifts > 1 of the tilings shifted by k w // shifts voxels along each axis (k < shifts, all their combinations, wrapping around the image), from the same solutions. WindowTensors.statistics() gives their statistics per size.

Modules