https://github.com/bhom/karamba3d_toolkit
BHoM - Karamba3D integration
https://github.com/bhom/karamba3d_toolkit
adapter analysis bhom structure
Last synced: about 1 year ago
JSON representation
BHoM - Karamba3D integration
- Host: GitHub
- URL: https://github.com/bhom/karamba3d_toolkit
- Owner: BHoM
- License: lgpl-3.0
- Created: 2022-05-11T14:18:48.000Z (about 4 years ago)
- Default Branch: develop
- Last Pushed: 2024-12-19T12:51:37.000Z (over 1 year ago)
- Last Synced: 2024-12-19T13:50:35.855Z (over 1 year ago)
- Topics: adapter, analysis, bhom, structure
- Language: C#
- Homepage:
- Size: 24.9 MB
- Stars: 5
- Watchers: 8
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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
### :information_source: NOTE: Requires installation of Karamba V3 (pre-release) :information_source:
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
0. Perform set up (see above)
1. Create a Karamba model. See [official examples](https://karamba3d.com/learn/examples/). Remember the limitations listed above.
2. 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`.
3. Take the assembled Karamba model and feed it as an input to the `ToBHoM` component. It will output a BHoM `FemModel` object.
4. Push the converted `FemModel` to an external structural software of choice. For instructions on this, see [Introduction to BHoM_Adapter](https://bhom.xyz/documentation/BHoM_Adapter/#example-usage-use-robot-adapter-to-push-export-a-bhom-model-to-robot). 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](Examples/Beam_Cantilever_ToRobot.gh): works
Example file for export to RFEM: [Beam_Cantilever_ToRFEM.gh](Examples/Beam_Cantilever_ToRFEM.gh): does not work