refactor duplicated code into separate function

Add test

Add PolarManifold::normal_vector

Merge pull request #9570 from tjhei/fix_tutorial_inline_comments

doxygen: do not remove multiline code comments

doxygen: do not remove multiline code comments

Code in tutorials that contains multiline comments like

/*keep_constrained_dofs = */ false

were being replaced by

/ *keep_constrained_dofs = * / false

I don't see why this is necessary. The documentation looks correct to
me.

fixes #9554

Merge pull request #9569 from tjhei/doxygen_skip_header_step_b

doxygen: skip license header in step-xxb

doxygen: skip license header in step-xxb

We introduced tutorials like step-12b but we incorrectly print the
license header at the beginning of the "commented program". Filter those
out as well.

Merge pull request #9568 from tjhei/64bit_refinement

fix 64bit overflow in refine_and_coarsen_fixed_number

fix 64bit overflow in refine_and_coarsen_fixed_number

The argument max_n_cells (that probably nobody uses) was declared as an
unsigned int, meaning that we can not refine over 4 billion cells with
this function. This is now fixed.

Merge pull request #9564 from kronbichler/fe_evaluation_assert_test

Make assertions to track state in FEEvaluation debug-only

Merge pull request #9559 from bangerth/doc

Update documentation of SphericalManifold::normal_vector.

Make assertions to track state in FEEvaluation debug-only

Update documentation of SphericalManifold::normal_vector.

Merge pull request #9539 from masterleinad/replace_assert_in_tests

Redefine Assert as AssertThrow in tests

Merge pull request #9561 from bangerth/endl

Avoid using std::endl over '\n'.

Merge pull request #9526 from agrayver/add_step_49_python

Add python version of step-49

Avoid using std::endl over '\n'.

std::endl writes an endline character into the stream, but then follows
that up with a flush(). That's expensive on remote-mounted file systems,
and most unnecessary as well -- we should really just write the endline
character and put a flush() at the very end of the operation.

Add python version of step-49

Merge pull request #9555 from marcfehling/test-hpconstraints

New test: p::d::tria + hp::dofh + hanging_node_constraints.

New test: p::d::tria + hp::dofh + hanging_node_constraints.

Merge pull request #9551 from masterleinad/add_split_by_block

Slight improvements to #9529

Merge pull request #9548 from tjhei/64bit_n_global_active_cells

Fix 64bit GridRefinement overflow

Fix 64bit GridRefinement overflow

GridRefinement::refine_and_coarsen_fixed_fraction causes overflow with
more than 2^32 global active cells. This is now fixed.

Merge pull request #9553 from GrahamBenHarper/graham_step51_typofix

Fix a typo in step-51 files

Fix a typo in step-51 files

Slight improvements to #9529

Merge pull request #9529 from KatrinMang/add_split_by_block

Add split_by_block() into IndexSet

add split_by_block into index_set

Add comments describing the redefinition

Merge pull request #9543 from GrahamBenHarper/graham_dev_dox2

Fix use of array concatenation in checkdoxygen.py

Include tests.h before any other local file

Change priority of tests.h for clang-format

Fix use of array concatenation

Merge pull request #9505 from GrahamBenHarper/graham_dev_dox

Upgrade checkdoxygen.py to check for multiple-defined section headers

Upgrade checkdoxygen.py to check for multiple-defined headers

Merge pull request #9540 from tjhei/64bit_n_global_active_cells

Fix overflow in tria.n_global_active_cells()

Fix overflow in tria.n_global_active_cells()

for large computations.

Redefine Assert as AssertThrow in tests

Merge pull request #9533 from tjhei/assert_throw_lapack

Use AssertThrow when LAPACK or other dependencies are not installed

Merge pull request #9534 from tjhei/mg_tansfer_64bit_but_not_really_a_bug

Use a 64bit type in one other MGTransfer location

Merge pull request #9536 from bangerth/nonlocal

Avoid nonlocal control flow since it's so hard to read.

Merge pull request #9537 from bangerth/pedantic

Be pedantic in how we spell deal.II.

Use better markup when talking about header files.

Be pedantic in how we spell deal.II.

Avoid nonlocal control flow since it's so hard to read.

find other places to AssertThrow for missing dependencies

Merge pull request #9531 from bangerth/refs

Move the step-71 -> step-47 references in references.bib.

Merge pull request #9532 from tjhei/examples_no_h2

do not use <h2> tag in tutorials

Use a 64bit type in one other MGTransfer location

This is a local index (how manyth index) and as such likely under 4
billion. I found it harder to assert or document why this cast makes
sense, so I rather change the type.

