Karamba3D v2
English 英文
English 英文
  • Welcome to Karamba3D
  • New in Karamba3D 2.2.0
  • See Scripting Guide
  • See Manual 1.3.3
  • 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: Physical Units
      • 2.4: Quick Component Reference
  • 3: In Depth Component Reference
    • 3.0 Settings
      • 3.0.1 Settings
      • 3.0.2 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: Line to Beam
      • 3.1.7: Connectivity to Beam
      • 3.1.8: Index to Beam
      • 3.1.9: Mesh to Shell
      • 3.1.10: Modify Element
      • 3.1.11: Point-Mass
      • 3.1.12: Disassemble Element
      • 3.1.13: Make Beam-Set 🔷
      • 3.1.14: Orientate Element
      • 3.1.15: Dispatch Elements
      • 3.1.16: Select Elements
      • 3.1.17: Support
    • 3.2: Load
      • 3.2.1: General Loads
      • 3.2.2: Beam Loads
      • 3.2.3: Disassemble Mesh Load
      • 3.2.4: Prescribed displacements
    • 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: ModelView
      • 3.7.2: Deformation-Energy
      • 3.7.3: Element Query
      • 3.7.4: Nodal Displacements
      • 3.7.5: Principal Strains Approximation
      • 3.7.6: Reaction Forces 🔷
      • 3.7.7: Utilization of Elements 🔷
        • Examples
      • 3.7.8: BeamView
      • 3.7.9: Beam Displacements 🔷
      • 3.7.10: Beam Forces
      • 3.7.11: Node Forces
      • 3.7.12: ShellView
      • 3.7.13: Line Results on Shells
      • 3.7.14: Result Vectors on Shells
      • 3.7.15: Shell Forces
      • 3.7.16 Results at Shell Sections
    • 3.8: Export 🔷
      • 3.8.1: Export Model to DStV 🔷
      • 3.8.2 Json / Bson Export and Import
    • 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.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
      • 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: Hints on Reducing Computation Time
      • 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
  • Gravity
  • Point-Load
  • Imperfection-Load
  • Initial Strain-Load
  • Temperature-Load
  • Line-Load on Element
  • Mesh-Load: Const and Variable
  • Mesh
  • Vec
  • Pos
  • BeamIds
  • LCase
  • Orientation
  • Generation

Was this helpful?

  1. 3: In Depth Component Reference
  2. 3.2: Load

3.2.1: General Loads

Previous3.2: LoadNext3.2.2: Beam Loads

Last updated 3 years ago

Was this helpful?

Currently Karamba3d offers these general types of loads: gravity-, point-, imperfection-, pretension-, temperature-loads, constant mesh-loads, variable mesh-loads and prescribed displacements at supports. For beam and truss elements additional options exist (see section Beam Loads). The types of loads discribed in this section apply to all types of elements. An arbitrary number of point-, mesh-, etc.-loads and one gravity-load may be combined to form a load-case of which again an arbitrary number may exist. Fig. 3.2.1.1 shows the definition of loads with the help of the “Loads” multi-component. On the bottom of the “ModelView”-component (see section ) there is a drop-down-list (unfold it by clicking on the “Result-case Selection”-menu header) which can be used to select single load-cases for display. Select “–all–” in order to view all existing load-definitions of all load-cases simultaneously. Use the force-slider to scale the size of the load-symbols (double-clicking on its knob lets you change the value range and its current value).

Gravity

It is the default setting when you place a “Loads”-component on the canvas.

Each load case may contain zero or one definition for the vector of gravity. In this way one can e.g. simulate the effect of an earthquake by applying a certain amount of gravity in horizontal direction. For Vienna, which has medium earthquake loads, this amounts to approximately 14 % of gravity that a building has to sustain in horizontal direction. In areas with severe earthquake loads this can rise to 100 % (the value however also depends on the stiffness properties of the structure and underlying soil).

When working in SI-units Karamba3D assumes a value of 10m/s210m/s^210m/s2 for the acceleration of gravity. In case of Imperial units g=9.8066352m/s2g = 9.8066352 m/s^2g=9.8066352m/s2 is used. Otherwise the conversion from pound mass to pound force does not work. The value of ggg can be set in the “karamba.ini”-file, which resides in the Karamba3D installation folder.

Point-Load

Plugging a point-load into a panel component gives the following information: Node-index where the load gets applied or position, force-vector, moment vector, the number of load case to which it belongs and whether the load is tied to the nodal coordinate system.

By default point loads will be put into load case zero. Any positive number fed into the “LCase”-plug defines the load case to which the corresponding load will be attributed. A value of −1-1−1 signals that the load acts in all existing load cases.

