PorousFlowPointEnthalpySourceFromPostprocessor

PorousFlowPointEnthalpySourceFromPostprocessor implements a point source that adds heat energy corresponding to adding fluid at a mass flux rate (computed by a postprocessor) at a specified temperature (computed by a postprocessor).

This object should be used in conjunction with (PorousFlowPointSourceFromPostprocessor)PorousFlowPointSourceFromPostprocessor that uses the same mass_flux Postprocessor, so that the correct amount of fluid is injected into the system.

Note that the fluid property object used by this Dirac kernel should be the same one that used in the computational domain where this object is located.

Parameter "pressure" (along with "T_in") is used to calculate the injected fluid enthalpy. Most frequently, it is the PorousFlow pressure variable (the porepressure in the porous medium). This models the situation where fluid is injected at a specified rate and temperature (using this DiracKernel and a PorousFlowPointSourceFromPostprocessor) which potentially leads to changes in the porepressure. Alternately, it may be the pressure of the injected fluid, as fixed by an external agent (such as a pump) which is stored in an AuxVariable.

For instance:

[DiracKernels<<<{"href": "../../syntax/DiracKernels/index.html"}>>>]
  [source]
    type = PorousFlowPointSourceFromPostprocessor<<<{"description": "Point source (or sink) that adds (or removes) fluid at a mass flux rate specified by a postprocessor.", "href": "PorousFlowPointSourceFromPostprocessor.html"}>>>
    variable<<<{"description": "The name of the variable that this residual object operates on"}>>> = pressure
    mass_flux<<<{"description": "The postprocessor name holding the mass flux at this point in kg/s (positive is flux in, negative is flux out)"}>>> = mass_flux_in
    point<<<{"description": "The x,y,z coordinates of the point source (or sink)"}>>> = '0.5 0.5 0'
  []
  [source_h]
    type = PorousFlowPointEnthalpySourceFromPostprocessor<<<{"description": "Point source that adds heat energy corresponding to injection of a fluid with specified mass flux rate (specified by a postprocessor) at given temperature (specified by a postprocessor)", "href": "PorousFlowPointEnthalpySourceFromPostprocessor.html"}>>>
    variable<<<{"description": "The name of the variable that this residual object operates on"}>>> = temperature
    mass_flux<<<{"description": "The postprocessor name holding the mass flux of injected fluid at this point in kg/s (please ensure this is positive so that this object acts like a source)"}>>> = mass_flux_in
    point<<<{"description": "The x,y,z coordinates of the point source"}>>> = '0.5 0.5 0'
    T_in<<<{"description": "The postprocessor name holding the temperature of injected fluid (measured in K)"}>>> = T_in
    pressure<<<{"description": "Pressure used to calculate the injected fluid enthalpy (measured in Pa)"}>>> = pressure
    fp<<<{"description": "The name of the user object used to calculate the fluid properties of the injected fluid"}>>> = simple_fluid
  []
[]
(modules/porous_flow/test/tests/dirackernels/hfrompps.i)

Note that the execute_on parameter is set to timestep_begin so that the correct value is being used within the timestep.

[Postprocessors<<<{"href": "../../syntax/Postprocessors/index.html"}>>>]
  [total_mass]
    type = PorousFlowFluidMass<<<{"description": "Calculates the mass of a fluid component in a region", "href": "../postprocessors/PorousFlowFluidMass.html"}>>>
    execute_on<<<{"description": "The list of flag(s) indicating when this object should be executed. For a description of each flag, see https://mooseframework.inl.gov/source/interfaces/SetupInterface.html."}>>> = 'initial timestep_end'
  []

  [total_heat]
    type = PorousFlowHeatEnergy<<<{"description": "Calculates the sum of heat energy of fluid phase(s) and/or the porous skeleton in a region", "href": "../postprocessors/PorousFlowHeatEnergy.html"}>>>
  []

  [mass_flux_in]
    type = FunctionValuePostprocessor<<<{"description": "Computes the value of a supplied function at a single point (scalable)", "href": "../postprocessors/FunctionValuePostprocessor.html"}>>>
    function<<<{"description": "The function which supplies the postprocessor value."}>>> = mass_flux_in_fn
    execute_on<<<{"description": "The list of flag(s) indicating when this object should be executed. For a description of each flag, see https://mooseframework.inl.gov/source/interfaces/SetupInterface.html."}>>> = 'initial timestep_end'
  []

  [avg_temp]
    type = ElementAverageValue<<<{"description": "Computes the volumetric average of a variable", "href": "../postprocessors/ElementAverageValue.html"}>>>
    variable<<<{"description": "The name of the variable that this object operates on"}>>> = temperature
    execute_on<<<{"description": "The list of flag(s) indicating when this object should be executed. For a description of each flag, see https://mooseframework.inl.gov/source/interfaces/SetupInterface.html."}>>> = 'initial timestep_end'
  []

  [T_in]
    type = FunctionValuePostprocessor<<<{"description": "Computes the value of a supplied function at a single point (scalable)", "href": "../postprocessors/FunctionValuePostprocessor.html"}>>>
    function<<<{"description": "The function which supplies the postprocessor value."}>>> = T_in_fn
    execute_on<<<{"description": "The list of flag(s) indicating when this object should be executed. For a description of each flag, see https://mooseframework.inl.gov/source/interfaces/SetupInterface.html."}>>> = 'initial timestep_end'
  []
