# CompositeShapeDef

## Composite Shape Definition

Composite Shape definition is **required** when the cross-section type in [StructuralCrossSection](https://gitbook.saf.guide/structuralcrosssection#cross-section) sheet is set as "General".

For **manufactured** types of a cross-section, is Composite Shape Definition is **optional**, offering the possibility to share detailed shape definition, for better classification of the profile.

### Specification in excel:

| Name of the column header | Type of data |            Value example or enum definition           | Required value                 | Description                                                                                                                                                                                                                                                                                                                |
| ------------------------- | ------------ | :---------------------------------------------------: | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Name                      | String       |                         GEN\_1                        | yes                            | Name of the profile from the [StructuralCrossSection](https://gitbook.saf.guide/structuralcrosssection#cross-section) object sheet                                                                                                                                                                                         |
| Material name #           | String       |                         MAT\_1                        | yes, if polygon is not opening | Name reference to the existing [StructuralMaterial](https://gitbook.saf.guide/structuralmaterial#material) object                                                                                                                                                                                                          |
| Polygon contour #         | String       | -75.0; 105.0\| -175.0; 5.0\| 175.0; 5.0\| 75.0; 105.0 | yes (at least one)             | <p>This attribute is used to define the cross-section geometry as a polygon contour.</p><p>One cross-section shape can consist of more polygons.</p><p><strong>Openings</strong> contour are defined clockwise.</p><p><strong>Common polygons</strong> counterclockwise.</p><p>The format of the data is:</p><p>y1; z1</p> |
| Id                        | String       |          39f238a5-01d0-45cf-a2eb-958170fd4f39         | no                             | Unique attribute designation                                                                                                                                                                                                                                                                                               |

## Notes

{% hint style="info" %}
The symbol "#" means indexing of the name columns, depends on how many polygons is used, starts from 1

The contour defined clockwise is opening

The contour defined counter clockwise is polygon of the general cross-section (relation between LCS and counter clockwise direction is shown below)
{% endhint %}

![](https://2984879901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP3f3I86mz7TGPX0pWLAB%2Fuploads%2Fgit-blob-705a3f030bc1ad00620d8e158c8519d0d39edaeb%2F8_compositeshapedef_counterclockwise.png?alt=media)

{% hint style="info" %}
Each polygon has a defined material which is name reference to existing material in [StructuralMaterial](https://gitbook.saf.guide/structuralmaterial#material) sheet

* The opening has no material definition
* Each polygon contour has to be closed
* The set of all polygons and openings defines one general cross-section (one row in the Excel table)
* The number of polygons is limited to 99. The definition of the general shape has to consist of at least one polygon which is not the opening.
* CompositeShapeDef example with opening is shown below. A,B,C,D are defining the contour of cross-section (counter clockwise polygon) and E,F,K,L are defining the opening (clockwise polygon).
  {% endhint %}

![](https://2984879901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP3f3I86mz7TGPX0pWLAB%2Fuploads%2Fgit-blob-de99a65607fab547994cffaa3d4d8999708735cb%2F8_compositeshapedef_animation.gif?alt=media)