Skip to main content
Version: 14

viktor.external.idea

Beam​

class viktor.external.idea_rcs.idea_rcs.Beam(rcs, check_section)

Bases: Member

Do not use this __init__ directly, but create the object by Model.create_beam().

CompressionMember​

class viktor.external.idea_rcs.idea_rcs.CompressionMember(rcs, check_section)

Bases: Member

Do not use this __init__ directly, but create the object by Model.create_compression_member().

GeneralShape​

class viktor.external.idea_rcs.idea_rcs.GeneralShape(outline, *, openings=None)

Bases: SectionPrototype1D

General cross-section, defined by a set of coordinates.

Parameters:

  • outline (Sequence[Tuple[float, float]]) – Vertices which define the outline of the section (y, z). A minimum of 3 vertices is required, the outline is automatically closed.

  • openings (Sequence[Sequence[Tuple[float, float]]]) – One or multiple openings, defined by vertices (y, z). A minimum of 3 vertices per opening is required, the opening is automatically closed.

IdeaRcsAnalysis​

class viktor.external.idea_rcs.idea_rcs.IdeaRcsAnalysis(input_file, *, return_result_xml=None, return_rcs_file=None)

Bases: ExternalProgram

Can be used to perform an analysis using IDEA StatiCa RCS on a third-party worker. To start an analysis call the method execute(), with an appropriate timeout (in seconds). To retrieve the results call the method get_output_file(), after execute().

Usage:

idea_rcs_file = File.from_data("idea rcs input file content")
idea_rcs_analysis = IdeaRcsAnalysis(input_file=idea_rcs_file)
idea_rcs_analysis.execute(timeout=10)
result = idea_rcs_analysis.get_output_file()

Exceptions which can be raised during calculation:

Parameters:

  • input_file (Union[BytesIO, File]) – IDEA (Open)Model input XML file.

  • return_result_xml (bool) – Result .xml file will be available if set to True (default: True).

  • return_rcs_file (bool) – Input .ideaRcs file will be available if set to True (default: False).

get_idea_rcs_file(*, as_file=False)

Method can be used to retrieve the .ideaRcs file which is converted from the (Open)Model input XML. The file is only available when return_rcs_file=True. execute() must be called first.

Return type:

Union[BytesIO, File, None]

Returns:

  • File, if as_file = True

  • BytesIO, if as_file = False (default)

get_output_file(*, as_file=False)

Method can be used to retrieve the results generated by running an external analysis. The file is only available when return_result_xml=True. execute() must be called first.

Return type:

Union[BytesIO, File, None]

Returns:

  • File (encoding=’utf-16’), if as_file = True

  • BytesIO (encoding=’utf-16’), if as_file = False (default)

Member​

class viktor.external.idea_rcs.idea_rcs.Member(rcs, check_section)

Base class of all member types.

property bars: List[ReinforcedBar]
create_bar(coordinates, diameter, material)

Create a reinforced bar on the reinforced cross-section.

Parameters:
Return type:

None

create_bar_layer(*, origin, diameter, material, number_of_bars, delta_y=None, delta_z=None)

Create multiple reinforced bars on the reinforced cross-section, positioned on a line.

Parameters:

  • origin (Tuple[float, float]) – Origin point (Y, Z) [m].

  • diameter (float) – Diameter of the bar [m].

  • material (MatReinforcement) – Reinforcement material (created by create_matreinforcement_ec2()).

  • number_of_bars (int) – Number of bars (minimum of 2).

  • delta_y (float) – Distance between origin bar and the last bar in y-direction [m].

  • delta_z (float) – Distance between origin bar and the last bar in z-direction [m].

Return type:

None

create_extreme(*, description=None, accidental=None, fatigue=None, frequent=None, fundamental=None, characteristic=None, quasi_permanent=None)

Create an extreme case with corresponding internal forces on the beam for checking.

Parameters:

  • description (str) – Description of the extreme (default: ‘{section_name} - E {i}’).

    New in v14.6.0

  • accidental (LoadingULS) – Accidental loading.

  • fatigue (FatigueLoading) – Fatigue loading.

  • frequent (LoadingSLS) – Frequent loading.

  • fundamental (LoadingULS) – Fundamental loading.

  • characteristic (LoadingSLS) – Characteristic loading.

  • quasi_permanent (LoadingSLS) – Quasi-Permanent loading.

Return type:

None

create_stirrup(points, diameter, material, distance, shear_check=None, torsion_check=None, mandrel_diameter_factor=None, anchorage_length=None)

Create a stirrup on the reinforced cross-section.

Parameters:

  • points (Sequence[Union[Tuple[float, float], Tuple[Tuple[float, float], Tuple[float, float]]]]) – Sequence of (X, Y) coordinates [m] of the stirrup vertices, connected by straight line segments. For arc-segments use ((X_end, Y_end), (X_on_arc, Y_on_arc)).

  • diameter (float) – Diameter of the stirrup [m].

  • material (MatReinforcement) – Reinforcement material (created by create_matreinforcement_ec2()).

  • distance (float) – Longitudinal distance between stirrups [m].

  • shear_check (bool) – Take stirrup into account in shear check (default: False).

  • torsion_check (bool) – Take stirrup into account in torsion check (default: False).

  • mandrel_diameter_factor (float) – Inner diameter of mandrel as multiple of stirrup diameter [-] (default: 1.0).

  • anchorage_length (float) – Anchorage length [m] (default: 0.0).

Return type:

None

property extremes: List[CheckSectionExtreme]
property stirrups: List[Stirrup]

Model​

class viktor.external.idea_rcs.idea_rcs.Model(*, project_data=None, code_settings=None)

Bases: _Model

Can be used to construct an IDEA-RCS model and generate its corresponding input XML file. This file can in turn be used as input of IdeaRcsAnalysis. For a more detailed elaboration, please see the guide.

Alternatively, you can use OpenModel.

Warning

Use this binding at own risk. Whether an input XML file represents a valid model is dependent on many things, e.g. on the combination of certain parameters. The Model does not give any guarantees on this. It is therefore important to always validate your model by hand thoroughly, before using it in an automated way within your app!

Example usage:

# Initialize the model.
model = Model()  # empty model, or optionally pass ProjectData and/or CodeSettings

# Create the desired material(s).
cs_mat = model.create_concrete_material(ConcreteMaterial.C12_15)
mat_reinf = model.create_reinforcement_material(ReinforcementMaterial.B_400A)

# Create a beam (or other type of member) to be checked.
cross_section = RectSection(0.5, 1.0)
beam = model.create_beam(cross_section, cs_mat)

# Create bars (and stirrups) as desired
bar_locations = [(-0.101, -0.175), (0.101, -0.175), (0.101, 0.175), (-0.101, 0.175)]
bar_diameters = [0.016, 0.016, 0.016, 0.016]

for coords, diameter in zip(bar_locations, bar_diameters):
    beam.create_bar(coords, diameter, mat_reinf)

# Add extreme(s)
freq = LoadingSLS(ResultOfInternalForces(N=-100000, My=210000))
fund = LoadingULS(ResultOfInternalForces(N=-99999, My=200000))
beam.create_extreme(frequent=freq, fundamental=fund)

# Generate the input XML file.
input_xml = model.generate_xml_input()
Parameters:

  • project_data (ProjectData) – project_data (default: IDEA-RCS default project_data)

  • code_settings (CodeSettings) – code and calculation settings (default: IDEA-RCS default settings)

project_data
code_settings
generate_xml_input(*, as_file=False)

Generates the input file XML representation of the IDEA-RCS model.

Warning

Whether an input XML file represents a valid model is dependent on many things, e.g. on the combination of certain parameters. The OpenModel does not give any guarantees on this. It is therefore important to always validate your model by hand thoroughly, before using it in an automated way within your app!

Note

This method needs to be mocked in (automated) unit and integration tests.

Parameters:

as_file (bool) – return as BytesIO (default) or File

New in v13.5.0

Return type:

Union[BytesIO, File]

create_beam(cs, material, *, calculation_control=None, name=None, rcs_name=None, design_member_name=None, exposure_classes=None, coeff_kx=None, creep_coefficient=None, relative_humidity=None)

Create a beam section.

