ANYstructure API

ANYstructure API Classes

class anystruct.api.FlatStru(calculation_domain: str = None)

API class for all flat plates.

Domains:

  1. ‘Flat plate, unstiffened’

  2. ‘Flat plate, stiffened’

Methods:

get_buckling_results([calculation_method, ...])

Return buckling results for the active calculation method.

get_special_provisions_results()

Special provisions for plating and stiffeners in steel structures.

set_buckling_parameters([...])

Various buckling realted parameters are set here.

set_fixation_parameters([kpp, kps, km1, ...])

Used for calculation of special provisions for plating and stiffeners in steel structures.

set_girder([hw, tw, bf, tf, stf_type, spacing])

Sets the girder properties.

set_material([mat_yield, emodule, ...])

Set the material properties for all structure.

set_ml_buckling_model(ml_algo)

Set the numeric ML model/scaler bundle used by the ML-Numeric (PULS based) method.

set_plate_geometry([spacing, thickness, span])

Set the properties of plate.

set_puls_parameters([sp_or_up, ...])

Set the PULS-style panel metadata used by SemiAnalytical and ML-Numeric buckling methods.

set_stiffener([hw, tw, bf, tf, stf_type, ...])

Sets the stiffener properties.

set_stresses([pressure, sigma_x1, sigma_x2, ...])

Set loads applied on the plate sides.
get_buckling_results(calculation_method: str = None, ml_algo=None)

Return buckling results for the active calculation method. UF - Utilization Factor.

DNV-RP-C201 returns the legacy result dictionary:

Plate : {‘Plate buckling’: UF}

Stiffener: {‘Overpressure plate side’: UF, ‘Overpressure stiffener side’: UF,

‘Resistance between stiffeners’: UF, ‘Shear capacity’: UF}

Girder: {‘Overpressure plate side’: UF, ‘Overpressure girder side’: UF, ‘Shear capacity’: UF}

Local buckling {‘Stiffener’: [UF web, UF flange], ‘Girder’: [UF web, UF flange]}

SemiAnalytical and ML-Numeric return a method result dictionary with buckling/ultimate UF,

raw UF, validity, and selected UF fields.

Returns:

Buckling results for the selected method

Return type:

dict

get_special_provisions_results()

Special provisions for plating and stiffeners in steel structures.

Return a dictionary:

‘Plate thickness’ : The thickness of plates shall not be less than this check.

‘Stiffener section modulus’ : The section modulus for longitudinals, beams, frames and other stiffeners

subjected to lateral pressure shall not be less than this check.

‘Stiffener shear area’ : The shear area of the plate/stiffener shall not be less than this ckeck.

Returns:

minium dimensions and actual dimensions for the current structure in mm/mm^2/mm^3

Return type:

dict

set_buckling_parameters(calculation_method: str = None, buckling_acceptance: str = None, stiffened_plate_effective_aginst_sigy=True, min_lat_press_adj_span: float = None, buckling_length_factor_stf: float = None, buckling_length_factor_girder: float = None, stf_dist_between_lateral_supp: float = None, girder_dist_between_lateral_supp: float = None, panel_length_Lp: float = None, stiffener_support: str = 'Continuous', girder_support: str = 'Continuous', pressure_side: str = 'both sides', load_factor_stresses: float = 1.0, load_factor_pressure: float = 1.0, fabrication_method_stiffener: str = 'welded', fabrication_method_girder: str = 'welded', ml_algo=None)

Various buckling realted parameters are set here. For details, see

DNV-RP-C201 Buckling strength of plated structures.

