# Graphical user interfaced

Dyssol comes with a graphical user interface that allows you to create and customize flowsheets and analyze simulation results.

## Menu

You can find File, Setup, Modules, Tools and Help in the main menu bar.

### File

1. Standard file operations

2. Save flowsheet as a script file for command line interface

3. Quick access to previously opened flowsheets

4. Close the program

### Setup

1. Main flowsheet setup

2. Additional flowsheet setup

3. Compounds editor

4. Phases editor

5. Grids editor

6. Holdups editor

7. Options

8. Calculation sequence editor

9. Recycle streams editor

#### Compounds editor

1. List of available compounds from materials database

2. List of active compounds in the flowsheet

3. Add selected compound to the flowsheet

4. Remove selected compound from the flowsheet

#### Phases editor

1. List of active phases

2. Phases names

3. Phases aggregation states

4. Add new phase to the flowsheet

5. Remove selected phase from the flowsheet

#### Grids specification

1. Distribution grids for the whole flowsheet

2. Distribution grids for every specific unit

3. Active distributed grids in the selected unit or whole flowsheet

4. Add distributed grid

5. Remove selected distributed grid

6. Default distribution by compounds

7. Distribution type

8. Number of classes

9. Entries type: numeric, symbolic

10. Grid function: equidistant, geometric, logarithmic, manual

11. Grid boundaries

12. Units for boundaries

13. Cells boundaries

#### Holdups editor

Here, material in inlet streams and holdups can be configured.

1. List of units with holdups/inlet streams

2. List of holdups/inlet streams in the selected unit

3. List of time points in the selected holdup/inlet stream

4. Add or remove time points

5. Overall holdup/stream properties

6. Phase fractions in the holdup/stream

7. Compound fractions of the liquid phase

8. Compound fractions of the gas phase

9. Compound fractions and distributed properties of the solid phase

1. Time point

2. Mass or mass flow at the corresponding time point

3. Temperature at the corresponding time point

4. Pressure at the corresponding time point

1. Time point

2. Mass fraction (0..1) of each defined phase at the corresponding time point

1. Time point

2. Mass fraction (0..1) of each defined compound at the corresponding time point

1. Time point

2. Mass fraction (0..1) of each defined compound at the corresponding time point

1. Selected time point from the list of time points

2. Mass fraction (0..1) of each defined compound at the corresponding time point

3. List of defined distributed properties

4. Compound or total mixture to set distributed properties

5. Distributed property to edit

6. Distributed property to edit

7. Additional setting for PSD: PSD type

8. Additional setting for PSD: PSD grid

9. Values of the distributed property

10. Insert functional distribution

11. Functional distribution editor

12. Function type

13. Parameters of the functional distribution

14. Apply all changes made

#### Options

General options:

1. Absolute and relative tolerances for convergence calculation

2. Minimal significant fraction of multidimensional distributed properties

3. Remove excessive time points from streams during the simulation

4. Also remove time points from holdups and internal streams

5. Temperature limits of the lookup table for calculating stream mixtures

6. Number of temperature intervals of the lookup table for calculating stream mixtures

Options for Waveform relaxation method, Data extrapolation and Convergence methods:

1. Initial size of the time window

2. Minimum allowed size of the time window

3. Maximum allowed size of the time window

4. Allowed number of iterations before stop

5. Window resizing factor

6. Upper critical limit of iterations before resizing the window

7. Lower critical limit of iterations before resizing the window

8. Upper critical limit of iterations before resizing the window, for the first time window

9. Settings for Convergence methods

10. Settings for Data extrapolation

Additional options:

1. Cache streams data on disk during simulation

2. Cache holdups data on disk during simulation

3. Cache internal streams data on disk during simulation

4. Number of time points to stay in RAM if caching is enabled

5. Split result `*.dflw` into 2GB files.

#### Calculation sequence

Here, one can adjust automatically calculated simulation sequence. See also Partitioning and tearing.

1. Calculation sequence in the partition

2. Tear streams in the partition

3. Automatically recalculate simulation sequence

