structural-lib-is456 0.21.3

IS 456 RC Design Library — beams, columns & footings (flexure, shear, axial, ductile detailing, DXF export)

structural-lib-is456

IS 456 RC Beam Design Library (Python package).

Version: 0.21.3 (development preview) Status:

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

Install

pip install structural-lib-is456           # from PyPI
pip install "structural-lib-is456[dxf]"    # with DXF export support

# Or pin to a release tag
pip install "structural-lib-is456 @ git+https://github.com/Pravin-surawase/structural_engineering_lib.git@v0.21.3#subdirectory=Python"

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

dxf_bytes = compute_dxf(detailed)  # returns bytes — write to file
with open("beam.dxf", "wb") as f:
    f.write(dxf_bytes)

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()
beams = adapter.parse_file("beams.csv")
results = [design_beam_is456(**beam) for beam in beams]

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

See examples/end_to_end_workflow.py for a complete working script.

Cost-Optimize a Beam

from structural_lib import optimize_beam_cost

optimized = optimize_beam_cost(
    b_mm=300, D_mm=500, d_mm=450,
    mu_knm=150, vu_kn=100, fck_nmm2=25, fy_nmm2=500,
)

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

Category	Functions	Description
Beam Design	design_beam_is456, design_and_detail_beam_is456, design_from_input	IS 456 flexure + shear
Detailing	build_detailing_input, compute_detailing, detail_beam_is456	Bar sizes, stirrups, cut lengths
BBS / Export	compute_bbs, export_bbs, compute_dxf, compute_report	BBS, DXF, HTML reports
Column Design	design_column_axial_is456, design_short_column_uniaxial_is456, classify_column_is456	Axial, uniaxial, biaxial
Optimization	optimize_beam_cost, smart_analyze_design, suggest_beam_design_improvements	Cost optimization, smart analysis
Compliance	check_beam_is456, check_compliance_report, check_beam_slenderness	Multi-case IS 456 checks
Torsion	design_torsion, calculate_equivalent_shear, calculate_torsion_shear_stress	IS 456 torsion design
Serviceability	check_deflection_span_depth, check_crack_width	Deflection + crack width
CSV Import	GenericCSVAdapter (via structural_lib.services.adapters)	40+ column mappings
ETABS Integration	load_etabs_csv, create_job_from_etabs, validate_etabs_csv	ETABS CSV import
3D Geometry	beam_to_3d_geometry, compute_rebar_positions, compute_stirrup_positions	3D rebar visualization
Validation	validate_job_spec, validate_design_results, verify_calculation	Input/output validation

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

License

MIT — see LICENSE.