Parameters:

  • calculation_method (str) – ‘DNV-RP-C201 - prescriptive’, ‘SemiAnalytical S3/U3’, or ‘ML-Numeric (PULS based)’

  • buckling_acceptance (str) – selected UF family, either ‘buckling’ or ‘ultimate’

  • stiffened_plate_effective_aginst_sigy

  • min_lat_press_adj_span (float) – relative pressure applied on adjacent spans

  • buckling_length_factor_stf (float) – Buckling length factor: , kstiff

  • buckling_length_factor_girder (float) – Buckling length factor: kstiff

  • stf_dist_between_lateral_supp (float) – Distance between tripping brackets: lT

  • girder_dist_between_lateral_supp (float) – Dist.betw.lateral supp.: Ltg

  • panel_length_Lp (float) – Panel length (max.no stiff spans*l): Lp

  • stiffener_support (str) – continuous or sniped at ends

  • girder_support (str) – continuous or sniped at ends

  • pressure_side (str) – side receiving overpressure, ‘plate side’, ‘stiffener side’ or ‘both sides’

  • load_factor_stresses (float) – load factor applied to in-plane stresses

  • load_factor_pressure (float) – load factor applied to lateral pressure

  • fabrication_method_stiffener (str) – flat stiffener fabrication method, ‘welded’ or ‘cold formed’

  • fabrication_method_girder (str) – flat girder fabrication method, ‘welded’ or ‘cold formed’

  • ml_algo (dict) – optional numeric ML model/scaler bundle for ‘ML-Numeric (PULS based)’

Returns:

Return type:

set_fixation_parameters(kpp: float = 1, kps: float = 1, km1: float = 12, km2: float = 24, km3: float = 12)

Used for calculation of special provisions for plating and stiffeners in steel structures.

Parameters:

  • kpp (float) – fixation parameter for plate, 1.0 for clamped edges, 0.5 for simply supported edges

  • kps – fixation parameter for stiffeners, 1.0 if at least one end is clamped, 0.9 if both ends are simply supported

  • km1 (float) – Bending moment and shear force factors, see DNV standards or ANYstructure GUI

  • km2 (float) – Bending moment and shear force factors, see DNV standards or ANYstructure GUI

  • km3 (float) – Bending moment and shear force factors, see DNV standards or ANYstructure GUI

Returns:

Return type:

set_girder(hw: float = 500, tw: float = 15, bf: float = 200, tf: float = 25, stf_type: str = 'T', spacing: float = 700)

Sets the girder properties.

Parameters:

  • hw (float) – stiffer web height, mm

  • tw (float) – girder web thickness, mm

  • bf (float) – girder flange width, mm

  • tf (float) – girder flange thickness, mm

  • stf_type (str) – girder type, either T, FB, L or L-bulb

  • spacing (float) – spacing between girders

Returns:

Return type:

set_material(mat_yield=355, emodule=210000, material_factor=1.15, poisson=0.3)

Set the material properties for all structure.

Parameters:

  • mat_yield (float) – material yield, fy, given in MPa

  • emodule (float) – elastic module, E, given in MPa

  • material_factor (float) – material factor, typically 1.15 or 1.1

  • poisson (float) – poisson number of matieral

Returns:

Return type:

set_ml_buckling_model(ml_algo)

Set the numeric ML model/scaler bundle used by the ML-Numeric (PULS based) method.

set_plate_geometry(spacing: float = 700, thickness: float = 20, span: float = 4000)

Set the properties of plate. If the plate is stiffened, spacing is between the stiffeners. If the plate is not unstiffened, the spacing is the width of the considered plate.

Parameters:

  • spacing (float) – stiffener spacing

  • thickness (float) – plate thickness

  • span (float) – span of plate field

Returns:

Return type:

set_puls_parameters(sp_or_up: str = None, puls_boundary: str = 'Int', stiffener_end: str = 'Continuous', up_boundary: str = 'SSSS')

Set the PULS-style panel metadata used by SemiAnalytical and ML-Numeric buckling methods.

set_stiffener(hw: float = 260, tw: float = 12, bf: float = 49, tf: float = 27.3, stf_type: str = 'bulb', spacing: float = 608)

Sets the stiffener properties.

Parameters:

  • hw (float) – stiffer web height, mm

  • tw (float) – stiffener web thickness, mm

  • bf (float) – stiffener flange width, mm

  • tf (float) – stiffener flange thickness, mm

  • stf_type (str) – stiffener type, either T, FB, L or L-bulb

  • spacing (float) – spacing between stiffeners

Returns:

Return type:

set_stresses(pressure: float = 0, sigma_x1: float = 0, sigma_x2: float = 0, sigma_y1: float = 0, sigma_y2: float = 0, tau_xy: float = 0)

Set loads applied on the plate sides.

x1 and y1 is on one side of the plate

x2 and y2 is the other side

tau_xy act uniformly on the plate field

Stresses are in MPA.

Use POSITIVE numbers for compression pressure, stresses and forces

Parameters:

  • pressure (float) – Lateral load / pressure: Psd [MPa]

  • sigma_x1 (float) – Longitudinal compr.: sx,sd [MPa]

  • sigma_x2 (float) – Longitudinal compr.: sx2,sd [MPa]

  • sigma_y1 (float) – Transverse compress.: sy,sd [MPa]

  • sigma_y2 (float) – Transverse compress.: sy2,sd [MPa]

  • tau_xy (float) – Shear Stress: txy [MPa]

Returns:

Return type:

class anystruct.api.CylStru(calculation_domain: str = 'Unstiffened shell')

API class for all cylinder options.

Calculation domains are:

  1. ‘Unstiffened shell’

  2. ‘Unstiffened panel’

  3. ‘Longitudinal Stiffened shell’

  4. ‘Longitudinal Stiffened panel’

  5. ‘Ring Stiffened shell’

  6. ‘Ring Stiffened panel’

  7. ‘Orthogonally Stiffened shell’

  8. ‘Orthogonally Stiffened panel’

Methods:

get_buckling_results()

Return a dict including all buckling results :return: :rtype:

set_end_cap_pressure_included_in_stress([...])

Cylinder may or may not have and end cap.

set_exclude_ring_frame([is_excluded])

If for example orthogonally stiffened cylinder is selected and there are no ring girder, set this to True.

set_exclude_ring_stiffener([is_excluded])

If for example orthogonally stiffened cylinder is selected and there are no ring stiffeners, set this to True.

set_fabrication_method([stiffener, girder])

Fabrication method for stiffener and girder.

set_forces([Nsd, Msd, Tsd, Qsd, psd])

Forces applied to cylinder.

set_imperfection([delta_0])

Initial out of roundness of stiffener: delta_0 * r Typical value is set as default.

set_length_between_girder([val])

Distance between the girders along the cylinder.

set_longitudinal_stiffener([hw, tw, bf, tf, ...])

Sets the longitudinal stiffener dimensions.

set_material([mat_yield, emodule, ...])

Set the material properties for all structure.

set_panel_spacing([val])

In case a curved panel is selected, not a complete cylinder, this value sets the width of the panel.

set_ring_girder([hw, tw, bf, tf, stf_type, ...])

Sets the ring girder dimensions.

set_ring_stiffener([hw, tw, bf, tf, ...])

Sets the ring stiffener dimensions.

set_shell_buckling_parmeters([...])

Sets the buckling length paramenter of the cylinder.

set_shell_geometry([radius, thickness, ...])

Sets the baic parameters for the cylinder.

set_stresses([sasd, smsd, tTsd, tQsd, psd, shsd])

Cylinder stresses.

set_uls_or_als([kind])

This is used to calculate th resulting material factor.
get_buckling_results()

Return a dict including all buckling results :return: :rtype:

set_end_cap_pressure_included_in_stress(is_included: bool = True)

Cylinder may or may not have and end cap. If there is an end cap, and the stresses from pressure on this is not included, ste this values to True.

Parameters:

is_included (bool) – if this is not set, stresses due to end cap pressure for clyinder is set

Returns:

Return type:

set_exclude_ring_frame(is_excluded: bool = True)

If for example orthogonally stiffened cylinder is selected and there are no ring girder, set this to True. The resulting structure will then be only longitudinal and ring stiffeners.

Parameters:

is_excluded (bool) – set no ring girders

Returns:

Return type:

set_exclude_ring_stiffener(is_excluded: bool = True)

If for example orthogonally stiffened cylinder is selected and there are no ring stiffeners, set this to True. In this case only ring girders are included.

Parameters:

is_excluded (bool) – set no ring stiffeners

Returns:

Return type:

set_fabrication_method(stiffener: str = 'Fabricated', girder: str = 'Fabricated')

Fabrication method for stiffener and girder. Either ‘Fabricated’ or ‘Cold formed’

Parameters:

  • stiffener (str) – set fabrication method of stiffeners, either ‘Fabricated’ or ‘Cold formed’

  • girder (str) – set fabrication method of girder, either ‘Fabricated’ or ‘Cold formed’

Returns:

Return type:

set_forces(Nsd: float = 0, Msd: float = 0, Tsd: float = 0, Qsd: float = 0, psd: float = 0)

Forces applied to cylinder. Use negative numbers for compression pressure, stresses and forces.

Parameters:

  • Nsd – Design Axial force, Nsd [kN]

  • Msd – Design bending mom., Msd [kNm]

  • Tsd – Design torsional mom., Tsd [kNm]

  • Qsd – Design shear force, Qsd [kN]

  • psd – Design lateral pressure, psd [N/mm2]

Returns:

set_imperfection(delta_0=0.005)

Initial out of roundness of stiffener: delta_0 * r Typical value is set as default.

Parameters:

delta_0 (float) – Initial out of roundness of stiffener

Returns:

Return type:

set_length_between_girder(val: float = 0)

Distance between the girders along the cylinder.

Parameters:

val (float) – length/span between girders

Returns:

Return type:

set_longitudinal_stiffener(hw: float = 260, tw: float = 12, bf: float = 49, tf: float = 28, stf_type: str = 'bulb', spacing: float = 680)

Sets the longitudinal stiffener dimensions. May be excluded.

Parameters:

  • hw (float) – web height

  • tw (float) – web thickness

  • bf (float) – flange width

  • tf (float) – flange thickness

  • stf_type (str) – stiffener type, either T, FB, L or L-bulb

  • spacing (float) – distance between stiffeners

set_material(mat_yield=355, emodule=210000, material_factor=1.15, poisson=0.3)

Set the material properties for all structure.

Parameters:

  • mat_yield (float) – material yield, fy, given in MPa

  • emodule (float) – elastic module, E, given in MPa

  • material_factor (float) – material factor, typically 1.15 or 1.1

  • poisson (float) – poisson number of matieral

Returns:

Return type:

set_panel_spacing(val: float = 0)

In case a curved panel is selected, not a complete cylinder, this value sets the width of the panel.

Parameters:

val (float) – spacing between stiffeners

Returns:

Return type:

set_ring_girder(hw: float = 500, tw: float = 15, bf: float = 200, tf: float = 25, stf_type: str = 'T', spacing: float = 700)

Sets the ring girder dimensions. May be excluded.

Parameters:

  • hw (float) – web height

  • tw (float) – web thickness

  • bf (float) – flange width

  • tf (float) – flange thickness

  • stf_type (str) – stiffener type, either T, FB, L or L-bulb

  • spacing (float) – distance between stiffeners

Returns:

Return type:

set_ring_stiffener(hw: float = 260, tw: float = 12, bf: float = 49, tf: float = 28, stf_type: str = 'bulb', spacing: float = 680)

Sets the ring stiffener dimensions. May be excluded.

Parameters:

  • hw (float) – web height

  • tw (float) – web thickness

  • bf (float) – flange width

  • tf (float) – flange thickness

  • stf_type (str) – stiffener type, either T, FB, L or L-bulb

  • spacing (float) – distance between stiffeners

Returns:

Return type:

set_shell_buckling_parmeters(eff_buckling_length_factor: float = 1.0)

Sets the buckling length paramenter of the cylinder. Used for global column buckling calculations.

Parameters:

eff_buckling_length_factor (float) – effective length factor, column buckling

Returns:

Return type:

set_shell_geometry(radius: float = 0, thickness: float = 0, distance_between_rings: float = 0, tot_length_of_shell: float = 0)

Sets the baic parameters for the cylinder.

Parameters:

  • radius (float) – radius of cylinder

  • thickness (float) – thickness of cylinder

  • distance_between_rings (float) – distance between girders

  • tot_length_of_shell (float) – total length of the cylinder

Returns:

Return type:

set_stresses(sasd=0, smsd=0, tTsd=0, tQsd=0, psd=0, shsd=0)

Cylinder stresses. Use negative numbers for compression pressure, stresses and forces.

Parameters:

  • sasd (float) – Design axial stress, sa,sd [MPa]

  • smsd (float) – Design bending stress, sm,sd [MPa]

  • tTsd (float) – Design torsional stress, tT,sd [MPa]

  • tQsd (float) – Design shear stress, tQ,sd [MPa]

  • psd (float) – Design lateral pressure, psd [MPa]

  • shsd (float) – Additional hoop stress, sh,sd [MPa]

Returns:

Return type:

set_uls_or_als(kind='ULS')

This is used to calculate th resulting material factor. ALS is Accidental Limit State ULS is Ultimate Limit State

Parameters:

kind (str) – set load condition, either ‘ULS’ or ‘ALS’

Returns:

Return type: