Lethe Open-Source Library version 1.2.0
Developer Guide
Loading...
Searching...
No Matches
grids.cc File Reference
#include <core/grid_birmingham_fluidized_bed.h>
#include <core/grid_cube_merged.h>
#include <core/grid_cylinder.h>
#include <core/grid_fichera_oven.h>
#include <core/grid_impinging_jet_mixer.h>
#include <core/grid_periodic_hills.h>
#include <core/grid_pipe_and_waveguide.h>
#include <core/grid_uniform_channel_with_meshed_cylinder.h>
#include <core/grid_uniform_channel_with_meshed_square_prism.h>
#include <core/grids.h>
#include <core/utilities.h>
#include <deal.II/base/conditional_ostream.h>
#include <deal.II/base/mpi.h>
#include <deal.II/base/types.h>
#include <deal.II/grid/grid_generator.h>
#include <deal.II/grid/grid_in.h>
#include <deal.II/grid/grid_tools.h>
#include <deal.II/grid/tria.h>
#include <algorithm>
#include <fstream>
#include <iostream>
#include <numbers>
#include <string>
Include dependency graph for grids.cc:

Go to the source code of this file.

Functions

template<int dim, int spacedim>
static void warn_if_scaling_curved_manifolds (const Parameters::Mesh< dim, spacedim > &mesh_parameters, const Triangulation< dim, spacedim > &triangulation)
template<int dim, int spacedim>
void attach_grid_to_triangulation (Triangulation< dim, spacedim > &triangulation, const Parameters::Mesh< dim, spacedim > &mesh_parameters)
template<int dim, int spacedim>
void setup_periodic_boundary_conditions (parallel::DistributedTriangulationBase< dim, spacedim > &triangulation, const Parameters::PeriodicBoundaries &periodic_boundaries)
template<int dim, int spacedim>
static void apply_initial_refinement (const Parameters::Mesh< dim, spacedim > &mesh_parameters, const bool restart, parallel::DistributedTriangulationBase< dim, spacedim > &triangulation)
template<int dim, int spacedim>
void read_mesh_and_manifolds (parallel::DistributedTriangulationBase< dim, spacedim > &triangulation, const Parameters::Mesh< dim, spacedim > &mesh_parameters, const Parameters::Manifolds &manifolds_parameters, const bool restart, const Parameters::PeriodicBoundaries &periodic_boundaries)
template<int dim, int spacedim>
void read_mesh_and_manifolds_for_stator_and_rotor (parallel::DistributedTriangulationBase< dim, spacedim > &triangulation, const Parameters::Mesh< dim, spacedim > &mesh_parameters, const Parameters::Manifolds &manifolds_parameters, const bool restart, const Parameters::PeriodicBoundaries &periodic_boundaries, const Parameters::Mortar< dim > &mortar_parameters)
template<int dim, int spacedim>
void build_refinement_box_triangulation (const Parameters::Mesh< dim, spacedim > &box_mesh_parameters, Triangulation< dim, spacedim > &box_triangulation)
template<int dim, int spacedim>
void apply_mesh_transformation (const Parameters::Mesh< dim, spacedim > &mesh_parameters, Triangulation< dim, spacedim > &triangulation)
template void attach_grid_to_triangulation (Triangulation< 2 > &triangulation, const Parameters::Mesh< 2 > &mesh_parameters)
template void attach_grid_to_triangulation (Triangulation< 3 > &triangulation, const Parameters::Mesh< 3 > &mesh_parameters)
template void attach_grid_to_triangulation (Triangulation< 2, 3 > &triangulation, const Parameters::Mesh< 2, 3 > &mesh_parameters)
template void setup_periodic_boundary_conditions (parallel::DistributedTriangulationBase< 2, 2 > &triangulation, const Parameters::PeriodicBoundaries &periodic_boundaries)
template void setup_periodic_boundary_conditions (parallel::DistributedTriangulationBase< 2, 3 > &triangulation, const Parameters::PeriodicBoundaries &periodic_boundaries)
template void setup_periodic_boundary_conditions (parallel::DistributedTriangulationBase< 3, 3 > &triangulation, const Parameters::PeriodicBoundaries &periodic_boundaries)
template void read_mesh_and_manifolds (parallel::DistributedTriangulationBase< 2 > &triangulation, const Parameters::Mesh< 2 > &mesh_parameters, const Parameters::Manifolds &manifolds_parameters, const bool restart, const Parameters::PeriodicBoundaries &periodic_boundaries)
template void read_mesh_and_manifolds (parallel::DistributedTriangulationBase< 3 > &triangulation, const Parameters::Mesh< 3 > &mesh_parameters, const Parameters::Manifolds &manifolds_parameters, const bool restart, const Parameters::PeriodicBoundaries &periodic_boundaries)
template void read_mesh_and_manifolds (parallel::DistributedTriangulationBase< 2, 3 > &triangulation, const Parameters::Mesh< 2, 3 > &mesh_parameters, const Parameters::Manifolds &manifolds_parameters, const bool restart, const Parameters::PeriodicBoundaries &periodic_boundaries)
template void read_mesh_and_manifolds_for_stator_and_rotor (parallel::DistributedTriangulationBase< 2 > &triangulation, const Parameters::Mesh< 2 > &mesh_parameters, const Parameters::Manifolds &manifolds_parameters, const bool restart, const Parameters::PeriodicBoundaries &periodic_boundaries, const Parameters::Mortar< 2 > &mortar_parameters)
template void read_mesh_and_manifolds_for_stator_and_rotor (parallel::DistributedTriangulationBase< 3 > &triangulation, const Parameters::Mesh< 3 > &mesh_parameters, const Parameters::Manifolds &manifolds_parameters, const bool restart, const Parameters::PeriodicBoundaries &periodic_boundaries, const Parameters::Mortar< 3 > &mortar_parameters)
template void build_refinement_box_triangulation (const Parameters::Mesh< 2 > &box_mesh_parameters, Triangulation< 2, 2 > &box_triangulation)
template void build_refinement_box_triangulation (const Parameters::Mesh< 2, 3 > &box_mesh_parameters, Triangulation< 2, 3 > &box_triangulation)
template void build_refinement_box_triangulation (const Parameters::Mesh< 3 > &box_mesh_parameters, Triangulation< 3, 3 > &box_triangulation)
template void apply_mesh_transformation (const Parameters::Mesh< 2 > &mesh_parameters, Triangulation< 2, 2 > &triangulation)
template void apply_mesh_transformation (const Parameters::Mesh< 2, 3 > &mesh_parameters, Triangulation< 2, 3 > &triangulation)
template void apply_mesh_transformation (const Parameters::Mesh< 3 > &mesh_parameters, Triangulation< 3, 3 > &triangulation)

