ProcessLib::WellboreSimulator::WellboreSimulatorProcess Class Reference

Detailed Description

Under the assumptions of the drift-flux model in a geothermal well with a constant cross-sectional area, the transient geo-fluid flow in a two-phase one-component geothermal well can be quantified using one-dimensional formulations of mass, momentum, and energy balance.

Attention

The process is restricted to vertical wells. Gravity enters the balance equations twice, and the two paths do not treat an inclined well consistently:

• The specific body force is projected onto the well axis, so it carries the factor \(\cos\theta\) with the inclination \(\theta\) measured from the vertical.
• The drift-flux closure is not projected. Both its drift flux velocity, MaterialPropertyLib::driftFluxVelocity(), and its profile parameter, MaterialPropertyLib::driftFluxProfileParameter(), are correlations for vertical flow and receive no inclination correction.

A simulation on an inclined mesh therefore combines an inclination-corrected body force with an uncorrected buoyant slip and is incorrect: the axial drift, and with it the void fraction and the phase holdup, are overestimated. The mismatch is worst for a horizontal section, where the body force vanishes while the drift flux velocity keeps its full vertical value. Beyond roughly 70 degrees from the vertical the flow leaves the bubbly and slug regimes the closure is derived for, so an inclination correction alone would not make such a section right either.

Definition at line 44 of file WellboreSimulatorProcess.h.

#include <WellboreSimulatorProcess.h>

Inheritance diagram for ProcessLib::WellboreSimulator::WellboreSimulatorProcess:

Collaboration diagram for ProcessLib::WellboreSimulator::WellboreSimulatorProcess:

Public Member Functions
	WellboreSimulatorProcess (std::string name, MeshLib::Mesh &mesh, std::unique_ptr< ProcessLib::AbstractJacobianAssembler > &&jacobian_assembler, std::vector< std::unique_ptr< ParameterLib::ParameterBase > > const &parameters, unsigned const integration_order, std::vector< std::vector< std::reference_wrapper< ProcessVariable > > > &&process_variables, WellboreSimulatorProcessData &&process_data, SecondaryVariableCollection &&secondary_variables)
ODESystem interface
bool	isLinear () const override
Public Member Functions inherited from ProcessLib::Process
	Process (std::string name_, MeshLib::Mesh &mesh, std::unique_ptr< AbstractJacobianAssembler > &&jacobian_assembler, std::vector< std::unique_ptr< ParameterLib::ParameterBase > > const &parameters, unsigned const integration_order, std::vector< std::vector< std::reference_wrapper< ProcessVariable > > > &&process_variables, SecondaryVariableCollection &&secondary_variables, const bool use_monolithic_scheme=true)
void	preTimestep (std::vector< GlobalVector * > const &x, const double t, const double delta_t, const int process_id)
	Preprocessing before starting assembly for new timestep.
void	postTimestep (std::vector< GlobalVector * > const &x, std::vector< GlobalVector * > const &x_prev, const double t, const double delta_t, int const process_id)
	Postprocessing after a complete timestep.
void	postNonLinearSolver (std::vector< GlobalVector * > const &x, std::vector< GlobalVector * > const &x_prev, const double t, double const dt, int const process_id)
void	preIteration (const unsigned iter, GlobalVector const &x) final
void	computeSecondaryVariable (double const t, double const dt, std::vector< GlobalVector * > const &x, GlobalVector const &x_prev, int const process_id)
	compute secondary variables for the coupled equations or for output.
