Quick Start

This guide will help you get started with Blueprints quickly by walking through common use cases.

Before You Begin

Make sure you have Blueprints installed. If not, see the Installation Guide.

Your First Calculation

Let's start with a simple concrete material calculation:

from blueprints.materials.concrete import ConcreteMaterial, ConcreteStrengthClass

# Create a C30/37 concrete material
concrete = ConcreteMaterial(concrete_class=ConcreteStrengthClass.C30_37)

# Access material properties
print(f"Concrete: {concrete.name}")
print(f"Characteristic strength (fck): {concrete.f_ck} MPa")
print(f"Design strength (fcd): {concrete.f_cd} MPa")
print(f"Mean tensile strength (fctm): {concrete.f_ctm:.2f} MPa")

Concrete: C30/37
Characteristic strength (fck): 30 MPa
Design strength (fcd): 20.0 MPa
Mean tensile strength (fctm): 2.90 MPa

That's it! You've just calculated key concrete properties according to Eurocode standards.

Working with Reinforcement Steel

Now let's add reinforcement steel to the mix:

from blueprints.materials.reinforcement_steel import ReinforcementSteelMaterial, ReinforcementSteelQuality

# Create B500B reinforcement steel
rebar = ReinforcementSteelMaterial(steel_quality=ReinforcementSteelQuality.B500B)

print(f"Steel quality: {rebar.name}")
print(f"Characteristic yield strength (fyk): {rebar.f_yk} MPa")
print(f"Design yield strength (fyd): {rebar.f_yd:.2f} MPa")
print(f"Modulus of elasticity (Es): {rebar.e_s} MPa")

Steel quality: B500B
Characteristic yield strength (fyk): 500.0 MPa
Design yield strength (fyd): 434.78 MPa
Modulus of elasticity (Es): 200000.0 MPa

Working with Formulas

Blueprints organizes formulas by engineering standard. Here's how to use them:

# Create a Formula instance using Eurocode formula 4.1: c_nom = c_min + Δc_dev
from blueprints.codes.eurocode.nen_en_1992_1_1_a1_2020.chapter_4_durability_and_cover.formula_4_1 import Form4Dot1NominalConcreteCover

c_min = 25.0  # mm
delta_c_dev = 10.0  # mm
concrete_cover = Form4Dot1NominalConcreteCover(c_min=c_min, delta_c_dev=delta_c_dev)

print(f"Formula result: {concrete_cover} mm")
print(f"Formula label: {concrete_cover.label}")
print(f"Source document: {concrete_cover.source_document}")
print(f"Stored parameters: c_min={concrete_cover.c_min}, delta_c_dev={concrete_cover.delta_c_dev}")

Formula result: 35.0 mm
Formula label: 4.1
Source document: NEN-EN 1992-1-1:2005+A1:2015+NB:2016+A1:2020
Stored parameters: c_min=25.0, delta_c_dev=10.0

Combining all elements in a Rectangular Reinforced cross section

from blueprints.structural_sections.concrete.covers import CoversRectangular
from blueprints.structural_sections.concrete.reinforced_concrete_sections.rectangular import RectangularReinforcedCrossSection

applied_cover = 5 + concrete_cover

# Define a rectangular reinforced cross-section
cs = RectangularReinforcedCrossSection(
    width=1000,
    height=800,
    covers=CoversRectangular(upper=applied_cover, right=applied_cover, lower=applied_cover, left=applied_cover),
    concrete_material=concrete,
)

# Add reinforcement to the upper edge
cs.add_longitudinal_reinforcement_by_quantity(
    n=10,
    diameter=16,
    edge="lower",
    material=rebar,
)

# Plot the cross-section
fig = cs.plot(show=False) #change show to True in your local example to show the plot directly

Next Steps

Now that you've seen the basics, you can:

• Explore the API Reference - Detailed documentation of all available functionality
• Check out Examples - More complex, real-world scenarios
• Read about Library Organization - Understand why Blueprints is structured the way it is
• Join the Discord community - Ask questions and connect with other engineers

Happy engineering! 🚀