Files
mfem/tests/unit/fem/test_transfer.cpp
T

588 lines
16 KiB
C++

// Copyright (c) 2010-2025, Lawrence Livermore National Security, LLC. Produced
// at the Lawrence Livermore National Laboratory. All Rights reserved. See files
// LICENSE and NOTICE for details. LLNL-CODE-806117.
//
// This file is part of the MFEM library. For more information and source code
// availability visit https://mfem.org.
//
// MFEM is free software; you can redistribute it and/or modify it under the
// terms of the BSD-3 license. We welcome feedback and contributions, see file
// CONTRIBUTING.md for details.
#include "unit_tests.hpp"
#include "mfem.hpp"
using namespace mfem;
int RandomPRefinement(FiniteElementSpace & fes)
{
Mesh *mesh = fes.GetMesh();
int maxorder = 0;
for (int i = 0; i < mesh->GetNE(); i++)
{
const int order = fes.GetElementOrder(i);
maxorder = std::max(maxorder,order);
if ((double) rand() / RAND_MAX < 0.5)
{
fes.SetElementOrder(i,order+1);
maxorder = std::max(maxorder,order+1);
}
}
fes.Update(false);
return maxorder;
}
int dimension;
int coeff_order;
double coeff(const Vector& X)
{
double x = X[0];
double y = X[1];
double z = 0.;
if (dimension == 2)
{
if (coeff_order == 1)
{
return 1.1 * x + 2.0 * y;
}
else
{
return (1.-x)*x*(1.-y)*y;
}
}
else
{
z = X[2];
if (coeff_order == 1)
{
return 1.1 * x + 2.0 * y + 3.0 * z;
}
else
{
return (1.-x)*x*(1.-y)*y*(1.-z)*z;
}
}
}
void vectorcoeff(const Vector& x, Vector& y)
{
y(0) = coeff(x);
y(1) = -coeff(x);
if (dimension == 3)
{
y(2) = 2.0 * coeff(x);
}
}
enum class VecSpace { H1, VectorH1, ND, RT };
std::string VecSpaceName(VecSpace vectorspace)
{
switch (vectorspace)
{
case VecSpace::H1: return "H1";
case VecSpace::VectorH1: return "Vector H1";
case VecSpace::ND: return "Nedelec";
case VecSpace::RT: return "Raviart-Thomas";
}
return "";
}
TEST_CASE("Transfer", "[Transfer]")
{
auto vectorspace = GENERATE(VecSpace::H1, VecSpace::VectorH1, VecSpace::ND,
VecSpace::RT);
auto geometric = GENERATE(true, false);
auto simplex = GENERATE(true, false);
dimension = GENERATE(2, 3);
int order = 2;
int ne = 2;
int fineOrder = geometric ? order : 2*order;
// Log test case information
int total_ne = static_cast<int>(std::pow(ne, dimension));
CAPTURE(VecSpaceName(vectorspace), dimension, simplex, total_ne, order,
fineOrder, geometric);
Mesh mesh;
if (dimension == 2)
{
Element::Type type = simplex ? Element::TRIANGLE : Element::QUADRILATERAL;
mesh = Mesh::MakeCartesian2D(ne, ne, type, 1, 1.0, 1.0);
}
else
{
Element::Type type = simplex ? Element::TETRAHEDRON : Element::HEXAHEDRON;
mesh = Mesh::MakeCartesian3D(ne, ne, ne, type, 1.0, 1.0, 1.0);
}
FiniteElementCollection *c_fec = nullptr;
FiniteElementCollection *f_fec = nullptr;
switch (vectorspace)
{
case VecSpace::H1:
case VecSpace::VectorH1:
c_fec = new H1_FECollection(order, dimension);
f_fec = geometric ? c_fec : new H1_FECollection(fineOrder, dimension);
break;
case VecSpace::ND:
c_fec = new ND_FECollection(order+1, dimension);
f_fec = geometric ? c_fec : new ND_FECollection(fineOrder, dimension);
break;
case VecSpace::RT:
c_fec = new RT_FECollection(order, dimension);
f_fec = geometric ? c_fec : new RT_FECollection(fineOrder, dimension);
break;
}
Mesh fineMesh(mesh);
if (geometric)
{
fineMesh.UniformRefinement();
}
const int vdim = (vectorspace == VecSpace::VectorH1) ? dimension : 1;
FiniteElementSpace *c_fespace =
new FiniteElementSpace(&mesh, c_fec, vdim);
FiniteElementSpace *f_fespace =
new FiniteElementSpace(&fineMesh, f_fec, vdim);
Operator* referenceOperator = nullptr;
if (!geometric)
{
referenceOperator = new PRefinementTransferOperator(*c_fespace,
*f_fespace);
}
else
{
OperatorPtr P(Operator::ANY_TYPE);
f_fespace->GetTransferOperator(*c_fespace, P);
P.SetOperatorOwner(false);
referenceOperator = P.Ptr();
}
TransferOperator testTransferOperator(*c_fespace, *f_fespace);
GridFunction X(c_fespace);
GridFunction X_cmp(c_fespace);
GridFunction Y_exact(f_fespace);
GridFunction Y_std(f_fespace);
GridFunction Y_test(f_fespace);
coeff_order = 1;
if (vectorspace == VecSpace::H1)
{
FunctionCoefficient funcCoeff(&coeff);
X.ProjectCoefficient(funcCoeff);
Y_exact.ProjectCoefficient(funcCoeff);
}
else
{
VectorFunctionCoefficient funcCoeff(dimension, &vectorcoeff);
X.ProjectCoefficient(funcCoeff);
Y_exact.ProjectCoefficient(funcCoeff);
}
Y_std = 0.0;
Y_test = 0.0;
referenceOperator->Mult(X, Y_std);
Y_std -= Y_exact;
REQUIRE(Y_std.Norml2() < 1e-12 * Y_exact.Norml2());
testTransferOperator.Mult(X, Y_test);
Y_test -= Y_exact;
REQUIRE(Y_test.Norml2() < 1e-12 * Y_exact.Norml2());
referenceOperator->MultTranspose(Y_exact, X);
testTransferOperator.MultTranspose(Y_exact, X_cmp);
X -= X_cmp;
REQUIRE(X.Norml2() < 1e-12 * X_cmp.Norml2());
delete referenceOperator;
delete f_fespace;
delete c_fespace;
if (geometric == 0)
{
delete f_fec;
}
delete c_fec;
}
TEST_CASE("Variable Order Transfer", "[Transfer][VariableOrder]")
{
auto vectorspace = GENERATE(VecSpace::H1, VecSpace::VectorH1, VecSpace::ND,
VecSpace::RT);
dimension = GENERATE(2, 3);
int ne = 2;
int order = 2;
// Log test case information
int total_ne = static_cast<int>(pow(ne, dimension));
CAPTURE(VecSpaceName(vectorspace), dimension, total_ne, order);
Mesh mesh;
if (dimension == 2)
{
Element::Type type = Element::QUADRILATERAL;
mesh = Mesh::MakeCartesian2D(ne, ne, type, 1, 1.0, 1.0);
}
else
{
Element::Type type = Element::HEXAHEDRON;
mesh = Mesh::MakeCartesian3D(ne, ne, ne, type, 1.0, 1.0, 1.0);
}
FiniteElementCollection* c_fec = nullptr;
FiniteElementCollection* f_fec = nullptr;
switch (vectorspace)
{
case VecSpace::H1:
case VecSpace::VectorH1:
c_fec = new H1_FECollection(order, dimension);
f_fec = new H1_FECollection(order, dimension);
break;
case VecSpace::ND:
c_fec = new ND_FECollection(order+1, dimension);
f_fec = new ND_FECollection(order+1, dimension);
break;
case VecSpace::RT:
c_fec = new RT_FECollection(order, dimension);
f_fec = new RT_FECollection(order, dimension);
break;
}
mesh.EnsureNCMesh();
mesh.RandomRefinement(0.5);
const int vdim = (vectorspace == VecSpace::VectorH1) ? dimension : 1;
FiniteElementSpace *c_fespace =
new FiniteElementSpace(&mesh, c_fec, vdim);
FiniteElementSpace *f_fespace =
new FiniteElementSpace(&mesh, f_fec, vdim);
RandomPRefinement(*f_fespace);
Operator* referenceOperator = nullptr;
referenceOperator = new PRefinementTransferOperator(*c_fespace,
*f_fespace);
TransferOperator testTransferOperator(*c_fespace, *f_fespace);
GridFunction X(c_fespace); X = 0.;
GridFunction X_cmp(c_fespace); X_cmp = 0.;
GridFunction Y_exact(f_fespace); Y_exact = 0.;
GridFunction Y_std(f_fespace); Y_std = 0.;
GridFunction Y_test(f_fespace); Y_test = 0.;
coeff_order = std::min(2,order);
if (vectorspace == VecSpace::H1)
{
FunctionCoefficient funcCoeff(&coeff);
X.ProjectCoefficient(funcCoeff);
Y_exact.ProjectCoefficient(funcCoeff);
}
else
{
VectorFunctionCoefficient funcCoeff(dimension, &vectorcoeff);
X.ProjectCoefficient(funcCoeff);
Y_exact.ProjectCoefficient(funcCoeff);
}
Y_std = 0.0;
Y_test = 0.0;
referenceOperator->Mult(X, Y_std);
Y_std -= Y_exact;
REQUIRE(Y_std.Norml2() < 1e-12 * Y_exact.Norml2());
testTransferOperator.Mult(X, Y_test);
Y_test -= Y_exact;
REQUIRE(Y_test.Norml2() < 1e-12 * Y_exact.Norml2());
referenceOperator->MultTranspose(Y_exact, X);
testTransferOperator.MultTranspose(Y_exact, X_cmp);
X -= X_cmp;
REQUIRE(X.Norml2() < 1e-12 * X_cmp.Norml2());
delete referenceOperator;
delete f_fespace;
delete c_fespace;
delete f_fec;
delete c_fec;
}
TEST_CASE("Variable Order True Transfer", "[Transfer][VariableOrder]")
{
auto vectorspace = GENERATE(VecSpace::H1, VecSpace::VectorH1);
dimension = GENERATE(2, 3);
int ne = 2;
int order = 2;
// Log test case information
CAPTURE(VecSpaceName(vectorspace), dimension, order);
Mesh mesh;
if (dimension == 2)
{
Element::Type type = Element::QUADRILATERAL;
mesh = Mesh::MakeCartesian2D(ne, ne, type, 1, 1.0, 1.0);
}
else
{
Element::Type type = Element::HEXAHEDRON;
mesh = Mesh::MakeCartesian3D(ne, ne, ne, type, 1.0, 1.0, 1.0);
}
FiniteElementCollection *c_fec = nullptr;
FiniteElementCollection *f_fec = nullptr;
c_fec = new H1_FECollection(order, dimension);
f_fec = new H1_FECollection(order, dimension);
mesh.EnsureNCMesh();
mesh.RandomRefinement(0.5);
const int vdim = (vectorspace == VecSpace::VectorH1) ? dimension : 1;
FiniteElementSpace *c_fespace =
new FiniteElementSpace(&mesh, c_fec, vdim);
FiniteElementSpace *f_fespace =
new FiniteElementSpace(&mesh, f_fec, vdim);
RandomPRefinement(*f_fespace);
const SparseMatrix *Rc = c_fespace->GetRestrictionMatrix();
TrueTransferOperator T(*c_fespace, *f_fespace);
GridFunction xc(c_fespace);
Vector Xc(c_fespace->GetTrueVSize());
Vector Diff(c_fespace->GetTrueVSize());
Vector Yc(c_fespace->GetTrueVSize());
Vector Xf(f_fespace->GetTrueVSize());
Vector Yf(f_fespace->GetTrueVSize());
coeff_order = 2;
BilinearFormIntegrator *massc = nullptr;
BilinearFormIntegrator *massf = nullptr;
if (vectorspace == VecSpace::H1)
{
FunctionCoefficient funcCoeff(&coeff);
xc.ProjectCoefficient(funcCoeff);
massc = new MassIntegrator;
massf = new MassIntegrator;
}
else
{
VectorFunctionCoefficient funcCoeff(dimension, &vectorcoeff);
xc.ProjectCoefficient(funcCoeff);
massc = new VectorMassIntegrator;
massf = new VectorMassIntegrator;
}
if (Rc)
{
Rc->Mult(xc,Xc);
}
else
{
Xc.MakeRef(xc,0);
}
T.Mult(Xc, Xf);
BilinearForm mc(c_fespace);
mc.AddDomainIntegrator(massc);
mc.Assemble();
SparseMatrix Mc;
Array<int> empty;
mc.FormSystemMatrix(empty, Mc);
BilinearForm mf(f_fespace);
mf.AddDomainIntegrator(massf);
mf.Assemble();
SparseMatrix Mf;
mf.FormSystemMatrix(empty, Mf);
Mf.Mult(Xf,Yf);
T.MultTranspose(Yf,Yc);
GSSmoother M(Mc);
Diff = 0.0;
PCG(Mc, M, Yc, Diff, 0, 500, 1e-24, 0.0);
Diff -= Xc;
REQUIRE(Diff.Norml2() < 1e-10);
delete f_fespace;
delete c_fespace;
delete f_fec;
delete c_fec;
}
TEST_CASE("Restriction Transpose Operator")
{
int order = GENERATE(1, 2);
auto mesh_fname = GENERATE("../../data/amr-quad.mesh",
"../../data/fichera-amr.mesh");
Mesh mesh = Mesh::LoadFromFile(mesh_fname);
H1_FECollection fec(order, mesh.Dimension());
FiniteElementSpace fes(&mesh, &fec);
BilinearForm a(&fes);
const Operator *R = fes.GetRestrictionOperator();
const Operator *Rt = fes.GetRestrictionTransposeOperator();
const Operator *Rt_2 = a.GetOutputRestrictionTranspose();
REQUIRE(R);
REQUIRE(Rt);
REQUIRE(Rt_2);
Vector x(R->Height()), y1(R->Width()), y2(Rt->Height()), y3(Rt_2->Height());
x.Randomize(1);
R->MultTranspose(x, y1);
Rt->Mult(x, y2);
Rt_2->Mult(x, y3);
y2 -= y1;
REQUIRE(y2.Normlinf() == MFEM_Approx(0.0));
y3 -= y1;
REQUIRE(y3.Normlinf() == MFEM_Approx(0.0));
}
#ifdef MFEM_USE_MPI
TEST_CASE("Parallel Transfer", "[Transfer][Parallel]")
{
auto simplex = GENERATE(true, false);
auto geometric = GENERATE(true, false);
dimension = GENERATE(2, 3);
int ne = 4;
int order = 2;
int fineOrder = geometric ? order : 2 * order;
int num_procs, myid;
MPI_Comm_size(MPI_COMM_WORLD, &num_procs);
MPI_Comm_rank(MPI_COMM_WORLD, &myid);
// Log test case information
int total_ne = static_cast<int>(std::pow(ne, dimension));
CAPTURE(dimension, simplex, total_ne, order, fineOrder, geometric);
coeff_order = 1;
Mesh mesh;
if (dimension == 2)
{
Element::Type type = simplex ? Element::TRIANGLE : Element::QUADRILATERAL;
mesh = Mesh::MakeCartesian2D(ne, ne, type, 1, 1.0, 1.0);
}
else
{
Element::Type type = simplex ? Element::TETRAHEDRON : Element::HEXAHEDRON;
mesh = Mesh::MakeCartesian3D(ne, ne, ne, type, 1.0, 1.0, 1.0);
}
Mesh fineMesh(mesh);
if (geometric)
{
fineMesh.UniformRefinement();
}
ParMesh *pmesh = new ParMesh(MPI_COMM_WORLD, mesh);
ParMesh pfineMesh(MPI_COMM_WORLD, mesh);
if (geometric)
{
pfineMesh.UniformRefinement();
}
FiniteElementCollection *c_h1_fec =
new H1_FECollection(order, dimension);
FiniteElementCollection *f_h1_fec = geometric ? c_h1_fec : new
H1_FECollection(fineOrder, dimension);
constexpr int vdim = 1;
double referenceRestrictionValue = 0.0;
// Compute reference values in serial
{
FiniteElementSpace* c_h1_fespace = new FiniteElementSpace(&mesh, c_h1_fec,
vdim);
FiniteElementSpace* f_h1_fespace = new FiniteElementSpace(&fineMesh,
f_h1_fec, vdim);
Operator* transferOperator = new TransferOperator(*c_h1_fespace,
*f_h1_fespace);
GridFunction X(c_h1_fespace);
GridFunction Y(f_h1_fespace);
FunctionCoefficient funcCoeff(&coeff);
Y.ProjectCoefficient(funcCoeff);
X = 0.0;
transferOperator->MultTranspose(Y, X);
referenceRestrictionValue = std::sqrt(InnerProduct(X, X));
delete transferOperator;
delete f_h1_fespace;
delete c_h1_fespace;
}
ParFiniteElementSpace* c_h1_fespace = new ParFiniteElementSpace(pmesh,
c_h1_fec,
vdim);
ParFiniteElementSpace* f_h1_fespace = new ParFiniteElementSpace(&pfineMesh,
f_h1_fec,
vdim);
Operator* transferOperator = new TrueTransferOperator(*c_h1_fespace,
*f_h1_fespace);
ParGridFunction X(c_h1_fespace);
ParGridFunction Y_exact(f_h1_fespace);
ParGridFunction Y(f_h1_fespace);
FunctionCoefficient funcCoeff(&coeff);
X.ProjectCoefficient(funcCoeff);
Y_exact.ProjectCoefficient(funcCoeff);
Y = 0.0;
Vector X_true(c_h1_fespace->GetTrueVSize());
Vector Y_true(f_h1_fespace->GetTrueVSize());
c_h1_fespace->GetRestrictionMatrix()->Mult(X, X_true);
transferOperator->Mult(X_true, Y_true);
f_h1_fespace->GetProlongationMatrix()->Mult(Y_true, Y);
Y -= Y_exact;
REQUIRE(Y.Norml2() < 1e-12 * Y_exact.Norml2());
f_h1_fespace->GetRestrictionMatrix()->Mult(Y_exact, Y_true);
transferOperator->MultTranspose(Y_true, X_true);
double restrictionValue = std::sqrt(InnerProduct(MPI_COMM_WORLD, X_true,
X_true));
REQUIRE(std::abs(restrictionValue - referenceRestrictionValue) < 1e-12 *
std::abs(referenceRestrictionValue));
delete transferOperator;
delete f_h1_fespace;
delete c_h1_fespace;
if (!geometric) { delete f_h1_fec; }
delete c_h1_fec;
delete pmesh;
}
#endif