Parameters:

  • cs (SectionPrototype1D) – Cross-section prototype.

  • material (MatConcrete) – Material for the cross-section (created by create_concrete_material()).

  • calculation_control (CalculationSetup) – Calculation control settings (default: Capacity N-M(-M) | Shear | Interaction | Stress Limitation | Crack width | Detailing).

  • name (str) – Name of the cross-section (default: ‘S{i}’).

  • rcs_name (str) – Name of the reinforced cross-section (default: ‘R{i}’).

  • design_member_name (str) – Name of the design member (default: ‘M {i}’).

    New in v14.6.0

  • exposure_classes (ExposureClassesDataEc2) – Corrosion exposure classes (default: no corrosion).

  • coeff_kx (float) – (Dutch annex only) Coefficient k_x acc. 7.3.1 (default: 1.0).

  • creep_coefficient (float) – Final value of creep coefficient (default: calculated by IDEA-RCS).

  • relative_humidity (float) – Percentage of relative humidity (default: 65).

Return type:

Beam

create_compression_member(cs, material, *, calculation_control=None, name=None, rcs_name=None, design_member_name=None, exposure_classes=None, coeff_kx=None, creep_coefficient=None, relative_humidity=None)

Create a compression member section.

Parameters:

  • cs (SectionPrototype1D) – Cross-section prototype.

  • material (MatConcrete) – Material for the cross-section (created by create_concrete_material()).

  • calculation_control (CalculationSetup) – Calculation control settings (default: Capacity N-M(-M) | Shear | Interaction | Stress Limitation | Crack width | Detailing).

  • name (str) – Name of the cross-section (default: ‘S{i}’).

  • rcs_name (str) – Name of the reinforced cross-section (default: ‘R{i}’).

  • design_member_name (str) – Name of the design member (default: ‘M {i}’).

    New in v14.6.0

  • exposure_classes (ExposureClassesDataEc2) – Corrosion exposure classes (default: no corrosion).

  • coeff_kx (float) – (Dutch annex only) Coefficient k_x acc. 7.3.1 (default: 1.0).

  • creep_coefficient (float) – Final value of creep coefficient (default: calculated by IDEA-RCS).

  • relative_humidity (float) – Percentage of relative humidity (default: 65).

Return type:

CompressionMember

create_concrete_material(base_material, name=None, *, unit_mass=2500, fck=None, stone_diameter=0.016, cement_class=ConcCementClass.R, aggregate_type=ConcAggregateType.QUARTZITE, diagram_type=ConcDiagramType.PARABOLIC, silica_fume=False, plain_concrete_diagram=False, dep_params=None)

Create a concrete material, to be used in create_beam() and similar methods.

Parameters:

  • base_material (ConcreteMaterial) – IDEA-RCS base material to start with.

  • name (str) – Name of the material (default: base_material name).

  • unit_mass (float) – Unit mass [kg/m3] (default: 2500 kg/m3).

  • fck (float) – Characteristic compressive cylinder strength of concrete at 28 days [MPa] (default: base_material fck).

  • stone_diameter (float) – Aggregate size (default: 16 mm).

  • cement_class (ConcCementClass) – Cement class (default: R).

  • aggregate_type (ConcAggregateType) – Aggregate type (default: Quartzite).

  • diagram_type (ConcDiagramType) – Type of stress-strain diagram for ULS calculation (default: Parabolic).

  • silica_fume (bool) – Contains silica fume (default: False) (EN 1992-2:2008-07 only).

  • plain_concrete_diagram (bool) – Stress strain diagram with tension part (default: False).

  • dep_params (ConcDependentParams) – Collection of a series of dependent parameters (see ConcDependentParams for more info). If None, values will be calculated based on ‘fck’ (default: None).

Return type:

MatConcreteEc2

create_one_way_slab(cs, material, *, calculation_control=None, name=None, rcs_name=None, design_member_name=None, exposure_classes=None, coeff_kx=None, creep_coefficient=None, relative_humidity=None)

Create a one-way slab member section.

Parameters:

  • cs (SectionPrototype1D) – Cross-section prototype.

  • material (MatConcrete) – Material for the cross-section (created by create_concrete_material()).

  • calculation_control (CalculationSetup) – Calculation control settings (default: Capacity N-M(-M) | Shear | Interaction | Stress Limitation | Crack width | Detailing).

  • name (str) – Name of the cross-section (default: ‘S{i}’).

  • rcs_name (str) – Name of the reinforced cross-section (default: ‘R{i}’).

  • design_member_name (str) – Name of the design member (default: ‘M {i}’).

    New in v14.6.0

  • exposure_classes (ExposureClassesDataEc2) – Corrosion exposure classes (default: no corrosion).

  • coeff_kx (float) – (Dutch annex only) Coefficient k_x acc. 7.3.1 (default: 1.0).

  • creep_coefficient (float) – Final value of creep coefficient (default: calculated by IDEA-RCS).

  • relative_humidity (float) – Percentage of relative humidity (default: 65).

Return type:

OneWaySlab

create_reinforcement_material(base_material, name=None, *, unit_mass=7850, e_modulus=200000, fyk=None, ftk_by_fyk=None, epsuk=None, type_=ReinfType.BARS, bar_surface=BarSurface.RIBBED, class_=ReinfClass.B, fabrication=ReinfFabrication.HOT_ROLLED, diagram_type=ReinfDiagramType.BILINEAR_INCLINED)

Create a reinforcement material, to be used in create_reinforcement_bar().

Parameters:

  • base_material (ReinforcementMaterial) – IDEA-RCS base material to start with.

  • name (str) – Name of the material (default: base_material name).

  • unit_mass (float) – Unit mass [kg/m3] (default: 7850 kg/m3).

  • e_modulus (float) – Young’s modulus [MPa] (default: 200000 MPa).

  • fyk (float) – Characteristic yield strength of reinforcement (default: base_material fyk).

  • ftk_by_fyk (float) – factor k = ratio ftk / fyk (default: base_material k).

  • epsuk (float) – Characteristic strain of reinforcement at maximum load - εuk [x 1e-4].

  • type – Type of reinforcement (default: Bars).

  • bar_surface (BarSurface) – Bar surface (default: Ribbed).

  • class – Class of reinforcement (default: B).

  • fabrication (ReinfFabrication) – Fabrication of reinforcement (default: Hot rolled).

  • diagram_type (ReinfDiagramType) – Type of material diagram (default: Bilinear with an inclined top branch).

Return type:

MatReinforcementEc2

OneWaySlab​

class viktor.external.idea_rcs.idea_rcs.OneWaySlab(rcs, check_section)

Bases: Member

Do not use this __init__ directly, but create the object by Model.create_one_way_slab().

OpenModel​

class viktor.external.idea_rcs.idea_rcs.OpenModel(*, project_data=None, code_settings=None)

Bases: _Model

Can be used to construct an IDEA-RCS model and generate its corresponding input XML file. This file can in turn be used as input of IdeaRcsAnalysis. For a more elaborate example implementation, please see the guide.

The OpenModel follows IDEA’s underlying API. Alternatively, you can use Model.

Warning

Use this binding at own risk. Whether an input XML file represents a valid model is dependent on many things, e.g. on the combination of certain parameters. The OpenModel does not give any guarantees on this. It is therefore important to always validate your model by hand thoroughly, before using it in an automated way within your app!

Example usage:

# Initialize the model.
model = OpenModel()  # empty model, or optionally pass ProjectData and/or CodeSettings

# Create the concrete section.
mat = model.create_matconcrete_ec2(ConcreteMaterial.C12_15)
cs = model.create_cross_section_parameter(name='cs', cross_section_type=CrossSectionType.RECT, material=mat,
                                          Width=2.0, Height=2.0)

# Create the reinforced cross-section.
rcs = model.create_reinforced_cross_section(name='rcs', cross_section=cs)

# Create bars (and stirrups) as desired
mat_reinf = model.create_matreinforcement_ec2(ReinforcementMaterial.B_400A)

bar_locations = [(-0.101, -0.175), (0.101, -0.175), (0.101, 0.175), (-0.101, 0.175)]
bar_diameters = [0.016, 0.016, 0.016, 0.016]

for coords, diameter in zip(bar_locations, bar_diameters):
    rcs.create_bar(coords, diameter, mat_reinf)

