added and implemented iso3 code crosswalk

adamvosburgh · adamvosburgh · commit b3dbc00eeb13 · 2026-02-27T18:37:38.000-05:00
diff --git a/public/data/iso3_names.json b/public/data/iso3_names.json
@@ -0,0 +1,174 @@
+{
+  "AFG": "Afghanistan",
+  "AGO": "Angola",
+  "ALB": "Albania",
+  "ARE": "United Arab Emirates",
+  "ARG": "Argentina",
+  "ARM": "Armenia",
+  "ATA": "Antarctica",
+  "ATF": "Fr. S. Antarctic Lands",
+  "AUS": "Australia",
+  "AUT": "Austria",
+  "AZE": "Azerbaijan",
+  "BDI": "Burundi",
+  "BEL": "Belgium",
+  "BEN": "Benin",
+  "BFA": "Burkina Faso",
+  "BGD": "Bangladesh",
+  "BGR": "Bulgaria",
+  "BHS": "Bahamas",
+  "BIH": "Bosnia and Herz.",
+  "BLR": "Belarus",
+  "BLZ": "Belize",
+  "BOL": "Bolivia",
+  "BRA": "Brazil",
+  "BRN": "Brunei",
+  "BTN": "Bhutan",
+  "BWA": "Botswana",
+  "CAF": "Central African Rep.",
+  "CAN": "Canada",
+  "CHE": "Switzerland",
+  "CHL": "Chile",
+  "CHN": "China",
+  "CIV": "Côte d'Ivoire",
+  "CMR": "Cameroon",
+  "COD": "Dem. Rep. Congo",
+  "COG": "Congo",
+  "COL": "Colombia",
+  "CRI": "Costa Rica",
+  "CUB": "Cuba",
+  "CYP": "Cyprus",
+  "CZE": "Czechia",
+  "DEU": "Germany",
+  "DJI": "Djibouti",
+  "DNK": "Denmark",
+  "DOM": "Dominican Rep.",
+  "DZA": "Algeria",
+  "ECU": "Ecuador",
+  "EGY": "Egypt",
+  "ERI": "Eritrea",
+  "ESH": "W. Sahara",
+  "ESP": "Spain",
+  "EST": "Estonia",
+  "ETH": "Ethiopia",
+  "FIN": "Finland",
+  "FJI": "Fiji",
+  "FLK": "Falkland Is.",
+  "GAB": "Gabon",
+  "GBR": "United Kingdom",
+  "GEO": "Georgia",
+  "GHA": "Ghana",
+  "GIN": "Guinea",
+  "GMB": "Gambia",
+  "GNB": "Guinea-Bissau",
+  "GNQ": "Eq. Guinea",
+  "GRC": "Greece",
+  "GRL": "Greenland",
+  "GTM": "Guatemala",
+  "GUY": "Guyana",
+  "HND": "Honduras",
+  "HRV": "Croatia",
+  "HTI": "Haiti",
+  "HUN": "Hungary",
+  "IDN": "Indonesia",
+  "IND": "India",
+  "IRL": "Ireland",
+  "IRN": "Iran",
+  "IRQ": "Iraq",
+  "ISL": "Iceland",
+  "ISR": "Israel",
+  "ITA": "Italy",
+  "JAM": "Jamaica",
+  "JOR": "Jordan",
+  "JPN": "Japan",
+  "KAZ": "Kazakhstan",
+  "KEN": "Kenya",
+  "KGZ": "Kyrgyzstan",
+  "KHM": "Cambodia",
+  "KOR": "South Korea",
+  "KWT": "Kuwait",
+  "LAO": "Laos",
+  "LBN": "Lebanon",
+  "LBR": "Liberia",
+  "LBY": "Libya",
+  "LKA": "Sri Lanka",
+  "LSO": "Lesotho",
+  "LTU": "Lithuania",
+  "LUX": "Luxembourg",
+  "LVA": "Latvia",
+  "MAR": "Morocco",
+  "MDA": "Moldova",
+  "MDG": "Madagascar",
+  "MEX": "Mexico",
+  "MKD": "North Macedonia",
+  "MLI": "Mali",
+  "MMR": "Myanmar",
+  "MNE": "Montenegro",
+  "MNG": "Mongolia",
+  "MOZ": "Mozambique",
+  "MRT": "Mauritania",
+  "MWI": "Malawi",
+  "MYS": "Malaysia",
+  "NAM": "Namibia",
+  "NCL": "New Caledonia",
+  "NER": "Niger",
+  "NGA": "Nigeria",
+  "NIC": "Nicaragua",
+  "NLD": "Netherlands",
+  "NPL": "Nepal",
+  "NZL": "New Zealand",
+  "OMN": "Oman",
+  "PAK": "Pakistan",
+  "PAN": "Panama",
+  "PER": "Peru",
+  "PHL": "Philippines",
+  "PNG": "Papua New Guinea",
+  "POL": "Poland",
+  "PRI": "Puerto Rico",
+  "PRK": "North Korea",
+  "PRT": "Portugal",
+  "PRY": "Paraguay",
+  "PSE": "Palestine",
+  "QAT": "Qatar",
+  "ROU": "Romania",
+  "RUS": "Russia",
+  "RWA": "Rwanda",
+  "SAU": "Saudi Arabia",
+  "SDN": "Sudan",
+  "SEN": "Senegal",
+  "SLB": "Solomon Is.",
+  "SLE": "Sierra Leone",
+  "SLV": "El Salvador",
+  "SOM": "Somalia",
+  "SRB": "Serbia",
+  "SSD": "S. Sudan",
+  "SUR": "Suriname",
+  "SVK": "Slovakia",
+  "SVN": "Slovenia",
+  "SWE": "Sweden",
+  "SWZ": "eSwatini",
+  "SYR": "Syria",
+  "TCD": "Chad",
+  "TGO": "Togo",
+  "THA": "Thailand",
+  "TJK": "Tajikistan",
+  "TKM": "Turkmenistan",
+  "TLS": "Timor-Leste",
+  "TTO": "Trinidad and Tobago",
+  "TUN": "Tunisia",
+  "TUR": "Turkey",
+  "TWN": "Taiwan",
+  "TZA": "Tanzania",
+  "UGA": "Uganda",
+  "UKR": "Ukraine",
+  "URY": "Uruguay",
+  "USA": "United States of America",
+  "UZB": "Uzbekistan",
+  "VEN": "Venezuela",
+  "VNM": "Vietnam",
+  "VUT": "Vanuatu",
+  "YEM": "Yemen",
+  "ZAF": "South Africa",
+  "ZMB": "Zambia",
+  "ZWE": "Zimbabwe"
+}
diff --git a/src/anthromes/lib/MapCanvas.svelte b/src/anthromes/lib/MapCanvas.svelte
@@ -54,6 +54,7 @@
   let cellHistoryLoading = $state(false);
   let countryData = $state(null);
   let countryDataLoading = $state(false);
