3.2.1: Loads

Currently Karamba3d supports these types of loads: gravity-, point-, imperfection-, pretension-, temperature-loads, constant mesh-loads, variable mesh-loads and prescribed displacements at supports. 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. shows the definition of loads with the help of the “Loads” multi-component. On the bottom of the “ModelView”-component (see section 3.6.1) 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).


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).

Gravity applies to all active elements in the structural model for which the specific weight gamma (see section 3.4.1) 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.


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

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.

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.

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


There exists no such thing as an ideally straight column positioned perfectly vertical. The deviation of a real column from its ideal counterpart is called imperfection. This term comprises geometric and material imperfections.

The “Imperfection” variant of the “Loads” multi-component allows to specify geometric imperfections (see fig. “psi0” takes the vector of the initial inclination of the beam axis about the axes of the local element coordinate system in radians. With “kappa0” one can specify the initial curvature. A positive component of curvature means that the rotation of the middle axis about the corresponding local coordinate axis increases when moving in longitudinal beam direction. Small inclinations and curvatures are assumed.

Initial Strain-Load

A positive value means that the element gets longer.

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.


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

Line-Load on Element

Mesh-Load: Const and Variable


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 examples 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.


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.


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.


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.

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 3.1.1) 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. 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.

Fig. shows a similar setting as in fig. 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.


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.


  • "local to mesh”: The convention for local coordinate systems for local loads corresponds to that given in section 3.1.14: 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.

    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.


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.

Last updated