# StructuralPointAction

## Point force

Instances of StructuralPointAction define a point load applied to the node ([StructuralPointConnection](https://gitbook.saf.guide/structural-analysis-elements/structuralpointconnection#node)) and also the location of the point load on a 1D member ([StructuralCurveMember](https://gitbook.saf.guide/structural-analysis-elements/structuralcurvemember#1d-member-beam-column)).

The point force can be defined in three main directions (global or local coordinate system). Every point force has to be assigned to a load case.

![](https://github.com/StructuralAnalysisFormat/StructuralAnalysisFormat-Doc/blob/backup/gitbook-2.0.0/loads/broken-reference)

### Specification in the excel

| 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 |
| 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>                               |
| Force action              | Enum         |                                                           <p>On beam</p><p>In node</p>                                                          | yes                            | Specifies on which type of object the force acts                                                                                                                                                         |
| Reference node            | String       |                                                                        N3                                                                       | yes, if Force action = In node | The name of the reference node                                                                                                                                                                           |
| Reference member          | String       |                                                                        B1                                                                       | yes, if Force action = On beam | The name of the reference member                                                                                                                                                                         |
| Value \[kN]               | Double       |                                                                       -150                                                                      | yes, if Direction = X,Y or Z   | Specifies the size of the load in, acts in one direction                                                                                                                                                 |
| Vector (X;Y;Z) \[kN]      | String       |                                                                    (10;10;0)                                                                    | yes, if Direction = Vector     | Specifies the size of the load in , direction by vector                                                                                                                                                  |
| Load case                 | String       |                                                                       LC2                                                                       | 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 node or 1D member</p>                                                   |
| Origin                    | Enum         |                                                         <p>From start</p><p>From end</p>                                                        | yes, if Force action = On beam | Specifies where the origin for the position co-ordinate measurement is                                                                                                                                   |
| Coordinate definition     | Enum         |                                                          <p>Absolute</p><p>Relative</p>                                                         | yes, if Force action = On beam | Specifies the definition of the position. It may be absolute or relative                                                                                                                                 |
| Position x \[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, if Force action = On beam | Defines the position of the load on the 1D member in local coordinate system in relative or in absolute coordinates \[m]                                                                                 |
| Repeat (n)                | Integer      |                                                                        0                                                                        | yes, if Force action = On beam | Defines the number of forces acting on the beam. If the number is greater than 1, the forces are distributed uniformly over the 1D member                                                                |
| Delta x \[m]              | Double       |                                                                       0,3                                                                       | yes, if Repeat (n) > 1         | <p>Defines the distance between forces acting on the 1D member in relative or in absolute coordinates \[m]</p><p>(only applicable when ForceAction = OnBeam)</p>                                         |
| Id                        | String       |                                                       39f238a5-01d0-45cf-a2eb-958170fd4f39                                                      | no                             | Unique attribute designation                                                                                                                                                                             |

## Notes

{% hint style="info" %}
An example of use of Repeat (n) is given below. The forces are distributed uniformly meaning that the value Delta x is used for uniform distribution along the 1D member for multiple point forces.
{% endhint %}

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