> For the complete documentation index, see [llms.txt](https://docs.openbrim.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.openbrim.org/developers/paramml-developer-guide/functions/custom-function/section-analysis-functionsmoment-capacity-moment-curvature-interaction-diagram-max-rebar-stress.md).

# Section Analysis Functions(Moment Capacity - Moment Curvature - Interaction Diagram - Max Rebar Stress)

The functions below utilizes a non-linear strain-compatibility methodology. Non-linear material models are applied to concrete materials and reinforcing strands by associating curves with their material definitions. Essentially, these functions requires a **section definition, orientation, concrete failure strain in compression, axial force, concrete failure strain in tension, resistance factor for compression, resistance factor for tension, refinement, a boolean value about using tendon initial strain, compression-controlled strain limit in the extreme tension steel** inputs.

**Tendons.** A tendon layout's force sets its initial strain (force / the tendon's area / E). In the section's forces a bonded tendon is read at its total strain, initial strain plus the section's strain, through its material's curve: it cannot pass the curve's strength (fpu), and in the compressed zone it keeps a reduced tension (AASHTO 5.6.4.4-2: fpe − Ep·εcu). An unbonded tendon keeps its initial tension. For an AASHTO reading the layout's force should be the effective force after losses (fpe × area). The steel stress and strain the functions *report* (maxRebarTensileStress, momentCapacityStrainAndCondition's MaxSteelStrain) are those of the section's strain alone: for a strand, the change after decompression, as AASHTO's f\_ss and εt for prestressed members are defined. The **useTendonInitStrain** argument is accepted and ignored: the initial strain is always used. Because a strand in the compressed zone keeps its tension, a prestressed section can have net tension above the neutral axis. Such a state is balanced by its forces, signed (they must add up to the axial force), the neutral axis is searched by that signed net force, and a prestressed section's moment is the signed moment of its forces about the centroid (the sum of magnitudes times distances would add the moment of a resultant that lies on the far side of the centroid). Where the solver accepts no state, momentCapacity answers 0 and momentCurvature leaves that point out, and that is not proof that the section has no balanced state: a state with no force at all on one side of the neutral axis is not accepted (a prestressed girder in negative bending with no tension steel, whose only balanced states are the small couple of the strands and the concrete around them), the neutral axis is not searched outside the section, and under axial compression the solver can reject a balanced state. momentCapacity also answers 0 when the only balanced state bends the section the other way (that girder under axial tension).

An eccentrically prestressed section's moment-curvature curve does not pass through the origin: at zero curvature it needs the moment that cancels its prestress (a pretensioned girder's camber), so the curve crosses zero moment away from zero curvature. maxRebarTensileStress then brackets the service moment by signed values on that curve (for every other section it interpolates as before, through the origin), and momentCurvatureIdealized answers an empty list (the bilinear idealization is drawn from the origin; it also answers an empty list when one direction has no point). For a section with a tendon, momentCurvature includes the zero-curvature state, the moment that holds the section straight under the axial force (its sampled states either side lie past cracking, so the curve would otherwise run straight across its uncracked part); momentCurvatureIdealized leaves that point out of its fit. A moment-curvature curve ends where a bar, strand or steel shape passes its strain limit (see the end of this list); a lightly reinforced section's curve can end before its top strain reaches εcu, and momentCurvatureIdealized's ultimate point with it. The section is analysed as drawn, with no construction staging: for a composite section with strands (girder and deck together), the strands prestress the deck as well, so the deck reinforcement's stress includes the prestress' share (conservative against a staged reading, where the prestress acts on the girder alone). Where the whole section is in compression the solver has no state, and maxRebarTensileStress interpolates across that range.

Here are the functions;

**momentCapacity(section,orientation,εcu, axial force,εtl,ϕ compression,ϕ tension, refinement, useTendonInitStrain, εcl) → number :** This function determines the bending moment capacity under a specific axial force and orientation while taking into account the failure strain of concrete in compression and tension. To obtain the negative flexural capacity of the section, the orientation should be set to PI. The capacity is taken with the concrete at εcu whatever the steel's strain, as AASHTO 5.6.2.1 assumes: the steel's strain limit (below) does not bound it, and the section editor's Flexural Strength says when a bar or strand is past it.

**momentCapacityNA(section,orientation,εcu, axial force,εtl,ϕ compression,ϕ tension, refinement, useTendonInitStrain,εcl) → number:** This function determines the neutral axis location of the section under a specific axial force and orientation while taking into account the failure strain of concrete in compression and tension.

**momentCapacityTension(section, orientation,εcu, axial force,εtl,ϕ compression,ϕ tension, refinement, useTendonInitStrain,εcl) → number:** This function determines the tension force acting on the section under axial force and orientation.

**momentCapacityTensionLoc(section, orientation,εcu, axial force,εtl,ϕ compression,ϕ tension, refinement, useTendonInitStrain,εcl) → number:** This function determines the tension force location on the considered section.

**momentCapacityCompression(section, orientation,εcu, axial force,εtl,ϕ compression,ϕ tension, refinement, useTendonInitStrain,εcl) → number:** This function determines the compression force acting on the section under axial force and orientation.

**momentCapacityCompressionLoc(section, orientation,εcu, axial force,εtl,ϕ compression,ϕ tension, refinement,useTendonInitStrain,εcl) → number:** This function determines the compression force location on the considered section.

**momentCapacityLeverArm(section, orientation,εcu, axial force,εtl,ϕ compression,ϕ tension, refinement,useTendonInitStrain,εcl) → number:** The distance between the resultant of the tensile forces and the resultant of the compressive forces at the flexural strength state, each force by its own sign (AASHTO 5.7.2.8's d\_v before its limits). The Tension and Compression locations above are the two sides of the neutral axis: a tendon in the compressed zone keeps its tension and, summed with the concrete, moves that side's resultant, so their difference can exceed the section's depth; this function counts that tendon as a tensile force. Never negative: 0 where the state has no tension or no compression, where no state exists, and where the tension resultant lies on the compressed side of the compression resultant.

**sectionAgBottomRatio(section, orientation, ratio) → number:** The area within ratio (default 0.5, clamped to 0..1) of the depth of the section turned by orientation, from its bottom: AASHTO 5.7.3.4.2's A\_ct at 0.5. The depth is the solid shapes'. Polygon-clipped, exact on an I-girder. Shapes are taken as drawn, as by sectionAg: cutouts subtract, bar and tendon layouts do not count, any other shape does whatever its material; read without a station, ratio 1 gives sectionAg's area on a section with drawn shapes. 0 when refused. At the caller's station, or without one as it stands (as sectionAg and Engine3 read it); a parameter computed from it is cached per station where the section varies, whatever the order of reads.

**sectionRebarBottomRatio(section, orientation, ratio) → \[A\_s, d\_s]:** The mild bars in the same band and the depth from the extreme compression fibre to their centroid; \[0, 0] when the band holds none or the call is refused. Steel on the band's line counts at half its area (bars and tendons alike); at ratio 1 all of it counts. Bars count at full area: reducing A\_s for a bar short of its development length (5.7.3.4.2) is the caller's.

**sectionTendonBottomRatio(section, orientation, ratio, mode, fpe, fps, memberDepth) → \[A\_ps or force, d\_p]:** The bonded prestressing steel in the same band (debonded lengths and unbonded post-tensioning left out). mode 0: area; mode 1: each strand layout's area times min(1, l\_px / l\_d); mode 2: force at f\_px (5.9.4.3.2-2 and -3). Modes 1 and 2 need fps > 0 and 0 ≤ fpe ≤ fps; any other mode or stresses, an infinite one included, are refused with \[0, 0] (mode 0 reads neither stress; an infinite memberDepth counts as not given). l\_d = κ (fps − 2/3 fpe) d\_b, κ 1.0 / 1.6 by memberDepth (or, when it is NULL, NaN or not positive, the turned section's depth) against 24 in, 2.0 for a strand layout whose own isDebonded is 1 (C5.7.2.8; the section builder has to set it). l\_px is the lesser of the layout's dToBondSt and dToBondEnd, read at the caller's station; without them (or NULL) a layout counts in full, and a distance that is not a finite number, on a layout with a strand in the band, refuses the call. A NULL DebondingLength leaves the layout out, as in the section analysis. At a bonded end, where no bonded strand counts, the answer is \[0, d\_p], not \[0, 0]. For A\_ps f\_po, mode 2 with fpe = fps = f\_po ramps f\_po over the transfer length. Inches and ksi.

**momentCapacityCurvature(section, orientation,εcu, axial force,εtl,ϕ compression,ϕ tension, refinement, useTendonInitStrain,εcl) → number:** This function determines the Curvature value of the section under given loading.

**momentCapacityStrainAndCondition(section,orientation,εcu, axial force,εtl,ϕ compression,ϕ tension, refinement, useTendonInitStrain,εcl) → \[PhiFactor:number, MaxSteelStrain:number, StrainCondition:enumaration] :** This function returns a list that includes the resistance factor (which takes the value of "**εcl**" for compression-controlled and "**εtl**" for tension-controlled and undergoes interpolation between etl and ecl for the transition zone), along with the maximum strain value and the strain condition of the extreme tension reinforcement. The strain condition is indicated as follows: 0 for Tension Controlled, 1 for Compression Controlled, and 2 for the Transition Zone.

**maxRebarTensileStress(section, orientation, axial force, moment, εcu, εtl, φcompression, φtension, refinement, useTendonInitStrain, εcl, prestressInLoads) → number :** This function determines the maximum rebar stress on the tension reinforcement under a given axial force and moment. Pass **prestressInLoads** = 1 when the axial force and moment already include the prestress, as a service combination read from the FE analysis does when the prestress load case is in it. The tendons then carry no initial strain in this call: a bonded tendon takes the section's strain like a bar, an unbonded one adds nothing, and the curve passes through the origin. Leave it out (or 0) when the forces come from the other loads only: the tendons then keep their initial strain (see **Tendons** above). Leaving it out for forces that include the prestress counts the prestress twice. With **prestressInLoads** = 1 the moment is taken about the centroid of the section's concrete outline (its shapes without the bar and tendon layouts: the axis a frame element whose section is that outline reports its forces about) and moved onto the centroid the solver's strips take moments about, bars and tendons included: with the whole prestress in the axial force, the distance between the two axes is worth axial force times that distance in moment. This applies to every call with the flag, sections without tendons included.

**interactionDiagram(section, orientation, εcu, εtl, φcompression, φtension, refinement, useTendonInitStrain, axial force, εcl) → \[\[Mu1, Pu1],\[Mu2, Pu2]….]:** This function calculates the interaction diagram curve points based on given parameters and returns a list containing point coordinates where Mu1, Mu2… represents moment and Pu1,Pu2... represents axial force. The points are the compression part of the interaction surface's diagram at that orientation (below), from the largest axial force down to zero axial force: each state integrated once over the section, its moment signed about the centroid. Where the concrete's curve falls between its peak and εcu (with a peak below εcu), the nominal moment at a nominal axial force is the most any admissible state carries there: the top fibre at the concrete's peak strain, at εcu or between, with the neutral axis below the section or in it. A fibre past its peak carries less, so on a wide flange in compression the states with the top below εcu carry more than those with εcu at the top (a 72 in bulb tee with its deck in compression: up to about 40 % more, factored, at 0.6 to 0.7 of the diagram's top; rectangular columns, caps and piles up to about 2.5 %); at zero axial force the εcu state leads. Each point is then factored by φ from the state with εcu at the top at the same eccentricity (AASHTO 5.6.2.1 reads εt, and so φ, at εcu), so φ varies smoothly along the curve. Where φ grows from compression- to tension-controlled faster than the nominal force falls, the factored force turns back up; the diagram keeps the lower branch there and steps out level where the curve comes back below it. With εcl = εtl (`OBP_InteractionDiagram`'s defaults) φ steps from φ compression to φ tension at εtl itself. Just above such a step the interaction surface (`interactionCapacity`, `interactionRatio`) can read more than the 2-D diagram on a flanged section, because each meridian steps at its own axial force (up to about 20 % of the largest moment in a band a few kip wide with coarse strips and a fine surface step; not seen at the default 10°); the 2-D diagram is the lower of the two there. **Against the AASHTO rectangular stress block:** the default concrete curve peaks at the full f′c (no 0.85 factor), so on a section whose compression is mostly a wide flange the nominal moment reads well above a block analysis — in an independent model of a bulb tee with its deck in compression about 13–18 % above it with εcu at the top and 33–59 % above it with this rule, at 0.6–0.7 of the top; rectangular columns about 16 % above it either way. Use your own concrete curve, or check such sections against the block, where that matters. The moment is the capacity for moments that compress the side the orientation compresses, never negative: where a state needs a moment the other way (a prestressed girder near pure compression in negative bending, which its strands bend up), the points run on the axial-force axis from where the moment changes sign. A non-zero **axial force** caps the diagram there (AASHTO 5.6.4.4): the first two points are (0, cap) and (the diagram's moment at the cap, cap), one point when that moment is 0 on the axis; a cap at or above the diagram's top caps it at the top. A demand above the cap then reads a moment of 0 on the horizontal first segment.

**interactionCapacity(section, P, My, Mz, εcu, εtl, φcompression, φtension, refinement, εcl, step) → number:** The moment the section carries in the direction of the demand's moment (My, Mz) at its axial force P, at constant P (P compression positive; +My compresses the section's +y fibre, +Mz its +x fibre), read off the section's interaction surface: diagrams every **step** degrees (10 by default) round the section. One diagram at an orientation gives the moment about the neutral-axis line, which points elsewhere on a section that is not symmetric about the axis across it; this function does not, and it tells the two faces of the section apart. It returns 0 beyond the axial range, and where even a moment-free load fails at that P (an unsymmetric section near pure compression or pure tension), so guard the ratio √(My² + Mz²) / interactionCapacity(…).

**interactionRatio(section, P, My, Mz, εcu, εtl, φcompression, φtension, refinement, εcl, step) → number:** The radial demand-to-capacity ratio on the same surface: the length of the load over the length to the surface along the ray from the origin through it, as the section editor's Interaction Diagram shows it. 0 for no load. -1 when there is no ratio: the section carries no load in that plane at all, the surface could not be built, an argument is missing or not a number, the section does not resolve, or the project is loading. -1 is not a pass: guard it, e.g. `max(iif(ratio .GE. 0, ratio, 99), iif(P_r .GT. 0 .AND. Pu .GT. 0, Pu / P_r, 0))`.

**interactionCurve(section, direction, εcu, εtl, φcompression, φtension, refinement, εcl, step) → \[\[M1, P1], \[M2, P2]….]:** The capacity the two functions above read, to draw demands against: the section of the same surface by the vertical plane of the moment direction **direction** (radians, the orientation whose diagram compresses that side, as interactionDiagram takes it), moments ≥ 0, as a closed polygon whose edges on the axial-force axis close it.

For all three: φ is applied as interactionDiagram applies it (only when φcompression and φtension differ), no axial limit is applied (apply AASHTO 5.6.4.4 yourself), and the first call per section and set of inputs builds the surface (about 0.2-6 s by refinement; cached afterwards until the section changes). Every state of the surface, and of interactionDiagram, is one the section can reach: concrete at most at εcu, and every steel at most at its strain limit in tension, its total strain counted (a tendon's prestrain in): its material's failure strain in tension (esuTens) where it has one, else its stress-strain model's esu, else its material's, else 0.05. Pure tension is the steel at that limit whatever the refinement. Moment curvature stops at the same limit (its curve ends there); momentCapacity does not. A bonded tendon is read at its total strain (prestrain + section strain) through its curve: it keeps a reduced tension in the compressed zone (AASHTO 5.6.4.4-2) and never passes its curve's strength. Every function on this page takes a tendon into its forces that way (see **Tendons** above).

Here are explanations about the inputs;

**section: ‘Section’**

```xml
<O N="Rectangle" T="Section" Material="@Fc_4ksi\|Material" Ay="432.00000000000546" Az="432.00000000000546" Iy="20735.999999999978" Iz="11664.000000000027" Izy="8.526512829121202e-14" Cz="-1.8770992990421393e-15" Cy="-1.8812112361703803e-15" Perimeter="84" MinZ="-12" MaxZ="12" MinY="-9" MaxY="9">
 <P N="w" V="18" D="Width" Category="Rectangle Shape" UT="Length" UC="Property" />
 <P N="d" V="24" D="Depth" Category="Rectangle Shape" UT="Length" UC="Property" />
 <O T="Shape">
 <O T="Point" X="-w/2" Y="-d/2" />
 <O T="Point" X="w/2" Y="-d/2" />
 <O T="Point" X="w/2" Y="d/2" />
 <O T="Point" X="-w/2" Y="d/2" />
 </O>
 <O T="RebarLineLayout">
 <P N="UseReferenceEdge" V="1" />
 <P N="Material" V="A615_60" T="Material" />
 <P N="RebarProfile" V="ASTMA615No6" T="Rebar" />
 <P N="BarDiameter" V="0.75" />
 <P N="NumberOfRebars" V="4" />
 <P N="RowSpacing" V="0" />
 <P N="NumberOfRows" V="1" />
 <P N="ReferenceEdge" V="0" />
 <P N="DistanceToEdge" V="1" />
 <P N="RebarSpacing" V="3" />
 <P N="InnerRebarSpacing" V="3" />
 <O T="Point" X="(-(NumberOfRebars-1)*((NumberOfRebars-2)*RebarSpacing+InnerRebarSpacing)/(NumberOfRebars-1)/2)+0" Y="(sectionDepth(Rectangle)/2-(DistanceToEdge+RebarProfile.D/2+((NumberOfRows-1)*RowSpacing)/2))+0" />
 <O T="Point" X="((NumberOfRebars-1)*((NumberOfRebars-2)*RebarSpacing+InnerRebarSpacing)/(NumberOfRebars-1)/2)+0" Y="(sectionDepth(Rectangle)/2-(DistanceToEdge+RebarProfile.D/2+((NumberOfRows-1)*RowSpacing)/2))+0" />
 </O>
 <O T="TendonLayout" Tensioning="0" StrandCount="1">
 <P N="DistanceToEdge" V="2" />
 <P N="TendonSpacing" V="3" />
 <P N="Material" V="A416_270low_relaxation" T="Material" />
 <P N="StrandProfile" V="Grade250_5_16_No8" T="Strand" />
 <P N="NumberOfTendons" V="6" />
 <P N="UseReferenceEdge" V="1" />
 <P N="Force" V="100" />
 <P N="DebondingLength" V="0" />
 <P N="ReferenceEdge" V="1" />
 <P N="InnerTendonSpacing" V="3" />
 <O T="Point" X="(-(NumberOfTendons-1)*((NumberOfTendons-2)*TendonSpacing+InnerTendonSpacing)/(NumberOfTendons-1)/2)+0" Y="(-sectionDepth(Rectangle)/2+(DistanceToEdge))+0" />
 <O T="Point" X="((NumberOfTendons-1)*((NumberOfTendons-2)*TendonSpacing+InnerTendonSpacing)/(NumberOfTendons-1)/2)+0" Y="(-sectionDepth(Rectangle)/2+(DistanceToEdge))+0" />
 </O>
 </O>
```

![](https://openbrim.atlassian.net/wiki/download/attachments/2254832345/image-20230817-114600.png?api=v2) | The provided ParamML code represents the definition of a rectangular section named "Rectangle." This section is described with its geometric properties, reinforcement, and other details. Here's a breakdown of what the code does:

1. **Section Properties:** - The section is named "Rectangle." - It is defined as a "Section" type. - The material for the section is referenced as "@Fc\_4ksi|Material," which indicates that the material properties for this section are taken from the material named "Fc\_4ksi." - Various properties of the section are specified, such as area moments of inertia (Iy, Iz, Izy), centroid coordinates (Ay, Az), and more. 2. **Geometry and Shape:** - The width of the rectangle is specified using the parameter "w." - The depth of the rectangle is specified using the parameter "d." - The shape of the rectangle is defined using points in a clockwise order, starting from the bottom left corner and proceeding around the perimeter. 3. **Reinforcement Layout:** - The section includes a "RebarLineLayout" to define reinforcement details. - The layout specifies the use of a reference edge, material (A615\_60), rebar profile (ASTMA615No6), bar diameter, number of rebars, and spacing between rebars. - The layout positions the rebars along the width of the rectangle, with a certain distance from the edges and a given spacing. 4. **Tendon Layout:** - The section also includes a "TendonLayout" for tendon (prestressing cable) details. - The layout specifies parameters like distance to edge, tendon spacing, material (A416\_270low\_relaxation), number of tendons, and force applied to the tendons. - The layout positions the tendons along the width of the rectangle, with a certain distance from the edges and a given spacing.

In summary, the code defines a rectangular section with specified geometric properties, reinforcement (rebars and tendons), and other relevant details for further analysis and calculations. The provided properties allow for the calculation of various structural characteristics, such as moment of inertia, centroid, and reinforcement layout, which are crucial for designing and analyzing the behavior of the rectangular section in structural applications.

To see further information about T=”Section” object, see [Section Object](https://docs.openbrim.org/developers/paramml-developer-guide/core-objects/finite-elements-objects/section-object.md) . To view this example in the library, see (<https://openbrim.org/app/?incubator=1&author=ParamML_Examples_OpenBrIM+Platform&obj=objid560qzp8sjvck01r5hxf6b9>)

**orientation : ‘Angle’ (in radians)**

```xml
<P N="Orientation1" V="0" />
 <P N="FlexuralCapacity1" V="momentCapacity(Rectangle,Orientation1,E_cu1,AxialForce1,E_tu1,phi_Compression1,phi_Tension1,Refinement1)" D="[EXPR_ALIAS: ]" />
 <P N="Orientation2" V="pi/2" />
 <P N="FlexuralCapacity2" V="momentCapacity(Rectangle,Orientation2,E_cu1,AxialForce1,E_tu1,phi_Compression1,phi_Tension1,Refinement1)" D="[EXPR_ALIAS: ]" />
```

![](https://openbrim.atlassian.net/wiki/download/attachments/2254832345/image-20230831-131704.png?api=v2) ![](https://openbrim.atlassian.net/wiki/download/attachments/2254832345/image-20230817-091750.png?api=v2) ![](https://openbrim.atlassian.net/wiki/download/attachments/2254832345/image-20230831-131737.png?api=v2) ![](https://openbrim.atlassian.net/wiki/download/attachments/2254832345/image-20230817-091835.png?api=v2) You can observe that the unaxial moment capacity of the section about x-axis and unaxial moment capacity of the section about y-axis are different and can be obtained by entering orientation as 0 for the flexural capacity of the section about x-axis and 90 degrees for the flexural capacity of the section about y-axis. The flexural capacity of a section subjected to biaxial flexure is calculated by considering the interaction between moments around both principal axes (X and Y axes) and the corresponding axial load.

The interaction between axial load and biaxial moment can be represented by an equation. This equation relates the axial load ratio, the biaxial moment ratio for both axes, and the column's capacity reduction factors. It takes the form:

→ φ(P/Pn) + φMx(Mu/Mnx) + φMy(Mu/Mny) ≤ 1.0

where φ is the capacity reduction factor, Mnx and Mny are the nominal moment capacities about the X and Y axes, and Mu is the applied biaxial moment.

![](https://openbrim.atlassian.net/wiki/download/attachments/2254832345/image-20230821-090140.png?api=v2)

When a section is subjected to bending moments around both the X-axis and the Y-axis, the biaxial moment value and its angle can be calculated using principles of structural mechanics.

The biaxial moment (Mλ) can be calculated using vector addition of the moments around the two axes:

→ Mλ = sqrt(Mx^2 + My^2)

The angle (θ) of the biaxial moment with respect to one of the axes can be determined using trigonometry:

→ θ = atan(My / Mx)

This angle is the orientation angle input for moment capacity functions that are explained in this page.

| **εcu : ‘Number’**                                  | **εtl : ‘Number’**                                                     | **εcl : ‘Number’**                                                         |
| --------------------------------------------------- | ---------------------------------------------------------------------- | -------------------------------------------------------------------------- |
| failure strain of concrete in compression (in./in.) | tension-controlled strain limit in the extreme tension steel (in./in.) | compression-controlled strain limit in the extreme tension steel (in./in.) |

**refinement** **: 'Number'** The section is defined by smaller segments based on the number entered for this parameter. This implies that the accuracy of the results pertaining to the section will get closer to correctness as the number of segments defining it increases. No matter the refinement value input, a segment is consistently formed at designated reinforcement and tendon locations, enhancing analysis result accuracy. ![](https://openbrim.atlassian.net/wiki/download/attachments/2254832345/image-20230831-131925.png?api=v2)

![](https://openbrim.atlassian.net/wiki/download/attachments/2254832345/image-20230818-092136.png?api=v2) ![](https://openbrim.atlassian.net/wiki/download/attachments/2254832345/image-20230831-132106.png?api=v2) ![](https://openbrim.atlassian.net/wiki/download/attachments/2254832345/image-20230818-092229.png?api=v2) As illustrated in above images, the size of the segments are changing based on refinement value.

**useTendonInitStrain** : **'Boolean'** — accepted and ignored (it has been since December 2023): a tendon's initial strain is always used. A tendon layout's force over the tendon's area, divided by its modulus, is the tendon's initial strain; a bonded tendon is read at its total strain — that initial strain plus the strain the section's strain plane gives its fibre — through the material's stress-strain curve, as the figure shows. If the section has no tendon, nothing changes.

![](https://openbrim.atlassian.net/wiki/download/attachments/2254832345/image-20230828-193804.png?api=v2) To see this section on the app, click <https://openbrim.org/platform/?application=app&prj=objidn2nkqiu8ojl7895qkak74i&active=GraphicsView>

Go to sections on **DATA**

Right click on the *Rectange* section. Select *Section Editor.*

Click 3 dots on the left top corner. Select *Flexural Strength.*

***

## DocSectionAnalysis Object

With this object, section analysis and calculations, such as rebar stress, flexural capacity, and interaction diagrams, can be displayed in the document. The values that affect the results can be overridden in the document, and changes in the results along the section can be reviewed instantaneously.

This core object is a very useful tool for displaying the results of the functions described above and for observing the effect on the outcome by altering the inputs in real-time.

The following parameters need to be set properly to display desired results correctly.

**AnalysisType =** This parameter changes the report type to be displayed.

→ To display “Flexural Capacity”, set AnalysisType as 0.

→ To display “Moment Curvature”, set AnalysisType as 1.

→ To display “Interaction Diagram”, set AnalysisType as 2.

→ To display “Rebar Stress”, set AnalysisType as 3. `<O T="DocSectionAnalysis" AnalysisType="0" />`

`<O T="DocSectionAnalysis" AnalysisType="1" />`

`<O T="DocSectionAnalysis" AnalysisType="2" />`

`<O T="DocSectionAnalysis" AnalysisType="3" />` ![](https://openbrim.atlassian.net/wiki/download/attachments/2254832345/image-20230818-073640.png?api=v2)

![](https://openbrim.atlassian.net/wiki/download/attachments/2254832345/image-20230815-135303.png?api=v2) ![](https://openbrim.atlassian.net/wiki/download/attachments/2254832345/image-20230815-135343.png?api=v2) ![](https://openbrim.atlassian.net/wiki/download/attachments/2254832345/image-20230815-135405.png?api=v2)

**Section =** This parameter collects the section definition for analysis. `<O T="DocSectionAnalysis" Section=" " />`

**Width/Height =** These parameters define the size of the report to be displayed. `<O T="DocSectionAnalysis" Width=" " Height =" "/>` ![](https://openbrim.atlassian.net/wiki/download/attachments/2254832345/image-20230815-145205.png?api=v2)

![](https://openbrim.atlassian.net/wiki/download/attachments/2254832345/image-20230815-145304.png?api=v2)

**AxialForce =** This parameter collects the axial force that is applied to the section. This parameter does not apply to interaction diagram analysis(AnalysisType=”2”).

To view the document that has been overridden on the user interface, simply modify the parameters in the input boxes and then click the refresh button

![](https://openbrim.atlassian.net/wiki/download/attachments/2254832345/image-20230815-145707.png?api=v2)

next to report title. `<O T="DocSectionAnalysis" AxialForce=" " />` ![](https://openbrim.atlassian.net/wiki/download/attachments/2254832345/image-20230815-145448.png?api=v2)

![](https://openbrim.atlassian.net/wiki/download/attachments/2254832345/image-20230815-145524.png?api=v2)

**Moment =** This parameter collects the bending moment that is applied to the section. This parameter is only valid when AnalysisType=”3” (Rebar Stress).

To view the document that has been overridden on the user interface, simply modify the parameters in the input boxes and then click the refresh button

![](https://openbrim.atlassian.net/wiki/download/attachments/2254832345/image-20230815-145707.png?api=v2)

next to report title. `<O T="DocSectionAnalysis" Moment=" " />` ![](https://openbrim.atlassian.net/wiki/download/attachments/2254832345/image-20230815-151044.png?api=v2)

![](https://openbrim.atlassian.net/wiki/download/attachments/2254832345/image-20230815-151443.png?api=v2)

**Orientation =** This parameter collects the angular position of the section in radians. To view the document that has been overridden on the user interface, simply modify the parameters in the input boxes and then click the refresh button. `<O T="DocSectionAnalysis" Orientation="pi/2" />` ![](https://openbrim.atlassian.net/wiki/download/attachments/2254832345/image-20230815-152253.png?api=v2)

![](https://openbrim.atlassian.net/wiki/download/attachments/2254832345/image-20230815-152317.png?api=v2)

**PhiComp =** This parameter collects the resistance factor for compression based on AASHTO.

**PhiTens =** This parameter collects the resistance factor for tension based on AASHTO. `<O T="DocSectionAnalysis" PhiComp=" " PhiTens=" " />` ![](https://openbrim.atlassian.net/wiki/download/attachments/2254832345/image-20230815-152923.png?api=v2) **Ecu =** Failure strain of concrete in compression (in./in.)

**Ecl =** Compression-controlled strain limit in the extreme tension steel (in./in.)

**Etl =** Tension-controlled strain limit in the extreme tension steel (in./in.) `<O T="DocSectionAnalysis" Ecu="0.003" Ecl="0.002" Etl="0.005"/>` ![](https://openbrim.atlassian.net/wiki/download/attachments/2254832345/image-20230815-153401.png?api=v2) **Refinement =** This parameter changes the precision of the diagrams. To override this parameter, simply change the value in degree on **Refinement** box then click refresh button

![](https://openbrim.atlassian.net/wiki/download/attachments/2254832345/image-20230815-145707.png?api=v2)

next to report title. `<O T="DocSectionAnalysis" Refinement ="1000" />` ![](https://openbrim.atlassian.net/wiki/download/attachments/2254832345/image-20230815-153546.png?api=v2)

![](https://openbrim.atlassian.net/wiki/download/attachments/2254832345/image-20230815-153628.png?api=v2)

***

**Example:**

```xml
<O N="MomentCapacityFunctionsObject1" T="Project" Category="Functions" TransAlignRule="1">
 <!-- created by ParamML Examples on 8/11/2023 -->
 <O N="Materials" T="Group">
 <O N="Fc_7ksi" T="Material">
 <P N="E" V="4795.121365" UT="Stress" UC="Property" />
 <P N="G" V="1997.96723559994" UT="Stress" UC="Property" />
 <P N="d" V="0.00008391" UT="Density" UC="Property" />
 <P N="a" V="0.000006" D="Alpha: The coefficient of thermal expansion property of the material." />
 <P N="Type" V="Concrete" T="Text" D="Type: The material type [Steel=steel/Concrete=concrete/Reinforcement Bar=rebar/Prestressing Tendon=prestress]." />
 <P N="Fc28" V="7" UT="Stress" UC="Property" />
 <P N="f_cm" V="8.16" UT="Stress" UC="Property" />
 </O>
 <O N="A416_270low_relaxation" T="Material">
 <P N="E" V="28500" UT="Stress" UC="Property" />
 <P N="Nu" V="0.3" D="Poisson Ratio: The poisson ratio property of the material." />
 <P N="d" V="0.000284" UT="Density" UC="Property" />
 <P N="a" V="0.0000065" D="Alpha: The coefficient of thermal expansion property of the material." />
 <P N="Fy" V="243" UT="Stress" UC="Property" />
 <P N="Fu" V="270" UT="Stress" UC="Property" />
 <P N="Type" V="prestress" T="Text" D="Type: The material type [Steel=steel/Concrete=concrete/Reinforcement Bar=rebar/Prestressing Tendon=prestress]." />
 </O>
 <O N="A615_60" T="Material" G="11153.8462">
 <P N="E" V="29000" UT="Stress" UC="Property" />
 <P N="Nu" V="0.3" D="Poisson Ratio: The poisson ratio property of the material." />
 <P N="d" V="0.000284" UT="Density" UC="Property" />
 <P N="a" V="0.0000065" D="Alpha: The coefficient of thermal expansion property of the material." />
 <P N="Fy" V="60" UT="Stress" UC="Property" />
 <P N="Fu" V="90" UT="Stress" UC="Property" />
 <P N="Type" V="rebar" T="Text" D="Type: The material type [Steel=steel/Concrete=concrete/Reinforcement Bar=rebar/Prestressing Tendon=prestress]." />
 <O N="Bilinear Steel" T="StressStrainModel" D="0" DisplayStrainMax="esu">
 <P N="esu" V="0.03" D="ultimate steel strain" />
 <P N="H" V="0.001" D="material hardening strain" />
 <P N="ey" V="Fy/E" />
 <O N="Elastic" T="Equation" Eqn="x*E" Guard="abs(x).LT.ey" />
 <O N="Plastic" T="Equation" Eqn="Fy + H * E * (abs(x) - ey)" Guard="abs(x).GE.ey .AND. abs(x).LT.esu" />
 <O N="Failure" T="Equation" Eqn="Fy+ H * E * (abs(esu) - ey)" Guard="abs(x).GE.esu" />
 </O>
 </O>
 </O>
 <O N="Rebars" T="Group">
 <O N="ASTMA615No11" T="Rebar">
 <P N="D" V="1.41" D="Diameter: The diameter of the reinforcement bar." UT="Length" UC="Property" />
 <P N="A" V="1.56" D="Area: The area of the reinforcement bar." UT="Area" UC="Property" />
 <P N="W" V="0.00044275" D="Weight: The weight of the reinforcement bar." UT="ForcePerLength" UC="Property" />
 <P N="ASTMtype" V="0" D="[HIDE]" />
 </O>
 </O>
 <O N="Strands" T="Group">
 <O N="Grade250_3_5_No15" T="Strand">
 <P N="Label" V="Grade250 3/5 inch No:15" T="Text" D="[HIDE]" />
 <P N="D" V="0.600" />
 <P N="A" V="0.216" />
 <P N="W" V="0.00006141666666666666" />
 </O>
 </O>
 <O N="Sections" T="Group">
 <O N="Section1" T="Section" d="45" tfw="48" tft="3.5" d1="1.5" w1="17" d2="3.5" w2="3.5" w3="15.5" Rad="15" d5="7.5" bft="7" cd="0.75" Iy="241429.1150600715" Iz="82751.02592741857" Cz="-25.426800347230166" Perimeter="224.52392107324548" SCy="0.0004" SCz="-21.3113" Cw="21769661.4320" MinY="-24" MaxY="24" MinZ="-45" MaxZ="0" Izy="732.3641950217177" Ay="915.911790507292" Az="915.911790507292" Material="@Fc_7ksi\|Material" Cy="-0.026713692400045126" Ax="915.911790507292">
 <P N="bfw" V="38" D="Bot. Flange Width" UT="Length" UC="Property" />
 <P N="Per" V="206.57" D="Perimeter" UT="Length" UC="Property" />
 <P N="w_w" V="7" D="Web Width " UT="Length" UC="Property" />
 <O T="Shape" Inherited="1">
 <O T="Point" X="-tfw/2" Y="0" />
 <O T="Point" X="tfw/2" Y="0" />
 <O T="Point" X="tfw/2" Y="-tft" />
 <O T="Point" X="tfw/2-w1" Y="-(tft+d1)" />
 <O T="Point" X="tfw/2-w1-w2" Y="-(tft+d1+d2)" />
 <O T="Point" R="Rad" X="tfw/2-w1-w2" Y="-(d-(d5+bft))" />
 <O T="Point" X="tfw/2-w1-w2+w3" Y="-(d-bft)" />
 <O T="Point" X="tfw/2-w1-w2+w3" Y="-(d-cd)" />
 <O T="Point" X="tfw/2-w1-w2+w3-cd" Y="-d" />
 <O T="Point" X="-(tfw/2-w1-w2+w3-cd)" Y="-d" />
 <O T="Point" X="-(tfw/2-w1-w2+w3)" Y="-(d-cd)" />
 <O T="Point" X="-(tfw/2-w1-w2+w3)" Y="-(d-bft)" />
 <O T="Point" R="Rad" X="-(tfw/2-w1-w2)" Y="-(d-(d5+bft))" />
 <O T="Point" X="-(tfw/2-w1-w2)" Y="-(tft+d1+d2)" />
 <O T="Point" X="-(tfw/2-w1-w2)" Y="-(tft+d1+d2)" />
 <O T="Point" X="-(tfw/2-w1)" Y="-(tft+d1)" />
 <O T="Point" X="-(tfw/2)" Y="-tft" />
 <O T="Point" X="-tfw/2" Y="0" />
 <P N="Material" V="Fc_7ksi" T="Material" />
 </O>
 <O T="TendonLayout" StrandCount="1" X="-0" Y="+22">
 <P N="DistanceToEdge" V="2" />
 <P N="TendonSpacing" V="3" />
 <P N="Material" V="A416_270low_relaxation" T="Material" />
 <P N="StrandProfile" V="Grade250_3_5_No15" T="Strand" />
 <P N="NumberOfTendons" V="5" />
 <P N="UseReferenceEdge" V="1" />
 <P N="Force" V="0" />
 <P N="DebondingLength" V="0" />
 <P N="ReferenceEdge" V="0" />
 <O T="Point" X="(-(NumberOfTendons-1)*TendonSpacing/2)+0" Y="(sectionDepth(FIB45)/2-(DistanceToEdge+0.26221162334209897))+-22.5" />
 <O T="Point" X="((NumberOfTendons-1)*TendonSpacing/2)+0" Y="(sectionDepth(FIB45)/2-(DistanceToEdge+0.26221162334209897))+-22.5" />
 </O>
 <O T="RebarLineLayout" X="-0" Y="-18">
 <P N="UseReferenceEdge" V="0" />
 <P N="Material" V="A615_60" T="Material" />
 <P N="RebarProfile" V="ASTMA615No11" T="Rebar" />
 <P N="BarDiameter" V="1.41" />
 <P N="NumberOfRebars" V="5" />
 <P N="RowSpacing" V="0" />
 <P N="NumberOfRows" V="1" />
 <P N="ReferenceEdge" V="0" />
 <P N="DistanceToEdge" V="0" />
 <P N="RebarSpacing" V="4" />
 <O T="Point" X="(-(NumberOfRebars-1)*RebarSpacing/2)+0" Y="(sectionDepth(FIB45)/2-(DistanceToEdge+RebarProfile.D/2+((NumberOfRows-1)*RowSpacing)/2))+-22.5" />
 <O T="Point" X="((NumberOfRebars-1)*RebarSpacing/2)+0" Y="(sectionDepth(FIB45)/2-(DistanceToEdge+RebarProfile.D/2+((NumberOfRows-1)*RowSpacing)/2))+-22.5" />
 </O>
 </O>
 </O>
 <P N="Orientation1" V="0" />
 <P N="E_cu1" V="0.003" />
 <P N="E_cl1" V="0.002" />
 <P N="E_tu1" V="0.005" />
 <P N="phi_Compression1" V="0.65" />
 <P N="phi_Tension1" V="0.9" />
 <P N="AxialForce1" V="100" />
 <P N="MLambda1" V="1000" />
 <P N="Refinement1" V="1000" />
 <P N="FlexuralCapacity" V="momentCapacity(Section1,Orientation1,E_cu1,AxialForce1,E_tu1,phi_Compression1,phi_Tension1,Refinement1)" />
 <P N="NALoc" V="momentCapacityNA(Section1,Orientation1,E_cu1,AxialForce1,E_tu1,phi_Compression1,phi_Tension1,Refinement1)" />
 <P N="Tension" V="momentCapacityTension(Section1,Orientation1,E_cu1,AxialForce1,E_tu1,phi_Compression1,phi_Tension1,Refinement1)" />
 <P N="TensionLocation" V="momentCapacityTensionLoc(Section1,Orientation1,E_cu1,AxialForce1,E_tu1,phi_Compression1,phi_Tension1,Refinement1)" />
 <P N="Compression" V="momentCapacityCompression(Section1,Orientation1,E_cu1,AxialForce1,E_tu1,phi_Compression1,phi_Tension1,Refinement1)" />
 <P N="CompressionLocation" V="momentCapacityCompressionLoc(Section1,Orientation1,E_cu1,AxialForce1,E_tu1,phi_Compression1,phi_Tension1,Refinement1)" />
 <P N="Curvature" V="momentCapacityCurvature(Section1,Orientation1,E_cu1,AxialForce1,E_tu1,phi_Compression1,phi_Tension1,Refinement1)" />
 <P N="ResistanceFactor_Strain_Condition" V="momentCapacityStrainAndCondition(Section1,Orientation1,E_cu1,AxialForce1,E_tu1,phi_Compression1,phi_Tension1,Refinement1)" />
 <O T="Document" Title="Moment Capacity Functions">
 <O T="DocText">
 <![CDATA[
 --md
 \| Parameter Name \| Function Name \| Result \|
 \|: ------------- \|:-------------:\| -----:\|
 \| 'FlexuralCapacity' \| momentCapacity \| \|FlexuralCapacity\| \|
 \| 'NALoc' \| momentCapacityNA \| \|NALoc\| \|
 \| 'Tension' \| momentCapacityTension \| \|Tension\| \|
 \| 'TensionLocation' \| momentCapacityTensionLoc \| \|TensionLocation\| \|
 \| 'Compression' \| momentCapacityCompression \| \|Compression\| \|
 \| 'CompressionLocation' \| momentCapacityCompressionLoc \| \|CompressionLocation\| \|
 \| 'Curvature' \| momentCapacityCurvature \| \|Curvature\| \|
 \| 'ResistanceFactor_Strain_Condition' \| momentCapacityStraingAndCondition \| \|ResistanceFactor_Strain_Condition\| \|

 ]]>
 </O>
 <O N="MomentCurvature" T="DocSectionAnalysis" AnalysisType="1" Section="Section1" Width="800" Height="700" AxialForce="AxialForce1" Moment="MLambda1" Orientation="Orientation1" PhiComp="phi_Compression1" PhiTens="phi_Tension1" Ecu="E_cu1" Ecl="E_cl1" Etu="E_tu1" Refinement="Refinement1" />
 <O N="InteractionDiagram" T="DocSectionAnalysis" AnalysisType="2" Section="Section1" Width="800" Height="700" AxialForce="AxialForce1" Moment="MLambda1" Orientation="Orientation1" PhiComp="phi_Compression1" PhiTens="phi_Tension1" Ecu="E_cu1" Ecl="E_cl1" Etu="E_tu1" Refinement="Refinement1" />
 <O N="RebarStress" T="DocSectionAnalysis" AnalysisType="3" Section="Section1" Width="800" Height="700" AxialForce="AxialForce1" Moment="MLambda1" Orientation="Orientation1" PhiComp="phi_Compression1" PhiTens="phi_Tension1" Ecu="E_cu1" Ecl="E_cl1" Etu="E_tu1" Refinement="Refinement1" />
 </O>
</O>
```

![](https://openbrim.atlassian.net/wiki/download/attachments/2254832345/image-20230815-153742.png?api=v2) The provided ParamML code includes pre-defined materials, an I-shaped section with tendons and reinforcement, and other necessary input parameters. It illustrates the utilization of the listed moment capacity functions and summarizes the results in a table. For further information about pre-defined objects in the code see [Section Object](https://docs.openbrim.org/developers/paramml-developer-guide/core-objects/finite-elements-objects/section-object.md) [Material Object](https://docs.openbrim.org/developers/paramml-developer-guide/core-objects/finite-elements-objects/material-object.md)[Document Objects](https://docs.openbrim.org/developers/paramml-developer-guide/core-objects/document-objects.md) To view this example in the library, see (<https://openbrim.org/app/?incubator=1&author=ParamML_Examples_OpenBrIM+Platform&obj=objid10a0m4welkyvov6m2zcxd> )


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.openbrim.org/developers/paramml-developer-guide/functions/custom-function/section-analysis-functionsmoment-capacity-moment-curvature-interaction-diagram-max-rebar-stress.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
