https://mooseframework.inl.gov
SubChannel1PhaseProblem.h
Go to the documentation of this file.
1 //* This file is part of the MOOSE framework
2 //* https://mooseframework.inl.gov
3 //*
4 //* All rights reserved, see COPYRIGHT for full restrictions
5 //* https://github.com/idaholab/moose/blob/master/COPYRIGHT
6 //*
7 //* Licensed under LGPL 2.1, please see LICENSE for details
8 //* https://www.gnu.org/licenses/lgpl-2.1.html
9 
10 #pragma once
11 #include "ExternalProblem.h"
12 #include "PostprocessorInterface.h"
13 #include "SubChannelApp.h"
14 #include "QuadSubChannelMesh.h"
15 #include "SolutionHandle.h"
17 #include <petscdm.h>
18 #include <petscdmda.h>
19 #include <petscksp.h>
20 #include <petscsys.h>
21 #include <petscvec.h>
22 #include <petscsnes.h>
23 
28 {
29 public:
31  virtual ~SubChannel1PhaseProblem();
32 
33  virtual void externalSolve() override;
34  virtual void syncSolutions(Direction direction) override;
35  virtual bool solverSystemConverged(const unsigned int) override;
36  virtual void initialSetup() override;
37 
39  virtual Real computeAddedHeatPin(unsigned int i_ch, unsigned int iz) = 0;
41  Real computeAddedHeatDuct(unsigned int i_ch, unsigned int iz);
42 
43 protected:
45  {
46  int i_ch;
49 
51  virtual Real computeFrictionFactor(FrictionStruct friction_args) = 0;
53  void computeWijFromSolve(int iblock);
55  void computeSumWij(int iblock);
57  void computeMdot(int iblock);
59  void computeWijPrime(int iblock);
61  virtual Real computeBeta(unsigned int i_gap, unsigned int iz, bool enthalpy) = 0;
63  void computeDP(int iblock);
65  void computeP(int iblock);
67  virtual void computeh(int iblock) = 0;
69  void computeT(int iblock);
71  void computeRho(int iblock);
73  void computeMu(int iblock);
75  void computeWijResidual(int iblock);
77  virtual Real getSubChannelPeripheralDuctWidth(unsigned int i_ch) = 0;
81  PetscErrorCode petscSnesSolver(int iblock,
82  const libMesh::DenseVector<Real> & solution,
85  friend PetscErrorCode formFunction(SNES snes, Vec x, Vec f, void * ctx);
86 
88  PetscErrorCode implicitPetscSolve(int iblock);
89 
91  virtual void initializeSolution() = 0;
92 
94  PetscScalar computeInterpolationCoefficients(PetscScalar Peclet = 0.0);
95  PetscScalar
96  computeInterpolatedValue(PetscScalar topValue, PetscScalar botValue, PetscScalar Peclet = 0.0);
97 
99  Real computeGravityDir(const MooseEnum & dir) const
100  {
101  switch (dir)
102  {
103  case 0: // counter_flow
104  return 1.0;
105  case 1: // co_flow
106  return -1.0;
107  case 2: // none
108  return 0.0;
109  default:
110  mooseError(name(), ": Invalid gravity direction: expected counter_flow, co_flow, or none");
111  }
112  }
113 
114  PetscErrorCode cleanUp();
117  unsigned int _n_blocks;
122  const Real _g_grav;
123  const Real & _kij;
124  unsigned int _n_cells;
125  unsigned int _n_gaps;
126  unsigned int _n_pins;
127  unsigned int _n_channels;
128  unsigned int _block_size;
130  std::vector<Real> _z_grid;
135  const bool _compute_density;
137  const bool _compute_viscosity;
139  const bool _compute_power;
141  const bool _pin_mesh_exist;
143  const bool _duct_mesh_exist;
151  const Real & _CT;
153  const Real & _P_tol;
155  const Real & _T_tol;
157  const int & _T_maxit;
159  const PetscReal & _rtol;
161  const PetscReal & _atol;
163  const PetscReal & _dtol;
165  const PetscInt & _maxit;
172  const bool _implicit_bool;
176  const bool _segregated_bool;
182  const bool _deformation;
183 
186  std::unique_ptr<SolutionHandle> _mdot_soln;
187  std::unique_ptr<SolutionHandle> _SumWij_soln;
188  std::unique_ptr<SolutionHandle> _P_soln;
189  std::unique_ptr<SolutionHandle> _DP_soln;
190  std::unique_ptr<SolutionHandle> _h_soln;
191  std::unique_ptr<SolutionHandle> _T_soln;
192  std::unique_ptr<SolutionHandle> _Tpin_soln;
193  std::unique_ptr<SolutionHandle> _Dpin_soln;
194  std::unique_ptr<SolutionHandle> _rho_soln;
195  std::unique_ptr<SolutionHandle> _mu_soln;
196  std::unique_ptr<SolutionHandle> _S_flow_soln;
197  std::unique_ptr<SolutionHandle> _w_perim_soln;
198  std::unique_ptr<SolutionHandle> _q_prime_soln;
199  std::unique_ptr<SolutionHandle> _duct_heat_flux_soln; // Only used for ducted assemblies
200  std::unique_ptr<SolutionHandle> _Tduct_soln; // Only used for ducted assemblies
201  std::unique_ptr<SolutionHandle> _displacement_soln;
202 
204  inline PetscErrorCode createPetscVector(Vec & v, PetscInt n)
205  {
207  LibmeshPetscCall(VecCreate(PETSC_COMM_WORLD, &v));
208  LibmeshPetscCall(PetscObjectSetName((PetscObject)v, "Solution"));
209  LibmeshPetscCall(VecSetSizes(v, PETSC_DECIDE, n));
210  LibmeshPetscCall(VecSetFromOptions(v));
211  LibmeshPetscCall(VecZeroEntries(v));
212  PetscFunctionReturn(LIBMESH_PETSC_SUCCESS);
213  }
214 
215  inline PetscErrorCode createPetscMatrix(Mat & M, PetscInt n, PetscInt m)
216  {
218  LibmeshPetscCall(MatCreate(PETSC_COMM_WORLD, &M));
219  LibmeshPetscCall(MatSetSizes(M, PETSC_DECIDE, PETSC_DECIDE, n, m));
220  LibmeshPetscCall(MatSetFromOptions(M));
221  LibmeshPetscCall(MatSetUp(M));
222  PetscFunctionReturn(LIBMESH_PETSC_SUCCESS);
223  }
224 
225  template <class T>
226  PetscErrorCode populateVectorFromDense(Vec & x,
227  const T & solution,
228  const unsigned int first_axial_level,
229  const unsigned int last_axial_level,
230  const unsigned int cross_dimension);
231  template <class T>
232  PetscErrorCode populateDenseFromVector(const Vec & x,
233  T & solution,
234  const unsigned int first_axial_level,
235  const unsigned int last_axial_level,
236  const unsigned int cross_dimension);
237  template <class T>
238  PetscErrorCode populateVectorFromHandle(Vec & x,
239  const T & solution,
240  const unsigned int first_axial_level,
241  const unsigned int last_axial_level,
242  const unsigned int cross_dimension);
243  template <class T>
244  PetscErrorCode populateSolutionChan(const Vec & x,
245  T & solution,
246  const unsigned int first_axial_level,
247  const unsigned int last_axial_level,
248  const unsigned int cross_dimension);
249 
254  Vec _Wij_vec;
255  Vec _prod;
256  Vec _prodp;
262 
288 
305 
321 
323  PetscScalar _added_K = 0.0;
324  PetscScalar _added_K_old = 1000.0;
325  PetscScalar _max_sumWij;
326  PetscScalar _max_sumWij_new;
327  PetscScalar _correction_factor = 1.0;
328 
329 public:
330  static InputParameters validParams();
331 };
332 
333 template <class T>
334 PetscErrorCode
336  T & loc_solution,
337  const unsigned int first_axial_level,
338  const unsigned int last_axial_level,
339  const unsigned int cross_dimension)
340 {
341  PetscScalar * xx;
342 
344  LibmeshPetscCall(VecGetArray(x, &xx));
345  for (unsigned int iz = first_axial_level; iz < last_axial_level + 1; iz++)
346  {
347  unsigned int iz_ind = iz - first_axial_level;
348  for (unsigned int i_l = 0; i_l < cross_dimension; i_l++)
349  {
350  loc_solution(i_l, iz) = xx[iz_ind * cross_dimension + i_l];
351  }
352  }
353  LibmeshPetscCall(VecRestoreArray(x, &xx));
354 
355  PetscFunctionReturn(LIBMESH_PETSC_SUCCESS);
356 }
357 
358 template <class T>
359 PetscErrorCode
361  const T & loc_solution,
362  const unsigned int first_axial_level,
363  const unsigned int last_axial_level,
364  const unsigned int cross_dimension)
365 {
366  PetscScalar * xx;
367 
369  LibmeshPetscCall(VecGetArray(x, &xx));
370  for (unsigned int iz = first_axial_level; iz < last_axial_level + 1; iz++)
371  {
372  unsigned int iz_ind = iz - first_axial_level;
373  for (unsigned int i_l = 0; i_l < cross_dimension; i_l++)
374  {
375  auto * loc_node = _subchannel_mesh.getChannelNode(i_l, iz);
376  xx[iz_ind * cross_dimension + i_l] = loc_solution(loc_node);
377  }
378  }
379  LibmeshPetscCall(VecRestoreArray(x, &xx));
380 
381  PetscFunctionReturn(LIBMESH_PETSC_SUCCESS);
382 }
383 
384 template <class T>
385 PetscErrorCode
387  const T & loc_solution,
388  const unsigned int first_axial_level,
389  const unsigned int last_axial_level,
390  const unsigned int cross_dimension)
391 {
392  PetscScalar * xx;
394  LibmeshPetscCall(VecGetArray(x, &xx));
395  for (unsigned int iz = first_axial_level; iz < last_axial_level + 1; iz++)
396  {
397  unsigned int iz_ind = iz - first_axial_level;
398  for (unsigned int i_l = 0; i_l < cross_dimension; i_l++)
399  {
400  xx[iz_ind * cross_dimension + i_l] = loc_solution(i_l, iz);
401  }
402  }
403  LibmeshPetscCall(VecRestoreArray(x, &xx));
404  PetscFunctionReturn(LIBMESH_PETSC_SUCCESS);
405 }
406 
407 template <class T>
408 PetscErrorCode
410  T & loc_solution,
411  const unsigned int first_axial_level,
412  const unsigned int last_axial_level,
413  const unsigned int cross_dimension)
414 {
415  PetscScalar * xx;
417  LibmeshPetscCall(VecGetArray(x, &xx));
418  Node * loc_node;
419  for (unsigned int iz = first_axial_level; iz < last_axial_level + 1; iz++)
420  {
421  unsigned int iz_ind = iz - first_axial_level;
422  for (unsigned int i_l = 0; i_l < cross_dimension; i_l++)
423  {
424  loc_node = _subchannel_mesh.getChannelNode(i_l, iz);
425  loc_solution.set(loc_node, xx[iz_ind * cross_dimension + i_l]);
426  }
427  }
428  PetscFunctionReturn(LIBMESH_PETSC_SUCCESS);
429 }
Mat _amc_sys_mdot_mat
Axial momentum system matrix.
const bool _pin_mesh_exist
Flag that informs if there is a pin mesh or not.
void computeRho(int iblock)
Computes Density per channel for block iblock.
Vec _amc_gravity_rhs
Axial momentum conservation - buoyancy force No implicit matrix.
std::unique_ptr< SolutionHandle > _Tduct_soln
std::unique_ptr< SolutionHandle > _duct_heat_flux_soln
void computeSumWij(int iblock)
Computes net diversion crossflow per channel for block iblock.
unsigned int _n_blocks
number of axial blocks
const bool _compute_power
Flag that informs if we need to solve the Enthalpy/Temperature equations or not.
std::unique_ptr< SolutionHandle > _T_soln
std::unique_ptr< SolutionHandle > _h_soln
const PetscReal & _dtol
The divergence tolerance for the ksp linear solver.
const bool _monolithic_thermal_bool
Thermal monolithic bool.
const MooseEnum _gravity_direction
The direction of gravity.
Mat _cmc_friction_force_mat
Cross momentum conservation - friction force.
void computeP(int iblock)
Computes Pressure per channel for block iblock.
Real _TR
Flag that activates or deactivates the transient parts of the equations we solve by multiplication...
libMesh::DenseMatrix< Real > _Wij_old
const PostprocessorValue & _P_out
Outlet Pressure.
void computeT(int iblock)
Computes Temperature per channel for block iblock.
void computeMdot(int iblock)
Computes mass flow per channel for block iblock.
std::unique_ptr< SolutionHandle > _S_flow_soln
const bool _compute_density
Flag that activates or deactivates the calculation of density.
PetscErrorCode populateSolutionChan(const Vec &x, T &solution, const unsigned int first_axial_level, const unsigned int last_axial_level, const unsigned int cross_dimension)
Mat _amc_friction_force_mat
Axial momentum conservation - friction force.
PetscScalar _added_K
Added resistances for monolithic convergence.
PetscErrorCode createPetscVector(Vec &v, PetscInt n)
Petsc Functions.
PetscFunctionBegin
const bool _duct_mesh_exist
Flag that informs if there is a pin mesh or not.
static InputParameters validParams()
virtual Real computeAddedHeatPin(unsigned int i_ch, unsigned int iz)=0
Function that computes the added heat coming from the fuel pins, for channel i_ch and cell iz...
const Real & _T_tol
Convergence tolerance for the temperature loop in external solve.
void computeMu(int iblock)
Computes Viscosity per channel for block iblock.
PetscScalar computeInterpolatedValue(PetscScalar topValue, PetscScalar botValue, PetscScalar Peclet=0.0)
const bool _segregated_bool
Segregated solve.
Mat _cmc_sys_Wij_mat
Lateral momentum system matrix.
bool _converged
Variable that informs whether we exited external solve with a converged solution or not...
const bool _staggered_pressure_bool
Flag to define the usage of staggered or collocated pressure.
virtual void initializeSolution()=0
Function to initialize the solution & geometry fields.
Real computeAddedHeatDuct(unsigned int i_ch, unsigned int iz)
Function that computes the heat added by the duct, for channel i_ch and cell iz.
Mat _mc_sumWij_mat
Matrices and vectors to be used in implicit assembly Mass conservation Mass conservation - sum of cro...
PetscErrorCode populateVectorFromDense(Vec &x, const T &solution, const unsigned int first_axial_level, const unsigned int last_axial_level, const unsigned int cross_dimension)
const Real & _CT
Turbulent modeling parameter used in axial momentum equation.
virtual Node * getChannelNode(unsigned int i_chan, unsigned iz) const =0
Get the subchannel mesh node for a given channel index and elevation index.
virtual void computeh(int iblock)=0
Computes Enthalpy per channel for block iblock.
std::unique_ptr< SolutionHandle > _rho_soln
Mat _amc_turbulent_cross_flows_mat
Mass conservation - density time derivative No implicit matrix.
PetscErrorCode populateVectorFromHandle(Vec &x, const T &solution, const unsigned int first_axial_level, const unsigned int last_axial_level, const unsigned int cross_dimension)
Mat _amc_advective_derivative_mat
Axial momentum conservation - advective (Eulerian) derivative.
Vec _hc_added_heat_rhs
Enthalpy conservation - source and sink.
std::vector< Real > _z_grid
axial location of nodes
const std::string & name() const
const int & _T_maxit
Maximum iterations for the inner temperature loop.
Mat _amc_pressure_force_mat
Axial momentum conservation - pressure force.
void computeWijResidual(int iblock)
Computes Residual Matrix based on the lateral momentum conservation equation for block iblock...
const std::vector< double > x
Real f(Real x)
Test function for Brents method.
std::unique_ptr< SolutionHandle > _q_prime_soln
virtual void syncSolutions(Direction direction) override
const PetscReal & _atol
The absolute convergence tolerance for the ksp linear solver.
Real computeGravityDir(const MooseEnum &dir) const
inline function that is used to define the gravity direction
PetscScalar computeInterpolationCoefficients(PetscScalar Peclet=0.0)
Functions that computes the interpolation scheme given the Peclet number.
Real root(std::function< Real(Real)> const &f, Real x1, Real x2, Real tol=1.0e-12)
Finds the root of a function using Brent&#39;s method.
Definition: BrentsMethod.C:66
Mat _hc_cross_derivative_mat
Enthalpy conservation - cross flux derivative.
Mat _mc_axial_convection_mat
Mass conservation - axial convection.
Common class for single phase fluid properties.
auto Peclet(const T1 &volume_fraction, const T2 &cp, const T3 &rho, const T4 &vel, const T5 &D_h, const T6 &k)
Compute Peclet number.
Definition: Numerics.h:153
virtual Real computeFrictionFactor(FrictionStruct friction_args)=0
Returns friction factor.
const PetscInt & _maxit
The maximum number of iterations to use for the ksp linear solver.
PetscErrorCode createPetscMatrix(Mat &M, PetscInt n, PetscInt m)
friend PetscErrorCode formFunction(SNES snes, Vec x, Vec f, void *ctx)
This is the residual Vector function in a form compatible with the SNES PETC solvers.
const MooseEnum _interpolation_scheme
The interpolation method used in constructing the systems.
std::unique_ptr< SolutionHandle > _Dpin_soln
virtual Real getSubChannelPeripheralDuctWidth(unsigned int i_ch)=0
Function that computes the width of the duct cell that the peripheral subchannel i_ch sees...
Base class for the 1-phase steady-state/transient subchannel solver.
libMesh::DenseMatrix< Real > _Wij_residual_matrix
std::unique_ptr< SolutionHandle > _mdot_soln
PetscErrorCode populateDenseFromVector(const Vec &x, T &solution, const unsigned int first_axial_level, const unsigned int last_axial_level, const unsigned int cross_dimension)
const PetscReal & _rtol
The relative convergence tolerance, (relative decrease) for the ksp linear solver.
DIE A HORRIBLE DEATH HERE typedef LIBMESH_DEFAULT_SCALAR_TYPE Real
std::unique_ptr< SolutionHandle > _displacement_soln
static const std::string v
Definition: NS.h:84
std::unique_ptr< SolutionHandle > _DP_soln
const bool _compute_viscosity
Flag that activates or deactivates the calculation of viscosity.
libMesh::DenseMatrix< Real > & _Wij
virtual void externalSolve() override
void computeWijPrime(int iblock)
Computes turbulent crossflow per gap for block iblock.
std::unique_ptr< SolutionHandle > _SumWij_soln
PetscErrorCode petscSnesSolver(int iblock, const libMesh::DenseVector< Real > &solution, libMesh::DenseVector< Real > &root)
Computes solution of nonlinear equation using snes and provided a residual in a formFunction.
Scalar< const PostprocessorValue > PostprocessorValue
libMesh::DenseVector< Real > residualFunction(int iblock, libMesh::DenseVector< Real > solution)
Computes Residual Vector based on the lateral momentum conservation equation for block iblock & updat...
const bool _verbose_subchannel
Boolean to printout information related to subchannel solve.
Mat _amc_cross_derivative_mat
Axial momentum conservation - cross flux derivative.
void mooseError(Args &&... args) const
const Real & _P_tol
Convergence tolerance for the pressure loop in external solve.
virtual Real computeBeta(unsigned int i_gap, unsigned int iz, bool enthalpy)=0
Computes turbulent mixing coefficient.
virtual bool solverSystemConverged(const unsigned int) override
struct SubChannel1PhaseProblem::FrictionStruct _friction_args
Mat _hc_advective_derivative_mat
Enthalpy conservation - advective (Eulerian) derivative;.
Base class for subchannel meshes.
void computeWijFromSolve(int iblock)
Computes diversion crossflow per gap for block iblock.
const bool _implicit_bool
Flag to define the usage of a implicit or explicit solution.
Mat _amc_time_derivative_mat
Axial momentum conservation - time derivative.
Mat _hc_time_derivative_mat
Enthalpy Enthalpy conservation - time derivative.
PetscErrorCode implicitPetscSolve(int iblock)
Computes implicit solve using PetSc.
const bool _deformation
Flag that activates the effect of deformation (pin/duct) based on the auxvalues for displacement...
void computeDP(int iblock)
Computes Pressure Drop per channel for block iblock.
SubChannel1PhaseProblem(const InputParameters &params)
Mat _cmc_time_derivative_mat
Cross momentum Cross momentum conservation - time derivative.
libMesh::DenseMatrix< Real > _WijPrime
virtual void initialSetup() override
PetscFunctionReturn(LIBMESH_PETSC_SUCCESS)
Mat _cmc_pressure_force_mat
Cross momentum conservation - pressure force.
std::unique_ptr< SolutionHandle > _P_soln
std::unique_ptr< SolutionHandle > _w_perim_soln
Mat _cmc_advective_derivative_mat
Cross momentum conservation - advective (Eulerian) derivative.
const SinglePhaseFluidProperties * _fp
Solutions handles and link to TH tables properties.
Mat _hc_sys_h_mat
System matrices.
std::unique_ptr< SolutionHandle > _mu_soln
std::unique_ptr< SolutionHandle > _Tpin_soln