feat: Energy-based Torino Scale + comprehensive documentation (v2.0.1)

- Torino Scale: Kinetic energy (Joules  Megatons TNT) classification
- Energy thresholds: harmless/local/regional/national/global/extinction
- Probability  Energy matrix for threat levels
- NEW: wiki/Torino-Scale.md - Complete methodology
- Updated: README.md, ROADMAP.md, DISCLAIMER.md, wiki files

Author: SpaceEngineerSS

CHANGELOG.md

@@ -5,7 +5,7 @@ All notable changes to CosmoRisk will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [2.0.0] - 18.12.2025
+## [2.0.1] - 18.12.2025
 
 ### Added - Branding & Polish
 - CosmoRisk branding throughout application
@@ -25,7 +25,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Collision warning banner with pulse animation
 
 ### Added - Analysis Tools
-- Torino Scale (0-10) impact hazard assessment
+- Torino Scale (0-10) impact hazard assessment with energy-based classification:
+  - Kinetic energy conversion: Joules → Megatons TNT
+  - Energy thresholds: harmless (<1 kt), local (1 kt-1 MT), regional (1-100 MT), national (100-1000 MT), global (1-100 GT), extinction (>100 GT)
+  - Probability × Energy matrix for accurate threat levels
+  - NASA CNEOS reference integration
+  - Display shows asteroid diameter and energy in MT/GT format
 - MOID Calculator with real distance-based calculations
 - Spectral type analysis (C/S/M/X/V)
 - Side-by-side asteroid comparison table modal

DISCLAIMER.md

@@ -26,7 +26,12 @@ based on simplified physical models and may not accurately represent real-world
 
 3. **MOID Calculation**: Uses 72×72 point orbital sampling for accuracy, but is not JPL-grade precision.
 
