8th ESyS-Particle Workshop Resources

The 8th ESyS-Particle Workshop is being held between 18-21 February 2019 at The University of Queensland, Brisbane, Australia. This page contains various resources relevant to that workshop.

Useful Online Resources

Marble Maze Hackathon


  • Simulation must include these components:
    • launcher of a particle
    • ramp(s)
    • funnel
    • Newton's cradle - transmission of force from one end of a row of particles to the other
    • Perpetual Motion!
  • GenGeo must be used to construct at least one component of the simulation
  • The first team to produce a movie of a simulation meeting the above requirements is the winner

(DKW cannot write any code; only point out resources available online)

Required Software

Installation of ESyS-Particle Docker Image

  • obtain a copy of the esys-particle-3.0.tar docker image (from USB) and place it in MyDocuments
  • Install Docker CE or Docker Toolbox and start the Docker Quick Terminal
  • install the esys-particle image from within the docker terminal:

$ docker pull dweatherley/esys-particle-3:r1195

  • Execute the ESyS-Particle Docker Image:

$ docker run -v /c/Users/MyUserName/Documents:/Documents -it dweatherley/esys-particle-3:r1195

(replace "MyUserName" with your own username)

Workshop scripts

  • Formative examples:
    • bingle.txt -- 1D elastic collision of two particles
      • command to convert snapshot files into VTK files for visualisation with Paraview:

$ dump2vtk -i snapshot -o snaps_ -t 0 31 100

  • mkbox.txt -- GenGeo script to construct a box of particles for the slump test example
  • slump.txt -- ESyS-Particle script for gravitational collapse of the box geometry
  • Biaxial compression simulations:
    • box_geometry.txt -- GenGeo script to construct a box of particles for the biaxial test example
    • biaxial_test.txt -- ESyS-Particle script for biaxial compression of the box geometry
    • wall_mover.py -- Runnable for moving a wall with a prescribed velocity
    • wall_piston.py -- Runnable for moving a wall to maintain a prescribed pressure on the wall
  • Scripts to fill a conical bucket with particles:
    • initGeometry.py -- GenGeo script to initialise particle geometry for fillBucket simulations
    • fillBucket.txt -- ESyS-Particle script for settling particles inside a trimesh bucket
    • stl2msh.py -- tool to convert triangle meshes in STL format into ESyS-Particle's mesh file format
      • also contains subroutine to convert from STL format to TriPatchSet for import into GenGeo's MeshVolume
    • TriMeshTools.py -- library of tools for manipulating and writing triangle meshes for ESyS-Particle simulations
  • Simulating particle breakage in an impact load cell device:
    • cylinderGeom.py -- GenGeo script to construct a cylinder of bonded particles
    • impactLoadCell.py -- ESyS-Particle script to simulate the Short Impact Load Cell device
    • ball_mover.py -- Runnable to move a SphereBody at constant speed
  • Additional Tools:
    • STLmeshvol.py -- example GenGeo script for importing an STL mesh and packing with spheres
GlossyBlue theme adapted by David Gilbert
Powered by PmWiki