New in Karamba3D 3.0.0 WIP

New in Karamba3D 3.0.0.5

• "Optimize Cross Section"-component:

  • Different load-case-combinations can be used for ultimate limit state (ULS) and serviceability limit state (SLS) design optimization.

  • Displacement optimization for SLS is now done using a virtual forces approach for more economic results.

  • Elements with insufficient cross sections in ULS and SLS can be highlighted using the "ModelView"-component.

• The "ModelView"-component:

  • "Annotation/NII" option now outputs the NII force of the currently visible load-case.

  • A "Result Selection" submenu was added to the "ModelView"-component. This allows to quickly select the display of minimum and/or maximum results for load-case combinations of a specific load-case of a combination.

  • The "Annotations" submenu now contains a slider to quickly adapt display text-heights.

  • It is possible to display single shell sub-elements by providing "Shell-Index/Meshface-Index" at the "View" input-plug.

• The "Line-Line Intersection"-component:

  • Has been refined: it is now possible to define intersecting lines and lines to intersect.

  • Can intersect parallel lines which lie on each other.

• The grammar for defining load case combinations has been made more flexible.

• The order of load cases and load case combinations in the model adheres to the order of defining load case combinations and feeding load cases into the assemble component.

• The order of loads after disassembling a model now corresponds to the order of input at the "Assemble"-component.

• When using Karamba3D's "Mesh Breps"-component the underlying surface gets attached to the mesh as custom data.

• "Point-Mass"-component: added scaling factors for mass for translational inertia in global directions.

• Added the "Analyse ThII"-component to have a shortcut for specifying second order theory analysis steps. This represents an alternative to applying the "Load Case Combination Settings"-component.

• The "Buckling Modes"- and "Natural Vibes"-components now have an input-plug for specifying the load-case-combination from which second order theory forces NII are to be taken.

• "Joint Agent"-component:

  • fixed bug that caused hinges to be added to beams when the beam-identifier of the second beam did not exist.

  • made limit-distance of joint agent for testing points for vicinity dependent on the limit-distance of the 'Assemble'-component.

• Changed handling of materials with different absolute values of tensile and compressive strength in EC3 design procedure: sign of normal force decides whether the tensile or compressive strength shall be applied.

• Added joint colors to the "karamba.ini"-file.

• Added a warning in case Karamba3D detects another Grasshopper plug-in which might come with its own version of the OpenMP-library "libiomp5md.dll" since this can cause crashes.

• Made "Shell Section"-component work with breps as intersecting geometries.

The following bugs were fixed:

• Fixed bug in serialization of locally oriented supports.

• Fixed a bug in the retrieval of shell-section results which resulted in partial result display.

• Parametric UI: made arrow heads scale with the forces and moments.

• Fixed bug in definition of Tsai-Wu factor for orthotropic materials.

• "LineToBeam"-component did not convert linear-curves. Now it does.

• Material table: compressive strength of glulam timber was positive.

• Fixed problem with coloring of results with small positive and large negative range.

• Fixed bug in setting the color range via the "ModelView"-component.

New in Karamba3D 3.0.0.4

There are two big new features:

• Load case combinations

• Interoperability via BHoM (see section "BHom" of this manual and the Github repository here) which will be included in the official BHoM release in the next few days.

The current version 3.0.0 is work in progress:

• Load-case combinations haven't yet been integrated into the cross-section optimizer. The "Optimize Cross Section"-component results are based on all load-cases present in the model.

• The $N^{II}$-forces used for cross section optimization, eigenmodes-, eigen frequency- and buckling-calculations are taken as the smallest value encountered in a previous analyze step.
• Result combinations will be included to provide spectral analysis for earthquake loads.

• Not all of the examples in this manual have not yet been updated to version 3.

Load Case Combinations

Up to now Karamba3D provided the possibility to work with load-cases. These were defined at the components for creating loads by specifying their name. With version 3.0.0 Karamba3D offers load case combinations.

These components help in creating and handling load case combinations:

• "Load-Case-Combinator"-component: Takes a list of combination rules expressed as text and converts them into load-case combinations.

• "Load-Case-Disassemble"-component: Reveals details of a load-case combination: which load-cases contribute with what factors.

• "Load-Case-Combination Options"-component: Specifies details with regards to how the load-case-combination needs to be evaluated: first order theory, second order theory with possibility of linear superposition or second order theory for each load-case individually.

• "Analyze"-component: Load-case combinations know about their calculation type. The "Analyze"-component uses this information to treat them accordingly. The user can specify the load-case-combinations of interest and limit analysis to these.

• "Load-Case Selector"-component: Load case combinations can contain large sets of load-cases. The "Load-Case Selector"-component helps to select the results of interest for each point of a structure. It is possible to select the envelope of specific response properties, results of a load case of interest, or the set of results that accompany a leading property (e.g., maximum moment and other cross section forces that come along with it). The component outputs a query string which can be used as input for specifying the load-case in all result components of Karamba3D.

Depending on the given load-case selection result-components output values for multiple load-cases. This works now via Grasshopper's Data-Tree-objects. The outmost branches correspond to load-cases, then come positions along an element (if applicable), then the level of elements. Branch indexes at element-level correspond to element-indexes in the model. This eliminates the necessity to introduce dummy values in case a result-component does not apply to all types of elements.

Without the definition of load-case combinations the handling of Karamba3D models does not change as compared to previous versions of Karamba3D - with the exception of Data-Tree output at the result-components. Flattening these eliminates the difference between new and old version.