Tutorials

New to TrixiParticles.jl? Start with Setting up your simulation from scratch.

  1. Setting up your simulation from scratch: learn the structure of a simulation file and run a complete WCSPH example.
  2. Modifying or extending components of TrixiParticles.jl within a simulation file: replace selected parts of an existing setup without cloning the package.
  3. Particle packing tutorial: build a body-fitted particle configuration for complex geometries.

Tutorials

Setting up your simulation from scratch

Rectangular tank setup used in the first tutorial

Build a complete Weakly Compressible SPH dam break setup from particle spacing through semidiscretization, callbacks, and time integration.

  • Focus: initial conditions, systems, semidiscretization, callbacks
  • Choose this if: you want the full workflow for a minimal example

Modifying or extending components of TrixiParticles.jl within a simulation file

Kernel comparison plot from the custom kernel tutorial

Start from an existing simulation and replace pieces such as the smoothing kernel directly in the file you run.

  • Focus: trixi_include, custom kernels, rapid iteration
  • Choose this if: you want to prototype changes without cloning and modifying the package

Particle packing tutorial

Packed particle configuration for a complex geometry

Go from a geometry file to a packed particle distribution using signed distance fields together with boundary and interior sampling.

  • Focus: geometry import, signed distance fields, boundary sampling, ParticlePackingSystem
  • Choose this if: you need body-fitted particles for complex geometries

See also Getting started and Examples.