betti particles spheres

Fill a container with spheres of given sizes, touching neither each other nor the walls, for a DEM packed bed.

particles module Granted on request: see access and licensing.

Usage

betti particles spheres [flags] container out

Examples

betti particles spheres -radius 0.5 drum.stl bed.data
betti particles spheres -min-radius 0.3 -max-radius 0.8 -fraction 0.58 hopper.stl bed.csv
betti particles spheres -sizes 0.3:0.2,0.6:0.8 silo.stl bed.py

Formats, by the extension of out

.csv	CSV x,y,z,r: EDEM, Rocky and DEM-Engine imports
.data	LAMMPS and LIGGGHTS data file, atom_style sphere, for read_data
.py	Yade: the spheres, for O.bodies.append
.txt	x y z r, one sphere to a line
.vtp	VTK polydata of the sphere centers with their radii (ParaView)

Flags

Flag	Takes	Default	Meaning
-count	integer	none	the number of spheres, instead of `-fraction`
-density	number	`1`	density, for the masses in .data files
-fraction	number	`0.55`	the share of the container's volume to fill; random packings reach about 0.6
-iters	integer	`2000`	the most rounds of pushing spheres apart
-max-radius	length or number	none	the largest radius
-min-radius	length or number	none	with `-max-radius`: radii spread evenly between the two
-radius	length or number	none	one size of sphere, such as 0.5 or 1%
-seed	integer	none	seed for the random placement
-sizes	text	none	sizes by share of the spheres' volume, radius:share pairs, such as 0.3:0.2,0.5:0.8

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 spheres. Lengths are absolute, or a percentage of the part's bounding-box diagonal, as in -size 1%.