omni_seismic_base_shear_asce7
Calculates ASCE 7/IBC seismic base shear and response coefficient from building weight, spectral acceleration, R, and importance factor for code-compliant design checks.
Instructions
Seismic Equivalent Lateral Force Base Shear Calculator (ASCE 7 / IBC). Calculate total seismic design base shear (V = Cs · W) and seismic response coefficient (Cs) compliant with ASCE 7-16 and International Building Code. Discipline: ENGINEERING. Governing mathematical model / formula: Base Shear V = Cs · W | Seismic Coefficient Cs = S_DS / (R / I_e).
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of total_seismic_base_shear_kips (Total Seismic Design Base Shear (V)), seismic_response_coeff_cs (Seismic Coefficient (Cs)), base_shear_weight_pct (Lateral Force as % of Building Weight), seismic_design_category (Seismic Design Category (SDC)) using effective_seismic_weight_kips (Total Effective Building Weight (W in Kips) in kips), spectral_acceleration_sds (Design Spectral Acceleration (S_DS) in g (gravity)), response_modification_r (Response Modification Factor (R)), importance_factor_ie (Seismic Importance Factor (I_e)). Guarantees exact machine floating-point precision, eliminating LLM arithmetic mistakes and formula hallucinations.
WHEN NOT TO USE: Do not use for qualitative evaluations or unquantified reasoning. All input parameters must be valid numerical values.
DISAMBIGUATION & BOUNDARIES:
Use this dedicated specialist tool for 'Seismic Equivalent Lateral Force Base Shear Calculator (ASCE 7 / IBC)' rather than generic dispatchers like omni_universal_query.
For multi-calculation chained jobs, use 'omni_batch_calculate'.
To inspect schema fields, see 'omni_describe_solver'.
BEHAVIOR & SAFETY:
Pure deterministic computation with machine floating-point precision.
Read-only, idempotent, and stateless. Zero side effects or persistent state mutations.
Input validation: All arguments are validated against physical and domain bounds. Out-of-bounds inputs return a safe diagnostic error status without throwing runtime exceptions.
RETURNS:
Structured JSON object containing:
status (string): "success" on valid execution or "error" if validation fails
calculator (string): "seismic-base-shear-asce7"
category (string): "engineering"
name (string): "Seismic Equivalent Lateral Force Base Shear Calculator (ASCE 7 / IBC)"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.total_seismic_base_shear_kips (Total Seismic Design Base Shear (V)): Formatted display string (e.g. '735.6 Kips')
metrics.seismic_response_coeff_cs (Seismic Coefficient (Cs)): Formatted display string (e.g. '0.1635 g')
metrics.base_shear_weight_pct (Lateral Force as % of Building Weight): Formatted display string (e.g. '16.4% of Total Weight')
metrics.seismic_design_category (Seismic Design Category (SDC)): Formatted display string (e.g. 'Category D (High Seismic Risk)')
execution_time_ms (number): Latency in milliseconds.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "omni_seismic_base_shear_asce7"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| importance_factor_ie | No | Seismic Importance Factor (I_e). Standard = 1.0; Schools/Assembly = 1.25; Hospitals/Emergency = 1.5. Default: 1.25. Min: 1. Max: 1.5. | |
| response_modification_r | No | Response Modification Factor (R). Ductile moment frame = 8.0; Braced frame = 6.0; Concrete shear wall = 5.0. Default: 6.5. Min: 1.5. Max: 8. | |
| spectral_acceleration_sds | No | Design Spectral Acceleration (S_DS) (g (gravity)). Short-period design acceleration from USGS seismic maps. Default: 0.85. Min: 0.1. Max: 2.5. | |
| effective_seismic_weight_kips | No | Total Effective Building Weight (W in Kips) (kips). Total building dead load plus permanent partitions and 25% snow. Default: 4500. Min: 100. Max: 100000. |