Partial factor selection

class groundhog.standards.eurocode7.factors.Eurocode7_factoring_STR_GEO[source]
__init__()[source]

This class sets the necessary factors for Eurocode 7 factoring of effects of actions and resistances for the STR and GEO limit states.

The initialisation sets four sets dictionaries for factors, each with sub-dictionaries for the case under consideration

  • Effects of actions: Factor sets A1 and A2
    • Permanent unfavourable

    • Permanent favourable

    • Variable unfavourable

    • Variable favourable

  • Soil parameters: Factor sets M1 and M2
    • Angle of shearing resistance

    • Effective cohesion

    • Undrained shear strength

    • Unconfined strength

    • Weight density

  • Resistances: Factor sets R1, R2, R3 and R4 for different types of foundations and retaining structures
    • Spread foundation
      • Bearing

      • Sliding

    • Driven pile
      • Base

      • Shaft

      • Total compression

      • Shaft tension

    • Bored pile
      • Base

      • Shaft

      • Total compression

      • Shaft tension

    • CFA pile
      • Base

      • Shaft

      • Total compression

      • Shaft tension

    • Prestressed anchorage
      • Temporary

      • Permanent

    • Retaining structure
      • Bearing capacity

      • Sliding resistance

      • Earth resistance

    • Slopes
      • Earth resistance

  • Correlation factors
    • \(\xi_1,\xi_2\) for pile design based on results from static pile load tests (SLT)

    • \(\xi_3,\xi_4\) for pile design based on results from geotechnical investigations

    • \(\xi_5,\xi_6\) for pile design based on results from dynamic pile load tests (DPLT)

By default, the factors from EN 1997-1 Appendix A are adopted. If the user wants to override these using Nationally Determined Parameters, they need to use the overriding methods.

override_factors_actions(set, loadtype=None, value=None, override_dict=None)[source]

Overrides the factor on effect of actions. An individual factor can be overridden by specifying its set, loadtype and value. Alternatively, an entire dictionary can be specified to override one of the sets, completely replacing the defaults

override_factors_resistance(set, foundationtype, resistancecomponent=None, value=None, override_dict=None)[source]

Overrides the factor on resistances. An individual factor can be overridden by specifying its set, foundation type, resistance component and value. Alternatively, an entire dictionary can be specified to override one of the sets for a given foundation type, completely replacing the defaults

override_factors_soil(set, soilparameter=None, value=None, override_dict=None)[source]

Overrides the factor on soil properties. An individual factor can be overridden by specifying its set, soilparameter type and value. Alternatively, an entire dictionary can be specified to override one of the sets, completely replacing the defaults

select_correlation_factors(testtype, no_tests, interpolate=False)[source]

Selects the correlation factors for a given testtype (‘Static load test’, ‘Ground investigation’, ‘Dynamic load test’) If interpolate is set to True, interpolation between the two nearest categories is considered. A dictionary with the selected correlation factors is returned.

select_design_approach(design_approach='DA1-1', foundation_type='Spread foundation')[source]

The user selects the design approach ("DA1-1", "DA1-1", "DA2", "DA3-1", "DA3-2") based on the design problem and national requirements. Note that design approach 1 is split in Combination 1 ("DA1-1") and Combination 2 ("DA1-2") as the two combinations need to be checked. A separate object needs to be created for each set. Design approach 3 is also split into two cases ("DA3-1" and "DA3-2") depending on whether A1 or A2 is used.

The following combinations are stored in the .selected_factors_actions, .selected_factors_soil and .selected_factors_resistance attributes:

  • DA1-1: A1 + M1 + R1

  • DA1-2: A2 + M2 + R1

  • DA2: A1 + M1 + R2

  • DA3-1: A1 + M2 + R3

  • DA3-2: A2 + M2 + R3

For the resistance factors, the user must also specify a foundation type from the following list:
  • Spread foundation

  • Driven pile

  • Bored pile

  • CFA pile

  • Prestressed anchorage

  • Retaining structure

  • Slopes