Grasshopper Docs

Community documentation for Grasshopper add-ons & plugins

Karamba3D

ADDON. Version 1.3.2. Released on 2019-Sep-18. Provides 81 components. Created by Clemens Preisinger. Features 4 video tutorials.
Karamba3D is a parametric structural engineering tool which provides accurate analysis of spatial trusses, frames and shells. Karamba3D is fully embedded in the parametric design environment of Grasshopper, a plug-in for the 3d modeling tool Rhinoceros. This makes it easy to combine parameterized geometric models, finite element calculations and optimization algorithms like Galapagos. It lets you analyze the response of 3-dimensional beam and shell structures under arbitrary loads.
1.Model
2.Load
3.Cross Section
4.Material
5.Algorithms
6.Results
7.Export
8.Utilities
License

8.Utilities

Element Felting
Felts elements of a model.
User Iso-Lines
Returns iso-lines at intersection point of given line with shell based on user supplied values.
User Stream-Lines
Returns stream lines at intersection point of given line with shell based on user supplied tangent vectors.
Closest Points
Connects each node to a given number of nearest neighbor nodes or neighbors within a specified distance.
Closest Points Multi-Dimensional
Performs a multidimensional neighborhood search on a set of vectors.
Detect Collision
Returns number of collisions between given mesh and model.
Line-Line Intersection
Intersects given lines and returns resulting end-points and pieces.
LocalVector
Transforms a vector from the global to a local coordinate system given by a plane.
Mesh Breps
Meshes multiple Breps. Allows to include manifold edges and points.
Principal States Transformation
Transforms given principal vectors of stresses, moments or in-plane forces to an arbitrary direction.
Remove Duplicate Lines
Eliminates identical lines from the given set of lines.
Remove Duplicate Points
Eliminates identical points from the given set of points.
Simplify Model
Simplifies a model by straightening the connecting elements between nodes that connect to more than two neighbor nodes.
Cull Curves
Remove curves from the branch of a data tree which are closer than LDist to a curve from another branch.
Get Cells from Lines
Get closed cells from a set of lines
Interpolate Shapes
Interpolates between a base geometry (0.0) and given shape(s) (1.0).
Mapper
Applies mappings (like Simple Stitch) to a model.
Stitches
Creates all types of stitches that connect beam sets by a preset number of elements.

1.Model

Connectivity to Beam
Creates beams with default properties from given connectivity diagram
Disassemble Element
Decomposes beams and shells into their components.
Make Element-Set
Puts elements designated by their element identifier into a group.
Index to Beam
Creates beams with default properties from given node indexes.
Line to Beam
Geometry is assumed to be given in [m]
Mesh to Shell
Geometry is assumed to be given in [m]
Modify Element
Modifies all types of elements or creates element modifiers that do this when the model is assembled.
Orientate Elem
Sets the local coordinate system of elements.
Point-Mass
Attaches a point mass to a node of given index or position. Does not result in additional weight, only inertia!
Select Element
Selects elements according to given criteria and puts all incoming beams in two groups: selected or rejected.
Assemble Model
Creates a finite element model from given entities (points, beams, supports, loads, cross sections, materials,... ).
Connected Parts
Lists the connected parts of the active line elements of a model.
Disassemble Model
Decomposes a model into its components
Element Activation
Activates the elements of a model according to the activation list. Uses soft kill approach for inactive elements.
Modify Model
Modifies a finite element model according to given entities (points, beams, supports, loads, cross sections, materials,... ).
Support
Creates supports at nodes of given node-indexes or node-coordinates. Lets you select translations/rotations which should be zero.

6.Results

