Physics Builder Tools > User Inputs > Material Property

Material Property
The Material Property node () is a special case of a User Input that also supports linking with material properties from the Materials node in the Model Builder. A material property node is actually a collection of two user inputs: one list with the options From material or User defined and one property value field for user-defined values.
To add a Material Property first add a feature node, for example, a Generic Feature, Domain Condition, or Device Model Feature, then:
From the contextual toolbar (in this example, Generic Feature, Domain Condition, or Device Model Feature), click the Material Property () button.
Right-click the feature node (in this example, Generic Feature, Domain Condition, or Device Model Feature) and select it from the Inputs submenu.
Also see Material Property (Auxiliary Definitions), which is a subnode to the Material Property Group node under Auxiliary Definitions.
The Settings window has the following sections:
Declaration
The material property can either be a basic material property or a property that belongs to a predefined material property group. Choose a Property type: Basic material property (the default), Built in predefined material property, Locally defined material property, or Imported material property from external resources.
A Basic material property belongs to a predefined set of quantities that are commonly used in material libraries.
-
Enter a valid Property name, Description, and Symbol (LaTeX encoded). See Variable Declaration.
-
Choose a Physical quantity. The quantity identifies the corresponding property in the material libraries. A property in the material library has a certain dimension, but it is possible to use a smaller dimension for a material property in a feature.
-
Choose the Dimension, which can only contain Scalar and Custom for a scalar material parameter.
-
For Built in predefined material property, choose a predefined Material property group from the list. Then choose a Material property and enter and choose Default Values.
For Locally defined material property, choose a Material model from the list. Then choose a Material property and choose Default Values.
For Imported material property from external resources, choose an Imported file from the list. Then choose a Link and a Material property. Then choose Default Values.
Select Locally defined from the top of the Physical quantity list to use one of the locally defined physical quantities, which you choose from the Link list. Click the Go to Source button () to move to the Physical Quantity node for the selected local physical quantity.
Default Values
In the Default value for user defined field, which can be a table, enter the default value for the user-defined option.
Use the Default value list to set the default for the feature instance. Choose From material (the default), User defined, First allowed value, or Custom default. First allowed value takes the first active value from the values specified by the Allowed Values child nodes. Use the Custom default option to enter a value. This value must always be active for the list in the feature instance.
Options
In the Model Builder most material properties get their values from the material assigned to the geometric entities overlapping with the selection of the feature instance. You can add a Material List to the feature, which allows you to choose among all materials added to a model. Select the Couple to material list check box to specify that this property gets linked to the material selected in the list. Then choose the list to couple against in the Material list, either by entering a name in the Name field or by choosing a particular material list reference.
For a Basic material property, the Pick material property from property groups in selected materials check box is available. Select this check box to make the material property take its values from the property groups of the material that is selected in the material list.
For a Basic material property with the Physical quantity set to Diffusion coefficient, the values that you can choose from are the property groups of the material selected in the material list that define the output property for the diffusion coefficient.
In addition to the options From material and User defined, you can add extra items to the list in the feature instance with Allowed Values child nodes. An alternative option is also entering them directly to the Extra list items table.
Restrictions
See User Input for information about this setting.
GUI Options
If you want the material property to disappear when it is inactive, you select the Hide user input in GUI when inactive check box. Select the Show no description check box to hide the text label containing the description above the GUI component of the property. Similarly, you can hide the symbol from the GUI by selecting the Show no symbol check box. As a final option, it is possible to add a divider above the GUI component and any description text label. The divider is a horizontal line with an optional descriptive text. Select the Add divider above the material property check box to add the divider. When selected, you can enter the divider text in the Text field.
Materials in the COMSOL Multiphysics Reference Manual