From: Timo Heister Date: Mon, 13 Feb 2023 17:43:55 +0000 (-0500) Subject: doxygen: simplex relates X-Git-Tag: v9.5.0-rc1~536^2 X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=refs%2Fpull%2F14794%2Fhead;p=dealii.git doxygen: simplex relates It turns out "@relates simplex" does not add the functionality (or link to) the simplex group. Instead, it removes some functions completely (GridGenerator functions are currently nowhere to be found). Instead, I created a list inside simplex manually and just reference the simplex group. --- diff --git a/doc/doxygen/headers/simplex.h b/doc/doxygen/headers/simplex.h index 85a7279e70..5beaf1d9b5 100644 --- a/doc/doxygen/headers/simplex.h +++ b/doc/doxygen/headers/simplex.h @@ -22,18 +22,43 @@ * Simplex and mixed meshes in deal.II are still experimental, i.e., work * in progress. Large parts of the library have been ported to be able to * operate on such kind of meshes. However, there are still many functions - * that need to be generalized. You can get a good overview of the ported + * that need to be generalized. + * + * @section Important Simplex Functionality + * + * Here is an incomplete list of functionality related to simplex + * computations: + * - Mesh generation: + * GridGenerator::implicit_function(), + * GridGenerator::convert_hypercube_to_simplex_mesh(), + * GridGenerator::subdivided_hyper_rectangle_with_simplices(), + * GridGenerator::subdivided_hyper_cube_with_simplices() + * - Quadratures: + * QGaussWedge, QGaussSimplex, QWitherdenVincentSimplex + * - FiniteElements: + * FE_SimplexP, FE_SimplexDGP, FE_SimplexP_Bubbles + * FE_PyramidP, FE_PyramidDGP, FE_WedgeP, FE_WedgeDGP + * - Mapping: + * MappingFE + * - Other: + * GridIn::read_vtk(), GridIn::read_msh(), GridIn::read_comsol_mphtxt() + * + * + * + * @section Examples + * + * You can get a good overview of the ported * functionalities by taking a look at the tests in the folder * "tests/simplex". In the following, we provide two very basic examples - * to get started and provide some implementation details. + * to get you started and to provide some implementation details. * - * @section simplex_reference_example_simplex Example: simplex mesh + * @subsection simplex_reference_example_simplex Example: simplex mesh * * The following code shows how to work with simplex meshes: * * @include step_3_simplex.cc * - * @section simplex_reference_example_mixed Example: mixed mesh + * @subsection simplex_reference_example_mixed Example: mixed mesh * * The following code shows how to work with mixed meshes: * diff --git a/include/deal.II/base/quadrature_lib.h b/include/deal.II/base/quadrature_lib.h index ea4d6bffea..3ab4640853 100644 --- a/include/deal.II/base/quadrature_lib.h +++ b/include/deal.II/base/quadrature_lib.h @@ -831,7 +831,8 @@ public: * depends on the numbering of the cell vertices. If you need rules that are * independent of the vertex numbering then use QWitherdenVincentSimplex. * - * @relates simplex + * Also see + * @ref simplex "Simplex support". */ template class QGaussSimplex : public QSimplex @@ -872,7 +873,8 @@ public: * @note Some rules (2d 2 odd and 3d 2 even) do not yet exist and instead a * higher-order rule is used in their place. * - * @relates simplex + * Also see + * @ref simplex "Simplex support". */ template class QWitherdenVincentSimplex : public QSimplex diff --git a/include/deal.II/fe/fe_pyramid_p.h b/include/deal.II/fe/fe_pyramid_p.h index 28981855f7..9715745b3c 100644 --- a/include/deal.II/fe/fe_pyramid_p.h +++ b/include/deal.II/fe/fe_pyramid_p.h @@ -29,7 +29,8 @@ DEAL_II_NAMESPACE_OPEN * * @note Only implemented for 3d. * - * @relates simplex + * Also see + * @ref simplex "Simplex support". */ template class FE_PyramidPoly : public dealii::FE_Poly @@ -59,7 +60,8 @@ public: * @note Currently, only linear polynomials (degree=1) are implemented. See * also the documentation of ScalarLagrangePolynomialPyramid. * - * @relates simplex + * Also see + * @ref simplex "Simplex support". */ template class FE_PyramidP : public FE_PyramidPoly @@ -121,7 +123,8 @@ public: * @note Currently, only linear polynomials (degree=1) are implemented. See * also the documentation of ScalarLagrangePolynomialPyramid. * - * @relates simplex + * Also see + * @ref simplex "Simplex support". */ template class FE_PyramidDGP : public FE_PyramidPoly diff --git a/include/deal.II/fe/fe_simplex_p.h b/include/deal.II/fe/fe_simplex_p.h index 38ac36cca2..e3040534c3 100644 --- a/include/deal.II/fe/fe_simplex_p.h +++ b/include/deal.II/fe/fe_simplex_p.h @@ -30,7 +30,8 @@ DEAL_II_NAMESPACE_OPEN * * @note Only implemented for 2d and 3d. * - * @relates simplex + * Also see + * @ref simplex "Simplex support". */ template class FE_SimplexPoly : public dealii::FE_Poly @@ -121,7 +122,8 @@ protected: * the finite element space of continuous, piecewise polynomials of * degree $k$. * - * @relates simplex + * Also see + * @ref simplex "Simplex support". */ template class FE_SimplexP : public FE_SimplexPoly @@ -176,7 +178,8 @@ public: * element space of discontinuous, piecewise polynomials of degree * $k$. * - * @relates simplex + * Also see + * @ref simplex "Simplex support". */ template class FE_SimplexDGP : public FE_SimplexPoly diff --git a/include/deal.II/fe/fe_wedge_p.h b/include/deal.II/fe/fe_wedge_p.h index 772c713dbd..3212d08485 100644 --- a/include/deal.II/fe/fe_wedge_p.h +++ b/include/deal.II/fe/fe_wedge_p.h @@ -29,7 +29,8 @@ DEAL_II_NAMESPACE_OPEN * * @note Only implemented for 3d. * - * @relates simplex + * Also see + * @ref simplex "Simplex support". */ template class FE_WedgePoly : public dealii::FE_Poly @@ -60,7 +61,8 @@ public: * (degree=2) are implemented. See also the documentation of * ScalarLagrangePolynomialWedge. * - * @relates simplex + * Also see + * @ref simplex "Simplex support". */ template class FE_WedgeP : public FE_WedgePoly @@ -123,7 +125,8 @@ public: * (degree=2) are implemented. See also the documentation of * ScalarLagrangePolynomialWedge. * - * @relates simplex + * Also see + * @ref simplex "Simplex support". */ template class FE_WedgeDGP : public FE_WedgePoly diff --git a/include/deal.II/fe/mapping_fe.h b/include/deal.II/fe/mapping_fe.h index 835900593f..fdb0ac6062 100644 --- a/include/deal.II/fe/mapping_fe.h +++ b/include/deal.II/fe/mapping_fe.h @@ -53,7 +53,8 @@ DEAL_II_NAMESPACE_OPEN * @note Currently, only implemented for elements with tensor_degree==1 and * n_components==1. * - * @relates simplex + * Also see + * @ref simplex "Simplex support". */ template class MappingFE : public Mapping diff --git a/include/deal.II/grid/grid_generator.h b/include/deal.II/grid/grid_generator.h index 9747f51a85..c557898e5e 100644 --- a/include/deal.II/grid/grid_generator.h +++ b/include/deal.II/grid/grid_generator.h @@ -2268,7 +2268,8 @@ namespace GridGenerator * out_tria.set_manifold(i, in_tria.get_manifold(i)); * @endcode * - * @relates simplex + * Also see + * @ref simplex "Simplex support". */ template void @@ -2484,7 +2485,8 @@ namespace GridGenerator * * @note Currently, this function only works for `dim==spacedim`. * - * @relates simplex + * Also see + * @ref simplex "Simplex support". */ template void @@ -2507,7 +2509,8 @@ namespace GridGenerator * quadrilateral/hexahedral cells and subdivides these into 2/5 * triangular/tetrahedral cells. * - * @relates simplex + * Also see + * @ref simplex "Simplex support". */ template void diff --git a/include/deal.II/grid/grid_in.h b/include/deal.II/grid/grid_in.h index 03254f44bd..b0b8fca345 100644 --- a/include/deal.II/grid/grid_in.h +++ b/include/deal.II/grid/grid_in.h @@ -411,7 +411,8 @@ public: * The companion GridOut::write_vtk function can be used to write VTK files * compatible with this method. * - * @relates simplex + * Also see + * @ref simplex "Simplex support". */ void read_vtk(std::istream &in); @@ -516,7 +517,8 @@ public: * Read grid data from an msh file. The %Gmsh formats are documented at * http://www.gmsh.info/. * - * @relates simplex + * Also see + * @ref simplex "Simplex support". */ void read_msh(std::istream &in); @@ -575,7 +577,9 @@ public: * as a boundary or material id. Physical surface numbers created in Gmsh, * which can be seen in the .geo file, become material IDs. * - * @relates simplex + * + * Also see + * @ref simplex "Simplex support". */ void read_msh(const std::string &filename); @@ -614,7 +618,8 @@ public: * @image html "comsol-mesh-boundary-lines.png" * @image html "comsol-mesh-boundary-triangles.png" * - * @relates simplex + * Also see + * @ref simplex "Simplex support". */ void read_comsol_mphtxt(std::istream &in);