Recognition: unknown
multisphere: a Python implementation of the Multi Sphere Shape generator (MSS) for DEM simulations
Pith reviewed 2026-05-10 00:51 UTC · model grok-4.3
The pith
multisphere is a Python package that converts triangulated meshes and voxel volumes into sets of intersecting spheres for DEM particle simulations.
A machine-rendered reading of the paper's core claim, the machinery that carries it, and where it could break.
Core claim
The package implements the Multi Sphere Shape generator to approximate arbitrary particle shapes by placing and overlapping spheres so that their union matches a given triangulated surface mesh or voxelized volume, while also offering built-in tools to assess the quality of the approximation, visualize the result, and export the sphere data for use in DEM codes.
What carries the argument
The multi-sphere reconstruction routine that places intersecting spheres to match input geometry from meshes or voxels.
If this is right
- Users can import existing triangulated particle models directly into DEM workflows.
- Voxel-based particle descriptions from imaging can be turned into sphere clusters without additional coding.
- Evaluation and visualization tools allow quick checking of how well the spheres fill the original volume.
- Export functions let the sphere sets be loaded into standard DEM software packages.
Where Pith is reading between the lines
- Wider adoption could reduce the barrier to simulating non-spherical particles in granular flow studies.
- The open-source release invites community extensions such as new input formats or optimization criteria for sphere placement.
- Integration with existing DEM frameworks might become a standard preprocessing step for irregular grains.
Load-bearing premise
That the sphere clusters produced will be accurate enough in both geometry and dynamics to be useful in actual DEM simulations.
What would settle it
A side-by-side DEM run comparing the motion or collision outcomes of the generated multi-sphere particles against either the original mesh-based particles or an independent reference method, revealing large discrepancies in macroscopic behavior.
Figures
read the original abstract
multisphere is an open-source Python package for generating multi-sphere representations of complex particles for use in DEM simulations. It reconstructs triangulated surface meshes and voxelized volumes as sets of intersecting spheres and provides tools for evaluation, visualization, and export.
Editorial analysis
A structured set of objections, weighed in public.
Referee Report
Summary. The manuscript describes 'multisphere', an open-source Python package implementing the Multi Sphere Shape generator (MSS) for DEM simulations. It converts triangulated surface meshes and voxelized volumes into sets of intersecting spheres, and supplies accompanying tools for evaluation, visualization, and export to common DEM formats.
Significance. If the implementation is reliable, the package addresses a recurring practical need in the DEM community: rapid generation of multi-sphere approximations for non-spherical particles. Open-source release with evaluation utilities is a clear strength that can support reproducibility and community adoption.
major comments (1)
- Abstract and §2 (Implementation): the central claim that the package 'reconstructs' meshes and voxels as sphere sets is not accompanied by any error metrics, overlap-volume statistics, or comparison against reference methods or ground-truth particle shapes. Without such quantitative validation the functionality claim cannot be assessed.
minor comments (2)
- The manuscript would benefit from a short table or figure showing runtime and sphere-count scaling for a few benchmark meshes/voxels of varying complexity.
- Add explicit citation of the original MSS algorithm paper and at least two other open multi-sphere generators to place the contribution in context.
Simulated Author's Rebuttal
We thank the referee for their constructive feedback and positive evaluation of the package's potential utility in the DEM community. We address the major comment point by point below.
read point-by-point responses
-
Referee: Abstract and §2 (Implementation): the central claim that the package 'reconstructs' meshes and voxels as sphere sets is not accompanied by any error metrics, overlap-volume statistics, or comparison against reference methods or ground-truth particle shapes. Without such quantitative validation the functionality claim cannot be assessed.
Authors: We agree that the current manuscript does not present quantitative error metrics, overlap statistics, or direct comparisons, which limits the ability to assess reconstruction fidelity from the text alone. The manuscript's emphasis is on documenting the open-source implementation of the established MSS algorithm together with user-facing evaluation and export utilities. In the revised version we will add a dedicated validation subsection (likely within §2 or as a new §3) that reports concrete metrics for representative test cases, including volume overlap fractions, surface deviation measures (e.g., Hausdorff distance), and comparisons against both ground-truth particle volumes and at least one alternative multi-sphere generation approach from the literature. These additions will be supported by the evaluation tools already present in the package. revision: yes
Circularity Check
Software package description with no derivations or predictions
full rationale
The manuscript is a descriptive announcement of an open-source Python package that converts triangulated meshes and voxel data into intersecting sphere sets for DEM use, along with evaluation, visualization, and export utilities. No equations, fitted parameters, predictions, uniqueness theorems, or ansatzes are present. The central claim is simply that the tool exists and performs the stated conversions, which is a factual software description with no internal derivation chain that could reduce to its own inputs or self-citations. This is a self-contained implementation report with no opportunity for circularity.
Axiom & Free-Parameter Ledger
Reference graph
Works this paper leans on
-
[1]
P. A. Cundall, O. D. L. Strack, A discrete numerical model for granular assemblies, Géotechnique 79 (1979) 47–65.doi:10.1680/geot.1979.29.1.47
-
[2]
T. Pöschel, T. Schwager, Computational Granular Dynamics: Models and Algorithms, Springer, Berlin, Heidelberg, 2005.doi:10.1007/3-540-27720-X
-
[3]
H.-G. Matuttis, J. Chen, Understanding the Discrete Element Method: Simulation of Non-Spherical Par- ticles for Granular and Multi-body Systems, Wiley, 2014.doi:10.1002/9781118567210
-
[4]
G. Lu, J. Third, C. Müller, Discrete element models for non-spherical particle systems: From theoretical de- velopments to applications, Chemical Engineering Sci- ence 127 (2015) 425–465.doi:10.1016/j.ces.2014. 11.050. 4
-
[5]
J. Zhao, S. Zhao, S. Luding, The role of particle shape in computational modelling of granular mat- ter, Nature Reviews Physics 5 (2023).doi:10.1038/ s42254-023-00617-9
2023
-
[6]
T. Pöschel, V. Buchholtz, Static friction phenomena in granular materials: Coulomb law versus particle geometry, Physical Review Letters 71 (1993) 3963– 3966.doi:10.1103/PhysRevLett.71.3963
-
[7]
V. Buchholtz, T. Pöschel, Numerical investigations of the evolution of sandpiles, Physica A-Statistical Mechanics and Its Applications 202 (1994) 390–401. doi:10.1016/0378-4371(94)90467-7
-
[8]
V. Buchholtz, T. Pöschel, Avalanche statistics of sand heaps, Journal of Statistical Physics 84 (1996) 1373–1378.doi:10.1007/BF02174136
-
[9]
P. M. Hubbard, Approximating polyhedra with spheres for time-critical collision detection, ACM Transactions on Graphics 15 (1996) 179–210.doi: 10.1145/231731.231732
-
[10]
Favier, M
J. Favier, M. Abbaspour-Fard, M. Kremmer, A. O. Raji, Shape representation of axi-symmetrical, non- spherical particles in discrete element simulation using multi-element model particles, Engineering Computations 16 (1999) 467–480. doi:10.1108/ 02644409910271894
1999
-
[11]
Viewpoint Animation Engineering, Sun Microsystems, cow2 [3d model] from the princeton suggestive con- tour gallery,https://gfx.cs.princeton.edu/proj/ sugcon/models/, accessed: 2026-01-26 (n.d.)
2026
-
[12]
V. Angelidakis, S. Nadimi, M. Otsubo, S. Utili, CLUMP: A code library to generate universal multi- sphere particles, SoftwareX 15 (2021) 100735.doi: 10.1016/j.softx.2021.100735
-
[13]
A. U. Canbolat, S. Nadimi, V. Angelidakis, A Python implementation of CLUMP, the code library to gen- erate universal multi-sphere particles, SoftwareX 29 (2025) 101957.doi:10.1016/j.softx.2024.101957
-
[14]
Amberger, M
S. Amberger, M. Friedl, C. Goniva, S. Pirker, C. Kloss, Approximation of objects by spheres for multisphere simulations in DEM, 2012
2012
-
[15]
Ferellec, G
J.-F. Ferellec, G. R. McDowell, A method to model realistic particle shape and inertia in DEM, Gran- ular Matter 12 (2010) 459–467. doi:10.1007/ s10035-010-0205-8
2010
-
[16]
B. Felix, T. Pöschel, P. Müller, Multi-sphere shape generator for dem simulations of complex-shaped par- ticles, Powder Technology, submitted (2026). doi: 10.48550/arXiv.2603.05877
-
[17]
L. R. Dice, Measures of the amount of ecologic associ- ation between species, Ecology 26 (3) (1945) 297–302. doi:10.2307/1932409
-
[18]
A. Levy, B. R. Shalom, M. Chalamish, A guide to similarity measures and their data science applications, Journal of Big Data 12 (1) (2025) 188.doi:10.1186/ s40537-025-01227-1
2025
-
[19]
stanford.edu/data/3Dscanrep/, Stanford Bunny Model, accessed: 2026-03-19 (1994)
Stanford Computer Graphics Laboratory, The stan- ford 3d scanning repository, http://graphics. stanford.edu/data/3Dscanrep/, Stanford Bunny Model, accessed: 2026-03-19 (1994)
2026
-
[20]
Milatz, N
M. Milatz, N. Hüsener, E. Andò, G. Viggiani, J. Grabe, Quantitative 3D imaging of partially saturated gran- ular materials under uniaxial compression, Acta Geotechnica 16 (2021) 3573–3600. doi:10.1007/ s11440-021-01315-5
2021
-
[21]
Vego, Multi-modal investigation of hygroscopic gran- ular media at high relative humidity, Ph.D
I. Vego, Multi-modal investigation of hygroscopic gran- ular media at high relative humidity, Ph.D. thesis, Université Grenoble Alpes (2023)
2023
-
[22]
M. Wiebicke, E. Andò, I. Herle, G. Viggiani, On the metrology of interparticle contacts in sand from x-ray tomography images, Meas. Sci. Technol. 28 (12) (2017) 124007.doi:10.1088/1361-6501/aa8dbf
-
[23]
M. Saadatfar, N. Francois, A. Arad, M. Madadi, R. Cruikshank, M. Alizadeh, A. Sheppard, A. Kingston, A. Limay, T. Senden, M. Knack- stedt, 3D mapping of deformation in an uncon- solidated sand: A micro mechanical study, in: SEG Technical Program Expanded Abstracts 2012, Society of Exploration Geophysicists, 2012, pp. 1–6. doi:10.1190/segam2012-1263.1
-
[24]
J. Luijmes, T. van Leeuwen, W. Renema, Foram- etcetera, a novel ct scan dataset to expedite classi- fication research of (non-)foraminifera, Scientific Data 11 (2024) 642.doi:10.1038/s41597-024-03476-w. 5
discussion (0)
Sign in with ORCID, Apple, or X to comment. Anyone can read and Pith papers without signing in.