ProcessLib::HMPhaseField Namespace Reference

Classes
class	HMPhaseFieldLocalAssembler
struct	HMPhaseFieldLocalAssemblerInterface
class	HMPhaseFieldProcess
struct	HMPhaseFieldProcessData
struct	IntegrationPointData
struct	SecondaryData

Functions
void	checkMPLProperties (std::map< int, std::shared_ptr< MaterialPropertyLib::Medium > > const &media)
template<int DisplacementDim>
std::unique_ptr< Process >	createHMPhaseFieldProcess (std::string name, MeshLib::Mesh &mesh, std::unique_ptr< ProcessLib::AbstractJacobianAssembler > &&jacobian_assembler, std::vector< ProcessVariable > const &variables, std::vector< std::unique_ptr< ParameterLib::ParameterBase > > const &parameters, std::optional< ParameterLib::CoordinateSystem > const &local_coordinate_system, unsigned const integration_order, BaseLib::ConfigTree const &config, std::map< int, std::shared_ptr< MaterialPropertyLib::Medium > > const &media)
template std::unique_ptr< Process >	createHMPhaseFieldProcess< 2 > (std::string name, MeshLib::Mesh &mesh, std::unique_ptr< ProcessLib::AbstractJacobianAssembler > &&jacobian_assembler, std::vector< ProcessVariable > const &variables, std::vector< std::unique_ptr< ParameterLib::ParameterBase > > const &parameters, std::optional< ParameterLib::CoordinateSystem > const &local_coordinate_system, unsigned const integration_order, BaseLib::ConfigTree const &config, std::map< int, std::shared_ptr< MaterialPropertyLib::Medium > > const &media)
template std::unique_ptr< Process >	createHMPhaseFieldProcess< 3 > (std::string name, MeshLib::Mesh &mesh, std::unique_ptr< ProcessLib::AbstractJacobianAssembler > &&jacobian_assembler, std::vector< ProcessVariable > const &variables, std::vector< std::unique_ptr< ParameterLib::ParameterBase > > const &parameters, std::optional< ParameterLib::CoordinateSystem > const &local_coordinate_system, unsigned const integration_order, BaseLib::ConfigTree const &config, std::map< int, std::shared_ptr< MaterialPropertyLib::Medium > > const &media)
void	showEnergyAndWork (const double t, double &_elastic_energy, double &_surface_energy, double &_pressure_work)

Function Documentation

checkMPLProperties()

void ProcessLib::HMPhaseField::checkMPLProperties

(

std::map< int, std::shared_ptr< MaterialPropertyLib::Medium > > const &

media

)

Definition at line 23 of file CreateHMPhaseFieldProcess.cpp.

{
    std::array const requiredMediumProperties = {
        MaterialPropertyLib::reference_temperature,
        MaterialPropertyLib::porosity, MaterialPropertyLib::permeability};
    std::array const requiredFluidProperties = {MaterialPropertyLib::viscosity,
                                                MaterialPropertyLib::density};
    std::array const requiredSolidProperties = {
        MaterialPropertyLib::biot_coefficient, MaterialPropertyLib::density};
 
    for (auto const& m : media)
    {
        checkRequiredProperties(*m.second, requiredMediumProperties);
        checkRequiredProperties(m.second->phase("AqueousLiquid"),
                                requiredFluidProperties);
        checkRequiredProperties(m.second->phase("Solid"),
                                requiredSolidProperties);
    }
}

References MaterialPropertyLib::biot_coefficient, MaterialPropertyLib::density, MaterialPropertyLib::permeability, MaterialPropertyLib::porosity, MaterialPropertyLib::reference_temperature, and MaterialPropertyLib::viscosity.

Referenced by createHMPhaseFieldProcess().

createHMPhaseFieldProcess()

template<int DisplacementDim>

