Calcs.com API

Schemas

TimberBeamAttributes

L_Xnumber
Beam span length in feet
typestring · enum
Member selection type. 'Database' uses standard lumber from NDS tables, 'Custom' allows custom dimensions
Enum values:
Database
Custom
Default: Database
memberstring
Lumber designation when type='Database' (e.g., '2x10 DF-L No.2', '4x12 DF-L No.1')
supportsarray[] · minItems: 2
Support definitions. Each support is [type, position_ft, bearing_width_in]. Minimum 2 supports required.
loadsDistarray[]
Distributed loads array. Format: [label, start, end, width1, width2, {load_cases}]. For joist presets use: [label, 0, 'L', 'spacing', 'TW_s', {load_cases}]
loadsConcarray[]
Concentrated/point loads. Format: [label, position_ft, {load_cases}] where load_cases contains {D: [force, moment], L: [force, moment]}
spacingnumber
Joist spacing in inches (for joist presets). floorJoist, ceilingJoist, deckJoist default to 16.
n_comnumber
Number of plies for multi-ply beams. Defaults: floorGirder/roofGirder/floorHeader/deckBeam=3, ceilingJoist/hipValley/roofHeader/comboBeam=2, others=1.
Default: 1
flitchstring · enum
Enable flitch plates (steel reinforcement). Defaults to 'Yes' for genericFlitchBeam preset.
Enum values:
Yes
No
Default: No
n_flitchnumber
Number of steel flitch plates. Defaults to 2 for genericFlitchBeam preset.
t_flitchnumber
Thickness of flitch plates in inches. Defaults to 0.375 for genericFlitchBeam preset.
d_flitchnumber
Depth of flitch plates in inches. If omitted, auto-calculated based on wood member depth.
F_ynumber
Yield strength of flitch plate steel in psi. Defaults to 36000 (36 ksi).
Default: 36000
wetstring · enum
Service moisture condition. Defaults: deckJoist/deckBeam='Wet' (outdoor exposure), all others='Dry'.
Enum values:
Dry
Wet
Default: Dry
Tstring · enum
Temperature range for adjustment factors
Enum values:
T ≤ 100°F
100°F < T ≤ 125°F
125°F < T ≤ 150°F
Default: T ≤ 100°F
incSWstring · enum
Include self-weight in analysis
Enum values:
Yes
No
Default: Yes
LLTstring · enum
Live load type for load combinations. ceilingJoist defaults to 'Storage'. Most presets default to 'Occupancy'.
Enum values:
Occupancy
Storage
Roofs (Lr or S)
Default: Occupancy
Delta_hardnumber
Absolute deflection limit in inches
Default: 2
Delta_Span_STnumber
Short-term deflection limit as L/xxx (e.g., 360 means L/360)
Default: 360
Delta_Span_LTnumber
Long-term deflection limit as L/xxx
Default: 240
flag_SDstring · enum
Consider simplified DL+LL deflection check. Defaults to 'Yes' for genericFlitchBeam, floorGirder, ceilingJoist, rafter, hipValley, roofGirder, roofHeader, floorHeader, deckJoist, deckBeam, and comboBeam presets.
Enum values:
Yes
No
Default: No
Delta_Span_DL+LLnumber
Simplified DL+(LL or SL) deflection limit as L/xxx. Preset defaults: floorJoist/floorGirder/ceilingJoist/roofHeader/floorHeader/deckJoist/deckBeam/comboBeam=180, rafter/hipValley/roofGirder=100, genericFlitchBeam=240.
Default: 240
repeatstring · enum
Member repetition for load sharing. Presets floorJoist, floorGirder, ceilingJoist, rafter, roofGirder, floorHeader, deckJoist, deckBeam default to 'Repeating'. Most others default to 'Non-Repeating'.
Enum values:
Non-Repeating
Repeating
Default: Non-Repeating
LTB_bracingstring · enum
Lateral torsional buckling bracing condition. Defaults: floorJoist/deckJoist/deckBeam='Top Braced', ceilingJoist='Bottom Braced', floorGirder/roofGirder/headers='None'.
Enum values:
None
Top Braced
Bottom Braced
Fully Braced
Default: None
doubleCantileverDeflectionstring · enum
Double L/ deflection limits for cantilevers. Defaults to 'Yes' for rafter, hipValley, roofGirder, roofHeader, floorHeader, deckJoist, deckBeam, and comboBeam presets.
Enum values:
Yes
No
Default: No

TimberBeamResults

passedboolean
Whether the beam passes all design checks
utilizationRationumber
Overall utilization ratio (demand/capacity)
summaryCheckobject

TimberBeamPreset

string · enum

Enum values:

genericBeam

genericFlitchBeam

floorJoist

floorGirder

ceilingJoist

hipValley

rafter

roofGirder

Beam configuration preset. Each preset provides sensible defaults: floorJoist/ceilingJoist/deckJoist use spacing format with repeat='Repeating'; floorGirder uses n_com=3 with TW format loads; comboBeam uses n_com=2 with TW format for combined floor+roof loading; genericFlitchBeam enables flitch plates; deckJoist/deckBeam default to wet='Wet' for outdoor exposure. See documentation for full preset defaults.