ESyS-Particle Community Wiki

• ESyS-Particle
• GenGeo

7th ESyS-Particle Workshop Resources

The 7th ESyS-Particle Workshop is being held between 10-13 December 2018 at the University of Chile, Santiago, Chile. This page contains various resources relevant to that workshop.

Useful Online Resources

• ESyS-Particle Tutorial
• ESyS-Particle Python Documentation
• GenGeo Python Documentation
• ESyS-Particle Software Website and User Forum
• Additional Documentation and Resources

Required Software

• Docker Community Edition - for Windows 10 Pro, MacOS X or Linux
  • or Docker Toolbox - for Windows 10 Home
• Paraview - computational scientific data visualisation software
• openSCAD - parametric Computer Aided Drafting (CAD) software
• VLC media player - Open Source video media player
• a text editor (e.g. notepad, wordpad, TextEdit, notepad++, other)

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 load -i /c/Users/MyUserName/Documents/esys-particle-3.0.tar

• Execute the ESyS-Particle Docker Image:

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

(replace "MyUserName" with your own username)

Marble Maze Hackathon

Rules:

• 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)

Workshop scripts

• Formative examples:
  • two_particle.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

• box_geometry.txt -- GenGeo script to construct a box of particles
• slump.txt -- ESyS-Particle script for gravitational collapse of the box geometry

• Biaxial compression simulations:
  • 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:
  • Guide for constructing triangle meshes using gmsh
    • save your mesh in gmsh (.msh) format, as well as VTK format
  • initGeometry.py -- GenGeo script to initialise particle geometry for fillBucket simulations
  • fillBucket.txt -- ESyS-Particle script for settling particles inside a trimesh bucket
  • gmsh2trimesh.py -- Script to convert gmsh (.msh) files to ESyS-Particle trimesh format
• 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:
  • 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
  • STLmeshvol.py -- example GenGeo script for importing an STL mesh and packing with spheres