betti particles fill

Fill a solid with particles, or line its surface, for SPH and other particle methods.

particles module Granted on request: see access and licensing.

Usage

betti particles fill [flags] in out

Examples

betti particles fill -spacing 0.5 tank.stl fluid.vtp
betti particles fill -spacing 1% -layers 3 -pack tank.stl fluid.k
betti particles fill -spacing 0.5 -layers 3 -walls inside -no-fill hull.stl hull.inp
betti particles fill -spacing 2 -min-spacing 0.25 -pack wing.stl air.csv

Formats, by the extension of out

.csvCSV: x,y,z,kind,volume,mass,area,nx,ny,nz,layer,spacing
.inpAbaqus: *NODE and PC3D elements, in sets INSIDE, WALLS and SURFACE
.kLS-DYNA keywords: *NODE and *ELEMENT_SPH, part 1 inside, 2 walls, 3 surface
.plyPLY points, with the particles' data
.vtpVTK polydata (ParaView), with the particles' data
.xyzplain x y z

Flags

FlagTakesDefaultMeaning
-densitynumber1density, for the particles' masses
-gradingnumber0.5with -min-spacing: how much the spacing grows for each unit of distance from the surface
-latticetextcubichow particles are laid out: cubic, or hcp (hexagonal close packed)
-layersintegernonelayers of wall particles
-leveltextnonefill only up to this height in z, as a tank filled to a level
-min-spacinglength or numbernonevariable resolution: this spacing at the surface, coarser inward up to -spacing (cubic lattice)
-no-fillswitchoffleave the inside empty: walls or surface particles alone
-packswitchoffrelax the inside particles so that they lie evenly along curved walls
-pack-itersinteger100with -pack: relaxation steps
-spacinglength or numberrequireddistance between neighboring particles, such as 0.5 or 1%
-surfaceswitchoffalso put particles on the surface, each with its normal and area
-wallstextoutsidewhere the wall layers go: outside, around a container whose inside is fluid, or inside, along a body's surface

Output flags

FlagTakesDefaultMeaning
-jsonswitchoffprint the result as JSON
-qswitchoffprint nothing but errors
-vswitchoffalso show the stages of each step, and their times

This page is generated from betti help particles fill. Lengths are absolute, or a percentage of the part's bounding-box diagonal, as in -size 1%.