# Dyssol documentation

Dyssol, the DYnamic Simulation of SOLids processes, is a dynamic flowsheet modelling system designed to simulate the time-dependent behaviour of complex production processes in solids processing technology. Its distinctive features:

- Dynamic simulation of complex process structures

- Sequential-modular calculation algorithm

- Consideration of solid, liquid, gas phases and their mixtures

- Handling of multidimensional interdependent distributed parameters of solids

- Standardized interfaces and templates for implementation of new units

- High modularity and extensibility

This documentation will help you to get familiar with the Dyssol flowsheet simulations system. Here you will find an introduction to the structure and algorithms of the program, the principles of its operation, a description of the user interface, as well as the documentation of available units. It also provides information on how to create your own units and solvers.

# Contents

Get started

- Get started
  - Installation
  - Files
  - Run your first simulation

User interface

- Graphical user interfaced
  - Menu
  - Tabs
- Command line interface
  - Main
  - Simulation options
  - Phases
  - Compounds
  - Grids
  - Flowsheet structure
  - Unit parameters
  - Holdups
  - Export

Structure and algorithms

- Overview
  - Flowsheet simulation of solids
  - Approaches and methods
  - Software system architecture
- Simulation core
  - Material streams
  - Units
  - Simulator
- Data storage subsystem
  - HDF5 data format
  - Data caching
- Material database
  - DMDB file
  - Constant parameters
  - Dependent parameters
- Multidimentional distributed parameters of solids
  - Tree data structures
  - Treatment of dependent parameters
- Time point management
  - Data interpolation
  - Interpolation of distributed parameters
  - Steady state units
  - Dynamic units with recycle
- Theoretical background
  - Discretization
  - Process systems
  - Numerical methods

Libraries

- Unit library
  - Inlet flow
  - Outlet flow
  - Mixer
  - Splitter
  - Screen
  - Crusher
  - Bunker
  - Granulator
  - Agglomerator
  - Time delay
  - Cyclone
- Solver library
  - Agglomeration solvers

Models development

- For developers
  - Compilation
- For models developers
  - Configuration of Visual Studio project template
  - Unit development
  - Solver development
- Classes
  - Basic unit
  - Stream
  - Particle size distribution
  - Thermodynamics
  - External solver
  - DAE Systems
  - Matrices
  - List of universal constants

# Acknowledgement

Dyssol project was funded by German Research Foundation (DFG) via SPP 1679 “Dyn-Sim-FP” and via “Research Software Sustainability” program.

See also

1. Skorych V., Dosta M., Hartge E.-U., Heinrich S.: Novel system for dynamic flowsheet simulation of solids processes. Powder Technology 314 (2017), 665-679. 10.1016/j.powtec.2017.01.061

2. Skorych V., Dosta M., Hartge E.-U., Heinrich S., Ahrens R., Le Borne S.: Investigation of an FFT-based solver applied to dynamic flowsheet simulation of agglomeration processes. Advanced Powder Technology 30(3) (2019), 555-564. 10.1016/j.apt.2018.12.007

3. Skorych V., Das N., Dosta M., Kumar J., Heinrich S.: Application of transformation matrices to the solution of population balance equations. Processes 7(8) (2019) 535. 10.3390/pr7080535

4. Skorych V., Dosta M., Heinrich S.: Dyssol — An open-source flowsheet simulation framework for particulate materials. SoftwareX 12 (2020), 100572. 10.1016/j.softx.2020.100572

5. Skorych V., Buchholz M., Dosta M., Heinrich S.: A Framework for Dynamic Simulation of Interconnected Solids Processes. In: Heinrich S. (eds) Dynamic Flowsheet Simulation of Solids Processes, 2020. Springer, Cham. 10.1007/978-3-030-45168-4_17

# Contact

Vasyl Skorych