+  let iso3ToName = $state(new Map());
   const cache = new Map();
   const inFlight = new Map();
   let draggingHandle = $state(false);
@@ -300,14 +301,19 @@
     countryDataLoading = true;
     try {
       const base = import.meta.env.BASE_URL;
-      const url = `${base}data/country_index.json`;
       const isDev = import.meta.env.DEV;
-      const res = await fetch(url, { cache: isDev ? 'no-store' : 'force-cache' });
-      if (!res.ok) {
-        throw new Error(`Failed to load country data (${res.status})`);
+
+      const [countryRes, namesRes] = await Promise.all([
+        fetch(`${base}data/country_index.json`, { cache: isDev ? 'no-store' : 'force-cache' }),
+        fetch(`${base}data/iso3_names.json`,    { cache: isDev ? 'no-store' : 'force-cache' }),
+      ]);
+
+      if (!countryRes.ok) throw new Error(`Failed to load country data (${countryRes.status})`);
+      countryData = new Map(Object.entries(await countryRes.json()));
+
+      if (namesRes.ok) {
+        iso3ToName = new Map(Object.entries(await namesRes.json()));
       }
-      const data = await res.json();
-      countryData = new Map(Object.entries(data));
     } catch (err) {
       console.error('MapCanvas: Failed to load country data', err);
     } finally {
@@ -753,7 +759,7 @@
       <div class="kv">
         <div class="k">${label} total in ${yearLabel}</div><div>${globalAreaDisplay}</div>
         <div class="k">${label} share in ${yearLabel}</div><div>${percentDisplay}</div>
-        ${countryISO3 ? `<div class="k">Present Day Country</div><div>${crosswalk?.country || countryISO3}</div>` : ''}
+        ${countryISO3 ? `<div class="k">Present Day Country</div><div>${iso3ToName.get(countryISO3) || crosswalk?.country || countryISO3}</div>` : ''}
         ${crosswalk ? `<div class="k">Number of samples from this country</div><div>${crosswalk.samples_total || 0}</div>` : ''}
         ${crosswalk ? `<div class="k">Percent of "Western" lifestyles in sampled persons</div><div>${westPercent}%</div>` : ''}
       </div>
diff --git a/src/biomes/lib/BiomesChart.svelte b/src/biomes/lib/BiomesChart.svelte
@@ -50,6 +50,9 @@
   let highlightedSGBs = $state(new Set());
   let crossHighlightActive = $state(false);
 
+  // Country name lookup (ISO3 → display name)
+  let iso3ToName = $state(new Map());
+
   // Constants
   const fullSize = 6400;        // base SVG dimension for full view
   const previewSize = 1200;     // smaller preview mode
@@ -576,7 +579,7 @@
     const glyphPath = glyphLine(chain);
 
     // Summary text
-    const loc = locationsFromMeta(meta);
+    const loc = locationsFromMeta(meta, iso3ToName);
     const sgb = sgbLabel(d);
     const summary = `<b>${sgb}</b> includes <b>${rec.toLocaleString()}</b> genomes within the <b>${phylum.replace(/_/g, ' ')}</b> phylum, identified from <b>${loc}</b>.`;
 
@@ -931,6 +934,16 @@
       })
       .catch(() => {});
 