Use AssertThrow when no LAPACK is installed

This bit me on a run in release mode on a cluster today, because my
deal.II didn't have a working LAPACK.

do not use <h2> tag in tutorials

I am not quite sure why, but they don't show up in the table of
contents. We have been avoiding them, but a few tutorials seem to
violate this now.

Move the step-71 -> step-47 references in references.bib.

Merge pull request #9528 from kronbichler/fix_64bit_type

Use types::global_dof_index rather than unsigned int in MGTransfer

Use types::global_dof_index rather than unsigned int in MGTransfer

Merge pull request #9510 from agrayver/add_python_wrappers

Add more python bindings

Merge pull request #9527 from GrahamBenHarper/graham_dev_fix_tables

Remove empty lines inside html tables

Remove empty lines inside html tables

Merge pull request #9511 from tamiko/fix_indent_for_old_git

Indent script: Do not use --diff-filter=d

Merge pull request #9522 from bangerth/14

Scale a graphic in the results section of step-14.

Merge pull request #9525 from kronbichler/fill_q_points

Ensure to have valid quadrature point data for all SIMD lanes

Merge pull request #9524 from kronbichler/fix_fe_eval_vector

FEEvaluation: Place exception about no block vector correctly

Merge pull request #9519 from kronbichler/fix_minmaxavg_mpi

Avoid calling into MPI functions with MinMaxAvg in serial

Merge pull request #9523 from bangerth/6

Replace eps-generated figure by vtu-generated one in step-6.

Merge pull request #9518 from rezarastak/value_semantics

Use value semantics for const parameters with trivial small types

Add python binding for TriaAccessor::centre

Add extra CylindricalManifold constructor

Ensure to have valid quadrature point data for all SIMD lanes

FEEvaluation: Place exception about no block vector correctly

Replace eps-generated figure by vtu-generated one in step-6.

Scale a graphic in the results section of step-14.

Make it the same size as the other images of the solution.

Merge pull request #9493 from bangerth/30

Convert step-30 from using eps/gnuplot to svg/vtu.

Merge pull request #9495 from bangerth/14

Convert step-14 from using eps/gnuplot to svg/vtu.

Merge pull request #9514 from peterrum/write_vtu_with_pvtu_record_comm

Remove MPI_COMM_WORLD as default argument in write_vtu_with_pvtu_record

Merge pull request #9515 from GrahamBenHarper/graham_dev_vec_warnings

Remove some unused variable warnings in vectorization.h

Merge pull request #9516 from marcfehling/bug-weights

parallel::CellWeights: Capture values, not references.

Avoid calling into MPI functions with MinMaxAvg in serial

Use value semantics for parameters with trivial small types

Add more python binds

Merge pull request #9451 from sophy1029/step-47

step-47: switch the jump and average in one term of the scheme.

parallel::CellWeights: Capture values, not references.

Remove some unused variable warnings

Remove MPI_COMM_WORLD as default arguemtn in write_vtu_with_pvtu_record

Merge pull request #9474 from GrahamBenHarper/graham_dev_svg_boundaryid

Add boundary id functionality to write_svg

Merge pull request #9506 from GrahamBenHarper/graham_dev_clean_tutorials

Update tutorial programs to fix all broken dox links

Merge pull request #9512 from kronbichler/fix_muelu_test

Fix MueLu periodicity test

Update tutorial programs to fix broken dox links

Fix MueLu periodicity test

Indent script: Do not use --diff-filter=d

This hopefully fixes some compatibility issues with ancient git versions
not supporting the --diff-filter option.

Closes #9489

Merge pull request #9507 from bangerth/6

Minor edit to step-6's results section.

Merge pull request #9508 from masterleinad/fix_section_step_45

Fix sections in step-45

Merge pull request #9473 from peterrum/minmaxave_vector

Add Utilities::MPI::min_max_avg() for vectors

Fix sections in step-45

Minor edit to step-6's results section.

Merge pull request #9501 from jihuan-tian/jihuan-tian-contrib

Correct the printed message output from ExcInvalidBoundaryFunction()

Merge pull request #9504 from GrahamBenHarper/graham_dev_step61

Fix header names in step-61

Fix header names in step-61

Merge pull request #9503 from masterleinad/create_separate_artifacts

Create separate artifacts in GitHub workflows

Create separate artifacts in GitHub workflows

Merge pull request #9500 from drwells/remove-eps-step-6

Remove eps step 6

Merge remote-tracking branch 'upstream/master' into jihuan-tian-contrib