NEML2TensorCompute

Compute object wrapper for a NEML2 model

Use a NEML2 model to perform a tensor compute.

Overview

Maps Marlin buffers to NEML2 model inputs, executes the model, and maps model outputs back to Marlin buffers. Configure the NEML2 input file and model via "neml2_input_file" and "neml2_model". Use "marlin_inputs", "neml2_inputs", "neml2_outputs", and "marlin_outputs" to define the mappings.

Example Input File Syntax

[Postprocessors<<<{"href": "../../syntax/Postprocessors/index.html"}>>>]
  [C]
    type = TensorAveragePostprocessor<<<{"description": "Compute the average value over a buffer.", "href": "../postprocessors/TensorAveragePostprocessor.html"}>>>
    buffer<<<{"description": "The buffer this compute is operating on"}>>> = C
  []
[]

Input Parameters

neml2_input_filePath to the NEML2 input file containing the NEML2 model(s).
C++ Type:DataFileName
Controllable:No
Description:Path to the NEML2 input file containing the NEML2 model(s).
neml2_modelModel name
C++ Type:std::string
Controllable:No
Description:Model name

Required Parameters

cli_argsAdditional command line arguments to use when parsing the NEML2 input file.
C++ Type:std::vector<std::string>
Controllable:No
Description:Additional command line arguments to use when parsing the NEML2 input file.
marlin_inputsMarlin buffer names that go into the NEML2 model.
C++ Type:std::vector<std::string>
Controllable:No
Description:Marlin buffer names that go into the NEML2 model.
marlin_outputsMarlin buffer name corresponding to the `neml2_outputs`.
C++ Type:std::vector<std::string>
Controllable:No
Description:Marlin buffer name corresponding to the `neml2_outputs`.
neml2_inputsNEML2 variable names corresponding to the `marlin_inputs`.
C++ Type:std::vector<std::string>
Controllable:No
Description:NEML2 variable names corresponding to the `marlin_inputs`.
neml2_outputsNEML2 model outputs.
C++ Type:std::vector<std::string>
Controllable:No
Description:NEML2 model outputs.

Optional 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.
enableTrueSet the enabled status of the MooseObject.
Default:True
C++ Type:bool
Controllable:No
Description:Set the enabled status of the MooseObject.

Advanced Parameters

Input Files

(test/tests/neml2/scalar.i)

(test/tests/neml2/scalar.i)

[Domain]
  dim = 2
  nx = 2
  ny = 2
  xmax = 1
  ymax = 1
  mesh_mode = DUMMY
[]

[Problem]
  type = TensorProblem
[]

[TensorComputes]
  [Initialize]
    [A]
      type = ConstantTensor
      buffer = A
      real = 2

    []
    [B]
      type = ConstantTensor
      buffer = B
      real = 3
    []
    [C]
      type = NEML2TensorCompute
      neml2_input_file = neml2_input.i
      neml2_model = multiply
      marlin_inputs = 'A B'
      neml2_inputs = 'A B'
      neml2_outputs = 'C'
      marlin_outputs = 'C'
    []
  []
[]

[Postprocessors]
  [C]
    type = TensorAveragePostprocessor
    buffer = C
  []
[]

[Executioner]
  type = Transient
  num_steps = 1
[]

[Outputs]
  csv = true
[]

(test/tests/neml2/scalar.i)

[Domain]
  dim = 2
  nx = 2
  ny = 2
  xmax = 1
  ymax = 1
  mesh_mode = DUMMY
[]

[Problem]
  type = TensorProblem
[]

[TensorComputes]
  [Initialize]
    [A]
      type = ConstantTensor
      buffer = A
      real = 2

    []
    [B]
      type = ConstantTensor
      buffer = B
      real = 3
    []
    [C]
      type = NEML2TensorCompute
      neml2_input_file = neml2_input.i
      neml2_model = multiply
      marlin_inputs = 'A B'
      neml2_inputs = 'A B'
      neml2_outputs = 'C'
      marlin_outputs = 'C'
    []
  []
[]

[Postprocessors]
  [C]
    type = TensorAveragePostprocessor
    buffer = C
  []
[]

[Executioner]
  type = Transient
  num_steps = 1
[]

[Outputs]
  csv = true
[]

Overview
Example Input File Syntax
Input Parameters
Input Files