std::unique_ptr< Process > ProcessLib::HMPhaseField::createHMPhaseFieldProcess	(	std::string	name,
		MeshLib::Mesh &	mesh,
		std::unique_ptr< ProcessLib::AbstractJacobianAssembler > &&	jacobian_assembler,
		std::vector< ProcessVariable > const &	variables,
		std::vector< std::unique_ptr< ParameterLib::ParameterBase > > const &	parameters,
		std::optional< ParameterLib::CoordinateSystem > const &	local_coordinate_system,
		unsigned const	integration_order,
		BaseLib::ConfigTree const &	config,
		std::map< int, std::shared_ptr< MaterialPropertyLib::Medium > > const &	media )

Input File Parameter

prj__processes__process__type

Input File Parameter

prj__processes__process__HM_PHASE_FIELD__coupling_scheme

Input File Parameter

prj__processes__process__HM_PHASE_FIELD__process_variables

Primary process variables as they appear in the global component vector:

Input File Parameter

prj__processes__process__HM_PHASE_FIELD__process_variables__phasefield

Input File Parameter

prj__processes__process__HM_PHASE_FIELD__process_variables__pressure

Input File Parameter

prj__processes__process__HM_PHASE_FIELD__process_variables__displacement

Process Parameters

Input File Parameter

prj__processes__process__HM_PHASE_FIELD__phasefield_parameters

Input File Parameter

prj__processes__process__HM_PHASE_FIELD__phasefield_parameters__residual_stiffness

Input File Parameter

prj__processes__process__HM_PHASE_FIELD__phasefield_parameters__crack_resistance

Input File Parameter

prj__processes__process__HM_PHASE_FIELD__phasefield_parameters__crack_length_scale

Input File Parameter

prj__processes__process__HM_PHASE_FIELD__characteristic_length

Input File Parameter

prj__processes__process__HM_PHASE_FIELD__fluid_compressibility

Input File Parameter

prj__processes__process__HM_PHASE_FIELD__specific_body_force

Input File Parameter

prj__processes__process__HM_PHASE_FIELD__specific_fracture_direction

Input File Parameter

prj__processes__process__HM_PHASE_FIELD__irreversible_threshold

Input File Parameter

prj__processes__process__HM_PHASE_FIELD__phasefield_model

Input File Parameter

prj__processes__process__HM_PHASE_FIELD__softening_curve

Input File Parameter

prj__processes__process__HM_PHASE_FIELD__energy_split_model

Input File Parameter

prj__processes__process__HM_PHASE_FIELD__diffused_range_parameter

Input File Parameter

prj__processes__process__HM_PHASE_FIELD__fracture_threshold

Input File Parameter

prj__processes__process__HM_PHASE_FIELD__fracture_permeability_parameter

Input File Parameter

prj__processes__process__HM_PHASE_FIELD__fixed_stress_stabilization_parameter

Input File Parameter

prj__processes__process__HM_PHASE_FIELD__spatial_stabilization_parameter

Input File Parameter

prj__processes__process__HM_PHASE_FIELD__width_init

Definition at line 45 of file CreateHMPhaseFieldProcess.cpp.

