Frame#
![]() |
In this example we will demonstrate:
|
from dlubal.api import rfem
def define_structure() -> list:
"""Define and return a list of structural objects."""
inf = float('inf')
return [
# Define material
rfem.structure_core.Material(no=1, name='S235'),
# Define section
rfem.structure_core.Section(no=1, name='HE 200 A', material=1),
# Define nodes
rfem.structure_core.Node(no=1),
rfem.structure_core.Node(no=2, coordinate_3=-3.0),
rfem.structure_core.Node(no=3, coordinate_1=4.0, coordinate_3=-3.0),
rfem.structure_core.Node(no=4, coordinate_1=4.0),
# Define line
rfem.structure_core.Line(no=1, definition_nodes=[1, 2]),
rfem.structure_core.Line(no=2, definition_nodes=[2, 3]),
rfem.structure_core.Line(no=3, definition_nodes=[3, 4]),
# Define member
rfem.structure_core.Member(no=1, line=1, section_start=1),
rfem.structure_core.Member(no=2, line=2, section_start=1),
rfem.structure_core.Member(no=3, line=3, section_start=1),
# Define nodal support at Node 1 (fully fixed)
rfem.types_for_nodes.NodalSupport(
no=1,
nodes=[1,4],
spring_x=inf, spring_y=inf, spring_z=inf,
rotational_restraint_x=inf,
rotational_restraint_y=inf,
rotational_restraint_z=inf
),
]
def define_loads() -> list:
"""Define and return a list of loading objects."""
return [
# Static analysis settings
rfem.loading.StaticAnalysisSettings(
no=1,
analysis_type=rfem.loading.StaticAnalysisSettings.ANALYSIS_TYPE_GEOMETRICALLY_LINEAR,
),
# Define load cases
rfem.loading.LoadCase(
no=1,
name='Self-weight',
self_weight_active=True,
static_analysis_settings=1,
),
rfem.loading.LoadCase(
no=2,
name='Snow',
action_category=rfem.loading.LoadCase.ACTION_CATEGORY_SNOW_ICE_LOADS_H_LESS_OR_EQUAL_TO_1000_M_QS,
static_analysis_settings=1,
),
rfem.loading.LoadCase(
no=3,
name='Wind +x',
action_category=rfem.loading.LoadCase.ACTION_CATEGORY_WIND_QW,
static_analysis_settings=1,
),
rfem.loading.LoadCase(
no=4,
name='Wind +x, with wind suction',
action_category=rfem.loading.LoadCase.ACTION_CATEGORY_WIND_QW,
static_analysis_settings=1,
),
rfem.loading.LoadCase(
no=5,
name='Wind -x',
action_category=rfem.loading.LoadCase.ACTION_CATEGORY_WIND_QW,
static_analysis_settings=1,
),
rfem.loading.LoadCase(
no=6,
name='Wind -x, with wind suction',
action_category=rfem.loading.LoadCase.ACTION_CATEGORY_WIND_QW,
static_analysis_settings=1,
),
# Define loads
rfem.loads.MemberLoad(
no=1,
load_case=1,
members=[2],
load_type=rfem.loads.MemberLoad.LOAD_TYPE_FORCE,
magnitude=1000
),
rfem.loads.MemberLoad(
no=2,
load_case=2,
members=[2],
load_type=rfem.loads.MemberLoad.LOAD_TYPE_FORCE,
magnitude=3000
),
rfem.loads.MemberLoad(
no=3,
load_case=3,
members=[1],
load_type=rfem.loads.MemberLoad.LOAD_TYPE_FORCE,
magnitude=2000,
load_direction=rfem.loads.MemberLoad.LOAD_DIRECTION_GLOBAL_X_OR_USER_DEFINED_U_TRUE_LENGTH,
),
rfem.loads.MemberLoad(
no=4,
load_case=3,
members=[3],
load_type=rfem.loads.MemberLoad.LOAD_TYPE_FORCE,
magnitude=1000,
load_direction=rfem.loads.MemberLoad.LOAD_DIRECTION_GLOBAL_X_OR_USER_DEFINED_U_TRUE_LENGTH,
),
rfem.loads.MemberLoad(
no=5,
load_case=4,
members=[1],
load_type=rfem.loads.MemberLoad.LOAD_TYPE_FORCE,
magnitude=2000,
load_direction=rfem.loads.MemberLoad.LOAD_DIRECTION_GLOBAL_X_OR_USER_DEFINED_U_TRUE_LENGTH,
),
rfem.loads.MemberLoad(
no=6,
load_case=4,
members=[3],
load_type=rfem.loads.MemberLoad.LOAD_TYPE_FORCE,
magnitude=1000,
load_direction=rfem.loads.MemberLoad.LOAD_DIRECTION_GLOBAL_X_OR_USER_DEFINED_U_TRUE_LENGTH,
),
rfem.loads.MemberLoad(
no=7,
load_case=4,
members=[2],
load_type=rfem.loads.MemberLoad.LOAD_TYPE_FORCE,
magnitude=-500
),
rfem.loads.MemberLoad(
no=8,
load_case=5,
members=[1],
load_type=rfem.loads.MemberLoad.LOAD_TYPE_FORCE,
magnitude=-2000,
load_direction=rfem.loads.MemberLoad.LOAD_DIRECTION_GLOBAL_X_OR_USER_DEFINED_U_TRUE_LENGTH,
),
rfem.loads.MemberLoad(
no=9,
load_case=5,
members=[3],
load_type=rfem.loads.MemberLoad.LOAD_TYPE_FORCE,
magnitude=-1000,
load_direction=rfem.loads.MemberLoad.LOAD_DIRECTION_GLOBAL_X_OR_USER_DEFINED_U_TRUE_LENGTH,
),
rfem.loads.MemberLoad(
no=10,
load_case=6,
members=[1],
load_type=rfem.loads.MemberLoad.LOAD_TYPE_FORCE,
magnitude=-2000,
load_direction=rfem.loads.MemberLoad.LOAD_DIRECTION_GLOBAL_X_OR_USER_DEFINED_U_TRUE_LENGTH,
),
rfem.loads.MemberLoad(
no=11,
load_case=6,
members=[3],
load_type=rfem.loads.MemberLoad.LOAD_TYPE_FORCE,
magnitude=-1000,
load_direction=rfem.loads.MemberLoad.LOAD_DIRECTION_GLOBAL_X_OR_USER_DEFINED_U_TRUE_LENGTH,
),
rfem.loads.MemberLoad(
no=12,
load_case=6,
members=[2],
load_type=rfem.loads.MemberLoad.LOAD_TYPE_FORCE,
magnitude=-500
),
rfem.loading.CombinationWizard(
no=1,
static_analysis_settings=1,
),
rfem.loading.DesignSituation(
no=1,
design_situation_type=rfem.loading.DesignSituation.DESIGN_SITUATION_TYPE_STR_PERMANENT_AND_TRANSIENT_6_10,
combination_wizard=1,
),
]
with rfem.Application() as rfem_app:
# Step 1: Create a new model and clear existing objects
rfem_app.create_model(name='frame')
rfem_app.delete_all_objects()
# Step 2: Define and create the structure and load objects
base_data = rfem_app.get_base_data()
base_data.combinations_settings.activate_combination_wizard = True
base_data.combinations_settings.result_combinations_active = True
rfem_app.set_base_data(base_data=base_data)
# Step 3: Define and create the structure and load objects
objects = define_structure() + define_loads()
rfem_app.create_object_list(objects)
# Step 4: Generate Load Combinations
print("\nLoad Combinations:")
rfem_app.generate_combinations()
all_load_combi = rfem_app.get_object_list([rfem.loading.LoadCombination()])
result_combi_rows = []
for i, load_combi in enumerate(all_load_combi):
# Check if this is the last item in the list
print(f"CO{load_combi.no} - {load_combi.combination_rule_str}")
if i == len(all_load_combi) - 1:
operator = rfem.loading.ResultCombination.ItemsRow.OPERATOR_NONE
else:
operator = rfem.loading.ResultCombination.ItemsRow.OPERATOR_AND
result_combi_rows.append(
rfem.loading.ResultCombination.ItemsRow(
case_object_item=rfem.ObjectId(
no=load_combi.no,
object_type=rfem.OBJECT_TYPE_LOAD_COMBINATION,
),
case_object_factor=1,
operator=operator,
)
)
# Step 5: Create Result Combination
print("\nResult Combination:")
rfem_app.create_object(
rfem.loading.ResultCombination(
no=1,
user_defined_name_enabled=True,
name='All ULS',
design_situation=1,
items=rfem.loading.ResultCombination.ItemsTable(
rows = result_combi_rows,
)
)
)
result_combi = rfem_app.get_object(rfem.loading.ResultCombination(no=1))
print(f"{result_combi.name} - {result_combi.combination_rule_str}")
# Step 6: Read Results
rfem_app.calculate_all(skip_warnings=False)
results_df = rfem_app.get_results(
results_type=rfem.results.STATIC_ANALYSIS_MEMBER_INTERNAL_FORCES
).data
print("\nAll Results:")
print(results_df)
# Step 7: Find maximum m_y envelope on specific member
member_no = 2
loading = "RC1"
min_max = 'max'
tag = 'm_y'
my_max_df = results_df[
(results_df['member_no'] == member_no) &
(results_df['loading'] == loading) &
(results_df['min_max'] == min_max) &
(results_df['tag'] == tag)
]
print("\nMaximum My:")
print(my_max_df)
using rfem = Dlubal.Api.Rfem;
using Google.Protobuf;
public class frame
{
public static async Task FrameModel(Application rfem_app)
{
rfem.ApplicationInfo info = await rfem_app.get_application_info();
Console.WriteLine("\nVersion:\n" + info.Name + "\n");
await rfem_app.close_all_models(saveChanges: false);
await rfem_app.create_model("Frame");
await rfem_app.delete_all_objects();
var structure = new List<IMessage> {
new rfem.StructureCore.Material {
No = 1,
Name = "S235"
},
new rfem.StructureCore.Section {
No = 1,
Name = "HE 200 A",
Material = 1
},
new rfem.StructureCore.Node {
No=1
},
new rfem.StructureCore.Node {
No = 2,
Coordinate3 = -3
},
new rfem.StructureCore.Node {
No = 3,
Coordinate1 = 4,
Coordinate3 = -3
},
new rfem.StructureCore.Node {
No = 4,
Coordinate1 = 4
},
new rfem.StructureCore.Line {
No = 1,
DefinitionNodes = { 1, 2 }
},
new rfem.StructureCore.Line {
No = 2,
DefinitionNodes = { 2, 3 }
},
new rfem.StructureCore.Line {
No = 3,
DefinitionNodes = { 3, 4 }
},
new rfem.StructureCore.Member {
No = 1,
Line = 1,
SectionStart = 1
},
new rfem.StructureCore.Member {
No = 2,
Line = 2,
SectionStart = 1
},
new rfem.StructureCore.Member {
No = 3,
Line = 3,
SectionStart = 1
},
new rfem.TypesForNodes.NodalSupport {
No = 1,
Nodes = { 1, 4 },
SpringX = double.PositiveInfinity,
SpringY = double.PositiveInfinity,
SpringZ = double.PositiveInfinity,
RotationalRestraintX = double.PositiveInfinity,
RotationalRestraintY = double.PositiveInfinity,
RotationalRestraintZ = double.PositiveInfinity
}
};
await rfem_app.create_object_list(structure);
var loading = new List<IMessage> {
new rfem.Loading.StaticAnalysisSettings{
No = 1,
AnalysisType = rfem.Loading.StaticAnalysisSettings.Types.AnalysisType.GeometricallyLinear
},
new rfem.Loading.LoadCase {
No = 1,
Name = "Self-weight",
SelfWeightActive = true,
StaticAnalysisSettings = 1
},
new rfem.Loading.LoadCase {
No = 2,
Name = "Snow",
ActionCategory = rfem.Loading.LoadCase.Types.ActionCategory.SnowIceLoadsHLessOrEqualTo1000MQs,
StaticAnalysisSettings = 1
},
new rfem.Loading.LoadCase {
No = 3,
Name = "Wind +x",
ActionCategory = rfem.Loading.LoadCase.Types.ActionCategory.WindQw,
StaticAnalysisSettings = 1
},
new rfem.Loading.LoadCase {
No = 4,
Name = "Wind +x, with wind suction",
ActionCategory = rfem.Loading.LoadCase.Types.ActionCategory.WindQw,
StaticAnalysisSettings = 1
},
new rfem.Loading.LoadCase {
No = 5,
Name = "Wind -x",
ActionCategory = rfem.Loading.LoadCase.Types.ActionCategory.WindQw,
StaticAnalysisSettings = 1
},
new rfem.Loading.LoadCase {
No = 6,
Name = "Wind -x, with wind suction",
ActionCategory = rfem.Loading.LoadCase.Types.ActionCategory.WindQw,
StaticAnalysisSettings = 1
},
new rfem.Loads.MemberLoad {
No = 1,
LoadCase = 1,
Members = { 2 },
LoadType = rfem.Loads.MemberLoad.Types.LoadType.Force,
Magnitude = 1000
},
new rfem.Loads.MemberLoad {
No = 2,
LoadCase = 2,
Members = { 2 },
LoadType = rfem.Loads.MemberLoad.Types.LoadType.Force,
Magnitude = 3000
},
new rfem.Loads.MemberLoad {
No = 3,
LoadCase = 3,
Members = { 1 },
LoadType = rfem.Loads.MemberLoad.Types.LoadType.Force,
Magnitude = 2000,
LoadDirection = rfem.Loads.MemberLoad.Types.LoadDirection.GlobalXOrUserDefinedUTrueLength
},
new rfem.Loads.MemberLoad {
No = 4,
LoadCase = 3,
Members = { 3 },
LoadType = rfem.Loads.MemberLoad.Types.LoadType.Force,
Magnitude = 1000,
LoadDirection = rfem.Loads.MemberLoad.Types.LoadDirection.GlobalXOrUserDefinedUTrueLength
},
new rfem.Loads.MemberLoad {
No = 5,
LoadCase = 4,
Members = { 1 },
LoadType = rfem.Loads.MemberLoad.Types.LoadType.Force,
Magnitude = 2000,
LoadDirection = rfem.Loads.MemberLoad.Types.LoadDirection.GlobalXOrUserDefinedUTrueLength
},
new rfem.Loads.MemberLoad {
No = 6,
LoadCase = 4,
Members = { 3 },
LoadType = rfem.Loads.MemberLoad.Types.LoadType.Force,
Magnitude = 1000,
LoadDirection = rfem.Loads.MemberLoad.Types.LoadDirection.GlobalXOrUserDefinedUTrueLength
},
new rfem.Loads.MemberLoad {
No = 7,
LoadCase = 4,
Members = { 2 },
LoadType = rfem.Loads.MemberLoad.Types.LoadType.Force,
Magnitude = -500
},
new rfem.Loads.MemberLoad {
No = 8,
LoadCase = 5,
Members = { 1 },
LoadType = rfem.Loads.MemberLoad.Types.LoadType.Force,
Magnitude = -2000,
LoadDirection = rfem.Loads.MemberLoad.Types.LoadDirection.GlobalXOrUserDefinedUTrueLength
},
new rfem.Loads.MemberLoad {
No = 9,
LoadCase = 5,
Members = { 3 },
LoadType = rfem.Loads.MemberLoad.Types.LoadType.Force,
Magnitude = -1000,
LoadDirection = rfem.Loads.MemberLoad.Types.LoadDirection.GlobalXOrUserDefinedUTrueLength
},
new rfem.Loads.MemberLoad {
No = 10,
LoadCase = 6,
Members = { 1 },
LoadType = rfem.Loads.MemberLoad.Types.LoadType.Force,
Magnitude = -2000,
LoadDirection = rfem.Loads.MemberLoad.Types.LoadDirection.GlobalXOrUserDefinedUTrueLength
},
new rfem.Loads.MemberLoad {
No = 11,
LoadCase = 6,
Members = { 3 },
LoadType = rfem.Loads.MemberLoad.Types.LoadType.Force,
Magnitude = -1000,
LoadDirection = rfem.Loads.MemberLoad.Types.LoadDirection.GlobalXOrUserDefinedUTrueLength
},
new rfem.Loads.MemberLoad {
No = 12,
LoadCase = 6,
Members = { 2 },
LoadType = rfem.Loads.MemberLoad.Types.LoadType.Force,
Magnitude = -500,
},
};
await rfem_app.create_object_list(loading);
await rfem_app.calculate_all(skipWarnings: true);
var results = await rfem_app.get_results(
rfem.Results.ResultsId.StaticAnalysisMemberInternalForces
);
Console.WriteLine("Results:\nStatic Analysis | Members Internal Forces");
Console.WriteLine(results);
}
}