Release Notes

Release 8.0.0

Prometech Software, Inc.

Jun 05, 2023

 CONTENTS

1 Notes 1
1.1 License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
1.2 Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
1.3 Particleworks/Granuleworks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.4 Particleworks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.5 Aeration Option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.6 Granuleworks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

2 New Features and Improvements 3

2.1 Particleworks/Granuleworks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
2.2 Particleworks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
2.3 GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
2.4 Documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
2.5 Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

3 Limitations 5

4 New Features, Improvements, and Bug Fixes 7

5 Known Issues 11

i
ii
 CHAPTER

ONE

NOTES

1.1 License

1. For both Particleworks 8.0 and Granuleworks 3.0, license servers are common. However, each license is
required to use.
2. For the use of the Software Development Kit (SDK), the SDK option license is required.
3. For the use of the Aeration feature, three licenses are required: Particleworks 8.0, Granuleworks 3.0, and
Interface option.
4. From Particleworks 8.0/Granuleworks 3.0, files of the license server (e.g., lmgrd) are located in “bin” of the
installation folder.
5. From Particleworks 8.0, a LBM-MPS co-simulation consumes two MPS solver jobs.
6. For more details refer to the Install Guide.

1.2 Environment

1. Particleworks 8.0.0/Granuleworks 3.0.0 use the CUDA Toolkit 11.8. Update the NVIDIA driver to CUDA
Toolkit 11.8 compatible.
• Download site: http://www.nvidia.co.jp/Download/index.aspx
• The CUDA Toolkit 11.8 no longer supports the following operating systems.
– Windows 8.1
– Windows Server 2008 R2
– Red Hat Enterprise Linux 6 (RHEL 6, including CentOS 6).
2. Particleworks 8.0/Granuleworks 3.0 supports Windows Server 2019.
3. Particleworks 8.0/Granuleworks 3.0 supports OpenGL 4.0 or later.

Note: The future version of Particleworks/Granuleworks, which will require the next CUDA version, drops support
for the following environments. Therefore, migration to the newer version is recommended.
• Kepler generation GPUs

1
Release Notes, Release 8.0.0

1.3 Particleworks/Granuleworks

1. Once old projects (created with Particleworks 7.2/Granuleworks 2.2 or earlier) are imported, they cannot be
opened with the previous versions, or simulation options may no longer be consistent. Please ensure you
create a backup before updating.
2. The filenames and paths of .rdyn, .rmd, and .rss files should not include any Japanese characters in
co-simulation with RecurDyn versions prior to V9R2.
3. From Particleworks 8.0/Granuleworks 3.0, the package includes Python for the SDK execution. The opera-
tion is verified only for the bundled Python.
4. The versions of the compilers required to build the SDK programs have been changed from Particleworks
7.2/Granuleworks 2.2. For more details refer to the SDK Manual.

1.4 Particleworks

1. MPI calculation for a periodic boundary condition is not supported.

2. The calculation results with the viscosity model or the surface tension potential model may differ from those
of Particleworks 7.2 when the density difference between fluids exists.
3. From Particleworks 8.0, the negative pressure model is renewed, and the old outside pressure model has been
removed.
4. From Particleworks 8.0, the way to specify the connected inflow to the outflow region and outflow has been
changed.

1.5 Aeration Option

1. Normal DEM calculation and aeration function cannot be used simultaneously.

2. One kind of fluid physical properties can be used as an ambient fluid.
3. Periodic boundary conditions are not supported.
4. Multi-GPU is not supported.

1.6 Granuleworks

1. Periodic boundary conditions are not supported.

2. Multi-GPU is not supported.
3. Granuleworks does not support the volumetric flow rate.

2 Chapter 1. Notes
 CHAPTER

TWO

NEW FEATURES AND IMPROVEMENTS

2.1 Particleworks/Granuleworks

1. Extended SDK API

• Extracts particles and cells
• Generates pathlines (postprocess)
• Specifies rotation axis
• Reads/Writes result files
• Loads mapping results
2. Simulation domain specified by arbitrary geometry file

2.2 Particleworks

