> For the complete documentation index, see [llms.txt](https://tlcfem.gitbook.io/suanpan-manual/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tlcfem.gitbook.io/suanpan-manual/section/sectionnm/nm3d2.md).

# NM3D2

$$N$$-$$M$$ Interaction Inelastic Section (Linear Hardening)

## References

1. [10.1061/JSENDH.STENG-12176](http://dx.doi.org/10.1061/JSENDH.STENG-12176)

## Syntax

### Option One

```
section NM3D2 (1) (2...11)
# (1) int, unique section tag
# (2) double, EA
# (3) double, strong axis EI
# (4) double, weak axis EI
# (5) double, yielding axial force
# (6) double, yielding strong axis moment
# (7) double, yielding weak axis moment
# (8) double, c
# (9) double, isotropic hardening parameter H
# (10) double, kinematic hardening parameter K
# (11) double, linear density
```

The $$N$$-$$M$$ interaction surface is defined as follows.

$$
f=1.15p^2+m\_s^2+m\_w^4+3.67p^2m\_s^2+3p^6m\_w^2+4.65m\_s^4m\_w^2-c
$$

where $$p$$, $$m\_s$$ and $$m\_w$$ are normalised axial force and moments about the strong and weak axes. This surface is suitable for I-sections.

### Option Two

One may wish to customise the surface by assigning different weights and orders, it is possible by using the following syntax.

```
section NM3D2 (1) (2...11) [(12) (13) (14) (15)...]
# (1) int, unique section tag
# (2) double, EA
# (3) double, strong axis EI
# (4) double, weak axis EI
# (5) double, yielding axial force
# (6) double, yielding strong axis moment
# (7) double, yielding weak axis moment
# (8) double, e
# (9) double, isotropic hardening parameter H
# (10) double, kinematic hardening parameter K
# (11) double, linear density
# (12) double, a_i
# (13) double, b_i
# (14) double, c_i
# (15) double, d_i
```

In the above command, parameters `(12)`, `(13)`, `(14)` and `(15)` form a set of parameters and can be appended as many groups as the analyst wishes. The surface is assumed to possess the following form,

$$
f=\sum\_{i=1}^na\_ip^{b\_i}m\_s^{c\_i}m\_w^{d\_i}-e.
$$

For example, the previous surface $$f=1.15p^2+m\_s^2+m\_w^4+3.67p^2m\_s^2+3p^6m\_w^2+4.65m\_s^4m\_w^2-c$$ can be equivalently expressed with the second syntax as follows.

```
section NM3D2 (1) (2...11) \
1.15 2. 0. 0. \
1. 0. 2. 0. \
1. 0. 0. 4. \
3.67 2. 2. 0. \
3. 6. 0. 2. \
4.65 0. 4. 2.
```

The only validation implemented is the number of triplets. The command takes $$4n$$ parameters and interprets them accordingly. Please make sure the definition is correct.

## Remarks

The true hardening ratio is defined as

$$
\dfrac{H+K}{1+H+K},
$$

since $$H$$ and $$K$$ are hardening ratios based on plastic strain.

## Output Type

This model supports the following additional history variables to be recorded.

| variable label | physical meaning                 |
| -------------- | -------------------------------- |
| YF             | yielding flag (vector of size 2) |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://tlcfem.gitbook.io/suanpan-manual/section/sectionnm/nm3d2.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.