Be cautious in case of nodes where only truss- or membrane-elements attach: these nodes do not possess rotational degrees of freedom. A moment load will therefore have no effect and gets automatically removed from the structure.

Imperfection-Load

Initial Strain-Load

Karamba3D lets you define initial strains. Fig. 3.2.1.3 shows a beam with both ends fixed, subject to a positive initial constant strain and curvature. The unit of dimension of the pretension which gets fed into the “Eps0” plug is mm/mmm/mmm/m.

A positive value means that the element gets longer.

Applying initial strain to an element is not the same as applying a pair of opposite forces or moments at its endpoints: In case of initial strain, the axial force in the element depends on its boundary conditions: If the structure to which it connects is very stiff then the resulting axial force will be N=−ϵ0⋅A⋅EN = -\epsilon _0 \cdot A \cdot EN=−ϵ0​⋅A⋅E. In fig. 3.2.1.3 the supports are rigid, the elements cross section A=25cm2A = 25 cm^2A=25cm2, Young’s Modulus E=21000kN/cm2E = 21000 kN/cm^2E=21000kN/cm2 and ϵ0=0.00015\epsilon _0 = 0.00015ϵ0​=0.00015. This results in an axial force of N=−78.75kNN = -78.75 kNN=−78.75kN and shows up as horizontal support reactions. When the rest of the structure does not resist, then a pretension-load merely results in lengthening or shortening the corresponding element.

The “Kappa0”-input is a vector of curvature values with respect to the local element axes. A positive component value signifies an anti-clockwise rotation about the corresponding axis. The input plug “ElemIds” defines the elements where the load acts and “LCase” the load-case.

Temperature-Load

Line-Load on Element

Mesh-Load: Const and Variable

Mesh

Vec

There exist two types of mesh-loads:

  1. “MeshLoad Const”: for loads which are constant throughout the mesh.

  2. “MeshLoad Var": lets one set specific load-values for each face of the mesh.

These two variants differ with respect to the data-structure expected at the input “Vec” and “Vecs” respectively: Either a single vector for specifying a constant load or a list of vectors. In the latter case the list items are applied to the mesh-faces based on the longest list principle. In what follows the “MeshLoad Const”-variant will be depicted but everything mentioned there applies to “MeshLoad Var” also.

Fig. 3.2.1.6 left side shows a simply supported beam and a mesh which consists of two rectangular faces. Each face covers one half of the beam and has a width of 2m2m2m perpendicular to the beam axis. With a distributed load of 1kN/m21kN/m^21kN/m2 in negative global Z-direction a uniformly distributed load of 2 kN/mkN/mkN/m results.

Pos

In order to define structure nodes where equivalent point-loads may be generated, plug a list of their coordinates into the “Pos”-plug. These need to correspond to existing nodes – otherwise the Assembly-component turns red. Offending nodes will be listed in its run-time error message. By default all points of the structure are included. Uncheck “Point loads” to avoid point-loads.

BeamIds

With the input-plug “BeamIds”, groups of elements can be specified on which equivalent loads shall be generated. By default all beams of the model are included. In case no beam loads shall be included uncheck the “Line loads” button on the “Generation” submenu.

The procedure for calculating nodal loads and uniformly distributed beam loads from surface loads consists of the following steps: First Karamba3D calculates the resultant load on each face of the given mesh. Then the resultant load of each face gets evenly distributed among its three or four vertices.

The second step consists of distributing the vertex-loads among the nodes of the structure. In order to arrive at beam loads additional helper-nodes along their axes get generated. The mutual distance of those is chosen equal to a third of the mean edge length of the given mesh.

Fig. 3.2.1.7 shows a similar setting as in fig. 3.2.1.6. The difference lies in the refined mesh with more vertices along the beam axis. Now loads from the mesh vertices get distributed also to the helper nodes along the element axis. This leads to the generation of a uniform line-load.

LCase

Set the “LCase”-input to the index of the load case in which the surface load shall act. Indexing of load-cases starts with zero, “−1” is short for all load cases.

Orientation

The right side of fig. 3.2.1.7 shows what data the “MeshLoad const”-component collects: The input-plug “Vec” expects a vector which specifies the surface load. Its physical unit is kilo Newton per square meter kN/m2kN/m^2kN/m2. The orientation of the load-vector depends on the checkbox selected under “Orientation” (see also fig. 3.2.1.8):

  • This means a surface load with components only in Z-direction acts like wind pressure or suction.

  • “global”: The force-vector is oriented according to the global coordinate system. This makes the surface load behave like additional weight on the mesh plane.

  • “global proj.”: The force-vector is oriented according to the global coordinate system. The corresponding surface load is distributed on the area that results from projecting the mesh-faces to global coordinate planes. In such a way the action of snow load can be simulated.

