Subscribe to DeepL Pro to edit this d

Visit www.DeepL.com/Pro for more information.

ShonCloud Particle Method

Software shonDy

User Manuals

(Third Edition)

Software name: shonDy

Software version: v2.3.0

Developed by: Suzhou ShonCloud

Engineering Software Co.
 Catalog
1：Updated content.........................................................................................................................4
2: Company Profile.......................................................................................................................... 5
3: Basic instructions.........................................................................................................................6
3.1-Hardware & Software Requirements.............................................................................6
3.2-License................................................................................................................................6
3.3 - Unit Description...............................................................................................................7
4: Function module.......................................................................................................................... 8
4.1 File component.................................................................................................................. 8
4.2 Edit component (setting function)................................................................................ 10
4.3 View component..............................................................................................................11
4.4 Tools component............................................................................................................ 11
4.5 Help component.............................................................................................................. 12
4.6 New case function.......................................................................................................... 12
4.7 Open Case....................................................................................................................... 12
4.8 Save function................................................................................................................... 13
4.9 Region Manager Features.............................................................................................13
4.10 Solver Control Component..........................................................................................14
4.11 Run/Stop Simulation Function....................................................................................15
4.12 Reload Result Data Function......................................................................................15
4.13 Clear Result Data function.......................................................................................... 15
5: Object Browser module............................................................................................................16
5.1 Simulation Region...........................................................................................................16
5.1.1 Fluid Region......................................................................................................... 16
5.1.2 Solid Region......................................................................................................... 20
5.2 Samples............................................................................................................................26
5.3 Simulation Results.......................................................................................................... 26
5.3.1 Fluid Result...........................................................................................................26
5.3.2 Solid Result.......................................................................................................... 26
5.3.3 IsoSurface Result................................................................................................ 26
5.4 Scene component...........................................................................................................26
6: Visualization module.................................................................................................................26
6.1 Rotating view component.............................................................................................. 27
 6.2 Fixed view component................................................................................................... 27
6.3 Output components........................................................................................................ 27
6.4 Calculation time selection component.........................................................................27
6.5 Physical quantity selection component....................................................................... 27
6.6 Visualization interface.................................................................................................... 28
6.7 Chart viewer component................................................................................................28
7: Solver Control Module..............................................................................................................29
7.1 Domain Setting................................................................................................................29
7.2 Physical Setting...............................................................................................................30
7.3 Output Setting..................................................................................................................31
7.4 computation Setting........................................................................................................32
8: Run Simulation Module............................................................................................................ 32
1：Updated content

Modified on October 16, 2020

Create shonDy 2.0 User Guide

Modified on May 08, 2021

Software version number updated to 2.1.0version
Interface Updates
Hardware Requirements Update
Remove the particle arrangement module and replace it with the initial particle positions
adjustment module
New shear layer thickness coeff and wall shear exponent correction coefficients are
added to correct the calculated moments
New use wall sticking wall, used to simulate smooth wall surface
New isosurface function to achieve liquid rendering effect within the software
New momentum equation type, can realize high viscosity fluid lubrication simulation
Improvements in computing progress monitoring

Modified on 06/23/2021
Software updated to version 2.3
Optimize the rotation view function: up/down/left/right/forward/backward rotation is now
possible
Optimized result file output strategy: smaller output files and faster loading results
Optimize the file opening strategy: now the case will not automatically load the results,
but can see the churning torque, flow rate and other related data
Optimize the fluid generation function: add the way of center point finding in liquid level
mode
Optimize start/stop calculation: add the function of determining again to reduce the loss
of results caused by misoperation
Fix the function of exporting text results: export csv will not fail to export results due to
insufficient memory.
Solve the transparency display exception problem: Fix the transparency model rendering
black problem
New HTC export function: users can export wall HTC calculation results
New wall adhesion model: open the model to simulate the adhesion of the wall to the
fluid
New isosurface output worker: output fluid isosurface, improve fluid effect post-
processing
New normal flip function: you can fix wall normal errors in the user interface
2: Company Profile

shonDy software developed by Suzhou ShonCloud Engineering Software Co., Ltd. is a

3D high performance numerical calculation software based on the motion particle method.
The software supports distributed parallel computing.

With this software, the user only needs to import CAD geometry models in the specified
format into the software to start the calculation easily. No complex meshing is required,
saving engineers a lot of time in simulation modeling.

In this software, the fluid domain or solid to be simulated is discretized into particles that
can move, including physical quantities such as pressure, velocity and temperature
stored on the moving particles, so that these key physical quantities are moving with the
fluid or solid unit.

Since the pressure of solid and fluid particles is solved in a linear algebraic system of
equations, the most important feature of shonDy is that the motion of the fluid and the
solid is intrinsically "coupled", which is not possible with the traditional finite volume
method. In addition, the particle method can simulate fluid free interfaces under complex
motion conditions, including sputtering phenomena. The software has a wide range of
applications in the engineering and industrial fields.
3: Basic instructions

3.1-Hardware & Software Requirements

Requirements

CPU 16 cores +

GPU Graphics card required

RAM 32G+

Disk 100G+

System Win7, Win10, centos, Ubuntu

Other OpenGL 3.2+

3.2-License

View by: edit-setting-License key solver

How to get it: Send the serial code of edit-setting-host id to ShonCloud Technology, we
will provide you with License key and activation service.
3.3 - Unit Description

Name units

Length m

Area m2

Volume m3

Velocity m/s

Density kg/m3

Heat capacity J/K

Thermal conductivity W m-1 K-1

Temperature K

Kinematic viscosity m2/s

Thermal expansion coefficient 1/k

Pressure Pa
4: Function module

The functional module is divided into 13 components.

4.1 File component

There are 8 functions in the File component.

1.New Case：Enter the case name and path to create a new case
2. Open Case: Just select the folder, there is no need to enter inside the case.

3.Recent Cases: Open recent cases

4. Save: Save

5. Open Case Directory: Open the case folder

6. Region Manager: Model Manager