NumLib::IterationResult	postIteration (GlobalVector const &x) final
void	initialize (std::map< int, std::shared_ptr< MaterialPropertyLib::Medium > > const &media)
void	setInitialConditions (std::vector< GlobalVector * > &process_solutions, std::vector< GlobalVector * > const &process_solutions_prev, double const t, int const process_id)
MathLib::MatrixSpecifications	getMatrixSpecifications (const int process_id) const override
void	updateDeactivatedSubdomains (double const time, const int process_id)
virtual bool	isMonolithicSchemeUsed () const
virtual void	extrapolateIntegrationPointValuesToNodes (const double, std::vector< GlobalVector * > const &, std::vector< GlobalVector * > &)
void	preAssemble (const double t, double const dt, GlobalVector const &x) final
void	assemble (const double t, double const dt, std::vector< GlobalVector * > const &x, std::vector< GlobalVector * > const &x_prev, int const process_id, GlobalMatrix &M, GlobalMatrix &K, GlobalVector &b) final
void	assembleWithJacobian (const double t, double const dt, std::vector< GlobalVector * > const &x, std::vector< GlobalVector * > const &x_prev, int const process_id, GlobalVector &b, GlobalMatrix &Jac) final
void	preOutput (const double t, double const dt, std::vector< GlobalVector * > const &x, std::vector< GlobalVector * > const &x_prev, int const process_id)
std::vector< NumLib::IndexValueVector< GlobalIndexType > > const *	getKnownSolutions (double const t, GlobalVector const &x, int const process_id) const final
virtual NumLib::LocalToGlobalIndexMap const &	getDOFTable (const int) const
MeshLib::Mesh &	getMesh () const
std::vector< std::vector< std::reference_wrapper< ProcessVariable > > > const &	getProcessVariables () const
std::vector< std::reference_wrapper< ProcessVariable > > const &	getProcessVariables (const int process_id) const
std::vector< std::size_t > const &	getActiveElementIDs () const
SecondaryVariableCollection const &	getSecondaryVariables () const
std::vector< std::unique_ptr< MeshLib::IntegrationPointWriter > > const &	getIntegrationPointWriters () const
virtual Eigen::Vector3d	getFlux (std::size_t, MathLib::Point3d const &, double const, std::vector< GlobalVector * > const &) const
virtual void	solveReactionEquation (std::vector< GlobalVector * > &, std::vector< GlobalVector * > const &, double const, double const, NumLib::EquationSystem &, int const)
bool	requiresNormalization () const override
Public Member Functions inherited from ProcessLib::SubmeshAssemblySupport
virtual std::vector< std::vector< std::string > >	initializeAssemblyOnSubmeshes (std::vector< std::reference_wrapper< MeshLib::Mesh > > const &meshes)
virtual	~SubmeshAssemblySupport ()=default

Private Member Functions
void	initializeConcreteProcess (NumLib::LocalToGlobalIndexMap const &dof_table, MeshLib::Mesh const &mesh, unsigned const integration_order) override
	Process specific initialization called by initialize().
void	assembleConcreteProcess (const double t, double const dt, std::vector< GlobalVector * > const &x, std::vector< GlobalVector * > const &x_prev, int const process_id, GlobalMatrix &M, GlobalMatrix &K, GlobalVector &b) override
void	assembleWithJacobianConcreteProcess (const double t, double const dt, std::vector< GlobalVector * > const &x, std::vector< GlobalVector * > const &x_prev, int const process_id, GlobalVector &b, GlobalMatrix &Jac) override
void	computeSecondaryVariableConcrete (double const t, double const dt, std::vector< GlobalVector * > const &x, GlobalVector const &x_prev, int const process_id) override
void	postTimestepConcreteProcess (std::vector< GlobalVector * > const &x, std::vector< GlobalVector * > const &x_prev, const double t, const double dt, int const process_id) override

Private Attributes
WellboreSimulatorProcessData	_process_data
std::vector< std::unique_ptr< WellboreSimulatorLocalAssemblerInterface > >	_local_assemblers

