# CompositeShapeDef

## Composite Shape Definition

Composite Shape definition is **required** when the cross-section type in [StructuralCrossSection](/structural-analysis-elements/structuralcrosssection.md#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](/structural-analysis-elements/structuralcrosssection.md#cross-section) object sheet                                                                                                                                                                                  |
| Material name #           | String       |                         MAT\_1                        | yes, if polygon is not opening | Name reference to the existing [StructuralMaterial](/structural-analysis-elements/structuralmaterial.md#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 %}

![](/files/xSOGM7g7V64bNXyoGMpZ)

{% hint style="info" %}
Each polygon has a defined material which is name reference to existing material in [StructuralMaterial](/structural-analysis-elements/structuralmaterial.md#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 %}

![](/files/9hLb87Osz5wOGIn4Helj)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://gitbook.saf.guide/structural-analysis-elements/compositeshapedef.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
