DesignApproach
One design approach (a column of the GUI's Design Approaches table): the
partial factors applied to loads, soil strength and structural strength
by every stage that uses it (stage.design_approach = 'ULS').
Reading a factor queries the running application; assigning one updates it immediately and the GUI table follows. "Unity" is read-only.
Examples
uls = project.design_approach['ULS']
uls.gamma_unfavorable_dead_load = 1.1
uls.gamma_unfavorable_live_load
1.65
uls.update(gamma_c=1.25, gamma_phi=1.25) # several factors, one call
uls.to_dict()
{'gamma_unfavorable_dead_load': 1.1, ...}
See also
Properties
- name : str
- The name as shown in the GUI ("SLS", "ULS", "ALS", "User 1", ...). gamma_unfavorable_dead_load, gamma_unfavorable_live_load,
- gamma_unfavorable_user1_load, gamma_unfavorable_user2_load : float
- Load factors for unfavourable dead, live, user 1 and user 2 loads. gamma_favorable_dead_load, gamma_favorable_live_load,
- gamma_favorable_user1_load, gamma_favorable_user2_load : float
- Load factors for favourable loads.
- gamma_c, gamma_phi, gamma_cu : float
- Soil strength factors on c', phi' and cu. gamma_anchor, gamma_general_plate, gamma_flat_plate_steel, gamma_sheet_pile, gamma_flat_plate_concrete_m, gamma_flat_plate_concrete_fc,
- gamma_flat_plate_concrete_ft, gamma_geogrid : float
- Structural strength factors.
- parameters : List[float]
- All factors as a list in the positional order of ``FIELDS`` (the legacy ``set_design_approach_parameters`` form).
- gamma_unfavorable_dead_load : float
- Load factor for unfavourable dead loads.
- gamma_unfavorable_live_load : float
- Load factor for unfavourable live loads.
- gamma_unfavorable_user1_load : float
- Load factor for unfavourable loads of safety type "user 1".
- gamma_unfavorable_user2_load : float
- Load factor for unfavourable loads of safety type "user 2".
- gamma_favorable_dead_load : float
- Load factor for favourable dead loads.
- gamma_favorable_live_load : float
- Load factor for favourable live loads.
- gamma_favorable_user1_load : float
- Load factor for favourable loads of safety type "user 1".
- gamma_favorable_user2_load : float
- Load factor for favourable loads of safety type "user 2".
- gamma_c : float
- Soil strength factor on the effective cohesion c'.
- gamma_phi : float
- Soil strength factor on the effective friction angle phi' (applied to tan phi').
- gamma_cu : float
- Soil strength factor on the undrained shear strength cu.
- gamma_anchor : float
- Structural strength factor for anchors (steel).
- gamma_general_plate : float
- Structural strength factor for General Plate materials.
- gamma_flat_plate_steel : float
- Structural strength factor for Flat Plate (steel) materials.
- gamma_sheet_pile : float
- Structural strength factor for Sheet Pile materials.
- gamma_flat_plate_concrete_m : float
- Flat Plate (concrete) factor on the moment capacity (gamma_m).
- gamma_flat_plate_concrete_fc : float
- Flat Plate (concrete) factor on the compressive strength (gamma_fc).
- gamma_flat_plate_concrete_ft : float
- Flat Plate (concrete) factor on the tensile strength (gamma_ft).
- gamma_geogrid : float
- Structural strength factor for Geogrid materials (gamma_np).
Methods
update()
Set several factors in one call.
Parameters
- **factors : float Keyword arguments named as in ``FIELDS``; a ``None`` value is skipped. Unknown names raise AttributeError.
Examples
project.design_approach['ULS'].update(gamma_c=1.25, gamma_phi=1.25)
to_dict()
All factors as {field: value} (one round trip). Feed the result
to update(**d) to restore or copy them.