# StructuralPointAction

## Point force

Instances of StructuralPointAction define a point load applied to the node ([StructuralPointConnection](/structural-analysis-elements/structuralpointconnection.md#node)) and also the location of the point load on a 1D member ([StructuralCurveMember](/structural-analysis-elements/structuralcurvemember.md#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 %}

![](/files/NCFxYoT3ZqYDkobBbwx6)


---

# 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/structuralpointaction.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.