Additional Inherited Members
Public Attributes inherited from ProcessLib::Process
std::string const	name
Static Public Attributes inherited from ProcessLib::Process
static PROCESSLIB_EXPORT const std::string	constant_one_parameter_name = "constant_one"
Protected Member Functions inherited from ProcessLib::Process
std::vector< NumLib::LocalToGlobalIndexMap const * >	getDOFTables (int const number_of_processes) const
NumLib::Extrapolator &	getExtrapolator () const
NumLib::LocalToGlobalIndexMap const &	getSingleComponentDOFTable () const
void	initializeProcessBoundaryConditionsAndSourceTerms (const NumLib::LocalToGlobalIndexMap &dof_table, const int process_id, std::map< int, std::shared_ptr< MaterialPropertyLib::Medium > > const &media)
virtual void	constructDofTable ()
void	constructMonolithicProcessDofTable ()
void	constructDofTableOfSpecifiedProcessStaggeredScheme (const int specified_process_id)
virtual std::tuple< NumLib::LocalToGlobalIndexMap *, bool >	getDOFTableForExtrapolatorData () const
std::vector< GlobalIndexType >	getIndicesOfResiduumWithoutInitialCompensation () const override
void	setReleaseNodalForces (GlobalVector const *r_neq, int const process_id) override
Protected Attributes inherited from ProcessLib::Process
MeshLib::Mesh &	_mesh
std::unique_ptr< MeshLib::MeshSubset const >	_mesh_subset_all_nodes
std::unique_ptr< NumLib::LocalToGlobalIndexMap >	_local_to_global_index_map
SecondaryVariableCollection	_secondary_variables
CellAverageData	cell_average_data_
std::unique_ptr< ProcessLib::AbstractJacobianAssembler >	_jacobian_assembler
VectorMatrixAssembler	_global_assembler
const bool	_use_monolithic_scheme
unsigned const	_integration_order
std::vector< std::unique_ptr< MeshLib::IntegrationPointWriter > >	_integration_point_writer
GlobalSparsityPattern	_sparsity_pattern
std::vector< std::vector< std::reference_wrapper< ProcessVariable > > >	_process_variables
std::vector< BoundaryConditionCollection >	_boundary_conditions

Constructor & Destructor Documentation

WellboreSimulatorProcess()

ProcessLib::WellboreSimulator::WellboreSimulatorProcess::WellboreSimulatorProcess	(	std::string	name,
		MeshLib::Mesh &	mesh,
		std::unique_ptr< ProcessLib::AbstractJacobianAssembler > &&	jacobian_assembler,
		std::vector< std::unique_ptr< ParameterLib::ParameterBase > > const &	parameters,
		unsigned const	integration_order,
		std::vector< std::vector< std::reference_wrapper< ProcessVariable > > > &&	process_variables,
		WellboreSimulatorProcessData &&	process_data,
		SecondaryVariableCollection &&	secondary_variables )

Definition at line 18 of file WellboreSimulatorProcess.cpp.

    : Process(std::move(name), mesh, std::move(jacobian_assembler), parameters,
              integration_order, std::move(process_variables),
              std::move(secondary_variables)),
      _process_data(std::move(process_data))
{
    // For numerical Jacobian
    this->_jacobian_assembler->setNonDeformationComponentIDs(
        {0, 1, 2} /* pressure, Velocity, Enthalpy */);
}

References ProcessLib::Process::Process(), ProcessLib::Process::_jacobian_assembler, _process_data, and ProcessLib::Process::name.

Member Function Documentation

assembleConcreteProcess()

void ProcessLib::WellboreSimulator::WellboreSimulatorProcess::assembleConcreteProcess ( const double t, double const dt, std::vector< GlobalVector * > const & x, std::vector< GlobalVector * > const & x_prev, int const process_id, GlobalMatrix & M, GlobalMatrix & K, GlobalVector & b )

overrideprivatevirtual

Implements ProcessLib::Process.

Definition at line 84 of file WellboreSimulatorProcess.cpp.

{
    DBUG("Assemble WellboreSimulator Process.");
 
    std::vector<NumLib::LocalToGlobalIndexMap const*> dof_tables;
 
    dof_tables.emplace_back(_local_to_global_index_map.get());
 
    // Call global assembler for each local assembly item.
    GlobalExecutor::executeSelectedMemberDereferenced(
        _global_assembler, &VectorMatrixAssembler::assemble, _local_assemblers,
        getActiveElementIDs(), dof_tables, t, dt, x, x_prev, process_id, &M, &K,
        &b);
}

References ProcessLib::Process::_global_assembler, _local_assemblers, ProcessLib::Process::_local_to_global_index_map, ProcessLib::VectorMatrixAssembler::assemble(), DBUG(), NumLib::SerialExecutor::executeSelectedMemberDereferenced(), and ProcessLib::Process::getActiveElementIDs().