1. CFD with lattice Boltzmann method (LBM) (Beta)

• Turbulence model
• Improved mesh generation
2. CFD with finite volume method (FVM)
• Turbulence model
• Intermediate result output of steady-state simulations
• FVM results for the air resistance model
• Algebraic multigrid method for faster pressure calculations
3. Improved capabilities to use spatially distributed physical quantities as boundary conditions in conjugate
heat transfer analysis.
• Support for temperature, heat source, and heat flux
• The GUI can display the distribution of physical quantities
4. Passive scalar calculation
5. Multi-Resolution
6. Moving Particle Full-Implicit (MPFI) method
7. Snow model (Bingham fluid model based on the Mohr-Coulomb failure criterion)
8. New negative pressure model
9. Particle Shifting
10. Improved connected inflows

3
Release Notes, Release 8.0.0

• Enables an outflow region and an outflow to be connected to multiple inflows

• Enables the user to specify the time until particles re-enter
11. Dynamic contact angle model
12. Potential amplifier for near-wall particles
13. DEM-MPS co-simulations with volume exclusion effects (Beta)

2.3 GUI

1. GUI Python console

• Interactive console
• Python script execution by drag and drop
• Dialog display by Python script
• Figure display of matplotlib
2. Physical quantity display by mouse hover
3. 3D view of FVM cells

2.4 Documents

1. Improved structure of the Particleworks theory manual

2.5 Installer

1. Silent installation
2. Independent installation of the free viewer

4 Chapter 2. New Features and Improvements

 CHAPTER

THREE

LIMITATIONS

1. 32-bit OSs are no longer supported.

2. Red Hat Enterprise Linux 6 (including CentOS 6) and earlier versions are not supported.
3. SUSE Linux Enterprise is not supported.
4. Some Intel / AMD graphics environments may fail to start GUI or to render the 3D view.
5. Functional restrictions on Linux
• OpenGL supports only NVIDIA (nouveau and AMD are not supported).
• The APIs that need offscreen rendering, such as video creation, do not work.

5
Release Notes, Release 8.0.0

6 Chapter 3. Limitations
 CHAPTER

FOUR

NEW FEATURES, IMPROVEMENTS, AND BUG FIXES

Type Key Summary Components

Feature PIT- Silent installation Installer
680
Feature PIT- Boundary conditions specified by CSV files for CHT Solver (CHT), UI
1844 steady-state simulations
Feature PIT- Passive scalar calculation Documents, Solver (FVM),
1848 Solver (MPS), UI
Im- PIT- Simulation domain specified by arbitrary geometry file Solver (ALL)
prove- 1408
ment
Im- PIT- Isothermal boundaries with temperature distributions Solver (CHT)
prove- 1435
ment
Im- PIT- Simulation domain specified by arbitrary geometry file Solver (FVM)
prove- 1654 for FVM simulations
ment
Im- PIT- The air resistance model uses the results of FVM simu- Solver (FVM)
prove- 1732 lations
ment
Im- PIT- The GUI displays the number of FVM cells UI
prove- 1747
ment
Im- PIT- The user can specify the initial velocity for FVM simula- Solver (FVM)
prove- 1756 tions
ment
Im- PIT- Reduced memory usage for video creation Postprocessor
prove- 1768
ment
Im- PIT- Independent installation of the free viewer Installer
prove- 1773
ment
Im- PIT- The surface tension potential model for multiphase sim- Solver (MPS)
prove- 1832 ulations with density difference
ment

7
Release Notes, Release 8.0.0

Type Key Summary Components

