==================
Consequence Models
==================

Introduction
------------

Consequence models translate structural damage states into economic losses and other impact 
metrics. These models are essential for converting fragility analysis results into actionable 
risk metrics for decision-making.


Damage-to-Loss Ratios
---------------------

Damage-to-loss ratios map each damage state to an expected loss expressed as a fraction of a 
building's replacement cost. The ratios used in this model are:

.. list-table:: Structural Damage-to-Loss Ratios
   :header-rows: 1
   :widths: 25 25 50

   * - Damage State
     - Mean Ratio
     - Description
   * - DS1 (Slight)
     - 0.05
     - Minor cosmetic repairs
   * - DS2 (Moderate)
     - 0.15
     - Moderate structural repairs
   * - DS3 (Extensive)
     - 0.60
     - Major structural repairs
   * - DS4 (Complete)
     - 1.00
     - Full replacement


Sources and Derivation
~~~~~~~~~~~~~~~~~~~~~~

The damage-to-loss ratios are derived from:

**Empirical Data**
   Post-earthquake damage and repair cost surveys (Di Pasquale et al. 2005; Bal et al. 2008)

**Analytical Procedures**
   Component-based loss estimation methodologies (Martins et al. 2016; Aljawhari et al. 2023)


Loss Categories
---------------

Structural Losses
~~~~~~~~~~~~~~~~~

Losses associated with damage to the building's lateral load-resisting system and gravity 
load-carrying elements.


Non-Structural Loss Functions (SLFs)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Storey Loss Functions (SLFs) relate engineering demand parameters (EDPs) directly to loss ratios 
for non-structural components. Two types of SLFs are provided:

* **Drift-sensitive SLFs**: For components sensitive to interstorey drift (partitions, facades, stairs)
* **Acceleration-sensitive SLFs**: For components sensitive to floor acceleration (ceilings, MEP systems)

The SLFs are available for different regions, building materials, component categories, and occupancy types.

**Interactive SLF Viewer**

.. raw:: html

   <div class="viewer-container" id="slf-viewer">
       <div class="viewer-controls">
           <div class="control-row">
               <div class="control-group">
                   <label for="slf-region-select">Region:</label>
                   <select id="slf-region-select" class="viewer-select">
                       <option value="">-- Select Region --</option>
                       <option value="Europe">Europe</option>
                       <option value="North_America">North America</option>
                       <option value="Caribbean_Central_America">Caribbean & Central America</option>
                       <option value="South_America">South America</option>
                       <option value="North_Asia">North Asia</option>
                       <option value="Central_Asia">Central Asia</option>
                       <option value="East_Asia">East Asia</option>
                       <option value="Southeast_Asia">Southeast Asia</option>
                       <option value="South_Asia">South Asia</option>
                       <option value="Oceania">Oceania</option>
                       <option value="Africa">Africa</option>
                       <option value="Middle_East">Middle East</option>
                   </select>
               </div>
               <div class="control-group">
                   <label for="slf-material-select">Material:</label>
                   <select id="slf-material-select" class="viewer-select">
                       <option value="">-- Select Material --</option>
                       <option value="CR">Reinforced Concrete (CR)</option>
                       <option value="CR/LFINF">RC with Infill (CR/LFINF)</option>
                       <option value="MUR">Unreinforced Masonry (MUR)</option>
                       <option value="MCF">Confined Masonry (MCF)</option>
                       <option value="W">Timber (W)</option>
                       <option value="S">Steel (S)</option>
                       <option value="S/LFINF">Steel with Infill (S/LFINF)</option>
                       <option value="ADO">Adobe (ADO)</option>
                   </select>
               </div>
           </div>
           <div class="control-row">
               <div class="control-group">
                   <label for="slf-component-select">Component:</label>
                   <select id="slf-component-select" class="viewer-select">
                       <option value="">-- Select Component --</option>
                       <option value="NSCUA">Unanchored (NSCUA)</option>
                       <option value="NSCA">Anchored (NSCA)</option>
                   </select>
               </div>
               <div class="control-group">
                   <label for="slf-occupancy-select">Occupancy:</label>
                   <select id="slf-occupancy-select" class="viewer-select">
                       <option value="">-- Select Occupancy --</option>
                       <option value="RES">Residential (RES)</option>
                       <option value="COM">Commercial (COM)</option>
                       <option value="IND">Industrial (IND)</option>
                   </select>
               </div>
               <div class="control-group">
                   <label for="slf-edp-select">EDP Type:</label>
                   <select id="slf-edp-select" class="viewer-select">
                       <option value="">-- Select EDP --</option>
                       <option value="drift">Drift-Sensitive</option>
                       <option value="acceleration">Acceleration-Sensitive</option>
                   </select>
               </div>
           </div>
           <div class="control-group">
               <button id="slf-load-btn" class="viewer-btn btn-primary">Load SLF</button>
           </div>
       </div>
       <div class="viewer-plot" id="slf-plot" style="height: 450px;"></div>
   </div>

   <script>
       document.addEventListener('DOMContentLoaded', function() {
           const loadBtn = document.getElementById('slf-load-btn');
           
           loadBtn.addEventListener('click', async function() {
               const region = document.getElementById('slf-region-select').value;
               const material = document.getElementById('slf-material-select').value;
               const component = document.getElementById('slf-component-select').value;
               const occupancy = document.getElementById('slf-occupancy-select').value;
               const edpType = document.getElementById('slf-edp-select').value;
               
               if (!region || !material || !component || !occupancy || !edpType) {
                   alert('Please select all parameters');
                   return;
               }
               
               document.getElementById('slf-plot').innerHTML = '<div style="padding: 40px; text-align: center;">Loading SLF data...</div>';
               
               try {
                   const response = await fetch('_static/data/in/consequences/nonstructural_slfs_all_regions.json');
                   if (!response.ok) {
                       document.getElementById('slf-plot').innerHTML = '<div style="padding: 40px; text-align: center; color: #666;">SLF data not available. Re-run ppGlobal_GenerateDocs.py to export.</div>';
                       return;
                   }
                   
                   const slfs = await response.json();
                   
                   if (!slfs[region] || !slfs[region][material] || !slfs[region][material][component] ||
                       !slfs[region][material][component][occupancy] || !slfs[region][material][component][occupancy][edpType]) {
                       document.getElementById('slf-plot').innerHTML = '<div style="padding: 40px; text-align: center; color: #666;">No SLF data for selected combination.</div>';
                       return;
                   }
                   
                   const data = slfs[region][material][component][occupancy][edpType];
                   const edp = data.EDP || [];
                   const loss = data.Loss || [];
                   const cov = data.COV || [];

                   const xLabel = edpType === 'drift' ? 'Peak Storey Drift Ratio' : 'Peak Floor Acceleration [g]';

                   const slfTraces = [];

                   // Shaded ±1σ uncertainty band from COV
                   if (cov.length === loss.length && cov.some(v => v > 0)) {
                       const upper = loss.map((l, i) => Math.min(1.0, l * (1 + cov[i])));
                       const lower = loss.map((l, i) => Math.max(0.0, l * (1 - cov[i])));
                       slfTraces.push({
                           x: [...edp, ...edp.slice().reverse()],
                           y: [...upper, ...lower.slice().reverse()],
                           fill: 'toself',
                           fillcolor: 'rgba(41,128,185,0.15)',
                           line: { width: 0 },
                           name: '±1σ Uncertainty',
                           showlegend: true,
                           hoverinfo: 'skip'
                       });
                   }

                   slfTraces.push({
                       x: edp,
                       y: loss,
                       mode: 'lines',
                       name: 'Mean Loss',
                       line: { color: '#2980b9', width: 2.5 }
                   });

                   Plotly.newPlot('slf-plot', slfTraces, {
                       title: { text: 'Storey Loss Function', x: 0.5 },
                       xaxis: { title: xLabel, gridcolor: '#ecf0f1' },
                       yaxis: { title: 'Loss Ratio', range: [0, 1.1], gridcolor: '#ecf0f1' },
                       legend: { orientation: 'h', y: -0.15, x: 0.5, xanchor: 'center' },
                       paper_bgcolor: '#fcfcfc', plot_bgcolor: 'white',
                       margin: { t: 60, b: 80, l: 60, r: 30 }
                   }, { responsive: true, displaylogo: false });
                   
               } catch (e) {
                   document.getElementById('slf-plot').innerHTML = '<div style="padding: 40px; text-align: center; color: #c0392b;">Error loading SLF data: ' + e.message + '</div>';
               }
           });
           
           document.getElementById('slf-plot').innerHTML = '<div style="padding: 40px; text-align: center; color: #666;">Select parameters and click Load SLF</div>';
       });
   </script>