assembleWithJacobianConcreteProcess()

void ProcessLib::WellboreSimulator::WellboreSimulatorProcess::assembleWithJacobianConcreteProcess ( const double t, double const dt, std::vector< GlobalVector * > const & x, std::vector< GlobalVector * > const & x_prev, int const process_id, GlobalVector & b, GlobalMatrix & Jac )

overrideprivatevirtual

Implements ProcessLib::Process.

Definition at line 102 of file WellboreSimulatorProcess.cpp.

{
    DBUG("AssembleWithJacobian WellboreSimulator Process.");
 
    std::vector<NumLib::LocalToGlobalIndexMap const*> dof_tables;
 
    dof_tables.emplace_back(_local_to_global_index_map.get());
 
    // Call global assembler for each local assembly item.
    GlobalExecutor::executeSelectedMemberDereferenced(
        _global_assembler, &VectorMatrixAssembler::assembleWithJacobian,
        _local_assemblers, getActiveElementIDs(), dof_tables, t, dt, x, x_prev,
        process_id, &b, &Jac);
}

References ProcessLib::Process::_global_assembler, _local_assemblers, ProcessLib::Process::_local_to_global_index_map, ProcessLib::VectorMatrixAssembler::assembleWithJacobian(), DBUG(), NumLib::SerialExecutor::executeSelectedMemberDereferenced(), and ProcessLib::Process::getActiveElementIDs().

computeSecondaryVariableConcrete()

void ProcessLib::WellboreSimulator::WellboreSimulatorProcess::computeSecondaryVariableConcrete ( double const t, double const dt, std::vector< GlobalVector * > const & x, GlobalVector const & x_prev, int const process_id )

overrideprivatevirtual

Reimplemented from ProcessLib::Process.

Definition at line 120 of file WellboreSimulatorProcess.cpp.

{
    std::vector<NumLib::LocalToGlobalIndexMap const*> dof_tables;
    dof_tables.reserve(x.size());
    dof_tables.push_back(_local_to_global_index_map.get());
 
    GlobalExecutor::executeSelectedMemberOnDereferenced(
        &WellboreSimulatorLocalAssemblerInterface::computeSecondaryVariable,
        _local_assemblers, getActiveElementIDs(), dof_tables, t, dt, x, x_prev,
        process_id);
}

References _local_assemblers, ProcessLib::Process::_local_to_global_index_map, ProcessLib::LocalAssemblerInterface::computeSecondaryVariable(), NumLib::SerialExecutor::executeSelectedMemberOnDereferenced(), and ProcessLib::Process::getActiveElementIDs().

initializeConcreteProcess()

void ProcessLib::WellboreSimulator::WellboreSimulatorProcess::initializeConcreteProcess ( NumLib::LocalToGlobalIndexMap const & dof_table, MeshLib::Mesh const & mesh, unsigned const integration_order )

overrideprivatevirtual

Process specific initialization called by initialize().

Implements ProcessLib::Process.

Definition at line 38 of file WellboreSimulatorProcess.cpp.

{
    ProcessLib::createLocalAssemblers<1, WellboreSimulatorFEM>(
        mesh.getElements(), dof_table, _local_assemblers,
        NumLib::IntegrationOrder{integration_order}, mesh.isAxiallySymmetric(),
        _process_data);
 
    auto add_secondary_variable = [&](std::string const& name,
                                      int const num_components,
                                      auto get_ip_values_function)
    {
        _secondary_variables.addSecondaryVariable(
            name,
            makeExtrapolator(num_components, getExtrapolator(),
                             _local_assemblers,
                             std::move(get_ip_values_function)));
    };
 
    add_secondary_variable(
        "vapor_mass_flow_rate", 1,
        &WellboreSimulatorLocalAssemblerInterface::getIntPtVaporMassFlowRate);
 
    add_secondary_variable(
        "liquid_mass_flow_rate", 1,
        &WellboreSimulatorLocalAssemblerInterface::getIntPtLiquidMassFlowRate);
 
    add_secondary_variable(
        "temperature", 1,
        &WellboreSimulatorLocalAssemblerInterface::getIntPtTemperature);
 
    add_secondary_variable(
        "dryness", 1,
        &WellboreSimulatorLocalAssemblerInterface::getIntPtDryness);
 
    add_secondary_variable(
        "vapor_volume_fraction", 1,
        &WellboreSimulatorLocalAssemblerInterface::getIntPtVaporVolumeFraction);
 
    _process_data.mesh_prop_density = MeshLib::getOrCreateMeshProperty<double>(
        const_cast<MeshLib::Mesh&>(mesh), "mix_density",
        MeshLib::MeshItemType::Cell, 1);
}