Function Documentation

◆ apply_initial_refinement()

template<int dim, int spacedim>
void apply_initial_refinement ( const Parameters::Mesh< dim, spacedim > & mesh_parameters,
const bool restart,
parallel::DistributedTriangulationBase< dim, spacedim > & triangulation )
static

Apply the initial refinement described by the mesh parameters.

This is the refinement carried out once, right after the grid has been attached to the triangulation. Nothing is refined when restarting, since the mesh stored in the checkpoint has already been refined.

Parameters
[in]mesh_parametersThe mesh parameters used to decide how the triangulation is refined
[in]restartFlag indicating whether this is a restart
[in,out]triangulationThe triangulation which must be refined

Definition at line 409 of file grids.cc.

References Parameters::Mesh< dim, spacedim >::boundaries_to_refine, Parameters::Mesh< dim, spacedim >::initial_refinement, Parameters::Mesh< dim, spacedim >::initial_refinement_at_boundaries, refine_triangulation_at_boundaries(), Parameters::Mesh< dim, spacedim >::refine_until_target_size, Parameters::Mesh< dim, spacedim >::simplex, and Parameters::Mesh< dim, spacedim >::target_size.

◆ apply_mesh_transformation() [1/4]

template void apply_mesh_transformation ( const Parameters::Mesh< 2 > & mesh_parameters,
Triangulation< 2, 2 > & triangulation )

◆ apply_mesh_transformation() [2/4]

template void apply_mesh_transformation ( const Parameters::Mesh< 2, 3 > & mesh_parameters,
Triangulation< 2, 3 > & triangulation )

◆ apply_mesh_transformation() [3/4]

template void apply_mesh_transformation ( const Parameters::Mesh< 3 > & mesh_parameters,
Triangulation< 3, 3 > & triangulation )

◆ apply_mesh_transformation() [4/4]

template<int dim, int spacedim>
void apply_mesh_transformation ( const Parameters::Mesh< dim, spacedim > & mesh_parameters,
Triangulation< dim, spacedim > & triangulation )

Apply scaling, rotation and translation to the mesh in the listed order.

Template Parameters
dimAn integer that denotes the dimensionality of the geometry.
spacedimAn integer that denotes the dimension of the space occupied by the embedded geometry.
Parameters
[in]mesh_parametersParameters of the mesh.
[in,out]triangulationTriangulation object on which the mesh transformations are applied.

Definition at line 728 of file grids.cc.

References Parameters::Mesh< dim, spacedim >::rotation_angle, Parameters::Mesh< dim, spacedim >::rotation_axis, Parameters::Mesh< dim, spacedim >::scale, and Parameters::Mesh< dim, spacedim >::translation.

◆ attach_grid_to_triangulation() [1/4]

template void attach_grid_to_triangulation ( Triangulation< 2 > & triangulation,
const Parameters::Mesh< 2 > & mesh_parameters )

◆ attach_grid_to_triangulation() [2/4]

template void attach_grid_to_triangulation ( Triangulation< 2, 3 > & triangulation,
const Parameters::Mesh< 2, 3 > & mesh_parameters )

◆ attach_grid_to_triangulation() [3/4]

template void attach_grid_to_triangulation ( Triangulation< 3 > & triangulation,
const Parameters::Mesh< 3 > & mesh_parameters )

◆ attach_grid_to_triangulation() [4/4]

◆ build_refinement_box_triangulation() [1/4]

template void build_refinement_box_triangulation ( const Parameters::Mesh< 2 > & box_mesh_parameters,
Triangulation< 2, 2 > & box_triangulation )

◆ build_refinement_box_triangulation() [2/4]

template void build_refinement_box_triangulation ( const Parameters::Mesh< 2, 3 > & box_mesh_parameters,
Triangulation< 2, 3 > & box_triangulation )

◆ build_refinement_box_triangulation() [3/4]

template void build_refinement_box_triangulation ( const Parameters::Mesh< 3 > & box_mesh_parameters,
Triangulation< 3, 3 > & box_triangulation )

◆ build_refinement_box_triangulation() [4/4]

template<int dim, int spacedim>
void build_refinement_box_triangulation ( const Parameters::Mesh< dim, spacedim > & box_mesh_parameters,
Triangulation< dim, spacedim > & box_triangulation )

Build the triangulation which delimits a mesh refinement box.

The box is described by a full set of mesh parameters, so any mesh type supported by attach_grid_to_triangulation() can be used to delimit a refinement region. The initial refinement of the box mesh is applied here, so the resulting triangulation is ready to be used to flag cells.

Parameters
[in]box_mesh_parametersThe mesh parameters describing the box
[in,out]box_triangulationThe triangulation which will hold the box mesh

Definition at line 712 of file grids.cc.

References attach_grid_to_triangulation(), Parameters::Mesh< dim, spacedim >::initial_refinement, and Parameters::Mesh< dim, spacedim >::simplex.

◆ read_mesh_and_manifolds() [1/4]

template void read_mesh_and_manifolds ( parallel::DistributedTriangulationBase< 2 > & triangulation,
const Parameters::Mesh< 2 > & mesh_parameters,
const Parameters::Manifolds & manifolds_parameters,
const bool restart,
const Parameters::PeriodicBoundaries & periodic_boundaries )

◆ read_mesh_and_manifolds() [2/4]

template void read_mesh_and_manifolds ( parallel::DistributedTriangulationBase< 2, 3 > & triangulation,
const Parameters::Mesh< 2, 3 > & mesh_parameters,
const Parameters::Manifolds & manifolds_parameters,
const bool restart,
const Parameters::PeriodicBoundaries & periodic_boundaries )

◆ read_mesh_and_manifolds() [3/4]

template void read_mesh_and_manifolds ( parallel::DistributedTriangulationBase< 3 > & triangulation,
const Parameters::Mesh< 3 > & mesh_parameters,
const Parameters::Manifolds & manifolds_parameters,
const bool restart,
const Parameters::PeriodicBoundaries & periodic_boundaries )

◆ read_mesh_and_manifolds() [4/4]

template<int dim, int spacedim>
void read_mesh_and_manifolds ( parallel::DistributedTriangulationBase< dim, spacedim > & triangulation,
const Parameters::Mesh< dim, spacedim > & mesh_parameters,
const Parameters::Manifolds & manifolds_parameters,
bool restart,
const Parameters::PeriodicBoundaries & periodic_boundaries )

Completely sets up a mesh and its manifolds.

This function reads and constructs a mesh according to the given mesh parameters, sets up manifolds on boundaries, and applies boundary conditions. It is intended for distributed triangulations.

Template Parameters
dimThe topological dimension of the mesh.
spacedimThe embedding space dimension (default = dim).
Parameters
[in,out]triangulationThe triangulation to which the grid will be attached.
[in]mesh_parametersParameters defining the mesh or primitive to use.
[in]manifolds_parametersInformation about the manifolds attached to boundaries.
[in]restartFlag indicating whether this is a restart.
[in]periodic_boundariesThe periodic boundary pairs and their direction of periodicity, used to set up the periodicity of the domain.

Definition at line 447 of file grids.cc.

References apply_initial_refinement(), attach_grid_to_triangulation(), attach_manifolds_to_triangulation(), Parameters::Mesh< dim, spacedim >::gmsh, Parameters::Manifolds::ids, setup_periodic_boundary_conditions(), and Parameters::Mesh< dim, spacedim >::type.

◆ read_mesh_and_manifolds_for_stator_and_rotor() [1/3]

template void read_mesh_and_manifolds_for_stator_and_rotor ( parallel::DistributedTriangulationBase< 2 > & triangulation,
const Parameters::Mesh< 2 > & mesh_parameters,
const Parameters::Manifolds & manifolds_parameters,
const bool restart,
const Parameters::PeriodicBoundaries & periodic_boundaries,
const Parameters::Mortar< 2 > & mortar_parameters )

◆ read_mesh_and_manifolds_for_stator_and_rotor() [2/3]

template void read_mesh_and_manifolds_for_stator_and_rotor ( parallel::DistributedTriangulationBase< 3 > & triangulation,
const Parameters::Mesh< 3 > & mesh_parameters,
const Parameters::Manifolds & manifolds_parameters,
const bool restart,
const Parameters::PeriodicBoundaries & periodic_boundaries,
const Parameters::Mortar< 3 > & mortar_parameters )

◆ read_mesh_and_manifolds_for_stator_and_rotor() [3/3]

template<int dim, int spacedim>
void read_mesh_and_manifolds_for_stator_and_rotor ( parallel::DistributedTriangulationBase< dim, spacedim > & triangulation,
const Parameters::Mesh< dim, spacedim > & mesh_parameters,
const Parameters::Manifolds & manifolds_parameters,
bool restart,
const Parameters::PeriodicBoundaries & periodic_boundaries,
const Parameters::Mortar< dim > & mortar_parameters )

Completely sets up a mesh and its manifolds for rotor-stator domains.

The triangulation initially contains the stator triangulation, which is later replaced by the merged rotor-stator triangulation.