{
    config.checkConfigParameter("type", "HM_PHASE_FIELD");
    DBUG("Create HMPhaseFieldProcess.");
 
    auto const coupling_scheme =
        config.getConfigParameter<std::string>("coupling_scheme", "staggered");
    const bool use_monolithic_scheme = (coupling_scheme != "staggered");

    auto const pv_config = config.getConfigSubtree("process_variables");
 
    ProcessVariable* variable_ph;
    ProcessVariable* variable_p;
    ProcessVariable* variable_u;
    std::vector<std::vector<std::reference_wrapper<ProcessVariable>>>
        process_variables;
    if (use_monolithic_scheme)  // monolithic scheme.
    {
        OGS_FATAL("Monolithic implementation is not available.");
    }
    else  // staggered scheme.
    {
        using namespace std::string_literals;
        for (
            auto const& variable_name :
            {
             "phasefield"s,
             "pressure"s,
             "displacement"s})
        {
            auto per_process_variables =
                findProcessVariables(variables, pv_config, {variable_name});
            process_variables.push_back(std::move(per_process_variables));
        }
        variable_ph = &process_variables[0][0].get();
        variable_p = &process_variables[1][0].get();
        variable_u = &process_variables[2][0].get();
    }
 
    DBUG("Associate phase field with process variable '{}'.",
         variable_ph->getName());
    if (variable_ph->getNumberOfGlobalComponents() != 1)
    {
        OGS_FATAL(
            "HMPhasefield process variable '{}' is not a scalar variable but "
            "has {:d} components.",
            variable_ph->getName(),
            variable_ph->getNumberOfGlobalComponents());
    }
 
    DBUG("Associate pressure with process variable '{}'.",
         variable_p->getName());
    if (variable_p->getNumberOfGlobalComponents() != 1)
    {
        OGS_FATAL(
            "HMPhasefield process variable '{}' is not a scalar variable but "
            "has {:d} components.",
            variable_p->getName(),
            variable_p->getNumberOfGlobalComponents());
    }
 
    DBUG("Associate displacement with process variable '{}'.",
         variable_u->getName());
 
    if (variable_u->getNumberOfGlobalComponents() != DisplacementDim)
    {
        OGS_FATAL(
            "The component number of the process variable '{}' is different "
            "from the displacement dimension: got {:d}, expected {:d}",
            variable_u->getName(),
            variable_u->getNumberOfGlobalComponents(),
            DisplacementDim);
    }

    auto solid_constitutive_relations =
        MaterialLib::Solids::createConstitutiveRelations<DisplacementDim>(
            parameters, local_coordinate_system, materialIDs(mesh), config);
 
    auto const phasefield_parameters_config =
        config.getConfigSubtree("phasefield_parameters");
 
    // Residual stiffness
    auto const& residual_stiffness = ParameterLib::findParameter<double>(
        phasefield_parameters_config,
        "residual_stiffness", parameters, 1);
    DBUG("Use '{}' as residual stiffness.", residual_stiffness.name);
 
    // Crack resistance
    auto const& crack_resistance = ParameterLib::findParameter<double>(
        phasefield_parameters_config,
        "crack_resistance", parameters, 1);
    DBUG("Use '{}' as crack resistance.", crack_resistance.name);
 
    // Crack length scale
    auto const& crack_length_scale = ParameterLib::findParameter<double>(
        phasefield_parameters_config,
        "crack_length_scale", parameters, 1);
    DBUG("Use '{}' as crack length scale.", crack_length_scale.name);
 
    // Characteristic_length
    auto const characteristic_length =
        config.getConfigParameter<double>("characteristic_length", 1.0);
 
    // Fluid compression modulus. Default value is 0.0.
    auto const fluid_compressibility =
        config.getConfigParameter<double>("fluid_compressibility", 0.0);
 
    // Specific body force
    Eigen::Matrix<double, DisplacementDim, 1> specific_body_force;
    {
        std::vector<double> const b =
            config.getConfigParameter<std::vector<double>>(
                "specific_body_force");
        if (b.size() != DisplacementDim)
        {
            OGS_FATAL(
                "The size of the specific body force vector does not match the "
                "displacement dimension. Vector size is {:d}, displacement "
                "dimension is {:d}",
                b.size(), DisplacementDim);
        }
 
        std::copy_n(b.data(), b.size(), specific_body_force.data());
    }
 
    // Specific fracture direction
    Eigen::Vector<double, DisplacementDim> specific_fracture_direction;
    {
        std::vector<double> const fracture_normal =
            config.getConfigParameter<std::vector<double>>(
                "specific_fracture_direction");
        if (fracture_normal.size() != DisplacementDim)
        {
            OGS_FATAL(
                "The size of the specific fracture direction vector does not "
                "match the displacement dimension. Vector size is {:d}, "
                "displacement dimension is {:d}",
                fracture_normal.size(), DisplacementDim);
        }
 
        std::copy_n(fracture_normal.data(), fracture_normal.size(),
                    specific_fracture_direction.data());
    }
 
    auto const irreversible_threshold =
        config.getConfigParameter<double>("irreversible_threshold", 0.05);
 
    auto const phasefield_model_string =
        config.getConfigParameter<std::string>("phasefield_model");
    auto const phasefield_model =
        MaterialLib::Solids::Phasefield::convertStringToPhaseFieldModel<
            DisplacementDim>(phasefield_model_string);
 
    auto const softening_curve_string =
        config.getConfigParameterOptional<std::string>("softening_curve");
    auto const softening_curve =
        MaterialLib::Solids::Phasefield::convertStringToSofteningCurve<
            DisplacementDim>(softening_curve_string);
 
    auto const energy_split_model_string =
        config.getConfigParameter<std::string>("energy_split_model");
    auto const energy_split_model =
        MaterialLib::Solids::Phasefield::convertStringToEnergySplitModel<
            DisplacementDim>(energy_split_model_string);
 
    auto degradation_derivative = creatDegradationDerivative<DisplacementDim>(
        phasefield_model, characteristic_length, softening_curve);
 
    auto const diffused_range_parameter =
        config.getConfigParameter<double>("diffused_range_parameter", 2.0);
 
    auto const fracture_threshold =
        config.getConfigParameter<double>("fracture_threshold", 1.0);
 
    auto const fracture_permeability_parameter =
        config.getConfigParameter<double>("fracture_permeability_parameter",
                                          0.0);
 
    // Default value is 0.5, which is recommended by [Mikelic & Wheeler].
    double const fixed_stress_stabilization_parameter =
        config.getConfigParameter<double>(
            "fixed_stress_stabilization_parameter", 0.5);
 
    DBUG("Using value {:g} for coupling parameter of staggered scheme.",
         fixed_stress_stabilization_parameter);
 
    auto spatial_stabilization_parameter_optional =
        config.getConfigParameterOptional<double>(
            "spatial_stabilization_parameter");
    double const spatial_stabilization_parameter =
        spatial_stabilization_parameter_optional
            ? spatial_stabilization_parameter_optional.value()
            : 0.0;
    DBUG("Using value {} for spatial stabilization coupling parameter.",
         spatial_stabilization_parameter);
 
    // Initial width
    auto const& width_init = ParameterLib::findParameter<double>(
        config,
        "width_init", parameters, 0.0);
    DBUG("Use '{}' as initial width.", width_init.name);
 
    auto media_map =
        MaterialPropertyLib::createMaterialSpatialDistributionMap(media, mesh);
    DBUG("Check the media properties of HMPhaseField process ...");
    checkMPLProperties(media);
    DBUG("Media properties verified.");
 
    HMPhaseFieldProcessData<DisplacementDim> process_data{
        materialIDs(mesh),
        std::move(media_map),
        std::move(solid_constitutive_relations),
        residual_stiffness,
        crack_resistance,
        crack_length_scale,
        specific_body_force,
        specific_fracture_direction,
        irreversible_threshold,
        phasefield_model,
        energy_split_model,
        softening_curve,
        characteristic_length,
        std::move(degradation_derivative),
        diffused_range_parameter,
        fluid_compressibility,
        fracture_threshold,
        fracture_permeability_parameter,
        fixed_stress_stabilization_parameter,
        spatial_stabilization_parameter,
        width_init};
 
    SecondaryVariableCollection secondary_variables;
 
    ProcessLib::createSecondaryVariables(config, secondary_variables);
 
    return std::make_unique<HMPhaseFieldProcess<DisplacementDim>>(
        std::move(name), mesh, std::move(jacobian_assembler), parameters,
        integration_order, std::move(process_variables),
        std::move(process_data), std::move(secondary_variables),
        use_monolithic_scheme);
}

