structural-lib-is456

IS 456 RC Beam Design Library (Python package).

Version: 0.23.0 (Alpha development preview) Status:

⚠️ Development Preview: APIs may change until v1.0. For reproducible results, pin to a release tag.

Supported-case boundary: this package implements selected IS 456 workflows, not the whole standard. Every output requires independent verification and qualified structural-engineering review. Use official standards as the authoritative source.

New in v0.23.0

• Security hardening: 14 cross-field plausibility validators, error sanitization
• Code quality: check_code() and show_versions() diagnostics
• Column API: Full column design pipeline (axial, uniaxial, biaxial, slender, detailing)
• OpenAPI freeze: Baseline drift detection in CI

Install

pip install structural-lib-is456           # from PyPI
pip install "structural-lib-is456[dxf]"    # with DXF export support
pip install structural-lib-is456==0.23.0   # pin this release exactly

Requires Python 3.11+. On Python 3.9–3.10, pip installs the older v0.16.x (beam-only, no column/footing).

If You Want To…

Design a Beam (IS 456 flexure + shear)

from structural_lib import design_beam_is456

result = design_beam_is456(
    units="IS456", b_mm=300, D_mm=500, d_mm=450,
    fck_nmm2=25, fy_nmm2=500,
    mu_knm=150, vu_kn=100,
)
print(f"Ast = {result.flexure.Ast_required:.0f} mm²")
print(f"Safe? {result.flexure.is_safe}")

Get Detailing (bar sizes, stirrups, cut lengths)

from structural_lib import build_detailing_input, compute_detailing

detailing_input = build_detailing_input(
    result, beam_id="B1", b_mm=300, D_mm=500, d_mm=450,
    span_mm=6000, cover_mm=30, fck_nmm2=25, fy_nmm2=500,
)
detailed = compute_detailing(detailing_input)

for beam in detailed:
    print(f"{beam.beam_id}: {len(beam.top_bars)} top, {len(beam.bottom_bars)} bottom zones")

Generate a Bar Bending Schedule (BBS)

from structural_lib import compute_bbs

bbs = compute_bbs(detailed, project_name="My Project")
print(f"Total weight: {bbs.summary.total_weight_kg:.1f} kg")
for item in bbs.items:
    print(f"  {item.bar_mark}: ø{item.diameter_mm:.0f} × {item.no_of_bars} nos")

Export DXF Drawings

from structural_lib import compute_dxf

output_path = compute_dxf(detailed, "beam.dxf")  # returns Path
print(f"DXF saved to {output_path}")

Requires the dxf extra: pip install "structural-lib-is456[dxf]"

Generate an HTML Report

from structural_lib import compute_report

html = compute_report(detailing_input, format="html")
with open("report.html", "w") as f:
    f.write(html)

Batch Design from CSV

from structural_lib.services.adapters import GenericCSVAdapter
from structural_lib import design_beam_is456

adapter = GenericCSVAdapter()
geometry_list, forces_list = adapter.load_combined("beams.csv")
# Pair geometry with forces and design each beam
for geom, forces in zip(geometry_list, forces_list):
    result = design_beam_is456(
        units="IS456", b_mm=geom.b_mm, D_mm=geom.D_mm, d_mm=geom.d_mm,
        fck_nmm2=geom.fck_nmm2, fy_nmm2=geom.fy_nmm2,
        mu_knm=forces.mu_knm, vu_kn=forces.vu_kn,
    )
    print(f"Ast = {result.flexure.Ast_required:.0f} mm²")

Run the Full Pipeline (design → detail → BBS → report)

See examples/end_to_end_workflow.py for a complete working script (available in the source repository).

Cost-Optimize a Beam

from structural_lib import optimize_beam_cost

optimized = optimize_beam_cost(
    units="IS456", span_mm=6000, mu_knm=150, vu_kn=100,
)
print(f"Optimal: {optimized.optimal_design.b_mm}×{optimized.optimal_design.D_mm} mm")

Check Multi-Case Compliance

from structural_lib import check_beam_is456

report = check_beam_is456(
    units="IS456", b_mm=230, D_mm=500, d_mm=450,
    fck_nmm2=25, fy_nmm2=500,
    cases=[{"case_id": "ULS-1", "mu_knm": 100, "vu_kn": 80}],
)
print(f"Governing case: {report.governing_case_id}")

CLI Usage

python -m structural_lib design input.csv -o results.json        # Beam design
python -m structural_lib bbs results.json -o bbs.csv             # Bar bending schedule
python -m structural_lib dxf results.json -o drawings.dxf        # DXF drawings
python -m structural_lib report results.json --format=html -o report.html  # HTML report
python -m structural_lib job job.json -o output/                 # Full job from spec
python -m structural_lib --help                                  # All options

What's Available

Beam Design & Detailing

The primary combined beam route covers flexure and shear. Torsion is available only through the separate explicit torsion workflow.

Column Design (IS 456 Cl 25, 39.3–39.7)

Footing Design (IS 456 Cl 34)

Combined, strap, raft and pile-cap foundations, settlement, geotechnical design, and lateral stability are outside these footing workflows.

Solid Slab Design (Supported Cases)

Two-way coefficients are not built in or verified by the library. The two-way route requires explicit source approval and a qualified acceptance reference. Flat/drop/ribbed slabs, openings, irregular panels and FEM are excluded.

IS 13920 Ductile Detailing

Export, Import & Visualization

Full API reference: see docs/reference/api.md

License

MIT — see LICENSE.

Engineering-use conditions and professional responsibilities are described in the repository's LICENSE_ENGINEERING.md. The software is a design aid, not a substitute for official code publications, independent calculation, or professional approval.