-4. **Impact Predictions**: All "hazard" or "impact" assessments are **NOT** official NASA/ESA 
+4. **Torino Scale**: Our energy-based Torino classification is a simplified model that:
+   - Converts kinetic energy to Megatons TNT
+   - Uses probability × energy thresholds
+   - Does NOT replace official NASA Sentry or ESA NEOCC assessments
+
+5. **Impact Predictions**: All "hazard" or "impact" assessments are **NOT** official NASA/ESA 
    determinations. For official assessments, consult:
    - [NASA Center for Near Earth Object Studies (CNEOS)](https://cneos.jpl.nasa.gov/)
    - [ESA NEO Coordination Centre (NEOCC)](https://neo.ssa.esa.int/)

README.md

@@ -35,7 +35,7 @@
 - **Post-Processing** - Unreal Bloom, SSAO, FXAA for cinematic quality
 
 ### Analysis Tools
-- **Torino Scale** - 0-10 impact hazard classification
+- **Torino Scale** - 0-10 impact hazard classification based on kinetic energy (Joules → Megatons TNT) and probability
 - **MOID Calculator** - Proper orbital intersection distance using 72×72 point sampling
 - **3D Orbit Visualization** - Accurate Keplerian orbits with inclination, RAAN, and argument of perihelion
 - **Spectral Type Analysis** - C/S/M/X/V composition types
@@ -90,6 +90,23 @@ R_Earth   = 6.378137×10⁶ m                Earth equatorial radius
 P_SRP     = 4.56×10⁻⁶ N/m²                Solar radiation pressure (1 AU)
 ```
 
+### Torino Scale Methodology
+
+Kinetic energy is converted to Megatons TNT for threat classification:
+
+$$E_{MT} = \frac{E_{Joules}}{4.184 \times 10^{15}}$$
+
+| Energy Range | Classification | Example |
+|--------------|----------------|---------|
+| < 1 kiloton | Harmless | Burns up |
+| 1 kt - 1 MT | Local | Chelyabinsk (~500 kt) |
+| 1 - 100 MT | Regional | Tunguska (~15 MT) |
+| 100 MT - 1 GT | National | Large city destruction |
+| 1 - 100 GT | Global | Nuclear winter |
+| > 100 GT | Extinction | Chicxulub |
+
+Reference: [NASA CNEOS Torino Scale](https://cneos.jpl.nasa.gov/sentry/torino_scale.html)
+
 ---
 
 ## 🛠️ Installation

ROADMAP.md

@@ -80,7 +80,11 @@ J2_EARTH = 1.08263e-3 // Earth oblateness coefficient
 
 ### Sağ Panel - Bilgi & Analiz
 - **Selected Object**: Seçili cismin pozisyon, hız, yarıçap bilgileri
-- **Torino Scale**: 0-10 tehlike seviyesi görselleştirmesi
+- **Torino Scale**: 0-10 tehlike seviyesi (enerji tabanlı: Joules → Megaton TNT)
+  - < 1 kt: Zararsız (atmosferde yanar)
+  - 1 kt - 1 MT: Yerel hasar
+  - 1 - 100 MT: Bölgesel
+  - > 100 MT: Ulusal/Küresel
 - **MOID Calculator**: Orbital kesişim mesafesi (72×72 nokta örnekleme)
 - **Asteroid Info**: Spektral tip, kütle, yoğunluk
 - **Deflection Control**: 

src/main.ts

@@ -1775,58 +1775,100 @@ class OrbitalSentinelApp {
 
   private updateTorinoScale(
     probability: number,
-    energy: number,
+    energyJoules: number,
     distanceAU: number,
-    radiusKm: number
+    radiusMeters: number
   ): void {
-    // Enhanced Torino scale calculation
-    // Based on impact probability, kinetic energy, proximity, and size
+    // Scientifically accurate Torino Scale calculation
+    // Based on: https://cneos.jpl.nasa.gov/sentry/torino_scale.html
+
+    // Convert kinetic energy from Joules to Megatons TNT
+    // 1 Megaton = 4.184e15 Joules
+    const energyMT = energyJoules / 4.184e15;
+
+    // Energy-based threat thresholds (in Megatons TNT)
+    const isHarmless = energyMT < 0.001;        // < 1 kiloton - burns up
+    const isLocal = energyMT >= 0.001 && energyMT < 1;    // 1kt-1MT - local damage
+    const isRegional = energyMT >= 1 && energyMT < 100;   // 1-100 MT - regional
+    const isNational = energyMT >= 100 && energyMT < 1000; // 100-1000 MT - national
+    const isGlobal = energyMT >= 1000 && energyMT < 100000; // 1-100 Gigatons
+    const isExtinction = energyMT >= 100000;              // > 100 Gigatons
+
+    // MOID-based hazard assessment
+    const isPHA = distanceAU < 0.05; // Potentially Hazardous Asteroid threshold
+
     let level = 0;
 
-    // Distance-based assessment (closer = higher level)
-    const isClose = distanceAU < 0.05; // < 0.05 AU is concerning
-    const isVeryClose = distanceAU < 0.01; // < 0.01 AU is very concerning
-
-    // Size-based assessment
-    const isLarge = radiusKm > 0.05; // > 50m can cause local damage
-    const isVeryLarge = radiusKm > 0.5; // > 500m can cause regional damage
-    const isMassive = radiusKm > 1.0; // > 1km can cause global effects
-
-    // Base level from probability
-    if (probability < 1e-6 && !isVeryClose) {
-      level = 0; // No hazard
-    } else if (probability < 1e-4 && !isClose) {
-      level = 1; // Normal
-    } else if (isVeryClose && isMassive) {
-      // Very close + massive = high threat
-      level = Math.min(10, 7 + Math.floor(probability * 6));
-    } else if (isVeryClose && isVeryLarge) {
-      level = Math.min(8, 5 + Math.floor(probability * 6));
-    } else if (isClose && isLarge) {
-      level = Math.min(6, 3 + Math.floor(Math.log10(energy + 1) / 4));
+    // Torino Scale Logic (simplified from official scale)
+    // Level 0: No hazard - collision extremely unlikely
+    // Level 1: Normal - routine discovery, very unlikely collision
+    // Levels 2-4: Meriting attention by astronomers
+    // Levels 5-7: Threatening - governmental attention warranted
+    // Levels 8-10: Certain/near-certain collision
+
+    if (probability < 1e-7 || isHarmless) {
+      // No real hazard - energy too low or probability negligible
+      level = 0;
+    } else if (probability < 1e-6) {
+      // Very low probability
+      level = isPHA ? 1 : 0;
+    } else if (probability < 1e-4) {
+      // Low probability, merit attention
+      if (isExtinction) level = 4;
+      else if (isGlobal) level = 3;
+      else if (isNational) level = 2;
+      else level = 1;
     } else if (probability < 1e-2) {
-      level = Math.min(4, Math.floor(2 + Math.log10(energy + 1) / 5));
+      // Moderate probability
+      if (isExtinction) level = 6;
+      else if (isGlobal) level = 5;
+      else if (isNational) level = 4;
+      else if (isRegional) level = 3;
+      else level = 2;
     } else if (probability < 0.5) {
-      level = Math.min(7, Math.floor(4 + Math.log10(energy + 1) / 5));
+      // Significant probability
+      if (isExtinction) level = 8;
+      else if (isGlobal) level = 7;
+      else if (isNational) level = 6;
+      else if (isRegional) level = 5;
+      else level = 4;
+    } else if (probability < 0.99) {
+      // High probability
+      if (isExtinction) level = 9;
+      else if (isGlobal) level = 8;
+      else if (isNational) level = 7;
+      else if (isRegional) level = 6;
+      else level = 5;
     } else {
-      level = Math.min(10, Math.floor(7 + probability * 6));
+      // Certain collision (>99%)
+      if (isExtinction) level = 10;
+      else if (isGlobal) level = 10;
+      else if (isNational) level = 9;
+      else if (isRegional) level = 8;
+      else if (isLocal) level = 8;
+      else level = 0; // Too small to matter even with certain collision
     }
 
-    // Ensure level is valid
+    // Ensure level is valid 0-10
     level = Math.max(0, Math.min(10, Math.floor(level)));
 
+    // Format energy and size for display
+    const energyStr = energyMT >= 1000 ? `${(energyMT / 1000).toFixed(0)} GT` : `${energyMT.toFixed(2)} MT`;
+    const diameterM = radiusMeters * 2;
+    const sizeStr = diameterM >= 1000 ? `${(diameterM / 1000).toFixed(1)} km` : `${diameterM.toFixed(0)} m`;
+
     const torinoDescriptions: Record<number, string> = {
-      0: 'No hazard - Likelihood of collision is zero',
-      1: 'Normal - A routine discovery with no unusual concern',
-      2: 'Meriting attention - A somewhat close but not unusual encounter',
-      3: 'Meriting attention - Close encounter deserving attention',
-      4: 'Meriting attention - Close encounter with 1%+ chance of collision',
-      5: 'Threatening - Close encounter posing a serious threat',
-      6: 'Threatening - Close encounter with large object, significant threat',
-      7: 'Threatening - Extremely close encounter with large object',
-      8: 'Certain collision - Localized destruction expected',
-      9: 'Certain collision - Regional devastation expected',
-      10: 'Certain collision - Global climatic catastrophe'
+      0: `No hazard - ${isHarmless ? 'Energy too low (<1 kt)' : 'Collision impossible'}`,
+      1: `Normal - ${sizeStr} object (${energyStr})`,
+      2: `Meriting attention - ${sizeStr} close pass (${energyStr})`,
+      3: `Meriting attention - ${sizeStr} regional threat (${energyStr})`,
+      4: `Meriting attention - ${sizeStr} 1%+ collision (${energyStr})`,
+      5: `Threatening - ${sizeStr} regional destruction (${energyStr})`,
+      6: `Threatening - ${sizeStr} national threat (${energyStr})`,
+      7: `Threatening - ${sizeStr} global effects (${energyStr})`,
+      8: `Certain impact - ${sizeStr} local destruction (${energyStr})`,
+      9: `Certain impact - ${sizeStr} continental (${energyStr})`,
+      10: `Certain impact - ${sizeStr} global catastrophe (${energyStr})`
     };
 
     const torinoDisplay = document.getElementById('torino-display');
@@ -1838,7 +1880,7 @@ class OrbitalSentinelApp {
       torinoValue.textContent = String(level);
       torinoDescription.textContent = torinoDescriptions[level] || 'Unknown';
 
-      // Highlight active segment
+      // Highlight active segment based on Torino color coding
       document.querySelectorAll('.torino-segment').forEach(seg => seg.classList.remove('active'));
       if (level === 0) {
         document.querySelector('.torino-segment.white')?.classList.add('active');

wiki/FAQ.md

@@ -64,12 +64,23 @@ sudo apt-get install libwebkit2gtk-4.1-dev libappindicator3-dev librsvg2-dev pat
 ## Scientific
 
 ### What is the Torino Scale?
-A 0-10 scale for categorizing asteroid impact threat:
-- 0: No hazard
-- 1: Normal discovery, low threat
-- 2-4: Meriting concern
-- 5-7: Threatening
-- 8-10: Certain collision
+A 0-10 scale for categorizing asteroid impact threat based on **probability** and **kinetic energy**:
+
+| Level | Color | Category |
+|-------|-------|----------|
+| 0 | ⬜ White | No hazard - too small or impossible collision |
+| 1 | 🟩 Green | Normal - routine discovery, very low threat |
+| 2-4 | 🟨 Yellow | Meriting attention - deserves monitoring |
+| 5-7 | 🟧 Orange | Threatening - contingency planning needed |
+| 8-10 | 🟥 Red | Certain collision - impact will occur |
+
+**Energy Thresholds:**
+- **< 1 kiloton**: Burns up in atmosphere
+- **1 kt - 1 MT**: Local damage (e.g., Chelyabinsk)
+- **1 - 100 MT**: Regional devastation (e.g., Tunguska)
+- **> 100 MT**: National/global effects
+
+📖 See [Torino Scale wiki page](https://github.com/SpaceEngineerSS/CosmoRisk/wiki/Torino-Scale) for full methodology.
 
 ### What deflection method is most realistic?
 Currently, the **Kinetic Impactor** (proven by NASA's DART mission in 2022) is the most technologically ready.

wiki/Home.md

@@ -10,6 +10,7 @@ Welcome to the **CosmoRisk** documentation! This wiki provides comprehensive gui
 | [Getting Started](Getting-Started) | First steps and basic usage |
 | [Keyboard Shortcuts](Keyboard-Shortcuts) | All hotkeys and controls |
 | [Physics Engine](Physics-Engine) | Scientific methodology explained |
+| [Torino Scale](Torino-Scale) | Impact hazard classification (0-10) |
 | [Deflection Methods](Deflection-Methods) | Kinetic Impactor, Ion Beam, Gravity Tractor |
 | [NASA API](NASA-API) | NeoWs API integration guide |
 | [FAQ](FAQ) | Frequently asked questions |

wiki/Physics-Engine.md

@@ -83,13 +83,35 @@ E - e·sin(E) = M
 
 Solved using Newton-Raphson iteration.
 
+## Torino Scale
+
+CosmoRisk implements energy-based Torino Scale assessment:
+
+| Level | Color | Meaning |
+|-------|-------|---------|
+| 0 | White | No hazard |
+| 1 | Green | Normal discovery |
+| 2-4 | Yellow | Meriting attention |
+| 5-7 | Orange | Threatening |
+| 8-10 | Red | Certain collision |
+
+Energy thresholds (Megatons TNT):
+- **< 1 kt**: Burns up (Level 0)
+- **1 kt - 1 MT**: Local damage
+- **1 - 100 MT**: Regional damage
+- **100 - 1000 MT**: National scale
+- **> 1000 MT**: Global effects
+
+📖 See [Torino Scale](Torino-Scale) for complete methodology.
+
 ## References
 
 1. NASA JPL Solar System Dynamics
 2. Velocity Verlet: Swope et al. (1982)
 3. Orbital Mechanics: Vallado (2007)
 4. Asteroid Densities: Carry (2012)
+5. Torino Scale: Morrison et al. (2004)
 
 ---
 
-[← Keyboard Shortcuts](Keyboard-Shortcuts) | [Next: Deflection Methods →](Deflection-Methods)
+[← Keyboard Shortcuts](Keyboard-Shortcuts) | [Next: Torino Scale →](Torino-Scale)