# Create a CheckMember.
member = model.create_check_member1d()

# 'Assign' the CheckMember to a CheckSection with the previously defined reinforced section and add extremes.
check_section = model.add_check_section(description='S 1', check_member=member, reinf_section=rcs)
freq = LoadingSLS(ResultOfInternalForces(N=-100000, My=210000))
fund = LoadingULS(ResultOfInternalForces(N=-99999, My=200000))
check_section.create_extreme(frequent=freq, fundamental=fund)

# 'Assign' the necessary additional data to the CheckMember.
model.add_member_data_ec2(member, MemberType.BEAM_SLAB, TwoWaySlabType.SHELL_AS_PLATE)

# Generate the input XML file.
input_xml = model.generate_xml_input()
Parameters:

  • project_data (ProjectData) – project_data (default: IDEA-RCS default project_data)

  • code_settings (CodeSettings) – code and calculation settings (default: IDEA-RCS default settings)

project_data
code_settings
generate_xml_input(*, as_file=False)

Generates the input file XML representation of the IDEA-RCS model.

Warning

Whether an input XML file represents a valid model is dependent on many things, e.g. on the combination of certain parameters. The OpenModel does not give any guarantees on this. It is therefore important to always validate your model by hand thoroughly, before using it in an automated way within your app!

Note

This method needs to be mocked in (automated) unit and integration tests.

Parameters:

as_file (bool) – return as BytesIO (default) or File

New in v13.5.0

Return type:

Union[BytesIO, File]

add_check_section(check_member, reinf_section, description=None)

Adds a single section check on the given CheckMember. Note that add_member_data_ec2() must be called subsequently.

Parameters:
Return type:

CheckSection

add_member_data_ec2(member, member_type, two_way_slab_type, *, calculation_setup=None, coeff_kx_for_wmax=None, exposure_class_data=None, creep_coefficient=None, relative_humidity=None)

Adds a concrete member Ec2 data to the model.

Parameters:

  • member (CheckMember) – CheckMember (created by create_check_member1d()). Should be previously added to a check section via add_check_section().

  • member_type (MemberType) – Structural type of member. Must be a valid type corresponding to the reinf_section assigned to the member in add_check_section().

  • two_way_slab_type (TwoWaySlabType) – Two-way slab type. Must be a valid type corresponding to the reinf_section assigned to the member in add_check_section().

  • calculation_setup (CalculationSetup) – Calculation control settings (default: Capacity N-M(-M) | Shear | Interaction | Stress Limitation | Crack width | Detailing).

  • coeff_kx_for_wmax (float) – (Dutch annex only) Coefficient kx to increase limited concrete crack (default: 1.0).

  • exposure_class_data (ExposureClassesDataEc2) – Exposure classes (default: no corrosion).

  • creep_coefficient (float) – Final value of creep coefficient (default: calculated by IDEA-RCS).

  • relative_humidity (float) – Percentage of relative humidity (default: 65).

Return type:

None

create_check_member1d(name=None)

Create a member 1D check, which can be used in add_check_section() and add_member_data_ec2().

Return type:

CheckMember1D

create_cross_section_component(name=None)

Create a cross-section object defined by one or multiple components and add it to the model.

Parameters:

name (str) – Name of cross-section (default: ‘’).

Return type:

CrossSectionComponent

create_cross_section_parameter(cross_section_type, material, name=None, **parameters)

Create a cross-section object defined by parameters and add it to the model.

Parameters:

  • cross_section_type (CrossSectionType) – Type of cross-section.

  • material (MatConcrete) – Material (created by create_matconcrete_ec2()).

  • name (str) – Name of cross-section (default: ‘’).

  • parameters (Any) – keyword naming should correspond to chosen cross_section_type(!).

Return type:

CrossSectionParameter

The following combinations of cross_section_type and parameters can be used (see the IDEA StatiCa interface for the naming convention):

  • O: D

  • RECT: Width, Height

  • TRAPEZOID: H, Bb, Bt

  • IGN: H, Bh, Bs, Ts, Th, Tw

  • IGH: H, Bh, Bs, Ts, Th, Tw, Bfh, Tfh

  • BEAM_SHAPE_I_HAUNCH_CHAMFER: Bbf, Hbf, Hbfh, Bw, H, Htfh, Htf, Btf, Bwh

  • TG: Height, Width, TopFlangeWidth, WallWidth

  • TTFH: Height, Width, TopFlangeWidth, WallWidth, TopFlangeHaunch

  • TGREV: Height, Width, TopFlangeWidth, WallWidth

  • TCHAMFER_1: Height, Width, TopFlangeWidth, WallWidth, TopFlangeHaunch2, WallHaunch2

  • TCHAMFER_2: Height, Width, TopFlangeWidth, WallWidth, TopFlangeHaunch2, WallHaunch1, WallHaunch2

  • TWH: Height, Width, TopFlangeWidth, WallWidth, WallHaunch

  • TTFHREV: Height, Width, TopFlangeWidth, WallWidth, TopFlangeHaunch

  • TWHREV: Height, Width, TopFlangeWidth, WallWidth, WallHaunch

create_matconcrete_ec2(base_material, name=None, *, e_modulus=32800, g_modulus=13667, poisson=0.2, unit_mass=2500, specific_heat=0.6, thermal_expansion=1e-05, thermal_conductivity=45, is_default=False, order_in_code=1, thermal_state=None, fck_28=None, stone_diameter=0.016, cement_class=ConcCementClass.R, aggregate_type=ConcAggregateType.QUARTZITE, diagram_type=ConcDiagramType.PARABOLIC, silica_fume=False, plain_concrete_diagram=False, dep_params=None)

Create a material concrete Ec2 object and add it to the model.

Parameters:

  • base_material (ConcreteMaterial) – IDEA-RCS base material to start with.

  • name (str) – Name of the material (default: base_material name).

  • e_modulus (float) – Young’s modulus [MPa] (default: 32800 MPa).

  • g_modulus (float) – Shear modulus [MPa] (default: 13667 MPa).

  • poisson (float) – Poisson’s ratio (default: 0.2).

  • unit_mass (float) – Unit mass [kg/m3] (default: 2500 kg/m3).

  • specific_heat (float) – Specific heat capacity (default: 0.6).

  • thermal_expansion (float) – Thermal expansion [1/K] (default: 1e-05).

  • thermal_conductivity (float) – Thermal conductivity (default: 45).

  • is_default (bool) – True if material is default material in IDEA-RCS code (default: False).

  • order_in_code (int) – Order of this material in the IDEA-RCS code (default: 1).

  • thermal_state (ThermalState) – Collection of thermal states for expansion, conductivity, specific heat, stress-strain and strain curvatures (default: ThermalState()).

  • fck_28 (float) – Characteristic compressive cylinder strength of concrete at 28 days [MPa] (default: base_material fck).

  • stone_diameter (float) – Aggregate size (default: 16 mm).

  • cement_class (ConcCementClass) – Cement class (default: R).

  • aggregate_type (ConcAggregateType) – Aggregate type (default: Quartzite).

  • diagram_type (ConcDiagramType) – Type of stress-strain diagram for ULS calculation (default: Parabolic).

  • silica_fume (bool) – Contains silica fume (default: False) (EN 1992-2:2008-07 only).

  • plain_concrete_diagram (bool) – Stress strain diagram with tension part (default: False).

  • dep_params (ConcDependentParams) – Collection of a series of dependent parameters (see ConcDependentParams for more info). If None, values will be calculated based on ‘fck’ (default: None).

Return type:

MatConcreteEc2

create_matreinforcement_ec2(base_material, name=None, *, e_modulus=200000, g_modulus=83333, poisson=0.2, unit_mass=7850, specific_heat=0.6, thermal_expansion=1e-05, thermal_conductivity=45, is_default=False, order_in_code=1, thermal_state=None, bar_surface=BarSurface.RIBBED, fyk=None, ftk_by_fyk=None, epsuk=None, ftk=None, class_=ReinfClass.B, type_=ReinfType.BARS, fabrication=ReinfFabrication.HOT_ROLLED, diagram_type=ReinfDiagramType.BILINEAR_INCLINED)

Create a material reinforcement Ec2 object and add it to the model.