Generation

By default, the “MeshLoad const”-component creates point- and line-loads. The radio-buttons in the submenu “Generation” can be used to disable the first or the latter.

Gravity applies to all active elements in the structural model for which the specific weight gamma (see section ) is not zero. The gravity vector defines the direction in which gravity shall act. A vector of length one corresponds to gravity as encountered on earth.

The component “Point-Load” lets you define loads on nodes. These get attached by node-index or coordinate. In order to find out the index of a specific node enable the “node tag”-checkbox in the “ModelView”-component. Feed a corresponding list of items into the ”Pos|Ind”-plug (quite analogous to the “Support”-component). See section on how to predefine the index of specific nodes or node-position. Point-loads can be either forces (kNkNkN) or moments (kNmkNmkNm). Feed a force- or moment-vector into the “Force” or “Moment” input-plug. Its components define the force or moment in global x-, y- and z-direction.

When set to “True” the boolean input “Local?” makes loads and moments follow the nodal rotations in large displacement calculations (see section ).

For more information on loads and some typical values see section .

With Karamba3D 2.2.0 this load option was moved to the "Beam Loads"-component (see section ).

The definition of temperature loads works analogously to defining pretension loads (see section ). The coefficient of thermal expansion (see section ) characterizes the response of a material to temperature changes.

With Karamba3D 2.2.0 this load option was moved to the "Beam Loads"-component (see section ) where it is available as 'Block'-load.

The “MeshLoad”-component can be used to transform surface loads into equivalent node- or element-loads. This lets you define life-loads on floor slabs, moving loads on bridges (see example “Bridge.ghx” in the collection on the Karamba3D web-site), snow on roofs, wind-pressure on a facade, etc.. The mesh where the load is applied and the underlying structure do not need to be connected. It needs to be fed into the “Mesh”-input-plug.

Each mesh vertex transfers its load to the nearest node. In case that there are several nodes within a radius of less than “LDist” as set at the Assemble-component (see section ) the vertex load gets evenly distributed among them. The loads received by the helper-nodes along beam axes get summed up and divided by the element length. This results in the approximately equivalent uniformly distributed load which is placed on the element. From the procedure described, one can see that a crude mesh may lead to a locally incorrect distribution of loads. In the system shown in fig. 3.2.1.6 the points closest to the vertices are the element’s end-points. Therefore the helper nodes along the beam-axis do not receive a share in the mesh-load and thus no line-load results.

"local to mesh”: The convention for local coordinate systems for local loads corresponds to that given in section : The local x-axis is parallel to the global x-direction unless the mesh-face normal is parallel to the global x-direction. In that case the local x-axis points in the global y-direction. The local z-axis is always perpendicular to the mesh-face and its orientation depends on the order of the vertices: If the z-axis points towards ones nose, the order of the face vertices is counter-clockwise.

3.4.1
3.1.6
3.5.4
3.2.2
3.2.2
examples
3.1.1
3.4.1
3.2.1
3.6.1
3.1.14
30KB
Load_Gravity_ResultingForce.gh
21KB
PointLoad.gh
25KB
PointLoadsOnGrid.gh
34KB
InitialStrainLoad_Beam.gh
36KB
InitialStrainLoad_Truss.gh
25KB
InitialStrainLoad_Shell.gh
22KB
InitialStrainLoad_ClampedShell.gh
28KB
InitialCurvatureLoad_Beam_Arc.gh
31KB
InitialCurvatureLoad_Beam_Cantilever.gh
34KB
InitialCurvatureLoad_Beam_Clamped.gh
23KB
InitialCurvatureLoad_Beam_Clamped_Rotated.gh
31KB
InitialCurvatureLoad_Beam_SimplySupported.gh
36KB
InitialCurvatureLoad_Shell_Arc.gh
24KB
InitialCurvatureLoad_Shell_Cantilever.gh
39KB
InitialCurvatureLoad_Shell_Clamped.gh
10KB
MeshLoad_VerySimple.gh
27KB
MeshLoad_Selective.gh
38KB
MeshLoad_OnShaft.gh
43KB
MeshLoad_MeshDependency.gh
19KB
MeshLoad_CrossingElements.gh
Fig. 3.2.1.1: Simply supported beam with five loads
Fig. 3.2.1.3: Member under initial strains fixed at both ends and support reactions
Fig. 3.2.1.4: Temperature load on a member which is fixed at both ends
Fig. 3.2.1.6: Simply supported beam with line-loads from a mesh load
Fig. 3.2.1.7: Simply supported beam with point loads from a mesh load
Fig. 3.2.1.8: Orientation of loads on mesh: (a) local; (b) global; (c) global projected to global plane
A.2.3