Embodied Carbon Loss Functions
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Carbon SLFs express embodied carbon loss (kg CO₂-eq per unit floor area) as a function of EDP,
for structural and non-structural components. They follow the same region × material × component × occupancy
structure as the non-structural SLFs above.

**Interactive Carbon SLF Viewer**

.. raw:: html

   <div class="viewer-container" id="carbon-slf-viewer">
       <div class="viewer-controls">
           <div class="control-row">
               <div class="control-group">
                   <label for="cslf-region-select">Region:</label>
                   <select id="cslf-region-select" class="viewer-select">
                       <option value="">-- Select Region --</option>
                       <option value="Europe">Europe</option>
                       <option value="North_America">North America</option>
                       <option value="Caribbean_Central_America">Caribbean &amp; Central America</option>
                       <option value="South_America">South America</option>
                       <option value="North_Asia">North Asia</option>
                       <option value="Central_Asia">Central Asia</option>
                       <option value="East_Asia">East Asia</option>
                       <option value="Southeast_Asia">Southeast Asia</option>
                       <option value="South_Asia">South Asia</option>
                       <option value="Oceania">Oceania</option>
                       <option value="Africa">Africa</option>
                       <option value="Middle_East">Middle East</option>
                   </select>
               </div>
               <div class="control-group">
                   <label for="cslf-material-select">Material:</label>
                   <select id="cslf-material-select" class="viewer-select">
                       <option value="">-- Select Material --</option>
                       <option value="CR">Reinforced Concrete (CR)</option>
                       <option value="CR/LFINF">RC with Infill (CR/LFINF)</option>
                       <option value="MUR">Unreinforced Masonry (MUR)</option>
                       <option value="MCF">Confined Masonry (MCF)</option>
                       <option value="W">Timber (W)</option>
                       <option value="S">Steel (S)</option>
                       <option value="S/LFINF">Steel with Infill (S/LFINF)</option>
                       <option value="ADO">Adobe (ADO)</option>
                   </select>
               </div>
           </div>
           <div class="control-row">
               <div class="control-group">
                   <label for="cslf-component-select">Component:</label>
                   <select id="cslf-component-select" class="viewer-select">
                       <option value="">-- Select Component --</option>
                       <option value="NSCUA">Unanchored (NSCUA)</option>
                       <option value="NSCA">Anchored (NSCA)</option>
                   </select>
               </div>
               <div class="control-group">
                   <label for="cslf-occupancy-select">Occupancy:</label>
                   <select id="cslf-occupancy-select" class="viewer-select">
                       <option value="">-- Select Occupancy --</option>
                       <option value="RES">Residential (RES)</option>
                       <option value="COM">Commercial (COM)</option>
                       <option value="IND">Industrial (IND)</option>
                   </select>
               </div>
               <div class="control-group">
                   <label for="cslf-edp-select">EDP Type:</label>
                   <select id="cslf-edp-select" class="viewer-select">
                       <option value="">-- Select EDP --</option>
                       <option value="drift">Drift-Sensitive</option>
                       <option value="acceleration">Acceleration-Sensitive</option>
                   </select>
               </div>
           </div>
           <div class="control-group">
               <button id="cslf-load-btn" class="viewer-btn btn-primary">Load Carbon SLF</button>
           </div>
       </div>
       <div class="viewer-plot" id="cslf-plot" style="height: 450px;"></div>
   </div>

   <script>
       document.addEventListener('DOMContentLoaded', function() {
           const cslfLoadBtn = document.getElementById('cslf-load-btn');

           cslfLoadBtn.addEventListener('click', async function() {
               const region = document.getElementById('cslf-region-select').value;
               const material = document.getElementById('cslf-material-select').value;
               const component = document.getElementById('cslf-component-select').value;
               const occupancy = document.getElementById('cslf-occupancy-select').value;
               const edpType = document.getElementById('cslf-edp-select').value;

               if (!region || !material || !component || !occupancy || !edpType) {
                   alert('Please select all parameters');
                   return;
               }

               document.getElementById('cslf-plot').innerHTML = '<div style="padding: 40px; text-align: center;">Loading Carbon SLF data...</div>';

               try {
                   const response = await fetch('_static/data/in/consequences/carbon_slfs_all_regions.json');
                   if (!response.ok) {
                       document.getElementById('cslf-plot').innerHTML = '<div style="padding: 40px; text-align: center; color: #666;">Carbon SLF data not available. Re-run ppGlobal_GenerateDocs.py to export.</div>';
                       return;
                   }

                   const slfs = await response.json();

                   if (!slfs[region] || !slfs[region][material] || !slfs[region][material][component] ||
                       !slfs[region][material][component][occupancy] || !slfs[region][material][component][occupancy][edpType]) {
                       document.getElementById('cslf-plot').innerHTML = '<div style="padding: 40px; text-align: center; color: #666;">No Carbon SLF data for selected combination.</div>';
                       return;
                   }

                   const data = slfs[region][material][component][occupancy][edpType];
                   const edp = data.EDP || [];
                   const loss = data.Loss || [];
                   const cov = data.COV || [];

                   const xLabel = edpType === 'drift' ? 'Peak Storey Drift Ratio' : 'Peak Floor Acceleration [g]';

                   const cslfTraces = [];

                   // Shaded ±1σ uncertainty band from COV
                   if (cov.length === loss.length && cov.some(v => v > 0)) {
                       const upper = loss.map((l, i) => l * (1 + cov[i]));
                       const lower = loss.map((l, i) => Math.max(0.0, l * (1 - cov[i])));
                       cslfTraces.push({
                           x: [...edp, ...edp.slice().reverse()],
                           y: [...upper, ...lower.slice().reverse()],
                           fill: 'toself',
                           fillcolor: 'rgba(39,174,96,0.15)',
                           line: { width: 0 },
                           name: '±1σ Uncertainty',
                           showlegend: true,
                           hoverinfo: 'skip'
                       });
                   }

                   cslfTraces.push({
                       x: edp,
                       y: loss,
                       mode: 'lines',
                       name: 'Mean Carbon Loss',
                       line: { color: '#27ae60', width: 2.5 }
                   });

                   Plotly.newPlot('cslf-plot', cslfTraces, {
                       title: { text: 'Carbon Storey Loss Function', x: 0.5 },
                       xaxis: { title: xLabel, gridcolor: '#ecf0f1' },
                       yaxis: { title: 'Embodied Carbon Loss [kg CO₂-eq/m²]', gridcolor: '#ecf0f1' },
                       legend: { orientation: 'h', y: -0.15, x: 0.5, xanchor: 'center' },
                       paper_bgcolor: '#fcfcfc', plot_bgcolor: 'white',
                       margin: { t: 60, b: 80, l: 80, r: 30 }
                   }, { responsive: true, displaylogo: false });

               } catch (e) {
                   document.getElementById('cslf-plot').innerHTML = '<div style="padding: 40px; text-align: center; color: #c0392b;">Error loading Carbon SLF data: ' + e.message + '</div>';
               }
           });

           document.getElementById('cslf-plot').innerHTML = '<div style="padding: 40px; text-align: center; color: #666;">Select parameters and click Load Carbon SLF</div>';
       });
   </script>


