/Karamba3D_Toolkit

BHoM - Karamba3D integration

Primary LanguageC#GNU Lesser General Public License v3.0LGPL-3.0

Karamba_Toolkit

Description

This Toolkit can be used for interoperability between Karamba and BHoM.

Currently supported conversions and limitations

  • Currently, the supported conversion is from Karamba models to BHoM models, which can then be exported to other software via Adapters (e.g. Robot_Toolkit, etc.).
  • Only linear elements (i.e. beams) are currently supported.
  • A variety of materials are supported. Some materials are converted to custom materials.
  • Load cases, combinations, non-surface loads and support conditions (Constraint6DOF) are supported.

This functionalty already allows to leverage Karamba and BHoM to a good extent. For example, a structural engineering model can be created via Karamba, then converted to BHoM and finally exported to external FEA software via the extensive suite of BHoM Adapters.

The conversion from BHoM models to Karamba is not yet implemented.

Set up

ℹ️ NOTE: Requires installation of Karamba V3 (pre-release) ℹ️

Install from: https://github.com/karamba3d/K3D_NightlyBuilds/releases/tag/3.0.0.4-WIP

Make sure you have the right version by using the Karamba License component:

Requires BHoM (latest version)

Install the latest beta from https://bhom.xyz/.

Requires assemblies of Karamba_Toolkit in the BHoM folder

Clone and compile the Karamba_Toolkit to get them. Make sure Rhino/Excel/Revit are closed before compiling.

Example usage

  1. Perform set up (see above)
  2. Create a Karamba model. See official examples. Remember the limitations listed above.
  3. In Grasshopper, use the BHoM search menu to find the Karamba_Toolkit method called ToBHoM. To do this, press CTRL+Shift+B and type Karamba tobhom.
  4. Take the assembled Karamba model and feed it as an input to the ToBHoM component. It will output a BHoM FemModel object.
  5. Push the converted FemModel to an external structural software of choice. For instructions on this, see Introduction to BHoM_Adapter. It takes 5 minutes to read and set up a working example.

Sample file: Beam cantilever

Example file for export to Robot: Beam_Cantilever_ToRobot.gh: works Example file for export to RFEM: Beam_Cantilever_ToRFEM.gh: does not work