![]() |
MFEM v4.10.0
Finite element discretization library
|
#include <complex_fem.hpp>
Public Member Functions | |
| ComplexGridFunction (FiniteElementSpace *f) | |
| Construct a ComplexGridFunction associated with the FiniteElementSpace *f. | |
| ComplexGridFunction (Mesh *m, std::istream &input) | |
| Construct a ComplexGridFunction on the given Mesh, using the data from input. | |
| void | Update () |
| long | GetSequence () const |
| void | MakeOwner (FiniteElementCollection *fec_) |
| Make the ComplexGridFunction the owner of fec_owned and fes. | |
| FiniteElementCollection * | OwnFEC () |
| int | VectorDim () const |
| ComplexGridFunction & | operator= (const ComplexGridFunction &rhs) |
| Copy assignment. Only the data of the base class Vector is copied. | |
| ComplexGridFunction & | operator= (const Vector &v) |
| Copy the data from v. | |
| ComplexGridFunction & | operator= (const std::complex< real_t > &value) |
| Assign constant values to the ComplexGridFunction data. | |
| virtual void | ProjectCoefficient (Coefficient &real_coeff, Coefficient &imag_coeff) |
| virtual void | ProjectCoefficient (VectorCoefficient &real_vcoeff, VectorCoefficient &imag_vcoeff) |
| virtual void | ProjectBdrCoefficient (Coefficient &real_coeff, Coefficient &imag_coeff, Array< int > &attr) |
| virtual void | ProjectBdrCoefficientNormal (VectorCoefficient &real_coeff, VectorCoefficient &imag_coeff, Array< int > &attr) |
| virtual void | ProjectBdrCoefficientTangent (VectorCoefficient &real_coeff, VectorCoefficient &imag_coeff, Array< int > &attr) |
| FiniteElementSpace * | FESpace () |
| const FiniteElementSpace * | FESpace () const |
| GridFunction & | real () |
| GridFunction & | imag () |
| const GridFunction & | real () const |
| const GridFunction & | imag () const |
| void | Sync () |
| void | SyncAlias () |
| virtual real_t | ComputeL2Error (Coefficient &exsolr, Coefficient &exsoli, const IntegrationRule *irs[]=NULL) const |
| Returns ||u_ex - u_h||_L2 for complex-valued scalar fields. | |
| virtual real_t | ComputeL2Error (VectorCoefficient &exsolr, VectorCoefficient &exsoli, const IntegrationRule *irs[]=NULL, Array< int > *elems=NULL) const |
| Returns ||u_ex - u_h||_L2 for complex-valued vector fields. | |
| virtual real_t | ComputeMaxError (Coefficient &exsolr, Coefficient &exsoli, const IntegrationRule *irs[]=NULL) const |
| Returns Max|u_ex - u_h| error for complex-valued H1 or L2 elements. | |
| virtual real_t | ComputeLpError (const real_t p, Coefficient &exsolr, Coefficient &exsoli, Coefficient *weight=NULL, const IntegrationRule *irs[]=NULL, const Array< int > *elems=NULL) const |
| Returns ||u_ex - u_h||_Lp for complex-valued H1 or L2 elements. | |
| virtual void | Save (std::ostream &out) const |
| Save the ComplexGridFunction to an output stream. | |
| virtual void | Save (const char *fname, int precision=16) const |
| Save the ComplexGridFunction to a file. | |
| virtual | ~ComplexGridFunction () |
| Destroys the grid function. | |
Public Member Functions inherited from mfem::Vector | |
| Vector () | |
| Vector (const Vector &) | |
| Copy constructor. Allocates a new data array and copies the data. | |
| Vector (Vector &&v) | |
| Move constructor. "Steals" data from its argument. | |
| Vector (int s) | |
| Creates vector of size s. | |
| Vector (real_t *data_, int size_) | |
| Creates a vector referencing an array of doubles, owned by someone else. | |
| Vector (Vector &base, int base_offset, int size_) | |
| Create a Vector referencing a sub-vector of the Vector base starting at the given offset, base_offset, and size size_. | |
| Vector (int size_, MemoryType mt) | |
| Create a Vector of size size_ using MemoryType mt. | |
| Vector (int size_, MemoryType h_mt, MemoryType d_mt) | |
| Create a Vector of size size_ using host MemoryType h_mt and device MemoryType d_mt. | |
| template<typename CT , int N> | |
| Vector (const CT(&values)[N]) | |
| Create a vector from a statically sized C-style array of convertible type. | |
| template<typename CT , typename std::enable_if< std::is_convertible< CT, real_t >::value, bool >::type = true> | |
| Vector (std::initializer_list< CT > values) | |
| Create a vector using a braced initializer list. | |
| virtual void | UseDevice (bool use_dev) const |
| Enable execution of Vector operations using the mfem::Device. | |
| virtual bool | UseDevice () const |
| Return the device flag of the Memory object used by the Vector. | |
| void | Load (std::istream **in, int np, int *dim) |
| Reads a vector from multiple files. | |
| void | Load (std::istream &in, int Size) |
| Load a vector from an input stream. | |
| void | Load (std::istream &in) |
| Load a vector from an input stream, reading the size from the stream. | |
| void | SetSize (int s) |
| Resize the vector to size s. | |
| void | SetSize (int s, MemoryType mt) |
| Resize the vector to size s using MemoryType mt. | |
| void | SetSize (int s, const Vector &v) |
| Resize the vector to size s using the MemoryType of v. | |
| void | Reserve (int res) |
| Update Capacity() to res (if less than current), keeping existing entries. | |
| void | DeleteAt (const Array< int > &indices) |
| void | SetData (real_t *d) |
| void | SetDataAndSize (real_t *d, int s) |
| Set the Vector data and size. | |
| void | NewDataAndSize (real_t *d, int s) |
| Set the Vector data and size, deleting the old data, if owned. | |
| void | NewMemoryAndSize (const Memory< real_t > &mem, int s, bool own_mem) |
| Reset the Vector to use the given external Memory mem and size s. | |
| void | MakeRef (Vector &base, int offset, int size) |
| Reset the Vector to be a reference to a sub-vector of base. | |
| void | MakeRef (Vector &base, int offset) |
| Reset the Vector to be a reference to a sub-vector of base without changing its current size. | |
| void | MakeDataOwner () const |
| Set the Vector data (host pointer) ownership flag. | |
| void | Destroy () |
| Destroy a vector. | |
| void | DeleteDevice (bool copy_to_host=true) |
| Delete the device pointer, if owned. If copy_to_host is true and the data is valid only on device, move it to host before deleting. Invalidates the device memory. | |
| int | Size () const |
| Returns the size of the vector. | |
| int | Capacity () const |
| Return the size of the currently allocated data array. | |
| real_t * | GetData () const |
| Return a pointer to the beginning of the Vector data. | |
| MFEM_DEPRECATED | operator real_t * () |
Conversion to double *. Deprecated. | |
| MFEM_DEPRECATED | operator const real_t * () const |
Conversion to const double *. Deprecated. | |
| real_t * | begin () |
| STL-like begin. | |
| real_t * | end () |
| STL-like end. | |
| const real_t * | begin () const |
| STL-like begin (const version). | |
| const real_t * | end () const |
| STL-like end (const version). | |
| Memory< real_t > & | GetMemory () |
| Return a reference to the Memory object used by the Vector. | |
| const Memory< real_t > & | GetMemory () const |
| Return a reference to the Memory object used by the Vector, const version. | |
| void | SyncMemory (const Vector &v) const |
| Update the memory location of the vector to match v. | |
| void | SyncAliasMemory (const Vector &v) const |
| Update the alias memory location of the vector to match v. | |
| bool | OwnsData () const |
| Read the Vector data (host pointer) ownership flag. | |
| void | StealData (real_t **p) |
| Changes the ownership of the data; after the call the Vector is empty. | |
| real_t * | StealData () |
| Changes the ownership of the data; after the call the Vector is empty. | |
| real_t & | Elem (int i) |
| Access Vector entries. Index i = 0 .. size-1. | |
| const real_t & | Elem (int i) const |
| Read only access to Vector entries. Index i = 0 .. size-1. | |
| real_t & | operator() (int i) |
| Access Vector entries using () for 0-based indexing. | |
| const real_t & | operator() (int i) const |
| Read only access to Vector entries using () for 0-based indexing. | |
| real_t & | operator[] (int i) |
| Access Vector entries using [] for 0-based indexing. | |
| const real_t & | operator[] (int i) const |
| Read only access to Vector entries using [] for 0-based indexing. | |
| real_t | operator* (const real_t *v) const |
| real_t | operator* (const Vector &v) const |
| Return the inner-product. | |
| Vector & | operator= (const real_t *v) |
| Copy Size() entries from v. | |
| Vector & | operator= (const Vector &v) |
| Copy assignment. | |
| Vector & | operator= (Vector &&v) |
| Move assignment. | |
| Vector & | operator= (real_t value) |
| Redefine '=' for vector = constant. | |
| Vector & | operator*= (real_t c) |
| Vector & | operator*= (const Vector &v) |
| Component-wise scaling: (*this)(i) *= v(i) | |
| Vector & | operator/= (real_t c) |
| Vector & | operator/= (const Vector &v) |
| Component-wise division: (*this)(i) /= v(i) | |
| Vector & | operator-= (real_t c) |
| Vector & | operator-= (const Vector &v) |
| Vector & | operator+= (real_t c) |
| Vector & | operator+= (const Vector &v) |
| Vector & | Add (const real_t a, const Vector &Va) |
| (*this) += a * Va | |
| Vector & | Set (const real_t a, const Vector &x) |
| (*this) = a * x | |
| void | SetVector (const Vector &v, int offset) |
| (*this)[i + offset] = v[i] | |
| void | AddSubVector (const Vector &v, int offset) |
| (*this)[i + offset] += v[i] | |
| void | Neg () |
| (*this) = -(*this) | |
| void | Reciprocal () |
| (*this)(i) = 1.0 / (*this)(i) | |
| void | Abs () |
| (*this)(i) = abs((*this)(i)) | |
| void | Pow (const real_t p) |
| (*this)(i) = pow((*this)(i), p) | |
| void | Swap (Vector &other) |
| Swap the contents of two Vectors. | |
| void | cross3D (const Vector &vin, Vector &vout) const |
| void | median (const Vector &lo, const Vector &hi) |
| v = median(v,lo,hi) entrywise. Implementation assumes lo <= hi. | |
| void | GetSubVector (const Array< int > &dofs, Vector &elemvect) const |
| Extract entries listed in dofs to the output Vector elemvect. | |
| void | GetSubVector (const Array< int > &dofs, real_t *elem_data) const |
| Extract entries listed in dofs to the output array elem_data. | |
| void | SetSubVector (const Array< int > &dofs, const real_t value) |
| Set the entries listed in dofs to the given value. | |
| void | SetSubVectorHost (const Array< int > &dofs, const real_t value) |
| Set the entries listed in dofs to the given value (always on host). | |
| void | SetSubVector (const Array< int > &dofs, const Vector &elemvect) |
| Set the entries listed in dofs to the values given in the elemvect Vector. Negative dof values cause the -dof-1 position in this Vector to receive the -val from elemvect. | |
| void | SetSubVector (const Array< int > &dofs, real_t *elem_data) |
| Set the entries listed in dofs to the values given the , elem_data array. Negative dof values cause the -dof-1 position in this Vector to receive the -val from elem_data. | |
| void | AddElementVector (const Array< int > &dofs, const Vector &elemvect) |
| Add elements of the elemvect Vector to the entries listed in dofs. Negative dof values cause the -dof-1 position in this Vector to add the -val from elemvect. | |
| void | AddElementVector (const Array< int > &dofs, real_t *elem_data) |
| Add elements of the elem_data array to the entries listed in dofs. Negative dof values cause the -dof-1 position in this Vector to add the -val from elem_data. | |
| void | AddElementVector (const Array< int > &dofs, const real_t a, const Vector &elemvect) |
| Add times the elements of the elemvect Vector to the entries listed in dofs. Negative dof values cause the -dof-1 position in this Vector to add the -a*val from elemvect. | |
| void | SetSubVectorComplement (const Array< int > &dofs, const real_t val) |
| Set all vector entries NOT in the dofs Array to the given val. | |
| void | Print (std::ostream &out=mfem::out, int width=8) const |
| Prints vector to stream out. | |
| void | Print (adios2stream &out, const std::string &variable_name) const |
| void | Print_HYPRE (std::ostream &out) const |
| Prints vector to stream out in HYPRE_Vector format. | |
| void | PrintMathematica (std::ostream &out=mfem::out) const |
| Prints vector as a List for importing into Mathematica. | |
| void | PrintHash (std::ostream &out) const |
| Print the Vector size and hash of its data. | |
| void | Randomize (int seed=0) |
| Set random values in the vector. | |
| real_t | Norml2 () const |
| Returns the l2 norm of the vector. | |
| real_t | Normlinf () const |
| Returns the l_infinity norm of the vector. | |
| real_t | Norml1 () const |
| Returns the l_1 norm of the vector. | |
| real_t | Normlp (real_t p) const |
| Returns the l_p norm of the vector. | |
| real_t | Max () const |
| Returns the maximal element of the vector. | |
| real_t | Min () const |
| Returns the minimal element of the vector. | |
| real_t | Sum () const |
| Return the sum of the vector entries. | |
| real_t | DistanceSquaredTo (const real_t *p) const |
| Compute the square of the Euclidean distance to another vector. | |
| real_t | DistanceSquaredTo (const Vector &p) const |
| Compute the square of the Euclidean distance to another vector. | |
| real_t | DistanceTo (const real_t *p) const |
| Compute the Euclidean distance to another vector. | |
| real_t | DistanceTo (const Vector &p) const |
| Compute the Euclidean distance to another vector. | |
| int | CheckFinite () const |
| Count the number of entries in the Vector for which isfinite is false, i.e. the entry is a NaN or +/-Inf. | |
| virtual | ~Vector () |
| Destroys vector. | |
| virtual const real_t * | Read (bool on_dev=true) const |
| Shortcut for mfem::Read(vec.GetMemory(), vec.Size(), on_dev). | |
| virtual const real_t * | HostRead () const |
| Shortcut for mfem::Read(vec.GetMemory(), vec.Size(), false). | |
| virtual real_t * | Write (bool on_dev=true) |
| Shortcut for mfem::Write(vec.GetMemory(), vec.Size(), on_dev). | |
| virtual real_t * | HostWrite () |
| Shortcut for mfem::Write(vec.GetMemory(), vec.Size(), false). | |
| virtual real_t * | ReadWrite (bool on_dev=true) |
| Shortcut for mfem::ReadWrite(vec.GetMemory(), vec.Size(), on_dev). | |
| virtual real_t * | HostReadWrite () |
| Shortcut for mfem::ReadWrite(vec.GetMemory(), vec.Size(), false). | |
| MemoryView< Array< real_t > > | GetArrayView () |
| Create a mutable (non-const) view of the Vector as Array<real_t> that can be used to pass Vector objects to functions that take Array arguments. | |
| MemoryView< const Array< real_t > > | GetArrayView () const |
| Create a const view of the Vector as const Array<real_t> that can be used to pass Vector objects to functions that take Array arguments. | |
Protected Member Functions | |
| void | Destroy () |
Protected Attributes | |
| FiniteElementSpace * | fes |
| FiniteElementCollection * | fec_owned |
| Used when the grid function is read from a file. It can also be set explicitly, see MakeOwner(). | |
| long | fes_sequence |
Protected Attributes inherited from mfem::Vector | |
| Memory< real_t > | data |
| int | size |
Class for complex-valued grid function - real + imaginary part Vector with associated FE space.
Definition at line 31 of file complex_fem.hpp.
| mfem::ComplexGridFunction::ComplexGridFunction | ( | FiniteElementSpace * | f | ) |
Construct a ComplexGridFunction associated with the FiniteElementSpace *f.
Definition at line 21 of file complex_fem.cpp.
| mfem::ComplexGridFunction::ComplexGridFunction | ( | Mesh * | m, |
| std::istream & | input ) |
Construct a ComplexGridFunction on the given Mesh, using the data from input.
The content of input should be in the format created by the method Save(). The reconstructed FiniteElementSpace and FiniteElementCollection are owned by the ComplexGridFunction.
Definition at line 36 of file complex_fem.cpp.
|
inlinevirtual |
Destroys the grid function.
Definition at line 246 of file complex_fem.hpp.
|
inlinevirtual |
Returns ||u_ex - u_h||_L2 for complex-valued scalar fields.
Definition at line 145 of file complex_fem.hpp.
|
inlinevirtual |
Returns ||u_ex - u_h||_L2 for complex-valued vector fields.
Definition at line 159 of file complex_fem.hpp.
|
virtual |
Returns ||u_ex - u_h||_Lp for complex-valued H1 or L2 elements.
Computes:
\[(\sum_{elems} \int_{elem} w \, |u_{ex} - u_h|^p)^{1/p}\]
Where:
\[|u_{ex} - u_h| = \sqrt{Re(u_{ex} - u_h)^2 + Im(u_{ex} - u_h)^2}\]
| [in] | p | Real value indicating the exponent of the \(L^p\) norm. To avoid domain errors p should have a positive value, either finite or infinite. |
| [in] | exsolr | Coefficient object reproducing the real part of the anticipated values of the scalar field, Re(u_ex). |
| [in] | exsoli | Coefficient object reproducing the imaginary part of the anticipated values of the scalar field, Im(u_ex). |
| [in] | weight | Optional pointer to a Coefficient object reproducing a weighting function, w. |
| [in] | irs | Optional pointer to an array of custom integration rules e.g. higher order than the default rules. If present the array will be indexed by Geometry::Type. |
| [in] | elems | Optional pointer to a marker array, with a length equal to the number of local elements, indicating which elements to integrate over. Only those elements corresponding to non-zero entries in elems will contribute to the computed L2 error. |
Definition at line 241 of file complex_fem.cpp.
|
inlinevirtual |
Returns Max|u_ex - u_h| error for complex-valued H1 or L2 elements.
Compute the \(L_\infty\) error across the entire domain.
| [in] | exsolr | Coefficient object reproducing the real part of the anticipated values of the scalar field, Re(u_ex). |
| [in] | exsoli | Coefficient object reproducing the imaginary part of the anticipated values of the scalar field, Im(u_ex). |
| [in] | irs | Optional pointer to an array of custom integration rules e.g. higher order than the default rules. If present the array will be indexed by Geometry::Type. |
Definition at line 189 of file complex_fem.hpp.
|
protected |
Definition at line 93 of file complex_fem.cpp.
|
inline |
Definition at line 123 of file complex_fem.hpp.
|
inline |
Definition at line 124 of file complex_fem.hpp.
|
inline |
Return update counter, similar to Mesh::GetSequence(). Used to check if it is up to date with the space.
Definition at line 69 of file complex_fem.hpp.
|
inline |
Definition at line 127 of file complex_fem.hpp.
|
inline |
Definition at line 129 of file complex_fem.hpp.
|
inline |
Make the ComplexGridFunction the owner of fec_owned and fes.
If the new FiniteElementCollection, fec_, is NULL, ownership of fec_owned and fes is taken away.
Definition at line 74 of file complex_fem.hpp.
|
inline |
Copy assignment. Only the data of the base class Vector is copied.
It is assumed that this object and rhs use FiniteElementSpaces that have the same size.
Definition at line 91 of file complex_fem.hpp.
|
inline |
Assign constant values to the ComplexGridFunction data.
Definition at line 105 of file complex_fem.hpp.
|
inline |
Copy the data from v.
The size of v must be equal to double of the size of the associated FiniteElementSpace fes.
Definition at line 97 of file complex_fem.hpp.
|
inline |
Returns a pointer to the FiniteElementCollection used to construct this ComplexGridFunction if this class owns that object. Otherwise this function will return NULL.
Definition at line 79 of file complex_fem.hpp.
|
virtual |
Definition at line 200 of file complex_fem.cpp.
|
virtual |
Definition at line 213 of file complex_fem.cpp.
|
virtual |
Definition at line 226 of file complex_fem.cpp.
|
virtual |
Definition at line 176 of file complex_fem.cpp.
|
virtual |
Definition at line 188 of file complex_fem.cpp.
|
inline |
Definition at line 126 of file complex_fem.hpp.
|
inline |
Definition at line 128 of file complex_fem.hpp.
|
virtual |
Save the ComplexGridFunction to a file.
The given precision will be used for ASCII output.
Definition at line 331 of file complex_fem.cpp.
|
virtual |
Save the ComplexGridFunction to an output stream.
Definition at line 315 of file complex_fem.cpp.
|
inline |
Update the memory location of the real and imaginary GridFunction gfr and gfi to match the ComplexGridFunction.
Definition at line 133 of file complex_fem.hpp.
|
inline |
Update the alias memory location of the real and imaginary GridFunction gfr and gfi to match the ComplexGridFunction.
Definition at line 137 of file complex_fem.hpp.
| void mfem::ComplexGridFunction::Update | ( | ) |
Definition at line 106 of file complex_fem.cpp.
| int mfem::ComplexGridFunction::VectorDim | ( | ) | const |
Shortcut for calling FiniteElementSpace::GetVectorDim() on the underlying fes
Definition at line 164 of file complex_fem.cpp.
|
protected |
Used when the grid function is read from a file. It can also be set explicitly, see MakeOwner().
If not NULL, this pointer is owned by the ComplexGridFunction.
Definition at line 46 of file complex_fem.hpp.
|
protected |
FE space on which the grid function lives. Owned if fec_owned is not NULL.
Definition at line 40 of file complex_fem.hpp.
|
protected |
Definition at line 48 of file complex_fem.hpp.