Contents Losses
~~~~~~~~~~~~~~~

Losses from damage to building contents including furniture, fixtures, equipment, machinery, 
personal belongings (residential), and inventory (commercial/industrial).


Casualty Consequence Models
---------------------------

Casualty models estimate fatalities and injuries based on building damage and collapse. 
The consequence ratios below represent the expected proportion of building occupants 
affected at each damage state.

**Fatalities Consequence Ratios**

.. raw:: html

   <div id="fatalities-table-container">
       <div class="viewer-controls" style="margin-bottom: 15px;">
           <input type="text" id="fatalities-search" placeholder="Search taxonomy..." 
                  style="padding: 8px 12px; border: 1px solid #ddd; border-radius: 4px; width: 300px;">
       </div>
       <div id="fatalities-table" style="max-height: 400px; overflow-y: auto; border: 1px solid #e9ecef; border-radius: 6px;">
           <p style="padding: 20px; color: #666;">Loading fatalities data...</p>
       </div>
   </div>

   <script>
       document.addEventListener('DOMContentLoaded', async function() {
           const container = document.getElementById('fatalities-table');
           const searchInput = document.getElementById('fatalities-search');
           
           try {
               const response = await fetch('_static/data/in/consequences/consequence_fatalities.csv');
               if (!response.ok) throw new Error('File not found');
               
               const text = await response.text();
               const lines = text.trim().split('\n');
               const headers = lines[0].split(',').map(h => h.trim());
               
               const data = [];
               for (let i = 1; i < lines.length; i++) {
                   const values = lines[i].split(',');
                   const row = {};
                   headers.forEach((h, idx) => { row[h] = values[idx]?.trim() || ''; });
                   data.push(row);
               }
               
               function renderTable(filteredData) {
                   const displayHeaders = ['Taxonomy', 'slight', 'moderate', 'extensive', 'complete'];
                   let html = '<table style="width: 100%; border-collapse: collapse; font-size: 12px;">';
                   html += '<thead style="position: sticky; top: 0; background: #f8f9fa;">';
                   html += '<tr style="border-bottom: 2px solid #dee2e6;">';
                   displayHeaders.forEach(h => {
                       const label = h === 'Taxonomy' ? h : h.charAt(0).toUpperCase() + h.slice(1);
                       html += '<th style="padding: 10px 8px; text-align: left;">' + label + '</th>';
                   });
                   html += '</tr></thead><tbody>';
                   
                   filteredData.slice(0, 100).forEach((row, idx) => {
                       const bg = idx % 2 === 0 ? 'white' : '#f8f9fa';
                       html += '<tr style="border-bottom: 1px solid #e9ecef; background: ' + bg + ';">';
                       displayHeaders.forEach(h => {
                           let val = row[h] || '0';
                           if (h !== 'Taxonomy') {
                               const num = parseFloat(val);
                               val = isNaN(num) ? '0.00000' : num.toFixed(5);
                           }
                           html += '<td style="padding: 8px;">' + val + '</td>';
                       });
                       html += '</tr>';
                   });
                   html += '</tbody></table>';
                   if (filteredData.length > 100) {
                       html += '<div style="padding: 10px; color: #666; font-size: 11px;">Showing first 100 of ' + filteredData.length + ' rows</div>';
                   }
                   container.innerHTML = html;
               }
               
               renderTable(data);
               
               searchInput.addEventListener('input', () => {
                   const query = searchInput.value.toLowerCase();
                   const filtered = data.filter(row => row['Taxonomy']?.toLowerCase().includes(query));
                   renderTable(filtered);
               });
               
           } catch (e) {
               container.innerHTML = '<div style="padding: 20px; color: #666;">Fatalities data not available. Place consequence_fatalities.csv in data/in/consequences/</div>';
           }
       });
   </script>