Parameters:

  • base_material (ReinforcementMaterial) – IDEA-RCS base material to start with.

  • name (str) – Name of the material (default: base_material name).

  • e_modulus (float) – Young’s modulus [MPa] (default: 200000 MPa).

  • g_modulus (float) – Shear modulus [MPa] (default: 83333 MPa).

  • poisson (float) – Poisson’s ratio (default: 0.2).

  • unit_mass (float) – Unit mass [kg/m3] (default: 7850 kg/m3).

  • specific_heat (float) – Specific heat capacity (default: 0.6).

  • thermal_expansion (float) – Thermal expansion [1/K] (default: 1e-05).

  • thermal_conductivity (float) – Thermal conductivity (default: 45).

  • is_default (bool) – True if material is default material in IDEA-RCS code (default: False).

  • order_in_code (int) – Order of this material in the IDEA-RCS code (default: 1).

  • thermal_state (ThermalState) – Collection of thermal states for expansion, conductivity, specific heat, stress-strain and strain curvatures (default: ThermalState()).

  • bar_surface (BarSurface) – Bar surface (default: Ribbed).

  • fyk (float) – Characteristic yield strength of reinforcement (default: base_material fyk).

  • ftk_by_fyk (float) – factor k = ratio ftk / fyk (default: base_material k).

  • epsuk (float) – Characteristic strain of reinforcement at maximum load - εuk [x 1e-4].

  • ftk (float) – Characteristic tensile strength of reinforcement (default: base_material ftk).

  • class – Class of reinforcement (default: B).

  • type – Type of reinforcement (default: Bars).

  • fabrication (ReinfFabrication) – Fabrication of reinforcement (default: Hot rolled).

  • diagram_type (ReinfDiagramType) – Type of material diagram (default: Bilinear with an inclined top branch).

Return type:

MatReinforcementEc2

create_reinforced_cross_section(cross_section, name=None)

Create a reinforced cross-section object and add it to the model.

Parameters:
Return type:

ReinforcedCrossSection

OutputFileParser​

class viktor.external.idea_rcs.idea_rcs.OutputFileParser(xml_file)

Helper class to extract results from a IDEA-RCS output file (.xml).

Note, for very large result files we advise to make use of RcsOutputFileParser instead.

Parameters:

xml_file (StringIO) – valid IDEA-RCS XML output file.

Raises:

ParsingError – if ‘xml_file’ can not be parsed (not a valid format).

Example usage:

parser = OutputFileParser(xml_file)
for section in parser.section_ids:
    capacity_results = parser.capacity_results(section)
    ...

In case you require results which are not supported, you can retrieve the raw results using the raw_results() method.

capacity_results(section_id)

Get the result of applied internal forces of all extremes for the section with provided ‘section_id’.

Parameters:

section_id (int) – id of the check section. Must be present in the output file.

Raises:

ParsingError – if ‘section_id’ is not present in output file.

Return type:

List[Optional[Dict[str, Any]]]

See capacity() for return format.

crack_width_results(section_id)

Get the crack width (short/long) results for all extremes for the section with provided ‘section_id’.

Parameters:

section_id (int) – id of the check section. Must be present in the output file.

Raises:

ParsingError – if ‘section_id’ is not present in output file.

Return type:

List[Optional[Dict[str, Optional[Dict[str, Any]]]]]

See crack_width() for return format.

detailing_results(section_id)

Get the unity checks of the longitudinal reinforcement and shear reinforcement for all extremes for the section with provided ‘section_id’.

Parameters:

section_id (int) – id of the check section. Must be present in the output file.

Raises:

ParsingError – if ‘section_id’ is not present in output file.

Return type:

List[Optional[Dict[str, Optional[float]]]]

See detailing() for return format.

fatigue_results(section_id)

Get the fatigue results for all extremes for the provided ‘section_id’.

Parameters:

section_id (int) – id of the check section. Must be present in the output file.

Raises:

ParsingError – if ‘section_id’ is not present in output file.

Return type:

List[Optional[dict]]

See fatigue() for return format.

raw_results()

Get the (complete) raw results in dict form. Can be used if results need to be extracted that are not supported by the available methods.

Return type:

dict

property section_ids: List[int]

Get all section ids for which results are present in the result file.

shear_results(section_id)

Get the shear resistances for all extremes for the section with provided ‘section_id’.

Parameters:

section_id (int) – id of the check section. Must be present in the output file.

Raises:

ParsingError – if ‘section_id’ is not present in output file.

Return type:

List[Optional[Dict[str, Any]]]

See shear() for return format.

stress_limitation_results(section_id)

Get the short- and long-term stress limitation results for all extremes for provided ‘section_id’.

Parameters:

section_id (int) – id of the check section. Must be present in the output file.

Raises:

ParsingError – if ‘section_id’ is not present in output file.

Return type:

List[Optional[Dict[str, Optional[float]]]]

See stress_limitation() for return format.

RcsOutputFileParser​

class viktor.external.idea_rcs.idea_rcs.RcsOutputFileParser(xml_file)

Parser to extract results from an IDEA-RCS output file (.xml).

Currently the following data can be extracted:

Example using File:

xml_file = idea_rcs_analysis.get_output_file(as_file=True)
with xml_file.open_binary() as f:
    parser = RcsOutputFileParser(f)

    # loop through all sections
    for section in parser.section_results():
        capacity_results = section.capacity()
        shear_results = section.shear()

    # or get results for a single section
    section_4 = parser.section_result(4)
    ...

    # or loop through all extremes within a section
    for extreme in section_4.extremes():
        capacity = extreme['capacity']
        ...

Example using BytesIO:

xml_file = idea_rcs_analysis.get_output_file()
parser = RcsOutputFileParser(xml_file)

for section in parser.section_results():
    ...
Parameters:

xml_file (BinaryIO) – IDEA-RCS XML output file (.xml).

class SectionResult(id_, element)

Parsed result section, on which specific results can be retrieved.

Do not instantiate this object directly, but retrieve it through RcsOutputFileParser.section_results().

capacity()

Get the capacity results of all extremes for the current section.

Returns a list of dictionaries (or None if not present for a certain extreme) in the following format:

[
    {
        'Fu': {
            'N': <float>,
            'Qy': <float>,
            'Qz': <float>,
            'Mx': <float>,
            'My': <float>,
            'Mz': <float>
        },
        'Fu1': {
            ...  # see 'Fu'
        } | None,
        'Fu2': {
            ...  # see 'Fu'
        } | None,
        'CheckValue': <float>,
        'Result': <str>  # new in v13.4.0
    } | None,
    ...
]
Return type:

List[Optional[dict]]

crack_width()

Get the crack width (short/long) results for all extremes for the current section.

Returns a list of dictionaries (or None if not present for a certain extreme) in the following format:

[
    {
        'short': {
            'N': <float>,
            'My': <float>,
            'Mz': <float>,
            'W': <float>,
            'Wlim': <float>,
            'CheckValue': <float>,
            'Result': <str>  # new in v13.4.0
        } | None,
        'long': {
            ...  # see 'short'
        } | None,
    } | None,
    ...
]
Return type:

List[Optional[dict]]

detailing()

Get the unity checks of the longitudinal reinforcement and shear reinforcement for all extremes for the current section.

Returns a list of dictionaries (or None if not present for a certain extreme) in the following format:

[
    {
        'longitudinal': <float> | None,
        'shear': <float> | None,
        'CheckValue': <float>,  # new in v13.4.0
        'CheckValueLongReinf': <float>,  # new in v13.4.0
        'CheckValueShearReinf': <float>,  # new in v13.4.0
        'Result': <str>  # new in v13.4.0
    } | None,
    ...
]
Return type:

List[Optional[dict]]

extremes()

Get all results combined per extreme for the current section.

Returns a list of dictionaries in the following format:

[
    {
        'capacity': {...} | None,
        'shear': {...} | None,
        'torsion': {...} | None,        # new in v13.4.0
        'interaction': {...} | None,    # new in v13.4.0
        'crack_width': {...} | None,
        'detailing': {...} | None,
        'stress_limitation': {...} | None,
        'fatigue': {...} | None,
    },
    ...
]
Return type:

List[dict]

fatigue()