Beam View
Lets you set the display properties of beams and trusses. Plug it into the definition after a ModelView-component so that you can fine-tune the model display with it.
Model View
Lets you inspect the current state of the model.
Plug it into the data pipeline in front of 'Beam View' or 'Shell View' to control the overall model display.
Shell View
Lets you inspect the current state of the shells in a model. Plug it into the definition after a ModelView-component so that you can fine-tune the model display with it.
Principal Strains Approximation
Approximates the principal strain directions from the model deformation at arbitrary points.
Beam Displacements
Returns displacements along beams: translations/rotations in global x-, y-, and z-direction; rotations about global x-, y- and z-axis.
Beam Forces
Retrieves section forces for all beam elements of the model.
Beam Resultant Forces
Retrieves maximum resultant section forces for all beam elements of the model.
Deformation-Energy
Retrieves deformation energies of the elements of the model.
Nodal Displacements
Returns nodal displacements: translations/rotations in global x-, y-, and z-direction; rotations about global x-, y- and z-axis.
Reaction Forces
Returns reaction forces and moments at supports.
Shell Forces
Retrieves section forces for all shell elements of the model.
Line Results on Shells
Returns results as lines painted on the shell mesh. The considered loadcase is that set at the nearest upstream ModelView-component.
Result Vectors on Shells
Returns results as vectors. The considered loadcase is that set at the nearest upstream ModelView-component.
Utilization of Elements
Returns the utilization of beams or shells for each load case according to Eurocode 3

5.Algorithms

Analyze
Calculates the deflections of a given model using first order theory for small deflections.
AnalyzeThII
Calculates the deflections of a given model using second order theory for small deflections.
BESO for Beams
Bidirectional Evolutionary Structural Optimization for beam structures.
BESO for Shells
Bidirectional Evolutionary Structural Optimization for shell structures.
Buckling Modes
Calculates the buckling modes of the given model under a specified load case and the buckling load factors. Returns positive buckling load factors only.
Eigen Modes
Calculates the eigen modes of the given model according to the special eigenvalue problem.
Large Deformation Analysis
Does incremental geometrically non-linear analysis for loads in load case zero.
Natural Vibrations
Calculates the natural vibrations of the given model.
Analyze Nonlinear WIP
Calculates the nonlinear response of the model. Is work in progress (WIP)
Optimize Cross Section
Selects optimum cross sections for beams and shells in the model according to EC3 (EN 1993-1-1) for steel structures. For beams the procedure of annex B is applied.
Optimize Reinforcement
Selects optimum reinforcement for shells according to the approach proposed by Marti (see Marti, P
Tension/Compression Eliminator
Removes elements under axial tension or compression. By default compression members will be removed.

3.Cross Section

Cross Section
Creates all types of cross sections.
Disassemble Cross Section
Retrieves properties of a cross section.
Eccentricity on Cross Section
Sets the eccentricity of a cross section relative to the element axis in local beam coordinates.
Beam-Joints
Add hinges at the end-points of beams.
Cross Section Matcher
Returns for a cross section the best fitting cross section contained in a given list. The matched cross section is equal or better in all mechanical aspects at minimum weight.
Modify Cross Section
Modifies all types of cross sections.
Cross Section Selector
Lets you select cross sections by name or regular expression from a list of cross sections.
Cross Section Range Selector
Lets you select cross sections by country, shape, family or maximum depth or width.
Read Cross Section Table from File
Reads cross section data from a csv-file.
Generate Cross Section Table
Converts a list of cross sections into a string
which can be streamed as a csv-file and used as a cross section table
Beam-Joint-Agent
Sets a hinge at the connection of a beam to another element or node.
Eccentricity on Beam
Sets the eccentricity of a cross section relative to the element axis in global coordinates.

4.Material

Disassemble Material
Retrieves properties of a material.
Read Material Table from File
Reads a list of materials from a table given in csv-format.
Material Properties
Sets the characteristic parameters of a material.
Material Selection
Lets you select a materials by name or regular expression from a list of materials.

2.Load

Disassemble Mesh Load
Converts mesh-loads to point- and element-loads.
Loads
Creates all types of loads for a structural model.
Prescribed Displacement
Prescribes displacements at nodes of given node-indexes or node-coordinates

7.Export

Export Model to DStV
Exports model to DStV file. A DStV-file is a STEP-derivative issued by the 'Deutscher Stahlbau-Verband'. Can be imported by e.g. RStab.

License

License
Informs you about and lets you manage your current license. Right-click on the icon and you can save your machine-id or load a license via the context menu.

Video Tutorials

Site design © Robin Rodricks.   Co-created by Andrew Heumann.   Karamba3D and associated data © 2022 Clemens Preisinger.  
Rhinoceros and Grasshopper are registered trademarks of Robert McNeel & Associates.  Hosted by GitHub

Report an Issue  |  Terms of Service