**Injuries Consequence Ratios**

.. raw:: html

   <div id="injuries-table-container">
       <div class="viewer-controls" style="margin-bottom: 15px;">
           <input type="text" id="injuries-search" placeholder="Search taxonomy..." 
                  style="padding: 8px 12px; border: 1px solid #ddd; border-radius: 4px; width: 300px;">
       </div>
       <div id="injuries-table" style="max-height: 400px; overflow-y: auto; border: 1px solid #e9ecef; border-radius: 6px;">
           <p style="padding: 20px; color: #666;">Loading injuries data...</p>
       </div>
   </div>

   <script>
       document.addEventListener('DOMContentLoaded', async function() {
           const container = document.getElementById('injuries-table');
           const searchInput = document.getElementById('injuries-search');
           
           try {
               const response = await fetch('_static/data/in/consequences/consequence_injuries.csv');
               if (!response.ok) throw new Error('File not found');
               
               const text = await response.text();
               const lines = text.trim().split('\n');
               const headers = lines[0].split(',').map(h => h.trim());
               
               const data = [];
               for (let i = 1; i < lines.length; i++) {
                   const values = lines[i].split(',');
                   const row = {};
                   headers.forEach((h, idx) => { row[h] = values[idx]?.trim() || ''; });
                   data.push(row);
               }
               
               function renderTable(filteredData) {
                   const displayHeaders = ['Taxonomy', 'slight', 'moderate', 'extensive', 'complete'];
                   let html = '<table style="width: 100%; border-collapse: collapse; font-size: 12px;">';
                   html += '<thead style="position: sticky; top: 0; background: #f8f9fa;">';
                   html += '<tr style="border-bottom: 2px solid #dee2e6;">';
                   displayHeaders.forEach(h => {
                       const label = h === 'Taxonomy' ? h : h.charAt(0).toUpperCase() + h.slice(1);
                       html += '<th style="padding: 10px 8px; text-align: left;">' + label + '</th>';
                   });
                   html += '</tr></thead><tbody>';
                   
                   filteredData.slice(0, 100).forEach((row, idx) => {
                       const bg = idx % 2 === 0 ? 'white' : '#f8f9fa';
                       html += '<tr style="border-bottom: 1px solid #e9ecef; background: ' + bg + ';">';
                       displayHeaders.forEach(h => {
                           let val = row[h] || '0';
                           if (h !== 'Taxonomy') {
                               const num = parseFloat(val);
                               val = isNaN(num) ? '0' : num.toExponential(2);
                           }
                           html += '<td style="padding: 8px;">' + val + '</td>';
                       });
                       html += '</tr>';
                   });
                   html += '</tbody></table>';
                   container.innerHTML = html;
               }
               
               renderTable(data);
               
               searchInput.addEventListener('input', () => {
                   const query = searchInput.value.toLowerCase();
                   const filtered = data.filter(row => row['Taxonomy']?.toLowerCase().includes(query));
                   renderTable(filtered);
               });
               
           } catch (e) {
               container.innerHTML = '<div style="padding: 20px; color: #666;">Injuries data not available.</div>';
           }
       });
   </script>