Get the fatigue results for all extremes for the current section.

Returns a list of dictionaries (or None if not present for a certain extreme) in the following format:

[
    {
        'fatigue': {
            'CheckValue': <float>,
            'DecisionMethod': <str>,
            'Result': <str>  # new in v13.4.0
        },
        'shear': {
            'max': {
                'Ved': <float>,
                'Vrdc': <float>,
                'Vrd': <float>,
                'Vrdmax': <float>,
                'Vrdr': <float>,
                'Vrds': <float>,
                'CheckValue': <float>,
                'Result': <str>  # new in v13.4.0
            },
            'min': {
                ...  # see 'max'
            },
        }
    } | None,
    ...
]
Return type:

List[Optional[dict]]

property id_: int

Returns the ‘SectionId’ of current section.

interaction()

New in v13.4.0

Get the interaction results for all extremes for the current section.

Returns a list of dictionaries (or None if not present for a certain extreme) in the following format:

[
    {
        'Ned': <float>,
        'Medy': <float>,
        'Medz': <float>,
        'Ved': <float>,
        'Ted': <float>,
        'CheckValue': <float>,
        'CheckValueShearAndTorsion': <float>,
        'CheckValueShearTorsionAndBending': <float>,
        'Result': <str>
    } | None,
    ...
]
Return type:

List[Optional[dict]]

shear()

Get the shear resistances for all extremes for the current section.

Returns a list of dictionaries (or None if not present for a certain extreme) in the following format:

[
    {
        'Ved': <float>,
        'Vrdc': <float>,
        'Vrd': <float>,
        'Vrdmax': <float>,
        'Vrdr': <float>,
        'Vrds': <float>,
        'CheckValue': <float>,
        'Result': <str>  # new in v13.4.0
    } | None,
    ...
]
Return type:

List[Optional[dict]]

stress_limitation()

Get the short- and long-term stress limitation results for all extremes for the current section.

Returns a list of dictionaries (or None if not present for a certain extreme) in the following format:

[
    {
        'Check_7_2_2_Concrete_fck': {  # new in v13.4.0
            'short': {
                'Stress': <float> | None,
                'CheckValue': <float>,
                'Result': <str>
            } | None,
            'long': {
                ...  # see 'short'
            } | None
        } | None,
        'Check_7_2_3_Concrete_fck': {  # new in v13.4.0
            ...  # see 'Check_7_2_2_Concrete_fck'
        } | None,
        'Check_7_2_5_Tendons_fpk': {  # new in v13.4.0
            ...  # see 'Check_7_2_2_Concrete_fck'
        } | None,
        'Check_7_2_5_ReinforcementBars_fyk': {  # new in v13.4.0
            ...  # see 'Check_7_2_2_Concrete_fck'
        } | None,
        'Check_5_10_3_2_Tendons': {  # new in v13.4.0
            ...  # see 'Check_7_2_2_Concrete_fck'
        } | None,
        'Check_5_10_2_1_1_Tendons': {  # new in v13.4.0
            ...  # see 'Check_7_2_2_Concrete_fck'
        } | None,
        'short': {
            'Check_7_2_2_Concrete_fck': <float> | None,
            ...  # see above for all keys
        } | None,
        'long': {
            'Check_7_2_2_Concrete_fck': <float> | None,
            ...  # see above for all keys
        } | None,
    } | None,
    ...
]
Return type:

List[Optional[dict]]

torsion()

New in v13.4.0

Get the torsion results for all extremes for the current section.

Returns a list of dictionaries (or None if not present for a certain extreme) in the following format:

[
    {
        'Ted': <float>,
        'Trdc': <float>,
        'Trdmax': <float>,
        'Trds': <float>,
        'Trd': <float>,
        'CheckValue': <float>,
        'Result': <str>
    } | None,
    ...
]
Return type:

List[Optional[dict]]

section_result(id_)

Retrieve the section result of the provided id.

Return type:

SectionResult

section_results()

Iterates through all section results.

Usage:

for section in parser.section_results():
    capacity_results = section.capacity()

    if section.id_ == 3:
        ...
Return type:

Iterator[SectionResult]

RectSection​

class viktor.external.idea_rcs.idea_rcs.RectSection(width, height)

Bases: SectionPrototype1D

Rectangular section.

The origin is located in the centroid of this section.

Parameters:

  • width (float) – Width of the section.

  • height (float) – Height of the section.

SectionPrototype1D​

class viktor.external.idea_rcs.idea_rcs.SectionPrototype1D

Bases: _SectionPrototype, ABC

Abstract base class of all 1D (beam-like) section prototypes.

BarSurface​

