Beachball-3D — 3D Focal Mechanism & Seismotectonic Stereonet Workbench

Created: August 2026
Live Production App: beachball-3d.yufajjiru.work
GitHub Repository: github.com/luthfiyufajjiru/beachball-3d-stereonet
Powered by: Terraversi

An interactive 3D focal mechanism simulator, stereographic projection tool, and seismotectonic workbench built for structural geologists, seismologists, and earth science researchers.


Key Capabilities

  • Real-Time 3D Focal Sphere Shaders: Custom WebGL/Three.js GLSL shaders evaluating orthogonal nodal planes and compressional/dilatational quadrants analytically on the unit sphere.
  • Geophysical Standards: Strict implementation of Aki & Richards (1980) coordinate conventions (NED frame), analytical auxiliary conjugate plane (NP2\text{NP}_2) derivation, and Frohlich (1992) ternary slip classification (T,N,SST, N, SS).
  • Live National & Global Earthquake Feeds: Concurrent telemetry ingestion from BMKG TEWS (Indonesia) and USGS ComCat (Global) moment tensor catalogs.
  • Automated Seismotectonic Inference: Hypocenter depth and regional fault database matching against active Indonesian tectonic structures (Sunda Megathrust, Flores Back-Arc Thrust, Palu-Koro Fault, Semangko Fault, and Wadati-Benioff slabs).
  • Spatial Area Stress Inversion: Interactive map bounding box selection with Kostrov (1974) moment-tensor summation and Jacobi eigenvalue rotation.
  • Publication-Ready Deliverables: Direct export to Generic Mapping Tools (GMT psmeca), vector SVG stereonets, high-resolution PNG snapshots, and reproducible JSON archives.

Technical Stack & Architecture

LayerTechnology
Frontend FrameworkReact 19, TypeScript, Tailwind CSS
3D Graphics & ShadersThree.js, Custom GLSL Shaders
Mapping & GeospatialLeaflet, OpenStreetMap / CartoDB
Math & Inversion EngineAnalytical Jacobi Eigenvalue Solver, Kostrov (1974) Moment Summation
Data IngestionBMKG TEWS API, USGS ComCat FDSN GeoJSON
Hosting & DeploymentFirebase Hosting / Cloudflare Static Architecture