**Affected Population**

.. raw:: html

   <div id="affectedpop-table-container">
       <div class="viewer-controls" style="margin-bottom: 15px;">
           <input type="text" id="affectedpop-search" placeholder="Search taxonomy..." 
                  style="padding: 8px 12px; border: 1px solid #ddd; border-radius: 4px; width: 300px;">
       </div>
       <div id="affectedpop-table" style="max-height: 400px; overflow-y: auto; border: 1px solid #e9ecef; border-radius: 6px;">
           <p style="padding: 20px; color: #666;">Loading affected population data...</p>
       </div>
   </div>

   <script>
       document.addEventListener('DOMContentLoaded', async function() {
           const container = document.getElementById('affectedpop-table');
           const searchInput = document.getElementById('affectedpop-search');
           
           try {
               const response = await fetch('_static/data/in/consequences/consequence_affectedpop.csv');
               if (!response.ok) throw new Error('File not found');
               
               const text = await response.text();
               const lines = text.trim().split('\n');
               const headers = lines[0].split(',').map(h => h.trim());
               
               const data = [];
               for (let i = 1; i < lines.length; i++) {
                   const values = lines[i].split(',');
                   const row = {};
                   headers.forEach((h, idx) => { row[h] = values[idx]?.trim() || ''; });
                   data.push(row);
               }
               
               function renderTable(filteredData) {
                   const displayHeaders = ['Taxonomy', 'slight', 'moderate', 'extensive', 'complete'];
                   let html = '<table style="width: 100%; border-collapse: collapse; font-size: 12px;">';
                   html += '<thead style="position: sticky; top: 0; background: #f8f9fa;">';
                   html += '<tr style="border-bottom: 2px solid #dee2e6;">';
                   displayHeaders.forEach(h => {
                       const label = h === 'Taxonomy' ? h : h.charAt(0).toUpperCase() + h.slice(1);
                       html += '<th style="padding: 10px 8px; text-align: left;">' + label + '</th>';
                   });
                   html += '</tr></thead><tbody>';
                   
                   filteredData.slice(0, 100).forEach((row, idx) => {
                       const bg = idx % 2 === 0 ? 'white' : '#f8f9fa';
                       html += '<tr style="border-bottom: 1px solid #e9ecef; background: ' + bg + ';">';
                       displayHeaders.forEach(h => {
                           let val = row[h] || '0';
                           if (h !== 'Taxonomy') {
                               const num = parseFloat(val);
                               val = isNaN(num) ? '0.00000' : num.toFixed(5);
                           }
                           html += '<td style="padding: 8px;">' + val + '</td>';
                       });
                       html += '</tr>';
                   });
                   html += '</tbody></table>';
                   container.innerHTML = html;
               }
               
               renderTable(data);
               
               searchInput.addEventListener('input', () => {
                   const query = searchInput.value.toLowerCase();
                   const filtered = data.filter(row => row['Taxonomy']?.toLowerCase().includes(query));
                   renderTable(filtered);
               });
               
           } catch (e) {
               container.innerHTML = '<div style="padding: 20px; color: #666;">Affected population data not available.</div>';
           }
       });
   </script>

**Displaced Population**

