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:
- two_particle.txt -- 1D elastic collision of two particles
$ 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
- Guide for constructing triangle meshes using gmsh
- 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
- stl2msh.py -- tool to convert triangle meshes in STL format into ESyS-Particle's mesh file format