CSI Client Support

How to make Swarm Apps work in the SAP 2000 and Etabs plugins

Supported CSI Elements

The Swarm Client for CSI allows analysis model data to be read from and written into open ETABs and SAP models. The table below describes which CSI element types are supported, which Swarm Input and Output types those elements map to, and which CSI properties are supported.

CSI Data Type	Swarm IO Type	Read / Write / Update supported?
Joint	Point3d	Read, Write, Partial Updates
Frame	Curve, Line, LineCurve, Polyline, PolylineCurve, NurbsCurve,	Read, Write, Update
Area	Mesh	Read, Write, Update

CSI Attributes in Swarm Apps

Create CSI Elements

By including the Swarm CSI Element component in an App, native CSI Frames, Areas, and Joints can be created in CSI platforms using Swarm, and authors can set common properties like Name, Material and Section, and can assign Elements to CSI groups.

If you specify a value that does not exist, a default attribute value will be assigned

Supported Elements

Input	Description
Attributes	Use When updating the CSI geometry (see below for details)
Restraint (optional)	Restrains at joints local direction. Use Swarm SixDOFs component to specify restraints and releases. Right click on the components to set one of the preset options.
Group (optional)	Provide a group name to combine the specified elements in a group

Input	Description
Attributes	Use When updating the CSI geometry (see below for details)
Section	Specify section profile
Material	Specify material
Property File (optional)	Specify property file (.pro)
Releases (optional)	Use Swarm CSI Releases and SixDOFs components
Group (optional)	Provide a group name to combine the specified elements in a group

Input	Description
Attributes	Use When updating the CSI geometry (see below for details)
Section	Type "Shell"
Material	Specify material
Shell Type (optional)	Specify shell type
Thickness (optional)	Specify thickness
Group (optional)	Provide a group name to combine the specified elements in a group

Sample App

The Swarm App shown below creates four joints, four frames and an area, and assigns all currently supported properties:

https://swarm.thorntontomasetti.com/app/5ea04931a4572a0004745733/info

Read and Update CSI Elements

When Frames, Areas, and Joints are referenced as inputs in an App, they bring a number of CSI Element Properties along with them in the form of Attributes.

Built In Swarm Attributes

Default Built In Swarm Attribute	CSI Property
Id	Label
Name	Label (SAP), Unique Name (ETABS)
Layer	<null>
Keys	Same attribute names that Swarm CSI Element creates
Values	Same attributes that Swarm CSI Element creates
Color	(0)

• Use Extract Swarm Attributes component if you want to assign the same attributes to the updated geometry:

• Use Deconstruct and Construct Swarm Attributes component if you want to modify existing CSI attributes and assign those to the updated geometry:

The App below uses the Id Attribute to update CSI elements during a bake in Sync Mode. This App moves elements up using a text Input:

https://swarm.thorntontomasetti.com/app/5ea06e5ea4572a00047457bb/info