.. raw:: html

   <div id="displaced-table-container">
       <div class="viewer-controls" style="margin-bottom: 15px;">
           <input type="text" id="displaced-search" placeholder="Search taxonomy..." 
                  style="padding: 8px 12px; border: 1px solid #ddd; border-radius: 4px; width: 300px;">
       </div>
       <div id="displaced-table" style="max-height: 400px; overflow-y: auto; border: 1px solid #e9ecef; border-radius: 6px;">
           <p style="padding: 20px; color: #666;">Loading displaced population data...</p>
       </div>
   </div>

   <script>
       document.addEventListener('DOMContentLoaded', async function() {
           const container = document.getElementById('displaced-table');
           const searchInput = document.getElementById('displaced-search');
           
           try {
               const response = await fetch('_static/data/in/consequences/consequence_displaced.csv');
               if (!response.ok) throw new Error('File not found');
               
               const text = await response.text();
               const lines = text.trim().split('\n');
               const headers = lines[0].split(',').map(h => h.trim());
               
               const data = [];
               for (let i = 1; i < lines.length; i++) {
                   const values = lines[i].split(',');
                   const row = {};
                   headers.forEach((h, idx) => { row[h] = values[idx]?.trim() || ''; });
                   data.push(row);
               }
               
               function renderTable(filteredData) {
                   const displayHeaders = ['Taxonomy', 'slight', 'moderate', 'extensive', 'complete'];
                   let html = '<table style="width: 100%; border-collapse: collapse; font-size: 12px;">';
                   html += '<thead style="position: sticky; top: 0; background: #f8f9fa;">';
                   html += '<tr style="border-bottom: 2px solid #dee2e6;">';
                   displayHeaders.forEach(h => {
                       const label = h === 'Taxonomy' ? h : h.charAt(0).toUpperCase() + h.slice(1);
                       html += '<th style="padding: 10px 8px; text-align: left;">' + label + '</th>';
                   });
                   html += '</tr></thead><tbody>';
                   
                   filteredData.slice(0, 100).forEach((row, idx) => {
                       const bg = idx % 2 === 0 ? 'white' : '#f8f9fa';
                       html += '<tr style="border-bottom: 1px solid #e9ecef; background: ' + bg + ';">';
                       displayHeaders.forEach(h => {
                           let val = row[h] || '0';
                           if (h !== 'Taxonomy') {
                               const num = parseFloat(val);
                               val = isNaN(num) ? '0.00000' : num.toFixed(5);
                           }
                           html += '<td style="padding: 8px;">' + val + '</td>';
                       });
                       html += '</tr>';
                   });
                   html += '</tbody></table>';
                   container.innerHTML = html;
               }
               
               renderTable(data);
               
               searchInput.addEventListener('input', () => {
                   const query = searchInput.value.toLowerCase();
                   const filtered = data.filter(row => row['Taxonomy']?.toLowerCase().includes(query));
                   renderTable(filtered);
               });
               
           } catch (e) {
               container.innerHTML = '<div style="padding: 20px; color: #666;">Displaced population data not available.</div>';
           }
       });
   </script>


Regional Variations
-------------------

Consequence models may vary by region due to:

* **Construction costs**: Labour and material costs differ globally
* **Repair practices**: Different repair approaches for similar damage
* **Economic factors**: Currency, inflation, and market conditions
* **Building standards**: Code requirements for repairs/retrofits


Uncertainty Quantification
--------------------------

Uncertainty in damage-to-loss ratios is captured through:

**Within-Damage-State Variability**
   Coefficient of variation for loss ratio given each damage state

**Between-Building Variability**
   Differences in repair costs for buildings of the same class

The uncertainty is propagated through the vulnerability calculation using the formulations 
described in the Vulnerability Models section.


References
----------

* Di Pasquale G. et al. (2005). New developments in seismic risk assessment in Italy. 
  Bulletin of Earthquake Engineering.

* Bal I.E. et al. (2008). Detailed assessment of structural characteristics of Turkish RC 
  building stock for loss assessment models. Soil Dynamics and Earthquake Engineering.

* Martins L. et al. (2016). Development and assessment of damage-to-loss models for 
  moment-frame reinforced concrete buildings. Earthquake Engineering & Structural Dynamics.

* Aljawhari K. et al. (2023). Simulation-based consequence models of seismic direct loss 
  and repair time for archetype reinforced concrete frames. Soil Dynamics and Earthquake 
  Engineering.

* FEMA (2012). Next-Generation Methodology for Seismic Performance Assessment of Buildings 
  (FEMA P-58). Washington, D.C.