User-defined Material#

../../../../_images/material_user_defined.png

In this example we will demonstrate how to:

Retrieve a material from the active model
Get material values for a specific temperature
Modify material values for a specific temperatue
Get standard-related material parameters
Modify standard-related material parameters
Apply the changes as a user-defined material to the model

from dlubal.api import rfem
from dlubal.api import common

# Connect to the RFEM application
with rfem.Application() as rfem_app:

    # Retrieve a specific material (ID = 2) from the active model
    material:rfem.structure_core.Material = rfem_app.get_object(
        rfem.structure_core.Material(no=2)  # Concrete material
    )

    # --- Update Material Properties ---

    # Print material values for all temperatures (=rows)
    for material_values in material.material_values.rows:
        print(material_values)

    # Define paths for material properties to be updated
    fck_path = ['strengths', 'f_ck']
    ecm_path = ['moduli', 'e_cm']

    # Create an empty MaterialValuesTreeTable and set the desired material property values
    material_values_tree = rfem.structure_core.Material.MaterialValuesRow.MaterialValuesTreeTable()
    common.set_tree_value(material_values_tree, fck_path, 28000000.0)
    common.set_tree_value(material_values_tree, ecm_path, 25000000000.0)

   # Copy the updated material values to the first temperature row of the material's values table.
    material.material_values.rows[0].material_values_tree.CopyFrom(material_values_tree)

    # --- Update Standard Parameters ---

    # Print material values for all temperature rows
    standard_params = material.standard_parameters
    print(standard_params)

    # Define paths for material properties to be updated
    gamma_c_path = ['2_basis_of_design', '2_4_2_4_partial_factors_for_materials', 'gamma_c']

    # Create an empty MaterialValuesTreeTable and set the desired material property values
    standard_params_tree = rfem.structure_core.Material.StandardParametersTreeTable()
    common.set_tree_value(standard_params_tree, gamma_c_path, 1.35)


    # --- Apply modified Material back to the model ---
    rfem_app.update_object(
        obj=rfem.structure_core.Material(
            no=2,
            user_defined=True,
            material_values=material.material_values, # material values
            standard_parameters=standard_params_tree  # standard parameters
        )
    )

using Rfem = Dlubal.Api.Rfem;
using Common = Dlubal.Api.Common;


ApplicationRfem? RfemApp = null;

try
{
    RfemApp = new ApplicationRfem();

    // Retrieve the specific material (ID = 2) from the active model
    Rfem.StructureCore.Material material = await RfemApp.get_object<Rfem.StructureCore.Material>(
        new Rfem.StructureCore.Material{No= 2} // Concrete material
    );

    // --- Update Material Properties ---

    // Print material values for all temperatures (=rows)
    foreach (var materialValues in material.MaterialValues.Rows)
    {
        Console.WriteLine(materialValues);
    }

    // Define paths for material properties to be updated
    var fckPath = new string[] { "strengths", "f_ck" };
    var ecmPath = new string[] { "moduli", "e_cm" };

    // Create an empty MaterialValuesTreeTable and set the desired material property values
    var materialValuesTree = new Rfem.StructureCore.Material.Types.MaterialValuesRow.Types.MaterialValuesTreeTable();
    Common.TreeHelpers.SetTreeValue(materialValuesTree, fckPath, 28000000.0);
    Common.TreeHelpers.SetTreeValue(materialValuesTree, ecmPath, 25000000000.0);

    // Copy the updated material values to the first temperature row of the material's values table.
    material.MaterialValues.Rows[0].MaterialValuesTree.MergeFrom(materialValuesTree);


    // --- Update Standard Parameters ---

    var materialStandardParams = material.StandardParameters;
    Console.WriteLine(materialStandardParams);

    var gammacPath = new string[] { "2_basis_of_design", "2_4_2_4_partial_factors_for_materials", "gamma_c" };
    var materialStandardParamsTree = new Rfem.StructureCore.Material.Types.StandardParametersTreeTable();
    Common.TreeHelpers.SetTreeValue(materialStandardParamsTree, gammacPath, 1.35);

    // --- Apply modified Material back to the model ---
    await RfemApp.update_object(
        obj: new Rfem.StructureCore.Material{
            No= 2, UserDefined= true,
            MaterialValues= material.MaterialValues,
            StandardParameters=materialStandardParamsTree
        }
    );
}

catch (Exception ex)
{
    Console.WriteLine($"Error: {ex.Message}");
}
finally
{
    // Step 8: Close connection
    if (RfemApp != null) await RfemApp.close_connection();
}