Template Parameters
dimThe topological dimension of the mesh.
spacedimThe embedding space dimension (default = dim).
Parameters
[in,out]triangulationThe triangulation to which the grid will be attached.
[in]mesh_parametersParameters defining the mesh or primitive to use.
[in]manifolds_parametersInformation about the manifolds attached to boundaries.
[in]restartFlag indicating whether this is a restart.
[in]periodic_boundariesThe periodic boundary pairs and their direction of periodicity, used to set up the periodicity of the domain.
[in]mortar_parametersParameters controlling the mortar method, including rotor mesh info.

Definition at line 501 of file grids.cc.

References apply_initial_refinement(), attach_grid_to_triangulation(), attach_manifolds_to_triangulation(), Parameters::Mesh< dim, spacedim >::dealii, Parameters::Mesh< dim, spacedim >::gmsh, Parameters::Manifolds::ids, Parameters::Mortar< dim >::interface_type, Parameters::Mortar< dim >::linear, Parameters::Mortar< dim >::rotor_boundary_id, Parameters::Mortar< dim >::rotor_mesh, setup_periodic_boundary_conditions(), Parameters::Mortar< dim >::stator_boundary_id, and Parameters::Mesh< dim, spacedim >::type.

◆ setup_periodic_boundary_conditions() [1/4]

template void setup_periodic_boundary_conditions ( parallel::DistributedTriangulationBase< 2, 2 > & triangulation,
const Parameters::PeriodicBoundaries & periodic_boundaries )

◆ setup_periodic_boundary_conditions() [2/4]

template void setup_periodic_boundary_conditions ( parallel::DistributedTriangulationBase< 2, 3 > & triangulation,
const Parameters::PeriodicBoundaries & periodic_boundaries )

◆ setup_periodic_boundary_conditions() [3/4]

template void setup_periodic_boundary_conditions ( parallel::DistributedTriangulationBase< 3, 3 > & triangulation,
const Parameters::PeriodicBoundaries & periodic_boundaries )

◆ setup_periodic_boundary_conditions() [4/4]

template<int dim, int spacedim>
void setup_periodic_boundary_conditions ( parallel::DistributedTriangulationBase< dim, spacedim > & triangulation,
const Parameters::PeriodicBoundaries & periodic_boundaries )

Modifies the triangulation to set up its periodic boundary conditions.

The periodic boundary information is the part of the boundary conditions that is shared by the CFD and the DEM solvers, so this function is used by both.

Parameters
[in,out]triangulationThe triangulation to which a grid is attached
[in]periodic_boundariesThe periodic boundary pairs and their direction of periodicity. This is used to set up the periodicity of the domain

Definition at line 367 of file grids.cc.

◆ warn_if_scaling_curved_manifolds()

template<int dim, int spacedim>
void warn_if_scaling_curved_manifolds ( const Parameters::Mesh< dim, spacedim > & mesh_parameters,
const Triangulation< dim, spacedim > & triangulation )
static

Warn when a mesh scaling factor is applied to a grid which carries curved manifolds.

Meshes generated by deal.II (type = dealii) or by Lethe's built-in generators (type = lethe) may carry curved manifolds attached to the triangulation. GridTools::scale moves the vertices but does not scale their attached manifolds, so a scale factor other than 1 can leave the manifolds inconsistent with the mesh and distort curved geometries under refinement. The scaling is still applied, but the user is warned so that the resulting mesh can be checked; such geometries can alternatively be scaled through the grid arguments.

Grids whose cells and faces all use the flat manifold, such as the hyper_cube or hyper_rectangle grids commonly used to delimit a mesh refinement box, are invariant under scaling and do not trigger the warning. Neither do gmsh meshes, which carry no manifold.

Parameters
[in]mesh_parametersThe mesh parameters used to generate the grid
[in]triangulationThe triangulation the grid was attached to. It must already carry its manifold ids, hence the check is made after the grid generation.

Definition at line 57 of file grids.cc.

References Parameters::Mesh< dim, spacedim >::dealii, Parameters::Mesh< dim, spacedim >::gmsh, Parameters::Mesh< dim, spacedim >::scale, and Parameters::Mesh< dim, spacedim >::type.