References _local_assemblers, _process_data, ProcessLib::Process::_secondary_variables, MeshLib::Cell, ProcessLib::createLocalAssemblers(), MeshLib::Mesh::getElements(), ProcessLib::Process::getExtrapolator(), ProcessLib::WellboreSimulator::WellboreSimulatorLocalAssemblerInterface::getIntPtDryness(), ProcessLib::WellboreSimulator::WellboreSimulatorLocalAssemblerInterface::getIntPtLiquidMassFlowRate(), ProcessLib::WellboreSimulator::WellboreSimulatorLocalAssemblerInterface::getIntPtTemperature(), ProcessLib::WellboreSimulator::WellboreSimulatorLocalAssemblerInterface::getIntPtVaporMassFlowRate(), ProcessLib::WellboreSimulator::WellboreSimulatorLocalAssemblerInterface::getIntPtVaporVolumeFraction(), MeshLib::getOrCreateMeshProperty(), MeshLib::Mesh::isAxiallySymmetric(), ProcessLib::makeExtrapolator(), and ProcessLib::Process::name.

isLinear()

bool ProcessLib::WellboreSimulator::WellboreSimulatorProcess::isLinear ( ) const

inlineoverride

Definition at line 62 of file WellboreSimulatorProcess.h.

{ return false; }

postTimestepConcreteProcess()

void ProcessLib::WellboreSimulator::WellboreSimulatorProcess::postTimestepConcreteProcess ( std::vector< GlobalVector * > const & x, std::vector< GlobalVector * > const & x_prev, const double t, const double dt, int const process_id )

overrideprivatevirtual

Reimplemented from ProcessLib::Process.

Definition at line 137 of file WellboreSimulatorProcess.cpp.

{
    std::vector<NumLib::LocalToGlobalIndexMap const*> dof_tables;
    dof_tables.reserve(x.size());
    dof_tables.push_back(_local_to_global_index_map.get());
 
    GlobalExecutor::executeSelectedMemberOnDereferenced(
        &WellboreSimulatorLocalAssemblerInterface::postTimestep,
        _local_assemblers, getActiveElementIDs(), dof_tables, x, x_prev, t, dt,
        process_id);
}

References _local_assemblers, ProcessLib::Process::_local_to_global_index_map, NumLib::SerialExecutor::executeSelectedMemberOnDereferenced(), ProcessLib::Process::getActiveElementIDs(), and ProcessLib::LocalAssemblerInterface::postTimestep().

Member Data Documentation

_local_assemblers

std::vector<std::unique_ptr<WellboreSimulatorLocalAssemblerInterface> > ProcessLib::WellboreSimulator::WellboreSimulatorProcess::_local_assemblers

private

Definition at line 85 of file WellboreSimulatorProcess.h.

Referenced by assembleConcreteProcess(), assembleWithJacobianConcreteProcess(), computeSecondaryVariableConcrete(), initializeConcreteProcess(), and postTimestepConcreteProcess().

_process_data

WellboreSimulatorProcessData ProcessLib::WellboreSimulator::WellboreSimulatorProcess::_process_data

private

Definition at line 82 of file WellboreSimulatorProcess.h.

Referenced by WellboreSimulatorProcess(), and initializeConcreteProcess().

---

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

• WellboreSimulatorProcess.h
• WellboreSimulatorProcess.cpp