The function includes importing model, activating model, selecting model properties,
and flipping model normal, 4 functions
※This function is duplicated with the file-region manager function (function #9)
※This function supports batch selection of geometry
1. Geometry pool: used to store the inactive geometry
2. Import geometry: for importing models
3. Computational geometry: the geometry involved in the computation will be
classified here
4. Flip Normal: it can provide a one-time normal flip for geometries with wrong normal
direction
7. Export Results to CSV: Export results to CSV format file

Export any information from shonDy results to an excel format file

8. Export Results to VTK: Export results to VTK format file

Any information of shonDy results can be exported to VTK format files for use by other
software coupling of ShonCloud Technology

4.2 Edit component (setting function)

There are 2 functions in the Edit component (setting function)

 1. General module: license management location
2. Scene module: background color modification position

4.3 View component

View component to turn on/off the content of the settings area displayed in the software
interface (recommend to open them all)

1. Object Browser: Model tree setting area

2. Object Properties: Model transparency/example size/value range setting area
3. Fluid Region View: Fluid property setting region
4. Solid Region View: Solid Property Setting Region
5. Solver Control View: solver property setting area
6. Run simulation View: Run the setup area
7. Default Layout: Initialized interface settings
4.4 Tools component

There are 2 functions in the Tools component

 1. Particle Film: Through the STP model, add liquid film to the model (the specific use
of this function to consult ShonCloud technical support)
2. Run Batch Simulations: queue calculation function (the specific use of this function
consult ShonCloud technical support)

4.5 Help component

There are 2 functions in the Help component

1. User Manual: User manual storage location

2. About: Software version and company information

4.6 New case function

New Case function: enter the case name and path to create a new case (the same
function as file-New Case)

4.7 Open Case

Open Case: Just select the folder, no need to go inside the case (the same function as
file-Open Case)
4.8 Save function

Save: Save case function, currently does not support Save As (and file-Save for the
same function)

4.9 Region Manager Features

Model Manager (same function as file-Region Manager)

※ The function includes importing model, activating model, selecting model

properties, and flipping model normal, 4 functions
※ This function is duplicated with the option bar function - region manager function
(function #9)
※This function supports batch selection of geometry
1. Geometry pool: used to store the inactive geometry
2. Import geometry: for importing models
3. Computational geometry: the geometry involved in the computation will be
classified here
4. Flip Normal: it can provide one-time normal flip for geometry with wrong normal
direction
4.10 Solver Control Component

Solver interface jump function: used to quickly enter the solver setup interface (please
see Chapter 7 Solver Setup for specific functions)
4.11 Run/Stop Simulation Function

Start/Stop Calculation Function: User can implement the calculation/stop/restart function

here. Caution.

1. Initial calculation without any secondary confirmation prompt

2. Secondary calculation, prompting whether to overwrite the previous result

3. Stop the calculation, prompting whether to abort the calculation

4.12 Reload Result Data Function

Load results function: shonDy will not automatically load the results, need to manually
refresh each time

4.13 Clear Result Data function

Delete result function: can clear the result, and can not be retrieved
5: Object Browser module

The model tree module is divided into 4 components.

5.1 Simulation Region

5.1.1 Fluid Region

5.1.1.1. Basic fluid area settings.

1 Add fluid region: right click to add fluid region (simulation regions on the left side of
the interface), enter the fluid region interface to set the selected model (right side of the
interface)

Right click Add Fluid Region

2. Initial property setting: In fluid region-initial condition, you can input the initial
pressure, initial temperature and initial flow rate information of the liquid.

3. Physical properties settings: In fluid region-physical properties, you can enter fluid-
related properties

5.1.1.2 Fluid domain-based fluid model

Select the imported fluid domain model in the Geometry file
5.1.1.3 Fluid model based on liquid level height
1. Open liquid level mode: In fluid region-fluid region type, select From liquid level type,
and open the liquid level setting module in the setting area after activation.

2. Selecting the liquid level height point: Users can get the liquid level height point in
three ways.

enable edit widget: free dragging of level points in the screen

from geometry: automatically finds the center of the model

Manual input

3. Define the direction of the liquid: click use filled volume, enter the positive normal
direction of the liquid.

5. Oil volume definition: click use filled volume, enter the real oil volume that needs to be
added. (Particle method there is the possibility of the initial particle is not tight, the use of
level point defined separately may cause the simulation oil volume is lower than the
actual oil volume)

5.1.1.4 - Inlet-based fluid model

1. Open the inlet mode: In fluid region-fluid region type, select From inlet type, and
activate it to open the inlet module in the setting area.

2. Define inlet area: In geometry definition, you can choose geometry file and circular,
which represent using user-defined face geometry or using software-generated circular
geometry, respectively. The user can define the inlet area by importing any plane, or by
defining the circular surface in the software to determine the inlet area.
3. Define the flow: Inlet-inlet velocity data, users can define time-dependent flow and flow
rate inlet information

5.1.2 Solid Region

5.1.2.1 Solid foundation setting

1. Enter the solid property setting interface: double-click the solid model that needs to be
set (simulation regions on the left side of the interface) and enter the solid region
interface to set the selected model (on the right side of the interface)
2. Initial property setting: In the solid region-initial condition, you can input the initial
angular velocity, angular velocity direction, initial translation velocity and initial
temperature information.

3. Physical Properties Settings: In Physical Properties, you can enter density, speed of
sound, geometric information, and thermal boundaries.
4. Geometry properties: Detailed settings for this item are required only when using free
motion, click auto detect geometry or enter manually to get the correct total mass, center
of mass position and moment of inertia.
5. Thermal boundary: Only when using the flow thermal coupling analysis need to set this
item in detail, click “add” to enter the boundary setting interface, the heat flow or
temperature, feature length and internal and external flow to set. (Detailed explanation)

6. Boundary condition: In the boundary condition, it is necessary to distinguish between

the heat flow boundary or the fixed temperature boundary. It is recommended to use the
heat flow boundary to obtain a more realistic HTC
5.1.2.2 Forced motion wall settings (rotation settings)
Shondy has three motion modes, and can be used in combination.

2. Translational motion mode: this function is activated by default and cannot be turned
off, the user can define the speed or speed curve in three directions in this function

3. Rotational motion mode: This function is activated by default and cannot be turned off,
you can get the center of rotation of the rotating body by clicking center of mass or
inputting manually, and the user can define the rotation axis and the rotation speed curve
in this function.

4. Sub-rotation motion mode: This function needs to be checked to use the revolution
motion, and can be activated for setting if there are motion behaviors such as rotation or
eccentric rotation. The setting of this function is the same as normal rotation.
5.1.2.3 Free motion wall settings
1. Open the free motion wall mode: In solid region-body region type, select free motion,
and the motion behavior set in initial will be activated after activation.
5.2 Samples

shonDy has perfect detection function, which can realize point, surface and body
detection. Consult technical support for details on how to use it

5.3 Simulation Results

5.3.1 Fluid Result

Fluid result selection area

5.3.2 Solid Result

Solid Result Selection Area

5.3.3 IsoSurface Result

IsoSurface result selection area

5.4 Scene component

The Scene component is a quick guide for object Properties to control the upper and
lower values of a range of values

6: Visualization module

The visualization module is divided into 6 components and 1 data processing module
6.1 Rotating view component

capable of up/down/left/right/forward/backward rotation

6.2 Fixed view component

capable of X/Y/Z/-X/-Y/-Z view fast setting

6.3 Output components

able to achieve picture/video output * Need a player with high compatibility

6.4 Calculation time selection component

able to implement the function of observing different time results

6.5 Physical quantity selection component

enables the viewing of the results of different calculation objects

6.6 Visualization interface

Capable of displaying beautiful pictures * Dedicated to achieving image-level effects

6.7 Chart viewer component

data processing component with the ability to select physical quantities for the X and Y
axes
7: Solver Control Module

The solver is the core of the shonDy software architecture and is based on a semi-implicit
kinematic particle numerical method. The solver supports a mixture of distributed and
shared-memory parallel computation without any limitation on the number of parallel
cores. The solver settings are divided into five parts - solver domain settings, physical
model settings, output settings, solver settings, and solver process monitoring.

7.1 Domain Setting

Calculate dimension settings - Usage: Click Solver controls in the lower right corner of
the interface, click domain setting, and enter the settings area. In the domain setting, you
can set the dimension of the calculation in dimension. If you only need to calculate the
XY plane and the z coordinate of the observation plane is 0m, you can set it as follows:

Virtual Boundary Settings - Usage: The virtual boundary is an important setting for
defining the computational domain, and the user only needs to click auto detect to
complete the settings.
Once the virtual boundary is set,

then remove the checkbox

7.2 Physical Setting

Usage: Click Solver controls in the lower right corner of the interface, click physical
setting, and enter the settings area. The specific setting information is shown in the table
below:

Particle Radius[m] Particle radius

Initial Particle Positions Adjustment Initial particle position adjustment

Solidification model Solidification model

Gravity[m/s2] Definition of gravity/acceleration

Free Surface Pressure[Pa] Free surface pressure

Environment temperature Ambient temperature

Shear Layer Thickness Coeff Torque correction parameter 1

Wall Shear Exponent Torque correction parameter 2

Use velocity limit [m/s] Maximum particle velocity limit

 Use heat transfer Consider heat transfer

Use turbulence model Turbulence model

Use wall repulsive model Rough wall model

Use wall Sticking model Smooth wall model

Use Fluid motion Consider fluid movement

Use negative Pressure Consider negative pressure

Use radiation Heat Transfer Consider radiant heat exchange

7.3 Output Setting

How to use: Click Solver controls in the lower right corner of the interface, click output
setting, and enter the settings area.

The specific setting information is described in the following table

Write fluid particles Output particle results

Write fluid isosurface Output envelope results

Isosurface resolution[m] Envelope resolution (particle radius

recommended)

Isosurface maximum number of cells Number of envelope surfaces

Write interval for results[s] Cloud map results write time interval

Write interval for samples[s] Detection message write out interval

7.4 Computation Setting

Usage: Click Solver controls in the lower right corner of the interface, click computation
setting, and enter the setting area. The specific setting information is described in the
following table

Pressure equation type Pressure implicit algorithm or display

algorithm

Momentum equation type Momentum implicit algorithm or

display algorithm

Maximum pressure iterations Number of pressure corrections in

the implicit algorithm

Number of velocity corrections Number of speed corrections

Courant number Courant number

Delta time[s] Initial time step

End time[s] Total time

8: Run Simulation Module

Usage: Click run simulation in the bottom right corner of the interface to enter the settings
area.
Number of cores: the number of cores selection function

Restart time: restart function, default from the selected time step after selecting the time
to continue to count

Process & log: Calculating progress monitoring areas