Im- PIT- The viscosity model for multiphase simulations with density difference Solver (MPS)
prove- 1833
ment
Im- PIT- The GUI displays units of flow resistance coefficients UI
prove- 1837
ment
Im- PIT- The RecurDyn co-simulation output TranslationalVelocity and Tempera- Solver (ALL)
prove- 1853 ture to the RPA file by default
ment
Im- PIT- The upper limit of viscosity ratio of the gas phase and the liquid phase for Documents,
prove- 1860 FVM simulations Solver (FVM),
ment UI
Bug PIT- Wall Y+ has not been added to the color map automatically UI
1808
Bug PIT- An error may occur when “Set Range of Field” of Prove (Solver) is enabled Postprocessor
1818
Bug PIT- When the group without particles exists, the output Shannon entropy is all Postprocessor
1825 zero
Bug PIT- The CHT steady-state simulation with boundary conditions specified by UI
1827 mapping files fails when the mapping folder includes JSON or CSV files
Bug PIT- The solver outputs “WARN 0: 0 ] unknown parameter , default parameter Solver (ALL)
1830 is set . ” to the log
Bug PIT- “Minimum Viscosity” and “Maximum Viscosity” have been applied to Solver (MPS)
1831 Newtonian fluids
Bug PIT- FVM-MPS co-simulations may fail by “cudaMalloc failed” Solver (FVM)
1835
Bug PIT- The mapping does not work correctly when “Average”, “Multiply time ratio Postprocessor,
1843 to CSV”, and “Reset” are enabled Solver (ALL)

8 Chapter 4. New Features, Improvements, and Bug Fixes

 Release Notes, Release 8.0.0

Type Key Summary Components

Bug PIT- Heat flux between MPS particles and polygon walls is not output Solver (CHT)
1861
Bug PIT- The post-processing probe with scripting motion does not count the correct Postprocessor
1864 number of particles when the parent object has motion
Bug PIT- When Appearance > Type of CHT cells is set to Isoline, CHT cells and UI
1878 widgets vanish
Bug PIT- The DEM-MPS drag coefficient for Re<1 is wrong in the Particleworks the- Documents
1879 ory manual
Bug PIT- The old data of the flow record may not be removed when the user runs a Solver (MPS)
1882 simulation in the same scene
Bug PIT- Air Drag Coefficient has not been output when the air resistance mode is Solver (DEM),
1884 Normal Solver (MPS)
Bug PIT- Prove does not work when the motion of the parent polygon is specified by Postprocessor
1901 velocity, rotational speed, or angular velocity
Bug PIT- The air resistance model with LBM results does not work when the domain Solver (ALL)
1932 type is not Wind Tunnel
Bug PIT- Error when outputting video with Python API if the profile is enabled and SDK
1965 Capping is checked

9
Release Notes, Release 8.0.0

10 Chapter 4. New Features, Improvements, and Bug Fixes

 CHAPTER

FIVE

KNOWN ISSUES

Type Key Summary Compo-

nents
Bug PIT- Video creation fails when the path of FFmpeg includes “%” UI
1389
Bug PIT- Bubble coalescence behaviors sometimes disagree between when started from 0 s Solver
1461 and when restarted (ALL)
Bug PIT- Use of Intel Iris Plus may cause unstable OpenGL rendering UI
1470
Bug PIT- Applying Appearance > Wire or Front-back to geometries with large size (about UI
1481 4GB or more) may cause GUI crash
Bug PIT- Number density of particles near inflows may suddenly fall on the step before inflow Solver
1483 events occur (ALL)
Bug PIT- When Output > Type is set to simulationTime, restarting simulation leads to incon- Solver
1486 sistent output time compared to one without restarting (ALL)
Bug PIT- In CHT analysis, when the implicit method and single precision are used in com- Solver
1551 bination, the CHT cell temperature may not be calculated properly. (MPS)
Bug PIT- When the scene path contains two or more double-byte katakana characters and Solver
1582 Executing In New Window, log output to the window stops. (ALL)
Bug PIT- “Render as Solid” of polygon walls does not work in the initial frame of screenshots UI
1812 or videos
Bug PIT- The SDK manual lacks the description of PW_ARRAYS_add_array_tag Docu-
1823 ments,
SDK
Bug PIT- Depending on the system locale setting, the GUI does not read a scene on Linux UI
1867
Bug PIT- Video creation by Python may fail for the scene with profiles Postpro-
1872 cessor

11
Release Notes, Release 8.0.0

Type Key Summary Components

Bug PIT-1873 Video creation by Python ignores profile settings in screenshots Postprocessor

12 Chapter 5. Known Issues