4. Add/remove/rearrange partitions, models or tear streams

#### Recycle streams

Here, one can adjust automatically calculated initial values of tear streams

1. Calculate initial values automatically

2. Set initial values manually

3. Remove all current initial values

4. List of partitions

5. List of tear streams

6. List of time points in the selected tear stream

7. Add/remove time points

8. Initial values

### Modules

1. Dustiness formation tester

### Tools

1. Program-wide tools

2. Models manager

3. Materials database

4. Program-wide settings

#### Models manager

Configuration of the models library

1. List of directories to look for models

2. Whether to look for models in this directory

3. Add/remove directory

4. Rearrange directories

5. List of available models

#### Materials database

Configuration of compounds in the global Material database.

1. Current file with materials database

2. Standard operations with materials database file

3. Configuration of compounds properties

4. Configuration of interactions between compounds

5. List of compounds

6. Compound names

7. Unique keys of compounds

8. Add/remove compounds

9. Create a copy of a selected compound

10. Rearrange compounds

11. List of compound properties

12. Constant compound properties

13. Temperature-/pressure-dependent compound properties

14. Whether to treat a temperature-/pressure-dependent property as a constant

15. User-defined information about the property

16. Property description

17. Add/remove a user-defined compound property

18. Create a copy of a selected property

19. Edit selected user-defined property

20. List of correlations defining values of a temperature-/pressure-dependent property

21. Temperature range of the correlation

22. Pressure range of the correlation

23. Correlation function

24. User-defined information about the correlation

25. Correlation parameters

26. Add/remove correlation

27. Rearrange correlations

28. Visualization of correlations

29. First correlation parameter

30. Second correlation parameter

31. Correlation plot in 2D

32. Property calculator

#### Settings

Application-wide settings.

1. Whether to load last opened flowsheet at application start

2. Open application-wide configuration file

3. Path to store cache files

4. Change cache path

5. Delete all cache files

### Help

1. Links to online documentation

2. Information about Dyssol

#### About

1. Version number

2. Build number

3. Link to updates

4. Dyssol license agreement

5. List of developers and credits

6. List of used 3rd party libraries

## Tabs

Tabs are used to build a flowsheet, run a simulation, and analyze the results. There are Flowsheet, Simulator, Streams and Units tabs.

1. Flowsheet tab: create flowsheet structure, specify unit parameters

2. Simulator tab: set simulation time, run and stop the simulation, calculation log and report

3. Streams tab: streams analysis after the simulation

4. Units tab: units analysis after the simulation

### Flowsheet

1. Add/remove units

2. Rearrange units

3. List of units

4. Add/remove streams

5. Rearrange streams

6. List of streams

7. Model selection for each unit

8. Names of units ports

9. Types of units ports

10. Streams connected to ports

11. Scheme of the assembled flowsheet

12. List of user-defined parameters of the selected unit

13. Values of constant unit parameters

14. Description of the selected parameter

15. Values of time-dependent unit parameters

16. Add/remove time point in the time-dependent unit parameter

### Simulator

Here you can start your simulation based on your time input.

1. Last time point of the simulation interval

2. Run simulation

3. Simulation log and report

4. Simulation progress info

5. Remove simulated data

6. Clear initial values of tear streams

7. Clear simulated data and tear streams

### Streams

Here, parameters of streams can be found after simulation.

Table view:

1. List of defined streams

2. List of available stream parameters

3. Number of time points in the selected stream

4. Simulation results

Plot view:

1. List of defined streams

2. List of available stream parameters

3. List of available distributed parameters

4. Specific compound or total mixture

5. PSD type for particle size distribution

6. PSD grid type for particle size distribution

7. Number of time points in the selected stream

8. Navigation through all time points in the selected stream

9. Currently selected time point

10. Simulation results

### Units

Here, parameters of units can be found after simulation.

1. List of defined units

2. List of holdups in the selected unit

3. List of state variables in the selected unit

4. List of plots in the selected unit

5. Parameters selection

6. Time slider

7. Table view

8. Plot view

9. Simulation results