betti particles clump
Approximate a solid by overlapping spheres of varying size, for DEM.
particles module Granted on request: see access and licensing.
Usage
betti particles clump [flags] in outExamples
betti particles clump -spheres 20 grain.stl grain.txt
betti particles clump -method fill -min-radius 0.2 -max-radius 1 -coverage 0.9 grain.stl grain.molFormats, by the extension of out
| .csv | CSV x,y,z,r: Chrono DEM-Engine clump templates, EDEM and Rocky imports |
|---|---|
| .json | the spheres, mass properties and report |
| .mol | LAMMPS molecule file, with mass, center of mass and inertia, for fix rigid |
| .py | Yade: the spheres, mass and inertia, for O.bodies.appendClumped |
| .txt | x y z r, one sphere to a line: LIGGGHTS particletemplate/multisphere |
| .vtp | VTK polydata of the sphere centers with their radii, in place (ParaView) |
Flags
| Flag | Takes | Default | Meaning |
|---|---|---|---|
| -coverage | number | none | with medial or fill: stop once the spheres cover this share of the volume, such as 0.9 |
| -density | number | 1 | density, for the mass and inertia |
| -max-radius | length or number | none | the largest sphere; larger ones shrink to it |
| -method | text | medial | how spheres are chosen: medial (fewest spheres for the shape), fill (largest first, filling the volume), or surface (following the surface) |
| -min-radius | length or number | 1% | the smallest sphere, such as 0.5 or 1% |
| -spheres | integer | 20 | the most spheres |
| -tolerance | length or number | 2% | with surface: how far from a sphere the surface may be |
Output flags
| Flag | Takes | Default | Meaning |
|---|---|---|---|
| -json | switch | off | print the result as JSON |
| -q | switch | off | print nothing but errors |
| -v | switch | off | also show the stages of each step, and their times |
This page is generated from betti help particles clump. Lengths are absolute, or a percentage of the part's bounding-box diagonal, as in -size 1%.