References BaseLib::ConfigTree::checkConfigParameter(), checkMPLProperties(), MaterialLib::Solids::Phasefield::convertStringToEnergySplitModel(), MaterialLib::Solids::Phasefield::convertStringToPhaseFieldModel(), MaterialLib::Solids::Phasefield::convertStringToSofteningCurve(), MaterialLib::Solids::createConstitutiveRelations(), MaterialPropertyLib::createMaterialSpatialDistributionMap(), ProcessLib::createSecondaryVariables(), DBUG(), ParameterLib::findParameter(), ProcessLib::findProcessVariables(), BaseLib::ConfigTree::getConfigParameter(), BaseLib::ConfigTree::getConfigParameterOptional(), BaseLib::ConfigTree::getConfigSubtree(), ProcessLib::ProcessVariable::getName(), ProcessLib::ProcessVariable::getNumberOfGlobalComponents(), and OGS_FATAL.

createHMPhaseFieldProcess< 2 >()

template std::unique_ptr< Process > ProcessLib::HMPhaseField::createHMPhaseFieldProcess< 2 >	(	std::string	name,
		MeshLib::Mesh &	mesh,
		std::unique_ptr< ProcessLib::AbstractJacobianAssembler > &&	jacobian_assembler,
		std::vector< ProcessVariable > const &	variables,
		std::vector< std::unique_ptr< ParameterLib::ParameterBase > > const &	parameters,
		std::optional< ParameterLib::CoordinateSystem > const &	local_coordinate_system,
		unsigned const	integration_order,
		BaseLib::ConfigTree const &	config,
		std::map< int, std::shared_ptr< MaterialPropertyLib::Medium > > const &	media )