class viktor.external.idea_rcs.objects.BarSurface(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: Enum

RIBBED: BarSurface = 1
SMOOTH: BarSurface = 0

CalculationSetup​

class viktor.external.idea_rcs.objects.CalculationSetup(*, uls_response=None, uls_diagram=None, uls_shear=None, uls_torsion=None, uls_interaction=None, sls_crack=None, sls_stress_limitation=None, sls_stiffnesses=None, detailing=None, m_n_kappa_diagram=None, fatigue=None, cross_section_characteristics=None)

Bases: _OpenObject

Concrete calculation setup.

Parameters:

  • uls_response (bool) – Response N-M(-M) (default: False).

  • uls_diagram (bool) – Capacity N-M(-M) (default: True).

  • uls_shear (bool) – Shear (default: True).

  • uls_torsion (bool) – Torsion (default: True).

  • uls_interaction (bool) – Interaction (default: True).

  • sls_crack (bool) – Crack width (default: True).

  • sls_stress_limitation (bool) – Stress limitation (default: True).

  • sls_stiffnesses (bool) – Stiffnesses (default: False).

  • detailing (bool) – Detailing (default: True).

  • m_n_kappa_diagram (bool) – M-N-κ diagram (default: False).

  • fatigue (bool) – Fatigue (default: True).

  • cross_section_characteristics (bool) – Cross-section characteristics (default: IDEA-RCS default).

CheckMember​

class viktor.external.idea_rcs.objects.CheckMember(id_)

Bases: _OpenElementId, ABC

Abstract base class of all check members.

CheckMember1D​

class viktor.external.idea_rcs.objects.CheckMember1D(id_, name)

Bases: CheckMember

Do not use this __init__ directly, but create the object by create_check_member1d().

CheckSection​

class viktor.external.idea_rcs.objects.CheckSection(id_, description, check_member, reinf_section, extremes=None)

Bases: _OpenElementId, ABC

Abstract base class of all check sections.

create_extreme(*, description=None, accidental=None, fatigue=None, frequent=None, fundamental=None, characteristic=None, quasi_permanent=None)

Create an extreme case with corresponding internal forces on the section for checking.

Parameters:

  • description (str) – Description of the extreme (default: ‘{section_name} - E {i}’).

    New in v14.6.0

  • accidental (LoadingULS) – Accidental loading.

  • fatigue (FatigueLoading) – Fatigue loading.

  • frequent (LoadingSLS) – Frequent loading.

  • fundamental (LoadingULS) – Fundamental loading.

  • characteristic (LoadingSLS) – Characteristic loading.

  • quasi_permanent (LoadingSLS) – Quasi-Permanent loading.

Return type:

None

property extremes: List[CheckSectionExtreme]

CheckSectionExtreme​

class viktor.external.idea_rcs.objects.CheckSectionExtreme(accidental=None, fatigue=None, frequent=None, fundamental=None, characteristic=None, quasi_permanent=None, *, description)

Bases: _OpenObject

Abstract base class of all check section extremes.

CodeSettings​

class viktor.external.idea_rcs.objects.CodeSettings(*, evaluation_interaction_diagram=None, theta=None, theta_min=None, theta_max=None, n_cycles_fatigue=None, no_resistance_concrete_tension_1d=None, type_sls_calculation=None)

Bases: _OpenObject

Code and calculation settings.

Parameters:

  • evaluation_interaction_diagram (EvaluationInteractionDiagram) – evaluation of interaction diagram (default: NuMuMu)

  • theta (float) – angle [deg] between the concrete compression strut and the beam axis perpendicular to the shear force (default: set by IDEA)

  • theta_min (float) – minimum angle [deg] between the concrete compression strut and the beam axis perpendicular to the shear force (default: set by IDEA)

  • theta_max (float) – maximum angle [deg] between the concrete compression strut and the beam axis perpendicular to the shear force (default: set by IDEA)

  • n_cycles_fatigue (float) – number of fatigue cycles (* 10⁶) (default: set by IDEA)

  • no_resistance_concrete_tension_1d (NoResistanceConcreteTension1d) – no resistance of concrete in tension - members 1D (default: Extreme)

  • type_sls_calculation (TypeSLSCalculation) – type of SLS calculation (default: Both)

ConcAggregateType​

class viktor.external.idea_rcs.objects.ConcAggregateType(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: Enum

BASALT: ConcAggregateType = 3
LIMESTONE: ConcAggregateType = 1
QUARTZITE: ConcAggregateType = 0
SANDSTONE: ConcAggregateType = 2

ConcCementClass​

class viktor.external.idea_rcs.objects.ConcCementClass(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: Enum

N: ConcCementClass = 2
R: ConcCementClass = 1
S: ConcCementClass = 0

ConcDependentParams​

class viktor.external.idea_rcs.objects.ConcDependentParams(E_cm, eps_c1, eps_c2, eps_c3, eps_cu1, eps_cu2, eps_cu3, F_ctm, F_ctk_0_05, F_ctk_0_95, n_factor, F_cm)

Bases: _OpenObject

Collection of all MatConcreteEc2 dependent parameters.

Parameters:

  • E_cm (float) – Secant modulus of elasticity of concrete [MPa]

  • eps_c1 (float) – Compressive strain in the concrete - εc1 [-]

  • eps_c2 (float) – Compressive strain in the concrete - εc2 [-]

  • eps_c3 (float) – Compressive strain in the concrete - εc3 [-]

  • eps_cu1 (float) – Ultimate compressive strain in the concrete - εcu1 [-]

  • eps_cu2 (float) – Ultimate compressive strain in the concrete - εcu2 [-]

  • eps_cu3 (float) – Ultimate compressive strain in the concrete - εcu3 [-]

  • F_ctm (float) – Mean value of axial tensile strength of concrete [MPa]

  • F_ctk_0_05 (float) – Characteristic axial tensile strength of concrete 5% quantile [MPa]

  • F_ctk_0_95 (float) – Characteristic axial tensile strength of concrete 95% quantile [MPa]

  • n_factor (float) – Coefficient n-factor - necessary parabolic part of stress-strain diagram - n [-]

  • F_cm (float) – Mean value of concrete cylinder compressive strength [MPa]

ConcDiagramType​

class viktor.external.idea_rcs.objects.ConcDiagramType(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: Enum

BILINEAR: ConcDiagramType = 0
PARABOLIC: ConcDiagramType = 1
USER: ConcDiagramType = 2

ConcreteMaterial​

class viktor.external.idea_rcs.objects.ConcreteMaterial(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: Enum

C100_115: ConcreteMaterial = 15
C12_15: ConcreteMaterial = 1
C16_20: ConcreteMaterial = 2
C20_25: ConcreteMaterial = 3
C25_30: ConcreteMaterial = 4
C30_37: ConcreteMaterial = 5
C35_45: ConcreteMaterial = 6
C40_50: ConcreteMaterial = 7
C45_55: ConcreteMaterial = 8
C50_60: ConcreteMaterial = 9
C55_67: ConcreteMaterial = 10
C60_75: ConcreteMaterial = 11
C70_85: ConcreteMaterial = 12
C80_95: ConcreteMaterial = 13
C90_105: ConcreteMaterial = 14

ConcreteMemberData​

class viktor.external.idea_rcs.objects.ConcreteMemberData(element, member_type, two_way_slab_type, calculation_setup=None)

Bases: _OpenObject, ABC

Abstract base class of all concrete member data.

ConcreteMemberDataEc2​

class viktor.external.idea_rcs.objects.ConcreteMemberDataEc2(element, member_type, two_way_slab_type, calculation_setup=None, coeff_kx_for_wmax=None, exposure_class_data=None, creep_coefficient=None, relative_humidity=None)

Bases: ConcreteMemberData

Do not use this __init__ directly, but create the object by add_member_data_ec2().

CrossSection​

class viktor.external.idea_rcs.objects.CrossSection(id_, name)

Bases: _OpenElementId, ABC

Abstract base class of all cross-sections.

CrossSectionComponent​

class viktor.external.idea_rcs.objects.CrossSectionComponent(id_, name)

Bases: CrossSection

Do not use this __init__ directly, but create the object by create_cross_section_component().

create_component(outline, material, *, openings=None)

Create a component to build up the cross-section.

Parameters:

  • outline (Sequence[Tuple[float, float]]) – Vertices which define the outline of the section (y, z). A minimum of 3 vertices is required, the outline is automatically closed.

  • material (MatConcrete) – Material (created by create_matconcrete_ec2()).

  • openings (Sequence[Sequence[Tuple[float, float]]]) – One or multiple openings, defined by vertices (y, z). A minimum of 3 vertices per opening is required, the opening is automatically closed.

Return type:

None

CrossSectionParameter​

class viktor.external.idea_rcs.objects.CrossSectionParameter(id_, name, cross_section_type, material, **parameters)

Bases: CrossSection

Do not use this __init__ directly, but create the object by create_cross_section_parameter().

CrossSectionType​

class viktor.external.idea_rcs.objects.CrossSectionType(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: Enum

BEAM_SHAPE_BOX: CrossSectionType = 79
BEAM_SHAPE_BOX_1: CrossSectionType = 80
BEAM_SHAPE_IREV_DEGEN: CrossSectionType = 83
BEAM_SHAPE_IREV_DEGEN_ADD: CrossSectionType = 84
BEAM_SHAPE_I_HAUNCH_CHAMFER: CrossSectionType = 76
BEAM_SHAPE_I_HAUNCH_CHAMFER_ASYM: CrossSectionType = 77
BEAM_SHAPE_I_Z_DEGEN: CrossSectionType = 88
BEAM_SHAPE_L_DEGEN: CrossSectionType = 89
BEAM_SHAPE_REV_U: CrossSectionType = 78
BEAM_SHAPE_TREV_CHAMFER_HAUNCH_D: CrossSectionType = 82
BEAM_SHAPE_TREV_CHAMFER_HAUNCH_S: CrossSectionType = 81
BEAM_SHAPE_TREV_DEGEN: CrossSectionType = 85
BEAM_SHAPE_TREV_DEGEN_ADD: CrossSectionType = 86
BEAM_SHAPE_Z_DEGEN: CrossSectionType = 87
BOX_2I: CrossSectionType = 18
BOX_2L: CrossSectionType = 21
BOX_2U: CrossSectionType = 19
BOX_2U_2PI: CrossSectionType = 20
BOX_4L: CrossSectionType = 22
BOX_FL: CrossSectionType = 16
BOX_WEB: CrossSectionType = 17
CHS_G: CrossSectionType = 34
CHS_PAR: CrossSectionType = 101
COMPOSITE_BEAM_BOX: CrossSectionType = 53
COMPOSITE_BEAM_BOX_1: CrossSectionType = 54
COMPOSITE_BEAM_IGEN_T: CrossSectionType = 55
COMPOSITE_BEAM_L_LEFT: CrossSectionType = 56
COMPOSITE_BEAM_PLATE: CrossSectionType = 57
COMPOSITE_BEAM_R_RES_T: CrossSectionType = 58
COMPOSITE_BEAM_R_RES_T_1: CrossSectionType = 59
COMPOSITE_BEAM_R_T: CrossSectionType = 60
COMPOSITE_BEAM_SHAPE_CHAMF: CrossSectionType = 61
COMPOSITE_BEAM_SHAPE_CHAMF_ASYM: CrossSectionType = 62
COMPOSITE_BEAM_SHAPE_IGEN: CrossSectionType = 63
COMPOSITE_BEAM_SHAPE_I_T: CrossSectionType = 64
COMPOSITE_BEAM_SHAPE_I_T_ASYM: CrossSectionType = 65
COMPOSITE_BEAM_SHAPE_T_T: CrossSectionType = 75
COMPOSITE_BEAM_TRAPEZOID: CrossSectionType = 67
COMPOSITE_BEAM_TRES_T: CrossSectionType = 68
COMPOSITE_BEAM_TREV: CrossSectionType = 69
COMPOSITE_BEAM_TREV_RES_I: CrossSectionType = 70
COMPOSITE_BEAM_TREV_RES_I_1: CrossSectionType = 71
COMPOSITE_BEAM_TREV_RES_R: CrossSectionType = 72
COMPOSITE_BEAM_TREV_RES_R_1: CrossSectionType = 73
COMPOSITE_BEAM_TREV_T: CrossSectionType = 74
COMPOSITE_BEAM_T_LEFT: CrossSectionType = 66
GENERAL: CrossSectionType = 38
GENERAL_CONCRETE: CrossSectionType = 52
GENERAL_STEEL: CrossSectionType = 51
IGH: CrossSectionType = 29
IGN: CrossSectionType = 28
IW: CrossSectionType = 23
IWN: CrossSectionType = 24
LG: CrossSectionType = 31
LG_MIRRORED: CrossSectionType = 32
O: CrossSectionType = 26
ONE_COMPONENT_CSS: CrossSectionType = 0
OVAL: CrossSectionType = 37
RECT: CrossSectionType = 27
RHS_G: CrossSectionType = 36
ROLLED_2I: CrossSectionType = 39
ROLLED_ANGLE: CrossSectionType = 2
ROLLED_CHS: CrossSectionType = 5
ROLLED_DOUBLE_LT: CrossSectionType = 10
ROLLED_DOUBLE_LU: CrossSectionType = 11
ROLLED_DOUBLE_UC: CrossSectionType = 8
ROLLED_DOUBLE_UO: CrossSectionType = 7
ROLLED_I: CrossSectionType = 1
ROLLED_I_PAR: CrossSectionType = 13
ROLLED_L_PAR: CrossSectionType = 15
ROLLED_RHS: CrossSectionType = 6
ROLLED_T: CrossSectionType = 3
ROLLED_TI: CrossSectionType = 12
ROLLED_U: CrossSectionType = 4
ROLLED_U_PAR: CrossSectionType = 14
SG: CrossSectionType = 50
TCHAMFER_1: CrossSectionType = 46
TCHAMFER_2: CrossSectionType = 47
TG: CrossSectionType = 30
TGREV: CrossSectionType = 43
TRAPEZOID: CrossSectionType = 40
TT: CrossSectionType = 48
TT1: CrossSectionType = 49
TTFH: CrossSectionType = 41
TTFHREV: CrossSectionType = 44
TW: CrossSectionType = 25
TWH: CrossSectionType = 42
TWHREV: CrossSectionType = 45
UG: CrossSectionType = 33
UNIQUE_NAME: CrossSectionType = 1001
ZG: CrossSectionType = 35

EvaluationInteractionDiagram​

class viktor.external.idea_rcs.objects.EvaluationInteractionDiagram(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: Enum

NU_MU_MU: EvaluationInteractionDiagram = 0
NU_M_M: EvaluationInteractionDiagram = 1
N_MU_MU: EvaluationInteractionDiagram = 2

ExposureClassEc2Carbonation​

class viktor.external.idea_rcs.objects.ExposureClassEc2Carbonation(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: Enum

XC1: ExposureClassEc2Carbonation = 1
XC2: ExposureClassEc2Carbonation = 2
XC3: ExposureClassEc2Carbonation = 3
XC4: ExposureClassEc2Carbonation = 4

ExposureClassEc2ChemicalAttack​

class viktor.external.idea_rcs.objects.ExposureClassEc2ChemicalAttack(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: Enum

XA1: ExposureClassEc2ChemicalAttack = 1
XA2: ExposureClassEc2ChemicalAttack = 2
XA3: ExposureClassEc2ChemicalAttack = 3

ExposureClassEc2Chlorides​

class viktor.external.idea_rcs.objects.ExposureClassEc2Chlorides(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: Enum

XD1: ExposureClassEc2Chlorides = 1
XD2: ExposureClassEc2Chlorides = 2
XD3: ExposureClassEc2Chlorides = 3

ExposureClassEc2ChloridesFromSea​

class viktor.external.idea_rcs.objects.ExposureClassEc2ChloridesFromSea(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: Enum

XS1: ExposureClassEc2ChloridesFromSea = 1
XS2: ExposureClassEc2ChloridesFromSea = 2
XS3: ExposureClassEc2ChloridesFromSea = 3

ExposureClassEc2FreezeAttack​

class viktor.external.idea_rcs.objects.ExposureClassEc2FreezeAttack(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: Enum

XF1: ExposureClassEc2FreezeAttack = 1
XF2: ExposureClassEc2FreezeAttack = 2
XF3: ExposureClassEc2FreezeAttack = 3
XF4: ExposureClassEc2FreezeAttack = 4

ExposureClassesDataEc2​

class viktor.external.idea_rcs.objects.ExposureClassesDataEc2(*, carbonation=None, chlorides=None, chlorides_from_sea=None, freeze_attack=None, chemical_attack=None)

Bases: _OpenObject

Exposure Classes Ec2.

Parameters:

FatigueLoading​

class viktor.external.idea_rcs.objects.FatigueLoading(max_loading, min_loading)

Bases: _OpenObject

Fatigue loading.

Parameters:

  • max_loading (LoadingULS) – Max. cyclic loading.

  • min_loading (LoadingULS) – Min. cyclic loading.

LoadingSLS​

class viktor.external.idea_rcs.objects.LoadingSLS(internal_forces, internal_forces_imperfection=None)

Bases: _OpenObject

Loading SLS.

Parameters:

LoadingULS​

class viktor.external.idea_rcs.objects.LoadingULS(internal_forces, internal_forces_second_order=None, internal_forces_begin=None, internal_forces_end=None, internal_forces_imperfection=None)

Bases: _OpenObject

Loading ULS.

Parameters:

MatConcrete​

class viktor.external.idea_rcs.objects.MatConcrete(id_, name, e_modulus, g_modulus, poisson, unit_mass, specific_heat, thermal_expansion, thermal_conductivity, is_default, order_in_code, thermal_state)

Bases: _Material, ABC

Abstract base class of all concrete materials.

MatConcreteEc2​

class viktor.external.idea_rcs.objects.MatConcreteEc2(id_, name, e_modulus, g_modulus, poisson, unit_mass, specific_heat, thermal_expansion, thermal_conductivity, is_default, order_in_code, thermal_state, fck, stone_diameter, cement_class, aggregate_type, diagram_type, silica_fume, plain_concrete_diagram, dep_params=None)

Bases: MatConcrete

Do not use this __init__ directly, but create the object by create_matconcrete_ec2().

MatReinforcement​

class viktor.external.idea_rcs.objects.MatReinforcement(id_, name, e_modulus, g_modulus, poisson, unit_mass, specific_heat, thermal_expansion, thermal_conductivity, is_default, order_in_code, thermal_state, bar_surface)

Bases: _Material, ABC

Abstract base class of all material reinforcements.

MatReinforcementEc2​

class viktor.external.idea_rcs.objects.MatReinforcementEc2(id_, name, e_modulus, g_modulus, poisson, unit_mass, specific_heat, thermal_expansion, thermal_conductivity, is_default, order_in_code, thermal_state, bar_surface, fyk, ftk_by_fyk, epsuk, ftk, class_, type_, fabrication, diagram_type)

Bases: MatReinforcement

Do not use this __init__ directly, but create the object by create_matreinforcement_ec2().

MemberType​

class viktor.external.idea_rcs.objects.MemberType(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: Enum

BEAM: MemberType = 1
BEAM_SLAB: MemberType = 4
COLUMN: MemberType = 2
HOLLOW_CORE_SLAB: MemberType = 8
PLATE: MemberType = 32
TWO_WAY_SLAB: MemberType = 16
UNDEFINED: MemberType = 0
WALL: MemberType = 64

NationalAnnex​

class viktor.external.idea_rcs.objects.NationalAnnex(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: Enum

BELGIUM: NationalAnnex = 'Belgian'
DUTCH: NationalAnnex = 'Dutch'
NO_ANNEX: NationalAnnex = 'NoAnnex'

NoResistanceConcreteTension1d​

class viktor.external.idea_rcs.objects.NoResistanceConcreteTension1d(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: Enum

ALWAYS: NoResistanceConcreteTension1d = 2
EXTREME: NoResistanceConcreteTension1d = 0
SECTION: NoResistanceConcreteTension1d = 1

ProjectData​

class viktor.external.idea_rcs.objects.ProjectData(*, national_annex=None, fatigue_check=False, name=None, number=None, description=None, author=None, date=None, design_working_life=None)

Bases: _OpenObject

Project data.

Parameters:

  • name (str) – Project name

    New in v14.6.0

  • number (str) – Project number

    New in v14.6.0

  • description (str) – Project description

    New in v14.6.0

  • author (str) – Author

    New in v14.6.0

  • date (date) – Date (default: today)

    New in v14.6.0

  • national_annex (NationalAnnex) – national annex (default: No national annex (EN))

  • fatigue_check (bool) – functionality - fatigue (default: false)

  • design_working_life (Literal[50, 75, 100]) – Design working life (default: 50)

    New in v14.6.0

ReinfClass​

class viktor.external.idea_rcs.objects.ReinfClass(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: Enum

A: ReinfClass = 0
B: ReinfClass = 1
C: ReinfClass = 2

ReinfDiagramType​

class viktor.external.idea_rcs.objects.ReinfDiagramType(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: Enum

BILINEAR_INCLINED: ReinfDiagramType = 0
BILINEAR_NOT_INCLINED: ReinfDiagramType = 1
USER: ReinfDiagramType = 2

ReinfFabrication​

class viktor.external.idea_rcs.objects.ReinfFabrication(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: Enum

COLD_WORKED: ReinfFabrication = 1
HOT_ROLLED: ReinfFabrication = 0

ReinfType​

class viktor.external.idea_rcs.objects.ReinfType(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: Enum

BARS: ReinfType = 0
DECOILED_RODS: ReinfType = 1
LATTICE_GIRDERS: ReinfType = 3
WIRE_FABRICS: ReinfType = 2

ReinforcedBar​

class viktor.external.idea_rcs.objects.ReinforcedBar(coordinates, diameter, material)

Bases: _OpenObject

Do not use this __init__ directly, but create the object by ReinforcedCrossSection.create_bar().

property coordinates: Tuple[float, float]
property diameter: float
property material_id: int

ReinforcedCrossSection​

class viktor.external.idea_rcs.objects.ReinforcedCrossSection(id_, name, cross_section, bars=None, stirrups=None)

Bases: _OpenElementId

Do not use this __init__ directly, but create the object by create_reinforced_cross_section().

property bars: List[ReinforcedBar]
create_bar(coordinates, diameter, material)

Create a reinforced bar on the reinforced cross-section.

Parameters:
Return type:

None

create_bar_layer(*, origin, diameter, material, number_of_bars, delta_y=None, delta_z=None)

Create multiple reinforced bars on the reinforced cross-section, positioned on a line.

Parameters:

  • origin (Tuple[float, float]) – Origin point (Y, Z) [m].

  • diameter (float) – Diameter of the bar [m].

  • material (MatReinforcement) – Reinforcement material (created by create_matreinforcement_ec2()).

  • number_of_bars (int) – Number of bars (minimum of 2).

  • delta_y (float) – Distance between origin bar and the last bar in y-direction [m].

  • delta_z (float) – Distance between origin bar and the last bar in z-direction [m].

Return type:

None

create_stirrup(points, diameter, material, distance, shear_check=None, torsion_check=None, mandrel_diameter_factor=None, anchorage_length=None)

Create a stirrup on the reinforced cross-section.

Parameters:

  • points (Sequence[Union[Tuple[float, float], Tuple[Tuple[float, float], Tuple[float, float]]]]) – Sequence of (X, Y) coordinates [m] of the stirrup vertices, connected by straight line segments. For arc-segments use ((X_end, Y_end), (X_on_arc, Y_on_arc)).

  • diameter (float) – Diameter of the stirrup [m].

  • material (MatReinforcement) – Reinforcement material (created by create_matreinforcement_ec2()).

  • distance (float) – Longitudinal distance between stirrups [m].

  • shear_check (bool) – Take stirrup into account in shear check (default: False).

  • torsion_check (bool) – Take stirrup into account in torsion check (default: False).

  • mandrel_diameter_factor (float) – Inner diameter of mandrel as multiple of stirrup diameter [-] (default: 1.0).

  • anchorage_length (float) – Anchorage length [m] (default: 0.0).

Return type:

None

property stirrups: List[Stirrup]

ReinforcementMaterial​

class viktor.external.idea_rcs.objects.ReinforcementMaterial(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: Enum

B_400A: ReinforcementMaterial = 1
B_400B: ReinforcementMaterial = 4
B_400C: ReinforcementMaterial = 7
B_500A: ReinforcementMaterial = 2
B_500B: ReinforcementMaterial = 5
B_500C: ReinforcementMaterial = 8
B_550A: ReinforcementMaterial = 10
B_550B: ReinforcementMaterial = 11
B_600A: ReinforcementMaterial = 3
B_600B: ReinforcementMaterial = 6
B_600C: ReinforcementMaterial = 9

ResultOfInternalForces​

class viktor.external.idea_rcs.objects.ResultOfInternalForces(N=0.0, Qy=0.0, Qz=0.0, Mx=0.0, My=0.0, Mz=0.0)

Bases: _OpenObject

Result of internal forces at a certain location.

Parameters:

  • N (float) – Normal force (default: 0.0).

  • Qy (float) – Shear force in y direction (default: 0.0).

  • Qz (float) – Shear force in z direction (default: 0.0).

  • Mx (float) – Bending moment around x-axis (default: 0.0).

  • My (float) – Bending moment around y-axis (default: 0.0).

  • Mz (float) – Bending moment around z-axis (default: 0.0).

StandardCheckSection​

class viktor.external.idea_rcs.objects.StandardCheckSection(id_, description, check_member, reinf_section, extremes=None)

Bases: CheckSection

Do not use this __init__ directly, but create the object by add_check_section().

StandardCheckSectionExtreme​

class viktor.external.idea_rcs.objects.StandardCheckSectionExtreme(*, accidental=None, frequent=None, fundamental=None, characteristic=None, quasi_permanent=None, fatigue=None, description)

Bases: CheckSectionExtreme

Do not use this __init__ directly, but create the object by CheckSection.create_extreme().

Stirrup​

class viktor.external.idea_rcs.objects.Stirrup(points, diameter, material, distance, shear_check=None, torsion_check=None, mandrel_diameter_factor=None, anchorage_length=None)

Bases: _OpenObject

Do not use this __init__ directly, but create the object by ReinforcedCrossSection.create_stirrup().

property anchorage_length: float
property mandrel_diameter_factor: float
property material_id: int
property points: Sequence[Tuple[float, float] | Tuple[Tuple[float, float], Tuple[float, float]]]
property shear_check: bool
property torsion_check: bool

ThermalState​

class viktor.external.idea_rcs.objects.ThermalState(expansion=ThermalStateType.NONE, conductivity=ThermalStateType.NONE, specific_heat=ThermalStateType.NONE, stress_strain=ThermalStateType.NONE, strain=ThermalStateType.NONE)

Bases: _OpenObject

Collection of thermal states for expansion, conductivity, specific heat, stress-strain and strain.

Parameters:

ThermalStateType​

class viktor.external.idea_rcs.objects.ThermalStateType(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: Enum

CODE: ThermalStateType = 1
NONE: ThermalStateType = 0
USER: ThermalStateType = 5

TwoWaySlabType​

class viktor.external.idea_rcs.objects.TwoWaySlabType(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: Enum

DEEP_BEAM: TwoWaySlabType = 2
SHELL_AS_PLATE: TwoWaySlabType = 3
SHELL_AS_WALL: TwoWaySlabType = 4
SLAB: TwoWaySlabType = 0
WALL: TwoWaySlabType = 1

TypeSLSCalculation​

class viktor.external.idea_rcs.objects.TypeSLSCalculation(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: Enum

BOTH: TypeSLSCalculation = 0
LONG_TERM: TypeSLSCalculation = 2
SHORT_TERM: TypeSLSCalculation = 1