Detailed Description

Data necessary for global equation system assembly.

Base of both bulk mesh and submesh assembly data.

Definition at line 14 of file AssemblyData.h.

#include <AssemblyData.h>

Inheritance diagram for ProcessLib::Assembly::CommonAssemblyData:

Public Member Functions
	CommonAssemblyData (std::vector< std::vector< std::reference_wrapper< MeshLib::PropertyVector< double > > > > &&residuum_vectors)
std::shared_ptr< std::vector< std::size_t > const >	activeElementIDsSorted (std::vector< std::size_t > const *const sorted_element_subset) const
virtual	~CommonAssemblyData ()=default

Public Attributes
std::vector< std::vector< std::reference_wrapper< MeshLib::PropertyVector< double > > > >	residuum_vectors
	Residuum vectors for each process ID.

Protected Member Functions
bool	areAllElementsActive () const

Protected Attributes
std::shared_ptr< std::vector< std::size_t > const >	sorted_active_element_ids_

Constructor & Destructor Documentation

◆ CommonAssemblyData()

ProcessLib::Assembly::CommonAssemblyData::CommonAssemblyData ( std::vector< std::vector< std::reference_wrapper< MeshLib::PropertyVector< double > > > > && residuum_vectors )

inlineexplicit

Definition at line 16 of file AssemblyData.h.

        : residuum_vectors{std::move(residuum_vectors)}
    {
    }

References residuum_vectors.

Referenced by ProcessLib::Assembly::SubmeshAssemblyData::SubmeshAssemblyData().

◆ ~CommonAssemblyData()

virtual ProcessLib::Assembly::CommonAssemblyData::~CommonAssemblyData ( )

virtualdefault

Member Function Documentation

◆ activeElementIDsSorted()

std::shared_ptr< std::vector< std::size_t > const > ProcessLib::Assembly::CommonAssemblyData::activeElementIDsSorted ( std::vector< std::size_t > const *const sorted_element_subset ) const

Returns active element ids.

Precondition: setAllElementsActive() or setElementSelectionActive() must have been called before.

If sorted_element_subset is not nullptr, only the intersection between the previously set values and sorted_element_subset is returned. sorted_element_subset must be sorted in ascending order in that case. At the moment (Nov 2025) this is used for assembly optimizations in the HeatTransportBHE process.

Returns: The returned range of element IDs is sorted in ascending order. (NOTE: That's specified for std::ranges::set_intersection only, I hope it is true for range-v3, too.) If this method returns nullptr it means that all elements are active.

Definition at line 13 of file AssemblyData.cpp.

{
    if (!sorted_element_subset)
    {
        return sorted_active_element_ids_;
    }
 
    assert(ranges::is_sorted(*sorted_element_subset));
 
    if (areAllElementsActive())
    {
        // We do not own sorted_element_subset, so the returned data must not be
        // deleted by us.
        auto do_not_delete = [](auto*) {};
        return {sorted_element_subset, do_not_delete};
    }
 
    // Final case: there are both some deactivated elements and a further
    // subselection by sorted_element_subset.
 
    // TODO frequent re-computations might occur here. Optimization potential.
    auto aeis = std::make_shared<std::vector<std::size_t>>();
    aeis->reserve(std::min(sorted_active_element_ids_->size(),
                           sorted_element_subset->size()));
 
    ranges::set_intersection(*sorted_active_element_ids_,
                             *sorted_element_subset, std::back_inserter(*aeis));
    return aeis;
}

References areAllElementsActive(), and sorted_active_element_ids_.

Referenced by ProcessLib::AssemblyMixin< Process >::assembleOnBulkMeshOrOnSubmeshCommon(), and ProcessLib::AssemblyMixin< Process >::assembleWithJacobianOnBulkMeshOrOnSubmeshCommon().

◆ areAllElementsActive()

bool ProcessLib::Assembly::CommonAssemblyData::areAllElementsActive ( ) const

inlineprotected

Definition at line 53 of file AssemblyData.h.

    {
        return sorted_active_element_ids_ == nullptr;
    }

References sorted_active_element_ids_.

Referenced by activeElementIDsSorted().

Member Data Documentation

◆ residuum_vectors

std::vector< std::vector<std::reference_wrapper<MeshLib::PropertyVector<double> > > > ProcessLib::Assembly::CommonAssemblyData::residuum_vectors

Residuum vectors for each process ID.

Definition at line 48 of file AssemblyData.h.

Referenced by CommonAssemblyData(), ProcessLib::Assembly::SubmeshAssemblyData::SubmeshAssemblyData(), and ProcessLib::AssemblyMixinBase::copyResiduumVectorsToSubmesh().

◆ sorted_active_element_ids_

std::shared_ptr<std::vector<std::size_t> const> ProcessLib::Assembly::CommonAssemblyData::sorted_active_element_ids_

protected

Definition at line 60 of file AssemblyData.h.

Referenced by activeElementIDsSorted(), areAllElementsActive(), ProcessLib::Assembly::BulkMeshAssemblyData::setAllElementsActive(), ProcessLib::Assembly::SubmeshAssemblyData::setAllElementsActive(), ProcessLib::Assembly::BulkMeshAssemblyData::setElementSelectionActive(), and ProcessLib::Assembly::SubmeshAssemblyData::setElementSelectionActive().

The documentation for this struct was generated from the following files: