Karamba3D v3
  • Welcome to Karamba3D
  • New in Karamba3D 3.1
  • See Scripting Guide
  • See Manual 2.2.0
  • 1 Introduction
    • 1.1 Installation
    • 1.2 Licenses
      • 1.2.1 Cloud Licenses
      • 1.2.2 Network Licenses
      • 1.2.3 Temporary Licenses
      • 1.2.4 Standalone Licenses
  • 2 Getting Started
    • 2 Getting Started
      • 2.1 Karamba3D Entities
      • 2.2 Setting up a Structural Analysis
        • 2.2.1 Define the Model Elements
        • 2.2.2 View the Model
        • 2.2.3 Add Supports
        • 2.2.4 Define Loads
        • 2.2.5 Choose an Algorithm
        • 2.2.6 Provide Cross Sections
        • 2.2.7 Specify Materials
        • 2.2.8 Retrieve Results
      • 2.3 The Karamba3D Menu
      • 2.4 User Settings
      • 2.5 Physical Units
      • 2.6 Asynchronous Execution of Karamba3D Components
      • 2.7 Quick Component Reference
  • 3 In Depth Component Reference
    • 3.0 Settings
      • 3.0.1 License
    • 3.1 Model
      • 3.1.1 Assemble Model
      • 3.1.2 Disassemble Model
      • 3.1.3: Modify Model
      • 3.1.4: Connected Parts
      • 3.1.5: Activate Element
      • 3.1.6 Create Linear Element
        • 3.1.6.1 Line to Beam
        • 3.1.6.2 Line to Truss
        • 3.1.6.3 Connectivity to Beam
        • 3.1.6.4: Index to Beam
      • 3.1.7 Create Surface Element
        • 3.1.7.1: Mesh to Shell
        • 3.1.7.2: Mesh to Membrane
      • 3.1.8: Modify Element
      • 3.1.9: Point-Mass
      • 3.1.10: Disassemble Element
      • 3.1.11: Make Element-Set
      • 3.1.12: Orientate Element
      • 3.1.13: Dispatch Elements
      • 3.1.14: Select Elements
      • 3.1.15: Support
    • 3.2: Load
      • 3.2.1: General Loads
      • 3.2.2: Beam Loads
      • 3.2.3: Disassemble Mesh Load
      • 3.2.4 Load-Case-Combinations
        • 3.2.5.1 Load-Case-Combinator
        • 3.2.5.2 Disassemble Load-Case-Combinaton
        • 3.2.5.3 Load-Case-Combination Settings
    • 3.3: Cross Section
      • 3.3.1: Beam Cross Sections
      • 3.3.2: Shell Cross Sections
      • 3.3.3: Spring Cross Sections
      • 3.3.4: Disassemble Cross Section
      • 3.3.5: Eccentricity on Beam and Cross Section
      • 3.3.6: Modify Cross Section
      • 3.3.7: Cross Section Range Selector
      • 3.3.8: Cross Section Selector
      • 3.3.9: Cross Section Matcher
      • 3.3.10: Generate Cross Section Table
      • 3.3.11: Read Cross Section Table from File
    • 3.4: Joint
      • 3.4.1: Beam-Joints
      • 3.4.2: Beam-Joint Agent
      • 3.4.3: Line-Joint
    • 3.5: Material
      • 3.5.1: Material Properties
      • 3.5.2: Material Selection
      • 3.5.3: Read Material Table from File
      • 3.5.4: Disassemble Material
    • 3.6: Algorithms
      • 3.6.1: Analyze
      • 3.6.2: AnalyzeThII
      • 3.6.3: Analyze Nonlinear WIP
      • 3.6.4: Large Deformation Analysis
      • 3.6.5: Buckling Modes
      • 3.6.6: Eigen Modes
      • 3.6.7: Natural Vibrations
      • 3.6.8: Optimize Cross Section
      • 3.6.9: BESO for Beams
      • 3.6.10: BESO for Shells
      • 3.6.11: Optimize Reinforcement
      • 3.6.12: Tension/Compression Eliminator
    • 3.7 Results
      • 3.7.1 General Results
        • 3.7.1.1 ModelView
        • 3.7.1.2 Result Selector
        • 3.7.1.3 Deformation-Energy
        • 3.7.1.4 Element Query
        • 3.7.1.5 Nodal Displacements
        • 3.7.1.6 Principal Strains Approximation
        • 3.7.1.7 Reaction Forces
        • 3.7.1.8 Utilization of Elements
        • 3.7.1.9 ReactionView
      • 3.7.2 Results on Beams
        • 3.7.2.1 BeamView
        • 3.7.2.2 Beam Displacements
        • 3.7.2.3 Beam Forces
        • 3.7.2.4 Node Forces
      • 3.7.3 Results on Shells
        • 3.7.3.1 ShellView
        • 3.7.3.2 Line Results on Shells
        • 3.7.3.3 Result Vectors on Shells
        • 3.7.3.4 Shell Forces
        • 3.7.3.5 Shell Sections
    • 3.8 Export
      • 3.8.1 Export Model to DStV
      • 3.8.2 Json/Bson Export and Import
      • 3.8.3 Export Model to SAF
      • 3.8.4 Export/Import Model to and from Speckle (WIP)
    • 3.9 Utilities
      • 3.9.1: Mesh Breps
      • 3.9.2: Closest Points
      • 3.9.3: Closest Points Multi-dimensional
      • 3.9.4: Cull Curves
      • 3.9.5: Detect Collisions
      • 3.9.6: Get Cells from Lines
      • 3.9.7: Line-Line Intersection
      • 3.9.8: Principal States Transformation
      • 3.9.9: Remove Duplicate Lines
      • 3.9.10: Remove Duplicate Points
      • 3.9.11: Simplify Model
      • 3.9.12: Element Felting
      • 3.9.13: Mapper
      • 3.9.14: Interpolate Shape
      • 3.9.15: Connecting Beams with Stitches
      • 3.9.16: User Iso-Lines and Stream-Lines
      • 3.9.17: Cross Section Properties
      • 3.9.18 Surface To Truss
    • 3.10 Parametric UI
      • 3.10.1: View-Components
      • 3.10.2: Rendered View
  • Troubleshooting
    • 4.1: Miscellaneous Questions and Problems
      • 4.1.0: FAQ
      • 4.1.1: Installation Issues
      • 4.1.2: Purchases
      • 4.1.3: Licensing
      • 4.1.4: Runtime Errors
      • 4.1.5: Definitions and Components
      • 4.1.6: Default Program Settings
    • 4.2: Support
  • Appendix
    • A.1: Release Notes
      • Work in Progress Versions
      • Older Versions
      • Version 2.2.0
      • Version 2.2.0 WIP
      • Version 1.3.3
      • Version 1.3.2 build 190919
      • Version 1.3.2 build 190731
      • Version 1.3.2 build 190709
      • Version 1.3.2
    • A.2: Background information
      • A.2.1: Basic Properties of Materials
      • A.2.2: Additional Information on Loads
      • A.2.3: Tips for Designing Statically Feasible Structures
      • A.2.4: Performance Optimization in Karamba3D
      • A.2.5: Natural Vibrations, Eigen Modes and Buckling
      • A.2.6: Approach Used for Cross Section Optimization
    • A.3: Workflow Examples
    • A.4: Bibliography
Powered by GitBook
On this page
  • Display of cross section forces and moments
  • The “Display”-submenu
  1. 3 In Depth Component Reference
  2. 3.7 Results
  3. 3.7.2 Results on Beams

3.7.2.1 BeamView

Previous3.7.2 Results on BeamsNext3.7.2.2 Beam Displacements

Last updated 3 months ago

The "BeamView" component manages the display options for beams and trusses (refer to Fig. 3.7.2.1.1). This includes the visualization of cross-section forces, resultant displacements, the stress-to-strength ratio of materials, axial stress, buckling lengths, second order theory normal forces NII and utilization.

In previous versions of Karamba3D, the term "utilization" was used in place of "Stress/Strength ratio". However, this caused confusion: the stress-wise utilization (or stress-to-strength ratio) only describes the condition at a specific point in the cross section. In contrast, the "Utilization of Elements" component calculates the overall utilization of the entire cross section, accounting for factors such as plastic behavior and buckling. Therefore, the stress/strength ratio and utilization values may differ for the same beam under the same loads.

Display of cross section forces and moments

The “Section Forces” sub-menu lets you plot section forces and moments as curves, meshes and with or without values attached. All generated curves and meshes get appended to the “BeamView”-component's “Curves” and “Mesh” output. The graphical representation is oriented according to the local coordinate axes of the beam and takes the deflected geometry as its base. The subscript of bending moments indicates the local axis about which they rotate, for shear forces it is the direction in which they act (see also fig. 3.7.2.1.2). The cross-section forces refer to the section which is defined by the element's local coordinate system. In fig. 3.7.8.4 the cross section forces need to be applied to the right side of the beam to be in equilibrium with the external point load since the local X-direction points to the left side.

The size of the cross section forces diagrams can be scaled separately for forces and moments by the two sliders in the "SectionForces"-menu.

Customize the mesh-colors of the cross section forces diagrams via "karamba.ini". The slider “Length/Subdivision” in sub-menu “Render Settings” of the “ModelView”-component controls the number of interpolation points.

The “Display”-submenu

This submenu of the "BeamView" component offers several options for rendering beam axes or meshes according to specified result properties.

When activated, options such as "Cross Section", "|Disp|-CroSec", "Stress/Strength Ratio" and "Axial Stress" display the corresponding calculation results using a cross-sectional representation. "Stress/Strength Ratio" illustrates the ratio between axial, normal stresses and the material strength, with shear and buckling effects not considered. Consequently the maximum "Stress/Strength Ratio" value in fig 3.7.2.1.3. lies slightly below the utilization according to EC3 as calculated with the "Utilization"-component.

The color range for the results extends from the minimum to the maximum values. Users can adjust color ranges for all result quantities via the "Karamba3D/Settings" menu. Alternatively, predefined color ranges can be selected from the component's context menu: right-click on the component, navigate to "Colors", and choose a color range. A "Legend" component allows inspection of the corresponding values for each color.

The mesh used for rendering is accessible via the "Mesh" output of the "BeamView" component. Two sliders control the mesh resolution of rendered beams: the "Length/Segment" slider in the "ModelView" component sets the size of sections along the beam’s middle axis, while the "Faces/Cross section" slider in "BeamView" controls the number of faces per cross section (see fig. 3.7.2.1.4). For circular hollow cross-sections, the "Faces/Cross section" value is multiplied by six to ensure a smooth visual appearance.

For certain result types, only a single value per beam is available, or the variations across the cross-section are minimal. In such cases, results are represented using colored beam axes.

  • |Disp|-MidAxis: Displays a color representation of the absolute beam displacements. It provides the same information as the cross-section-based |Disp|-CroSec option but with less detail.

  • Buckling Length: The options "Buckling Length Y," "Buckling Length Z," and "Buckling Length LT" plot the buckling lengths of beam elements in the local Y and Z directions, as well as for lateral-torsional buckling, respectively. Negative values indicate that Karamba3D generated the values, while positive values denote user-defined inputs via the "ModifyBeam" component. There is no such thing as a negative length - only the absolute values enter the code equations. Since the absolute values of the buckling lengths significantly impact code-based utilization calculations, accuracy is crucial. The square of a beam’s buckling length is approximately inversely proportional to its buckling resistance—an underestimated buckling length results in unsafe calculations.

  • NII (Geometric Stiffness Normal Force): Plots the normal forces used to determine a beam’s geometric stiffness in the currently active result selection, which is set in an upstream "ModelView" component. A negative NII value indicates compression, reducing stiffness, whereas positive values increase stiffness—similar to how a pre-tensioned rope behaves.

  • Utilization: Displays the highest building-code-based utilization value for the currently active result selection. Currently, only EC3 is supported, and buckling effects are considered. To analyze the contribution of individual cross-section forces to overall utilization, the options "Utilization-N" to "Utilization-Mz" can be enabled:

    • N: Normal force

    • Vy, Vz: Shear forces in the local Y and Z directions

    • Mt, My, Mz: Torsional moment and bending moments about the local Y and Z axes

    Enabling the "Utilization-LcInd" option highlights the index of the load case within the currently selected load-case combination that leads to the maximum utilization at a specific location. Load cases are indexed from zero within their respective combinations.

When plotting results in axis mode, the "Line Thickness" slider in the "Render Settings" menu controls the thickness of the result lines (see Fig. 3.7.2.1.4).

Visualizing tension and compression within a beam can be insightful. To display axial stresses along the beam’s length, enable the "Axial Stress" checkbox in the "Display" menu. Red (similar to brick) indicates compression, while blue (similar to steel) represents tension. In some models there may exist small regions with high stresses with the rest of the structure having comparatively low stress levels. This results in a stress rendering that is predominantly white and not very informative. With the sliders for “Upper Result Threshold” and “Lower Result Threshold” of the “ModelView” you can set the range of the color-scale (see section ). Result values beyond the upper limit appear yellow, below the lower threshold green.

3.6.1
30KB
BeamView_CrossSectionForces.gh
38KB
BeamView_Results.gh
36KB
BeamView.gh
Fig. 3.7.2.1.1: Display of utilization and bending moments of cantilever beam
Fig. 3.7.2.1.2: Moment My about the local Y-Axis and shear force Vz.
Fig. 3.7.2.1.3: Cross section based color plot of the strength to stress ratio and comparison to utilization.
Fig. 3.7.2.1.4: Axis based, beam-wise color plot of the utilization.