Technical Documentation & Engine Protocols

Reference manual for civil and structural engineers. Mathematical derivations, codified limit states, and REST/WASM integration schemas.

Protocol ID: getting-started

Platform Architecture & Core Principles

Local-First, Zero-DB Computational Architecture

SASA Engineers operates on a client-side execution paradigm. Finite element stiffness calculations, shear-moment integrations, and limit-state safety checks run directly in local browser memory without storing sensitive engineering CAD geometries on remote databases.

Codified Standards & Formulation

Client-Side Computing: Zero latency, offline resiliency, 100% data confidentiality

Codified Calibration: Strict adherence to Bureau of Indian Standards (BIS) clauses

Dual Limit States: Serviceability Limit State (SLS) & Ultimate Limit State (ULS)

Implementation Blueprint

// SASA Core Solver Initialization
import { SasaEngine } from '@sasa/engine';

const engine = new SasaEngine({
  standard: 'IS_456_2000',
  mode: 'ULTIMATE_LIMIT_STATE',
  safetyFactors: { concrete: 1.5, steel: 1.15 }
});

const result = await engine.solveEquilibrium(elementMesh);
console.log(`Max Factored Moment: ${result.maxMu} kNm`);

Protocol ID: load-calculator

Elemental Load & Stress Solver

IS 456:2000 Slabs, Beams, Columns & Footings

The Load Symmetry workspace provides parametric analysis of RC structural elements with automated tributary load dispersion, 45-degree yield-line envelopes, and span-to-depth deflection verification.

Codified Standards & Formulation

Beam Flexure (IS 456 Cl 38.1): Mu = 0.138 * fck * b * d² for Fe415 / 0.133 for Fe500

Deflection Control (IS 456 Cl 23.2): Basic L/d ratios (7 cantilever, 20 simply supported, 26 continuous)

Column Buckling (Euler Critical Load): Pcr = (π² * E * I) / Leff²

Implementation Blueprint

POST /api/calculate
Content-Type: application/json

{
  "elementType": "BEAM_SIMPLY_SUPPORTED",
  "parameters": {
    "spanLength": 6.0,
    "udlLoad": 18.0,
    "concreteGrade": "M25",
    "steelGrade": "Fe500",
    "section": { "width": 300, "depth": 500 }
  }
}

Protocol ID: force-calculator

Force Command & Matrix Mechanics

18 Codified Limit State Combinations (IS 875 & IS 1893)

Direct stiffness matrix discretization [K]{u} = {F} evaluating dead, live, wind, and seismic force interactions under 18 limit state combinations with P-Delta second-order moment amplification.

Codified Standards & Formulation

Gravity Limit States: 1.5 DL + 1.5 LL

Seismic & Wind Combos: 1.2 DL + 1.2 LL ± 1.2 EQ/WL

Stability & Overturning: 0.9 DL ± 1.5 EQ/WL

Implementation Blueprint

// 18 Limit State Matrix Evaluation
const matrix = new ForceMatrix({
  deadLoad: 120, // kN
  liveLoad: 60,  // kN
  seismicLoad: 45 // kN
});

const criticalEnvelope = matrix.evaluate18LimitStates();
// Output: Critical governing state: 1.2 DL + 1.2 LL + 1.2 EQ = 270 kN

Protocol ID: seismic-resilience

Seismic Dynamics & Base Shear

IS 1893:2016 Part 1 Zone Factor & Response Spectrum

Calculates horizontal seismic acceleration coefficients (Ah) and total design seismic base shear (Vb = Ah * W) across Seismic Zones II, III, IV, and V with soil-structure interaction factors.

Codified Standards & Formulation

Design Base Shear: Vb = Ah * W where Ah = (Z / (2 * R)) * (I * (Sa / g))

Zone Factors: Zone II (0.10), Zone III (0.16), Zone IV (0.24), Zone V (0.36)

Ductility Detailing: IS 13920:2016 special confining reinforcement intervals

Implementation Blueprint

// Seismic Base Shear Computation (IS 1893)
const seismic = new SeismicSolver({
  zone: 'ZONE_IV',        // Z = 0.24
  importanceFactor: 1.5,  // Important building (Hospital/School)
  responseReduction: 5.0, // SMRF frame
  soilType: 'MEDIUM_SOIL',
  fundamentalPeriod: 0.65 // seconds
});

const { Ah, baseShearRatio } = seismic.computeCoefficients();

Protocol ID: api-reference

REST API & WebAssembly Integration

Direct Microservice & Embedded WASM Solvers

Integrate SASA calculation capabilities into your existing BIM pipelines, Revit/AutoCAD plugins, or internal structural audit dashboards via our high-speed JSON endpoints.

Codified Standards & Formulation

HTTPS Endpoints: /api/calculate, /api/sasa-design-lab, /api/dream-forge

Payload Validation: Strict TypeScript schemas with error bounds

Response Time: < 50ms average latency worldwide

Implementation Blueprint

// Example cURL execution
curl -X POST https://sasa.engineer/api/calculate \
  -H "Content-Type: application/json" \
  -d '{
    "loadType": "beam_flexure",
    "span": 6.0,
    "load": 22.5,
    "concrete": "M30"
  }'