[]
(modules/porous_flow/test/tests/dirackernels/hfrompps.i)
[DiracKernels<<<{"href": "../../syntax/DiracKernels/index.html"}>>>]
  [source]
    type = PorousFlowPointSourceFromPostprocessor<<<{"description": "Point source (or sink) that adds (or removes) fluid at a mass flux rate specified by a postprocessor.", "href": "PorousFlowPointSourceFromPostprocessor.html"}>>>
    variable<<<{"description": "The name of the variable that this residual object operates on"}>>> = pressure
    mass_flux<<<{"description": "The postprocessor name holding the mass flux at this point in kg/s (positive is flux in, negative is flux out)"}>>> = mass_flux_in
    point<<<{"description": "The x,y,z coordinates of the point source (or sink)"}>>> = '0.5 0.5 0'
  []
  [source_h]
    type = PorousFlowPointEnthalpySourceFromPostprocessor<<<{"description": "Point source that adds heat energy corresponding to injection of a fluid with specified mass flux rate (specified by a postprocessor) at given temperature (specified by a postprocessor)", "href": "PorousFlowPointEnthalpySourceFromPostprocessor.html"}>>>
    variable<<<{"description": "The name of the variable that this residual object operates on"}>>> = temperature
    mass_flux<<<{"description": "The postprocessor name holding the mass flux of injected fluid at this point in kg/s (please ensure this is positive so that this object acts like a source)"}>>> = mass_flux_in
    point<<<{"description": "The x,y,z coordinates of the point source"}>>> = '0.5 0.5 0'
    T_in<<<{"description": "The postprocessor name holding the temperature of injected fluid (measured in K)"}>>> = T_in
    pressure<<<{"description": "Pressure used to calculate the injected fluid enthalpy (measured in Pa)"}>>> = pressure
    fp<<<{"description": "The name of the user object used to calculate the fluid properties of the injected fluid"}>>> = simple_fluid
  []
[]
(modules/porous_flow/test/tests/dirackernels/hfrompps.i)

Input Parameters

  • T_inThe postprocessor name holding the temperature of injected fluid (measured in K)

    C++ Type:PostprocessorName

    Unit:(no unit assumed)

    Controllable:No

    Description:The postprocessor name holding the temperature of injected fluid (measured in K)

  • fpThe name of the user object used to calculate the fluid properties of the injected fluid

    C++ Type:UserObjectName

    Controllable:No

    Description:The name of the user object used to calculate the fluid properties of the injected fluid

  • mass_fluxThe postprocessor name holding the mass flux of injected fluid at this point in kg/s (please ensure this is positive so that this object acts like a source)

    C++ Type:PostprocessorName

    Unit:(no unit assumed)

    Controllable:No

    Description:The postprocessor name holding the mass flux of injected fluid at this point in kg/s (please ensure this is positive so that this object acts like a source)

  • pointThe x,y,z coordinates of the point source

    C++ Type:libMesh::Point

    Controllable:No

    Description:The x,y,z coordinates of the point source

  • pressurePressure used to calculate the injected fluid enthalpy (measured in Pa)

    C++ Type:std::vector<VariableName>

    Unit:(no unit assumed)

    Controllable:No

    Description:Pressure used to calculate the injected fluid enthalpy (measured in Pa)

  • variableThe name of the variable that this residual object operates on

    C++ Type:NonlinearVariableName

    Unit:(no unit assumed)

    Controllable:No

    Description:The name of the variable that this residual object operates on

