# StructuralCurveAction

## Line force on the beam

The Line force load models load distributed over a 1D member or on a slab edge. It may be action along the whole 1D member or only on its part. It can be constant or trapezoidal, acting in three main directions X, Y, Z (global or local coordinate system).

![](/files/J2eCx0HgaEZLYAWDtPfv)

| Name of the column header | Type of data |                                                         Value example or enum definition                                                        | Required value                                                                               | Description                                                                                                                                                                                                                                                                                                                                                                                                            |
| ------------------------- | ------------ | :---------------------------------------------------------------------------------------------------------------------------------------------: | -------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Name                      | String       |                                                                        F3                                                                       | yes                                                                                          | Human readable unique name of the force                                                                                                                                                                                                                                                                                                                                                                                |
| Type                      | String       |                                                                     Standard                                                                    | no                                                                                           | This property defines what the load is caused by, E.g. Standard, Wind, Snow, Self weight, Hoar Frost, Predefined, Plane Load, Water Pond, Water Pressure, Soil Pressure, Generated Water, Generated Soil                                                                                                                                                                                                               |
| Force action              | Enum         |                             <p>On beam</p><p>On edge</p><p>On subregion edge</p><p>On opening edge</p><p>On rib</p>                             | yes                                                                                          | Specifies on which type of object the force acts                                                                                                                                                                                                                                                                                                                                                                       |
| Distribution              | Enum         |                                                           <p>Uniform</p><p>Trapez</p>                                                           | yes                                                                                          | The load may be either constant along the 1D member or linearly variable (trapezoidal).                                                                                                                                                                                                                                                                                                                                |
| Direction                 | Enum         |                                                      <p>X</p><p>Y</p><p>Z</p><p>Vector</p>                                                      | yes                                                                                          | <p>Specifies the base direction of the load</p><p>X, Y, Z - action will be applied in one of these directions</p><p>Vector - size and direction calculated from vector</p>                                                                                                                                                                                                                                             |
| Value 1 \[kN/m]           | Double       |                                                                       -150                                                                      | yes, if Direction = X,Y or Z                                                                 | <p>Specifies the first size of the load in, acts in one direction</p><p>Value1 is always closer to origin (see notes)<br></p>                                                                                                                                                                                                                                                                                          |
| Value 2 \[kN/m]           | Double       |                                                                       -180                                                                      | <p>yes, if Direction = X,Y or Z</p><p>yes, if Distribution = Trapez</p>                      | <p>Specifies the second size of the load in, acts in one direction</p><p>Value2 is always further from origin (see notes)</p>                                                                                                                                                                                                                                                                                          |
| Vector 1(X;Y;Z) \[kN/m]   | String       |                                                                    (10;10;0)                                                                    | yes, if Direction = Vector                                                                   | <p>Specifies the first size of the load in, direction by vector</p><p>Note: Vector1 and Vector2 needs to be in same direction</p>                                                                                                                                                                                                                                                                                      |
| Vector 2(X;Y;Z) \[kN/m]   | String       |                                                                    (20;20;0)                                                                    | <p>yes, if Direction = Vector</p><p>yes, if Dsitribution = Trapez</p>                        | <p>Specifies the second size of the load in, direction by vector</p><p>Note: Vector1 and Vector2 needs to be in same direction</p>                                                                                                                                                                                                                                                                                     |
| Member                    | String       |                                                                       B11                                                                       | yes, if Force action = On beam                                                               | The name of the [StructuralCurveMember](https://saf.guide/Content/A_Objects/7_StructuralCurveMember.htm) on which the load is applied                                                                                                                                                                                                                                                                                  |
| Member Rib                | String       |                                                                       B11                                                                       | yes, if Force action = On rib                                                                | The name of the [StructuralCurveMemberRib](https://saf.guide/Content/A_Objects/25_StructuralCurveMemberRib.htm) on which the load is applied                                                                                                                                                                                                                                                                           |
| 2D Member                 | String       |                                                                        S1                                                                       | yes, if Force action = On edge                                                               | <p>The name of the <a href="/pages/7eKYIRAYPJhFS9PAOmM4">StructuralSurfaceMember </a>which the load is applied.<br><a href="/pages/Qn67QF1S3wGEmi4rlDCU">StructuralCurveAction</a> can act either on a 2D member edge or on internal edge.</p>                                                                                                                                                                         |
| 2D Member Region          | String       |                                                                        R1                                                                       | yes, if Force action = On subregion edge                                                     | The name of the [StructuralSurfaceMemberRegion](/structural-analysis-elements/structuralsurfacememberregion.md) on which is the load applied.                                                                                                                                                                                                                                                                          |
| 2D Member Opening         | String       |                                                                        O1                                                                       | yes, if Force action = On opening edge                                                       | The name of the [StructuralSurfaceMemberOpening](/structural-analysis-elements/structuralsurfacememberopening.md) on which is the load applied.                                                                                                                                                                                                                                                                        |
| Edge                      | Integer      |                                                                        1                                                                        | yes, if Force action acts on edge of 2D Member edge or 2D member region or 2D member opening | The index starting with 1. The order is according to order of “edges” property at [StructuralSurfaceMember](/structural-analysis-elements/structuralsurfacemember.md), [StructuralSurfaceMemberRegion](/structural-analysis-elements/structuralsurfacememberregion.md) or [StructuralSurfaceMemberOpening](/structural-analysis-elements/structuralsurfacememberopening.md) on which the load is applied               |
| Internal edge             | String       |                                                                       ES2                                                                       | yes, if Force action = On edge                                                               | The name of the [StructuralCurveEdge](https://saf.guide/Content/A_Objects/6_StructuralCurveEdge.htm) on which is the load applied. [StructuralCurveAction](https://saf.guide/Content/A_Objects/19_StructuralCurveAction.htm#) can act either on a 2D member edge or on internal edge.                                                                                                                                  |
| Load case                 | String       |                                                                       LC1                                                                       | yes                                                                                          | The name of the load case to which the force belongs                                                                                                                                                                                                                                                                                                                                                                   |
| Coordinate system         | Enum         |                                                            <p>Global</p><p>Local</p>                                                            | yes                                                                                          | <p>Defines the co-ordinate system of the member in which the load is applied</p><p>For " Local", coordinate system is defined by the member where is load applied</p>                                                                                                                                                                                                                                                  |
| Location                  | Enum         |                                                          <p>Length</p><p>Projection</p>                                                         | yes                                                                                          | Specifies whether the load is "put directly on an inclined 1D member" or whether the "projection on plan" is defined.                                                                                                                                                                                                                                                                                                  |
| Coordinate definition     | Enum         |                                                          <p>Absolute</p><p>Relative</p>                                                         | yes                                                                                          | Selects the coordinate system that is used to define the length of the line load. Relative means without units. To define length of the load in meters input absolute                                                                                                                                                                                                                                                  |
| Origin                    | Enum         |                                                         <p>From start</p><p>From end</p>                                                        | yes                                                                                          | Specifies the origin of the coordinate system used for the definition of the length of the force                                                                                                                                                                                                                                                                                                                       |
| Extent                    | Enum         |                                                              <p>Full</p><p>Span</p>                                                             | yes                                                                                          | Defines if a load is extended just over a span instead of the whole 1D member, it is used if a 1D member consists of more than one span. This feature is not fully supported, only two spans are supported in the moment.                                                                                                                                                                                              |
| Start point \[m]          | Double       |  <p>value in meters for Coordinate definition = Absolute</p><p>0,0</p><p>value in percentage for Coordinate definition = Relative</p><p>0,0</p> | yes                                                                                          | Defines the position of the start point of the force in relative or absolute coordinates \[m]                                                                                                                                                                                                                                                                                                                          |
| End point \[m]            | Double       | <p>value in meters for Coordinate definition = Absolute</p><p>5,25</p><p>value in percentage for Coordinate definition = Relative</p><p>1,0</p> | yes                                                                                          | Defines the position of the end point of the force in relative or absolute coordinates \[m]                                                                                                                                                                                                                                                                                                                            |
| Eccentricity ey \[mm]     | Double       |                                                                       -150                                                                      | yes                                                                                          | Eccentricity of the force system line in Y direction of the local coordinate system                                                                                                                                                                                                                                                                                                                                    |
| Eccentricity ez \[mm]     | Double       |                                                                        75                                                                       | yes                                                                                          | Eccentricity of the force system line in Z direction of the local coordinate system                                                                                                                                                                                                                                                                                                                                    |
| Parent ID                 | String       |                                                       67b35d84-3d04-47aa-aa4a-dc1263982320                                                      | no                                                                                           | <p>Is filled for objects created be dividing curved geometry to series of straight line objects.<br><br>Parent ID will ensure that curved edge is imported as straight parts to nonsupporting application, and back to original supporting application as curved geometry.</p><p>To ensure successful round trip of segmented objects and their related objects, Parent ID needs to be present in both directions.</p> |
| Id                        | String       |                                                       39f238a5-01d0-45cf-a2eb-958170fd4f39                                                      | no                                                                                           | Unique attribute designation                                                                                                                                                                                                                                                                                                                                                                                           |

## Notes

{% hint style="info" %}
Difference between Location type Length and Projection can be seen in the picture. Location is used only if Coordinate system is Global.
{% endhint %}

![](/files/iULIMFL16y5w0YNDjdA7)

{% hint style="info" %}
An example of use of parameter Extent is in the in the picture below. In case of Span the load acts only on the span which is defined by internal nodes
{% endhint %}

![](/files/yY81OSFFAHvXejYtYf8z)

{% hint style="info" %}
An example with Distribution type Trapez and with different values 1 and 2 can be seen in the following picture. Coordinate definition is relative, start point 0 and end point 0,3. StructuralCurveAction 1 has origin "From start" and StructuralCurveAction 2 has origin "From end". In this case the parameter extent doesn’t make any difference, only in case of beams consisting of more parts.
{% endhint %}

![](/files/huh598jLfunzBBjOjkww)


---

# 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/loads/structuralcurveaction.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.
