/*------------------------------- 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 __insertionRegion_hpp__ #define __insertionRegion_hpp__ #include "anyList.hpp" #include "baseTimeControl.hpp" #include "peakableRegion.hpp" #include "shapeMixture.hpp" namespace pFlow { class dictionary; class insertion; class pointStructure; /** * This class defines all the necessary enteties for defining an insertion * region. * * Insertion region information are supplied through a dictionary in a file. * For example: \verbatim { type cylinderRegion; // type of insertion region rate 15000; // insertion rate (particles/s) startTime 0; // (s) endTime 0.5; // (s) interval 0.025; // (s) cylinderRegionInfo { radius 0.09; // radius of cylinder (m) p1 (0.0 0.0 0.10); // (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 } } \endverbatim * * More information on the above dictionary entries can be found in * the table below. * * * | Parameter | Type | Description | Optional [default value] | * |----| :---: | ---- | ---- | * | type | word | type of the insertion region with name ### | No | * | rate | real | rate of insertion (particle/s) | No | * | startTime | real | start of insertion (s) | No | * | endTime | real | end of insertion (s) | No | * | interval | real | time interval between successive insertions (s) | No | * | ###Info | dictionary | data for insertion region | No | * | setFields | dictionary | set field for inserted particles (s) | Yes [empty dictionray] | * | mixture | dictionary | mixture of particles to be inserted (s) | No | * */ class insertionRegion { private: /// name of this region const word name_; /// insertion region dictionary const dictionary& dict_; /// ref to insertion const insertion& insertion_; /// @brief time control for insertion events baseTimeControl tControl_; /// rate of insertion real rate_; /// number of inserted particles uint32 numInserted_ = 0; /// type of insertion region word type_; /// peakable region of points uniquePtr pRegion_ = nullptr; /// mixture of shapes uniquePtr mixture_ = nullptr; /// @brief dictionary for set field uniquePtr setFieldDict_ = nullptr; /// list of (filedName type value) for the fields anyList setFieldList_; private: // - private methods /// read from dictionary bool readInsertionRegion(const dictionary& dict); /// write to dictionary bool writeInsertionRegion(dictionary& dict) const; bool readSetFieldDict(); public: /// Type info TypeInfoNV("insertionRegion"); // - Constructors /// Construct from a dictionary insertionRegion(const word& name, const insertion& instn); /// Destructor ~insertionRegion() = default; // - Methods /// Const ref to name of the region const auto& name() const { return name_; } /// return type of insertion region const auto& type() const { return type_; } const auto& dict()const { return dict_; } const auto& Insertion() const { return insertion_; } const pointStructure& pStruct()const; inline bool insertionTime(uint32 iter, real t, real dt) const { return tControl_.eventTime(iter, t, dt); } uint32 numberToBeInserted(uint32 iter, real t, real dt); inline uint32 addToNumInserted(uint32 newInserted) { return numInserted_ += newInserted; } inline uint32 totalInserted() const { return numInserted_; } auto& mixture() { return mixture_(); } auto& pRegion() { return pRegion_(); } const auto& setFieldList() const { return setFieldList_; } // - IO operation /// read from dictionary /*bool read(const dictionary& dict) { if (!timeFlowControl::read(dict)) return false; return readInsertionRegion(dict); }*/ /// write to dictionary bool write(dictionary& dict) const { return writeInsertionRegion(dict); } }; } // pFlow #endif //__insertionRegion_hpp__