Required Parameters

  • allow_moving_sourcesFalseIf true, allow Dirac sources to move, even if the mesh does not move, during the simulation.

    Default:False

    C++ Type:bool

    Controllable:No

    Description:If true, allow Dirac sources to move, even if the mesh does not move, during the simulation.

  • blockThe list of blocks (ids or names) that this object will be applied

    C++ Type:std::vector<SubdomainName>

    Controllable:No

    Description:The list of blocks (ids or names) that this object will be applied

  • matrix_onlyFalseWhether this object is only doing assembly to matrices (no vectors)

    Default:False

    C++ Type:bool

    Controllable:No

    Description:Whether this object is only doing assembly to matrices (no vectors)

  • point_not_found_behaviorIGNOREBy default (IGNORE), it is ignored if an added point cannot be located in the specified subdomains. If this option is set to ERROR, this situation will result in an error. If this option is set to WARNING, then a warning will be issued.

    Default:IGNORE

    C++ Type:MooseEnum

    Options:ERROR, WARNING, IGNORE

    Controllable:No

    Description:By default (IGNORE), it is ignored if an added point cannot be located in the specified subdomains. If this option is set to ERROR, this situation will result in an error. If this option is set to WARNING, then a warning will be issued.

Optional Parameters

  • absolute_value_vector_tagsThe tags for the vectors this residual object should fill with the absolute value of the residual contribution

    C++ Type:std::vector<TagName>

    Controllable:No

    Description:The tags for the vectors this residual object should fill with the absolute value of the residual contribution

  • extra_matrix_tagsThe extra tags for the matrices this Kernel should fill

    C++ Type:std::vector<TagName>

    Controllable:No

    Description:The extra tags for the matrices this Kernel should fill

  • extra_vector_tagsThe extra tags for the vectors this Kernel should fill

    C++ Type:std::vector<TagName>

    Controllable:No

    Description:The extra tags for the vectors this Kernel should fill

  • matrix_tagssystemThe tag for the matrices this Kernel should fill

    Default:system

    C++ Type:MultiMooseEnum

    Options:nontime, system

    Controllable:No

    Description:The tag for the matrices this Kernel should fill

  • vector_tagsnontimeThe tag for the vectors this Kernel should fill

    Default:nontime

    C++ Type:MultiMooseEnum

    Options:nontime, time

    Controllable:No

    Description:The tag for the vectors this Kernel should fill

Contribution To Tagged Field Data Parameters

  • control_tagsAdds user-defined labels for accessing object parameters via control logic.

    C++ Type:std::vector<std::string>

    Controllable:No

    Description:Adds user-defined labels for accessing object parameters via control logic.

  • drop_duplicate_pointsTrueBy default points added to a DiracKernel are dropped if a point at the same locationhas been added before. If this option is set to false duplicate points are retainedand contribute to residual and Jacobian.

    Default:True

    C++ Type:bool

    Controllable:No

    Description:By default points added to a DiracKernel are dropped if a point at the same locationhas been added before. If this option is set to false duplicate points are retainedand contribute to residual and Jacobian.

  • enableTrueSet the enabled status of the MooseObject.

    Default:True

    C++ Type:bool

    Controllable:Yes

    Description:Set the enabled status of the MooseObject.

  • implicitTrueDetermines whether this object is calculated using an implicit or explicit form

    Default:True

    C++ Type:bool

    Controllable:No

    Description:Determines whether this object is calculated using an implicit or explicit form

  • seed0The seed for the master random number generator

    Default:0

    C++ Type:unsigned int

    Controllable:No

    Description:The seed for the master random number generator

  • use_displaced_meshFalseWhether or not this object should use the displaced mesh for computation. Note that in the case this is true but no displacements are provided in the Mesh block the undisplaced mesh will still be used.

    Default:False

    C++ Type:bool

    Controllable:No

    Description:Whether or not this object should use the displaced mesh for computation. Note that in the case this is true but no displacements are provided in the Mesh block the undisplaced mesh will still be used.

Advanced Parameters

  • prop_getter_suffixAn optional suffix parameter that can be appended to any attempt to retrieve/get material properties. The suffix will be prepended with a '_' character.

    C++ Type:MaterialPropertyName

    Unit:(no unit assumed)

    Controllable:No

    Description:An optional suffix parameter that can be appended to any attempt to retrieve/get material properties. The suffix will be prepended with a '_' character.

  • use_interpolated_stateFalseFor the old and older state use projected material properties interpolated at the quadrature points. To set up projection use the ProjectedStatefulMaterialStorageAction.

    Default:False

    C++ Type:bool

    Controllable:No

    Description:For the old and older state use projected material properties interpolated at the quadrature points. To set up projection use the ProjectedStatefulMaterialStorageAction.

Material Property Retrieval Parameters

Input Files