morphoGen

Virtual microstructures for the mechanics and physics of materials.

morphoGen generates random and architected media from models of stochastic geometry, describes them exactly, measures them against theory, computes their properties up to their fracture, and tells how large a volume must be to represent them. A Python package, a command line and a graphical interface in the web browser; free software (GNU GPL v3 or later).

a Boolean model of spheres a Voronoi polycrystal the excursion of a Gaussian field fibres packed without overlap a lattice of struts a gyroid trabecular bone a pattern of reaction and diffusion

The steps of a study

Generate

40 models of random and architected media: Boolean models, packings, fibres, tessellations, Gaussian fields, dead leaves, automata and growths, lattices, foams, triply periodic surfaces, bio-inspired structures; periodic or not, combined, nested.

Describe exactly

A realization is a description (centres, axes, cells) with an implicit function for each phase: sections, surfaces and conforming meshes are cut from it at any resolution, not from voxels.

Measure

Fractions, specific surface, covariance, chords, tortuosity, percolation thresholds, stereology, textures…, each beside the closed form of its model when there is one.

Compute properties

Elastic, thermal, electrical, dielectric, magnetic and diffusive properties, their weak and strong couplings, harmonic regimes, waves, flow and sound: an FFT solver on voxels (CPU or GPU), finite elements on conforming meshes, extended finite elements.

Follow behaviours

Plasticity, crystal plasticity, viscoelasticity, hyperelasticity, damage and MFront laws along loading paths, in small or finite strains; macroscopic laws identified, reduced or learned from the responses.

Break

The phase field of fracture on voxel images, cohesive zones, cracks of any surface and front, ductile growth; contact, self-contact and friction; high-cycle fatigue.

Size the representative volume

The statistics of Kanit et al. (2003) for every property: the variance against the volume, the integral range, the volume and the number of realizations for a precision.

Design

Periodic cells optimized for their homogenized properties, compatible assemblies of building blocks, lattices with defects and their rigidity, holes shaped on their exact geometry, patterns after buckling.

Applications and tools

Architecture metal sheets

Localized laser treatments: the thermal cycles of the tracks, the phases they leave, the tensile test of the specimen, the path optimized for strength and ductility.

Crush and impact

Explicit dynamics with OpenRadioss: the crushing, tension, shear and impact of a morphology at the rates of crashes, shocks and drops.

Work your way

Python functions, configuration files run from the command line (in parallel, on clusters), or the forms of the graphical interface: the same computations, the same files.

Exchange

Meshes, images, behaviours and results for Abaqus and CalculiX, AMITEX_FFTP, MFront, Z-set, Gmsh, Neper, DAMASK, FEniCSx and ParaView.

A first study

A model, a realization, its voxels, a measure against theory and three apparent properties, in a second:

import morphogen as mg
from morphogen.homogenization import Material, homogenize

model = mg.models.BooleanSpheres(radius=1.0, volume_fraction=0.3)
micro = model.generate(mg.Domain.cube(8.0, periodic=True), seed=1)  # centres and radii
image = micro.voxelize(shape=32)  # 32³ voxels: phase 0 (matrix), phase 1 (spheres)
theory = model.theory()
print(mg.analysis.volume_fraction(image), theory["volume_fraction"])  # 0.29 for 0.3

phases = {
    0: Material(young=3.0, poisson=0.35, conductivity=0.2),  # a polymer: GPa, W/(m K)
    1: Material(young=70.0, poisson=0.22, conductivity=1.0),  # glass
}
properties = ["bulk_modulus", "shear_modulus", "conductivity"]
out = homogenize(image, phases, properties=properties)
print({name: result.value for name, result in out.items()})  # 5.89, 2.59 (GPa), 0.33

The same from a configuration file, or from forms:

morphogen template homogenization_spheres -o study.yaml  # an example to start from
morphogen run study.yaml                                 # realizations and properties
morphogen gui                                            # the interface, in the browser

Where to go next

To…

read

install morphoGen

Installation

learn it by a study

the tutorials: a whole study, the size of the representative volume, a rubber, exact geometry, isogeometric analysis, contact and damage, fracture, textures, the interface

go through the steps of a study

the user guide, a page for each step

get a quick answer

the recipes and the questions and troubles

know what is computed, and by which solver

the guide to the physics

start from an example

the gallery: a card per template, with its image and its configuration

find a key of a configuration or a command

the configuration reference

look up a function or a class

the API reference

read the formulas and how they are checked

the theory notes

check what a word means here

the glossary

see what changed

the change log