Use for CS 455 (UK assessment) ULS of RC beam, column, pier or pile sections. For EN 1992 use ec2_section_check; for slabs and plates use slab_assess; for stresses use stress_profile or sls_stress_check. CS 455 ULS assessment of reinforced concrete beam sections with the plugin's own engine: reads the concurrent force rows (BEAMFORCE / BEAMFORCEVBM for envelopes and moving loads, kN·m; a moving-load case from a model analysed without 'Normal + Concurrent Force' is refused as NOT CONCURRENT) at the chosen element ends for the chosen combinations, and runs every row — N–M flexure by strain-compatibility equilibrium, shear (additive approach, links optional), torsion (cl 5.17–5.27) — or, with member set to a column, pier or pile, the CS 455 Section 7 checks (N_uz, slenderness and additional moments, biaxial bending Eq 7.7.2a, bar restraint 7.6, shear 7.10.1 / Eq 7.11) — with status per row (PASS / FAIL / BLOCKED / OUTSIDE RANGE OF VALIDITY) and the utilisation of each check. Read-only. Takes a while for many rows (a job on the website).
View input schema
{
"type": "object",
"properties": {
"sectionId": {
"type": [
"integer",
"string"
],
"description": "The CIVIL NX section id (a beam section)."
},
"rebar": {
"type": "object",
"description": "The bar schedule, as the plugin's Reinforcement tab: cover (mm to the bar face, default 50), gap (mm between layers, default max(25, Ø)), rows [{face: bottom|top|side|depth, layer (any whole number, 1 = outermost), count ('8' bars or '@150' spacing), dia (mm, or '1.128in', or '#9'), depth (mm below top, face 'depth' only), span ('±430:900' width limits), from/to/which (side bars)}], coords {datum: bc|bl|tc, text: 'y z dia' per line, mm}.",
"properties": {
"cover": {
"type": "number"
},
"gap": {
"type": [
"number",
"string"
]
},
"rows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"face": {
"enum": [
"bottom",
"top",
"side",
"depth"
]
},
"layer": {
"type": "integer"
},
"count": {
"type": [
"string",
"integer"
],
"description": "8 (bars) or '@150' (spacing, mm)"
},
"dia": {
"type": [
"number",
"string"
],
"description": "Bar diameter: mm (32, 28.6), inches ('1.128in', '1 1/8\"') or a US bar number ('#9')."
},
"depth": {
"type": [
"number",
"string"
]
},
"span": {
"type": "string"
},
"from": {
"type": [
"number",
"string"
]
},
"to": {
"type": [
"number",
"string"
]
},
"which": {
"enum": [
"both",
"left",
"right"
]
}
},
"required": [
"face",
"count",
"dia"
],
"additionalProperties": false
}
},
"coords": {
"type": "object",
"properties": {
"datum": {
"enum": [
"bc",
"bl",
"tc"
]
},
"text": {
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"restrained": {
"type": "boolean",
"description": "Compression bars are restrained by links (cl 5.3.1). Default false: compression bars get no compressive strength (cl 5.3.2(1)), conservative."
},
"confirmDimensions": {
"type": "boolean",
"description": "Only after the user has compared the drawn section with the drawing: needed when CIVIL NX published no properties to check the outline against."
},
"concreteParts": {
"type": "object",
"description": "Composite sections: { part id: f_cu } where a part's grade differs (describe lists the parts)."
},
"image": {
"type": "boolean",
"description": "cs455_describe_section only: return the drawing of the section with its bars (default true)."
},
"stations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"element": {
"type": "integer"
},
"end": {
"enum": [
"I",
"J",
"IJ"
]
},
"location": {
"enum": [
"support",
"midspan",
"quarter",
"other"
]
}
},
"required": [
"element"
],
"additionalProperties": false
},
"description": "Element ends to assess (default: the section's first element, both ends, midspan). Location 'support' removes the shear enhancement near supports."
},
"cases": {
"type": "array",
"items": {
"type": "string"
},
"description": "Load cases / combinations by name (default: every load combination the model has)."
},
"fcu": {
"type": "number",
"description": "Concrete cube strength, MPa (default: from the model's EN grade C../.. — its cube value)."
},
"fy": {
"type": "number",
"description": "Reinforcement yield strength, MPa (default 500)."
},
"concreteModel": {
"enum": [
"parabolic",
"rectangular"
],
"description": "Figure 3.4.1 curve (default) or the constant 0.6 fcu/γmc block of cl 5.1(3)."
},
"shear": {
"type": "boolean",
"description": "Run the shear check (default true)."
},
"links": {
"type": "object",
"properties": {
"dia": {
"type": [
"number",
"string"
],
"description": "mm, or inches '0.5in', or US '#4' (default 12)"
},
"legs": {
"type": "integer"
},
"spacing": {
"type": "number",
"description": "mm along the member"
},
"fyv": {
"type": "number"
}
},
"required": [
"spacing"
],
"additionalProperties": false,
"description": "Links (omit for concrete-only shear, cl 5.6). Used by shear and by torsion."
},
"torsion": {
"type": "boolean",
"description": "Torsion check, CS 455 cl 5.17–5.27, on rows that carry a torque (default true, as in the plugin)."
},
"tensionOrigin": {
"enum": [
"externally applied axial tension",
"restraint-induced tension"
]
},
"secondaryActions": {
"enum": [
"report",
"block"
],
"description": "Vy / T / Mz: assess N–My–Vz and list them (default), or refuse rows where they are non-zero."
},
"axialSign": {
"enum": [
-1,
1
],
"description": "Positive MIDAS axial is tension (-1, default) or compression (1)."
},
"momentSign": {
"enum": [
1,
-1
],
"description": "Positive MIDAS My is sagging (1, default) or hogging (-1)."
},
"drawingReference": {
"type": "string"
},
"classification": {
"enum": [
"RC"
],
"description": "RC only in these tools."
},
"maxRows": {
"type": "integer",
"description": "Stop above this many force rows (default 1000)."
},
"member": {
"type": "object",
"description": "Assess as a column, pier or pile to CS 455 Section 7 instead of a beam (the plugin's Sections tab > Member). The effective height about each axis is a Table 7.2 case (1: both ends held in position and rotation 0.7; 2: top in position only, bottom fixed 0.85; 3: both ends in position only 1.0; 4: bottom fixed, top unrestrained, racked rollers 1.3; 5: bottom fixed, top unrestrained 1.4; 6: bottom fixed, top restrained in rotation only 1.5; 7: cantilever, top free 2.3) or your own factor k (l_e = k l_o). Give links: their diameter and spacing decide whether the compression bars count (7.6). A pile is assessed as a column with no soil restraint: give k for its depth to fixity. Omit for a beam.",
"properties": {
"type": {
"enum": [
"beam",
"column",
"pier",
"pile"
]
},
"length": {
"type": "number",
"description": "Length between restraints l_o, metres."
},
"caseY": {
"type": "integer",
"enum": [
0,
1,
2,
3,
4,
5,
6,
7
],
"description": "Table 7.2 case about the y axis (bending My); 0 = use kY. Default 3."
},
"caseZ": {
"type": "integer",
"enum": [
0,
1,
2,
3,
4,
5,
6,
7
],
"description": "Table 7.2 case about the z axis (bending Mz); 0 = use kZ. Default 3."
},
"kY": {
"type": "number",
"description": "Effective height factor about y (used when caseY is 0 or omitted with kY given)."
},
"kZ": {
"type": "number",
"description": "Effective height factor about z."
}
},
"required": [
"type"
],
"additionalProperties": false
},
"maxResults": {
"type": "integer",
"description": "How many rows to list, worst first (default 40)."
},
"includeJobs": {
"type": "boolean",
"description": "Also return the exact engine job of each listed row (for audit or re-running in the plugin)."
}
},
"required": [
"sectionId",
"rebar"
],
"additionalProperties": false
}