Referenced by ProjectData::parseProcesses().

createHMPhaseFieldProcess< 3 >()

template std::unique_ptr< Process > ProcessLib::HMPhaseField::createHMPhaseFieldProcess< 3 >	(	std::string	name,
		MeshLib::Mesh &	mesh,
		std::unique_ptr< ProcessLib::AbstractJacobianAssembler > &&	jacobian_assembler,
		std::vector< ProcessVariable > const &	variables,
		std::vector< std::unique_ptr< ParameterLib::ParameterBase > > const &	parameters,
		std::optional< ParameterLib::CoordinateSystem > const &	local_coordinate_system,
		unsigned const	integration_order,
		BaseLib::ConfigTree const &	config,
		std::map< int, std::shared_ptr< MaterialPropertyLib::Medium > > const &	media )

Referenced by ProjectData::parseProcesses().

showEnergyAndWork()

void ProcessLib::HMPhaseField::showEnergyAndWork ( const double t, double & _elastic_energy, double & _surface_energy, double & _pressure_work )

inline

Definition at line 33 of file HMPhaseFieldProcessData.h.

{
#ifdef USE_PETSC
    double const elastic_energy = _elastic_energy;
    MPI_Allreduce(&elastic_energy, &_elastic_energy, 1, MPI_DOUBLE, MPI_SUM,
                  PETSC_COMM_WORLD);
    double const surface_energy = _surface_energy;
    MPI_Allreduce(&surface_energy, &_surface_energy, 1, MPI_DOUBLE, MPI_SUM,
                  PETSC_COMM_WORLD);
    double const pressure_work = _pressure_work;
    MPI_Allreduce(&pressure_work, &_pressure_work, 1, MPI_DOUBLE, MPI_SUM,
                  PETSC_COMM_WORLD);
#endif
 
    INFO("Elastic energy: {} Surface energy: {} Pressure work: {} at time: {} ",
         _elastic_energy, _surface_energy, _pressure_work, t);
};

References INFO().

Referenced by ProcessLib::HMPhaseField::HMPhaseFieldProcess< DisplacementDim >::postTimestepConcreteProcess().