+    // Load ISO3 → country name lookup
+    const base = import.meta.env.BASE_URL;
+    fetch(`${base}data/iso3_names.json`)
+      .then(res => res.ok ? res.json() : null)
+      .then(json => {
+        if (!json) return;
+        iso3ToName = new Map(Object.entries(json));
+      })
+      .catch(() => {});
+
     const svg = d3.select(svgElement);
 
     // Ensure zoom container exists
diff --git a/src/biomes/lib/dataAdapter.js b/src/biomes/lib/dataAdapter.js
@@ -133,7 +133,7 @@ export function parseWestern(meta) {
  * @param {Object} meta - Metadata object
  * @returns {string} Human-readable location string
  */
-export function locationsFromMeta(meta) {
+export function locationsFromMeta(meta, nameMap) {
   if (!meta) return '—';
 
   let v = meta["Country_List"];
@@ -165,10 +165,11 @@ export function locationsFromMeta(meta) {
   if (!arr.length) return 'various global sites';
 
   const uniq = Array.from(new Set(arr.map(s => s.trim())));
+  const named = nameMap ? uniq.map(code => nameMap.get(code) || code) : uniq;
 
-  const shown = uniq.slice(0, 5).join(', ');
-  if (uniq.length > 5) {
-    const remaining = uniq.length - 5;
+  const shown = named.slice(0, 5).join(', ');
+  if (named.length > 5) {
+    const remaining = named.length - 5;
     return `${shown}, and ${remaining} other global site${remaining > 1 ? 's' : ''}`;
   }
   return shown;
