From 73f4b35fd489726c10facb694806687613628e90 Mon Sep 17 00:00:00 2001 From: Hamidreza Date: Wed, 23 Apr 2025 00:47:03 +0330 Subject: [PATCH 01/15] readme.md file is added for postprocessing --- .../postprocessData/postprocessData.cpp | 4 + src/PostprocessData/readme.md | 346 ++++++++++++++++++ .../lineRegionPoints/lineRegionPoints.cpp | 24 +- .../sampleDictionary/postprocessDataDict | 224 ++++++++---- 4 files changed, 511 insertions(+), 87 deletions(-) create mode 100644 src/PostprocessData/readme.md diff --git a/src/PostprocessData/postprocessData/postprocessData.cpp b/src/PostprocessData/postprocessData/postprocessData.cpp index 02afc48e..ac76c26b 100644 --- a/src/PostprocessData/postprocessData/postprocessData.cpp +++ b/src/PostprocessData/postprocessData/postprocessData.cpp @@ -100,6 +100,8 @@ pFlow::postprocessData::postprocessData bool pFlow::postprocessData::execute() { + if( inSimulation_ && !activeInSimulation_() ) return true; + const auto& ti = time_.TimeInfo(); for(auto& component:postprocesses_) @@ -118,6 +120,8 @@ bool pFlow::postprocessData::execute() bool pFlow::postprocessData::write() const { + if( inSimulation_ && !activeInSimulation_() ) return true; + for(auto& component:postprocesses_) { if(!component->executed()) diff --git a/src/PostprocessData/readme.md b/src/PostprocessData/readme.md new file mode 100644 index 00000000..0edd208a --- /dev/null +++ b/src/PostprocessData/readme.md @@ -0,0 +1,346 @@ +# PostprocessData Module in phasicFlow + +The `PostprocessData` module in phasicFlow provides powerful tools for analyzing particle-based simulations both during runtime (in-simulation) and after simulation completion (post-simulation). This document explains how to configure and use the postprocessing features through the dictionary-based input system. + +## Overview + +Postprocessing in phasicFlow allows you to: + +- Extract information about particles in specific regions of the domain +- Calculate statistical properties such as averages and sums of particle attributes +- Track specific particles throughout the simulation +- Apply different weighing methods when calculating statistics +- Perform postprocessing at specific time intervals + +## Setting Up Postprocessing + +Postprocessing is configured through a dictionary file named `postprocessDataDict` which should be placed in the `settings` directory. Below is a detailed explanation of the configuration options. + +### Basic Configuration + +The input dictionary, **settings/postprocessDataDict**, may look like this: + +```cpp +// PostprocessData dictionary + + +// Enable/disable postprocessing during simulation +runTimeActive yes; // Options: yes, no + +// Shape type - only needed when doing post-simulation processing +shapeType sphere; // Options depend on the simulation type: sphere, grain, etc. + +// Default time control for postprocessing components +defaultTimeControl +{ + timeControl timeStep; // Options: timeStep, simulationTime, settings + startTime 0; // Start time for postprocessing + endTime 1000; // End time for postprocessing + executionInterval 150; // How frequently to run postprocessing +} + +// List of postprocessing components +components +( + // Component definitions here... +); +``` + +If you want to activate in-simulaiton postprocessing, you need to add these lines to the `settings/settingsDict` file: + +```cpp +libs ("libPostprocessData.so"); + +auxFunctions postprocessData; +``` + +This will link the postprocessing library to your simulation, allowing you to use its features. Note that, anytime you want to deactivate the in-simulation postprocessing, you can simply change the `runTimeActive` option to `no` in `postprocessDataDict` file. + +## Time Control Options + +Each postprocessing component can either use the default time control settings or define its own. There are three main options for time control: + +| Option | Description | Required Parameters | +|--------|-------------|---------------------| +| `timeStep` | Controls execution based on simulation time steps | `startTime`, `endTime`, `executionInterval` | +| `simulationTime` | Controls execution based on simulation time | `startTime`, `endTime`, `executionInterval` | +| `settings` | Uses parameters from settingsDict file | None (defined elsewhere) | +| `default` | Uses the default time control settings (uses `defaultTimeControl` settings)| None (uses default) | + +If no time control is specified, the `default` option is used automatically. + +## Processing Methods + +The postprocessing module provides several methods for processing particle data. They are categorized into two main groups: bulk and individual methods. + +- **Bulk Methods**: Operate on all particles that are located in a specified locations/regions (cells, spheres, etc.). +- **Individual Methods**: Operate on specific particles, allowing for targeted particle property extraction. + +| Method | Property type | Description | Formula | +|--------|------------------|-------------|---------| +| `arithmetic` | bulk | Simple arithmetic mean/sum with equal weights | Each particle contributes equally | +| `uniformDistribution` | bulk | Each particle contributes inversely proportional to the total number of particles | $w_i = 1/n$ where $n$ is the number of particles | +| `GaussianDistribution` | bulk | Weight contribution based on distance from center with Gaussian falloff | $w_i = \exp(-\|x_i - c\|^2/(2\sigma^2))/\sqrt{2\pi\sigma^2}$ | +| `particleProbe` | individual | Extracts values from specific particles | Direct access to particle properties | + +## Region Types + +Regions define where in the domain the postprocessing operations are applied: + +| Region Type | Description | Required Parameters | Compatible with | +|-------------|-------------|---------------------|-----------------| +| `sphere` | A spherical region | `radius`, `center` | bulk | +| `multipleSpheres` | Multiple spherical regions | `centers`, `radii` | bulk | +| `line` | Spheres along a line with specified radius | `p1`, `p2`, `nSpheres`, `radius` | bulk | +| `centerPoints` | Specific particles selected by ID | `ids` | individual | + +## Processing Operations + +Within each processing region of type `bulk`, you can define multiple operations to be performed: + +### Available Functions + +| Function | Property type | Description | Formula | Required Parameters | +|----------|---------------|-------------|---------|---------------------| +| `average` | bulk | Weighted average of particle field values | $\frac{\sum_{i \in \text{region}} w_i \cdot \phi_i \cdot \text{field}_i}{\sum_{i \in \text{region}} w_i \cdot \phi_i}$ | `field`, `phi` (optional), `threshold` (optional), `includeMask` (optional), `divideByVolume` (optional) | +| `sum` | bulk | Weighted sum of particle field values | $\sum_{i \in \text{region}} w_i \cdot \phi_i \cdot \text{field}_i$ | `field`, `phi` (optional),`threshold` (optional), `includeMask` (optional), `divideByVolume` (optional) | + +### Derived Functions + +In addition to the above basic functions, some derived functions are available for specific calculations: + +| Function | Property type | Description | Formula | Required Parameters | +|----------|---------------|-------------|---------|---------------------| +|`avMassVelocity` | bulk | Average velocity weighted by mass | $\frac{\sum_{i \in \text{region}} m_i \cdot v_i}{\sum_{i \in \text{region}} m_i}$ | - | + +### Available Fields + +All the pointFields in the simulation database (for in-simulation processing), or the ones stored in the time folders (for post-simulation processing) can be referenced in the operations. In addition to them, some extra fields are available for use in the operations. The following fields are available for use in the operations: + +1. Extra fileds to be used in post-processing operations: + +| Field | Field Type | Description | Default Value | +|-------|------------|-------------|---------------| +| `position` | `realx3` | Particle positions | - | +| `one` | `real` | Value 1 for each particle | 1 | +| `mass` | `real` | Particle mass | - | +| `density` | `real` | Particle density | - | +| `volume` | `real` | Particle volume | - | +| `diameter` | `real` | Particle diameter | - | +| `I` | `real` | Moment of inertia | - | + +2. Common fields which are available in the simulation database/time folders: + +| Field | Field Type | Description | +|-------|------------|-------------| +| `velocity` | `realx3` | Particle velocity | +| `rVelocity` | `realx3` | Particle rotational velocity | +| `acceleration` | `realx3` | Particle acceleration | +| `rAcceleration` | `realx3` | Particle rotational acceleration | +| `contactForce` | `realx3` | Particle contact force | +| `contactTorque` | `realx3` | Particle contact torque | +| `id` | `integer` | Particle ID | +| `shapeIndex` | `integer` | Particle shape index | + +The above fields may vary from one type of simulation to other. Pleas note that this is only a tentative list. + +### Optional Parameters + +| Parameter | Description | Default | Options | +|-----------|-------------|---------|---------| +| `divideByVolume` | Divide result by region volume | `no` | `yes`, `no` | +| `threshold` | Exclude regions with fewer particles | 1 | Integer value | +| `includeMask` | Filter particles based on a field value | `all` | `all`, `lessThan`, `greaterThan`, `between`, `lessThanOrEq`, `greaterThanEq`, `betweenEq` | + +## Examples + +### Example 1: Probing Individual Particles + +```cpp +velocityProb +{ + processMethod particleProbe; + processRegion centerPoints; + selector id; + field component(position,y); + ids (0 10 100); + timeControl default; +} +``` + +This example extracts the y-component of the position for particles with IDs 0, 10, and 100. + +### Example 2: Processing in a Spherical Region + +```cpp +on_single_sphere +{ + processMethod arithmetic; + processRegion sphere; + + sphereInfo + { + radius 0.01; + center (-0.08 -0.08 0.015); + } + + timeControl default; + + operations + ( + averageVel + { + function average; + field mag(velocity); + divideByVolume no; + threshold 3; + includeMask all; + } + + par1Fraction + { + function average; + field one; + phi one; + divideByVolume no; + includeMask lessThan; + + lessThanInfo + { + field diameter; + value 0.0031; + } + } + + numberDensity + { + function sum; + field one; + phi one; + divideByVolume yes; + } + ); +} +``` + +This example defines a sphere region and performs three operations: + +1. Calculate the average of velocity magnitude of particles +2. Calculate the fraction of particles with diameter less than 0.0031 +3. Calculate the number density by summing and dividing by volume + +### Example 3: Processing Along a Line + +In this example, a line region is defined. The `lineInfo` section specifies the start and end points of the line, the number of spheres to create along the line, and the radius of each point. Bulk properties are calculated in each sphere, based on the properties of particles contained in each sphere. + +```cpp +along_a_line +{ + processMethod arithmetic; + processRegion line; + + timeControl simulationTime; + startTime 1.0; + endTime 3.0; + executionInterval 0.1; + + lineInfo + { + p1 (0 0 0); + p2 (0 0.15 0.15); + nSpheres 10; + radius 0.01; + } + + operations + ( + bulkDensity + { + function sum; + field mass; + phi one; + divideByVolume yes; + } + + volumeDensity + { + function sum; + field volume; + divideByVolume yes; + } + ); +} +``` + +This example creates 10 spherical regions along a line from (0,0,0) to (0,0.15,0.15) and calculates the bulk density and volume density in each region. + +## Advanced Features + +### Special functions applied on fields + +You can access specific components of vector fields (`realx3`) using the `component` function: + +```cpp +field component(position,y); // Access the y-component of position +``` + +Here is a complete list of these special functions: + +| Function Name | Valid field Type | Example | +|-----------------|------------|---------| +| `component` | `realx3` | `component(velocity,x)` | +| `abs` | `real` | `abs(s)` | +| `square` | `real` | `square(I)` | +| `cube` | `real` | `cube(diameter)` | +| `squre root` | `real` | `sqrt(mass)` | +| `magnitude` | `realx3` | `mag(contactForce)` | +| `magnitude square` | `realx3` | `magSquare(velocity)` | +| `magnitude cube` | `realx3` | `magCube(velocity)` | +| `magnitude square root` | `realx3` | `magSqrt(acceleration)` | + + +### Particle Filtering with includeMask + +The `includeMask` parameter allows you to filter particles based on field values: + +```cpp +includeMask lessThan; +lessThanInfo +{ + field diameter; + value 0.0031; +} +``` + +Supported masks: + +- `all`: Include all particles (default) +- `lessThan`: Include particles where field < value +- `greaterThan`: Include particles where field > value +- `between`: Include particles where value1 < field < value2 +- `lessThanOrEq`: Include particles where field ≤ value +- `greaterThanOrEq`: Include particles where field ≥ value +- `betweenEq`: Include particles where value1 ≤ field ≤ value2 + +## Implementation Notes + +- The postprocessing system can work both during simulation (`runTimeActive yes`) or after simulation completion. +- When using post-simulation mode, you must specify the correct `shapeType` to properly initialize the shape objects. +- Results are written to output files in the case directory with timestamps. +- The `threshold` parameter helps eliminate statistical noise in regions with few particles. +- Setting `divideByVolume` to `yes` normalizes results by the volume of the region, useful for calculating densities. + +## Mathematical Formulations + +For weighted `bulk` properties calculation: + +$$ \text{average} = \frac{\sum_{i \in \text{region \& includeMask}} w_i \cdot \phi_i \cdot \text{field}_i}{\sum_{i \in \text{region}} w_i \cdot \phi_i} $$ + +For weighted summing: + +$$ \text{sum} = \sum_{i \in \text{region \& includeMask}} w_i \cdot \phi_i \cdot \text{field}_i $$ + +If `divideByVolume` is set to `yes`, the result is divided by the volume of the region: + +$$ \text{volumetric result} = \frac{\text{result}}{V_{\text{region}}} $$ + diff --git a/src/PostprocessData/region/regionPoints/lineRegionPoints/lineRegionPoints.cpp b/src/PostprocessData/region/regionPoints/lineRegionPoints/lineRegionPoints.cpp index 979a51a6..5d3e4482 100644 --- a/src/PostprocessData/region/regionPoints/lineRegionPoints/lineRegionPoints.cpp +++ b/src/PostprocessData/region/regionPoints/lineRegionPoints/lineRegionPoints.cpp @@ -14,7 +14,7 @@ pFlow::lineRegionPoints::lineRegionPoints selectedPoints_("selectedPoints") { const auto& lDict = dict.subDict("lineInfo"); - uint32 nPoints = lDict.getValMax("numPoints",2); + uint32 nSpheres = lDict.getValMax("nSpheres",2); realList raddi; if( lDict.containsDataEntry("radii")) @@ -24,24 +24,24 @@ pFlow::lineRegionPoints::lineRegionPoints else { auto r = lDict.getVal("radius"); - raddi = realList(nPoints, r); + raddi = realList(nSpheres, r); } - if(raddi.size() != nPoints) + if(raddi.size() != nSpheres) { fatalErrorInFunction - << "The number elements in of radii list should be equal to the " - << "number of points"< Date: Wed, 23 Apr 2025 01:08:03 +0330 Subject: [PATCH 02/15] corrections for readme.md file postprocessing --- src/PostprocessData/readme.md | 25 +++++++++++++++++++++---- 1 file changed, 21 insertions(+), 4 deletions(-) diff --git a/src/PostprocessData/readme.md b/src/PostprocessData/readme.md index 0edd208a..2e6d937b 100644 --- a/src/PostprocessData/readme.md +++ b/src/PostprocessData/readme.md @@ -102,8 +102,25 @@ Within each processing region of type `bulk`, you can define multiple operations | Function | Property type | Description | Formula | Required Parameters | |----------|---------------|-------------|---------|---------------------| -| `average` | bulk | Weighted average of particle field values | $\frac{\sum_{i \in \text{region}} w_i \cdot \phi_i \cdot \text{field}_i}{\sum_{i \in \text{region}} w_i \cdot \phi_i}$ | `field`, `phi` (optional), `threshold` (optional), `includeMask` (optional), `divideByVolume` (optional) | -| `sum` | bulk | Weighted sum of particle field values | $\sum_{i \in \text{region}} w_i \cdot \phi_i \cdot \text{field}_i$ | `field`, `phi` (optional),`threshold` (optional), `includeMask` (optional), `divideByVolume` (optional) | +| `average` | bulk | Weighted average of particle field values | see Equation 1 | `field`, `phi` (optional), `threshold` (optional), `includeMask` (optional), `divideByVolume` (optional) | +| `sum` | bulk | Weighted sum of particle field values | see Equation 2 | `field`, `phi` (optional),`threshold` (optional), `includeMask` (optional), `divideByVolume` (optional) | + +Equation 1: + +$\text{result}=\qquad \frac{\sum_{j} w_j \cdot \phi_j \cdot \text{field}_j}{\sum_{j} w_i \cdot \phi_i}$ + +Equation 2: + +$\text{result} = \sum_{j} w_j \cdot \phi_j \cdot \text{field}_j$ + +where: + +- $j$ is the index of the particle in the region that also satisfies the `includeMask` +- $i$ is the index of the particle in the region +- $w_j$ is the weight of particle $j$ based on the selected processing method +- $\phi_j$ is the value of the `phi` field for particle $j$ (default is 1) +- $field_j$ is the value of the specified field for particle $j$ + ### Derived Functions @@ -334,11 +351,11 @@ Supported masks: For weighted `bulk` properties calculation: -$$ \text{average} = \frac{\sum_{i \in \text{region \& includeMask}} w_i \cdot \phi_i \cdot \text{field}_i}{\sum_{i \in \text{region}} w_i \cdot \phi_i} $$ +$$ \text{average} = \frac{\sum_{i \in \text{region and includeMask}} w_i \cdot \phi_i \cdot \text{field}_i}{\sum_{i \in \text{region}} w_i \cdot \phi_i} $$ For weighted summing: -$$ \text{sum} = \sum_{i \in \text{region \& includeMask}} w_i \cdot \phi_i \cdot \text{field}_i $$ +$$ \text{sum} = \sum_{i \in \text{region and includeMask}} w_i \cdot \phi_i \cdot \text{field}_i $$ If `divideByVolume` is set to `yes`, the result is divided by the volume of the region: From a9e5b9bb5980e261abe2bc2f92061f0bc67e8ee1 Mon Sep 17 00:00:00 2001 From: PhasicFlow <113092888+PhasicFlow@users.noreply.github.com> Date: Wed, 23 Apr 2025 01:19:10 +0330 Subject: [PATCH 03/15] Update readme.md --- src/PostprocessData/readme.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/PostprocessData/readme.md b/src/PostprocessData/readme.md index 2e6d937b..436b7e25 100644 --- a/src/PostprocessData/readme.md +++ b/src/PostprocessData/readme.md @@ -107,11 +107,11 @@ Within each processing region of type `bulk`, you can define multiple operations Equation 1: -$\text{result}=\qquad \frac{\sum_{j} w_j \cdot \phi_j \cdot \text{field}_j}{\sum_{j} w_i \cdot \phi_i}$ +$$\text{result} = \frac{\sum_j w_j \cdot \phi_j \cdot \text{field}_j}{\sum_i w_i \cdot \phi_i}$$ Equation 2: -$\text{result} = \sum_{j} w_j \cdot \phi_j \cdot \text{field}_j$ +$$\text{result} = \sum_j w_j \cdot \phi_j \cdot \text{field}_j$$ where: From f2e8e69899fc207112f5bb5c4c14f17fdd189144 Mon Sep 17 00:00:00 2001 From: Hamidreza Date: Thu, 24 Apr 2025 14:08:17 +0330 Subject: [PATCH 04/15] prime2 is added and readme update --- .../PostprocessOperationAverage.cpp | 38 ++- .../PostprocessOperationAverage.hpp | 7 + .../postprocessOperation.cpp | 58 ---- .../postprocessOperation.hpp | 11 +- .../postprocessOperationFunctions.hpp | 100 +++++++ src/PostprocessData/readme.md | 259 ++++++++++++++++-- .../sampleDictionary/postprocessDataDict | 108 +++----- 7 files changed, 407 insertions(+), 174 deletions(-) create mode 100644 src/PostprocessData/operation/postprocessOperation/postprocessOperationFunctions.hpp diff --git a/src/PostprocessData/operation/PostprocessOperation/PostprocessOperationAverage.cpp b/src/PostprocessData/operation/PostprocessOperation/PostprocessOperationAverage.cpp index 3ffbd5b8..15474667 100644 --- a/src/PostprocessData/operation/PostprocessOperation/PostprocessOperationAverage.cpp +++ b/src/PostprocessData/operation/PostprocessOperation/PostprocessOperationAverage.cpp @@ -77,6 +77,7 @@ pFlow::PostprocessOperationAverage::PostprocessOperationAverage } } + /// Performs weighted average of field values within each region bool pFlow::PostprocessOperationAverage::execute ( @@ -109,7 +110,7 @@ bool pFlow::PostprocessOperationAverage::execute allField) ); - if(calculateFluctuation2_) + if(calculateFluctuation2_()) { auto& processedRegField = processedRegFieldPtr_(); fluctuation2FieldPtr_ = makeUnique @@ -136,5 +137,40 @@ bool pFlow::PostprocessOperationAverage::execute } + return true; +} + +bool pFlow::PostprocessOperationAverage::write(const fileSystem &parDir) const +{ + if(! postprocessOperation::write(parDir)) + { + return false; + } + if(!calculateFluctuation2_()) + { + return true; + } + + auto ti = time().TimeInfo(); + + if(!os2Ptr_) + { + fileSystem path = parDir+( + processedFieldName()+"_prime2" + ".Start_" + ti.timeName()); + os2Ptr_ = makeUnique(path); + + regPoints().write(os2Ptr_()); + } + + + std::visit + ( + [&](auto&& arg)->bool + { + return writeField(os2Ptr_(), ti.t(), arg, threshold()); + }, + fluctuation2FieldPtr_() + ); + return true; } \ No newline at end of file diff --git a/src/PostprocessData/operation/PostprocessOperation/PostprocessOperationAverage.hpp b/src/PostprocessData/operation/PostprocessOperation/PostprocessOperationAverage.hpp index 6620d588..4d71d54f 100644 --- a/src/PostprocessData/operation/PostprocessOperation/PostprocessOperationAverage.hpp +++ b/src/PostprocessData/operation/PostprocessOperation/PostprocessOperationAverage.hpp @@ -150,6 +150,9 @@ private: uniquePtr fluctuation2FieldPtr_ = nullptr; + /// Pointer to the output stream for writing fluctuation2 results + mutable uniquePtr os2Ptr_ = nullptr; + public: TypeInfo("PostprocessOperation"); @@ -190,6 +193,10 @@ public: return processedRegFieldPtr_(); } + /// write to os stream + bool write(const fileSystem &parDir)const override; + + /// @brief Execute average operation on field values /// @param weights Weight factors for particles /// @return True if successful diff --git a/src/PostprocessData/operation/postprocessOperation/postprocessOperation.cpp b/src/PostprocessData/operation/postprocessOperation/postprocessOperation.cpp index e752f359..3eedd066 100644 --- a/src/PostprocessData/operation/postprocessOperation/postprocessOperation.cpp +++ b/src/PostprocessData/operation/postprocessOperation/postprocessOperation.cpp @@ -23,64 +23,6 @@ Licence: #include "regionPoints.hpp" #include "fieldsDataBase.hpp" -namespace pFlow -{ - -template -inline -bool writeField -( - iOstream& os, - timeValue t, - const regionField field, - uint32 threshold, - const T& defValue=T{} -) -{ - const auto& regPoints = field.regPoints(); - const uint32 n = field.size(); - os<= threshold) - { - if constexpr(std::is_same_v) - { - os<) - { - os << field[i].x() << ' ' << field[i].y() << ' ' << field[i].z() << ' ' << field[i].w() << tab; - } - else - { - os<) - { - os<) - { - os << defValue.x() << ' ' << defValue.y() << ' ' << defValue.z() << ' ' << defValue.w() << tab; - } - else - { - os<, regionField, and regionField are supported -/// in the postprocessOperation class. -using processedRegFieldType = std::variant - < - regionField, - regionField, - regionField - >; + /// - forward declaration class fieldsDataBase; diff --git a/src/PostprocessData/operation/postprocessOperation/postprocessOperationFunctions.hpp b/src/PostprocessData/operation/postprocessOperation/postprocessOperationFunctions.hpp new file mode 100644 index 00000000..82376fd1 --- /dev/null +++ b/src/PostprocessData/operation/postprocessOperation/postprocessOperationFunctions.hpp @@ -0,0 +1,100 @@ +/*------------------------------- phasicFlow --------------------------------- + O C enter of + O O E ngineering and + O O M ultiscale modeling of + OOOOOOO F luid flow +------------------------------------------------------------------------------ + Copyright (C): www.cemf.ir + email: hamid.r.norouzi AT gmail.com +------------------------------------------------------------------------------ +Licence: + This file is part of phasicFlow code. It is a free software for simulating + granular and multiphase flows. You can redistribute it and/or modify it under + the terms of GNU General Public License v3 or any other later versions. + + phasicFlow is distributed to help others in their research in the field of + granular and multiphase flows, but WITHOUT ANY WARRANTY; without even the + implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. + +-----------------------------------------------------------------------------*/ + +#ifndef __postprocessOperationFunctions_hpp__ +#define __postprocessOperationFunctions_hpp__ + +#include + +#include "types.hpp" +#include "iOstream.hpp" +#include "regionField.hpp" + +namespace pFlow +{ + +/// Type alias for processed region field types. +/// Only regionField, regionField, and regionField are supported +/// in the postprocessOperation class. +using processedRegFieldType = std::variant +< + regionField, + regionField, + regionField +>; + + +template +inline +bool writeField +( + iOstream& os, + timeValue t, + const regionField field, + uint32 threshold, + const T& defValue=T{} +) +{ + const auto& regPoints = field.regPoints(); + const uint32 n = field.size(); + os<= threshold) + { + if constexpr(std::is_same_v) + { + os<) + { + os << field[i].x() << ' ' << field[i].y() << ' ' << field[i].z() << ' ' << field[i].w() << tab; + } + else + { + os<) + { + os<) + { + os << defValue.x() << ' ' << defValue.y() << ' ' << defValue.z() << ' ' << defValue.w() << tab; + } + else + { + os< Date: Thu, 24 Apr 2025 14:18:08 +0330 Subject: [PATCH 05/15] minor change to readme.md --- src/PostprocessData/readme.md | 1 + 1 file changed, 1 insertion(+) diff --git a/src/PostprocessData/readme.md b/src/PostprocessData/readme.md index fa22ebff..8dbefd5b 100644 --- a/src/PostprocessData/readme.md +++ b/src/PostprocessData/readme.md @@ -150,6 +150,7 @@ where: Fluctuation2 is an optional parameter that can be used to account for fluctuations in the particle field values with respect to mean value of the field. It is used in the `average` function to calculate the fluctuation of the field values around the mean. The formula for fluctuation2 is: + $$\text{fluctuation}^2 = \frac{\sum_j w_j \cdot \phi_j \cdot (\text{field}_j - \text{mean})^2}{\sum_i w_i \cdot \phi_i}$$ where: From a448ce5f8d2179bcfe1c6ea7f2de9776a4a7d061 Mon Sep 17 00:00:00 2001 From: Hamidreza Date: Thu, 24 Apr 2025 14:28:28 +0330 Subject: [PATCH 06/15] minor changes to readme.md --- src/PostprocessData/readme.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/src/PostprocessData/readme.md b/src/PostprocessData/readme.md index 8dbefd5b..543e35cc 100644 --- a/src/PostprocessData/readme.md +++ b/src/PostprocessData/readme.md @@ -2,6 +2,9 @@ The `PostprocessData` module in phasicFlow provides powerful tools for analyzing particle-based simulations both during runtime (in-simulation) and after simulation completion (post-simulation). This document explains how to configure and use the postprocessing features through the dictionary-based input system. +- in-simulation: this is postprocessing that is active during simulation. When running a solver, it allows for real-time data analysis and adjustments based on the simulation's current state. See bellow to see how you can activate in-simulation postprocessing. +- post-simulation: this is postprocessing that is done after the simulation is completed. It allows for detailed analysis of the simulation results, including data extraction and visualization based on the results that are stored in time-folders. If you want to use post-simulation, you need to run utitlity `postprocessPhasicFlow` in terminal (in the simulation case setup folder) to run the postprocessing. This utility reads the `postprocessDataDict` file and performs the specified operations on the simulation data. + ## 1. Overview Postprocessing in phasicFlow allows you to: From d5ea338ab33d3e838cc4478d2213d237aef31840 Mon Sep 17 00:00:00 2001 From: Hamidreza Date: Thu, 24 Apr 2025 14:41:31 +0330 Subject: [PATCH 07/15] spell check readme.md --- src/PostprocessData/readme.md | 21 +++++++++++---------- 1 file changed, 11 insertions(+), 10 deletions(-) diff --git a/src/PostprocessData/readme.md b/src/PostprocessData/readme.md index 543e35cc..050420d4 100644 --- a/src/PostprocessData/readme.md +++ b/src/PostprocessData/readme.md @@ -2,8 +2,8 @@ The `PostprocessData` module in phasicFlow provides powerful tools for analyzing particle-based simulations both during runtime (in-simulation) and after simulation completion (post-simulation). This document explains how to configure and use the postprocessing features through the dictionary-based input system. -- in-simulation: this is postprocessing that is active during simulation. When running a solver, it allows for real-time data analysis and adjustments based on the simulation's current state. See bellow to see how you can activate in-simulation postprocessing. -- post-simulation: this is postprocessing that is done after the simulation is completed. It allows for detailed analysis of the simulation results, including data extraction and visualization based on the results that are stored in time-folders. If you want to use post-simulation, you need to run utitlity `postprocessPhasicFlow` in terminal (in the simulation case setup folder) to run the postprocessing. This utility reads the `postprocessDataDict` file and performs the specified operations on the simulation data. +- in-simulation: this is postprocessing that is active during simulation. When running a solver, it allows for real-time data analysis and adjustments based on the simulation's current state. See below to see how you can activate in-simulation postprocessing. +- post-simulation: this is postprocessing that is done after the simulation is completed. It allows for detailed analysis of the simulation results, including data extraction and visualization based on the results that are stored in time-folders. If you want to use post-simulation, you need to run utility `postprocessPhasicFlow` in terminal (in the simulation case setup folder) to run the postprocessing. This utility reads the `postprocessDataDict` file and performs the specified operations on the simulation data. ## 1. Overview @@ -38,7 +38,7 @@ Postprocessing in phasicFlow allows you to: - [8.2. Particle Filtering with includeMask](#82-particle-filtering-with-includemask) - [8.3. Implementation Notes](#83-implementation-notes) - [9. Mathematical Formulations](#9-mathematical-formulations) -- [10. A complete dictioanry file (postprocessDataDict)](#10-a-complete-dictioanry-file-postprocessdatadict) +- [10. A complete dictionary file (postprocessDataDict)](#10-a-complete-dictionary-file-postprocessdatadict) ## 2. Setting Up Postprocessing @@ -74,7 +74,8 @@ components ); ``` -If you want to activate in-simulaiton postprocessing, you need to add these lines to the `settings/settingsDict` file: + +If you want to activate in-simulation postprocessing, you need to add these lines to the `settings/settingsDict` file: ```cpp libs ("libPostprocessData.so"); @@ -159,8 +160,8 @@ $$\text{fluctuation}^2 = \frac{\sum_j w_j \cdot \phi_j \cdot (\text{field}_j - \ where: - `mean`: is the average value of the field in the region. -- `field`: The field to be processed (e.g., `velocity`, `mass`, etc.) -- `fluctuation2`: Optional parameter to account for fluctuations in the particle field values. +- `field`: The field to be processed (e.g., `velocity`, `mass`, etc.) +- `fluctuation2`: Optional parameter to account for fluctuations in the particle field values. ### 6.3. Derived Functions @@ -291,7 +292,7 @@ This example defines a sphere region and performs three operations: ### 7.3. Example 3: Processing Along a Line -In this example, a line region is defined. The `lineInfo` section specifies the start and end points of the line, the number of spheres to create along the line, and the radius of each point. Bulk properties are calculated in each sphere, based on the properties of particles contained in each sphere. +In this example, a line region is defined. The `lineInfo` section specifies the start and end points of the line, the number of spheres to create along the line, and the radius of each point. Bulk properties are calculated in each sphere, based on the properties of particles contained in each sphere. ```cpp along_a_line @@ -358,7 +359,6 @@ Here is a complete list of these special functions: | `magnitude cube` | `realx3` | `magCube(velocity)` | | `magnitude square root` | `realx3` | `magSqrt(acceleration)` | - ### 8.2. Particle Filtering with includeMask The `includeMask` parameter allows you to filter particles based on field values: @@ -393,7 +393,8 @@ Supported masks: ## 9. Mathematical Formulations For weighted `bulk` properties calculation, we have these two general formulations: - - For weighted averaging: + +- For weighted averaging: $$ \text{average} = \frac{\sum_j w_j \cdot \phi_j \cdot \text{field}_j}{\sum_i w_i \cdot \phi_i} $$ @@ -405,7 +406,7 @@ If `divideByVolume` is set to `yes`, the result is divided by the volume of the $$ \text{volumetric result} = \frac{\text{result}}{V_{\text{region}}} $$ -## 10. A complete dictioanry file (postprocessDataDict) +## 10. A complete dictionary file (postprocessDataDict) ```C++ /* -------------------------------*- C++ -*--------------------------------- *\ From be807e4a71c9bd02c216a774ca50e36b2f305411 Mon Sep 17 00:00:00 2001 From: Hamidreza Date: Thu, 24 Apr 2025 23:31:43 +0330 Subject: [PATCH 08/15] change of namespace from pFlow to pFlow::postprocessData --- .../fieldsDataBase/fieldFunctions.hpp | 2 +- .../fieldsDataBase/fieldsDataBase.cpp | 65 ++++++++++++------- .../fieldsDataBase/fieldsDataBase.hpp | 12 ++-- .../fieldsDataBase/fieldsDataBaseDclr.hpp | 2 +- .../fieldsDataBaseTemplates.cpp | 12 ++-- .../simulationFieldsDataBase.cpp | 17 +++-- .../simulationFieldsDataBase.hpp | 2 +- .../PostprocessOperationAvMassVelocity.cpp | 7 +- .../PostprocessOperationAvMassVelocity.hpp | 2 +- .../PostprocessOperationAverage.cpp | 15 +++-- .../PostprocessOperationAverage.hpp | 5 +- .../PostprocessOperationSum.cpp | 10 ++- .../PostprocessOperationSum.hpp | 4 +- .../operationFunctions.hpp | 4 +- .../operation/includeMask/IncludeMask.hpp | 4 +- .../operation/includeMask/IncludeMasks.cpp | 35 +++++----- .../operation/includeMask/includeMask.cpp | 14 ++-- .../operation/includeMask/includeMask.hpp | 8 ++- .../operation/includeMask/maskOperations.hpp | 4 +- .../postprocessOperation.cpp | 20 ++++-- .../postprocessOperation.hpp | 11 ++-- .../postprocessOperationFunctions.hpp | 4 +- .../PostprocessComponent.cpp | 6 +- .../PostprocessComponent.hpp | 2 +- .../PostprocessComponentArithmetic.hpp | 2 +- .../PostprocessComponentGaussian.hpp | 2 +- .../PostprocessComponentUniform.hpp | 2 +- .../PostprocessComponents.cpp | 22 ++++--- .../particleProbePostprocessComponent.cpp | 28 ++++++-- .../particleProbePostprocessComponent.hpp | 2 +- .../postprocessComponent.cpp | 24 ++++++- .../postprocessComponent.hpp | 13 ++-- .../postprocessData/postprocessData.cpp | 15 ++--- .../postprocessData/postprocessData.hpp | 10 ++- .../postprocessData/postprocessGlobals.hpp | 2 +- .../postprocessTimeControl.hpp | 6 +- src/PostprocessData/readme.md | 2 +- .../region/regionFields/regionField.hpp | 4 +- .../regionFields/regionFieldTemplate.cpp | 8 ++- .../centerPointsRegionPoints.cpp | 13 ++-- .../centerPointsRegionPoints.hpp | 4 +- .../lineRegionPoints/lineRegionPoints.cpp | 15 +++-- .../lineRegionPoints/lineRegionPoints.hpp | 2 +- .../multipleSpheresRegionPoints.cpp | 15 +++-- .../multipleSpheresRegionPoints.hpp | 2 +- .../regionPoints/regionPoints.cpp | 13 ++-- .../regionPoints/regionPoints.hpp | 8 ++- .../sphereRegionPoints/sphereRegionPoints.cpp | 11 +++- .../sphereRegionPoints/sphereRegionPoints.hpp | 2 +- 49 files changed, 317 insertions(+), 177 deletions(-) diff --git a/src/PostprocessData/fieldsDataBase/fieldFunctions.hpp b/src/PostprocessData/fieldsDataBase/fieldFunctions.hpp index ea5b7110..7454188d 100644 --- a/src/PostprocessData/fieldsDataBase/fieldFunctions.hpp +++ b/src/PostprocessData/fieldsDataBase/fieldFunctions.hpp @@ -24,7 +24,7 @@ Licence: #include "types.hpp" #include "span.hpp" -namespace pFlow +namespace pFlow::postprocessData { template diff --git a/src/PostprocessData/fieldsDataBase/fieldsDataBase.cpp b/src/PostprocessData/fieldsDataBase/fieldsDataBase.cpp index 51a533b4..08d5cbc2 100644 --- a/src/PostprocessData/fieldsDataBase/fieldsDataBase.cpp +++ b/src/PostprocessData/fieldsDataBase/fieldsDataBase.cpp @@ -26,20 +26,24 @@ Licence: #include "fieldFunctions.hpp" #include "dictionary.hpp" -namespace pFlow +namespace pFlow::postprocessData { bool pointFieldGetType(const word& TYPENAME, word& fieldType, word& fieldSpace); } -bool pFlow::fieldsDataBase::loadPointStructureToTime() +bool pFlow::postprocessData::fieldsDataBase::loadPointStructureToTime() { return false; } -bool pFlow::fieldsDataBase::checkForUpdate(const word &compoundName, bool forceUpdate) +bool pFlow::postprocessData::fieldsDataBase::checkForUpdate +( + const word &compoundName, + bool forceUpdate +) { auto t = currentTime(); bool shouldUpdate = false; @@ -58,7 +62,10 @@ bool pFlow::fieldsDataBase::checkForUpdate(const word &compoundName, bool forceU return shouldUpdate; } -pFlow::span pFlow::fieldsDataBase::createOrGetRealField(const word &name) +pFlow::span pFlow::postprocessData::fieldsDataBase::createOrGetRealField +( + const word &name +) { bool shouldUpdate = checkForUpdate(name); @@ -83,7 +90,10 @@ pFlow::span pFlow::fieldsDataBase::createOrGetRealField(const word field.size()); } -pFlow::span pFlow::fieldsDataBase::createOrGetVolume(bool forceUpdate) +pFlow::span pFlow::postprocessData::fieldsDataBase::createOrGetVolume +( + bool forceUpdate +) { const word fName = "volume"; bool shouldUpdate = checkForUpdate(fName, forceUpdate); @@ -119,7 +129,7 @@ pFlow::span pFlow::fieldsDataBase::createOrGetVolume(bool forceUpda } -pFlow::span pFlow::fieldsDataBase::createOrGetDensity(bool forceUpdate) +pFlow::span pFlow::postprocessData::fieldsDataBase::createOrGetDensity(bool forceUpdate) { const word fName = "density"; @@ -155,7 +165,7 @@ pFlow::span pFlow::fieldsDataBase::createOrGetDensity(bool forceUpd field.size()); } -pFlow::span pFlow::fieldsDataBase::createOrGetOne(bool forceUpdate) +pFlow::span pFlow::postprocessData::fieldsDataBase::createOrGetOne(bool forceUpdate) { const word fName = "one"; @@ -182,7 +192,7 @@ pFlow::span pFlow::fieldsDataBase::createOrGetOne(bool forceUpdate) field.size()); } -pFlow::span pFlow::fieldsDataBase::createOrGetMass(bool forceUpdate) +pFlow::span pFlow::postprocessData::fieldsDataBase::createOrGetMass(bool forceUpdate) { const word fName = "mass"; @@ -218,7 +228,7 @@ pFlow::span pFlow::fieldsDataBase::createOrGetMass(bool forceUpdate field.size()); } -pFlow::span pFlow::fieldsDataBase::createOrGetI(bool forceUpdate) +pFlow::span pFlow::postprocessData::fieldsDataBase::createOrGetI(bool forceUpdate) { const word fName = "I"; @@ -254,7 +264,7 @@ pFlow::span pFlow::fieldsDataBase::createOrGetI(bool forceUpdate) field.size()); } -bool pFlow::fieldsDataBase::findFunction( +bool pFlow::postprocessData::fieldsDataBase::findFunction( const word &compoundFieldName, word &fieldName, fieldsDataBase::Functions &func) @@ -360,7 +370,7 @@ bool pFlow::fieldsDataBase::findFunction( return false; // No match } -bool pFlow::fieldsDataBase::inputOutputType +bool pFlow::postprocessData::fieldsDataBase::inputOutputType ( fieldsDataBase::Functions func, const word &inputType, @@ -458,7 +468,7 @@ bool pFlow::fieldsDataBase::inputOutputType return false; } -pFlow::fieldsDataBase::fieldsDataBase +pFlow::postprocessData::fieldsDataBase::fieldsDataBase ( systemControl& control, const dictionary& postDict, @@ -488,12 +498,12 @@ pFlow::fieldsDataBase::fieldsDataBase } } -pFlow::timeValue pFlow::fieldsDataBase::currentTime() const +pFlow::timeValue pFlow::postprocessData::fieldsDataBase::currentTime() const { return time_.currentTime(); } -bool pFlow::fieldsDataBase::getFieldTypeNameFunction +bool pFlow::postprocessData::fieldsDataBase::getFieldTypeNameFunction ( const word& compoundName, word& pointFieldName, @@ -543,7 +553,7 @@ bool pFlow::fieldsDataBase::getFieldTypeNameFunction return true; } -bool pFlow::fieldsDataBase::getFieldType +bool pFlow::postprocessData::fieldsDataBase::getFieldType ( const word& compoundName, word& originalType, @@ -559,7 +569,7 @@ bool pFlow::fieldsDataBase::getFieldType return true; } -bool pFlow::fieldsDataBase::getFieldType +bool pFlow::postprocessData::fieldsDataBase::getFieldType ( const word &compoundName, word &typeAfterFunction @@ -575,7 +585,7 @@ bool pFlow::fieldsDataBase::getFieldType return true; } -pFlow::span pFlow::fieldsDataBase::updatePoints(bool forceUpdate) +pFlow::span pFlow::postprocessData::fieldsDataBase::updatePoints(bool forceUpdate) { const word fName = "position"; bool shouldUpdate = checkForUpdate(fName, forceUpdate); @@ -604,7 +614,7 @@ pFlow::span pFlow::fieldsDataBase::updatePoints(bool forceUpdate) } -pFlow::span pFlow::fieldsDataBase::updateFieldRealx3 +pFlow::span pFlow::postprocessData::fieldsDataBase::updateFieldRealx3 ( const word &compoundName, bool forceUpdate @@ -640,7 +650,7 @@ pFlow::span pFlow::fieldsDataBase::updateFieldRealx3 } -pFlow::span pFlow::fieldsDataBase::updateFieldRealx4 +pFlow::span pFlow::postprocessData::fieldsDataBase::updateFieldRealx4 ( const word &compoundName, bool forceUpdate @@ -676,7 +686,7 @@ pFlow::span pFlow::fieldsDataBase::updateFieldRealx4 } -pFlow::span pFlow::fieldsDataBase::updateFieldReal +pFlow::span pFlow::postprocessData::fieldsDataBase::updateFieldReal ( const word &compoundName, bool forceUpdate @@ -843,7 +853,7 @@ pFlow::span pFlow::fieldsDataBase::updateFieldReal return span(nullptr, 0); } -pFlow::span pFlow::fieldsDataBase::updateFieldUint32 +pFlow::span pFlow::postprocessData::fieldsDataBase::updateFieldUint32 ( const word& name, bool forceUpdate @@ -852,7 +862,7 @@ pFlow::span pFlow::fieldsDataBase::updateFieldUint32 return updateField(name, forceUpdate); } -pFlow::allPointFieldTypes pFlow::fieldsDataBase::updateFieldAll +pFlow::postprocessData::allPointFieldTypes pFlow::postprocessData::fieldsDataBase::updateFieldAll ( const word &compoundName, bool forceUpdate @@ -890,8 +900,8 @@ pFlow::allPointFieldTypes pFlow::fieldsDataBase::updateFieldAll -pFlow::uniquePtr - pFlow::fieldsDataBase::create +pFlow::uniquePtr + pFlow::postprocessData::fieldsDataBase::create ( systemControl& control, const dictionary& postDict, @@ -931,7 +941,12 @@ pFlow::uniquePtr return nullptr; } -bool pFlow::pointFieldGetType(const word& TYPENAME, word& fieldType, word& fieldSpace) +bool pFlow::postprocessData::pointFieldGetType +( + const word& TYPENAME, + word& fieldType, + word& fieldSpace +) { std::regex match("pointField\\<([A-Za-z1-9_]*)\\,([A-Za-z1-9_]*)\\>"); std::smatch search; diff --git a/src/PostprocessData/fieldsDataBase/fieldsDataBase.hpp b/src/PostprocessData/fieldsDataBase/fieldsDataBase.hpp index 6af3f2f9..822af933 100644 --- a/src/PostprocessData/fieldsDataBase/fieldsDataBase.hpp +++ b/src/PostprocessData/fieldsDataBase/fieldsDataBase.hpp @@ -29,13 +29,15 @@ Licence: #include "Map.hpp" #include "shape.hpp" - namespace pFlow { + class dictionary; + class systemControl; + class Time; +} -class dictionary; -class systemControl; -class Time; +namespace pFlow::postprocessData +{ class fieldsDataBase @@ -311,7 +313,7 @@ public: timeValue startTime); }; -} // namespace pFlow +} // namespace pFlow::postprocessData #include "fieldsDataBaseTemplates.cpp" diff --git a/src/PostprocessData/fieldsDataBase/fieldsDataBaseDclr.hpp b/src/PostprocessData/fieldsDataBase/fieldsDataBaseDclr.hpp index 283b5e7b..e5d483c0 100644 --- a/src/PostprocessData/fieldsDataBase/fieldsDataBaseDclr.hpp +++ b/src/PostprocessData/fieldsDataBase/fieldsDataBaseDclr.hpp @@ -9,7 +9,7 @@ #include "types.hpp" #include "span.hpp" -namespace pFlow +namespace pFlow::postprocessData { diff --git a/src/PostprocessData/fieldsDataBase/fieldsDataBaseTemplates.cpp b/src/PostprocessData/fieldsDataBase/fieldsDataBaseTemplates.cpp index b473e8c8..33cb0d87 100644 --- a/src/PostprocessData/fieldsDataBase/fieldsDataBaseTemplates.cpp +++ b/src/PostprocessData/fieldsDataBase/fieldsDataBaseTemplates.cpp @@ -23,9 +23,9 @@ Licence: #include "fieldsDataBase.hpp" -template +template inline -pFlow::span pFlow::fieldsDataBase::updateField(const word& name, bool forceUpdate) +pFlow::span pFlow::postprocessData::fieldsDataBase::updateField(const word& name, bool forceUpdate) { bool shouldUpdate = checkForUpdate(name, forceUpdate); @@ -40,8 +40,8 @@ pFlow::span pFlow::fieldsDataBase::updateField(const word& name, bool forceUp { if( loadPointFieldToTime(name) ) { - const auto& pField = time_.lookupObject>(name); - allFields_.emplaceBackOrReplace>( + const auto& pField = time_.template lookupObject>(name); + allFields_.template emplaceBackOrReplace>( name, pField.activeValuesHost()); } @@ -63,9 +63,9 @@ pFlow::span pFlow::fieldsDataBase::updateField(const word& name, bool forceUp } -template +template inline -pFlow::span pFlow::fieldsDataBase::updateReservedField +pFlow::span pFlow::postprocessData::fieldsDataBase::updateReservedField ( const word& name, bool forceUpdate diff --git a/src/PostprocessData/fieldsDataBase/simulationFieldsDataBase.cpp b/src/PostprocessData/fieldsDataBase/simulationFieldsDataBase.cpp index 9348037a..3e1683a0 100644 --- a/src/PostprocessData/fieldsDataBase/simulationFieldsDataBase.cpp +++ b/src/PostprocessData/fieldsDataBase/simulationFieldsDataBase.cpp @@ -8,29 +8,32 @@ namespace pFlow bool pointFieldGetType(const word& TYPENAME, word& fieldType, word& fieldSpace); } -bool pFlow::simulationFieldsDataBase::pointFieldNameExists(const word &name) const +bool pFlow::postprocessData::simulationFieldsDataBase::pointFieldNameExists(const word &name) const { return time().lookupObjectName(name); } -bool pFlow::simulationFieldsDataBase::loadPointFieldToTime(const word &name) +bool pFlow::postprocessData::simulationFieldsDataBase::loadPointFieldToTime(const word &name) { return time().lookupObjectName(name); } -bool pFlow::simulationFieldsDataBase::loadPointStructureToTime() +bool pFlow::postprocessData::simulationFieldsDataBase::loadPointStructureToTime() { // it is already in the Time object return time().lookupObjectName(pointStructureFile__); } -const pFlow::shape& pFlow::simulationFieldsDataBase::getShape() const +const pFlow::shape& pFlow::postprocessData::simulationFieldsDataBase::getShape() const { return shape_; } -pFlow::word pFlow::simulationFieldsDataBase::getPointFieldType(const word &name) const +pFlow::word pFlow::postprocessData::simulationFieldsDataBase::getPointFieldType +( + const word &name +) const { word pfType = time().lookupObjectTypeName(name); word type, space; @@ -44,7 +47,7 @@ pFlow::word pFlow::simulationFieldsDataBase::getPointFieldType(const word &name) return type; } -pFlow::simulationFieldsDataBase::simulationFieldsDataBase +pFlow::postprocessData::simulationFieldsDataBase::simulationFieldsDataBase ( systemControl &control, const dictionary& postDict, @@ -60,7 +63,7 @@ pFlow::simulationFieldsDataBase::simulationFieldsDataBase { } -const pFlow::pointStructure &pFlow::simulationFieldsDataBase::pStruct() const +const pFlow::pointStructure &pFlow::postprocessData::simulationFieldsDataBase::pStruct() const { return static_cast diff --git a/src/PostprocessData/fieldsDataBase/simulationFieldsDataBase.hpp b/src/PostprocessData/fieldsDataBase/simulationFieldsDataBase.hpp index de1d5b51..298a4957 100644 --- a/src/PostprocessData/fieldsDataBase/simulationFieldsDataBase.hpp +++ b/src/PostprocessData/fieldsDataBase/simulationFieldsDataBase.hpp @@ -23,7 +23,7 @@ Licence: #include "fieldsDataBase.hpp" -namespace pFlow +namespace pFlow::postprocessData { class simulationFieldsDataBase diff --git a/src/PostprocessData/operation/PostprocessOperation/PostprocessOperationAvMassVelocity.cpp b/src/PostprocessData/operation/PostprocessOperation/PostprocessOperationAvMassVelocity.cpp index 580d5ae0..b64ba902 100644 --- a/src/PostprocessData/operation/PostprocessOperation/PostprocessOperationAvMassVelocity.cpp +++ b/src/PostprocessData/operation/PostprocessOperation/PostprocessOperationAvMassVelocity.cpp @@ -1,6 +1,9 @@ #include "PostprocessOperationAvMassVelocity.hpp" -pFlow::PostprocessOperationAvMassVelocity::PostprocessOperationAvMassVelocity +namespace pFlow::postprocessData +{ + +PostprocessOperationAvMassVelocity::PostprocessOperationAvMassVelocity ( const dictionary &opDict, const regionPoints ®Points, @@ -17,4 +20,6 @@ pFlow::PostprocessOperationAvMassVelocity::PostprocessOperationAvMassVelocity fieldsDB ) { +} + } \ No newline at end of file diff --git a/src/PostprocessData/operation/PostprocessOperation/PostprocessOperationAvMassVelocity.hpp b/src/PostprocessData/operation/PostprocessOperation/PostprocessOperationAvMassVelocity.hpp index 5c0f164e..efa0478a 100644 --- a/src/PostprocessData/operation/PostprocessOperation/PostprocessOperationAvMassVelocity.hpp +++ b/src/PostprocessData/operation/PostprocessOperation/PostprocessOperationAvMassVelocity.hpp @@ -132,7 +132,7 @@ Licence: #include "regionField.hpp" #include "includeMask.hpp" -namespace pFlow +namespace pFlow::postprocessData { diff --git a/src/PostprocessData/operation/PostprocessOperation/PostprocessOperationAverage.cpp b/src/PostprocessData/operation/PostprocessOperation/PostprocessOperationAverage.cpp index 15474667..07a4411e 100644 --- a/src/PostprocessData/operation/PostprocessOperation/PostprocessOperationAverage.cpp +++ b/src/PostprocessData/operation/PostprocessOperation/PostprocessOperationAverage.cpp @@ -3,8 +3,11 @@ #include "fieldsDataBase.hpp" #include "operationFunctions.hpp" +namespace pFlow::postprocessData +{ + /// Constructs average processor and initializes result field based on input field type -pFlow::PostprocessOperationAverage::PostprocessOperationAverage +PostprocessOperationAverage::PostprocessOperationAverage ( const dictionary &opDict, const regionPoints ®Points, @@ -39,7 +42,7 @@ pFlow::PostprocessOperationAverage::PostprocessOperationAverage } } -pFlow::PostprocessOperationAverage::PostprocessOperationAverage +PostprocessOperationAverage::PostprocessOperationAverage ( const dictionary &opDict, const word &fieldName, @@ -79,7 +82,7 @@ pFlow::PostprocessOperationAverage::PostprocessOperationAverage /// Performs weighted average of field values within each region -bool pFlow::PostprocessOperationAverage::execute +bool PostprocessOperationAverage::execute ( const std::vector>& weights, const regionField& volFactor @@ -140,7 +143,7 @@ bool pFlow::PostprocessOperationAverage::execute return true; } -bool pFlow::PostprocessOperationAverage::write(const fileSystem &parDir) const +bool PostprocessOperationAverage::write(const fileSystem &parDir) const { if(! postprocessOperation::write(parDir)) { @@ -173,4 +176,6 @@ bool pFlow::PostprocessOperationAverage::write(const fileSystem &parDir) const ); return true; -} \ No newline at end of file +} + +} // namespace pFlow::postprocessData \ No newline at end of file diff --git a/src/PostprocessData/operation/PostprocessOperation/PostprocessOperationAverage.hpp b/src/PostprocessData/operation/PostprocessOperation/PostprocessOperationAverage.hpp index 4d71d54f..1840c0c4 100644 --- a/src/PostprocessData/operation/PostprocessOperation/PostprocessOperationAverage.hpp +++ b/src/PostprocessData/operation/PostprocessOperation/PostprocessOperationAverage.hpp @@ -132,10 +132,9 @@ Licence: #include "regionField.hpp" #include "includeMask.hpp" -namespace pFlow +namespace pFlow::postprocessData { - class PostprocessOperationAverage : public postprocessOperation @@ -207,6 +206,6 @@ public: }; -} +} // namespace pFlow::postprocessData #endif //__PostprocessOperationAverage_hpp__ \ No newline at end of file diff --git a/src/PostprocessData/operation/PostprocessOperation/PostprocessOperationSum.cpp b/src/PostprocessData/operation/PostprocessOperation/PostprocessOperationSum.cpp index c10315d7..1eec581f 100644 --- a/src/PostprocessData/operation/PostprocessOperation/PostprocessOperationSum.cpp +++ b/src/PostprocessData/operation/PostprocessOperation/PostprocessOperationSum.cpp @@ -3,8 +3,11 @@ #include "fieldsDataBase.hpp" #include "operationFunctions.hpp" +namespace pFlow::postprocessData +{ + /// Constructs sum processor and initializes result field based on input field type -pFlow::PostprocessOperationSum::PostprocessOperationSum +PostprocessOperationSum::PostprocessOperationSum ( const dictionary &opDict, const regionPoints ®Points, @@ -39,7 +42,7 @@ pFlow::PostprocessOperationSum::PostprocessOperationSum } /// Performs weighted sum of field values within each region -bool pFlow::PostprocessOperationSum::execute +bool PostprocessOperationSum::execute ( const std::vector>& weights, const regionField& volFactor @@ -72,3 +75,6 @@ bool pFlow::PostprocessOperationSum::execute return true; } + + +} \ No newline at end of file diff --git a/src/PostprocessData/operation/PostprocessOperation/PostprocessOperationSum.hpp b/src/PostprocessData/operation/PostprocessOperation/PostprocessOperationSum.hpp index b811e89b..4452be0e 100644 --- a/src/PostprocessData/operation/PostprocessOperation/PostprocessOperationSum.hpp +++ b/src/PostprocessData/operation/PostprocessOperation/PostprocessOperationSum.hpp @@ -129,7 +129,7 @@ Licence: #include "regionField.hpp" #include "includeMask.hpp" -namespace pFlow +namespace pFlow::postprocessData { @@ -182,6 +182,6 @@ public: }; -} +} // namespace pFlow::postprocessData #endif //__PostprocessOperationSum_hpp__ \ No newline at end of file diff --git a/src/PostprocessData/operation/PostprocessOperation/operationFunctions.hpp b/src/PostprocessData/operation/PostprocessOperation/operationFunctions.hpp index 8dbe643b..d9c23552 100644 --- a/src/PostprocessData/operation/PostprocessOperation/operationFunctions.hpp +++ b/src/PostprocessData/operation/PostprocessOperation/operationFunctions.hpp @@ -28,7 +28,7 @@ Licence: #include "regionField.hpp" #include "includeMask.hpp" -namespace pFlow +namespace pFlow::postprocessData { template @@ -190,6 +190,6 @@ regionField executeFluctuation2Operation return processedField; } -} // namespace pFlow +} // namespace pFlow::postprocessData #endif //__operationFunctions_hpp__ diff --git a/src/PostprocessData/operation/includeMask/IncludeMask.hpp b/src/PostprocessData/operation/includeMask/IncludeMask.hpp index 34ae4dfb..3689f22c 100644 --- a/src/PostprocessData/operation/includeMask/IncludeMask.hpp +++ b/src/PostprocessData/operation/includeMask/IncludeMask.hpp @@ -61,7 +61,7 @@ Licence: #include "Time.hpp" -namespace pFlow +namespace pFlow::postprocessData { template @@ -270,7 +270,7 @@ public: }; -} // pFlow +} // pFlow::postprocessData #endif //__IncludeMask_hpp__ diff --git a/src/PostprocessData/operation/includeMask/IncludeMasks.cpp b/src/PostprocessData/operation/includeMask/IncludeMasks.cpp index 8fd6cd3e..7e8e687c 100644 --- a/src/PostprocessData/operation/includeMask/IncludeMasks.cpp +++ b/src/PostprocessData/operation/includeMask/IncludeMasks.cpp @@ -20,31 +20,34 @@ Licence: #include "IncludeMask.hpp" +namespace pFlow::postprocessData +{ + // real -template class pFlow::IncludeMask >; -template class pFlow::IncludeMask >; +template class IncludeMask >; +template class IncludeMask >; -template class pFlow::IncludeMask >; -template class pFlow::IncludeMask >; +template class IncludeMask >; +template class IncludeMask >; -template class pFlow::IncludeMask >; +template class IncludeMask >; -template class pFlow::IncludeMask >; -template class pFlow::IncludeMask >; +template class IncludeMask >; +template class IncludeMask >; -template class pFlow::IncludeMask>; +template class IncludeMask>; // realx3 -template class pFlow::IncludeMask >; -template class pFlow::IncludeMask >; +template class IncludeMask >; +template class IncludeMask >; -template class pFlow::IncludeMask >; -template class pFlow::IncludeMask >; +template class IncludeMask >; +template class IncludeMask >; -template class pFlow::IncludeMask >; +template class IncludeMask >; -template class pFlow::IncludeMask >; -template class pFlow::IncludeMask >; +template class IncludeMask >; +template class IncludeMask >; -// realx4 +} // postprocessData diff --git a/src/PostprocessData/operation/includeMask/includeMask.cpp b/src/PostprocessData/operation/includeMask/includeMask.cpp index 209391be..6ba84aa8 100644 --- a/src/PostprocessData/operation/includeMask/includeMask.cpp +++ b/src/PostprocessData/operation/includeMask/includeMask.cpp @@ -24,7 +24,10 @@ Licence: #include "fieldsDataBase.hpp" -pFlow::includeMask::includeMask +namespace pFlow::postprocessData +{ + +includeMask::includeMask ( const dictionary& dict, fieldsDataBase& fieldDB @@ -33,7 +36,7 @@ pFlow::includeMask::includeMask database_(fieldDB) {} -pFlow::includeMask::includeMask +includeMask::includeMask ( const word &type, const dictionary &opDict, @@ -44,7 +47,7 @@ pFlow::includeMask::includeMask { } -pFlow::uniquePtr pFlow::includeMask::create +uniquePtr includeMask::create ( const dictionary& opDict, fieldsDataBase& fieldsDB @@ -97,8 +100,7 @@ pFlow::uniquePtr pFlow::includeMask::create return nullptr; } -pFlow::uniquePtr - pFlow::includeMask::create +uniquePtr includeMask::create ( const word &type, const dictionary &opDict, @@ -150,3 +152,5 @@ pFlow::uniquePtr } return nullptr; } + +} \ No newline at end of file diff --git a/src/PostprocessData/operation/includeMask/includeMask.hpp b/src/PostprocessData/operation/includeMask/includeMask.hpp index 928822b8..1f58a31a 100644 --- a/src/PostprocessData/operation/includeMask/includeMask.hpp +++ b/src/PostprocessData/operation/includeMask/includeMask.hpp @@ -47,11 +47,15 @@ Licence: #include "virtualConstructor.hpp" namespace pFlow +{ + class dictionary; +} + +namespace pFlow::postprocessData { // forward declaration class fieldsDataBase; -class dictionary; class includeMask @@ -188,7 +192,7 @@ public: -} // pFlow +} // pFlow::postprocessData #endif //__IncludeMask_hpp__ diff --git a/src/PostprocessData/operation/includeMask/maskOperations.hpp b/src/PostprocessData/operation/includeMask/maskOperations.hpp index 63bb5665..054ea240 100644 --- a/src/PostprocessData/operation/includeMask/maskOperations.hpp +++ b/src/PostprocessData/operation/includeMask/maskOperations.hpp @@ -24,7 +24,7 @@ Licence: #include "types.hpp" #include "dictionary.hpp" -namespace pFlow +namespace pFlow::postprocessData { template @@ -176,6 +176,6 @@ public: } }; -} +} // namespace pFlow::postprocessData #endif //__maskOperation_hpp__ \ No newline at end of file diff --git a/src/PostprocessData/operation/postprocessOperation/postprocessOperation.cpp b/src/PostprocessData/operation/postprocessOperation/postprocessOperation.cpp index 3eedd066..b123f0af 100644 --- a/src/PostprocessData/operation/postprocessOperation/postprocessOperation.cpp +++ b/src/PostprocessData/operation/postprocessOperation/postprocessOperation.cpp @@ -24,7 +24,10 @@ Licence: #include "fieldsDataBase.hpp" -pFlow::postprocessOperation::postprocessOperation +namespace pFlow::postprocessData +{ + +postprocessOperation::postprocessOperation ( const dictionary &opDict, const regionPoints& regPoints, @@ -42,7 +45,7 @@ pFlow::postprocessOperation::postprocessOperation ) {} -pFlow::postprocessOperation::postprocessOperation +postprocessOperation::postprocessOperation ( const dictionary &opDict, const word &fieldName, @@ -89,12 +92,12 @@ pFlow::postprocessOperation::postprocessOperation fatalExit; } } -const pFlow::Time& pFlow::postprocessOperation::time() const +const Time& postprocessOperation::time() const { return database_.time(); } -bool pFlow::postprocessOperation::write(const fileSystem &parDir) const +bool postprocessOperation::write(const fileSystem &parDir) const { auto ti = time().TimeInfo(); @@ -121,11 +124,12 @@ bool pFlow::postprocessOperation::write(const fileSystem &parDir) const return true; } -pFlow::uniquePtr -pFlow::postprocessOperation::create( +uniquePtr postprocessOperation::create +( const dictionary &opDict, const regionPoints ®Points, - fieldsDataBase &fieldsDB) + fieldsDataBase &fieldsDB +) { word func = opDict.getVal("function"); word method = angleBracketsNames("PostprocessOperation", func); @@ -151,3 +155,5 @@ pFlow::postprocessOperation::create( return nullptr; } } + +} \ No newline at end of file diff --git a/src/PostprocessData/operation/postprocessOperation/postprocessOperation.hpp b/src/PostprocessData/operation/postprocessOperation/postprocessOperation.hpp index 61ee263e..73aa3112 100644 --- a/src/PostprocessData/operation/postprocessOperation/postprocessOperation.hpp +++ b/src/PostprocessData/operation/postprocessOperation/postprocessOperation.hpp @@ -80,12 +80,15 @@ Licence: namespace pFlow { + class Time; +} - +namespace pFlow::postprocessData +{ /// - forward declaration class fieldsDataBase; -class Time; + class postprocessOperation { @@ -96,7 +99,7 @@ public: private: /// Dictionary containing operation-specific parameters. - dictionary operationDict_; + pFlow::dictionary operationDict_; /// This Threshold is used to exclude the regions which contain /// fewer than this value. @@ -266,6 +269,6 @@ public: }; -} +} // namespace pFlow::postprocessData #endif //__postprocessOperation_hpp__ \ No newline at end of file diff --git a/src/PostprocessData/operation/postprocessOperation/postprocessOperationFunctions.hpp b/src/PostprocessData/operation/postprocessOperation/postprocessOperationFunctions.hpp index 82376fd1..5356cf84 100644 --- a/src/PostprocessData/operation/postprocessOperation/postprocessOperationFunctions.hpp +++ b/src/PostprocessData/operation/postprocessOperation/postprocessOperationFunctions.hpp @@ -27,7 +27,7 @@ Licence: #include "iOstream.hpp" #include "regionField.hpp" -namespace pFlow +namespace pFlow::postprocessData { /// Type alias for processed region field types. @@ -95,6 +95,6 @@ bool writeField return true; } -} // namespace pFlow +} // namespace pFlow::postprocessData #endif //__postprocessOperationFunctions_hpp__ \ No newline at end of file diff --git a/src/PostprocessData/postprocessComponent/PostprocessComponent/PostprocessComponent.cpp b/src/PostprocessData/postprocessComponent/PostprocessComponent/PostprocessComponent.cpp index 10590f7c..90dcff16 100644 --- a/src/PostprocessData/postprocessComponent/PostprocessComponent/PostprocessComponent.cpp +++ b/src/PostprocessData/postprocessComponent/PostprocessComponent/PostprocessComponent.cpp @@ -20,7 +20,7 @@ Licence: -----------------------------------------------------------------------------*/ template -pFlow::PostprocessComponent::PostprocessComponent +pFlow::postprocessData::PostprocessComponent::PostprocessComponent ( const dictionary& dict, fieldsDataBase& fieldsDB, @@ -61,7 +61,7 @@ pFlow::PostprocessComponent::PostprocessComponent template -bool pFlow::PostprocessComponent::execute +bool pFlow::postprocessData::PostprocessComponent::execute ( const timeInfo &ti, bool forceUpdate @@ -129,7 +129,7 @@ bool pFlow::PostprocessComponent::execute template inline -bool pFlow::PostprocessComponent::write +bool pFlow::postprocessData::PostprocessComponent::write ( const fileSystem &parDir ) const diff --git a/src/PostprocessData/postprocessComponent/PostprocessComponent/PostprocessComponent.hpp b/src/PostprocessData/postprocessComponent/PostprocessComponent/PostprocessComponent.hpp index 996467a1..cc6ead75 100644 --- a/src/PostprocessData/postprocessComponent/PostprocessComponent/PostprocessComponent.hpp +++ b/src/PostprocessData/postprocessComponent/PostprocessComponent/PostprocessComponent.hpp @@ -32,7 +32,7 @@ Licence: #include "regionPoints.hpp" #include "regionField.hpp" -namespace pFlow +namespace pFlow::postprocessData { template diff --git a/src/PostprocessData/postprocessComponent/PostprocessComponent/PostprocessComponentArithmetic.hpp b/src/PostprocessData/postprocessComponent/PostprocessComponent/PostprocessComponentArithmetic.hpp index 7b9a37c3..aa335dd6 100644 --- a/src/PostprocessData/postprocessComponent/PostprocessComponent/PostprocessComponentArithmetic.hpp +++ b/src/PostprocessData/postprocessComponent/PostprocessComponent/PostprocessComponentArithmetic.hpp @@ -24,7 +24,7 @@ Licence: #include "PostprocessComponent.hpp" #include "arithmetic.hpp" -namespace pFlow +namespace pFlow::postprocessData { template diff --git a/src/PostprocessData/postprocessComponent/PostprocessComponent/PostprocessComponentGaussian.hpp b/src/PostprocessData/postprocessComponent/PostprocessComponent/PostprocessComponentGaussian.hpp index 0fb00163..2f5cbd3e 100644 --- a/src/PostprocessData/postprocessComponent/PostprocessComponent/PostprocessComponentGaussian.hpp +++ b/src/PostprocessData/postprocessComponent/PostprocessComponent/PostprocessComponentGaussian.hpp @@ -25,7 +25,7 @@ Licence: #include "GaussianDistribution.hpp" #include "numericConstants.hpp" -namespace pFlow +namespace pFlow::postprocessData { template diff --git a/src/PostprocessData/postprocessComponent/PostprocessComponent/PostprocessComponentUniform.hpp b/src/PostprocessData/postprocessComponent/PostprocessComponent/PostprocessComponentUniform.hpp index 5a181474..93f0d9d2 100644 --- a/src/PostprocessData/postprocessComponent/PostprocessComponent/PostprocessComponentUniform.hpp +++ b/src/PostprocessData/postprocessComponent/PostprocessComponent/PostprocessComponentUniform.hpp @@ -24,7 +24,7 @@ Licence: #include "PostprocessComponent.hpp" #include "uniformDistribution.hpp" -namespace pFlow +namespace pFlow::postprocessData { template diff --git a/src/PostprocessData/postprocessComponent/PostprocessComponent/PostprocessComponents.cpp b/src/PostprocessData/postprocessComponent/PostprocessComponent/PostprocessComponents.cpp index 2a6245a5..5556e342 100644 --- a/src/PostprocessData/postprocessComponent/PostprocessComponent/PostprocessComponents.cpp +++ b/src/PostprocessData/postprocessComponent/PostprocessComponent/PostprocessComponents.cpp @@ -27,16 +27,18 @@ Licence: #include "lineRegionPoints.hpp" #include "multipleSpheresRegionPoints.hpp" +namespace pFlow::postprocessData +{ +template class PostprocessComponentGaussian; +template class PostprocessComponentUniform; +template class PostprocessComponentArithmetic; -template class pFlow::PostprocessComponentGaussian; -template class pFlow::PostprocessComponentUniform; -template class pFlow::PostprocessComponentArithmetic; +template class PostprocessComponentGaussian; +template class PostprocessComponentUniform; +template class PostprocessComponentArithmetic; -template class pFlow::PostprocessComponentGaussian; -template class pFlow::PostprocessComponentUniform; -template class pFlow::PostprocessComponentArithmetic; - -template class pFlow::PostprocessComponentGaussian; -template class pFlow::PostprocessComponentUniform; -template class pFlow::PostprocessComponentArithmetic; +template class PostprocessComponentGaussian; +template class PostprocessComponentUniform; +template class PostprocessComponentArithmetic; +} \ No newline at end of file diff --git a/src/PostprocessData/postprocessComponent/particleProbePostprocessComponent/particleProbePostprocessComponent.cpp b/src/PostprocessData/postprocessComponent/particleProbePostprocessComponent/particleProbePostprocessComponent.cpp index 7588e602..3c390cc9 100644 --- a/src/PostprocessData/postprocessComponent/particleProbePostprocessComponent/particleProbePostprocessComponent.cpp +++ b/src/PostprocessData/postprocessComponent/particleProbePostprocessComponent/particleProbePostprocessComponent.cpp @@ -1,7 +1,27 @@ +/*------------------------------- phasicFlow --------------------------------- + O C enter of + O O E ngineering and + O O M ultiscale modeling of + OOOOOOO F luid flow +------------------------------------------------------------------------------ + Copyright (C): www.cemf.ir + email: hamid.r.norouzi AT gmail.com +------------------------------------------------------------------------------ +Licence: + This file is part of phasicFlow code. It is a free software for simulating + granular and multiphase flows. You can redistribute it and/or modify it under + the terms of GNU General Public License v3 or any other later versions. + + phasicFlow is distributed to help others in their research in the field of + granular and multiphase flows, but WITHOUT ANY WARRANTY; without even the + implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. + +-----------------------------------------------------------------------------*/ + #include "particleProbePostprocessComponent.hpp" #include "Time.hpp" -namespace pFlow +namespace pFlow::postprocessData { template @@ -62,7 +82,7 @@ inline bool writeField } -pFlow::particleProbePostprocessComponent::particleProbePostprocessComponent +pFlow::postprocessData::particleProbePostprocessComponent::particleProbePostprocessComponent ( const dictionary &dict, fieldsDataBase &fieldsDB, @@ -81,7 +101,7 @@ pFlow::particleProbePostprocessComponent::particleProbePostprocessComponent name_(dict.name()) {} -bool pFlow::particleProbePostprocessComponent::execute +bool pFlow::postprocessData::particleProbePostprocessComponent::execute ( const timeInfo &ti, bool forceExecute @@ -126,7 +146,7 @@ bool pFlow::particleProbePostprocessComponent::execute } -bool pFlow::particleProbePostprocessComponent::write(const fileSystem& parDir)const +bool pFlow::postprocessData::particleProbePostprocessComponent::write(const fileSystem& parDir)const { if(! executed_ ) return true; diff --git a/src/PostprocessData/postprocessComponent/particleProbePostprocessComponent/particleProbePostprocessComponent.hpp b/src/PostprocessData/postprocessComponent/particleProbePostprocessComponent/particleProbePostprocessComponent.hpp index 5069e291..808e6615 100644 --- a/src/PostprocessData/postprocessComponent/particleProbePostprocessComponent/particleProbePostprocessComponent.hpp +++ b/src/PostprocessData/postprocessComponent/particleProbePostprocessComponent/particleProbePostprocessComponent.hpp @@ -27,7 +27,7 @@ Licence: #include "regionField.hpp" #include "oFstream.hpp" -namespace pFlow +namespace pFlow::postprocessData { diff --git a/src/PostprocessData/postprocessComponent/postprocessComponent/postprocessComponent.cpp b/src/PostprocessData/postprocessComponent/postprocessComponent/postprocessComponent.cpp index ed2e3b6c..d7882334 100644 --- a/src/PostprocessData/postprocessComponent/postprocessComponent/postprocessComponent.cpp +++ b/src/PostprocessData/postprocessComponent/postprocessComponent/postprocessComponent.cpp @@ -1,9 +1,29 @@ +/*------------------------------- phasicFlow --------------------------------- + O C enter of + O O E ngineering and + O O M ultiscale modeling of + OOOOOOO F luid flow +------------------------------------------------------------------------------ + Copyright (C): www.cemf.ir + email: hamid.r.norouzi AT gmail.com +------------------------------------------------------------------------------ +Licence: + This file is part of phasicFlow code. It is a free software for simulating + granular and multiphase flows. You can redistribute it and/or modify it under + the terms of GNU General Public License v3 or any other later versions. + + phasicFlow is distributed to help others in their research in the field of + granular and multiphase flows, but WITHOUT ANY WARRANTY; without even the + implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. + +-----------------------------------------------------------------------------*/ + #include "postprocessComponent.hpp" #include "fieldsDataBase.hpp" #include "Time.hpp" -pFlow::postprocessComponent::postprocessComponent +pFlow::postprocessData::postprocessComponent::postprocessComponent ( const dictionary &dict, fieldsDataBase &fieldsDB, @@ -23,7 +43,7 @@ pFlow::postprocessComponent::postprocessComponent } -pFlow::uniquePtr pFlow::postprocessComponent::create +pFlow::uniquePtr pFlow::postprocessData::postprocessComponent::create ( const dictionary& dict, fieldsDataBase& fieldsDB, diff --git a/src/PostprocessData/postprocessComponent/postprocessComponent/postprocessComponent.hpp b/src/PostprocessData/postprocessComponent/postprocessComponent/postprocessComponent.hpp index 70db2153..1f6c633f 100644 --- a/src/PostprocessData/postprocessComponent/postprocessComponent/postprocessComponent.hpp +++ b/src/PostprocessData/postprocessComponent/postprocessComponent/postprocessComponent.hpp @@ -25,12 +25,17 @@ Licence: #include "dictionary.hpp" #include "virtualConstructor.hpp" -namespace pFlow +namespace +{ + class dictionary; +} + +namespace pFlow::postprocessData { -class fieldsDataBase; + class regionPoints; -class dictionary; +class fieldsDataBase; class postprocessComponent { @@ -112,6 +117,6 @@ public: }; -} // namespace pFlow +} // namespace pFlow::postprocessData #endif // __postprocessComponent_hpp__ \ No newline at end of file diff --git a/src/PostprocessData/postprocessData/postprocessData.cpp b/src/PostprocessData/postprocessData/postprocessData.cpp index ac76c26b..967bcfda 100644 --- a/src/PostprocessData/postprocessData/postprocessData.cpp +++ b/src/PostprocessData/postprocessData/postprocessData.cpp @@ -1,4 +1,3 @@ - /*------------------------------- phasicFlow --------------------------------- O C enter of O O E ngineering and @@ -25,7 +24,7 @@ Licence: #include "postprocessGlobals.hpp" #include "postprocessComponent.hpp" -pFlow::postprocessData::postprocessData +pFlow::postprocessData::postprocessData::postprocessData ( const systemControl &control, timeValue startTime @@ -45,7 +44,7 @@ pFlow::postprocessData::postprocessData ) ) { - postProcessGlobals::defaultDir__ = CWD()/pFlow::postProcessGlobals::defaultRelDir__; + defaultDir__ = CWD()/defaultRelDir__; // if dictionary is not provided, no extra action is required. if( !dict_.fileExist() || !dict_.headerOk() ) @@ -98,7 +97,7 @@ pFlow::postprocessData::postprocessData } -bool pFlow::postprocessData::execute() +bool pFlow::postprocessData::postprocessData::execute() { if( inSimulation_ && !activeInSimulation_() ) return true; @@ -118,7 +117,7 @@ bool pFlow::postprocessData::execute() return true; } -bool pFlow::postprocessData::write() const +bool pFlow::postprocessData::postprocessData::write() const { if( inSimulation_ && !activeInSimulation_() ) return true; @@ -129,7 +128,7 @@ bool pFlow::postprocessData::write() const continue; } - if(!component->write(postProcessGlobals::defaultDir__/component->name())) + if(!component->write(defaultDir__/component->name())) { fatalErrorInFunction <<"Error occured in writing postprocess component: " @@ -140,7 +139,7 @@ bool pFlow::postprocessData::write() const return true; } -void pFlow::postprocessData::setOutputDirectory(const fileSystem &path) const +void pFlow::postprocessData::postprocessData::setOutputDirectory(const fileSystem &path) const { - postProcessGlobals::defaultDir__ = path; + defaultDir__ = path; } diff --git a/src/PostprocessData/postprocessData/postprocessData.hpp b/src/PostprocessData/postprocessData/postprocessData.hpp index 04ae6188..553c3d22 100644 --- a/src/PostprocessData/postprocessData/postprocessData.hpp +++ b/src/PostprocessData/postprocessData/postprocessData.hpp @@ -28,14 +28,18 @@ Licence: #include "fieldsDataBase.hpp" #include "postprocessComponent.hpp" - -namespace pFlow +namespace pFlow { class systemControl; class Time; class timeInfo; +} + +namespace pFlow::postprocessData +{ + /** * @class postprocessData @@ -109,6 +113,6 @@ public: void setOutputDirectory(const fileSystem& path)const; }; -} // namespace pFlow +} // namespace pFlow::postprocessData #endif // __postprocessData_hpp__ \ No newline at end of file diff --git a/src/PostprocessData/postprocessData/postprocessGlobals.hpp b/src/PostprocessData/postprocessData/postprocessGlobals.hpp index 335bc267..f7ba18ec 100644 --- a/src/PostprocessData/postprocessData/postprocessGlobals.hpp +++ b/src/PostprocessData/postprocessData/postprocessGlobals.hpp @@ -23,7 +23,7 @@ Licence: #include "fileSystem.hpp" -namespace pFlow::postProcessGlobals +namespace pFlow::postprocessData { static fileSystem defaultDir__; diff --git a/src/PostprocessData/postprocessData/postprocessTimeControl.hpp b/src/PostprocessData/postprocessData/postprocessTimeControl.hpp index f70cfd2a..1d2689ea 100644 --- a/src/PostprocessData/postprocessData/postprocessTimeControl.hpp +++ b/src/PostprocessData/postprocessData/postprocessTimeControl.hpp @@ -22,9 +22,11 @@ Licence: #define __postprocessTimeControl_hpp__ #include "baseTimeControl.hpp" +#include "dictionary.hpp" -namespace pFlow +namespace pFlow::postprocessData { + class postprocessTimeControl : public baseTimeControl @@ -60,6 +62,6 @@ postprocessTimeControl( // Additional methods and members can be added here }; -} // namespace pFlow +} // namespace pFlow::postprocessData #endif // __postprocessTimeControl_hpp__ \ No newline at end of file diff --git a/src/PostprocessData/readme.md b/src/PostprocessData/readme.md index 050420d4..ee1431ca 100644 --- a/src/PostprocessData/readme.md +++ b/src/PostprocessData/readme.md @@ -169,7 +169,7 @@ In addition to the above basic functions, some derived functions are available f | Function | Property type | Description | Formula | Required Parameters | |----------|---------------|-------------|---------|---------------------| -|`avMassVelocity` | bulk | Average velocity weighted by mass | $\frac{\sum_{i \in \text{region}} m_i \cdot v_i}{\sum_{i \in \text{region}} m_i}$ | - | +|`avMassVelocity` | bulk | Average velocity weighted by mass | $\frac{\sum_{i \in \text{region}} w_i \cdot m_i \cdot v_i}{\sum_{i \in \text{region}} w_i \cdot m_i}$ | - | ### 6.4. Available Fields diff --git a/src/PostprocessData/region/regionFields/regionField.hpp b/src/PostprocessData/region/regionFields/regionField.hpp index 1996fed1..9094cd34 100644 --- a/src/PostprocessData/region/regionFields/regionField.hpp +++ b/src/PostprocessData/region/regionFields/regionField.hpp @@ -25,7 +25,7 @@ Licence: #include "regionPoints.hpp" #include "Field.hpp" -namespace pFlow +namespace pFlow::postprocessData { template @@ -119,7 +119,7 @@ public: }; -} // namespace pFlow +} // namespace pFlow::postprocessData #include "regionFieldTemplate.cpp" diff --git a/src/PostprocessData/region/regionFields/regionFieldTemplate.cpp b/src/PostprocessData/region/regionFields/regionFieldTemplate.cpp index 65112474..408107c6 100644 --- a/src/PostprocessData/region/regionFields/regionFieldTemplate.cpp +++ b/src/PostprocessData/region/regionFields/regionFieldTemplate.cpp @@ -1,10 +1,14 @@ +namespace pFlow::postprocessData +{ template -pFlow::regionField::regionField( +regionField::regionField( const word& name, const regionPoints& rPoints, const T defaultVal) : field_(name, "regionFieldValue", rPoints.size(), rPoints.size(), defaultVal), regionPoints_(rPoints) -{} \ No newline at end of file +{} + +} // End namespace pFlow::postprocessData \ No newline at end of file diff --git a/src/PostprocessData/region/regionPoints/centerPointsRegionPoints/centerPointsRegionPoints.cpp b/src/PostprocessData/region/regionPoints/centerPointsRegionPoints/centerPointsRegionPoints.cpp index b5ffb730..73aaf7f2 100644 --- a/src/PostprocessData/region/regionPoints/centerPointsRegionPoints/centerPointsRegionPoints.cpp +++ b/src/PostprocessData/region/regionPoints/centerPointsRegionPoints/centerPointsRegionPoints.cpp @@ -3,7 +3,10 @@ #include "Set.hpp" #include "pStructSelector.hpp" -bool pFlow::centerPointsRegionPoints::selectIds() +namespace pFlow::postprocessData +{ + +bool centerPointsRegionPoints::selectIds() { if(!firstTimeUpdate_) return true; firstTimeUpdate_ = false; @@ -42,7 +45,7 @@ bool pFlow::centerPointsRegionPoints::selectIds() return true; } -pFlow::centerPointsRegionPoints::centerPointsRegionPoints( +centerPointsRegionPoints::centerPointsRegionPoints( const dictionary &dict, fieldsDataBase &fieldsDataBase) : regionPoints(dict, fieldsDataBase), @@ -50,7 +53,7 @@ pFlow::centerPointsRegionPoints::centerPointsRegionPoints( probDict_(dict) {} -bool pFlow::centerPointsRegionPoints::update() +bool centerPointsRegionPoints::update() { if(!selectIds()) return false; @@ -74,7 +77,7 @@ bool pFlow::centerPointsRegionPoints::update() return true; } -bool pFlow::centerPointsRegionPoints::write(iOstream &os) const +bool centerPointsRegionPoints::write(iOstream &os) const { if(firstTimeUpdate_) { @@ -95,3 +98,5 @@ bool pFlow::centerPointsRegionPoints::write(iOstream &os) const return true; } + +} // End namespace pFlow::postprocessData diff --git a/src/PostprocessData/region/regionPoints/centerPointsRegionPoints/centerPointsRegionPoints.hpp b/src/PostprocessData/region/regionPoints/centerPointsRegionPoints/centerPointsRegionPoints.hpp index 1da7cc4f..979018fc 100644 --- a/src/PostprocessData/region/regionPoints/centerPointsRegionPoints/centerPointsRegionPoints.hpp +++ b/src/PostprocessData/region/regionPoints/centerPointsRegionPoints/centerPointsRegionPoints.hpp @@ -23,7 +23,7 @@ Licence: #include "regionPoints.hpp" -namespace pFlow +namespace pFlow::postprocessData { /** @@ -163,7 +163,7 @@ public: }; // class centerPointsRegionPoints -} // namespace pFlow +} // namespace pFlow::postprocessData diff --git a/src/PostprocessData/region/regionPoints/lineRegionPoints/lineRegionPoints.cpp b/src/PostprocessData/region/regionPoints/lineRegionPoints/lineRegionPoints.cpp index 5d3e4482..c313321c 100644 --- a/src/PostprocessData/region/regionPoints/lineRegionPoints/lineRegionPoints.cpp +++ b/src/PostprocessData/region/regionPoints/lineRegionPoints/lineRegionPoints.cpp @@ -1,7 +1,10 @@ #include "lineRegionPoints.hpp" #include "fieldsDataBase.hpp" -pFlow::lineRegionPoints::lineRegionPoints +namespace pFlow::postprocessData +{ + +lineRegionPoints::lineRegionPoints ( const dictionary &dict, fieldsDataBase &fieldsDataBase @@ -50,7 +53,7 @@ pFlow::lineRegionPoints::lineRegionPoints } } -pFlow::span pFlow::lineRegionPoints::indices(uint32 elem) const +pFlow::span lineRegionPoints::indices(uint32 elem) const { if(elem >= size()) { @@ -65,7 +68,7 @@ pFlow::span pFlow::lineRegionPoints::indices(uint32 elem) c selectedPoints_[elem].size()); } -pFlow::span pFlow::lineRegionPoints::indices(uint32 elem) +pFlow::span lineRegionPoints::indices(uint32 elem) { if(elem >= size()) { @@ -80,7 +83,7 @@ pFlow::span pFlow::lineRegionPoints::indices(uint32 elem) selectedPoints_[elem].size()); } -bool pFlow::lineRegionPoints::update() +bool lineRegionPoints::update() { const auto points = database().updatePoints(); for(auto& elem : selectedPoints_) @@ -101,7 +104,7 @@ bool pFlow::lineRegionPoints::update() return true; } -bool pFlow::lineRegionPoints::write(iOstream &os) const +bool lineRegionPoints::write(iOstream &os) const { os << "# Spheres along a straight line \n"; os << "# No." << tab << "centerPoint" << tab << "diameter" << endl; @@ -118,3 +121,5 @@ bool pFlow::lineRegionPoints::write(iOstream &os) const os << endl; return true; } + +} // End namespace pFlow::postprocessData diff --git a/src/PostprocessData/region/regionPoints/lineRegionPoints/lineRegionPoints.hpp b/src/PostprocessData/region/regionPoints/lineRegionPoints/lineRegionPoints.hpp index 58989aab..8271d917 100644 --- a/src/PostprocessData/region/regionPoints/lineRegionPoints/lineRegionPoints.hpp +++ b/src/PostprocessData/region/regionPoints/lineRegionPoints/lineRegionPoints.hpp @@ -54,7 +54,7 @@ Licence: #include "Vectors.hpp" -namespace pFlow +namespace pFlow::postprocessData { class lineRegionPoints diff --git a/src/PostprocessData/region/regionPoints/multipleSpheresRegionPoints/multipleSpheresRegionPoints.cpp b/src/PostprocessData/region/regionPoints/multipleSpheresRegionPoints/multipleSpheresRegionPoints.cpp index e983c602..8dae8757 100644 --- a/src/PostprocessData/region/regionPoints/multipleSpheresRegionPoints/multipleSpheresRegionPoints.cpp +++ b/src/PostprocessData/region/regionPoints/multipleSpheresRegionPoints/multipleSpheresRegionPoints.cpp @@ -1,7 +1,10 @@ #include "multipleSpheresRegionPoints.hpp" #include "fieldsDataBase.hpp" -pFlow::multipleSpheresRegionPoints::multipleSpheresRegionPoints +namespace pFlow::postprocessData +{ + +multipleSpheresRegionPoints::multipleSpheresRegionPoints ( const dictionary &dict, fieldsDataBase &fieldsDataBase @@ -46,7 +49,7 @@ pFlow::multipleSpheresRegionPoints::multipleSpheresRegionPoints } } -pFlow::span pFlow::multipleSpheresRegionPoints::indices(uint32 elem) const +pFlow::span multipleSpheresRegionPoints::indices(uint32 elem) const { if (elem >= size()) { @@ -59,7 +62,7 @@ pFlow::span pFlow::multipleSpheresRegionPoints::indices(uin return span(selectedPoints_[elem].data(), selectedPoints_[elem].size()); } -pFlow::span pFlow::multipleSpheresRegionPoints::indices(uint32 elem) +pFlow::span multipleSpheresRegionPoints::indices(uint32 elem) { if (elem >= size()) { @@ -73,7 +76,7 @@ pFlow::span pFlow::multipleSpheresRegionPoints::indices(uint32 el } -bool pFlow::multipleSpheresRegionPoints::update() +bool multipleSpheresRegionPoints::update() { const auto points = database().updatePoints(); for (auto& elem : selectedPoints_) @@ -94,7 +97,7 @@ bool pFlow::multipleSpheresRegionPoints::update() return true; } -bool pFlow::multipleSpheresRegionPoints::write(iOstream &os) const +bool multipleSpheresRegionPoints::write(iOstream &os) const { os << "# Multiple spheres region points\n"; os << "# No." << tab << "centerPoint" << tab << "diameter" << endl; @@ -110,3 +113,5 @@ bool pFlow::multipleSpheresRegionPoints::write(iOstream &os) const os << endl; return true; } + +} // End namespace pFlow::postprocessData diff --git a/src/PostprocessData/region/regionPoints/multipleSpheresRegionPoints/multipleSpheresRegionPoints.hpp b/src/PostprocessData/region/regionPoints/multipleSpheresRegionPoints/multipleSpheresRegionPoints.hpp index e01da658..8a67549c 100644 --- a/src/PostprocessData/region/regionPoints/multipleSpheresRegionPoints/multipleSpheresRegionPoints.hpp +++ b/src/PostprocessData/region/regionPoints/multipleSpheresRegionPoints/multipleSpheresRegionPoints.hpp @@ -51,7 +51,7 @@ Licence: #include "sphere.hpp" #include "Vectors.hpp" -namespace pFlow +namespace pFlow::postprocessData { class multipleSpheresRegionPoints diff --git a/src/PostprocessData/region/regionPoints/regionPoints/regionPoints.cpp b/src/PostprocessData/region/regionPoints/regionPoints/regionPoints.cpp index 20599503..696c33a4 100644 --- a/src/PostprocessData/region/regionPoints/regionPoints/regionPoints.cpp +++ b/src/PostprocessData/region/regionPoints/regionPoints/regionPoints.cpp @@ -2,7 +2,10 @@ #include "fieldsDataBase.hpp" #include "Time.hpp" -pFlow::regionPoints::regionPoints +namespace pFlow::postprocessData +{ + +regionPoints::regionPoints ( const dictionary &dict, fieldsDataBase &fieldsDataBase @@ -11,18 +14,20 @@ pFlow::regionPoints::regionPoints fieldsDataBase_(fieldsDataBase) {} -const pFlow::Time& pFlow::regionPoints::time() const +const Time& regionPoints::time() const { return fieldsDataBase_.time(); } -const pFlow::fieldsDataBase & pFlow::regionPoints::database() const +const fieldsDataBase & regionPoints::database() const { return fieldsDataBase_; } -pFlow::fieldsDataBase& pFlow::regionPoints::database() +fieldsDataBase& regionPoints::database() { return fieldsDataBase_; } +} // namespace pFlow::postprocessData + diff --git a/src/PostprocessData/region/regionPoints/regionPoints/regionPoints.hpp b/src/PostprocessData/region/regionPoints/regionPoints/regionPoints.hpp index 0931175f..54cca825 100644 --- a/src/PostprocessData/region/regionPoints/regionPoints/regionPoints.hpp +++ b/src/PostprocessData/region/regionPoints/regionPoints/regionPoints.hpp @@ -25,12 +25,16 @@ Licence: #include "dictionary.hpp" #include "pointStructure.hpp" - namespace pFlow +{ + class Time; +} + +namespace pFlow::postprocessData { class fieldsDataBase; -class Time; + /** * @class regionPoints diff --git a/src/PostprocessData/region/regionPoints/sphereRegionPoints/sphereRegionPoints.cpp b/src/PostprocessData/region/regionPoints/sphereRegionPoints/sphereRegionPoints.cpp index 4022c00e..b647560b 100644 --- a/src/PostprocessData/region/regionPoints/sphereRegionPoints/sphereRegionPoints.cpp +++ b/src/PostprocessData/region/regionPoints/sphereRegionPoints/sphereRegionPoints.cpp @@ -1,7 +1,10 @@ #include "sphereRegionPoints.hpp" #include "fieldsDataBase.hpp" -pFlow::sphereRegionPoints::sphereRegionPoints +namespace pFlow::postprocessData +{ + +sphereRegionPoints::sphereRegionPoints ( const dictionary &dict, fieldsDataBase &fieldsDataBase @@ -15,7 +18,7 @@ pFlow::sphereRegionPoints::sphereRegionPoints { } -bool pFlow::sphereRegionPoints::update() +bool sphereRegionPoints::update() { const auto points = database().updatePoints(); selectedPoints_.clear(); @@ -30,7 +33,7 @@ bool pFlow::sphereRegionPoints::update() return true; } -bool pFlow::sphereRegionPoints::write(iOstream &os) const +bool sphereRegionPoints::write(iOstream &os) const { os <<"# Single sphere\n"; os <<"# center point: "< Date: Thu, 24 Apr 2025 23:39:31 +0330 Subject: [PATCH 09/15] pFlow -> pFlow::postprocessData --- .../PostprocessOperationAvMassVelocity.hpp | 2 +- src/PostprocessData/processMethod/GaussianDistribution.hpp | 2 +- src/PostprocessData/processMethod/arithmetic.hpp | 7 ++++++- src/PostprocessData/processMethod/uniformDistribution.hpp | 7 ++++++- 4 files changed, 14 insertions(+), 4 deletions(-) diff --git a/src/PostprocessData/operation/PostprocessOperation/PostprocessOperationAvMassVelocity.hpp b/src/PostprocessData/operation/PostprocessOperation/PostprocessOperationAvMassVelocity.hpp index efa0478a..4cbdf5a2 100644 --- a/src/PostprocessData/operation/PostprocessOperation/PostprocessOperationAvMassVelocity.hpp +++ b/src/PostprocessData/operation/PostprocessOperation/PostprocessOperationAvMassVelocity.hpp @@ -168,6 +168,6 @@ public: }; -} +} // namespace pFlow::postprocessData #endif //__PostprocessOperationAvMassVelocity_hpp__ \ No newline at end of file diff --git a/src/PostprocessData/processMethod/GaussianDistribution.hpp b/src/PostprocessData/processMethod/GaussianDistribution.hpp index 6248bfa0..06809cf4 100644 --- a/src/PostprocessData/processMethod/GaussianDistribution.hpp +++ b/src/PostprocessData/processMethod/GaussianDistribution.hpp @@ -28,7 +28,7 @@ Licence: #include "span.hpp" #include "numericConstants.hpp" -namespace pFlow +namespace pFlow::postprocessData { class GaussianDistribution diff --git a/src/PostprocessData/processMethod/arithmetic.hpp b/src/PostprocessData/processMethod/arithmetic.hpp index 67a7fd30..bcd36267 100644 --- a/src/PostprocessData/processMethod/arithmetic.hpp +++ b/src/PostprocessData/processMethod/arithmetic.hpp @@ -32,6 +32,9 @@ namespace pFlow class dictionary; +namespace postprocessData +{ + class arithmetic { private: @@ -86,6 +89,8 @@ public: }; -} +} // namespace postprocessData + +} // namespace pFlow #endif //__arithmetic_hpp__ \ No newline at end of file diff --git a/src/PostprocessData/processMethod/uniformDistribution.hpp b/src/PostprocessData/processMethod/uniformDistribution.hpp index d0445615..02f40d15 100644 --- a/src/PostprocessData/processMethod/uniformDistribution.hpp +++ b/src/PostprocessData/processMethod/uniformDistribution.hpp @@ -32,6 +32,9 @@ namespace pFlow class dictionary; +namespace postprocessData +{ + class uniformDistribution { private: @@ -86,6 +89,8 @@ public: }; -} +} // namespace postprocessData + +} // namespace pFlow #endif //__uniformDistribution_hpp__ \ No newline at end of file From d8c91357007501821f922fcfd50c9b403055527b Mon Sep 17 00:00:00 2001 From: Hamidreza Date: Fri, 25 Apr 2025 00:40:41 +0330 Subject: [PATCH 10/15] readme.md file for postprocessPhasicFlow --- .../fieldsDataBase/fieldsDataBase.cpp | 38 ++- .../fieldsDataBase/fieldsDataBase.hpp | 6 + .../simulationFieldsDataBase.cpp | 7 +- .../postSimulationFieldsDataBase.cpp | 35 ++- .../postSimulationFieldsDataBase.hpp | 4 +- .../postprocessPhasicFlow.cpp | 8 +- utilities/postprocessPhasicFlow/readme.md | 234 ++++++++++++++++++ 7 files changed, 279 insertions(+), 53 deletions(-) create mode 100644 utilities/postprocessPhasicFlow/readme.md diff --git a/src/PostprocessData/fieldsDataBase/fieldsDataBase.cpp b/src/PostprocessData/fieldsDataBase/fieldsDataBase.cpp index 08d5cbc2..731e0881 100644 --- a/src/PostprocessData/fieldsDataBase/fieldsDataBase.cpp +++ b/src/PostprocessData/fieldsDataBase/fieldsDataBase.cpp @@ -26,12 +26,6 @@ Licence: #include "fieldFunctions.hpp" #include "dictionary.hpp" -namespace pFlow::postprocessData -{ - -bool pointFieldGetType(const word& TYPENAME, word& fieldType, word& fieldSpace); - -} bool pFlow::postprocessData::fieldsDataBase::loadPointStructureToTime() { @@ -898,7 +892,21 @@ pFlow::postprocessData::allPointFieldTypes pFlow::postprocessData::fieldsDataBas } } - +bool pFlow::postprocessData::fieldsDataBase::pointFieldGetType +( + const word& TYPENAME, + word& fieldType, + word& fieldSpace +) +{ + std::regex match("pointField\\<([A-Za-z1-9_]*)\\,([A-Za-z1-9_]*)\\>"); + std::smatch search; + if(!std::regex_match(TYPENAME, search, match)) return false; + if(search.size()!= 3) return false; + fieldType = search[1]; + fieldSpace = search[2]; + return true; +} pFlow::uniquePtr pFlow::postprocessData::fieldsDataBase::create @@ -941,19 +949,5 @@ pFlow::uniquePtr return nullptr; } -bool pFlow::postprocessData::pointFieldGetType -( - const word& TYPENAME, - word& fieldType, - word& fieldSpace -) -{ - std::regex match("pointField\\<([A-Za-z1-9_]*)\\,([A-Za-z1-9_]*)\\>"); - std::smatch search; - if(!std::regex_match(TYPENAME, search, match)) return false; - if(search.size()!= 3) return false; - fieldType = search[1]; - fieldSpace = search[2]; - return true; -} + diff --git a/src/PostprocessData/fieldsDataBase/fieldsDataBase.hpp b/src/PostprocessData/fieldsDataBase/fieldsDataBase.hpp index 822af933..fb707b1e 100644 --- a/src/PostprocessData/fieldsDataBase/fieldsDataBase.hpp +++ b/src/PostprocessData/fieldsDataBase/fieldsDataBase.hpp @@ -304,6 +304,12 @@ public: { return -1.0; } + + static + bool pointFieldGetType( + const word& TYPENAME, + word& fieldType, + word& fieldSpace); static uniquePtr create( diff --git a/src/PostprocessData/fieldsDataBase/simulationFieldsDataBase.cpp b/src/PostprocessData/fieldsDataBase/simulationFieldsDataBase.cpp index 3e1683a0..b4e19f6a 100644 --- a/src/PostprocessData/fieldsDataBase/simulationFieldsDataBase.cpp +++ b/src/PostprocessData/fieldsDataBase/simulationFieldsDataBase.cpp @@ -3,10 +3,7 @@ #include "dynamicPointStructure.hpp" #include "vocabs.hpp" -namespace pFlow -{ - bool pointFieldGetType(const word& TYPENAME, word& fieldType, word& fieldSpace); -} + bool pFlow::postprocessData::simulationFieldsDataBase::pointFieldNameExists(const word &name) const { @@ -37,7 +34,7 @@ pFlow::word pFlow::postprocessData::simulationFieldsDataBase::getPointFieldType { word pfType = time().lookupObjectTypeName(name); word type, space; - if(!pointFieldGetType(pfType, type, space)) + if(!fieldsDataBase::pointFieldGetType(pfType, type, space)) { fatalErrorInFunction <<"Error in retriving the type of pointField " diff --git a/utilities/postprocessPhasicFlow/postSimulationFieldsDataBase/postSimulationFieldsDataBase.cpp b/utilities/postprocessPhasicFlow/postSimulationFieldsDataBase/postSimulationFieldsDataBase.cpp index 97bd8d4d..624a3444 100644 --- a/utilities/postprocessPhasicFlow/postSimulationFieldsDataBase/postSimulationFieldsDataBase.cpp +++ b/utilities/postprocessPhasicFlow/postSimulationFieldsDataBase/postSimulationFieldsDataBase.cpp @@ -1,26 +1,19 @@ #include "postSimulationFieldsDataBase.hpp" #include "vocabs.hpp" -namespace pFlow +namespace pFlow::postprocessData { -bool pointFieldGetType -( - const word& objectType, - word& fieldType, - word& fieldSpace -); -} -bool pFlow::postSimulationFieldsDataBase::pointFieldNameExists(const word& name) const +bool postSimulationFieldsDataBase::pointFieldNameExists(const word& name) const { if(currentFileFields_.contains(name)) return true; if(time().lookupObjectName(name)) return true; return false; } -bool pFlow::postSimulationFieldsDataBase::loadPointFieldToTime(const word &name) +bool postSimulationFieldsDataBase::loadPointFieldToTime(const word &name) { if(time().lookupObjectName(name)) return true; if(auto [iter, success]=currentFileFields_.findIf(name); success) @@ -116,7 +109,7 @@ bool pFlow::postSimulationFieldsDataBase::loadPointFieldToTime(const word &name) return true; } -bool pFlow::postSimulationFieldsDataBase::loadPointStructureToTime() +bool postSimulationFieldsDataBase::loadPointStructureToTime() { if(!pStructPtr_) { @@ -126,7 +119,7 @@ bool pFlow::postSimulationFieldsDataBase::loadPointStructureToTime() return true; } -const pFlow::shape &pFlow::postSimulationFieldsDataBase::getShape() const +const shape &postSimulationFieldsDataBase::getShape() const { if(!shapePtr_) { @@ -143,7 +136,7 @@ const pFlow::shape &pFlow::postSimulationFieldsDataBase::getShape() const return shapePtr_(); } -pFlow::word pFlow::postSimulationFieldsDataBase::getPointFieldType(const word &name) const +word postSimulationFieldsDataBase::getPointFieldType(const word &name) const { if(auto [iter, success]=currentFileFields_.findIf(name); success) { @@ -159,7 +152,7 @@ pFlow::word pFlow::postSimulationFieldsDataBase::getPointFieldType(const word &n return ""; } -bool pFlow::postSimulationFieldsDataBase::setToCurrentFolder() +bool postSimulationFieldsDataBase::setToCurrentFolder() { allPointFields_.clear(); pStructPtr_.reset(nullptr); @@ -184,7 +177,7 @@ bool pFlow::postSimulationFieldsDataBase::setToCurrentFolder() word type, space; for(auto& [name, objectType]: files) { - if(pointFieldGetType(objectType, type, space)) + if(fieldsDataBase::pointFieldGetType(objectType, type, space)) { if(name == pointStructureFile__) continue; currentFileFields_.insertIf(name, type); @@ -194,7 +187,7 @@ bool pFlow::postSimulationFieldsDataBase::setToCurrentFolder() return true; } -pFlow::postSimulationFieldsDataBase::postSimulationFieldsDataBase +postSimulationFieldsDataBase::postSimulationFieldsDataBase ( systemControl &control, const dictionary& postDict, @@ -233,17 +226,17 @@ pFlow::postSimulationFieldsDataBase::postSimulationFieldsDataBase } } -const pFlow::pointStructure& pFlow::postSimulationFieldsDataBase::pStruct()const +const pointStructure& postSimulationFieldsDataBase::pStruct()const { return pStructPtr_(); } -pFlow::timeValue pFlow::postSimulationFieldsDataBase::getNextTimeFolder() const +timeValue postSimulationFieldsDataBase::getNextTimeFolder() const { return allValidFolders_.nextTime(); } -pFlow::timeValue pFlow::postSimulationFieldsDataBase::setToNextTimeFolder() +timeValue postSimulationFieldsDataBase::setToNextTimeFolder() { timeValue nextTime = allValidFolders_.nextTime(); if(nextTime < 0.0) return nextTime; @@ -261,7 +254,7 @@ pFlow::timeValue pFlow::postSimulationFieldsDataBase::setToNextTimeFolder() return nextTime; } -pFlow::timeValue pFlow::postSimulationFieldsDataBase::skipNextTimeFolder() +timeValue postSimulationFieldsDataBase::skipNextTimeFolder() { timeValue nextTime = allValidFolders_.nextTime(); if(nextTime < 0.0) return nextTime; @@ -269,3 +262,5 @@ pFlow::timeValue pFlow::postSimulationFieldsDataBase::skipNextTimeFolder() allValidFolders_++; return nextTime; } + +} // namespace pFlow::postprocessData \ No newline at end of file diff --git a/utilities/postprocessPhasicFlow/postSimulationFieldsDataBase/postSimulationFieldsDataBase.hpp b/utilities/postprocessPhasicFlow/postSimulationFieldsDataBase/postSimulationFieldsDataBase.hpp index ee24a691..e0afd59c 100644 --- a/utilities/postprocessPhasicFlow/postSimulationFieldsDataBase/postSimulationFieldsDataBase.hpp +++ b/utilities/postprocessPhasicFlow/postSimulationFieldsDataBase/postSimulationFieldsDataBase.hpp @@ -27,12 +27,12 @@ Licence: #include "ListPtr.hpp" #include "property.hpp" -namespace pFlow +namespace pFlow::postprocessData { class postSimulationFieldsDataBase : - public fieldsDataBase + public postprocessData::fieldsDataBase { systemControl& control_; diff --git a/utilities/postprocessPhasicFlow/postprocessPhasicFlow.cpp b/utilities/postprocessPhasicFlow/postprocessPhasicFlow.cpp index 792876f2..aeaace52 100644 --- a/utilities/postprocessPhasicFlow/postprocessPhasicFlow.cpp +++ b/utilities/postprocessPhasicFlow/postprocessPhasicFlow.cpp @@ -30,7 +30,7 @@ Licence: int main(int argc, char** argv ) { - pFlow::word outFolder = (pFlow::CWD()/pFlow::postProcessGlobals::defaultRelDir__).wordPath(); + pFlow::word outFolder = (pFlow::CWD()/pFlow::postprocessData::defaultRelDir__).wordPath(); pFlow::commandLine cmds( "postprocessPhasicFlow", @@ -40,7 +40,7 @@ int main(int argc, char** argv ) pFlow::wordVector times; pFlow::word description = "path to output folder of postprocess data: ./" - + pFlow::postProcessGlobals::defaultRelDir__; + + pFlow::postprocessData::defaultRelDir__; cmds.addOption("-o,--out-folder", outFolder, @@ -50,7 +50,7 @@ int main(int argc, char** argv ) cmds.addOption( "-t,--time", times.vectorField(), - "a SPACE separated lits of time folders, " + "a SPACE separated list of time folders, " "or a strided range ::, or an interval :", " "); @@ -99,7 +99,7 @@ int main(int argc, char** argv ) fatalExit; } - pFlow::postprocessData postprocess(Control, nextTime); + pFlow::postprocessData::postprocessData postprocess(Control, nextTime); postprocess.setOutputDirectory(pFlow::fileSystem(outFolder+"/").absolute()); bool folderSkipped = false; diff --git a/utilities/postprocessPhasicFlow/readme.md b/utilities/postprocessPhasicFlow/readme.md new file mode 100644 index 00000000..04e1a7a1 --- /dev/null +++ b/utilities/postprocessPhasicFlow/readme.md @@ -0,0 +1,234 @@ +# postprocessPhasicFlow Utility + +This is a documentation for the `postprocessPhasicFlow` utility. This utility is designed to perform post-simulation processing on completed simulation data. + +## Table of Contents + +- [1. Overview](#1-overview) +- [2. When to Use postprocessPhasicFlow](#2-when-to-use-postprocessphasicflow) +- [3. Basic Usage](#3-basic-usage) +- [4. Command Line Options](#4-command-line-options) + - [4.1. Available Options](#41-available-options) + - [4.2. Examples](#42-examples) +- [5. Configuration](#5-configuration) + - [5.1. Important Configuration Parameters for Post-Simulation Processing](#51-important-configuration-parameters-for-post-simulation-processing) +- [6. Difference Between In-Simulation and Post-Simulation Processing](#6-difference-between-in-simulation-and-post-simulation-processing) +- [7. File Structure](#7-file-structure) +- [8. Advanced Features](#8-advanced-features) +- [9. Example Configuration](#9-example-configuration) +- [10. Troubleshooting](#10-troubleshooting) +- [11. See Also](#11-see-also) + +## 1. Overview + +`postprocessPhasicFlow` is a utility for performing postprocessing analysis on completed simulation data. It allows you to extract statistical information, track specific particles, and analyze regional particle behavior without needing to re-run your simulations. This utility leverages the functionality provided by phasicFlow's `PostprocessData` module to analyze data stored in time folders. + +## 2. When to Use postprocessPhasicFlow + +You should use this utility when: + +1. Your simulation has completed and you want to analyze the results +2. You want to try different postprocessing configurations on the same simulation data +3. You need to extract additional information that wasn't included in real-time processing +4. You want to focus on specific time periods or regions of your simulation domain + +## 3. Basic Usage + +To use the `postprocessPhasicFlow` utility, navigate to your simulation case directory and run: + +```bash +postprocessPhasicFlow +``` + +This will read the `postprocessDataDict` file from your case's `settings` directory and perform the configured postprocessing operations on all available time folders. + +## 4. Command Line Options + +The `postprocessPhasicFlow` utility supports several command line options that allow you to customize its behavior: + +```bash +postprocessPhasicFlow [OPTIONS] +``` + +### 4.1. Available Options + +| Option | Description | +|--------|-------------| +| `-o, --out-folder ` | Specify the output directory path where postprocessing results will be written. Default is `./postprocessData/` | +| `-t, --time ` | Process only specific time folders. Accepts multiple formats:
- Space-separated list of times (e.g., `0.1 0.2 0.3`)
- Strided range with format `::` (e.g., `0.1:0.1:0.5`)
- Interval with format `:` (e.g., `0.1:0.5`) | +| `-z, --zeroFolder` | Include the zero folder (initial state) in the processing. By default, the zero folder is not processed. | +| `-h, --help` | Display help message with all available options | + +### 4.2. Examples + +Process all available time folders (except zero folder): + +```bash +postprocessPhasicFlow +``` + +Process only specific time steps: + +```bash +postprocessPhasicFlow -t 0.1 0.2 0.5 +``` + +Process a range of time steps from 0.1 to 1.0 with 0.1 increments: + +```bash +postprocessPhasicFlow -t 0.1:0.1:1.0 +``` + +Process all time steps including the initial state (zero folder): + +```bash +postprocessPhasicFlow -z +``` + +Write output to a custom directory: + +```bash +postprocessPhasicFlow -o /path/to/custom/output +``` + + +## 5. Configuration + +The `postprocessPhasicFlow` utility is configured through the same `postprocessDataDict` file used for in-simulation postprocessing. This file should be placed in the `settings` directory of your case. + +### 5.1. Important Configuration Parameters for Post-Simulation Processing + +When using `postprocessPhasicFlow` for post-simulation processing, pay special attention to these settings: + +```cpp +// For post-simulation, runTimeActive should be set to "no" +// This indicates that you're doing post-simulation processing +runTimeActive no; + +// Specify the correct shape type used in your simulation +// This is essential for post-simulation processing +shapeType sphere; // Options: sphere, grain, etc. +``` + +The `shapeType` parameter is particularly crucial for post-simulation processing as it tells the utility what kind of particles were used in the simulation, allowing it to correctly interpret the stored data. + +## 6. Difference Between In-Simulation and Post-Simulation Processing + +| Feature | In-Simulation Processing | Post-Simulation Processing with postprocessPhasicFlow | +|---------|--------------------------|--------------------------------------------------------| +| When it runs | During simulation execution | After simulation is complete | +| How to activate | Set `runTimeActive yes` in postprocessDataDict, set `auxFunctions postprocessData` in settingsDict and add library | Run the `postprocessPhasicFlow` utility | +| Data access | Direct access to simulation data in memory | Reads data from time folders | +| Performance impact | May slow down simulation | No impact on simulation performance | +| Iterations | Can only run once per simulation step | Can be run multiple times with different settings | + +## 7. File Structure + +The results of the postprocessing will be written to files in your case directory (by default, under `postprocessData` folder), with timestamps and naming that matches your configured components and operations. These files can then be used for further analysis or visualization. + +## 8. Advanced Features + +`postprocessPhasicFlow` supports all the features of the PostprocessData module, including: + +- Different processing methods (arithmetic, uniformDistribution, GaussianDistribution) +- Various region types (sphere, multipleSpheres, line, centerPoints) +- Multiple operation types (average, sum, avMassVelocity) +- Special field functions (component, abs, square, magnitude, etc.) +- Particle filtering with includeMask + +but it disables/ignores the effect of all `timeControl` settings in postprocess components. + +For detailed information about these features, refer to the [PostprocessData module documentation](../../src/PostprocessData/readme.md). + +## 9. Example Configuration + +Here's a simple example of a `postprocessDataDict` file configured for post-simulation processing: + +```cpp +/* -------------------------------*- C++ -*--------------------------------- *\ +| phasicFlow File | +| copyright: www.cemf.ir | +\* ------------------------------------------------------------------------- */ +objectName postprocessDataDict; +objectType dictionary;; +fileFormat ASCII; +/*---------------------------------------------------------------------------*/ + +// Set to "no" for post-simulation processing +runTimeActive no; + +// Required for post-simulation processing - specify the shape type used in the simulation +shapeType sphere; + +// Default time control settings +defaultTimeControl +{ + timeControl timeStep; + startTime 0; + endTime 1000; + executionInterval 20; +} + +// List of postprocessing components +components +( + // Track specific particles by ID + particleTracker + { + processMethod particleProbe; + processRegion centerPoints; + selector id; + field velocity; + ids (10 42 87); + timeControl default; + } + + // Analyze particle behavior in a spherical region + centerRegionAnalysis + { + processMethod arithmetic; + processRegion sphere; + + sphereInfo + { + radius 0.05; + center (0 0 0.1); + } + + timeControl default; + + operations + ( + velocityMagnitude + { + function average; + field mag(velocity); + threshold 5; + divideByVolume no; + fluctuation2 yes; + } + + particleDensity + { + function sum; + field mass; + divideByVolume yes; + } + ); + } +); +``` + +## 10. Troubleshooting + +If you encounter issues with the `postprocessPhasicFlow` utility, check the following: + +1. Make sure your `postprocessDataDict` file specifies the correct `shapeType` +2. Verify that the time folders contain all the required field data +3. Check that field names referenced in your configuration exist in the simulation data +4. Ensure that the simulation case structure is intact and not modified + +## 11. See Also + +- [PostprocessData module documentation](../../src/PostprocessData/readme.md) +- [phasicFlow simulation tutorials](../../tutorials/) \ No newline at end of file From 6cc4b3954ab223d4183f68d114c9fe588d7fa8bd Mon Sep 17 00:00:00 2001 From: Hamidreza Date: Fri, 25 Apr 2025 09:26:56 +0330 Subject: [PATCH 11/15] readme.md file for pFlowToVTK --- utilities/pFlowToVTK/README.md | 110 +++++++++++++++++++++++++++++++++ 1 file changed, 110 insertions(+) create mode 100644 utilities/pFlowToVTK/README.md diff --git a/utilities/pFlowToVTK/README.md b/utilities/pFlowToVTK/README.md new file mode 100644 index 00000000..789f7e5e --- /dev/null +++ b/utilities/pFlowToVTK/README.md @@ -0,0 +1,110 @@ +# pFlowToVTK Utility + +## Overview + +pFlowToVTK is a utility for converting phasicFlow simulation data into VTK (Visualization Toolkit) file format. This enables visualization of simulation results in applications like ParaView. The utility handles two primary types of data: + +1. **Particle Data** (pointField) - Converts particle properties such as position, velocity, forces, etc. +2. **Geometry Data** (triSurfaceField) - Converts surface geometries and their properties + +## Basic Usage + +```bash +pFlowToVTK [OPTIONS] +``` + +After simulation is complete, run this command from the case directory to convert all simulation data to VTK format, which will be stored in the `./VTK/` folder. + +## Command Line Options + +| Option | Description | +|--------|-------------| +| `--no-geometry` | Skip conversion of geometry data to VTK format | +| `--no-particles` | Skip conversion of particle data to VTK format | +| `-b, --binary` | Write VTK files in binary format (default is ASCII). Using binary format accelerates conversion (5-10x) and visualization in ParaView | +| `-o, --out-folder ` | Specify the output directory path (default: `./VTK/`) | +| `-s, --separate-surfaces` | Create separate files for each sub-surface in geometry | +| `-f, --fields ...` | Specify which particle fields to convert (space-separated list). If not specified, all fields are converted | +| `-t, --time ` | Process only specific time folders. Accepts multiple formats:
- Space-separated list of times (e.g., `0.1 0.2 0.3`)
- Strided range with format `::` (e.g., `0.1:0.1:0.5`)
- Interval with format `:` (e.g., `0.1:0.5`) | +| `-h, --help` | Display help message with all available options | + +## Examples + +Convert all data with default settings: + +```bash +pFlowToVTK +``` + +Convert only geometry data: + +```bash +pFlowToVTK --no-particles +``` + +Convert only particle data in binary format: + +```bash +pFlowToVTK --no-geometry --binary +``` + +Convert specific fields for particles: + +```bash +pFlowToVTK -f velocity diameter contactForce +``` + +Convert data for specific time steps: + +```bash +pFlowToVTK -t 0.1 0.2 0.3 +``` + +Convert data for a range of time steps: + +```bash +pFlowToVTK -t 0.1:0.1:1.0 +``` + +Write output to a custom directory: + +```bash +pFlowToVTK -o /path/to/custom/output +``` + +## Output Structure + +The utility creates the following directory structure: +``` +simulationCase/ +├── 0/ # Contains the initial time step data +├── 0.1/ # time-folder for simulation data at 0.1 s +├── 0.2/ # time-folder for simulation data at 0.2 s +├── caseSetup/ # Contains the case setup files +├── settings/ # Contains the settings files +└── VTK/ + ├── geometry/ # Contains VTK files for geometry + │ └── surface-*.vtk # Geometry at different time steps + └── particles/ # Contains VTK files for particles + └── particles-*.vtk # Particle data at different time steps +``` + +Additionally, the utility generates `.vtk.series` files in the VTK root folder, which can be used by ParaView for loading time series data automatically: +``` +VTK/ +├── particles.vtk.series +└── surface.vtk.series # (and possibly other surface names if --separate-surfaces is used) +``` + +## Recommendations + +- Use binary format (`-b` flag) for large simulations to significantly improve conversion speed and reduce file size +- For complex geometries with multiple sub-surfaces, consider using `-s` flag to keep surfaces in separate files for better visualization +- When working with large datasets, use the `-t` option to convert only the time steps you need to visualize + +## See Also +## Related Utilities +- [`tutorials`](../../tutorials): Contains example cases and step-by-step guides for using phasicFlow +- [`particlesPhasicFlow`](../particlesPhasicFlow): Creates the initial fields for particles +- [`geometryPhasicFlow`](../geometryPhasicFlow): Creates the geometry +- [`postprocessPhasicFlow`](../postprocessPhasicFlow): Tool for performing various cell-based averaging on fields From a545acb3741c9bd360db8e329b683df3e6c6d791 Mon Sep 17 00:00:00 2001 From: Hamidreza Date: Fri, 25 Apr 2025 11:36:46 +0330 Subject: [PATCH 12/15] readme.md for particlesPhasicFlow and change diameter to distance in dict files --- utilities/particlesPhasicFlow/README.md | 369 ++++++++++++++++++ utilities/particlesPhasicFlow/empty/empty.hpp | 2 +- .../positionFile/positionFile.hpp | 4 +- .../positionOrdered/positionOrdered.cpp | 6 +- .../positionOrdered/positionOrdered.hpp | 8 +- .../positionParticles/positionParticles.hpp | 3 +- .../positionRandom/positionRandom.cpp | 10 +- .../positionRandom/positionRandom.hpp | 22 +- 8 files changed, 399 insertions(+), 25 deletions(-) create mode 100644 utilities/particlesPhasicFlow/README.md diff --git a/utilities/particlesPhasicFlow/README.md b/utilities/particlesPhasicFlow/README.md new file mode 100644 index 00000000..439377bc --- /dev/null +++ b/utilities/particlesPhasicFlow/README.md @@ -0,0 +1,369 @@ +# particlesPhasicFlow Utility + +## 1. Overview + +`particlesPhasicFlow` is a pre-processing utility for Discrete Element Method (DEM) simulations in phasicFlow. It is used to: + +1. Position particles in the simulation domain using different methods +2. Set initial field values (such as velocity, acceleration, shape) for particles +3. Apply field values to selected subsets of particles + +The utility reads its configuration from `settings/particlesDict` in your simulation case directory. + +## Table of Contents + +- [1. Overview](#1-overview) +- [2. Command Line Options](#2-command-line-options) +- [3. The particlesDict File Structure](#3-the-particlesdict-file-structure) + - [3.1. positionParticles Sub-dictionary](#31-positionparticles-sub-dictionary) + - [3.1.1. Positioning Methods](#311-positioning-methods) + - [3.1.2. Region Types](#312-region-types) + - [3.2. setFields Dictionary](#32-setfields-dictionary) + - [3.2.1. Selector Types](#321-selector-types) +- [4. Usage Examples](#4-usage-examples) + - [4.1. Example 1: Positioning Particles in an Ordered Pattern](#41-example-1-positioning-particles-in-an-ordered-pattern) + - [4.2. Example 2: Setting Field Values for a Binary Mixture of Particles](#42-example-2-setting-field-values-for-a-binary-mixture-of-particles) + - [4.3. Example 3: Empty Initial Particle System (for Insertion Later)](#43-example-3-empty-initial-particle-system-for-insertion-later) +- [5. Workflow Tips](#5-workflow-tips) +- [6. Common Field Types](#6-common-field-types) +- [7. Shape Handling](#7-shape-handling) +- [8. See Also](#8-see-also) + +## 2. Command Line Options + +The utility can be run with the following command line options: + +``` +particlesPhasicFlow [OPTIONS] +``` + +Where `[OPTIONS]` can include: + +- `--positionParticles-only`: Execute only the positioning part and store the created pointStructure. +- `--setFields-only`: Execute only the field setting part, reading an existing pointStructure file from the time folder. +- `-c, --coupling`: Specify if this is a fluid-particle coupling simulation. + +## 3. The particlesDict File Structure + +The `particlesDict` file consists of two main sections: + +1. `positionParticles`: Defines how particles are positioned in the domain. +2. `setFields`: Defines initial field values for particles and selective field assignments. + +### 3.1. positionParticles Sub-dictionary + +This section defines how particles are positioned in the simulation domain: + +```C++ +positionParticles +{ + method ; // Options: ordered, random, file, empty + + regionType ; // Options: box, cylinder, sphere, domain + + // Method-specific settings + Info + { + // Parameters for the selected method + } + + // Region-specific settings + Info + { + // Parameters for the selected region + } +} +``` + +#### 3.1.1. Positioning Methods + +1. **ordered**: Positions particles in an ordered pattern along specified axes + + ```C++ + orderedInfo + { + distance ; // Minimum space between centers of particles + numPoints ; // Number of particles to position + axisOrder ( ); // Order of axes for filling (x, y, z) + } + ``` + +2. **random**: Positions particles randomly in the specified region + + ```C++ + randomInfo + { + distance ; // Minimum distance between particle centers + numPoints ; // Number of particles to position + maxIterations ; // Maximum iterations for random positioning (default: 10) + } + ``` + +3. **file**: Reads particle positions from a file + + ```C++ + fileInfo + { + fileName ; // Path to file containing positions + commaSeparated Yes/No; // Whether file is comma-separated + } + ``` + +4. **empty**: Creates an empty pointStructure with no particles. No additional sub-dictionary is required. + +#### 3.1.2. Region Types + +1. **box**: Rectangular region + + ```C++ + boxInfo + { + min ( ); // Lower corner point coordinates + max ( ); // Upper corner point coordinates + } + ``` + +2. **cylinder**: Cylindrical region + + ```C++ + cylinderInfo + { + p1 ( ); // Begin point of cylinder axis + p2 ( ); // End point of cylinder axis + radius ; // Radius of cylinder + } + ``` + +3. **sphere**: Spherical region + + ```C++ + sphereInfo + { + center ( ); // Center of sphere + radius ; // Radius of sphere + } + ``` + +4. **domain**: Uses the global domain defined in the simulation (in file `settings/domainDict`) + + ```C++ + // No additional information needed when using domain + ``` + +### 3.2. setFields Dictionary + +This section defines the initial field values for particles and allows selective field assignments: + +```C++ +setFields +{ + defaultValue + { + // Default field values for all particles + velocity realx3 ( ); // Initial linear velocity (m/s) + acceleration realx3 ( ); // Initial linear acceleration (m/s²) + rVelocity realx3 ( ); // Initial rotational velocity (rad/s) + shapeName word ; // Particle shape name + // Additional fields as required + } + + selectors + { + + { + selector ; // Type of selector + + Info + { + // Parameters specific to the selector type + } + + fieldValue + { + // Field values to set for selected particles + ; + // Additional fields as required + } + } + // Additional selectors as required + } +} +``` + +#### 3.2.1. Selector Types + +1. **stridedRange**: Selects particles based on index ranges + + ```C++ + stridedRangeInfo + { + begin ; // Beginning index + end ; // Ending index + stride ; // Step size (default: 1) + } + ``` + +2. **box**: Selects particles within a box region + + ```C++ + boxInfo + { + min ( ); // Lower corner point coordinates + max ( ); // Upper corner point coordinates + } + ``` + +3. **cylinder**: Selects particles within a cylindrical region + + ```C++ + cylinderInfo + { + p1 ( ); // Begin point of cylinder axis + p2 ( ); // End point of cylinder axis + radius ; // Radius of cylinder + } + ``` + +4. **sphere**: Selects particles within a spherical region + + ```C++ + sphereInfo + { + center ( ); // Center of sphere + radius ; // Radius of sphere + } + ``` + +5. **randomPoints**: Selects a random subset of particles + + ```C++ + randomPointsInfo + { + begin ; // Beginning index + end ; // Ending index + number ; // Number of random points to select + } + ``` + +## 4. Usage Examples + +### 4.1. Example 1: Positioning Particles in an Ordered Pattern + +```C++ +positionParticles +{ + method ordered; + mortonSorting Yes; + + orderedInfo + { + distance 0.005; + numPoints 30000; + axisOrder (z x y); + } + + regionType cylinder; + + cylinderInfo + { + p1 (0.0 0.0 0.003); + p2 (0.0 0.0 0.097); + radius 0.117; + } +} +``` + +### 4.2. Example 2: Setting Field Values for a Binary Mixture of Particles + +```C++ +setFields +{ + defaultValue + { + velocity realx3 (0 0 0); + acceleration realx3 (0 0 0); + rVelocity realx3 (0 0 0); + shapeName word smallSphere; + } + + selectors + { + shapeAssigne + { + selector stridedRange; + + stridedRangeInfo + { + begin 0; + end 30000; + stride 3; + } + + fieldValue + { + shapeName word largeSphere; + } + } + } +} +``` + +### 4.3. Example 3: Empty Initial Particle System (for Insertion Later) + +```C++ +positionParticles +{ + method empty; +} +``` + +## 5. Workflow Tips + +1. To create particles at the beginning of a simulation: + + ``` + particlesPhasicFlow + ``` + +2. To only position particles without setting fields: + + ``` + particlesPhasicFlow --positionParticles-only + ``` + +3. To modify fields on existing particles (e.g., at a later time step): + + ``` + particlesPhasicFlow --setFields-only + ``` + +4. For fluid-particle coupling simulations: + + ``` + particlesPhasicFlow -c + ``` + +5. To change particle properties at a later time step in a simulation: + - Change `startTime` in the settings dictionary to the desired time + - Run `particlesPhasicFlow --setFields-only` + - Restart the simulation from that time step + +## 6. Common Field Types + +- `realx3`: 3D vector of real values, e.g., `(0 0 0)` +- `real`: Single real value +- `word`: Text string +- `uint32`: Unsigned 32-bit integer + +## 7. Shape Handling + +When using the `shapeName` field, ensure that the shapes are defined in the `shape` file in the `caseSetup` directory. The utility will automatically convert shape names to shape indices and hashes for the simulation. + +For any further assistance, please refer to the tutorial examples in the phasicFlow distribution. + +## 8. See Also + +- [Tutorials](../../tutorials) - Example cases demonstrating phasicFlow capabilities and more about particlesPhasicFlow +- [geometryPhasicFlow](../geometryPhasicFlow) - Utility for geometry creation and manipulation in phasicFlow +- [pFlowToVTK](../pFlowToVTK) - Utility for converting phasicFlow data to VTK format for visualization +- [postprocessPhasicFlow](../postprocessPhasicFlow) - Utility for post-processing simulation results \ No newline at end of file diff --git a/utilities/particlesPhasicFlow/empty/empty.hpp b/utilities/particlesPhasicFlow/empty/empty.hpp index 9b296893..4b8bdeac 100755 --- a/utilities/particlesPhasicFlow/empty/empty.hpp +++ b/utilities/particlesPhasicFlow/empty/empty.hpp @@ -64,7 +64,7 @@ public: return 0; } - real maxDiameter() const final + real distance() const final { return 1.0; } diff --git a/utilities/particlesPhasicFlow/positionFile/positionFile.hpp b/utilities/particlesPhasicFlow/positionFile/positionFile.hpp index e2df0841..aa46a456 100755 --- a/utilities/particlesPhasicFlow/positionFile/positionFile.hpp +++ b/utilities/particlesPhasicFlow/positionFile/positionFile.hpp @@ -74,9 +74,9 @@ public: return static_cast(position_.size()); } - real maxDiameter() const final + real distance() const final { - return 0; + return 1.0; } // bool commaSeparated()const diff --git a/utilities/particlesPhasicFlow/positionOrdered/positionOrdered.cpp b/utilities/particlesPhasicFlow/positionOrdered/positionOrdered.cpp index eb1c94d4..b655a8c5 100755 --- a/utilities/particlesPhasicFlow/positionOrdered/positionOrdered.cpp +++ b/utilities/particlesPhasicFlow/positionOrdered/positionOrdered.cpp @@ -79,7 +79,7 @@ bool pFlow::positionOrdered::positionPointsOrdered() { position_.clear(); - realx3 dl(diameter_); + realx3 dl(distance_); const auto& region = pRegion(); auto minP = region.minPoint(); auto maxP = region.maxPoint(); @@ -131,9 +131,9 @@ pFlow::positionOrdered::positionOrdered ( dict.subDict("orderedInfo") ), - diameter_ + distance_ ( - poDict_.getVal("diameter") + poDict_.getVal("distance") ), numPoints_ ( diff --git a/utilities/particlesPhasicFlow/positionOrdered/positionOrdered.hpp b/utilities/particlesPhasicFlow/positionOrdered/positionOrdered.hpp index caf711dd..744554c8 100755 --- a/utilities/particlesPhasicFlow/positionOrdered/positionOrdered.hpp +++ b/utilities/particlesPhasicFlow/positionOrdered/positionOrdered.hpp @@ -35,7 +35,8 @@ private: dictionary poDict_; - real diameter_; + /// Minimum distance between centers of particles + real distance_; uint32 numPoints_; @@ -86,9 +87,10 @@ public: return static_cast(position_.size()); } - real maxDiameter() const final + /// Minimum distance between centers of particles + real distance() const final { - return diameter_; + return distance_; } // - const access to position diff --git a/utilities/particlesPhasicFlow/positionParticles/positionParticles.hpp b/utilities/particlesPhasicFlow/positionParticles/positionParticles.hpp index 749ba7c3..e62ef575 100755 --- a/utilities/particlesPhasicFlow/positionParticles/positionParticles.hpp +++ b/utilities/particlesPhasicFlow/positionParticles/positionParticles.hpp @@ -83,7 +83,8 @@ public: virtual uint32 size()const = 0; - virtual real maxDiameter() const = 0; + /// Minimum distance between centers of particles + virtual real distance() const = 0; // - const access to position virtual const realx3Vector& position()const = 0; diff --git a/utilities/particlesPhasicFlow/positionRandom/positionRandom.cpp b/utilities/particlesPhasicFlow/positionRandom/positionRandom.cpp index d67f9df4..9717cf66 100755 --- a/utilities/particlesPhasicFlow/positionRandom/positionRandom.cpp +++ b/utilities/particlesPhasicFlow/positionRandom/positionRandom.cpp @@ -35,10 +35,10 @@ bool pFlow::positionRandom::positionOnePass(collisionCheck& collCheck) { realx3 p = region.peek(); - if( collCheck.checkPoint(p, diameter_) ) + if( collCheck.checkPoint(p, distance_) ) { position_.push_back(p); - diameters_.push_back(diameter_); + diameters_.push_back(distance_); if(!collCheck.mapLastAddedParticle()) { @@ -64,7 +64,7 @@ bool pFlow::positionRandom::positionPointsRandom() uint32 pass = 0; collisionCheck collCheck( box(pRegion().minPoint(), pRegion().maxPoint()), - diameter_, + distance_, position_, diameters_); @@ -107,9 +107,9 @@ pFlow::positionRandom::positionRandom ( dict.subDict("randomInfo") ), - diameter_ + distance_ ( - prDict_.getVal("diameter") + prDict_.getVal("distance") ), numPoints_ ( diff --git a/utilities/particlesPhasicFlow/positionRandom/positionRandom.hpp b/utilities/particlesPhasicFlow/positionRandom/positionRandom.hpp index 6faa81d9..e676c476 100755 --- a/utilities/particlesPhasicFlow/positionRandom/positionRandom.hpp +++ b/utilities/particlesPhasicFlow/positionRandom/positionRandom.hpp @@ -32,23 +32,25 @@ class positionRandom : public positionParticles { private: - dictionary prDict_; + dictionary prDict_; - real diameter_; + real distance_; - uint32 numPoints_; + uint32 numPoints_; - uint32 maxIterations_; + uint32 maxIterations_; + + uint32 reportInterval_ = 100; realx3Vector position_; + // still keeping this variable name as diameters_ since it stores + // the collection of distance values realVector diameters_; - uint32 reportInterval_; + bool positionOnePass(collisionCheck& collCheck); - bool positionOnePass(collisionCheck& collCheck); - - bool positionPointsRandom(); + bool positionPointsRandom(); public: @@ -79,9 +81,9 @@ public: return position_.size(); } - real maxDiameter() const override + real distance() const override { - return diameter_; + return distance_; } // - const access to position From 7c3b90a22d5dbe031c05121f0db0ca4c0008c0b6 Mon Sep 17 00:00:00 2001 From: Hamidreza Date: Fri, 25 Apr 2025 14:17:09 +0330 Subject: [PATCH 13/15] tutorials-1 after diameter->distance --- .../rotatingDrum/settings/particlesDict | 4 +- .../segregation/settings/particlesDict | 7 +- .../RotaryAirLockValve/caseSetup/shapes | 4 +- .../RotaryAirLockValve/cleanThisCase | 7 + .../RotaryAirLockValve/runThisCase | 21 ++ .../RotaryAirLockValve/settings/domainDict | 62 ++-- .../RotaryAirLockValve/settings/geometryDict | 50 +-- .../RotaryAirLockValve/settings/particlesDict | 4 +- .../RotaryAirLockValve/settings/settingsDict | 8 +- .../binarySystemOfParticles/README.md | 6 +- .../binarySystemOfParticles/cleanThisCase | 0 .../settings/domainDict | 64 ++-- .../settings/geometryDict | 94 +++-- .../settings/particlesDict | 93 ++--- .../settings/settingsDict | 28 +- .../conveyorBelt/caseSetup/particleInsertion | 52 +-- .../conveyorBelt/caseSetup/shapes | 11 +- .../conveyorBelt/settings/domainDict | 84 +++-- .../conveyorBelt/settings/geometryDict | 79 ++--- .../conveyorBelt/settings/particlesDict | 17 +- .../conveyorBelt/settings/settingsDict | 30 +- .../drum-PeriodicBoundary/README.md | 4 +- .../drum-PeriodicBoundary/caseSetup/shapes | 10 +- .../settings/geometryDict | 4 +- .../settings/particlesDict | 34 +- .../settings/settingsDict | 14 +- .../README.md | 2 +- .../caseSetup/interaction | 1 - .../caseSetup/particleInsertion | 262 +++++++------- .../settings/domainDict | 60 ++-- .../settings/geometryDict | 91 +++-- .../settings/particlesDict | 35 +- .../settings/settingsDict | 30 +- .../layeredSiloFilling/caseSetup/shapes | 10 +- .../layeredSiloFilling/settings/particlesDict | 1 - .../layeredSiloFilling/settings/settingsDict | 4 +- .../rotatingDrumMedium/README.md | 161 +++++++++ .../rotatingDrumMedium/caseSetup/interaction | 1 + .../caseSetup/particleInsertion | 10 - .../rotatingDrumMedium/settings/domainDict | 4 +- .../rotatingDrumMedium/settings/geometryDict | 1 + .../rotatingDrumMedium/settings/particlesDict | 2 +- .../rotatingDrumMedium/settings/settingsDict | 2 +- .../rotatingDrumSmall/README.md | 328 ++++++++++-------- .../rotatingDrumSmall/caseSetup/interaction | 29 +- .../caseSetup/particleInsertion | 13 - .../rotatingDrumSmall/caseSetup/shapes | 10 +- .../rotatingDrumSmall/settings/domainDict | 62 ++-- .../rotatingDrumSmall/settings/geometryDict | 4 +- .../rotatingDrumSmall/settings/particlesDict | 65 ++-- .../rotatingDrumSmall/settings/settingsDict | 27 +- .../toteBlender/settings/particlesDict | 2 +- 52 files changed, 1100 insertions(+), 908 deletions(-) create mode 100755 tutorials/sphereGranFlow/RotaryAirLockValve/cleanThisCase create mode 100755 tutorials/sphereGranFlow/RotaryAirLockValve/runThisCase mode change 100644 => 100755 tutorials/sphereGranFlow/binarySystemOfParticles/cleanThisCase create mode 100644 tutorials/sphereGranFlow/rotatingDrumMedium/README.md delete mode 100755 tutorials/sphereGranFlow/rotatingDrumMedium/caseSetup/particleInsertion delete mode 100755 tutorials/sphereGranFlow/rotatingDrumSmall/caseSetup/particleInsertion diff --git a/tutorials/grainGranFlow/rotatingDrum/settings/particlesDict b/tutorials/grainGranFlow/rotatingDrum/settings/particlesDict index 2dcb6684..017aa2ef 100644 --- a/tutorials/grainGranFlow/rotatingDrum/settings/particlesDict +++ b/tutorials/grainGranFlow/rotatingDrum/settings/particlesDict @@ -44,8 +44,8 @@ positionParticles orderedInfo { - // minimum space between centers of particles - diameter 0.001; + // minimum distance between particles centers + distance 0.001; // number of particles in the simulation numPoints 50000; diff --git a/tutorials/postprocessPhasicFlow/segregation/settings/particlesDict b/tutorials/postprocessPhasicFlow/segregation/settings/particlesDict index 10a81e34..88f6aa4c 100644 --- a/tutorials/postprocessPhasicFlow/segregation/settings/particlesDict +++ b/tutorials/postprocessPhasicFlow/segregation/settings/particlesDict @@ -24,7 +24,7 @@ positionParticles positionOrderedInfo { - diameter 0.005; // minimum space between centers of particles + distance 0.005; // minimum distance between particles centers numPoints 30000; // number of particles in the simulation axisOrder (z x y); // axis order for filling the space with particles } @@ -41,7 +41,7 @@ setFields { velocity realx3 (0 0 0); // linear velocity (m/s) acceleration realx3 (0 0 0); // linear acceleration (m/s2) - r Velocity realx3 (0 0 0); // rotational velocity (rad/s) + rVelocity realx3 (0 0 0); // rotational velocity (rad/s) shapeName word smallSphere; // name of the particle shape } @@ -53,7 +53,8 @@ setFields selectRandomInfo { begin 0; // begin index of points - end 29999; // end index of points + end 29999; // end index of points + number 10000; // number of points to be selected } fieldValue // fields that the selector is applied to { diff --git a/tutorials/sphereGranFlow/RotaryAirLockValve/caseSetup/shapes b/tutorials/sphereGranFlow/RotaryAirLockValve/caseSetup/shapes index fa676375..0b5d97ae 100644 --- a/tutorials/sphereGranFlow/RotaryAirLockValve/caseSetup/shapes +++ b/tutorials/sphereGranFlow/RotaryAirLockValve/caseSetup/shapes @@ -6,8 +6,8 @@ objectName particleInsertion; objectType dicrionary; fileFormat ASCII; /*---------------------------------------------------------------------------*/ -names (sphere); // names of shapes +names (sphere); // names of shapes -diameters (0.005); // diameter of shapes +diameters (0.005); // diameter of shapes materials (sphereMat); // material names for shapes diff --git a/tutorials/sphereGranFlow/RotaryAirLockValve/cleanThisCase b/tutorials/sphereGranFlow/RotaryAirLockValve/cleanThisCase new file mode 100755 index 00000000..8a0ab919 --- /dev/null +++ b/tutorials/sphereGranFlow/RotaryAirLockValve/cleanThisCase @@ -0,0 +1,7 @@ +#!/bin/sh +cd ${0%/*} || exit 1 # Run from this directory + +ls | grep -P "^(([0-9]+\.?[0-9]*)|(\.[0-9]+))$" | xargs -d"\n" rm -rf +rm -rf VTK + +#------------------------------------------------------------------------------ diff --git a/tutorials/sphereGranFlow/RotaryAirLockValve/runThisCase b/tutorials/sphereGranFlow/RotaryAirLockValve/runThisCase new file mode 100755 index 00000000..c48d71fe --- /dev/null +++ b/tutorials/sphereGranFlow/RotaryAirLockValve/runThisCase @@ -0,0 +1,21 @@ +#!/bin/sh +cd ${0%/*} || exit 1 # Run from this directory +echo "\n<--------------------------------------------------------------------->" +echo "1) Creating particles" +echo "<--------------------------------------------------------------------->\n" +particlesPhasicFlow + +echo "\n<--------------------------------------------------------------------->" +echo "2) Creating geometry" +echo "<--------------------------------------------------------------------->\n" +geometryPhasicFlow + +echo "\n<--------------------------------------------------------------------->" +echo "3) Running the case" +echo "<--------------------------------------------------------------------->\n" +sphereGranFlow + + + + +#------------------------------------------------------------------------------ diff --git a/tutorials/sphereGranFlow/RotaryAirLockValve/settings/domainDict b/tutorials/sphereGranFlow/RotaryAirLockValve/settings/domainDict index 818757f4..d2fe503a 100755 --- a/tutorials/sphereGranFlow/RotaryAirLockValve/settings/domainDict +++ b/tutorials/sphereGranFlow/RotaryAirLockValve/settings/domainDict @@ -2,46 +2,48 @@ | phasicFlow File | | copyright: www.cemf.ir | \* ------------------------------------------------------------------------- */ -objectName domainDict; -objectType dictionary; +objectName domainDict; +objectType dictionary; fileFormat ASCII; /*---------------------------------------------------------------------------*/ -globalBox // Simulation domain: every particles that goes outside this domain will be deleted + +// Simulation domain: every particles that goes outside this domain will be deleted +globalBox { - min (0.397538 0.178212 0.00); - - max (0.725537 0.600214 0.06); + min (0.397538 0.178212 0.00); + + max (0.725537 0.600214 0.06); } boundaries { - left - { - type exit; // other options: periodict, reflective - } + left + { + type exit; // other options: periodict, reflective + } - right - { - type exit; // other options: periodict, reflective - } + right + { + type exit; // other options: periodict, reflective + } - bottom - { - type exit; // other options: periodict, reflective - } + bottom + { + type exit; // other options: periodict, reflective + } - top - { - type exit; // other options: periodict, reflective - } + top + { + type exit; // other options: periodict, reflective + } - rear - { - type exit; // other options: periodict, reflective - } + rear + { + type exit; // other options: periodict, reflective + } - front - { - type exit; // other options: periodict, reflective - } + front + { + type exit; // other options: periodict, reflective + } } diff --git a/tutorials/sphereGranFlow/RotaryAirLockValve/settings/geometryDict b/tutorials/sphereGranFlow/RotaryAirLockValve/settings/geometryDict index f4b737c3..7852401a 100644 --- a/tutorials/sphereGranFlow/RotaryAirLockValve/settings/geometryDict +++ b/tutorials/sphereGranFlow/RotaryAirLockValve/settings/geometryDict @@ -2,50 +2,50 @@ | phasicFlow File | | copyright: www.cemf.ir | \* ------------------------------------------------------------------------- */ -objectName geometryDict; -objectType dictionary; +objectName geometryDict; +objectType dictionary; fileFormat ASCII; /*---------------------------------------------------------------------------*/ motionModel rotatingAxis; // motion model: rotating object around an axis rotatingAxisInfo // information for rotatingAxisMotion motion model { - rotAxis - { - p1 (0.561547 0.372714 0.000); // first point for the axis of rotation - - p2 (0.561547 0.372714 0.010); // second point for the axis of rotation + rotAxis + { + p1 (0.561547 0.372714 0.000); // first point for the axis of rotation + + p2 (0.561547 0.372714 0.010); // second point for the axis of rotation - omega 2.1; // rotation speed (rad/s) + omega 2.1; // rotation speed (rad/s) - startTime 1.25; // Start time of Geometry Rotating (s) - - endTime 7; // End time of Geometry Rotating (s) - } + startTime 1.25; // Start time of Geometry Rotating (s) + + endTime 7; // End time of Geometry Rotating (s) + } } surfaces { - gear - { - type stlWall; // type of the wall + gear + { + type stlWall; // type of the wall - file gear.stl; // file name in stl folder + file gear.stl; // file name in stl folder - material wallMat; // material name of this wall + material wallMat; // material name of this wall - motion rotAxis; // motion component name - } + motion rotAxis; // motion component name + } surfaces - { - type stlWall; // type of the wall + { + type stlWall; // type of the wall - file surfaces.stl; // file name in stl folder + file surfaces.stl; // file name in stl folder - material wallMat; // material name of this wall + material wallMat; // material name of this wall - motion none; // motion component name - } + motion none; // motion component name + } } diff --git a/tutorials/sphereGranFlow/RotaryAirLockValve/settings/particlesDict b/tutorials/sphereGranFlow/RotaryAirLockValve/settings/particlesDict index f5d5de63..8c2e2c92 100644 --- a/tutorials/sphereGranFlow/RotaryAirLockValve/settings/particlesDict +++ b/tutorials/sphereGranFlow/RotaryAirLockValve/settings/particlesDict @@ -2,8 +2,8 @@ | phasicFlow File | | copyright: www.cemf.ir | \* ------------------------------------------------------------------------- */ -objectName particlesDict; -objectType dictionary; +objectName particlesDict; +objectType dictionary; fileFormat ASCII; /*---------------------------------------------------------------------------*/ diff --git a/tutorials/sphereGranFlow/RotaryAirLockValve/settings/settingsDict b/tutorials/sphereGranFlow/RotaryAirLockValve/settings/settingsDict index c65cc4c8..20471dfc 100644 --- a/tutorials/sphereGranFlow/RotaryAirLockValve/settings/settingsDict +++ b/tutorials/sphereGranFlow/RotaryAirLockValve/settings/settingsDict @@ -2,8 +2,8 @@ | phasicFlow File | | copyright: www.cemf.ir | \* ------------------------------------------------------------------------- */ -objectName geometryDict; -objectType dictionary; +objectName geometryDict; +objectType dictionary; fileFormat ASCII; /*---------------------------------------------------------------------------*/ @@ -25,10 +25,12 @@ g (0 -9.8 0); // gravity vector (m/s2) includeObjects (diameter mass); // exclude unnecessary data from saving on disk -excludeObjects (rVelocity.dy1 pStructPosition.dy1 pStructVelocity.dy1); +excludeObjects (); integrationMethod AdamsBashforth2; +integrationHistory off; + writeFormat ascii; // data writting format (ascii or binary) timersReport Yes; // report timers: Yes or No diff --git a/tutorials/sphereGranFlow/binarySystemOfParticles/README.md b/tutorials/sphereGranFlow/binarySystemOfParticles/README.md index 041923d7..c1276f13 100644 --- a/tutorials/sphereGranFlow/binarySystemOfParticles/README.md +++ b/tutorials/sphereGranFlow/binarySystemOfParticles/README.md @@ -47,9 +47,9 @@ positionParticles method ordered; // other options: random or empty orderedInfo { - diameter 0.005; // minimum space between centers of particles - numPoints 30000; // number of particles in the simulation - axisOrder (z x y); // axis order for filling the space with particles + distance 0.005; // minimum space between centers of particles + numPoints 30000; // number of particles in the simulation + axisOrder (z x y); // axis order for filling the space with particles } regionType cylinder; // other options: box and sphere diff --git a/tutorials/sphereGranFlow/binarySystemOfParticles/cleanThisCase b/tutorials/sphereGranFlow/binarySystemOfParticles/cleanThisCase old mode 100644 new mode 100755 diff --git a/tutorials/sphereGranFlow/binarySystemOfParticles/settings/domainDict b/tutorials/sphereGranFlow/binarySystemOfParticles/settings/domainDict index 32064d51..b4ab383c 100755 --- a/tutorials/sphereGranFlow/binarySystemOfParticles/settings/domainDict +++ b/tutorials/sphereGranFlow/binarySystemOfParticles/settings/domainDict @@ -1,49 +1,49 @@ /* -------------------------------*- C++ -*--------------------------------- *\ -| phasicFlow File | -| copyright: www.cemf.ir | +| phasicFlow File | +| copyright: www.cemf.ir | \* ------------------------------------------------------------------------- */ -objectName domainDict; -objectType dictionary; +objectName domainDict; +objectType dictionary; fileFormat ASCII; /*---------------------------------------------------------------------------*/ + // Simulation domain: every particles that goes outside this domain will be deleted - -globalBox +globalBox { - min (-0.12 -0.12 0); + min (-0.12 -0.12 0); - max (0.12 0.12 0.1); + max (0.12 0.12 0.1); } boundaries { - left - { - type exit; // other options: periodic, reflective - } + left + { + type exit; // other options: periodic, reflective + } - right - { - type exit; // other options: periodic, reflective - } + right + { + type exit; // other options: periodic, reflective + } - bottom - { - type exit; // other options: periodic, reflective - } + bottom + { + type exit; // other options: periodic, reflective + } - top - { - type exit; // other options: periodic, reflective - } + top + { + type exit; // other options: periodic, reflective + } - rear - { - type exit; // other options: periodic, reflective - } + rear + { + type exit; // other options: periodic, reflective + } - front - { - type exit; // other options: periodic, reflective - } + front + { + type exit; // other options: periodic, reflective + } } diff --git a/tutorials/sphereGranFlow/binarySystemOfParticles/settings/geometryDict b/tutorials/sphereGranFlow/binarySystemOfParticles/settings/geometryDict index 3ec50c1a..b4992c6e 100755 --- a/tutorials/sphereGranFlow/binarySystemOfParticles/settings/geometryDict +++ b/tutorials/sphereGranFlow/binarySystemOfParticles/settings/geometryDict @@ -2,84 +2,82 @@ | phasicFlow File | | copyright: www.cemf.ir | \* ------------------------------------------------------------------------- */ -objectName geometryDict; -objectType dictionary; +objectName geometryDict; +objectType dictionary; fileFormat ASCII; /*---------------------------------------------------------------------------*/ motionModel rotatingAxis; // motion model can be rotatingAxis or stationary or vibrating rotatingAxisInfo // information for rotatingAxis motion model { - rotAxis - { - p1 (0.0 0.0 0.0); // first point for the axis of rotation + rotAxis + { + p1 (0.0 0.0 0.0); // first point for the axis of rotation - p2 (0.0 0.0 1.0); // second point for the axis of rotation - - omega 1.214; // rotation speed (rad/s) - } + p2 (0.0 0.0 1.0); // second point for the axis of rotation + + omega 1.214; // rotation speed (rad/s) + } } surfaces { - cylinder - { - type cylinderWall; // other options: cuboidWall and planeWall + cylinder + { + type cylinderWall; // other options: cuboidWall and planeWall - p1 (0.0 0.0 0.0); // begin point of cylinder axis + p1 (0.0 0.0 0.0); // begin point of cylinder axis - p2 (0.0 0.0 0.1); // end point of cylinder axis + p2 (0.0 0.0 0.1); // end point of cylinder axis - radius1 0.12; // radius at p1 + radius1 0.12; // radius at p1 - radius2 0.12; // radius at p2 + radius2 0.12; // radius at p2 - resolution 24; // number of divisions + resolution 24; // number of divisions - material prop1; // material name of this wall + material prop1; // material name of this wall - motion rotAxis; // motion component name - } + motion rotAxis; // motion component name + } - /* - This is a plane wall at the rear end of cylinder - */ + /* + This is a plane wall at the rear end of cylinder + */ + wall1 + { + type planeWall; // other options: cuboidWall and cylinderWall - wall1 - { - type planeWall; // other options: cuboidWall and cylinderWall + p1 (-0.12 -0.12 0.0); // first point of the wall - p1 (-0.12 -0.12 0.0); // first point of the wall + p2 (0.12 -0.12 0.0); // second point of the wall - p2 (0.12 -0.12 0.0); // second point of the wall + p3 (0.12 0.12 0.0); // third point of the wall - p3 (0.12 0.12 0.0); // third point of the wall + p4 (-0.12 0.12 0.0); // fourth point of the wall - p4 (-0.12 0.12 0.0); // fourth point of the wall + material prop1; // material name of the wall - material prop1; // material name of the wall + motion rotAxis; // motion component name + } - motion rotAxis; // motion component name - } + /* + This is a plane wall at the front end of cylinder + */ + wall2 + { + type planeWall; // other options: cuboidWall and cylinderWall - /* - This is a plane wall at the front end of cylinder - */ + p1 (-0.12 -0.12 0.1); // first point of the wall - wall2 - { - type planeWall; // other options: cuboidWall and cylinderWall + p2 (0.12 -0.12 0.1); // second point of the wall - p1 (-0.12 -0.12 0.1); // first point of the wall + p3 (0.12 0.12 0.1); // third point of the wall - p2 (0.12 -0.12 0.1); // second point of the wall + p4 (-0.12 0.12 0.1); // fourth point of the wall - p3 (0.12 0.12 0.1); // third point of the wall + material prop1; // material name of the wall - p4 (-0.12 0.12 0.1); // fourth point of the wall - - material prop1; // material name of the wall - - motion rotAxis; // motion component name - } + motion rotAxis; // motion component name + } } diff --git a/tutorials/sphereGranFlow/binarySystemOfParticles/settings/particlesDict b/tutorials/sphereGranFlow/binarySystemOfParticles/settings/particlesDict index b29ebbed..57702104 100755 --- a/tutorials/sphereGranFlow/binarySystemOfParticles/settings/particlesDict +++ b/tutorials/sphereGranFlow/binarySystemOfParticles/settings/particlesDict @@ -2,73 +2,74 @@ | phasicFlow File | | copyright: www.cemf.ir | \* ------------------------------------------------------------------------- */ -objectName particlesDict; -objectType dictionary; +objectName particlesDict; +objectType dictionary; fileFormat ASCII; /*---------------------------------------------------------------------------*/ + setFields { - /* - Default value for fields defined for particles: + /* + Default value for fields defined for particles: - These fields should always be defined for simulations with spherical particles - */ + These fields should always be defined for simulations with spherical particles + */ - defaultValue - { - velocity realx3 (0 0 0); // linear velocity (m/s) + defaultValue + { + velocity realx3 (0 0 0); // linear velocity (m/s) - acceleration realx3 (0 0 0); // linear acceleration (m/s2) + acceleration realx3 (0 0 0); // linear acceleration (m/s2) - rVelocity realx3 (0 0 0); // rotational velocity (rad/s) + rVelocity realx3 (0 0 0); // rotational velocity (rad/s) - shapeName word smallSphere; // name of the particle shape - } + shapeName word smallSphere; // name of the particle shape + } - selectors - { - shapeAssigne - { - selector stridedRange; // other options: box, cylinder, sphere, randomPoints + selectors + { + shapeAssigne + { + selector stridedRange; // other options: box, cylinder, sphere, randomPoints - stridedRangeInfo - { - begin 0; // begin index of points + stridedRangeInfo + { + begin 0; // begin index of points - end 30000; // end index of points + end 30000; // end index of points - stride 3; // stride for selector - } + stride 3; // stride for selector + } - fieldValue // fields that the selector is applied to - { - shapeName word largeSphere; // sets shapeName of the selected points to largeSphere - } - } - } + fieldValue // fields that the selector is applied to + { + shapeName word largeSphere; // sets shapeName of the selected points to largeSphere + } + } + } } -positionParticles // positions particles +positionParticles // positions particles { - method ordered; // other options: random and empty + method ordered; // other options: random and empty - orderedInfo - { - diameter 0.005; // diameter of particles + orderedInfo + { + distance 0.005; // minimum distance between particles centers - numPoints 30000; // number of particles in the simulation + numPoints 30000; // number of particles in the simulation - axisOrder (z x y); // axis order for filling the space with particles - } - - regionType cylinder; // other options: box and sphere + axisOrder (z x y); // axis order for filling the space with particles + } + + regionType cylinder; // other options: box and sphere - cylinderInfo // cylinder information for positioning particles - { - p1 (0.0 0.0 0.003); // begin point of cylinder axis + cylinderInfo // cylinder information for positioning particles + { + p1 (0.0 0.0 0.003); // begin point of cylinder axis - p2 (0.0 0.0 0.097); // end point of cylinder axis + p2 (0.0 0.0 0.097); // end point of cylinder axis - radius 0.117; // radius of cylinder - } + radius 0.117; // radius of cylinder + } } diff --git a/tutorials/sphereGranFlow/binarySystemOfParticles/settings/settingsDict b/tutorials/sphereGranFlow/binarySystemOfParticles/settings/settingsDict index 3b341e60..34a6ce39 100755 --- a/tutorials/sphereGranFlow/binarySystemOfParticles/settings/settingsDict +++ b/tutorials/sphereGranFlow/binarySystemOfParticles/settings/settingsDict @@ -2,37 +2,37 @@ | phasicFlow File | | copyright: www.cemf.ir | \* ------------------------------------------------------------------------- */ -objectName settingsDict; -objectType dictionary; +objectName settingsDict; +objectType dictionary; fileFormat ASCII; /*---------------------------------------------------------------------------*/ run binarySystemofParticles; -dt 0.00001; // time step for integration (seconds) +dt 0.00001; // time step for integration (seconds) -startTime 0.0; // start time for simulation +startTime 0.0; // start time for simulation -endTime 10.0; // end time for simulation +endTime 10.0; // end time for simulation -saveInterval 0.1; // time interval for saving the simulation +saveInterval 0.1; // time interval for saving the simulation -timePrecision 6; // maximum number of digits for time folder +timePrecision 6; // maximum number of digits for time folder -g (0 -9.8 0); // gravity vector (m/s2) +g (0 -9.8 0); // gravity vector (m/s2) // save necessary (i.e., required) data on disk - includeObjects (diameter); // exclude unnecessary data from saving on disk +excludeObjects (); -excludeObjects (rVelocity.dy1 pStructPosition.dy1 pStructVelocity.dy1); +integrationMethod AdamsBashforth2; // integration method -integrationMethod AdamsBashforth2; // integration method +integrationHistory off; // do not keep integration history on disk (saves space) -writeFormat ascii; // data writting format (ascii or binary) +writeFormat ascii; // data writting format (ascii or binary) -timersReport Yes; // report timers +timersReport Yes; // report timers -timersReportInterval 0.1; // time interval for reporting timers +timersReportInterval 0.1; // time interval for reporting timers \ No newline at end of file diff --git a/tutorials/sphereGranFlow/conveyorBelt/caseSetup/particleInsertion b/tutorials/sphereGranFlow/conveyorBelt/caseSetup/particleInsertion index 195f27df..22e0b06b 100755 --- a/tutorials/sphereGranFlow/conveyorBelt/caseSetup/particleInsertion +++ b/tutorials/sphereGranFlow/conveyorBelt/caseSetup/particleInsertion @@ -6,46 +6,46 @@ objectName particleInsertion; objectType dicrionary; fileFormat ASCII; /*---------------------------------------------------------------------------*/ -active Yes; // is insertion active -> yes or no -checkForCollision No; // is checked -> yes or no +active Yes; // is insertion active -> yes or no + +checkForCollision No; // is checked -> yes or no /* - one layers of particles are packed + one layer of particles are packed */ - layer0 { - timeControl simulationTime; + timeControl simulationTime; - regionType cylinder; // type of insertion region + regionType cylinder; // type of insertion region - rate 15000; // insertion rate (particles/s) + rate 15000; // insertion rate (particles/s) - startTime 0; // (s) + startTime 0; // (s) - endTime 0.5; // (s) + endTime 0.5; // (s) - insertionInterval 0.025; // s + insertionInterval 0.025; // s - cylinderInfo - { - radius 0.09; // radius of cylinder (m) + cylinderInfo + { + radius 0.09; // radius of cylinder (m) - p1 ( 0.0 0.0 0.1 ); // (m,m,m) + p1 ( 0.0 0.0 0.1 ); // (m,m,m) - p2 ( 0.0 0.0 0.11); // (m,m,m) - } - - setFields - { - velocity realx3 (0.0 0.0 -0.6); // initial velocity of inserted particles - } - - mixture - { - lightSphere 1; // mixture composition of inserted particles - } + p2 ( 0.0 0.0 0.11); // (m,m,m) + } + + setFields + { + velocity realx3 (0.0 0.0 -0.6); // initial velocity of inserted particles + } + + mixture + { + lightSphere 1; // mixture composition of inserted particles + } } diff --git a/tutorials/sphereGranFlow/conveyorBelt/caseSetup/shapes b/tutorials/sphereGranFlow/conveyorBelt/caseSetup/shapes index 603c28cb..cc84242f 100755 --- a/tutorials/sphereGranFlow/conveyorBelt/caseSetup/shapes +++ b/tutorials/sphereGranFlow/conveyorBelt/caseSetup/shapes @@ -2,14 +2,15 @@ | phasicFlow File | | copyright: www.cemf.ir | \* ------------------------------------------------------------------------- */ -objectName sphereDict; -objectType sphereShape; +objectName sphereDict; +objectType sphereShape; fileFormat ASCII; /*---------------------------------------------------------------------------*/ -names (lightSphere heavySphere); // names of shapes -diameters (0.007 0.007); // diameter of shapes +names (lightSphere heavySphere); // names of shapes -materials (lightMat heavyMat); // material names for shapes +diameters (0.007 0.007); // diameter of shapes + +materials (lightMat heavyMat); // material names for shapes diff --git a/tutorials/sphereGranFlow/conveyorBelt/settings/domainDict b/tutorials/sphereGranFlow/conveyorBelt/settings/domainDict index 159c33e5..1ae5faa4 100755 --- a/tutorials/sphereGranFlow/conveyorBelt/settings/domainDict +++ b/tutorials/sphereGranFlow/conveyorBelt/settings/domainDict @@ -2,64 +2,62 @@ | phasicFlow File | | copyright: www.cemf.ir | \* ------------------------------------------------------------------------- */ -objectName domainDict; -objectType dictionary; +objectName domainDict; +objectType dictionary; fileFormat ASCII; /*---------------------------------------------------------------------------*/ -globalBox // Simulation domain: every particles that goes outside this domain will be deleted + +// Simulation domain: every particles that goes outside this domain will be deleted +globalBox { - min (-0.11 -0.11 -0.41); - - max ( 0.33 0.11 0.41); + min (-0.11 -0.11 -0.41); + + max ( 0.33 0.11 0.41); } boundaries { - // Determines how often (how many iterations) do you want to + // Determines how often (how many iterations) do you want to + // rebuild the list of particles in the neighbor list + // of all boundaries in the simulation domain - // rebuild the list of particles in the neighbor list + neighborListUpdateInterval 30; + + // Determines how often do you want to update the new changes in the boundary + updateInterval 10; - // of all boundaries in the simulation domain + // The distance from the boundary plane within which particles are marked to be in the boundary list + neighborLength 0.004; - neighborListUpdateInterval 30; - - // Determines how often do you want to update the new changes in the boundary + left + { + type exit; // other options: periodict, reflective + } - updateInterval 10; + right + { + type exit; // other options: periodict, reflective + } - // The distance from the boundary plane within which particles are marked to be in the boundary list + bottom + { + type exit; // other options: periodict, reflective + } - neighborLength 0.004; + top + { + type exit; // other options: periodict, reflective + } - left - { - type exit; // other options: periodict, reflective - } + rear + { + type exit; // other options: periodict, reflective + } - right - { - type exit; // other options: periodict, reflective - } - - bottom - { - type exit; // other options: periodict, reflective - } - - top - { - type exit; // other options: periodict, reflective - } - - rear - { - type exit; // other options: periodict, reflective - } - - front - { - type exit; // other options: periodict, reflective - } + front + { + type exit; // other options: periodict, reflective + } } diff --git a/tutorials/sphereGranFlow/conveyorBelt/settings/geometryDict b/tutorials/sphereGranFlow/conveyorBelt/settings/geometryDict index 73f24386..251e94b7 100755 --- a/tutorials/sphereGranFlow/conveyorBelt/settings/geometryDict +++ b/tutorials/sphereGranFlow/conveyorBelt/settings/geometryDict @@ -2,11 +2,13 @@ | phasicFlow File | | copyright: www.cemf.ir | \* ------------------------------------------------------------------------- */ -objectName geometryDict; -objectType dictionary; +objectName geometryDict; +objectType dictionary; fileFormat ASCII; /*---------------------------------------------------------------------------*/ -motionModel conveyorBelt; // motion model can be rotatingAxis or stationary or vibrating + +// motion model can be rotatingAxis or stationary or vibrating +motionModel conveyorBelt; conveyorBeltInfo { @@ -18,63 +20,58 @@ conveyorBeltInfo surfaces { - cylinderShell - { - type cylinderWall; // other options: cuboidWall and planeWall + cylinderShell + { + type cylinderWall; // other options: cuboidWall and planeWall - p1 (0.0 0.0 0.0); // begin point of cylinder axis + p1 (0.0 0.0 0.0); // begin point of cylinder axis - p2 (0.0 0.0 0.4); // end point of cylinder axis + p2 (0.0 0.0 0.4); // end point of cylinder axis - radius1 0.1; // radius at p1 + radius1 0.1; // radius at p1 - radius2 0.1; // radius at p2 + radius2 0.1; // radius at p2 - resolution 36; // number of divisions + resolution 36; // number of divisions - material wallMat; // material name of this wall - } + material wallMat; // material name of this wall + } - coneShell - { - type cylinderWall; // other options: cuboidWall and planeWall + coneShell + { + type cylinderWall; // other options: cuboidWall and planeWall - p1 (0.0 0.0 -0.1); // begin point of cylinder axis + p1 (0.0 0.0 -0.1); // begin point of cylinder axis - p2 (0.0 0.0 0.0); // end point of cylinder axis + p2 (0.0 0.0 0.0); // end point of cylinder axis - radius1 0.02; // radius at p1 + radius1 0.02; // radius at p1 - radius2 0.1; // radius at p2 + radius2 0.1; // radius at p2 - resolution 36; // number of divisions + resolution 36; // number of divisions - material wallMat; // material name of this wall - } + material wallMat; // material name of this wall + } - belt - { - type stlWall; // type of the wall + belt + { + type stlWall; // type of the wall - file belt.stl; // file name in stl folder + file belt.stl; // file name in stl folder - material wallMat; // material name of this wall + material wallMat; // material name of this wall - motion conveyorBelt1; // motion component name - } + motion conveyorBelt1; // motion component name + } - box - { - type stlWall; // type of the wall + box + { + type stlWall; // type of the wall - file box.stl; // file name in stl folder + file box.stl; // file name in stl folder - material wallMat; // material name of this wall - } + material wallMat; // material name of this wall + } } - - - - - diff --git a/tutorials/sphereGranFlow/conveyorBelt/settings/particlesDict b/tutorials/sphereGranFlow/conveyorBelt/settings/particlesDict index 4df47975..397b29e8 100755 --- a/tutorials/sphereGranFlow/conveyorBelt/settings/particlesDict +++ b/tutorials/sphereGranFlow/conveyorBelt/settings/particlesDict @@ -6,16 +6,14 @@ objectName particlesDict; objectType dictionary; fileFormat ASCII; /*---------------------------------------------------------------------------*/ + setFields { /* Default value for fields defined for particles - These fields should always be defined for simulations with - spherical particles. */ - defaultValue { velocity realx3 (0 0 0); // linear velocity (m/s) @@ -31,17 +29,8 @@ setFields {} } -positionParticles // positions particles +positionParticles { - method empty; // other options: ordered and random - - regionType box; // other options: cylinder and sphere - - boxInfo // box region for positioning particles - { - min (-0.08 -0.08 0.015); // lower corner point of the box - - max ( 0.08 0.08 0.098); // upper corner point of the box - } + method empty; // other options: file, ordered and random } diff --git a/tutorials/sphereGranFlow/conveyorBelt/settings/settingsDict b/tutorials/sphereGranFlow/conveyorBelt/settings/settingsDict index c5b6650d..3d3f5658 100755 --- a/tutorials/sphereGranFlow/conveyorBelt/settings/settingsDict +++ b/tutorials/sphereGranFlow/conveyorBelt/settings/settingsDict @@ -2,41 +2,39 @@ | phasicFlow File | | copyright: www.cemf.ir | \* ------------------------------------------------------------------------- */ -objectName settingsDict; -objectType dictionary; +objectName settingsDict; +objectType dictionary; fileFormat ASCII; /*---------------------------------------------------------------------------*/ -run layerdSiloFilling; -dt 0.00005; // time step for integration (s) +run conveyorBelt; -startTime 0.0; // start time for simulation +dt 0.00005; // time step for integration (s) -endTime 5.0; // end time for simulation +startTime 0.0; // start time for simulation -saveInterval 0.05; // time interval for saving the simulation +endTime 5.0; // end time for simulation -timePrecision 6; // maximum number of digits for time folder +saveInterval 0.05; // time interval for saving the simulation -g (0 0 -9.8); // gravity vector (m/s2) +timePrecision 6; // maximum number of digits for time folder + +g (0 0 -9.8); // gravity vector (m/s2) // save data objects that are not automatically saved on disk. - // overrides the default behavior - includeObjects (diameter); // exclude unnecessary data from saving on disk - excludeObjects (rVelocity.dy1 pStructPosition.dy1 pStructVelocity.dy1); -integrationMethod AdamsBashforth2; // integration method +integrationMethod AdamsBashforth2; // integration method -writeFormat ascii; // data writting format (ascii or binary) +writeFormat ascii; // data writting format (ascii or binary) -timersReport Yes; // report timers +timersReport Yes; // report timers -timersReportInterval 0.01; // time interval for reporting timers +timersReportInterval 0.01; // time interval for reporting timers diff --git a/tutorials/sphereGranFlow/drum-PeriodicBoundary/README.md b/tutorials/sphereGranFlow/drum-PeriodicBoundary/README.md index 48296411..558ac7c8 100644 --- a/tutorials/sphereGranFlow/drum-PeriodicBoundary/README.md +++ b/tutorials/sphereGranFlow/drum-PeriodicBoundary/README.md @@ -72,7 +72,7 @@ boundaries ## Running the Case The solver for this simulation is `sphereGranFlow`. Enter the following commands in the terminal. Depending on the computational power, it may take a few minutes to a few hours to complete. -```sh +``` geometryPhasicFlow particlesPhasicFlow sphereGranFlow @@ -81,6 +81,6 @@ sphereGranFlow ## Post Processing After finishing the simulation, you can render the results in ParaView. To convert the results to VTK format, just enter the following command in the terminal. This will convert all the results (particles and geometry) to VTK format and store them in the `VTK/` folder. -```sh +``` pFlowToVTK --binary ``` diff --git a/tutorials/sphereGranFlow/drum-PeriodicBoundary/caseSetup/shapes b/tutorials/sphereGranFlow/drum-PeriodicBoundary/caseSetup/shapes index 7b563b12..2bcfddd7 100755 --- a/tutorials/sphereGranFlow/drum-PeriodicBoundary/caseSetup/shapes +++ b/tutorials/sphereGranFlow/drum-PeriodicBoundary/caseSetup/shapes @@ -2,12 +2,12 @@ | phasicFlow File | | copyright: www.cemf.ir | \* ------------------------------------------------------------------------- */ -objectName sphereDict; -objectType sphereShape; +objectName sphereDict; +objectType sphereShape; fileFormat ASCII; /*---------------------------------------------------------------------------*/ -names (sphere1); // names of shapes +names (sphere1); // names of shapes -diameters (0.004); // diameter of shapes +diameters (0.004); // diameter of shapes -materials (prop1); // material names for shapes +materials (prop1); // material names for shapes diff --git a/tutorials/sphereGranFlow/drum-PeriodicBoundary/settings/geometryDict b/tutorials/sphereGranFlow/drum-PeriodicBoundary/settings/geometryDict index e87cbc6a..341d412d 100644 --- a/tutorials/sphereGranFlow/drum-PeriodicBoundary/settings/geometryDict +++ b/tutorials/sphereGranFlow/drum-PeriodicBoundary/settings/geometryDict @@ -2,8 +2,8 @@ | phasicFlow File | | copyright: www.cemf.ir | \* ------------------------------------------------------------------------- */ -objectName geometryDict; -objectType dictionary; +objectName geometryDict; +objectType dictionary; fileFormat ASCII; /*---------------------------------------------------------------------------*/ diff --git a/tutorials/sphereGranFlow/drum-PeriodicBoundary/settings/particlesDict b/tutorials/sphereGranFlow/drum-PeriodicBoundary/settings/particlesDict index d1d24bb6..dfd0ec90 100644 --- a/tutorials/sphereGranFlow/drum-PeriodicBoundary/settings/particlesDict +++ b/tutorials/sphereGranFlow/drum-PeriodicBoundary/settings/particlesDict @@ -2,33 +2,33 @@ | phasicFlow File | | copyright: www.cemf.ir | \* ------------------------------------------------------------------------- */ -objectName particlesDict; -objectType dictionary; +objectName particlesDict; +objectType dictionary; fileFormat ASCII; /*---------------------------------------------------------------------------*/ setFields { - /* - Default value for fields defined for particles - These fields should always be defined for simulations with - spherical particles. - */ - defaultValue - { - velocity realx3 (0 0 0); // linear velocity (m/s) + /* + Default value for fields defined for particles + These fields should always be defined for simulations with + spherical particles. + */ + defaultValue + { + velocity realx3 (0 0 0); // linear velocity (m/s) - acceleration realx3 (0 0 0); // linear acceleration (m/s2) + acceleration realx3 (0 0 0); // linear acceleration (m/s2) - rVelocity realx3 (0 0 0); // rotational velocity (rad/s) + rVelocity realx3 (0 0 0); // rotational velocity (rad/s) - shapeName word sphere1; // name of the particle shape - } + shapeName word sphere1; // name of the particle shape + } - selectors - {} + selectors + {} } positionParticles { - method empty; // no particle at the start of simulation + method empty; // no particle at the start of simulation } diff --git a/tutorials/sphereGranFlow/drum-PeriodicBoundary/settings/settingsDict b/tutorials/sphereGranFlow/drum-PeriodicBoundary/settings/settingsDict index 6dbfc53a..b7f92697 100644 --- a/tutorials/sphereGranFlow/drum-PeriodicBoundary/settings/settingsDict +++ b/tutorials/sphereGranFlow/drum-PeriodicBoundary/settings/settingsDict @@ -24,17 +24,11 @@ g (0 -9.8 0); // gravity vector (m/s2) includeObjects (diameter); // save necessary (i.e., required) data on disk // exclude unnecessary data from saving on disk -excludeObjects (rVelocity.dy1 - rVelocity.dy2 - rVelocity.dy3 - pStructPosition.dy1 - pStructPosition.dy2 - pStructPosition.dy3 - pStructVelocity.dy1 - pStructVelocity.dy2 - pStructVelocity.dy3); +excludeObjects (); -integrationMethod AdamsBashforth4; // integration method +integrationMethod AdamsBashforth4; // integration method + +integrationHistory off; // to save space on disk writeFormat ascii; // data writting format (ascii or binary) diff --git a/tutorials/sphereGranFlow/homogenizationSilo-PeriodicBoundary/README.md b/tutorials/sphereGranFlow/homogenizationSilo-PeriodicBoundary/README.md index b1e41664..3e670c4c 100644 --- a/tutorials/sphereGranFlow/homogenizationSilo-PeriodicBoundary/README.md +++ b/tutorials/sphereGranFlow/homogenizationSilo-PeriodicBoundary/README.md @@ -3,7 +3,7 @@ ## Problem A homogenization silo is used to mix particles inside a silo using the circulation of particles. A pneumatic conveying system carries particles from the exit and re-enters them from the top. Here, we use a `periodic` boundary to simulate the action of the pneumatic conveyor system for circulating particles. Particles exiting from the bottom are re-entered from the top using this boundary (`periodic`). -The simulation case setup is essentially similar to the [`layeredSiloFilling`](https://github.com/PhasicFlow/phasicFlow/tree/main/tutorials/sphereGranFlow/layeredSiloFilling) tutorial. There is also another change with regard to `layeredSiloFilling`. The exit gate is opened after the filling phase of the silo (see `settings/geometryDict` for more details). +The simulation case setup is essentially similar to the [`layeredSiloFilling`](../layeredSiloFilling/) tutorial. There is also another change with regard to `layeredSiloFilling`. The exit gate is opened after the filling phase of the silo (see `settings/geometryDict` for more details).
diff --git a/tutorials/sphereGranFlow/homogenizationSilo-PeriodicBoundary/caseSetup/interaction b/tutorials/sphereGranFlow/homogenizationSilo-PeriodicBoundary/caseSetup/interaction index f5fc4f23..75f65ec4 100755 --- a/tutorials/sphereGranFlow/homogenizationSilo-PeriodicBoundary/caseSetup/interaction +++ b/tutorials/sphereGranFlow/homogenizationSilo-PeriodicBoundary/caseSetup/interaction @@ -37,7 +37,6 @@ model heavyMat-heavyMat heavyMat-wallMat wallMat-wallMat ); */ - Yeff (1.0e6 1.0e6 1.0e6 // Young modulus [Pa] 1.0e6 1.0e6 1.0e6); diff --git a/tutorials/sphereGranFlow/homogenizationSilo-PeriodicBoundary/caseSetup/particleInsertion b/tutorials/sphereGranFlow/homogenizationSilo-PeriodicBoundary/caseSetup/particleInsertion index 2dc7bea7..bb44dcb6 100755 --- a/tutorials/sphereGranFlow/homogenizationSilo-PeriodicBoundary/caseSetup/particleInsertion +++ b/tutorials/sphereGranFlow/homogenizationSilo-PeriodicBoundary/caseSetup/particleInsertion @@ -26,189 +26,185 @@ layer0 insertionInterval 0.025; // s - cylinderInfo - { - radius 0.09; // radius of cylinder (m) + cylinderInfo + { + radius 0.09; // radius of cylinder (m) - p1 (0.0 0.0 0.1); // (m,m,m) + p1 (0.0 0.0 0.1); // (m,m,m) - p2 (0.0 0.0 0.11); // (m,m,m) - } - - setFields - { - velocity realx3 (0.0 0.0 -0.6); // initial velocity of inserted particles - } - - mixture - { - parType1 1; // mixture composition of inserted particles - } + p2 (0.0 0.0 0.11); // (m,m,m) + } + + setFields + { + velocity realx3 (0.0 0.0 -0.6); // initial velocity of inserted particles + } + + mixture + { + parType1 1; // mixture composition of inserted particles + } } layer1 { - timeControl simulationTime; + timeControl simulationTime; - regionType cylinder; // type of insertion region + regionType cylinder; // type of insertion region - rate 5100; // insertion rate (particles/s) + rate 5100; // insertion rate (particles/s) - startTime 0.7; // (s) + startTime 0.7; // (s) - endTime 1.2; // (s) + endTime 1.2; // (s) - insertionInterval 0.025; // s + insertionInterval 0.025; // s - - cylinderInfo - { - radius 0.09; - p1 (0.0 0.0 0.16 ); // (m,m,m) - p2 (0.0 0.0 0.17); // (m,m,m) - } - - setFields - { - velocity realx3 (0.0 0.0 -0.6); - } - - mixture - { - parType2 1; // only parType2 - - } + + cylinderInfo + { + radius 0.09; + p1 (0.0 0.0 0.16 ); // (m,m,m) + p2 (0.0 0.0 0.17); // (m,m,m) + } + + setFields + { + velocity realx3 (0.0 0.0 -0.6); + } + + mixture + { + parType2 1; // only parType2 + + } } layer2 { - timeControl simulationTime; + timeControl simulationTime; - regionType cylinder; // type of insertion region + regionType cylinder; // type of insertion region - rate 5100; // insertion rate (particles/s) + rate 5100; // insertion rate (particles/s) - startTime 1.4; // (s) + startTime 1.4; // (s) - endTime 1.9; // (s) + endTime 1.9; // (s) - insertionInterval 0.025; // s + insertionInterval 0.025; // s - cylinderInfo - { - radius 0.09; - p1 ( 0.0 0.0 0.2 ); // (m,m,m) - p2 ( 0.0 0.0 0.21); // (m,m,m) - } - - setFields - { - velocity realx3 (0.0 0.0 -0.6); - } - - mixture - { - parType1 1; // only parType1 - - } + cylinderInfo + { + radius 0.09; + p1 ( 0.0 0.0 0.2 ); // (m,m,m) + p2 ( 0.0 0.0 0.21); // (m,m,m) + } + + setFields + { + velocity realx3 (0.0 0.0 -0.6); + } + + mixture + { + parType1 1; // only parType1 + } } layer3 { - timeControl simulationTime; + timeControl simulationTime; - regionType cylinder; // type of insertion region + regionType cylinder; // type of insertion region - rate 5100; // insertion rate (particles/s) + rate 5100; // insertion rate (particles/s) - startTime 2.1; // (s) + startTime 2.1; // (s) - endTime 2.6; // (s) + endTime 2.6; // (s) - insertionInterval 0.025; // s - + insertionInterval 0.025; // s - cylinderInfo - { - radius 0.09; - p1 ( 0.0 0.0 0.28 ); // (m,m,m) - p2 ( 0.0 0.0 0.29); // (m,m,m) - } - - setFields - { - velocity realx3 (0.0 0.0 -0.6); - } - - mixture - { - parType2 1; - - } + + cylinderInfo + { + radius 0.09; + p1 ( 0.0 0.0 0.28 ); // (m,m,m) + p2 ( 0.0 0.0 0.29); // (m,m,m) + } + + setFields + { + velocity realx3 (0.0 0.0 -0.6); + } + + mixture + { + parType2 1; + } } layer4 { - timeControl simulationTime; + timeControl simulationTime; - regionType cylinder; // type of insertion region + regionType cylinder; // type of insertion region - rate 5100; // insertion rate (particles/s) + rate 5100; // insertion rate (particles/s) - startTime 2.8; // (s) + startTime 2.8; // (s) - endTime 3.3; // (s) + endTime 3.3; // (s) - insertionInterval 0.025; // s + insertionInterval 0.025; // s - cylinderInfo - { - radius 0.09; - p1 ( 0.0 0.0 0.37 ); // (m,m,m) - p2 ( 0.0 0.0 0.38); // (m,m,m) - } - - setFields - { - velocity realx3 (0.0 0.0 -0.6); - } - - mixture - { - parType1 1; - - } + cylinderInfo + { + radius 0.09; + p1 ( 0.0 0.0 0.37 ); // (m,m,m) + p2 ( 0.0 0.0 0.38); // (m,m,m) + } + + setFields + { + velocity realx3 (0.0 0.0 -0.6); + } + + mixture + { + parType1 1; + } } layer5 { - timeControl simulationTime; + timeControl simulationTime; - regionType cylinder; // type of insertion region + regionType cylinder; // type of insertion region - rate 5100; // insertion rate (particles/s) + rate 5100; // insertion rate (particles/s) - startTime 3.4; // (s) + startTime 3.4; // (s) - endTime 3.9; // (s) + endTime 3.9; // (s) - insertionInterval 0.025; // s + insertionInterval 0.025; // s - cylinderInfo - { - radius 0.09; - p1 ( 0.0 0.0 0.38 ); // (m,m,m) - p2 ( 0.0 0.0 0.39); // (m,m,m) - } - - setFields - { - velocity realx3 (0.0 0.0 -0.6); - } - - mixture - { - parType2 1; - - } + cylinderInfo + { + radius 0.09; + p1 ( 0.0 0.0 0.38 ); // (m,m,m) + p2 ( 0.0 0.0 0.39); // (m,m,m) + } + + setFields + { + velocity realx3 (0.0 0.0 -0.6); + } + + mixture + { + parType2 1; + } } \ No newline at end of file diff --git a/tutorials/sphereGranFlow/homogenizationSilo-PeriodicBoundary/settings/domainDict b/tutorials/sphereGranFlow/homogenizationSilo-PeriodicBoundary/settings/domainDict index 606db9b1..c0d515c0 100755 --- a/tutorials/sphereGranFlow/homogenizationSilo-PeriodicBoundary/settings/domainDict +++ b/tutorials/sphereGranFlow/homogenizationSilo-PeriodicBoundary/settings/domainDict @@ -2,51 +2,51 @@ | phasicFlow File | | copyright: www.cemf.ir | \* ------------------------------------------------------------------------- */ -objectName domainDict; -objectType dictionary; +objectName domainDict; +objectType dictionary; fileFormat ASCII; /*---------------------------------------------------------------------------*/ // Simulation domain: every particles that goes outside this domain will be deleted globalBox { - min (-0.11 -0.11 -0.15); - - max ( 0.11 0.11 0.4); + min (-0.11 -0.11 -0.15); + + max ( 0.11 0.11 0.4); } boundaries { - - left - { - type exit; - } + + left + { + type exit; + } - right - { - type exit; - } + right + { + type exit; + } - bottom - { - type exit; - } + bottom + { + type exit; + } - top - { - type exit; - } + top + { + type exit; + } - rear - { - type periodic; - } + rear // z- + { + type periodic; + } - front - { - type periodic; - } + front // z+ + { + type periodic; + } } diff --git a/tutorials/sphereGranFlow/homogenizationSilo-PeriodicBoundary/settings/geometryDict b/tutorials/sphereGranFlow/homogenizationSilo-PeriodicBoundary/settings/geometryDict index b72f1c07..13d93a19 100755 --- a/tutorials/sphereGranFlow/homogenizationSilo-PeriodicBoundary/settings/geometryDict +++ b/tutorials/sphereGranFlow/homogenizationSilo-PeriodicBoundary/settings/geometryDict @@ -2,8 +2,8 @@ | phasicFlow File | | copyright: www.cemf.ir | \* ------------------------------------------------------------------------- */ -objectName geometryDict; -objectType dictionary; +objectName geometryDict; +objectType dictionary; fileFormat ASCII; /*---------------------------------------------------------------------------*/ @@ -11,73 +11,72 @@ motionModel rotatingAxis; rotatingAxisInfo { - // for opening the gate of silo between time 4.1 and 5.1 s - gateMotion - { - p1 (-0.04 -0.04 -0.1); - p2 (-0.04 -0.04 0.0); - omega 3.14; - startTime 4.1; - endTime 5.1; - } + // for opening the gate of silo between time 4.1 and 5.1 s + gateMotion + { + p1 (-0.04 -0.04 -0.1); + p2 (-0.04 -0.04 0.0); + omega 3.14; + startTime 4.1; + endTime 5.1; + } } surfaces { - cylinderShell - { - type cylinderWall; // other options: cuboidWall and planeWall + cylinderShell + { + type cylinderWall; // other options: cuboidWall and planeWall - p1 (0.0 0.0 0.0); // begin point of cylinder axis + p1 (0.0 0.0 0.0); // begin point of cylinder axis - p2 (0.0 0.0 0.4); // end point of cylinder axis + p2 (0.0 0.0 0.4); // end point of cylinder axis - radius1 0.1; // radius at p1 + radius1 0.1; // radius at p1 - radius2 0.1; // radius at p2 + radius2 0.1; // radius at p2 - resolution 36; // number of divisions + resolution 36; // number of divisions - material wallMat; // material name of this wall - } + material wallMat; // material name of this wall + } - coneShell - { - type cylinderWall; // other options: cuboidWall and planeWall + coneShell + { + type cylinderWall; // other options: cuboidWall and planeWall - p1 (0.0 0.0 -0.1); // begin point of cylinder axis + p1 (0.0 0.0 -0.1); // begin point of cylinder axis - p2 (0.0 0.0 0.0); // end point of cylinder axis + p2 (0.0 0.0 0.0); // end point of cylinder axis - radius1 0.04; // radius at p1 + radius1 0.04; // radius at p1 - radius2 0.1; // radius at p2 + radius2 0.1; // radius at p2 - resolution 36; // number of divisions + resolution 36; // number of divisions - material wallMat; // material name of this wall - } + material wallMat; // material name of this wall + } - /* - This is a plane wall at the exit of silo - */ + /* + This is a plane wall at the exit of silo + */ + exitGate + { + type planeWall; // other options: cuboidWall and cylinderWall - exitGate - { - type planeWall; // other options: cuboidWall and cylinderWall + p1 (-0.04 -0.04 -0.1); // first point of the wall - p1 (-0.04 -0.04 -0.1); // first point of the wall + p2 ( 0.04 -0.04 -0.1); // second point of the wall - p2 ( 0.04 -0.04 -0.1); // second point of the wall + p3 ( 0.04 0.04 -0.1); // third point of the wall - p3 ( 0.04 0.04 -0.1); // third point of the wall + p4 (-0.04 0.04 -0.1); // fourth point of the wall + + material wallMat; // material name of the wall - p4 (-0.04 0.04 -0.1); // fourth point of the wall - - material wallMat; // material name of the wall - - motion gateMotion; - } + motion gateMotion; + } } diff --git a/tutorials/sphereGranFlow/homogenizationSilo-PeriodicBoundary/settings/particlesDict b/tutorials/sphereGranFlow/homogenizationSilo-PeriodicBoundary/settings/particlesDict index a01a553e..7805806f 100755 --- a/tutorials/sphereGranFlow/homogenizationSilo-PeriodicBoundary/settings/particlesDict +++ b/tutorials/sphereGranFlow/homogenizationSilo-PeriodicBoundary/settings/particlesDict @@ -2,35 +2,34 @@ | phasicFlow File | | copyright: www.cemf.ir | \* ------------------------------------------------------------------------- */ -objectName particlesDict; -objectType dictionary; +objectName particlesDict; +objectType dictionary; fileFormat ASCII; /*---------------------------------------------------------------------------*/ setFields { - /* - Default value for fields defined for particles - These fields should always be defined for simulations with - spherical particles. - */ + /* + Default value for fields defined for particles + These fields should always be defined for simulations with + spherical particles. + */ + defaultValue + { + velocity realx3 (0 0 0); // linear velocity (m/s) - defaultValue - { - velocity realx3 (0 0 0); // linear velocity (m/s) + acceleration realx3 (0 0 0); // linear acceleration (m/s2) - acceleration realx3 (0 0 0); // linear acceleration (m/s2) + rVelocity realx3 (0 0 0); // rotational velocity (rad/s) - rVelocity realx3 (0 0 0); // rotational velocity (rad/s) + shapeName word parType1; // name of the particle shape + } - shapeName word parType1; // name of the particle shape - } - - selectors - {} + selectors + {} } positionParticles { - method empty; // empty simulation + method empty; // empty simulation } diff --git a/tutorials/sphereGranFlow/homogenizationSilo-PeriodicBoundary/settings/settingsDict b/tutorials/sphereGranFlow/homogenizationSilo-PeriodicBoundary/settings/settingsDict index 0f119f33..774e1c9c 100755 --- a/tutorials/sphereGranFlow/homogenizationSilo-PeriodicBoundary/settings/settingsDict +++ b/tutorials/sphereGranFlow/homogenizationSilo-PeriodicBoundary/settings/settingsDict @@ -2,40 +2,40 @@ | phasicFlow File | | copyright: www.cemf.ir | \* ------------------------------------------------------------------------- */ -objectName settingsDict; -objectType dictionary; +objectName settingsDict; +objectType dictionary; fileFormat ASCII; /*---------------------------------------------------------------------------*/ run homogenizationSilo; -dt 0.00001; // time step for integration (s) +dt 0.00001; // time step for integration (s) -startTime 0.0; // start time for simulation +startTime 0.0; // start time for simulation -endTime 20; // end time for simulation +endTime 20; // end time for simulation -saveInterval 0.05; // time interval for saving the simulation +saveInterval 0.05; // time interval for saving the simulation -timePrecision 4; // maximum number of digits for time folder +timePrecision 4; // maximum number of digits for time folder -g (0 0 -9.8); // gravity vector (m/s2) +g (0 0 -9.8); // gravity vector (m/s2) // overrides the default behavior includeObjects (diameter); // exclude unnecessary data from saving on disk -excludeObjects (rVelocity.dy1 rVelocity.dy2 rVelocity.dy3 - pStructPosition.dy1 pStructPosition.dy2 pStructPosition.dy3 - pStructVelocity.dy1 pStructVelocity.dy2 pStructVelocity.dy3); +excludeObjects (); -integrationMethod AdamsBashforth4; // integration method +integrationMethod AdamsBashforth4; // integration method -writeFormat binary; // data writting format (ascii or binary) +integrationHistory off; // to save space on disk -timersReport Yes; // report timers +writeFormat binary; // data writting format (ascii or binary) -timersReportInterval 0.1; // time interval for reporting timers +timersReport Yes; // report timers + +timersReportInterval 0.1; // time interval for reporting timers diff --git a/tutorials/sphereGranFlow/layeredSiloFilling/caseSetup/shapes b/tutorials/sphereGranFlow/layeredSiloFilling/caseSetup/shapes index 354e3d53..76ed5ee5 100755 --- a/tutorials/sphereGranFlow/layeredSiloFilling/caseSetup/shapes +++ b/tutorials/sphereGranFlow/layeredSiloFilling/caseSetup/shapes @@ -2,14 +2,14 @@ | phasicFlow File | | copyright: www.cemf.ir | \* ------------------------------------------------------------------------- */ -objectName sphereDict; -objectType sphereShape; +objectName sphereDict; +objectType sphereShape; fileFormat ASCII; /*---------------------------------------------------------------------------*/ -names (lightSphere heavySphere); // names of shapes +names (lightSphere heavySphere); // names of shapes -diameters (0.007 0.007); // diameter of shapes +diameters (0.007 0.007); // diameter of shapes -materials (lightMat heavyMat); // material names for shapes +materials (lightMat heavyMat); // material names for shapes diff --git a/tutorials/sphereGranFlow/layeredSiloFilling/settings/particlesDict b/tutorials/sphereGranFlow/layeredSiloFilling/settings/particlesDict index 66bc9ec0..8db9229c 100755 --- a/tutorials/sphereGranFlow/layeredSiloFilling/settings/particlesDict +++ b/tutorials/sphereGranFlow/layeredSiloFilling/settings/particlesDict @@ -13,7 +13,6 @@ setFields These fields should always be defined for simulations with spherical particles. */ - defaultValue { velocity realx3 (0 0 0); // linear velocity (m/s) diff --git a/tutorials/sphereGranFlow/layeredSiloFilling/settings/settingsDict b/tutorials/sphereGranFlow/layeredSiloFilling/settings/settingsDict index 1beb6649..27047265 100755 --- a/tutorials/sphereGranFlow/layeredSiloFilling/settings/settingsDict +++ b/tutorials/sphereGranFlow/layeredSiloFilling/settings/settingsDict @@ -25,10 +25,12 @@ g (0 0 -9.8); // gravity vector (m/s^2) includeObjects (diameter mass); // exclude unnecessary data from saving on disk -excludeObjects (rVelocity.dy1 pStructPosition.dy1 pStructVelocity.dy1); +excludeObjects (); integrationMethod AdamsBashforth2; // integration method +integrationHistory off; + writeFormat ascii; // data writing format (ascii or binary) timersReport Yes; // report timers diff --git a/tutorials/sphereGranFlow/rotatingDrumMedium/README.md b/tutorials/sphereGranFlow/rotatingDrumMedium/README.md new file mode 100644 index 00000000..42c580c3 --- /dev/null +++ b/tutorials/sphereGranFlow/rotatingDrumMedium/README.md @@ -0,0 +1,161 @@ +# Simulating a Medium-Scale Rotating Drum (v-1.0) + +## Problem Definition + +This tutorial demonstrates the simulation of a medium-sized rotating drum with a diameter of 0.24 m and a length of 0.36 m. The drum is filled with 250,000 spherical glass beads with a diameter of 3 mm. The drum rotates at a constant speed, and the simulation captures the flow behavior and mixing of the particles. + +
+ +A view of the rotating drum simulation + +
+ +*** + +## Setting up the Case + +PhasicFlow simulation case setup is based on text-based scripts provided in two folders located in the simulation case folder: `settings` and `caseSetup`. All commands should be entered in the terminal while the current working directory is the simulation case folder. + +### Creating Particles + +In the file `settings/particlesDict`, two dictionaries, `positionParticles` and `setFields`, define how particles are positioned and what field values they have initially. + +The `positionParticles` dictionary specifies the ordered positioning method to place 250,000 particles within a cylindrical region: + +```C++ +positionParticles +{ + method ordered; // other options: random and empty + + orderedInfo + { + distance 0.003; // minimum distance between particles centers + numPoints 250000; // number of particles in the simulation + axisOrder (z y x); // axis order for filling the space with particles + } + + regionType cylinder; // other options: box and sphere + + cylinderInfo + { + p1 (0.0 0.0 0.003); // begin point of cylinder axis + p2 (0.0 0.0 0.357); // end point of cylinder axis + radius 0.117; // radius of cylinder + } +} +``` + +The `setFields` dictionary defines the initial values for particle fields: + +```C++ +setFields +{ + defaultValue + { + velocity realx3 (0 0 0); // linear velocity (m/s) + acceleration realx3 (0 0 0); // linear acceleration (m/s2) + rVelocity realx3 (0 0 0); // rotational velocity (rad/s) + shapeName word glassBead; // name of the particle shape + } +} +``` + +To create the particles based on these settings, enter the following command in the terminal: + +``` +> particlesPhasicFlow +``` + +### Creating Geometry + +In the file `settings/geometryDict`, you can find information for creating the rotating drum geometry. The simulation uses the `rotatingAxis` motion model to define rotation around a fixed axis. + +The surfaces of the drum are defined in the `surfaces` dictionary, including the cylindrical shell and end walls. + +To create the geometry based on these settings, enter the following command in the terminal: + +``` +> geometryPhasicFlow +``` + +### Defining Properties and Interactions + +In the file `caseSetup/shapes`, the particle shape, diameter, and material are defined: + +```C++ +names (glassBead); // names of shapes +diameters (0.003); // diameter of shapes +materials (glassMat); // material names for shapes +``` + +In the file `caseSetup/interaction`, the material properties and interaction models are defined: + +```C++ +materials (glassMat wallMat); // a list of materials names +densities (2500.0 2500); // density of materials [kg/m3] + +model +{ + contactForceModel nonLinearLimited; + rollingFrictionModel normal; + + /* + Property (glassMat-glassMat glassMat-wallMat + wallMat-wallMat); + */ + + Yeff (1.0e6 1.0e6 + 1.0e6); // Young modulus [Pa] + + Geff (0.8e6 0.8e6 + 0.8e6); // Shear modulus [Pa] + + nu (0.25 0.25 + 0.25); // Poisson's ratio [-] + + en (0.97 0.85 + 1.00); // coefficient of normal restitution + + mu (0.65 0.65 + 0.65); // dynamic friction + + mur (0.1 0.1 + 0.1); // rolling friction +} +``` + +The contact search settings are also defined in this file, including the method, update interval, and other parameters. + +## Running the Simulation + +To run the simulation, follow these steps in order: + +1. Create the initial particle fields: + + ``` + > particlesPhasicFlow + ``` + +2. Create the geometry: + + ``` + > geometryPhasicFlow + ``` + +3. Start the simulation: + + ``` + > sphereGranFlow + ``` + +The simulation will run according to the settings defined in `settings/settingsDict`, including the time step, start/end times, and gravity vector. + +## Post-Processing + +After the simulation is complete, you can visualize the results using ParaView. To convert the simulation results to VTK format, use the following command: + +``` +> pFlowToVTK --binary +``` + +This will create VTK files in the `VTK/` folder that can be opened in ParaView for visualization and analysis. diff --git a/tutorials/sphereGranFlow/rotatingDrumMedium/caseSetup/interaction b/tutorials/sphereGranFlow/rotatingDrumMedium/caseSetup/interaction index 3abd0790..57691172 100755 --- a/tutorials/sphereGranFlow/rotatingDrumMedium/caseSetup/interaction +++ b/tutorials/sphereGranFlow/rotatingDrumMedium/caseSetup/interaction @@ -6,6 +6,7 @@ objectName interaction; objectType dicrionary; fileFormat ASCII; /*---------------------------------------------------------------------------*/ + materials (glassMat wallMat); // a list of materials names densities (2500.0 2500); // density of materials [kg/m3] diff --git a/tutorials/sphereGranFlow/rotatingDrumMedium/caseSetup/particleInsertion b/tutorials/sphereGranFlow/rotatingDrumMedium/caseSetup/particleInsertion deleted file mode 100755 index c4fd4f25..00000000 --- a/tutorials/sphereGranFlow/rotatingDrumMedium/caseSetup/particleInsertion +++ /dev/null @@ -1,10 +0,0 @@ -/* -------------------------------*- C++ -*--------------------------------- *\ -| phasicFlow File | -| copyright: www.cemf.ir | -\* ------------------------------------------------------------------------- */ -objectName particleInsertion; -objectType dicrionary; -fileFormat ASCII; -/*---------------------------------------------------------------------------*/ -active No; // is checked -> Yes or No - diff --git a/tutorials/sphereGranFlow/rotatingDrumMedium/settings/domainDict b/tutorials/sphereGranFlow/rotatingDrumMedium/settings/domainDict index 5c0faa6f..edf8509a 100755 --- a/tutorials/sphereGranFlow/rotatingDrumMedium/settings/domainDict +++ b/tutorials/sphereGranFlow/rotatingDrumMedium/settings/domainDict @@ -6,7 +6,9 @@ objectName domainDict; objectType dictionary; fileFormat ASCII; /*---------------------------------------------------------------------------*/ -globalBox // Simulation domain: every particles that goes outside this domain will be deleted + +// Simulation domain: every particles that goes outside this domain will be deleted +globalBox { min (-0.12 -0.12 0); diff --git a/tutorials/sphereGranFlow/rotatingDrumMedium/settings/geometryDict b/tutorials/sphereGranFlow/rotatingDrumMedium/settings/geometryDict index b1cf7ee0..7e9605b4 100644 --- a/tutorials/sphereGranFlow/rotatingDrumMedium/settings/geometryDict +++ b/tutorials/sphereGranFlow/rotatingDrumMedium/settings/geometryDict @@ -6,6 +6,7 @@ objectName geometryDict; objectType dictionary; fileFormat ASCII; /*---------------------------------------------------------------------------*/ + motionModel rotatingAxis; // motion model: rotating object around an axis diff --git a/tutorials/sphereGranFlow/rotatingDrumMedium/settings/particlesDict b/tutorials/sphereGranFlow/rotatingDrumMedium/settings/particlesDict index 61796a4f..07b12d2c 100644 --- a/tutorials/sphereGranFlow/rotatingDrumMedium/settings/particlesDict +++ b/tutorials/sphereGranFlow/rotatingDrumMedium/settings/particlesDict @@ -36,7 +36,7 @@ positionParticles // positions particles orderedInfo { - diameter 0.003; // minimum space between centers of particles + distance 0.003; // minimum distance between particles centers numPoints 250000; // number of particles in the simulation diff --git a/tutorials/sphereGranFlow/rotatingDrumMedium/settings/settingsDict b/tutorials/sphereGranFlow/rotatingDrumMedium/settings/settingsDict index b6270b50..7281076f 100644 --- a/tutorials/sphereGranFlow/rotatingDrumMedium/settings/settingsDict +++ b/tutorials/sphereGranFlow/rotatingDrumMedium/settings/settingsDict @@ -23,7 +23,7 @@ g (0 -9.8 0); // gravity vector (m/s2) includeObjects (diameter); // save necessary (i.e., required) data on disk // exclude unnecessary data from saving on disk -excludeObjects (rVelocity.dy1 pStructPosition.dy1 pStructVelocity.dy1); +excludeObjects (); integrationMethod AdamsBashforth2; // integration method diff --git a/tutorials/sphereGranFlow/rotatingDrumSmall/README.md b/tutorials/sphereGranFlow/rotatingDrumSmall/README.md index d8955de3..e1d18e44 100644 --- a/tutorials/sphereGranFlow/rotatingDrumSmall/README.md +++ b/tutorials/sphereGranFlow/rotatingDrumSmall/README.md @@ -1,60 +1,62 @@ -# Simularing a rotating drum (v-1.0) -## Problem definition -The problem is to simulate a rotating drum with the diameter 0.24 m and the length 0.1 m rotating at 11.6 rpm. It is filled with 30,000 4-mm spherical particles. The timestep for integration is 0.00001 s. +# Simulating a Rotating Drum (v-1.0) + +## Problem Definition + +The problem is to simulate a rotating drum with a diameter of 0.24 m and a length of 0.1 m, rotating at 11.6 rpm. It is filled with 30,000 spherical particles, each with a diameter of 4 mm. The timestep for integration is 0.00001 s. This tutorial demonstrates the basic setup for creating a rotation-based simulation using built-in geometry in PhasicFlow. +
- -A view of rotating drum +A view of the rotating drum - - -![](https://github.com/PhasicFlow/phasicFlow/blob/media/media/rotating-drum-s.png) - -
+
+ +
+
*** -## Setting up the case -PhasicFlow simulation case setup is based on the text-based scripts that we provide in two folders located in the simulation case folder: `settings` and `caseSetup` (You can find the case setup files in the above folders. -All the commands should be entered in the terminal while the current working directory is the simulation case folder (at the top of the `caseSetup` and `settings`). +## Setting up the Case +PhasicFlow simulation case setup is based on text-based scripts provided in two folders located in the simulation case folder: `settings` and `caseSetup`. All commands should be entered in the terminal while the current working directory is the simulation case folder (at the top level of `caseSetup` and `settings`). -### Creating particles +### Creating Particles -Open the file `settings/particlesDict`. Two dictionaries, `positionParticles` and `setFields` position particles and set the field values for the particles. -In dictionary `positionParticles`, the positioning `method` is `ordered`, which position particles in order in the space defined by `box`. `box` space is defined by two corner points `min` and `max`. In dictionary `orderedInfo`, `numPoints` defines number of particles; `diameter`, the distance between two adjacent particles, and `axisOrder` defines the axis order for filling the space by particles. +In the file `settings/particlesDict`, two dictionaries, `positionParticles` and `setFields`, position particles and set the field values for the particles. + +The `positionParticles` dictionary uses the `ordered` method to position particles in a space defined by `box`. The box space is defined by two corner points: `min` and `max`. In the `orderedInfo` sub-dictionary, `numPoints` defines the number of particles (30,000), `distance` defines the spacing between adjacent particles (4 mm), and `axisOrder` defines the axis order for filling the space with particles.
in settings/particlesDict file
```C++ -positionParticles // positions particles -{ - method ordered; // other options: random and empty +positionParticles +{ + method ordered; // other options: random and empty - mortonSorting Yes; // perform initial sorting based on morton code? + mortonSorting Yes; // perform initial sorting based on morton code? orderedInfo { - diameter 0.004; // minimum space between centers of particles + distance 0.004; // minimum space between centers of particles - numPoints 30000; // number of particles in the simulation + numPoints 30000; // number of particles in the simulation - axisOrder (z y x); // axis order for filling the space with particles + axisOrder (z y x); // axis order for filling the space with particles } - regionType box; // other options: cylinder and sphere + regionType box; // other options: cylinder and sphere - boxInfo // box information for positioning particles + boxInfo // box information for positioning particles { - min (-0.08 -0.08 0.015); // lower corner point of the box + min (-0.08 -0.08 0.015); // lower corner point of the box - max ( 0.08 0.08 0.098); // upper corner point of the box + max ( 0.08 0.08 0.098); // upper corner point of the box } } ``` -In dictionary `setFields`, dictionary `defaultValue` defines the initial value for particle fields (here, `velocity`, `acceleration`, `rotVelocity`, and `shapeName`). Note that `shapeName` field should be consistent with the name of shape that you later set for shapes (here one shape with name `sphere1`). + +In the `setFields` dictionary, the `defaultValue` sub-dictionary defines the initial values for particle fields (velocity, acceleration, rotational velocity, and shape name). The shape name field should be consistent with the name defined in the shapes file (here, "sphere1").
in settings/particlesDict file @@ -76,17 +78,20 @@ setFields selectors { - + // Selectors can be used to modify properties for specific particle groups } } ``` -Enter the following command in the terminal to create the particles and store them in `0` folder. +To create the particles and store them in the `0` folder, enter the following command: -`> particlesPhasicFlow` +``` +particlesPhasicFlow +``` -### Creating geometry -In file `settings/geometryDict` , you can provide information for creating geometry. Each simulation should have a `motionModel` that defines a model for moving the surfaces in the simulation. `rotatingAxis` model defines a fixed axis which rotates around itself. The dictionary `rotAxis` defines an motion component with `p1` and `p2` as the end points of the axis and `omega` as the rotation speed in rad/s. You can define more than one motion component in a simulation. +### Creating Geometry + +In the file `settings/geometryDict`, you define the motion model and geometry for the simulation. The `rotatingAxis` motion model defines a fixed axis which rotates around itself. The `rotAxis` dictionary specifies the axis endpoints and rotation speed.
in settings/geometryDict file @@ -95,19 +100,23 @@ in settings/geometryDict file ```C++ motionModel rotatingAxis; -rotatingAxisInfo // information for rotatingAxisMotion motion model +rotatingAxisInfo { rotAxis { - p1 (0.0 0.0 0.0); // first point for the axis of rotation + p1 (0.0 0.0 0.0); // first point for the axis of rotation - p2 (0.0 0.0 1.0); // second point for the axis of rotation + p2 (0.0 0.0 1.0); // second point for the axis of rotation - omega 1.214; // rotation speed (rad/s) + omega 1.214; // rotation speed (rad/s) } } ``` -In the dictionary `surfaces` you can define all the surfaces (walls) in the simulation. Two main options are available: built-in geometries in PhasicFlow, and providing surfaces with stl file. Here we use built-in geometries. In `cylinder` dictionary, a cylindrical shell with end radii, `radius1` and `radius2`, axis end points `p1` and `p2`, `material` name `prop1`, `motion` component `rotAxis` is defined. `resolution` sets number of division for the cylinder shell. `wall1` and `wall2` define two plane walls at two ends of cylindrical shell with coplanar corner points `p1`, `p2`, `p3`, and `p4`, `material` name `prop1` and `motion` component `rotAxis`. + +The `surfaces` dictionary defines all the walls in the simulation. This tutorial uses built-in geometries provided by PhasicFlow. The geometry consists of: + +1. A `cylinder` dictionary defining a cylindrical shell with end radii (`radius1` and `radius2`), axis endpoints (`p1` and `p2`), material name (`prop1`), and motion component (`rotAxis`). +2. Two plane walls (`wall1` and `wall2`) at the ends of the cylindrical shell, each defined with four coplanar corner points, the same material name, and the same motion component.
in settings/geometryDict file @@ -119,114 +128,119 @@ surfaces /* A cylinder with begin and end radii 0.12 m and axis points at (0 0 0) and (0 0 0.1) */ - cylinder { - type cylinderWall; // type of the wall + type cylinderWall; // type of the wall - p1 (0.0 0.0 0.0); // begin point of cylinder axis + p1 (0.0 0.0 0.0); // begin point of cylinder axis - p2 (0.0 0.0 0.1); // end point of cylinder axis + p2 (0.0 0.0 0.1); // end point of cylinder axis - radius1 0.12; // radius at p1 + radius1 0.12; // radius at p1 - radius2 0.12; // radius at p2 + radius2 0.12; // radius at p2 - resolution 24; // number of divisions + resolution 24; // number of divisions - material prop1; // material name of this wall + material prop1; // material name of this wall - motion rotAxis; // motion component name + motion rotAxis; // motion component name } /* This is a plane wall at the rear end of cylinder */ - wall1 { - type planeWall; // type of the wall + type planeWall; // type of the wall - p1 (-0.12 -0.12 0.0); // first point of the wall + p1 (-0.12 -0.12 0.0); // first point of the wall - p2 ( 0.12 -0.12 0.0); // second point + p2 ( 0.12 -0.12 0.0); // second point - p3 ( 0.12 0.12 0.0); // third point + p3 ( 0.12 0.12 0.0); // third point - p4 (-0.12 0.12 0.0); // fourth point + p4 (-0.12 0.12 0.0); // fourth point - material prop1; // material name of the wall + material prop1; // material name of the wall - motion rotAxis; // motion component name + motion rotAxis; // motion component name } /* This is a plane wall at the front end of cylinder */ - wall2 { - type planeWall; // type of the wall + type planeWall; // type of the wall - p1 (-0.12 -0.12 0.1); // first point of the wall + p1 (-0.12 -0.12 0.1); // first point of the wall - p2 ( 0.12 -0.12 0.1); // second point + p2 ( 0.12 -0.12 0.1); // second point - p3 ( 0.12 0.12 0.1); // third point + p3 ( 0.12 0.12 0.1); // third point - p4 (-0.12 0.12 0.1); // fourth point + p4 (-0.12 0.12 0.1); // fourth point - material prop1; // material name of the wall + material prop1; // material name of the wall - motion rotAxis; // motion component name + motion rotAxis; // motion component name } } ``` -Enter the following command in the terminal to create the geometry and store it in `0/geometry` folder. -`> geometryPhasicFlow` +To create the geometry and store it in the `0/geometry` folder, enter: -### Defining properties and interactions -In the file `caseSetup/interaction` , you find properties of materials. `materials` defines a list of material names in the simulation and `densities` sets the corresponding density of each material name. model dictionary defines the interaction model for particle-particle and particle-wall interactions. `contactForceModel` selects the model for mechanical contacts (here nonlinear model with limited tangential displacement) and `rollingFrictionModel` selects the model for calculating rolling friction. Other required prosperities should be defined in this dictionary. +``` +geometryPhasicFlow +``` + +### Defining Properties and Interactions + +In the file `caseSetup/interaction`, you define properties of materials and their interactions. The `materials` entry lists material names, and `densities` sets the corresponding densities. The `model` dictionary defines the contact force and rolling friction models, along with other required properties.
in caseSetup/interaction file
```C++ -materials (prop1); // a list of materials names -densities (1000.0); // density of materials [kg/m3] -. -. -. +materials (prop1); // a list of materials names + +densities (1000.0); // density of materials [kg/m3] + +contactListType sortedContactList; + model { - contactForceModel nonLinearNonLimited; - rollingFrictionModel normal; + contactForceModel nonLinearNonLimited; - Yeff (1.0e6); // Young modulus [Pa] - Geff (0.8e6); // Shear modulus [Pa] - nu (0.25); // Poisson's ratio [-] - en (0.7); // coefficient of normal restitution - mu (0.3); // dynamic friction - mur (0.1); // rolling friction + rollingFrictionModel normal; + + Yeff (1.0e6); // Young modulus [Pa] + + Geff (0.8e6); // Shear modulus [Pa] + + nu (0.25); // Poisson's ratio [-] + + en (0.7); // coefficient of normal restitution + + mu (0.3); // dynamic friction + + mur (0.1); // rolling friction } ``` -Dictionary `contactSearch` sets the methods for particle-particle and particle-wall contact search. `method` specifies the algorithm for finding neighbor list for particle-particle contacts. `updateInterval` sets the number of iterations between each occurance of updating neighbor list and `sizeRatio` sets the size of enlarged cells (with respect to particle diameter) for finding neighbor list. Larger `sizeRatio` include more particles in the neighbor list and you require to update it less frequent. +The `contactSearch` dictionary specifies the algorithm and parameters for finding particle-particle contacts. The `method` determines the broad search algorithm, `updateInterval` sets how often to update the neighbor list, and `sizeRatio` controls the enlarged cell size for finding neighbors.
in caseSetup/interaction file
```C++ -contactListType sortedContactList; - contactSearch { - - method NBS; // method for broad search - + method NBS; + updateInterval 10; sizeRatio 1.1; @@ -235,57 +249,25 @@ contactSearch adjustableBox Yes; } - ``` -In the file `caseSetup/shape`, you can define a list of `names` for shapes (`shapeName` in particle field), a list of diameters for shapes and their `properties` names. +In the file `caseSetup/shapes`, you define particle shapes, including their names, diameters, and material properties:
-in caseSetup/shape file +in caseSetup/shapes file
```C++ -names (sphere1); // names of shapes -diameters (0.004); // diameter of shapes -materials (prop1); // material names for shapes +names (sphere1); // names of shapes + +diameters (0.004); // diameter of shapes + +materials (prop1); // material names for shapes ``` -Other settings for the simulation can be set in file `settings/settingsDict`. +### Simulation Domain and Boundaries -
-in settings/settingsDict file -
- -```C++ -run rotatingDrumSmall; - -dt 0.00001; // time step for integration (s) - -startTime 0; // start time for simulation - -endTime 10; // end time for simulation - -saveInterval 0.1; // time interval for saving the simulation - -timePrecision 6; // maximum number of digits for time folder - -g (0 -9.8 0); // gravity vector (m/s2) - -includeObjects (diameter); // save necessary (i.e., required) data on disk - -// exclude unnecessary data from saving on disk -excludeObjects (rVelocity.dy1 pStructPosition.dy1 pStructVelocity.dy1); - -integrationMethod AdamsBashforth2; // integration method - -writeFormat ascii; // data writting format (ascii or binary) - -timersReport Yes; // report timers (Yes or No) - -timersReportInterval 0.01; // time interval for reporting timers -``` - -The dictionary `settings/domainDict` defines the a rectangular bounding box with two corner points for the simulation. Each particle that gets out of this box, will be deleted automatically. +The file `settings/domainDict` defines a rectangular bounding box with boundaries. Particles that exit this box are automatically deleted.
in settings/domainDict file @@ -295,52 +277,116 @@ in settings/domainDict file // Simulation domain: every particles that goes outside this domain will be deleted globalBox { - min (-0.12 -0.12 0.00); // lower corner point of the box + min (-0.12 -0.12 0.00); // lower corner point of the box - max (0.12 0.12 0.11); // upper corner point of the box + max (0.12 0.12 0.11); // upper corner point of the box } boundaries { left { - type exit; // other options: periodic, reflective + type exit; // other options: periodic, reflective } right { - type exit; // other options: periodic, reflective + type exit; // other options: periodic, reflective } bottom { - type exit; // other options: periodic, reflective + type exit; // other options: periodic, reflective } top { - type exit; // other options: periodic, reflective + type exit; // other options: periodic, reflective } rear { - type exit; // other options: periodic, reflective + type exit; // other options: periodic, reflective } front { - type exit; // other options: periodic, reflective + type exit; // other options: periodic, reflective } } ``` +### Other Settings -## Running the case -The solver for this simulation is `sphereGranFlow`. Enter the following command in the terminal. Depending on the computational power, it may take a few minutes to a few hours to complete. +Additional parameters for the simulation are set in `settings/settingsDict`, including timestep, start and end times, saving intervals, and gravity: -`> sphereGranFlow` +
+in settings/settingsDict file +
-## Post processing -After finishing the simulation, you can render the results in Paraview. To convert the results to VTK format, just enter the following command in the terminal. This will converts all the results (particles and geometry) to VTK format and store them in folder `VTK/`. +```C++ +dt 0.00001; // time step for integration (s) -`> pFlowToVTK --binary` +startTime 0; // start time for simulation + +endTime 10; // end time for simulation + +saveInterval 0.1; // time interval for saving the simulation + +timePrecision 6; // maximum number of digits for time folder + +g (0 -9.8 0); // gravity vector (m/s2) + +includeObjects (diameter); // save necessary (i.e., required) data on disk + +// exclude unnecessary data from saving on disk +excludeObjects (); + +integrationMethod AdamsBashforth2; // integration method + +integrationHistory off; // to save space on disk + +writeFormat ascii; // data writing format (ascii or binary) + +timersReport Yes; // report timers (Yes or No) +``` + +## Running the Case + +To execute the simulation, follow these steps in order: + +1. Create the geometry: + +``` +geometryPhasicFlow +``` + +2. Create the initial particle fields: + +``` +particlesPhasicFlow +``` + +3. Run the simulation: + +``` +sphereGranFlow +``` + +Depending on your computational resources, the simulation may take from a few minutes to several hours to complete. + +## Post Processing + +After the simulation completes, you can visualize the results in ParaView by converting them to VTK format: + +``` +pFlowToVTK --binary +``` + +This command converts all simulation results (particles and geometry) to VTK format and stores them in a `VTK/` folder. You can then open these files in ParaView for detailed analysis and visualization. + +For more specific field output, you can specify fields: + +``` +pFlowToVTK --binary --fields diameter velocity id +``` diff --git a/tutorials/sphereGranFlow/rotatingDrumSmall/caseSetup/interaction b/tutorials/sphereGranFlow/rotatingDrumSmall/caseSetup/interaction index 2713ed01..1adca27f 100755 --- a/tutorials/sphereGranFlow/rotatingDrumSmall/caseSetup/interaction +++ b/tutorials/sphereGranFlow/rotatingDrumSmall/caseSetup/interaction @@ -6,6 +6,7 @@ objectName interaction; objectType dicrionary; fileFormat ASCII; /*---------------------------------------------------------------------------*/ + materials (prop1); // a list of materials names densities (1000.0); // density of materials [kg/m3] @@ -15,33 +16,33 @@ contactListType sortedContactList; contactSearch { - method NBS; // method for broad search - - updateInterval 10; + method NBS; // method for broad search - sizeRatio 1.1; + updateInterval 10; - cellExtent 0.55; + sizeRatio 1.1; - adjustableBox Yes; + cellExtent 0.55; + + adjustableBox Yes; } model { - contactForceModel nonLinearNonLimited; + contactForceModel nonLinearNonLimited; - rollingFrictionModel normal; + rollingFrictionModel normal; - Yeff (1.0e6); // Young modulus [Pa] + Yeff (1.0e6); // Young modulus [Pa] - Geff (0.8e6); // Shear modulus [Pa] + Geff (0.8e6); // Shear modulus [Pa] - nu (0.25); // Poisson's ratio [-] + nu (0.25); // Poisson's ratio [-] - en (0.7); // coefficient of normal restitution + en (0.7); // coefficient of normal restitution - mu (0.3); // dynamic friction + mu (0.3); // dynamic friction - mur (0.1); // rolling friction + mur (0.1); // rolling friction } diff --git a/tutorials/sphereGranFlow/rotatingDrumSmall/caseSetup/particleInsertion b/tutorials/sphereGranFlow/rotatingDrumSmall/caseSetup/particleInsertion deleted file mode 100755 index cabe23da..00000000 --- a/tutorials/sphereGranFlow/rotatingDrumSmall/caseSetup/particleInsertion +++ /dev/null @@ -1,13 +0,0 @@ -/* -------------------------------*- C++ -*--------------------------------- *\ -| phasicFlow File | -| copyright: www.cemf.ir | -\* ------------------------------------------------------------------------- */ -objectName particleInsertion; -objectType dicrionary; -fileFormat ASCII; -/*---------------------------------------------------------------------------*/ -active No; // is insertion active -> Yes or No - -collisionCheck No; // is checked -> Yes or No - - diff --git a/tutorials/sphereGranFlow/rotatingDrumSmall/caseSetup/shapes b/tutorials/sphereGranFlow/rotatingDrumSmall/caseSetup/shapes index 30ddfb1c..25d23a36 100755 --- a/tutorials/sphereGranFlow/rotatingDrumSmall/caseSetup/shapes +++ b/tutorials/sphereGranFlow/rotatingDrumSmall/caseSetup/shapes @@ -2,12 +2,12 @@ | phasicFlow File | | copyright: www.cemf.ir | \* ------------------------------------------------------------------------- */ -objectName sphereDict; -objectType sphereShape; +objectName sphereDict; +objectType sphereShape; fileFormat ASCII; /*---------------------------------------------------------------------------*/ -names (sphere1); // names of shapes +names (sphere1); // names of shapes -diameters (0.004); // diameter of shapes +diameters (0.004); // diameter of shapes -materials (prop1); // material names for shapes +materials (prop1); // material names for shapes diff --git a/tutorials/sphereGranFlow/rotatingDrumSmall/settings/domainDict b/tutorials/sphereGranFlow/rotatingDrumSmall/settings/domainDict index 730402bc..563cd80d 100755 --- a/tutorials/sphereGranFlow/rotatingDrumSmall/settings/domainDict +++ b/tutorials/sphereGranFlow/rotatingDrumSmall/settings/domainDict @@ -2,46 +2,48 @@ | phasicFlow File | | copyright: www.cemf.ir | \* ------------------------------------------------------------------------- */ -objectName domainDict; -objectType dictionary; +objectName domainDict; +objectType dictionary; fileFormat ASCII; /*---------------------------------------------------------------------------*/ -globalBox // Simulation domain: every particles that goes outside this domain will be deleted -{ - min (-0.12 -0.12 0.00); // lower corner point of the box - max (0.12 0.12 0.11); // upper corner point of the box +// Simulation domain: every particles that goes outside this domain will be deleted +globalBox +{ + min (-0.12 -0.12 0.00); // lower corner point of the box + + max (0.12 0.12 0.11); // upper corner point of the box } boundaries { - left - { - type exit; // other options: periodict, reflective - } + left + { + type exit; // other options: periodic, reflective + } - right - { - type exit; // other options: periodict, reflective - } + right + { + type exit; // other options: periodic, reflective + } - bottom - { - type exit; // other options: periodict, reflective - } + bottom + { + type exit; // other options: periodic, reflective + } - top - { - type exit; // other options: periodict, reflective - } + top + { + type exit; // other options: periodic, reflective + } - rear - { - type exit; // other options: periodict, reflective - } + rear + { + type exit; // other options: periodic, reflective + } - front - { - type exit; // other options: periodict, reflective - } + front + { + type exit; // other options: periodic, reflective + } } diff --git a/tutorials/sphereGranFlow/rotatingDrumSmall/settings/geometryDict b/tutorials/sphereGranFlow/rotatingDrumSmall/settings/geometryDict index d1a55c1f..763a56be 100644 --- a/tutorials/sphereGranFlow/rotatingDrumSmall/settings/geometryDict +++ b/tutorials/sphereGranFlow/rotatingDrumSmall/settings/geometryDict @@ -6,6 +6,7 @@ objectName geometryDict; objectType dictionary; fileFormat ASCII; /*---------------------------------------------------------------------------*/ + motionModel rotatingAxis; rotatingAxisInfo // information for rotatingAxisMotion motion model @@ -25,7 +26,6 @@ surfaces /* A cylinder with begin and end radii 0.12 m and axis points at (0 0 0) and (0 0 0.1) */ - cylinder { type cylinderWall; // type of the wall @@ -48,7 +48,6 @@ surfaces /* This is a plane wall at the rear end of cylinder */ - wall1 { type planeWall; // type of the wall @@ -69,7 +68,6 @@ surfaces /* This is a plane wall at the front end of cylinder */ - wall2 { type planeWall; // type of the wall diff --git a/tutorials/sphereGranFlow/rotatingDrumSmall/settings/particlesDict b/tutorials/sphereGranFlow/rotatingDrumSmall/settings/particlesDict index 23d4af07..f9cb7773 100644 --- a/tutorials/sphereGranFlow/rotatingDrumSmall/settings/particlesDict +++ b/tutorials/sphereGranFlow/rotatingDrumSmall/settings/particlesDict @@ -2,58 +2,55 @@ | phasicFlow File | | copyright: www.cemf.ir | \* ------------------------------------------------------------------------- */ -objectName particlesDict; -objectType dictionary; +objectName particlesDict; +objectType dictionary; fileFormat ASCII; /*---------------------------------------------------------------------------*/ setFields { - /* - Default value for fields defined for particles + /* + Default value for fields defined for particles + These fields should always be defined for simulations with + spherical particles. + */ + defaultValue + { + velocity realx3 (0 0 0); // linear velocity (m/s) - These fields should always be defined for simulations with + acceleration realx3 (0 0 0); // linear acceleration (m/s2) - spherical particles. - */ + rVelocity realx3 (0 0 0); // rotational velocity (rad/s) - defaultValue - { - velocity realx3 (0 0 0); // linear velocity (m/s) + shapeName word sphere1; // name of the particle shape + } - acceleration realx3 (0 0 0); // linear acceleration (m/s2) + selectors + { - rVelocity realx3 (0 0 0); // rotational velocity (rad/s) - - shapeName word sphere1; // name of the particle shape - } - - selectors - { - - } + } } positionParticles // positions particles { - method ordered; // other options: random and empty + method ordered; // other options: random and empty - mortonSorting Yes; // perform initial sorting based on morton code? + mortonSorting Yes; // perform initial sorting based on morton code? - orderedInfo - { - diameter 0.004; // minimum space between centers of particles + orderedInfo + { + distance 0.004; // minimum distance between particles centers - numPoints 30000; // number of particles in the simulation + numPoints 30000; // number of particles in the simulation - axisOrder (z y x); // axis order for filling the space with particles - } + axisOrder (z y x); // axis order for filling the space with particles + } - regionType box; // other options: cylinder and sphere + regionType box; // other options: cylinder and sphere - boxInfo // box information for positioning particles - { - min (-0.08 -0.08 0.015); // lower corner point of the box + boxInfo // box information for positioning particles + { + min (-0.08 -0.08 0.015); // lower corner point of the box - max ( 0.08 0.08 0.098); // upper corner point of the box - } + max ( 0.08 0.08 0.098); // upper corner point of the box + } } diff --git a/tutorials/sphereGranFlow/rotatingDrumSmall/settings/settingsDict b/tutorials/sphereGranFlow/rotatingDrumSmall/settings/settingsDict index 796e1a1a..226a918d 100644 --- a/tutorials/sphereGranFlow/rotatingDrumSmall/settings/settingsDict +++ b/tutorials/sphereGranFlow/rotatingDrumSmall/settings/settingsDict @@ -2,33 +2,36 @@ | phasicFlow File | | copyright: www.cemf.ir | \* ------------------------------------------------------------------------- */ -objectName settingsDict; -objectType dictionary; +objectName settingsDict; +objectType dictionary; fileFormat ASCII; /*---------------------------------------------------------------------------*/ + run rotatingDrumSmall; -dt 0.00001; // time step for integration (s) +dt 0.00001; // time step for integration (s) -startTime 0; // start time for simulation +startTime 0; // start time for simulation -endTime 10; // end time for simulation +endTime 10; // end time for simulation -saveInterval 0.1; // time interval for saving the simulation +saveInterval 0.1; // time interval for saving the simulation -timePrecision 6; // maximum number of digits for time folder +timePrecision 6; // maximum number of digits for time folder -g (0 -9.8 0); // gravity vector (m/s2) +g (0 -9.8 0); // gravity vector (m/s2) includeObjects (diameter); // save necessary (i.e., required) data on disk // exclude unnecessary data from saving on disk excludeObjects (rVelocity.dy1 pStructPosition.dy1 pStructVelocity.dy1); -integrationMethod AdamsBashforth2; // integration method +integrationMethod AdamsBashforth2; // integration method -writeFormat ascii; // data writting format (ascii or binary) +integrationHistory off; -timersReport Yes; // report timers (Yes or No) +writeFormat ascii; // data writting format (ascii or binary) -timersReportInterval 0.01; // time interval for reporting timers +timersReport Yes; // report timers (Yes or No) + +timersReportInterval 0.01; // time interval for reporting timers diff --git a/tutorials/sphereGranFlow/toteBlender/settings/particlesDict b/tutorials/sphereGranFlow/toteBlender/settings/particlesDict index ebb66d3d..7a80fe95 100644 --- a/tutorials/sphereGranFlow/toteBlender/settings/particlesDict +++ b/tutorials/sphereGranFlow/toteBlender/settings/particlesDict @@ -38,7 +38,7 @@ positionParticles orderedInfo { - diameter 0.005; // minimum space between centers of particles + distance 0.005; // minimum distance between particles centers numPoints 24000; // number of particles in the simulation From 2593e2acf160533d87ab6b4cb1eb0899f80084b4 Mon Sep 17 00:00:00 2001 From: Hamidreza Date: Fri, 25 Apr 2025 16:14:16 +0330 Subject: [PATCH 14/15] diameter->distance, update in tutorials, v-Blender readme.md --- .../RotatingDrumWithBaffles/ReadMe.md | 94 ++++--- .../caseSetup/interaction | 3 +- .../caseSetup/particleInsertion | 48 ++-- .../RotatingDrumWithBaffles/caseSetup/shapes | 15 +- .../settings/domainDict | 22 +- .../settings/geometryDict | 123 ++++----- .../settings/particlesDict | 25 +- .../settings/settingsDict | 32 +-- tutorials/sphereGranFlow/V-blender/README.md | 250 ++++++++++++++++++ .../V-blender/caseSetup/interaction | 19 +- .../V-blender/caseSetup/particleInsertion | 38 +-- .../sphereGranFlow/V-blender/caseSetup/shapes | 6 +- .../V-blender/settings/domainDict | 16 +- .../V-blender/settings/geometryDict | 1 + .../V-blender/settings/particlesDict | 28 +- .../V-blender/settings/settingsDict | 28 +- .../sphereGranFlow/V-blender/v-blender.png | Bin 0 -> 161900 bytes .../screwConveyor/caseSetup/particleInsertion | 59 ++--- .../screwConveyor/settings/geometryDict | 1 - .../screwConveyor/settings/particlesDict | 2 - .../screwConveyor/settings/settingsDict | 38 ++- .../sphereGranFlow/toteBlender/ReadMe.md | 2 +- .../toteBlender/settings/settingsDict | 4 +- 23 files changed, 556 insertions(+), 298 deletions(-) create mode 100644 tutorials/sphereGranFlow/V-blender/README.md create mode 100644 tutorials/sphereGranFlow/V-blender/v-blender.png diff --git a/tutorials/sphereGranFlow/RotatingDrumWithBaffles/ReadMe.md b/tutorials/sphereGranFlow/RotatingDrumWithBaffles/ReadMe.md index 8ea62191..2b177b81 100644 --- a/tutorials/sphereGranFlow/RotatingDrumWithBaffles/ReadMe.md +++ b/tutorials/sphereGranFlow/RotatingDrumWithBaffles/ReadMe.md @@ -1,4 +1,5 @@ # Problem Definition (v-1.0) + The problem is to simulate a rotating drum with a diameter of 0.24 m, a length of 0.1 m and 6 baffles rotating at 15 rpm. This drum is filled with 20000 particles, the integration time step is 0.00001 s. There are 2 types of particles in this drum, each of which is inserted during the simulation to fill the drum. * **12500** Particles with **4 mm** diameter, at the rate of 12500 particles/s for 1 sec. * **7500** Particles with **5mm** diameter, at the rate of 7500 particles/s for 1 sec. @@ -15,10 +16,13 @@ The problem is to simulate a rotating drum with a diameter of 0.24 m, a length o # Setting up the Case -As it has been explained in the previous cases, the simulation case setup is based on text-based scripts. Here, the simulation case setup are sorted in three folders: `caseSetup`, `setting` and `stl`. + +As it has been explained in the previous cases, the simulation case setup is based on text-based scripts. Here, the simulation case setup are sorted in three folders: `caseSetup`, `setting` and `stl`. ## Defining small and large particles -Then in the `caseSetup/shapes` the diameter and the material name of the particles are defined. Two sizes are defined: 4 and 5 mm. + +Then in the `caseSetup/shapes` the diameter and the material name of the particles are defined. Two sizes are defined: 4 and 5 mm. + ```C++ // names of shapes names (smallSphere largeSphere); @@ -28,8 +32,8 @@ diameters (0.004 0.005); materials (lightMat heavyMat); ``` - ## Particle Insertion + In this case we have two regions for inserting the particles. In both regions we define the insertion rate, the start and end time of the insertion, information about the volume of space through which the particles are inserted. The insertion phase in the simulation is performed between times 0 and 1 second. For example, for the insertion region for inserting light particles is shown below. @@ -39,31 +43,44 @@ in caseSetup/particleInsertion file ```C++ -// Right Layer Region -layerrightregion +// Right Region +right_region { -// type of insertion region - timeControl simulationTime; - regionType cylinder; -// insertion rate (particles/s) + // type of insertion region + regionType cylinder; + // insertion rate (particles/s) rate 12500; -// Start time of LightParticles insertion (s) + + timeControl simulationTime; + // Start time of insertion (s) startTime 0; -// End time of LightParticles insertion (s) + // End time of insertion (s) endTime 1; -// Time Interval of LightParticles insertion (s) + // Time Interval of insertion (s) insertionInterval 0.025; cylinderInfo { -// Coordinates of cylinderRegion (m,m,m) - p2 (-0.15 0.25 0.05); - p1 (-0.15 0.24 0.05); -// radius of cylinder (m) - radius 0.035; + // Coordinates of cylinderRegion (m,m,m) + p2 (-0.15 0.25 0.05); + p1 (-0.15 0.24 0.05); + // radius of cylinder (m) + radius 0.035; + } + + setFields + { + velocity realx3 (0.0 -0.6 0.0); // initial velocity of inserted particles + } + + mixture + { + smallSphere 1; // mixture composition of inserted particles } } ``` + + ## Interaction between particles and walls The `caseSetup/interaction` file defines the material names and properties as well as the interaction parameters: the interaction between the particles and the shell of the rotating drum. Since we define 3 materials for simulation, the interaction matrix is 3x3, while we only need to enter upper triangle elements (interactions are symmetric). @@ -73,36 +90,37 @@ materials (lightMat heavyMat wallMat); // density of materials [kg/m3] densities (1000 1500 2500); - /* + /* Property (lightMat-lightMat lightMat-heavyMat lightMat-wallMat heavyMat-heavyMat heavyMat-wallMat wallMat-wallMat ); - */ -// Young modulus [Pa] + */ + // Young modulus [Pa] Yeff (1.0e6 1.0e6 1.0e6 1.0e6 1.0e6 1.0e6); -// Shear modulus [Pa] + // Shear modulus [Pa] Geff (0.8e6 0.8e6 0.8e6 0.8e6 0.8e6 0.8e6); -// Poisson's ratio [-] + // Poisson's ratio [-] nu (0.25 0.25 0.25 0.25 0.25 0.25); -// coefficient of normal restitution + // coefficient of normal restitution en (0.97 0.97 0.85 0.97 0.85 1.00); -// dynamic friction + // dynamic friction mu (0.65 0.65 0.35 0.65 0.35 0.35); -// rolling friction + // rolling friction mur (0.1 0.1 0.1 0.1 0.1 0.1); ``` + ## Settings ### Geometry In the `settings/geometryDict` file, the geometry and axis of rotation is defined for the drum. The geometry is composed of a body, front and rear ends. @@ -163,28 +181,32 @@ surfaces In this part of `geometryDict` the information of rotating axis and speed of rotation are defined. The start of rotation is at 2 s. The first 2 seconds of simulation is for allowing particles to settle donw in the drum. ```C++ -motionModel rotatingAxis; + +motionModel rotatingAxis; + rotatingAxisInfo { rotAxis { // first point for the axis of rotation - p1 (-0.1974 0.2269 0); - // second point for the axis of rotation - p2 (-0.1974 0.2269 0.1); - // rotation speed (rad/s) => 15 rpm - omega 2.38733; - // Start time of Geometry Rotating - startTime 2; - // End time of Geometry Rotating - endTime 9.5; + p1 (-0.1974 0.2269 0); + // second point for the axis of rotation + p2 (-0.1974 0.2269 0.1); + // rotation speed (rad/s) => 15 rpm + omega 2.38733; + // Start time of Geometry Rotating + startTime 2; + // End time of Geometry Rotating + endTime 9.5; } } ``` + ## Performing Simulation + To run simulations, type the following commands in the terminal one at a time. Enter `particlesPhasicFlow` command to create the initial fields for particles. Enter `geometryPhasicFlow` command to create the Geometry. At last, enter `sphereGranFlow` command to start the simulation. -After finishing the simulation, you can use `pFlowtoVTK` to convert the results into vtk format stored in ./VTK folder. \ No newline at end of file +After finishing the simulation, you can use `pFlowtoVTK` to convert the results into vtk format stored in ./VTK folder. \ No newline at end of file diff --git a/tutorials/sphereGranFlow/RotatingDrumWithBaffles/caseSetup/interaction b/tutorials/sphereGranFlow/RotatingDrumWithBaffles/caseSetup/interaction index 7572adb9..b0009cda 100644 --- a/tutorials/sphereGranFlow/RotatingDrumWithBaffles/caseSetup/interaction +++ b/tutorials/sphereGranFlow/RotatingDrumWithBaffles/caseSetup/interaction @@ -6,6 +6,7 @@ objectName interaction; objectType dicrionary; fileFormat ASCII; /*---------------------------------------------------------------------------*/ + materials (lightMat heavyMat wallMat); // a list of materials names densities (1000 1500 2500); // density of materials [kg/m3] @@ -14,7 +15,7 @@ contactListType sortedContactList; contactSearch { - method NBS; // method for broad search + method NBS; updateInterval 10; diff --git a/tutorials/sphereGranFlow/RotatingDrumWithBaffles/caseSetup/particleInsertion b/tutorials/sphereGranFlow/RotatingDrumWithBaffles/caseSetup/particleInsertion index 6ba98b98..fd20ef9b 100644 --- a/tutorials/sphereGranFlow/RotatingDrumWithBaffles/caseSetup/particleInsertion +++ b/tutorials/sphereGranFlow/RotatingDrumWithBaffles/caseSetup/particleInsertion @@ -6,78 +6,78 @@ objectName particleInsertion; objectType dicrionary; fileFormat ASCII; /*---------------------------------------------------------------------------*/ -active Yes; // is insertion active -> Yes or No + +active Yes; // is insertion active -> Yes or No /* Two layers of particles are packed one-by-one using 1 insertion steps */ - -layerrightregion // Right Layer Region +right_region { timeControl simulationTime; - regionType cylinder; // type of insertion region + regionType cylinder; // type of insertion region - rate 12500; // Right Region Particles Insertion Rate (particles/s) + rate 12500; // Right Region Particles Insertion Rate (particles/s) - startTime 0; // Start time of LightParticles insertion (s) + startTime 0; // Start time of insertion (s) - endTime 1; // End time of LightParticles insertion (s) + endTime 1; // End time of insertion (s) - insertionInterval 0.025; // Time Interval of LightParticles insertion (s) + insertionInterval 0.025; // Time Interval of particles insertion (s) cylinderInfo { - p2 (-0.15 0.25 0.05); // Top of cylinderRegion (m,m,m) + p2 (-0.15 0.25 0.05); // Top of cylinderRegion (m,m,m) - p1 (-0.15 0.24 0.05); // Bottom of cylinderRegion (m,m,m) + p1 (-0.15 0.24 0.05); // Bottom of cylinderRegion (m,m,m) - radius 0.035; // radius of cylinder (m) + radius 0.035; // radius of cylinder (m) } setFields { - velocity realx3 (0.0 -0.6 0.0); // initial velocity of inserted particles + velocity realx3 (0.0 -0.6 0.0); // initial velocity of inserted particles } mixture { - smallSphere 1; // mixture composition of inserted particles + smallSphere 1; // mixture composition of inserted particles } } -layerleftregion // Left Layer Region +left_region { timeControl simulationTime; - regionType cylinder; // type of insertion region + regionType cylinder; // type of insertion region - rate 7500; // Left Region Particles Insertion Rate (particles/s) + rate 7500; // Left Region Particles Insertion Rate (particles/s) - startTime 0; // Start time of LightParticles insertion (s) + startTime 0; // Start time of insertion (s) - endTime 1; // End time of LightParticles insertion (s) + endTime 1; // End time of insertion (s) - insertionInterval 0.025; // Time Interval of LightParticles insertion (s) + insertionInterval 0.025; // Time Interval of insertion (s) cylinderInfo { - p2 (-0.23 0.25 0.05); // Top of cylinderRegion (m,m,m) + p2 (-0.23 0.25 0.05); // Top of cylinderRegion (m,m,m) - p1 (-0.23 0.24 0.05); // Bottom of cylinderRegion (m,m,m) + p1 (-0.23 0.24 0.05); // Bottom of cylinderRegion (m,m,m) - radius 0.035; // radius of cylinder (m) + radius 0.035; // radius of cylinder (m) } setFields { - velocity realx3 (0.0 -0.6 0.0); // initial velocity of inserted particles + velocity realx3 (0.0 -0.6 0.0); // initial velocity of inserted particles } mixture { - largeSphere 1; // only heavySphere + largeSphere 1; // only heavySphere } } diff --git a/tutorials/sphereGranFlow/RotatingDrumWithBaffles/caseSetup/shapes b/tutorials/sphereGranFlow/RotatingDrumWithBaffles/caseSetup/shapes index 95d438e4..c894548b 100644 --- a/tutorials/sphereGranFlow/RotatingDrumWithBaffles/caseSetup/shapes +++ b/tutorials/sphereGranFlow/RotatingDrumWithBaffles/caseSetup/shapes @@ -2,12 +2,13 @@ | phasicFlow File | | copyright: www.cemf.ir | \* ------------------------------------------------------------------------- */ -objectName sphereDict; -objectType sphereShape; +objectName sphereDict; +objectType sphereShape; fileFormat ASCII; /*---------------------------------------------------------------------------*/ -names (smallSphere largeSphere); // names of shapes - -diameters (0.004 0.005); // diameter of shapes (m) - -materials (lightMat heavyMat); // material names for shapes + +names (smallSphere largeSphere); // names of shapes + +diameters (0.004 0.005); // diameter of shapes (m) + +materials (lightMat heavyMat); // material names for shapes diff --git a/tutorials/sphereGranFlow/RotatingDrumWithBaffles/settings/domainDict b/tutorials/sphereGranFlow/RotatingDrumWithBaffles/settings/domainDict index 74c86ad3..f6a3f02e 100755 --- a/tutorials/sphereGranFlow/RotatingDrumWithBaffles/settings/domainDict +++ b/tutorials/sphereGranFlow/RotatingDrumWithBaffles/settings/domainDict @@ -6,42 +6,44 @@ objectName domainDict; objectType dictionary; fileFormat ASCII; /*---------------------------------------------------------------------------*/ -globalBox // Simulation domain: every particles that goes outside this domain will be deleted -{ - min (-0.328 0.095 -0.025); // lower corner point of the box - max (-0.068 0.355 0.125); // upper corner point of the box +// Simulation domain: every particles that goes outside this domain will be deleted +globalBox +{ + min (-0.328 0.095 -0.025); // lower corner point of the box + + max (-0.068 0.355 0.125); // upper corner point of the box } boundaries { left { - type exit; // other options: periodic, reflective + type exit; // other options: periodic, reflective } right { - type exit; // other options: periodict, reflective + type exit; // other options: periodic, reflective } bottom { - type exit; // other options: periodict, reflective + type exit; // other options: periodic, reflective } top { - type exit; // other options: periodict, reflective + type exit; // other options: periodic, reflective } rear { - type exit; // other options: periodict, reflective + type exit; // other options: periodic, reflective } front { - type exit; // other options: periodict, reflective + type exit; // other options: periodic, reflective } } diff --git a/tutorials/sphereGranFlow/RotatingDrumWithBaffles/settings/geometryDict b/tutorials/sphereGranFlow/RotatingDrumWithBaffles/settings/geometryDict index a7502d1c..d46b854b 100644 --- a/tutorials/sphereGranFlow/RotatingDrumWithBaffles/settings/geometryDict +++ b/tutorials/sphereGranFlow/RotatingDrumWithBaffles/settings/geometryDict @@ -2,80 +2,81 @@ | phasicFlow File | | copyright: www.cemf.ir | \* ------------------------------------------------------------------------- */ -objectName geometryDict; -objectType dictionary; +objectName geometryDict; +objectType dictionary; fileFormat ASCII; /*---------------------------------------------------------------------------*/ + motionModel rotatingAxis; rotatingAxisInfo { rotAxis - { - p1 (-0.1974 0.2269 0); // first point for the axis of rotation - - p2 (-0.1974 0.2269 0.1); // second point for the axis of rotation - - omega 2.38733; // rotation speed (rad/s) => 15 rpm - - startTime 2; // Start time of Geometry Rotating - - endTime 9.5; // End time of Geometry Rotating - } + { + p1 (-0.1974 0.2269 0); // first point for the axis of rotation + + p2 (-0.1974 0.2269 0.1); // second point for the axis of rotation + + omega 2.38733; // rotation speed (rad/s) => 15 rpm + + startTime 2; // Start time of Geometry Rotating + + endTime 9.5; // End time of Geometry Rotating + } } surfaces { - body - { - type stlWall; // type of the wall - - file Body.stl; // file name in stl folder - - material wallMat; // material name of this wall - - motion rotAxis; // motion component name - } + body + { + type stlWall; // type of the wall + + file Body.stl; // file name in stl folder + + material wallMat; // material name of this wall + + motion rotAxis; // motion component name + } - /* - This is a Cylinder Wall at the rear of cylinder - */ + /* + This is a Cylinder Wall at the rear of cylinder + */ - rearEnd - { - type cylinderWall; // type of the wall - - p1 (-0.1974 0.2269 -0.001); // first point for the axis of rotation - - p2 (-0.1974 0.2269 0.0); // second point for the axis of rotation - - radius1 0.0001; // Radius of p1 - - radius2 0.12; // Radius of p2 - - material wallMat; // material name of the wall - - motion rotAxis; // motion component name - } + rearEnd + { + type cylinderWall; // type of the wall + + p1 (-0.1974 0.2269 -0.001); // first point for the axis of rotation + + p2 (-0.1974 0.2269 0.0); // second point for the axis of rotation + + radius1 0.0001; // Radius of p1 + + radius2 0.12; // Radius of p2 + + material wallMat; // material name of the wall + + motion rotAxis; // motion component name + } - /* - This a cylinder Wall at the front of Cylinder - */ + /* + This a cylinder Wall at the front of Cylinder + */ - frontEnd - { - type cylinderWall; // type of the wall - - p1 (-0.1974 0.2269 0.0989); // first point for the axis of rotation - - p2 (-0.1974 0.2269 0.0990); // second point for the axis of rotation - - radius1 0.0001; // Radius of p1 - - radius2 0.12; // Radius of p2 - - material wallMat; // material name of the wall - - motion rotAxis; // motion component name - } + frontEnd + { + type cylinderWall; // type of the wall + + p1 (-0.1974 0.2269 0.0989); // first point for the axis of rotation + + p2 (-0.1974 0.2269 0.0990); // second point for the axis of rotation + + radius1 0.0001; // Radius of p1 + + radius2 0.12; // Radius of p2 + + material wallMat; // material name of the wall + + motion rotAxis; // motion component name + } } diff --git a/tutorials/sphereGranFlow/RotatingDrumWithBaffles/settings/particlesDict b/tutorials/sphereGranFlow/RotatingDrumWithBaffles/settings/particlesDict index b4d5bf80..31f3c913 100644 --- a/tutorials/sphereGranFlow/RotatingDrumWithBaffles/settings/particlesDict +++ b/tutorials/sphereGranFlow/RotatingDrumWithBaffles/settings/particlesDict @@ -10,9 +10,7 @@ setFields { /* Default value for fields defined for particles - These fields should always be defined for simulations with - spherical particles. */ @@ -29,30 +27,13 @@ setFields selectors { - shapeAssigne - { - selector stridedRange; // other options: box, cylinder, sphere, randomPoints - - stridedRangeInfo - { - begin 0; // begin index of points - - end 20000; // end index of points - - stride 3; // stride for selector - } - - fieldValue // fields that the selector is applied to - { - shapeName word sphere1; // sets shapeName of the selected points to largeSphere - } - } + } } -positionParticles // positions particles +positionParticles { - method empty; // other options: random and ordered + method empty; // other options: random, file and ordered } diff --git a/tutorials/sphereGranFlow/RotatingDrumWithBaffles/settings/settingsDict b/tutorials/sphereGranFlow/RotatingDrumWithBaffles/settings/settingsDict index b64a6a85..f4af181a 100644 --- a/tutorials/sphereGranFlow/RotatingDrumWithBaffles/settings/settingsDict +++ b/tutorials/sphereGranFlow/RotatingDrumWithBaffles/settings/settingsDict @@ -2,34 +2,36 @@ | phasicFlow File | | copyright: www.cemf.ir | \* ------------------------------------------------------------------------- */ -objectName settingsDict; -objectType dictionary; +objectName settingsDict; +objectType dictionary; fileFormat ASCII; /*---------------------------------------------------------------------------*/ -run RotatingDrumwithBaffles; +run RotatingDrumwithBaffles; -dt 0.00001; // time step for integration (s) +dt 0.00001; // time step for integration (s) -startTime 0; // start time for simulation +startTime 0; // start time for simulation -endTime 10; // end time for simulation +endTime 10; // end time for simulation -saveInterval 0.05; // time interval for saving the simulation +saveInterval 0.05; // time interval for saving the simulation -timePrecision 6; // maximum number of digits for time folder +timePrecision 6; // maximum number of digits for time folder -g (0 -9.8 0); // gravity vector (m/s2) +g (0 -9.8 0); // gravity vector (m/s2) -// save necessary (i.e., required) data on disk +// save necessary data on disk includeObjects (diameter); // exclude unnecessary data from saving on disk -excludeObjects (rVelocity.dy1 pStructPosition.dy1 pStructVelocity.dy1); +excludeObjects (); -integrationMethod AdamsBashforth2; // integration method +integrationMethod AdamsBashforth2; // integration method -writeFormat ascii; // data writting format (ascii or binary) +integrationHistory off; // to sace space on disk -timersReport Yes; // report timers (Yes or No) +writeFormat ascii; // data writting format (ascii or binary) -timersReportInterval 0.1; // time interval for reporting timers +timersReport Yes; // report timers (Yes or No) + +timersReportInterval 0.1; // time interval for reporting timers diff --git a/tutorials/sphereGranFlow/V-blender/README.md b/tutorials/sphereGranFlow/V-blender/README.md new file mode 100644 index 00000000..323e659b --- /dev/null +++ b/tutorials/sphereGranFlow/V-blender/README.md @@ -0,0 +1,250 @@ +# V-blender Simulation (phasicFlow v-1.0) + +This tutorial demonstrates the simulation of a V-blender, a common mixing device used in pharmaceutical and powder processing industries. The V-blender consists of a V-shaped vessel that rotates around a horizontal axis, allowing for efficient mixing of particulate materials. + + +
+ + + + V-blender simulation with two layers of particles + +
+ +## Problem Definition + +The simulation represents a V-blender with the following characteristics: + +- The blender is initially empty and is filled with two different particle types in sequence +- First layer: Small particles (10 mm diameter) are inserted from the right side +- Second layer: Slightly larger particles (10.1 mm diameter) are inserted from the left side +- The blender begins rotation at t = 3.0 s and continues until t = 10.0 s +- The rotation speed is set to 3.14 rad/s (approximately 0.5 Hz or 30 RPM) +- The simulation runs for a total of 10 seconds + +## Case Setup + +The simulation case setup files are organized in the `settings/` and `caseSetup/` folders. + +### Particles Definition + +Two particle types are defined in the `caseSetup/shapes` file: + +```C++ +names (smallSphere largeSphere); // names of particles +diameters (0.01 0.0101); // diameter of particles (m) +materials (lightMat lightMat); // material names for particles +``` + +Both particle types share the same material properties but differ slightly in size to allow for visual distinction during mixing. + +### Particle Insertion + +Particles are inserted in two sequential phases, as defined in `caseSetup/particleInsertion`: + +```C++ +active Yes; // is insertion active -> Yes or No + +rightregion +{ + timeControl simulationTime; // Controls insertion based on simulation time + + regionType cylinder; // Defines a cylindrical insertion region + + rate 10000; // Inserts 10,000 particles per second + + startTime 0.0; // Starts inserting at t = 0s (beginning of simulation) + + endTime 1.0; // Stops inserting at t = 1s + + insertionInterval 0.025; // Inserts particles every 0.025s + // (40 insertion events during the 1s period) + + cylinderInfo { + // Defines cylinder endpoints and radius + p1 (0.0950615 0.12 0.5011585); // First endpoint coordinates (x,y,z) in meters + p2 (0.1150615 0.12 0.4811585); // Second endpoint coordinates (x,y,z) in meters + radius 0.1; // Cylinder radius in meters + } + + setFields { + // Initial properties for inserted particles + velocity realx3 (1.2 0.0 -1.2); // Initial velocity vector (x,y,z) in m/s + // Particles move to the right and downward + } + + mixture { + // Particle type distribution + smallSphere 1; // 100% of inserted particles are "smallSphere" type + } +} + +leftregion +{ + timeControl simulationTime; // Controls insertion based on simulation time + + regionType cylinder; // Defines a cylindrical insertion region + + rate 10000; // Inserts 10,000 particles per second + + startTime 1.5; // Starts inserting at t = 1.5s + // (after the first insertion phase) + + endTime 2.5; // Stops inserting at t = 2.5s + + insertionInterval 0.025; // Inserts particles every 0.025s + // (40 insertion events during the 1s period) + + cylinderInfo { + // Defines cylinder endpoints and radius + p1 (0.7562545 0.12 0.50079); // First endpoint coordinates (x,y,z) in meters + p2 (0.7362545 0.12 0.48079); // Second endpoint coordinates (x,y,z) in meters + radius 0.1; // Cylinder radius in meters + } + + setFields { + // Initial properties for inserted particles + velocity realx3 (-1.2 0.0 -1.2); // Initial velocity vector (x,y,z) in m/s + // Particles move to the left and downward + } + + mixture { + // Particle type distribution + largeSphere 1; // 100% of inserted particles are "largeSphere" type + } +} +``` + +#### Detailed Explanation of Insertion Parameters + +1. **`rightregion` Dictionary**: + - Creates a cylindrical insertion region on the right side of the V-blender + - Active during t=0s to t=1s at the beginning of the simulation + - Particles are inserted from randomly generated positions within the cylinder + - Inserts "smallSphere" particles with 10mm diameter + - Initial velocity (1.2, 0.0, -1.2) m/s directs particles toward the center and bottom of the blender + - 40 insertion events occur (every 0.025s), each adding approximately 250 particles + +2. **`leftregion` Dictionary**: + - Creates a symmetrical cylindrical insertion region on the left side of the V-blender + - Active during t=1.5s to t=2.5s, after the first batch of particles has settled + - Inserts "largeSphere" particles with 10.1mm diameter + - Initial velocity (-1.2, 0.0, -1.2) m/s directs particles toward the center and bottom of the blender + - Mirror image of the first insertion but with slightly larger particles + +3. **Insertion Region Selection**: + - Cylindrical insertion regions are positioned above each arm of the V-blender + - This arrangement ensures particles fall naturally into the V-blender without initial overlap + +4. **Timing Strategy**: + - Sequential insertion with a 0.5s gap between phases allows the first batch to settle + - All particles settle for 0.5s after the second insertion (t=2.5s to t=3.0s) + - Blender rotation begins after all particles have settled (t=3.0s) + +### Geometry and Motion + +The V-blender geometry is defined in `settings/geometryDict` using an STL file: + +```C++ +motionModel rotatingAxis; // motion model: rotating object around an axis + +rotatingAxisInfo // information for rotatingAxis motion model +{ + rotAxis + { + p1 (0.128228 0.116446 0.297901); // first point for the axis of rotation + p2 (0.722596 0.116459 0.297901); // second point for the axis of rotation + omega 3.14; // rotation speed (rad/s) + startTime 3; // start time of rotation + endTime 10; // end time of rotation + } +} +``` + +The blender starts rotating at t = 3.0 s, after both particle types have been inserted and allowed to settle. + +### Simulation Domain and Boundaries + +The simulation domain is defined in `settings/domainDict`: + +```C++ +globalBox +{ + min (-0.1 -0.4 0); // lower corner point of the box + max (0.86 0.6 0.6); // upper corner point of the box +} +``` + +All boundaries are set to "exit" type, meaning particles that go outside the domain will be deleted. + +### Particle Interaction Properties + +Material properties and interaction parameters are defined in `caseSetup/interaction`: + +```C++ +materials (wallMat lightMat); // a list of materials names +densities (1000 1000); // density of materials [kg/m3] + +// Contact force models +model +{ + contactForceModel nonLinearNonLimited; + rollingFrictionModel normal; + + // Material properties + Yeff (1.0e6 1.0e6 + 1.0e6); // Young modulus [Pa] + Geff (0.8e6 0.8e6 + 0.8e6); // Shear modulus [Pa] + nu (0.25 0.25 + 0.25); // Poisson's ratio [-] + en (0.97 0.85 + 0.97); // coefficient of normal restitution + mu (0.65 0.35 + 0.65); // dynamic friction + mur (0.1 0.1 + 0.1); // rolling friction +} +``` + +## Running the Simulation + +To run this simulation, execute the following commands in sequence: + +1. First, create the geometry: + + ``` + geometryPhasicFlow + ``` + +2. Next, initialize the particle system (note: starts with zero particles): + ``` + particlesPhasicFlow + ``` + +3. Finally, run the simulation: + + ``` + sphereGranFlow + ``` + +The simulation will automatically insert particles according to the defined schedule and begin rotating the V-blender at the specified time. + +## Visualizing Results + +After the simulation completes, you can convert the results to VTK format for visualization: + +``` +pFlowToVTK --binary +``` + +The VTK files will be stored in a new directory called `./VTK` and can be visualized using tools like ParaView or VisIt. + +## Expected Behavior + +During the simulation, you should observe: +1. Initial filling with small particles from the right side (0-1s) +2. A brief settling period (1-1.5s) +3. Filling with large particles from the left side (1.5-2.5s) +4. Another settling period (2.5-3s) +5. Rotation of the V-blender causing mixing of the two particle types (3-10s) diff --git a/tutorials/sphereGranFlow/V-blender/caseSetup/interaction b/tutorials/sphereGranFlow/V-blender/caseSetup/interaction index 0c2ef656..437e98bf 100644 --- a/tutorials/sphereGranFlow/V-blender/caseSetup/interaction +++ b/tutorials/sphereGranFlow/V-blender/caseSetup/interaction @@ -6,15 +6,16 @@ objectName interaction; objectType dicrionary; fileFormat ASCII; /*---------------------------------------------------------------------------*/ -materials (wallMat lightMat); // a list of materials names -densities (1000 1000); // density of materials [kg/m3] +materials (wallMat lightMat); // a list of materials names + +densities (1000 1000); // density of materials [kg/m3] contactListType sortedContactList; contactSearch { - method NBS; // method for broad search + method NBS; updateInterval 10; @@ -33,22 +34,22 @@ model Yeff (1.0e6 1.0e6 - 1.0e6); // Young modulus [Pa] + 1.0e6); // Young modulus [Pa] Geff (0.8e6 0.8e6 - 0.8e6); // Shear modulus [Pa] + 0.8e6); // Shear modulus [Pa] nu (0.25 0.25 - 0.25); // Poisson's ratio [-] + 0.25); // Poisson's ratio [-] en (0.97 0.85 - 0.97); // coefficient of normal restitution + 0.97); // coefficient of normal restitution mu (0.65 0.35 - 0.65); // dynamic friction + 0.65); // dynamic friction mur (0.1 0.1 - 0.1); // rolling friction + 0.1); // rolling friction } diff --git a/tutorials/sphereGranFlow/V-blender/caseSetup/particleInsertion b/tutorials/sphereGranFlow/V-blender/caseSetup/particleInsertion index 5d9a104e..320a29c8 100644 --- a/tutorials/sphereGranFlow/V-blender/caseSetup/particleInsertion +++ b/tutorials/sphereGranFlow/V-blender/caseSetup/particleInsertion @@ -6,9 +6,10 @@ objectName particleInsertion; objectType dicrionary; fileFormat ASCII; /*---------------------------------------------------------------------------*/ -active Yes; // is insertion active -> Yes or No -checkForCollision Yes; // is checked -> Yes or No + +active Yes; // is insertion active -> Yes or No + /* Two layers of particles are packed one-by-one using tho insertion steps @@ -18,15 +19,15 @@ rightregion { timeControl simulationTime; - regionType cylinder; // type of insertion region + regionType cylinder; // type of insertion region - rate 10000; // Particles Insertion Rate (particles/s) + rate 10000; // Particles Insertion Rate (particles/s) - startTime 0.0; // start time of small particles insertion (s) + startTime 0.0; // start time of small particles insertion (s) - endTime 1; // end time of small particles insertion (s) + endTime 1; // end time of small particles insertion (s) - insertionInterval 0.025; // time interval of small particles insertion (s) + insertionInterval 0.025; // time interval of small particles insertion (s) cylinderInfo { @@ -37,17 +38,17 @@ rightregion p2 (0.1150615 0.12 0.4811585); - radius 0.1; // radius of cylinder (m) + radius 0.1; // radius of cylinder (m) } setFields { - velocity realx3 (1.2 0.0 -1.2); // initial velocity of inserted particles + velocity realx3 (1.2 0.0 -1.2); // initial velocity of inserted particles } mixture { - smallSphere 1; // first layer of inserted particles + smallSphere 1; // first layer of inserted particles } } @@ -55,35 +56,34 @@ leftregion { timeControl simulationTime; - regionType cylinder; // type of insertion region + regionType cylinder; // type of insertion region - rate 10000; // Particles Insertion Rate (particles/s) + rate 10000; // Particles Insertion Rate (particles/s) - startTime 1.5; // start time of large particles insertion (s) + startTime 1.5; // start time of large particles insertion (s) - endTime 2.5; // end time of large particles insertion (s) + endTime 2.5; // end time of large particles insertion (s) - insertionInterval 0.025; // time interval of large particles insertion (s) + insertionInterval 0.025; // time interval of large particles insertion (s) cylinderInfo { /* coordinates of center of both ends of the insertion cylinder on the left side of the V-blender (m,m,m) */ - p1 ( 0.7562545 0.12 0.50079); p2 ( 0.7362545 0.12 0.48079); - radius 0.1; // radius of cylinder (m) + radius 0.1; } setFields { - velocity realx3 (-1.2 0.0 -1.2); // initial velocity of inserted particles + velocity realx3 (-1.2 0.0 -1.2); // initial velocity of inserted particles } mixture { - largeSphere 1; // second layer of inserted particles + largeSphere 1; // second layer of inserted particles } } diff --git a/tutorials/sphereGranFlow/V-blender/caseSetup/shapes b/tutorials/sphereGranFlow/V-blender/caseSetup/shapes index d7008679..820578c8 100644 --- a/tutorials/sphereGranFlow/V-blender/caseSetup/shapes +++ b/tutorials/sphereGranFlow/V-blender/caseSetup/shapes @@ -7,8 +7,8 @@ objectType sphereShape; fileFormat ASCII; /*---------------------------------------------------------------------------*/ -names (smallSphere largeSphere); // names of particles +names (smallSphere largeSphere); // names of particles -diameters (0.01 0.0101); // diameter of particles +diameters (0.01 0.0101); // diameter of particles -materials (lightMat lightMat); // material names for particles +materials (lightMat lightMat); // material names for particles diff --git a/tutorials/sphereGranFlow/V-blender/settings/domainDict b/tutorials/sphereGranFlow/V-blender/settings/domainDict index 68aa66b9..7ee51605 100755 --- a/tutorials/sphereGranFlow/V-blender/settings/domainDict +++ b/tutorials/sphereGranFlow/V-blender/settings/domainDict @@ -10,9 +10,9 @@ fileFormat ASCII; // Simulation domain: every particles that goes outside this domain will be deleted globalBox { - min (-0.1 -0.4 0); // lower corner point of the box + min (-0.1 -0.4 0); // lower corner point of the box - max (0.86 0.6 0.6); // upper corner point of the box + max (0.86 0.6 0.6); // upper corner point of the box } boundaries @@ -20,31 +20,31 @@ boundaries left { - type exit; // other options: periodic, reflective + type exit; // other options: periodic, reflective } right { - type exit; // other options: periodict, reflective + type exit; // other options: periodic, reflective } bottom { - type exit; // other options: periodict, reflective + type exit; // other options: periodic, reflective } top { - type exit; // other options: periodict, reflective + type exit; // other options: periodic, reflective } rear { - type exit; // other options: periodict, reflective + type exit; // other options: periodic, reflective } front { - type exit; // other options: periodict, reflective + type exit; // other options: periodic, reflective } } diff --git a/tutorials/sphereGranFlow/V-blender/settings/geometryDict b/tutorials/sphereGranFlow/V-blender/settings/geometryDict index 005cf07d..0c302482 100644 --- a/tutorials/sphereGranFlow/V-blender/settings/geometryDict +++ b/tutorials/sphereGranFlow/V-blender/settings/geometryDict @@ -6,6 +6,7 @@ objectName geometryDict; objectType dictionary; fileFormat ASCII; /*---------------------------------------------------------------------------*/ + motionModel rotatingAxis; // motion model: rotating object around an axis rotatingAxisInfo // information for rotatingAxis motion model diff --git a/tutorials/sphereGranFlow/V-blender/settings/particlesDict b/tutorials/sphereGranFlow/V-blender/settings/particlesDict index a61bf692..46c2288b 100644 --- a/tutorials/sphereGranFlow/V-blender/settings/particlesDict +++ b/tutorials/sphereGranFlow/V-blender/settings/particlesDict @@ -2,38 +2,38 @@ | phasicFlow File | | copyright: www.cemf.ir | \* ------------------------------------------------------------------------- */ -objectName particlesDict; -objectType dictionary; -fileFormat ASCII; +objectName particlesDict; +objectType dictionary; +fileFormat ASCII; /*---------------------------------------------------------------------------*/ setFields { /* - Default value for fields defined for particles - These fields should always be defined for simulations with - spherical particles. + Default value for fields defined for particles + These fields should always be defined for simulations with + spherical particles. */ defaultValue { - velocity realx3 (0 0 0); // linear velocity (m/s) + velocity realx3 (0 0 0); // linear velocity (m/s) - acceleration realx3 (0 0 0); // linear acceleration (m/s2) + acceleration realx3 (0 0 0); // linear acceleration (m/s2) - rVelocity realx3 (0 0 0); // rotational velocity (rad/s) + rVelocity realx3 (0 0 0); // rotational velocity (rad/s) - shapeName word smallSphere; // name of the particle shape + shapeName word smallSphere; // name of the particle shape } selectors - {} + {} } positionParticles { - - method empty; // no particle at the start of simulation + + method empty; // no particle at the start of simulation - mortonSorting Yes; // perform initial sorting based on morton code? + mortonSorting Yes; // perform initial sorting based on morton code? } diff --git a/tutorials/sphereGranFlow/V-blender/settings/settingsDict b/tutorials/sphereGranFlow/V-blender/settings/settingsDict index 05e34f47..dad5bcd6 100644 --- a/tutorials/sphereGranFlow/V-blender/settings/settingsDict +++ b/tutorials/sphereGranFlow/V-blender/settings/settingsDict @@ -2,23 +2,23 @@ | phasicFlow File | | copyright: www.cemf.ir | \* ------------------------------------------------------------------------- */ -objectName settingsDict; -objectType dictionary; +objectName settingsDict; +objectType dictionary; fileFormat ASCII; /*---------------------------------------------------------------------------*/ -run rotatingVblender; +run rotatingVblender; -dt 0.00001; // time step for integration (s) +dt 0.00001; // time step for integration (s) -startTime 0; // start time for simulation +startTime 0; // start time for simulation -endTime 10; // end time for simulation +endTime 10; // end time for simulation -saveInterval 0.05; // time interval for saving the simulation +saveInterval 0.05; // time interval for saving the simulation -timePrecision 6; // maximum number of digits for time folder +timePrecision 6; // maximum number of digits for time folder -g (0 0 -9.8); // gravity vector (m/s2) +g (0 0 -9.8); // gravity vector (m/s2) includeObjects (diameter); // save necessary (i.e., required) data on disk @@ -28,12 +28,12 @@ excludeObjects (); // include the objects to be saved in the time folders includeObject (); -integrationMethod AdamsBashforth2; // integration method +integrationMethod AdamsBashforth2; // integration method -integrationHistory off; // Do not save integration history on the disk +integrationHistory off; // Do not save integration history on the disk -writeFormat ascii; // data writting format (ascii or binary) +writeFormat ascii; // data writting format (ascii or binary) -timersReport Yes; // report timers (Yes or No) +timersReport Yes; // report timers (Yes or No) -timersReportInterval 0.05; // time interval for reporting timers +timersReportInterval 0.05; // time interval for reporting timers diff --git a/tutorials/sphereGranFlow/V-blender/v-blender.png b/tutorials/sphereGranFlow/V-blender/v-blender.png new file mode 100644 index 0000000000000000000000000000000000000000..1c99ebe79628b1299b60a8088d810552be0da9b3 GIT binary patch literal 161900 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 none } - } diff --git a/tutorials/sphereGranFlow/screwConveyor/settings/particlesDict b/tutorials/sphereGranFlow/screwConveyor/settings/particlesDict index 4b419d77..79e3655a 100644 --- a/tutorials/sphereGranFlow/screwConveyor/settings/particlesDict +++ b/tutorials/sphereGranFlow/screwConveyor/settings/particlesDict @@ -13,8 +13,6 @@ positionParticles { // A list of options are: ordered, random method empty; // creates the required fields with zero particles (empty). - - mortonSorting Yes; // perform initial sorting based on morton } setFields diff --git a/tutorials/sphereGranFlow/screwConveyor/settings/settingsDict b/tutorials/sphereGranFlow/screwConveyor/settings/settingsDict index 12c55d37..8e7bcfbe 100644 --- a/tutorials/sphereGranFlow/screwConveyor/settings/settingsDict +++ b/tutorials/sphereGranFlow/screwConveyor/settings/settingsDict @@ -2,41 +2,39 @@ | phasicFlow File | | copyright: www.cemf.ir | \* ------------------------------------------------------------------------- */ -objectName settingsDict; -objectType dictionary; -fileFormat ASCII; +objectName settingsDict; +objectType dictionary; +fileFormat ASCII; /*---------------------------------------------------------------------------*/ -run screwConveyor; +run screwConveyor; -dt 0.00002; // time step for integration (s) +dt 0.00002; // time step for integration (s) -startTime 0; // start time for simulation +startTime 0; // start time for simulation -endTime 20; // end time for simulation +endTime 20; // end time for simulation -saveInterval 0.025; // time interval for saving the simulation +saveInterval 0.025; // time interval for saving the simulation -timePrecision 4; // maximum number of digits for time folder +timePrecision 4; // maximum number of digits for time folder -g (0 -9.8 0); // gravity vector (m/s2) +g (0 -9.8 0); // gravity vector (m/s2) -writeFormat binary; // field files will be saved in binary format +writeFormat binary; // field files will be saved in binary format // A list of options: AB2, AB3, AB4, AB5 -integrationMethod AdamsBashforth4; // integration method +integrationMethod AdamsBashforth4; // integration method + +integrationHistory off; // overrides the default behavior includeObjects (diameter); - - // exclude unnecessary data from saving on disk -excludeObjects (rVelocity.dy1 rVelocity.dy2 rVelocity.dy3 - pStructPosition.dy1 pStructPosition.dy2 pStructPosition.dy3 - pStructVelocity.dy1 pStructVelocity.dy2 pStructVelocity.dy3); - +excludeObjects (); + -timersReport Yes; // report timers? +timersReport Yes; // report timers? -timersReportInterval 0.1; // time interval for reporting timers +timersReportInterval 0.1; // time interval for reporting timers diff --git a/tutorials/sphereGranFlow/toteBlender/ReadMe.md b/tutorials/sphereGranFlow/toteBlender/ReadMe.md index de1a367c..dd6e0322 100644 --- a/tutorials/sphereGranFlow/toteBlender/ReadMe.md +++ b/tutorials/sphereGranFlow/toteBlender/ReadMe.md @@ -244,7 +244,7 @@ positionParticles positionOrderedInfo { // minimum space between centers of particles - diameter 0.005; + distance 0.005; // number of particles in the simulation numPoints 24000; diff --git a/tutorials/sphereGranFlow/toteBlender/settings/settingsDict b/tutorials/sphereGranFlow/toteBlender/settings/settingsDict index 46a7218b..a0015cee 100644 --- a/tutorials/sphereGranFlow/toteBlender/settings/settingsDict +++ b/tutorials/sphereGranFlow/toteBlender/settings/settingsDict @@ -24,10 +24,12 @@ g (0 0 -9.8); // gravity vector (m/s2) // include/exclude fields for saving on disk includeObjects (diameter); -excludeObjects (rVelocity.dy1 pStructPosition.dy1 pStructVelocity.dy1); +excludeObjects (); integrationMethod AdamsBashforth2; +integrationHistory off; + writeFormat ascii; timersReport Yes; From 953059cec524bb5469b066a56257a8b1442761ff Mon Sep 17 00:00:00 2001 From: Hamidreza Date: Fri, 25 Apr 2025 16:37:24 +0330 Subject: [PATCH 15/15] tutorials readme.md --- tutorials/README.md | 40 ++++++++++++++++++++ tutorials/sphereGranFlow/V-blender/README.md | 3 +- 2 files changed, 42 insertions(+), 1 deletion(-) create mode 100644 tutorials/README.md diff --git a/tutorials/README.md b/tutorials/README.md new file mode 100644 index 00000000..7a603ef9 --- /dev/null +++ b/tutorials/README.md @@ -0,0 +1,40 @@ +# phasicFlow Tutorials + +This directory contains various tutorial examples to help you learn how to use phasicFlow for different particle simulation scenarios. Each tutorial provides a complete working example with configuration files and instructions. + + +## 1. Sphere DEM Simulations (`sphereGranFlow`) + +The most comprehensive collection of tutorials using spherical particles for DEM simulations: + +- [Rotating Drum (Small)](./sphereGranFlow/rotatingDrumSmall/) - Simple rotating drum simulation with 30,000 spherical particles (4 mm diameter) +- [Rotating Drum (Medium)](./sphereGranFlow/rotatingDrumMedium/) - Medium-sized rotating drum simulation +- [Rotating Drum with Baffles](./sphereGranFlow/RotatingDrumWithBaffles/) - Rotating drum with internal baffles and binary particle mixture +- [Rotating Drum with Periodic Boundaries](./sphereGranFlow/drum-PeriodicBoundary/) - Simulates an "infinite length" drum using periodic boundaries +- [V-blender](./sphereGranFlow/V-blender/) - V-shaped blender simulation for particle mixing +- [Tote Blender](./sphereGranFlow/toteBlender/) - Double pedestal tote blender simulation with 24,000 particles +- [Binary System of Particles](./sphereGranFlow/binarySystemOfParticles/) - Demonstrates particle segregation in a rotating drum with two particle sizes +- [Screw Conveyor](./sphereGranFlow/screwConveyor/) - Simulates particle transport using a screw conveyor +- [Conveyor Belt](./sphereGranFlow/conveyorBelt/) - Simulates particles on a moving conveyor belt +- [Rotary Air Lock Valve](./sphereGranFlow/RotaryAirLockValve/) - Simulates a rotary air lock valve with particle insertion +- [Layered Silo Filling](./sphereGranFlow/layeredSiloFilling/) - Demonstrates filling a silo with layers of particles +- [Homogenization Silo (Periodic Boundaries)](./sphereGranFlow/homogenizationSilo-PeriodicBoundary/) - Simulates homogenization in a silo with periodic boundaries + +## 2. Course-grained (Grain) DEM Simulations (`grainGranFlow`) + +Tutorials for simulations with non-spherical (grain-shaped) particles: + +- [Rotating Drum](./grainGranFlow/rotatingDrum/) - Demonstrates non-spherical grain particles in a rotating drum + +## 3. Geometry Iteration (`iterateGeometry`) + +Tutorials focused on geometry handling and visualization: + +- [Inclined Screw Conveyor](./iterateGeometry/inclinedScrewConveyor/) - Visualizes the geometry of an inclined screw conveyor without particles + +## 4. Post-processing (`postprocessPhasicFlow`) + +Tutorials focused on post-processing and analysis: + +- [Segregation Analysis](./postprocessPhasicFlow/segregation/) - Demonstrates how to analyze particle segregation in simulation results + diff --git a/tutorials/sphereGranFlow/V-blender/README.md b/tutorials/sphereGranFlow/V-blender/README.md index 323e659b..f9c02f08 100644 --- a/tutorials/sphereGranFlow/V-blender/README.md +++ b/tutorials/sphereGranFlow/V-blender/README.md @@ -5,7 +5,8 @@ This tutorial demonstrates the simulation of a V-blender, a common mixing device
- +
+
V-blender simulation with two layers of particles