Upload 162 files

.gitattributes

@@ -32,3 +32,8 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+media/2D/2d_fields/air_concentration/air_concentration.gif filter=lfs diff=lfs merge=lfs -text
+media/2D/frames/air_concentration/frame_0001.jpg filter=lfs diff=lfs merge=lfs -text
+media/2D/frames/air_concentration/frame_0008.jpg filter=lfs diff=lfs merge=lfs -text
+media/2D/frames/air_concentration/frame_0009.jpg filter=lfs diff=lfs merge=lfs -text
+media/2D/frames/air_concentration/frame_0010.jpg filter=lfs diff=lfs merge=lfs -text

NameModel_app.zip

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:58ecfedfead9237ae58b93ed6351f6492703145dfae1349591f9d9ac489a8867
+size 741076

Taal_273070_20200112_scenario_yizhou.zip

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:9bb340a75132c3008a149557ff85f8bc05b4a46e70eee027503e30b9573fdd39
+size 181349

app.py

@@ -1,147 +1,323 @@
+import os
+import glob
+import shutil
 import io
-import random
-from typing import List, Tuple
-
-import aiohttp
+import logging
 import panel as pn
-from PIL import Image
-from transformers import CLIPModel, CLIPProcessor
+import xarray as xr
+import numpy as np
+from datetime import datetime
+from types import SimpleNamespace
+from collections import defaultdict
+from ash_animator.converter import NAMEDataProcessor
+from ash_animator.plot_3dfield_data import Plot_3DField_Data
+from ash_animator.plot_horizontal_data import Plot_Horizontal_Data
+from ash_animator import create_grid
+
+pn.extension()
+
+MEDIA_DIR = "media"
+os.makedirs(MEDIA_DIR, exist_ok=True)
+
+# Logging setup
+LOG_FILE = os.path.join(MEDIA_DIR, "app_errors.log")
+logging.basicConfig(filename=LOG_FILE, level=logging.ERROR,
+                    format="%(asctime)s - %(levelname)s - %(message)s")
+
+animator_obj = {}
+
+# ---------------- Widgets ----------------
+file_input = pn.widgets.FileInput(accept=".zip")
+process_button = pn.widgets.Button(name="📦 Process ZIP", button_type="primary")
+reset_button = pn.widgets.Button(name="🔄 Reset App", button_type="danger")
+status = pn.pane.Markdown("### Upload a NAME Model ZIP to begin")
+
+download_button = pn.widgets.FileDownload(
+    label="⬇️ Download All Exports",
+    filename="all_exports.zip",
+    button_type="success",
+    callback=lambda: io.BytesIO(
+        open(shutil.make_archive(
+            os.path.join(MEDIA_DIR, "all_exports").replace(".zip", ""),
+            "zip", MEDIA_DIR
+        ), 'rb').read()
+    )
+)
+
+log_link = pn.widgets.FileDownload(
+    label="🪵 View Error Log", file=LOG_FILE,
+    filename="app_errors.log", button_type="warning"
+)
+
+threshold_slider_3d = pn.widgets.FloatSlider(name='3D Threshold', start=0.0, end=1.0, step=0.05, value=0.1)
+zoom_slider_3d = pn.widgets.IntSlider(name='3D Zoom Level', start=1, end=20, value=19)
+cmap_select_3d = pn.widgets.Select(name='3D Colormap', options=["rainbow", "viridis", "plasma"])
+fps_slider_3d = pn.widgets.IntSlider(name='3D FPS', start=1, end=10, value=2)
+Altitude_slider = pn.widgets.IntSlider(name='Define Ash Altitude', start=1, end=15, value=1)
+
+threshold_slider_2d = pn.widgets.FloatSlider(name='2D Threshold', start=0.0, end=1.0, step=0.01, value=0.005)
+zoom_slider_2d = pn.widgets.IntSlider(name='2D Zoom Level', start=1, end=20, value=19)
+fps_slider_2d = pn.widgets.IntSlider(name='2D FPS', start=1, end=10, value=2)
+cmap_select_2d = pn.widgets.Select(name='2D Colormap', options=["rainbow", "viridis", "plasma"])
+
+# ---------------- Core Functions ----------------
+def process_zip(event=None):
+    if file_input.value:
+        zip_path = os.path.join(MEDIA_DIR, file_input.filename)
+        with open(zip_path, "wb") as f:
+            f.write(file_input.value)
+        status.object = "✅ ZIP uploaded and saved."
+    else:
+        zip_path = os.path.join(MEDIA_DIR, "default_model.zip")
+        if not os.path.exists(zip_path):
+            status.object = "❌ No ZIP uploaded and default_model.zip not found."
+            return
+        status.object = "📦 Using default_model.zip"
+
+    output_dir = os.path.join("./", "ash_output")
+    shutil.rmtree(output_dir, ignore_errors=True)
+    os.makedirs(output_dir, exist_ok=True)
+
+    try:
+        processor = NAMEDataProcessor(output_root=output_dir)
+        processor.batch_process_zip(zip_path)
+
+        # animator_obj["3d"] = [xr.open_dataset(fp).load()
+        #                       for fp in sorted(glob.glob(os.path.join(output_dir, "3D", "*.nc")))]
+        
+        animator_obj["3d"] = []
+        for fp in sorted(glob.glob(os.path.join(output_dir, "3D", "*.nc"))):
+            with xr.open_dataset(fp) as ds:
+                animator_obj["3d"].append(ds.load())
+
+        animator_obj["2d"] = []
+        for fp in sorted(glob.glob(os.path.join(output_dir, "horizontal", "*.nc"))):
+            with xr.open_dataset(fp) as ds:
+                animator_obj["2d"].append(ds.load())
 
-pn.extension(design="bootstrap", sizing_mode="stretch_width")
+        
+        # animator_obj["2d"] = [xr.open_dataset(fp).load()
+        #                       for fp in sorted(glob.glob(os.path.join(output_dir, "horizontal", "*.nc")))]
 
-ICON_URLS = {
-    "brand-github": "https://github.com/holoviz/panel",
-    "brand-twitter": "https://twitter.com/Panel_Org",
-    "brand-linkedin": "https://www.linkedin.com/company/panel-org",
-    "message-circle": "https://discourse.holoviz.org/",
-    "brand-discord": "https://discord.gg/AXRHnJU6sP",
-}
+        with open(os.path.join(MEDIA_DIR, "last_run.txt"), "w") as f:
+            f.write(zip_path)
 
+        status.object += f" | ✅ Loaded 3D: {len(animator_obj['3d'])} & 2D: {len(animator_obj['2d'])}"
+        update_media_tabs()
+    except Exception as e:
+        logging.exception("Error during ZIP processing")
+        status.object = f"❌ Processing failed: {e}"
 
-async def random_url(_):
-    pet = random.choice(["cat", "dog"])
-    api_url = f"https://api.the{pet}api.com/v1/images/search"
-    async with aiohttp.ClientSession() as session:
-        async with session.get(api_url) as resp:
-            return (await resp.json())[0]["url"]
+def reset_app(event=None):
+    animator_obj.clear()
+    file_input.value = None
+    status.object = "🔄 App has been reset."
+    for folder in ["ash_output", "2D", "3D"]:
+        shutil.rmtree(os.path.join(MEDIA_DIR, folder), ignore_errors=True)
+    if os.path.exists(os.path.join(MEDIA_DIR, "last_run.txt")):
+        os.remove(os.path.join(MEDIA_DIR, "last_run.txt"))
+    update_media_tabs()
 
+def restore_previous_session():
+    try:
+        state_file = os.path.join(MEDIA_DIR, "last_run.txt")
+        if os.path.exists(state_file):
+            with open(state_file) as f:
+                zip_path = f.read().strip()
+            if os.path.exists(zip_path):
+                output_dir = os.path.join("./", "ash_output")
 
-@pn.cache
-def load_processor_model(
-    processor_name: str, model_name: str
-) -> Tuple[CLIPProcessor, CLIPModel]:
-    processor = CLIPProcessor.from_pretrained(processor_name)
-    model = CLIPModel.from_pretrained(model_name)
-    return processor, model
+                animator_obj["3d"] = []
+                for fp in sorted(glob.glob(os.path.join(output_dir, "3D", "*.nc"))):
+                    with xr.open_dataset(fp) as ds:
+                        animator_obj["3d"].append(ds.load())
 
+                animator_obj["2d"] = []
+                for fp in sorted(glob.glob(os.path.join(output_dir, "horizontal", "*.nc"))):
+                    with xr.open_dataset(fp) as ds:
+                        animator_obj["2d"].append(ds.load())
 
-async def open_image_url(image_url: str) -> Image:
-    async with aiohttp.ClientSession() as session:
-        async with session.get(image_url) as resp:
-            return Image.open(io.BytesIO(await resp.read()))
+                status.object = f"🔁 Restored previous session from {os.path.basename(zip_path)}"
+                update_media_tabs()
+    except Exception as e:
+        logging.exception("Error restoring previous session")
+        status.object = f"⚠️ Could not restore previous session: {e}"
 
+process_button.on_click(process_zip)
+reset_button.on_click(reset_app)
 
-def get_similarity_scores(class_items: List[str], image: Image) -> List[float]:
-    processor, model = load_processor_model(
-        "openai/clip-vit-base-patch32", "openai/clip-vit-base-patch32"
+# ---------------- Animator Builders ----------------
+def build_animator_3d():
+    ds = animator_obj["3d"]
+    attrs = ds[0].attrs
+    lons, lats, grid = create_grid(attrs)
+    return SimpleNamespace(
+        datasets=ds,
+        levels=ds[0].altitude.values,
+        lons=lons,
+        lats=lats,
+        lon_grid=grid[0],
+        lat_grid=grid[1],
     )
-    inputs = processor(
-        text=class_items,
-        images=[image],
-        return_tensors="pt",  # pytorch tensors
+
+def build_animator_2d():
+    ds = animator_obj["2d"]
+    lat_grid, lon_grid = xr.broadcast(ds[0]["latitude"], ds[0]["longitude"])
+    return SimpleNamespace(
+        datasets=ds,
+        lats=ds[0]["latitude"].values,
+        lons=ds[0]["longitude"].values,
+        lat_grid=lat_grid.values,
+        lon_grid=lon_grid.values,
     )
-    outputs = model(**inputs)
-    logits_per_image = outputs.logits_per_image
-    class_likelihoods = logits_per_image.softmax(dim=1).detach().numpy()
-    return class_likelihoods[0]
 
+# ---------------- Plot Functions ----------------
+def plot_z_level():
+    try:
+        animator = build_animator_3d()
+        out = os.path.join(MEDIA_DIR, "3D")
+        os.makedirs(out, exist_ok=True)
+        Plot_3DField_Data(animator, out, cmap_select_3d.value,
+                          threshold_slider_3d.value, zoom_slider_3d.value,
+                          fps_slider_3d.value).plot_single_z_level(
+                              Altitude_slider.value, f"ash_altitude{Altitude_slider.value}km_runTimes.gif")
+        update_media_tabs()
+        status.object = "✅ Z-Level animation created."
+    except Exception as e:
+        logging.exception("Error in plot_z_level")
+        status.object = f"❌ Error in Z-Level animation: {e}"
 
-async def process_inputs(class_names: List[str], image_url: str):
-    """
-    High level function that takes in the user inputs and returns the
-    classification results as panel objects.
-    """
+def plot_vertical_profile():
     try:
-        main.disabled = True
-        if not image_url:
-            yield "##### ⚠️ Provide an image URL"
-            return
-    
-        yield "##### ⚙ Fetching image and running model..."
-        try:
-            pil_img = await open_image_url(image_url)
-            img = pn.pane.Image(pil_img, height=400, align="center")
-        except Exception as e:
-            yield f"##### 😔 Something went wrong, please try a different URL!"
-            return
-    
-        class_items = class_names.split(",")
-        class_likelihoods = get_similarity_scores(class_items, pil_img)
-    
-        # build the results column
-        results = pn.Column("##### 🎉 Here are the results!", img)
-    
-        for class_item, class_likelihood in zip(class_items, class_likelihoods):
-            row_label = pn.widgets.StaticText(
-                name=class_item.strip(), value=f"{class_likelihood:.2%}", align="center"
-            )
-            row_bar = pn.indicators.Progress(
-                value=int(class_likelihood * 100),
-                sizing_mode="stretch_width",
-                bar_color="secondary",
-                margin=(0, 10),
-                design=pn.theme.Material,
-            )
-            results.append(pn.Column(row_label, row_bar))
-        yield results
-    finally:
-        main.disabled = False
-
-
-# create widgets
-randomize_url = pn.widgets.Button(name="Randomize URL", align="end")
-
-image_url = pn.widgets.TextInput(
-    name="Image URL to classify",
-    value=pn.bind(random_url, randomize_url),
-)
-class_names = pn.widgets.TextInput(
-    name="Comma separated class names",
-    placeholder="Enter possible class names, e.g. cat, dog",
-    value="cat, dog, parrot",
+        animator = build_animator_3d()
+        out = os.path.join(MEDIA_DIR, "3D")
+        os.makedirs(out, exist_ok=True)
+        plotter = Plot_3DField_Data(animator, out, cmap_select_3d.value, fps_slider_3d.value,
+                                    threshold_slider_3d.value, zoom_level=zoom_slider_3d.value,
+                                    basemap_type='basemap')
+        plotter.plot_vertical_profile_at_time(Altitude_slider.value - 1,
+                                              filename=f"T{Altitude_slider.value - 1}_profile.gif")
+        update_media_tabs()
+        status.object = "✅ Vertical profile animation created."
+    except Exception as e:
+        logging.exception("Error in plot_vertical_profile")
+        status.object = f"❌ Error in vertical profile animation: {e}"
+
+def animate_all_altitude_profiles():
+    try:
+        animator = build_animator_3d()
+        out = os.path.join(MEDIA_DIR, "3D")
+        Plot_3DField_Data(animator, out, cmap_select_3d.value,
+                          threshold_slider_3d.value, zoom_slider_3d.value).animate_all_altitude_profiles()
+        update_media_tabs()
+        status.object = "✅ All altitude profile animations created."
+    except Exception as e:
+        logging.exception("Error in animate_all_altitude_profiles")
+        status.object = f"❌ Error animating all altitude profiles: {e}"
+
+def export_jpg_frames():
+    try:
+        animator = build_animator_3d()
+        out = os.path.join(MEDIA_DIR, "3D")
+        Plot_3DField_Data(animator, out, cmap_select_3d.value,
+                          threshold_slider_3d.value, zoom_slider_3d.value).export_frames_as_jpgs(include_metadata=True)
+        update_media_tabs()
+        status.object = "✅ JPG frames exported."
+    except Exception as e:
+        logging.exception("Error exporting JPG frames")
+        status.object = f"❌ Error exporting JPG frames: {e}"
+
+def plot_2d_field(field):
+    try:
+        animator = build_animator_2d()
+        out = os.path.join(MEDIA_DIR, "2D")
+        Plot_Horizontal_Data(animator, out, cmap_select_2d.value, fps_slider_2d.value,
+                             include_metadata=True, threshold=threshold_slider_2d.value,
+                             zoom_width_deg=6.0, zoom_height_deg=6.0,
+                             zoom_level=zoom_slider_2d.value,
+                             static_frame_export=True).plot_single_field_over_time(field, f"{field}.gif")
+        update_media_tabs()
+        status.object = f"✅ 2D field `{field}` animation created."
+    except Exception as e:
+        logging.exception(f"Error in plot_2d_field: {field}")
+        status.object = f"❌ Error in 2D field `{field}` animation: {e}"
+
+# ---------------- Layout ----------------
+def human_readable_size(size):
+    for unit in ['B', 'KB', 'MB', 'GB']:
+        if size < 1024: return f"{size:.1f} {unit}"
+        size /= 1024
+    return f"{size:.1f} TB"
+
+def generate_output_gallery(base_folder):
+    grouped = defaultdict(lambda: defaultdict(list))
+    for root, _, files in os.walk(os.path.join(MEDIA_DIR, base_folder)):
+        for file in files:
+            ext = os.path.splitext(file)[1].lower()
+            subfolder = os.path.relpath(root, MEDIA_DIR)
+            grouped[subfolder][ext].append(os.path.join(root, file))
+
+    folder_tabs = []
+    for subfolder, ext_files in sorted(grouped.items()):
+        type_tabs = []
+        for ext, paths in sorted(ext_files.items()):
+            previews = []
+            for path in sorted(paths, key=os.path.getmtime, reverse=True):
+                size = human_readable_size(os.path.getsize(path))
+                mod = datetime.fromtimestamp(os.path.getmtime(path)).strftime("%Y-%m-%d %H:%M")
+                title = f"**{os.path.basename(path)}**\\n_{size}, {mod}_"
+                download = pn.widgets.FileDownload(label="⬇", file=path, filename=os.path.basename(path), width=60)
+                if ext in [".gif", ".png", ".jpg", ".jpeg"]:
+                    preview = pn.pane.Image(path, width=320)
+                else:
+                    with open(path, "r", errors="ignore") as f:
+                        content = f.read(2048)
+                    preview = pn.pane.PreText(content, width=320)
+                card = pn.Card(pn.pane.Markdown(title), preview, pn.Row(download), width=360)
+                previews.append(card)
+            type_tabs.append((ext.upper(), pn.GridBox(*previews, ncols=2)))
+        folder_tabs.append((subfolder, pn.Tabs(*type_tabs)))
+    return pn.Tabs(*folder_tabs)
+
+def update_media_tabs():
+    media_tab_2d.objects[:] = [generate_output_gallery("2D")]
+    media_tab_3d.objects[:] = [generate_output_gallery("3D")]
+
+media_tab_2d = pn.Column(generate_output_gallery("2D"))
+media_tab_3d = pn.Column(generate_output_gallery("3D"))
+
+media_tab = pn.Tabs(
+    ("2D Outputs", media_tab_2d),
+    ("3D Outputs", media_tab_3d)
 )
 
-input_widgets = pn.Column(
-    "##### 😊 Click randomize or paste a URL to start classifying!",
-    pn.Row(image_url, randomize_url),
-    class_names,
+tab3d = pn.Column(
+    threshold_slider_3d, zoom_slider_3d, fps_slider_3d, Altitude_slider, cmap_select_3d,
+    pn.widgets.Button(name="🎞 Generate animation at selected altitude level", button_type="primary", on_click=lambda e: tab3d.append(plot_z_level())),
+    pn.widgets.Button(name="📈 Generate vertical profile animation at time index", button_type="primary", on_click=lambda e: tab3d.append(plot_vertical_profile())),
+    pn.widgets.Button(name="📊 Generate all altitude level animations", button_type="primary", on_click=lambda e: tab3d.append(animate_all_altitude_profiles())),
+    pn.widgets.Button(name="🖼 Export all animation frames as JPG", button_type="primary", on_click=lambda e: tab3d.append(export_jpg_frames())),
 )
 
-# add interactivity
-interactive_result = pn.panel(
-    pn.bind(process_inputs, image_url=image_url, class_names=class_names),
-    height=600,
+tab2d = pn.Column(
+    threshold_slider_2d, zoom_slider_2d, fps_slider_2d, cmap_select_2d,
+    pn.widgets.Button(name="🌫 Animate Air Concentration", button_type="primary", on_click=lambda e: tab2d.append(plot_2d_field("air_concentration"))),
+    pn.widgets.Button(name="🌧 Animate Dry Deposition Rate", button_type="primary", on_click=lambda e: tab2d.append(plot_2d_field("dry_deposition_rate"))),
+    pn.widgets.Button(name="💧 Animate Wet Deposition Rate", button_type="primary", on_click=lambda e: tab2d.append(plot_2d_field("wet_deposition_rate"))),
 )
 
-# add footer
-footer_row = pn.Row(pn.Spacer(), align="center")
-for icon, url in ICON_URLS.items():
-    href_button = pn.widgets.Button(icon=icon, width=35, height=35)
-    href_button.js_on_click(code=f"window.open('{url}')")
-    footer_row.append(href_button)
-footer_row.append(pn.Spacer())
-
-# create dashboard
-main = pn.WidgetBox(
-    input_widgets,
-    interactive_result,
-    footer_row,
+tabs = pn.Tabs(
+    ("🧱 3D Field", tab3d),
+    ("🌍 2D Field", tab2d),
+    ("📁 Media Viewer", media_tab)
 )
 
-title = "Panel Demo - Image Classification"
-pn.template.BootstrapTemplate(
-    title=title,
-    main=main,
-    main_max_width="min(50%, 698px)",
-    header_background="#F08080",
-).servable(title=title)
+sidebar = pn.Column("## 🌋 NAME Ash Visualizer", file_input, process_button, reset_button, download_button, log_link, status)
+
+restore_previous_session()
+
+pn.template.FastListTemplate(
+    title="NAME Visualizer Dashboard",
+    sidebar=sidebar,
+    main=[tabs],
+).servable()

ash_animator/__init__.py

@@ -0,0 +1,12 @@
+
+# Auto-generated __init__.py to import all modules
+from .basemaps import *
+from .converter import *
+from .interpolation import *
+from .plot_3dfield_data import *
+from .plot_horizontal_data import *
+from .utils import *
+from .animation_all import *
+from .animation_single import *
+from .animation_vertical import *
+from .export import *

ash_animator/animation_all.py

@@ -0,0 +1,516 @@
+
+# import os
+# import numpy as np
+# import matplotlib.pyplot as plt
+# import matplotlib.animation as animation
+# import matplotlib.ticker as mticker
+# import cartopy.crs as ccrs
+# import cartopy.feature as cfeature
+# from adjustText import adjust_text
+# import cartopy.io.shapereader as shpreader
+# from .interpolation import interpolate_grid
+# from .basemaps import draw_etopo_basemap
+
+# def animate_all_z_levels(animator, output_folder: str, fps: int = 2, threshold: float = 0.1):
+#     os.makedirs(output_folder, exist_ok=True)
+
+#     countries_shp = shpreader.natural_earth(resolution='110m', category='cultural', name='admin_0_countries')
+#     reader = shpreader.Reader(countries_shp)
+#     country_geoms = list(reader.records())
+
+#     for z_index, z_val in enumerate(animator.levels):
+#         fig = plt.figure(figsize=(16, 7))
+#         proj = ccrs.PlateCarree()
+#         ax1 = fig.add_subplot(1, 2, 1, projection=proj)
+#         ax2 = fig.add_subplot(1, 2, 2, projection=proj)
+
+#         valid_mask = np.stack([
+#             ds['ash_concentration'].values[z_index] for ds in animator.datasets
+#         ]).max(axis=0) > 0
+#         y_idx, x_idx = np.where(valid_mask)
+
+#         if y_idx.size == 0 or x_idx.size == 0:
+#             print(f"Z level {z_val} km has no valid data. Skipping...")
+#             plt.close()
+#             continue
+
+#         y_min, y_max = y_idx.min(), y_idx.max()
+#         x_min, x_max = x_idx.min(), x_idx.max()
+
+#         buffer_y = int((y_max - y_min) * 0.5)
+#         buffer_x = int((x_max - x_min) * 0.5)
+
+#         y_start = max(0, y_min - buffer_y)
+#         y_end = min(animator.lat_grid.shape[0], y_max + buffer_y + 1)
+#         x_start = max(0, x_min - buffer_x)
+#         x_end = min(animator.lon_grid.shape[1], x_max + buffer_x + 1)
+
+#         lat_zoom = animator.lats[y_start:y_end]
+#         lon_zoom = animator.lons[x_start:x_end]
+#         lon_zoom_grid, lat_zoom_grid = np.meshgrid(lon_zoom, lat_zoom)
+
+#         valid_frames = []
+#         for t in range(len(animator.datasets)):
+#             data = animator.datasets[t]['ash_concentration'].values[z_index]
+#             interp = interpolate_grid(data, animator.lon_grid, animator.lat_grid)
+#             interp = np.where(interp < 0, np.nan, interp)
+#             if np.isfinite(interp).sum() > 0:
+#                 valid_frames.append(t)
+
+#         if not valid_frames:
+#             print(f"No valid frames for Z={z_val} km. Skipping animation.")
+#             plt.close()
+#             continue
+
+#         def update(t):
+#             ax1.clear()
+#             ax2.clear()
+
+#             data = animator.datasets[t]['ash_concentration'].values[z_index]
+#             interp = interpolate_grid(data, animator.lon_grid, animator.lat_grid)
+#             interp = np.where(interp < 0, np.nan, interp)
+#             zoom_plot = interp[y_start:y_end, x_start:x_end]
+
+#             valid_vals = interp[np.isfinite(interp)]
+#             if valid_vals.size == 0:
+#                 return []
+
+#             min_val = np.nanmin(valid_vals)
+#             max_val = np.nanmax(valid_vals)
+#             log_cutoff = 1e-3
+#             log_ratio = max_val / (min_val + 1e-6)
+#             use_log = min_val > log_cutoff and log_ratio > 100
+
+#             if use_log:
+#                 data_for_plot = np.where(interp > log_cutoff, interp, np.nan)
+#                 levels = np.logspace(np.log10(log_cutoff), np.log10(max_val), 20)
+#                 scale_label = "Hybrid Log"
+#             else:
+#                 data_for_plot = interp
+#                 levels = np.linspace(0, max_val, 20)
+#                 scale_label = "Linear"
+
+#             draw_etopo_basemap(ax1, mode='stock')
+#             draw_etopo_basemap(ax2, mode='stock')
+
+#             c1 = ax1.contourf(animator.lons, animator.lats, data_for_plot, levels=levels,
+#                             cmap="rainbow", alpha=0.6, transform=proj)
+#             ax1.contour(animator.lons, animator.lats, data_for_plot, levels=levels,
+#                         colors='black', linewidths=0.5, transform=proj)
+#             ax1.set_title(f"T{t+1} | Alt: {z_val} km (Full - {scale_label})")
+#             ax1.set_extent([animator.lons.min(), animator.lons.max(), animator.lats.min(), animator.lats.max()])
+#             ax1.coastlines()
+#             ax1.add_feature(cfeature.BORDERS, linestyle=':')
+#             ax1.add_feature(cfeature.LAND)
+#             ax1.add_feature(cfeature.OCEAN)
+
+#             c2 = ax2.contourf(lon_zoom_grid, lat_zoom_grid, zoom_plot, levels=levels,
+#                             cmap="rainbow", alpha=0.4, transform=proj)
+#             ax2.contour(lon_zoom_grid, lat_zoom_grid, zoom_plot, levels=levels,
+#                         colors='black', linewidths=0.5, transform=proj)
+#             ax2.set_title(f"T{t+1} | Alt: {z_val} km (Zoom - {scale_label})")
+#             ax2.set_extent([lon_zoom.min(), lon_zoom.max(), lat_zoom.min(), lat_zoom.max()])
+#             ax2.coastlines()
+#             ax2.add_feature(cfeature.BORDERS, linestyle=':')
+#             ax2.add_feature(cfeature.LAND)
+#             ax2.add_feature(cfeature.OCEAN)
+
+#             ax2.text(animator.lons[0], animator.lats[0], animator.country_label, fontsize=9, color='white',
+#                     transform=proj, bbox=dict(facecolor='black', alpha=0.5))
+
+#             texts_ax1, texts_ax2 = [], []
+#             for country in country_geoms:
+#                 name = country.attributes['NAME_LONG']
+#                 geom = country.geometry
+#                 try:
+#                     lon, lat = geom.centroid.x, geom.centroid.y
+#                     if (lon_zoom.min() <= lon <= lon_zoom.max()) and (lat_zoom.min() <= lat <= lat_zoom.max()):
+#                         text = ax2.text(lon, lat, name, fontsize=6, transform=proj,
+#                                         ha='center', va='center', color='white',
+#                                         bbox=dict(facecolor='black', alpha=0.5, linewidth=0))
+#                         texts_ax2.append(text)
+
+#                     if (animator.lons.min() <= lon <= animator.lons.max()) and (animator.lats.min() <= lat <= animator.lats.max()):
+#                         text = ax1.text(lon, lat, name, fontsize=6, transform=proj,
+#                                         ha='center', va='center', color='white',
+#                                         bbox=dict(facecolor='black', alpha=0.5, linewidth=0))
+#                         texts_ax1.append(text)
+#                 except:
+#                     continue
+
+#             adjust_text(texts_ax1, ax=ax1, only_move={'points': 'y', 'text': 'y'},
+#                         arrowprops=dict(arrowstyle="->", color='white', lw=0.5))
+#             adjust_text(texts_ax2, ax=ax2, only_move={'points': 'y', 'text': 'y'},
+#                         arrowprops=dict(arrowstyle="->", color='white', lw=0.5))
+
+#             if np.nanmax(valid_vals) > threshold:
+#                 alert_text = f"⚠ Exceeds {threshold} g/m³!"
+#                 for ax in [ax1, ax2]:
+#                     ax.text(0.99, 0.01, alert_text, transform=ax.transAxes,
+#                             ha='right', va='bottom', fontsize=10, color='red',
+#                             bbox=dict(facecolor='white', alpha=0.8, edgecolor='red'))
+#                 ax1.contour(animator.lons, animator.lats, interp, levels=[threshold], colors='red', linewidths=2, transform=proj)
+#                 ax2.contour(lon_zoom_grid, lat_zoom_grid, zoom_plot, levels=[threshold], colors='red', linewidths=2, transform=proj)
+
+#             if not hasattr(update, "colorbar"):
+#                 update.colorbar = fig.colorbar(c1, ax=[ax1, ax2], orientation='vertical',
+#                                             label="Ash concentration (g/m³)")
+#                 formatter = mticker.FuncFormatter(lambda x, _: f'{x:.2g}')
+#                 update.colorbar.ax.yaxis.set_major_formatter(formatter)
+#                 if use_log:
+#                     update.colorbar.ax.text(1.05, 1.02, "log scale", transform=update.colorbar.ax.transAxes,
+#                                             fontsize=9, color='gray', rotation=90, ha='left', va='bottom')
+
+#             return []
+
+#         ani = animation.FuncAnimation(fig, update, frames=valid_frames, blit=False)
+#         gif_path = os.path.join(output_folder, f"ash_T1-Tn_Z{z_index+1}.gif")
+#         ani.save(gif_path, writer='pillow', fps=fps)
+#         plt.close()
+#         print(f"✅ Saved animation for Z={z_val} km to {gif_path}")
+###################################################################################################################
+# import os
+# import numpy as np
+# import matplotlib.pyplot as plt
+# import matplotlib.animation as animation
+# import matplotlib.ticker as mticker
+# import cartopy.crs as ccrs
+# import cartopy.feature as cfeature
+# from adjustText import adjust_text
+# import cartopy.io.shapereader as shpreader
+# from .interpolation import interpolate_grid
+# from .basemaps import draw_etopo_basemap
+
+# def animate_all_z_levels(animator, output_folder: str, fps: int = 2, threshold: float = 0.1):
+#     os.makedirs(output_folder, exist_ok=True)
+
+#     countries_shp = shpreader.natural_earth(resolution='110m', category='cultural', name='admin_0_countries')
+#     reader = shpreader.Reader(countries_shp)
+#     country_geoms = list(reader.records())
+
+#     # Compute consistent zoom window across all z-levels and time frames
+#     valid_mask_all = np.zeros_like(animator.datasets[0]['ash_concentration'].values[0], dtype=bool)
+#     for ds in animator.datasets:
+#         for z in range(len(animator.levels)):
+#             valid_mask_all |= ds['ash_concentration'].values[z] > 0
+
+#     y_idx_all, x_idx_all = np.where(valid_mask_all)
+#     if y_idx_all.size == 0 or x_idx_all.size == 0:
+#         raise ValueError("No valid data found across any Z level or frame.")
+
+#     y_min, y_max = y_idx_all.min(), y_idx_all.max()
+#     x_min, x_max = x_idx_all.min(), x_idx_all.max()
+#     buffer_y = int((y_max - y_min) * 0.5)
+#     buffer_x = int((x_max - x_min) * 0.5)
+
+#     y_start = max(0, y_min - buffer_y)
+#     y_end = min(animator.lat_grid.shape[0], y_max + buffer_y + 1)
+#     x_start = max(0, x_min - buffer_x)
+#     x_end = min(animator.lon_grid.shape[1], x_max + buffer_x + 1)
+
+#     lat_zoom = animator.lats[y_start:y_end]
+#     lon_zoom = animator.lons[x_start:x_end]
+#     lon_zoom_grid, lat_zoom_grid = np.meshgrid(lon_zoom, lat_zoom)
+
+#     for z_index, z_val in enumerate(animator.levels):
+#         fig = plt.figure(figsize=(16, 7))
+#         proj = ccrs.PlateCarree()
+#         ax1 = fig.add_subplot(1, 2, 1, projection=proj)
+#         ax2 = fig.add_subplot(1, 2, 2, projection=proj)
+
+#         valid_frames = []
+#         for t in range(len(animator.datasets)):
+#             data = animator.datasets[t]['ash_concentration'].values[z_index]
+#             interp = interpolate_grid(data, animator.lon_grid, animator.lat_grid)
+#             interp = np.where(interp < 0, np.nan, interp)
+#             if np.isfinite(interp).sum() > 0:
+#                 valid_frames.append(t)
+
+#         if not valid_frames:
+#             print(f"No valid frames for Z={z_val} km. Skipping animation.")
+#             plt.close()
+#             continue
+
+#         def update(t):
+#             ax1.clear()
+#             ax2.clear()
+
+#             data = animator.datasets[t]['ash_concentration'].values[z_index]
+#             interp = interpolate_grid(data, animator.lon_grid, animator.lat_grid)
+#             interp = np.where(interp < 0, np.nan, interp)
+#             zoom_plot = interp[y_start:y_end, x_start:x_end]
+
+#             valid_vals = interp[np.isfinite(interp)]
+#             if valid_vals.size == 0:
+#                 return []
+
+#             min_val = np.nanmin(valid_vals)
+#             max_val = np.nanmax(valid_vals)
+#             log_cutoff = 1e-3
+#             log_ratio = max_val / (min_val + 1e-6)
+#             use_log = min_val > log_cutoff and log_ratio > 100
+
+#             if use_log:
+#                 data_for_plot = np.where(interp > log_cutoff, interp, np.nan)
+#                 levels = np.logspace(np.log10(log_cutoff), np.log10(max_val), 20)
+#                 scale_label = "Hybrid Log"
+#             else:
+#                 data_for_plot = interp
+#                 levels = np.linspace(0, max_val, 20)
+#                 scale_label = "Linear"
+
+#             draw_etopo_basemap(ax1, mode='stock')
+#             draw_etopo_basemap(ax2, mode='stock')
+
+#             c1 = ax1.contourf(animator.lons, animator.lats, data_for_plot, levels=levels,
+#                             cmap="rainbow", alpha=0.6, transform=proj)
+#             ax1.contour(animator.lons, animator.lats, data_for_plot, levels=levels,
+#                         colors='black', linewidths=0.5, transform=proj)
+#             ax1.set_title(f"T{t+1} | Alt: {z_val} km (Full - {scale_label})")
+#             ax1.set_extent([animator.lons.min(), animator.lons.max(), animator.lats.min(), animator.lats.max()])
+#             ax1.coastlines()
+#             ax1.add_feature(cfeature.BORDERS, linestyle=':')
+#             ax1.add_feature(cfeature.LAND)
+#             ax1.add_feature(cfeature.OCEAN)
+
+#             c2 = ax2.contourf(lon_zoom_grid, lat_zoom_grid, zoom_plot, levels=levels,
+#                             cmap="rainbow", alpha=0.4, transform=proj)
+#             ax2.contour(lon_zoom_grid, lat_zoom_grid, zoom_plot, levels=levels,
+#                         colors='black', linewidths=0.5, transform=proj)
+#             ax2.set_title(f"T{t+1} | Alt: {z_val} km (Zoom - {scale_label})")
+#             ax2.set_extent([lon_zoom.min(), lon_zoom.max(), lat_zoom.min(), lat_zoom.max()])
+#             ax2.coastlines()
+#             ax2.add_feature(cfeature.BORDERS, linestyle=':')
+#             ax2.add_feature(cfeature.LAND)
+#             ax2.add_feature(cfeature.OCEAN)
+
+#             ax2.text(animator.lons[0], animator.lats[0], animator.country_label, fontsize=9, color='white',
+#                      transform=proj, bbox=dict(facecolor='black', alpha=0.5))
+
+#             texts_ax1, texts_ax2 = [], []
+#             for country in country_geoms:
+#                 name = country.attributes['NAME_LONG']
+#                 geom = country.geometry
+#                 try:
+#                     lon, lat = geom.centroid.x, geom.centroid.y
+#                     if (lon_zoom.min() <= lon <= lon_zoom.max()) and (lat_zoom.min() <= lat <= lat_zoom.max()):
+#                         text = ax2.text(lon, lat, name, fontsize=6, transform=proj,
+#                                         ha='center', va='center', color='white',
+#                                         bbox=dict(facecolor='black', alpha=0.5, linewidth=0))
+#                         texts_ax2.append(text)
+
+#                     if (animator.lons.min() <= lon <= animator.lons.max()) and (animator.lats.min() <= lat <= animator.lats.max()):
+#                         text = ax1.text(lon, lat, name, fontsize=6, transform=proj,
+#                                         ha='center', va='center', color='white',
+#                                         bbox=dict(facecolor='black', alpha=0.5, linewidth=0))
+#                         texts_ax1.append(text)
+#                 except:
+#                     continue
+
+#             adjust_text(texts_ax1, ax=ax1, only_move={'points': 'y', 'text': 'y'},
+#                         arrowprops=dict(arrowstyle="->", color='white', lw=0.5))
+#             adjust_text(texts_ax2, ax=ax2, only_move={'points': 'y', 'text': 'y'},
+#                         arrowprops=dict(arrowstyle="->", color='white', lw=0.5))
+
+#             if np.nanmax(valid_vals) > threshold:
+#                 alert_text = f"⚠ Exceeds {threshold} g/m³!"
+#                 for ax in [ax1, ax2]:
+#                     ax.text(0.99, 0.01, alert_text, transform=ax.transAxes,
+#                             ha='right', va='bottom', fontsize=10, color='red',
+#                             bbox=dict(facecolor='white', alpha=0.8, edgecolor='red'))
+#                 ax1.contour(animator.lons, animator.lats, interp, levels=[threshold], colors='red', linewidths=2, transform=proj)
+#                 ax2.contour(lon_zoom_grid, lat_zoom_grid, zoom_plot, levels=[threshold], colors='red', linewidths=2, transform=proj)
+
+#             if not hasattr(update, "colorbar"):
+#                 update.colorbar = fig.colorbar(c1, ax=[ax1, ax2], orientation='vertical',
+#                                                label="Ash concentration (g/m³)")
+#                 formatter = mticker.FuncFormatter(lambda x, _: f'{x:.2g}')
+#                 update.colorbar.ax.yaxis.set_major_formatter(formatter)
+#                 if use_log:
+#                     update.colorbar.ax.text(1.05, 1.02, "log scale", transform=update.colorbar.ax.transAxes,
+#                                             fontsize=9, color='gray', rotation=90, ha='left', va='bottom')
+
+#             return []
+
+#         ani = animation.FuncAnimation(fig, update, frames=valid_frames, blit=False)
+#         gif_path = os.path.join(output_folder, f"ash_T1-Tn_Z{z_index+1}.gif")
+#         ani.save(gif_path, writer='pillow', fps=fps)
+#         plt.close()
+#         print(f"✅ Saved animation for Z={z_val} km to {gif_path}")
+
+
+import os
+import numpy as np
+import matplotlib.pyplot as plt
+import matplotlib.animation as animation
+import matplotlib.ticker as mticker
+import cartopy.crs as ccrs
+import cartopy.feature as cfeature
+from adjustText import adjust_text
+import cartopy.io.shapereader as shpreader
+from .interpolation import interpolate_grid
+from .basemaps import draw_etopo_basemap
+
+def animate_all_z_levels(animator, output_folder: str, fps: int = 2, threshold: float = 0.1,
+                         zoom_width_deg: float = 6.0, zoom_height_deg: float = 6.0):
+    os.makedirs(output_folder, exist_ok=True)
+
+    countries_shp = shpreader.natural_earth(resolution='110m', category='cultural', name='admin_0_countries')
+    reader = shpreader.Reader(countries_shp)
+    country_geoms = list(reader.records())
+
+    # Find the most active region (max concentration point)
+    max_conc = -np.inf
+    center_lat = center_lon = None
+    for ds in animator.datasets:
+        for z in range(len(animator.levels)):
+            data = ds['ash_concentration'].values[z]
+            if np.max(data) > max_conc:
+                max_conc = np.max(data)
+                max_idx = np.unravel_index(np.argmax(data), data.shape)
+                center_lat = animator.lat_grid[max_idx]
+                center_lon = animator.lon_grid[max_idx]
+
+    if center_lat is None or center_lon is None:
+        raise ValueError("No valid concentration found to determine zoom center.")
+
+    # Compute fixed zoom extents in lat/lon degrees
+    lon_zoom_min = center_lon - zoom_width_deg / 2
+    lon_zoom_max = center_lon + zoom_width_deg / 2
+    lat_zoom_min = center_lat - zoom_height_deg / 2
+    lat_zoom_max = center_lat + zoom_height_deg / 2
+
+    # Create zoom grids for plotting
+    lat_zoom = animator.lats[(animator.lats >= lat_zoom_min) & (animator.lats <= lat_zoom_max)]
+    lon_zoom = animator.lons[(animator.lons >= lon_zoom_min) & (animator.lons <= lon_zoom_max)]
+    lon_zoom_grid, lat_zoom_grid = np.meshgrid(lon_zoom, lat_zoom)
+
+    for z_index, z_val in enumerate(animator.levels):
+        fig = plt.figure(figsize=(16, 7))
+        proj = ccrs.PlateCarree()
+        ax1 = fig.add_subplot(1, 2, 1, projection=proj)
+        ax2 = fig.add_subplot(1, 2, 2, projection=proj)
+
+        valid_frames = []
+        for t in range(len(animator.datasets)):
+            data = animator.datasets[t]['ash_concentration'].values[z_index]
+            interp = interpolate_grid(data, animator.lon_grid, animator.lat_grid)
+            interp = np.where(interp < 0, np.nan, interp)
+            if np.isfinite(interp).sum() > 0:
+                valid_frames.append(t)
+
+        if not valid_frames:
+            print(f"No valid frames for Z={z_val} km. Skipping animation.")
+            plt.close()
+            continue
+
+        def update(t):
+            ax1.clear()
+            ax2.clear()
+
+            data = animator.datasets[t]['ash_concentration'].values[z_index]
+            interp = interpolate_grid(data, animator.lon_grid, animator.lat_grid)
+            interp = np.where(interp < 0, np.nan, interp)
+
+            # Extract zoom window from interpolated data
+            lat_idx = np.where((animator.lats >= lat_zoom_min) & (animator.lats <= lat_zoom_max))[0]
+            lon_idx = np.where((animator.lons >= lon_zoom_min) & (animator.lons <= lon_zoom_max))[0]
+            zoom_plot = interp[np.ix_(lat_idx, lon_idx)]
+
+            valid_vals = interp[np.isfinite(interp)]
+            if valid_vals.size == 0:
+                return []
+
+            min_val = np.nanmin(valid_vals)
+            max_val = np.nanmax(valid_vals)
+            log_cutoff = 1e-3
+            log_ratio = max_val / (min_val + 1e-6)
+            use_log = min_val > log_cutoff and log_ratio > 100
+
+            if use_log:
+                data_for_plot = np.where(interp > log_cutoff, interp, np.nan)
+                levels = np.logspace(np.log10(log_cutoff), np.log10(max_val), 20)
+                scale_label = "Hybrid Log"
+            else:
+                data_for_plot = interp
+                levels = np.linspace(0, max_val, 20)
+                scale_label = "Linear"
+
+            draw_etopo_basemap(ax1, mode='stock')
+            draw_etopo_basemap(ax2, mode='stock')
+
+            c1 = ax1.contourf(animator.lons, animator.lats, data_for_plot, levels=levels,
+                            cmap="rainbow", alpha=0.6, transform=proj)
+            ax1.contour(animator.lons, animator.lats, data_for_plot, levels=levels,
+                        colors='black', linewidths=0.5, transform=proj)
+            ax1.set_title(f"T{t+1} | Alt: {z_val} km (Full - {scale_label})")
+            ax1.set_extent([animator.lons.min(), animator.lons.max(), animator.lats.min(), animator.lats.max()])
+            ax1.coastlines()
+            ax1.add_feature(cfeature.BORDERS, linestyle=':')
+            ax1.add_feature(cfeature.LAND)
+            ax1.add_feature(cfeature.OCEAN)
+
+            c2 = ax2.contourf(lon_zoom_grid, lat_zoom_grid, zoom_plot, levels=levels,
+                            cmap="rainbow", alpha=0.4, transform=proj)
+            ax2.contour(lon_zoom_grid, lat_zoom_grid, zoom_plot, levels=levels,
+                        colors='black', linewidths=0.5, transform=proj)
+            ax2.set_title(f"T{t+1} | Alt: {z_val} km (Zoom - {scale_label})")
+            ax2.set_extent([lon_zoom_min, lon_zoom_max, lat_zoom_min, lat_zoom_max])
+            ax2.coastlines()
+            ax2.add_feature(cfeature.BORDERS, linestyle=':')
+            ax2.add_feature(cfeature.LAND)
+            ax2.add_feature(cfeature.OCEAN)
+
+            ax2.text(animator.lons[0], animator.lats[0], animator.country_label, fontsize=9, color='white',
+                     transform=proj, bbox=dict(facecolor='black', alpha=0.5))
+
+            texts_ax1, texts_ax2 = [], []
+            for country in country_geoms:
+                name = country.attributes['NAME_LONG']
+                geom = country.geometry
+                try:
+                    lon, lat = geom.centroid.x, geom.centroid.y
+                    if (lon_zoom_min <= lon <= lon_zoom_max) and (lat_zoom_min <= lat <= lat_zoom_max):
+                        text = ax2.text(lon, lat, name, fontsize=6, transform=proj,
+                                        ha='center', va='center', color='white',
+                                        bbox=dict(facecolor='black', alpha=0.5, linewidth=0))
+                        texts_ax2.append(text)
+
+                    if (animator.lons.min() <= lon <= animator.lons.max()) and (animator.lats.min() <= lat <= animator.lats.max()):
+                        text = ax1.text(lon, lat, name, fontsize=6, transform=proj,
+                                        ha='center', va='center', color='white',
+                                        bbox=dict(facecolor='black', alpha=0.5, linewidth=0))
+                        texts_ax1.append(text)
+                except:
+                    continue
+
+            adjust_text(texts_ax1, ax=ax1, only_move={'points': 'y', 'text': 'y'},
+                        arrowprops=dict(arrowstyle="->", color='white', lw=0.5))
+            adjust_text(texts_ax2, ax=ax2, only_move={'points': 'y', 'text': 'y'},
+                        arrowprops=dict(arrowstyle="->", color='white', lw=0.5))
+
+            if np.nanmax(valid_vals) > threshold:
+                alert_text = f"⚠ Exceeds {threshold} g/m³!"
+                for ax in [ax1, ax2]:
+                    ax.text(0.99, 0.01, alert_text, transform=ax.transAxes,
+                            ha='right', va='bottom', fontsize=10, color='red',
+                            bbox=dict(facecolor='white', alpha=0.8, edgecolor='red'))
+                ax1.contour(animator.lons, animator.lats, interp, levels=[threshold], colors='red', linewidths=2, transform=proj)
+                ax2.contour(lon_zoom_grid, lat_zoom_grid, zoom_plot, levels=[threshold], colors='red', linewidths=2, transform=proj)
+
+            if not hasattr(update, "colorbar"):
+                update.colorbar = fig.colorbar(c1, ax=[ax1, ax2], orientation='vertical',
+                                               label="Ash concentration (g/m³)")
+                formatter = mticker.FuncFormatter(lambda x, _: f'{x:.2g}')
+                update.colorbar.ax.yaxis.set_major_formatter(formatter)
+                if use_log:
+                    update.colorbar.ax.text(1.05, 1.02, "log scale", transform=update.colorbar.ax.transAxes,
+                                            fontsize=9, color='gray', rotation=90, ha='left', va='bottom')
+
+            return []
+
+        ani = animation.FuncAnimation(fig, update, frames=valid_frames, blit=False)
+        gif_path = os.path.join(output_folder, f"ash_T1-Tn_Z{z_index+1}.gif")
+        ani.save(gif_path, writer='pillow', fps=fps)
+        plt.close()
+        print(f"✅ Saved animation for Z={z_val} km to {gif_path}")

ash_animator/animation_single.py

@@ -0,0 +1,147 @@
+
+import os
+import numpy as np
+import matplotlib.pyplot as plt
+import matplotlib.animation as animation
+import matplotlib.ticker as mticker
+import cartopy.crs as ccrs
+import cartopy.feature as cfeature
+from .interpolation import interpolate_grid
+from .basemaps import draw_etopo_basemap
+
+def animate_single_z_level(animator, z_km: float, output_path: str, fps: int = 2, include_metadata: bool = True, threshold: float = 0.1):
+    if z_km not in animator.levels:
+        print(f"Z level {z_km} km not found in dataset.")
+        return
+
+    z_index = np.where(animator.levels == z_km)[0][0]
+    fig = plt.figure(figsize=(16, 7))
+    proj = ccrs.PlateCarree()
+    ax1 = fig.add_subplot(1, 2, 1, projection=proj)
+    ax2 = fig.add_subplot(1, 2, 2, projection=proj)
+
+    meta = animator.datasets[0].attrs
+    legend_text = (
+        f"Run name:         {meta.get('run_name', 'N/A')}\n"
+        f"Run time:         {meta.get('run_time', 'N/A')}\n"
+        f"Met data:         {meta.get('met_data', 'N/A')}\n"
+        f"Start release:    {meta.get('start_of_release', 'N/A')}\n"
+        f"End release:      {meta.get('end_of_release', 'N/A')}\n"
+        f"Source strength:  {meta.get('source_strength', 'N/A')} g/s\n"
+        f"Release loc:      {meta.get('release_location', 'N/A')}\n"
+        f"Release height:   {meta.get('release_height', 'N/A')} m asl\n"
+        f"Run duration:     {meta.get('run_duration', 'N/A')}"
+    )
+
+    valid_mask = np.stack([
+        ds['ash_concentration'].values[z_index] for ds in animator.datasets
+    ]).max(axis=0) > 0
+    y_idx, x_idx = np.where(valid_mask)
+
+    if y_idx.size == 0 or x_idx.size == 0:
+        print(f"Z level {z_km} km has no valid data. Skipping...")
+        plt.close()
+        return
+
+    y_min, y_max = y_idx.min(), y_idx.max()
+    x_min, x_max = x_idx.min(), x_idx.max()
+    buffer_y = int((y_max - y_min) * 0.5)
+    buffer_x = int((x_max - x_min) * 0.5)
+    y_start = max(0, y_min - buffer_y)
+    y_end = min(animator.lat_grid.shape[0], y_max + buffer_y + 1)
+    x_start = max(0, x_min - buffer_x)
+    x_end = min(animator.lon_grid.shape[1], x_max + buffer_x + 1)
+
+    lat_zoom = animator.lats[y_start:y_end]
+    lon_zoom = animator.lons[x_start:x_end]
+    lon_zoom_grid, lat_zoom_grid = np.meshgrid(lon_zoom, lat_zoom)
+
+    valid_frames = []
+    for t in range(len(animator.datasets)):
+        interp = interpolate_grid(animator.datasets[t]['ash_concentration'].values[z_index],
+                                  animator.lon_grid, animator.lat_grid)
+        if np.isfinite(interp).sum() > 0:
+            valid_frames.append(t)
+
+    if not valid_frames:
+        print(f"No valid frames for Z={z_km} km. Skipping animation.")
+        plt.close()
+        return
+
+    def update(t):
+        ax1.clear()
+        ax2.clear()
+
+        data = animator.datasets[t]['ash_concentration'].values[z_index]
+        interp = interpolate_grid(data, animator.lon_grid, animator.lat_grid)
+        interp = np.where(interp < 0, np.nan, interp)
+        zoom_plot = interp[y_start:y_end, x_start:x_end]
+
+        valid_vals = interp[np.isfinite(interp)]
+        if valid_vals.size == 0:
+            return []
+
+        min_val = np.nanmin(valid_vals)
+        max_val = np.nanmax(valid_vals)
+        log_cutoff = 1e-3
+        use_log = min_val > log_cutoff and (max_val / (min_val + 1e-6)) > 100
+
+        levels = np.logspace(np.log10(log_cutoff), np.log10(max_val), 20) if use_log else np.linspace(0, max_val, 20)
+        data_for_plot = np.where(interp > log_cutoff, interp, 0) if use_log else interp
+        scale_label = "Log" if use_log else "Linear"
+
+        draw_etopo_basemap(ax1, mode='stock')
+        draw_etopo_basemap(ax2, mode='stock')
+
+        c1 = ax1.contourf(animator.lons, animator.lats, data_for_plot, levels=levels,
+                        cmap="rainbow", alpha=0.6, transform=proj)
+        ax1.set_title(f"T{t+1} | Alt: {z_km} km (Full - {scale_label})")
+        ax1.set_extent([animator.lons.min(), animator.lons.max(), animator.lats.min(), animator.lats.max()])
+        ax1.coastlines(); ax1.add_feature(cfeature.BORDERS); ax1.add_feature(cfeature.LAND); ax1.add_feature(cfeature.OCEAN)
+
+        c2 = ax2.contourf(lon_zoom_grid, lat_zoom_grid, zoom_plot, levels=levels,
+                        cmap="rainbow", alpha=0.6, transform=proj)
+        ax2.set_title(f"T{t+1} | Alt: {z_km} km (Zoom - {scale_label})")
+        ax2.set_extent([lon_zoom.min(), lon_zoom.max(), lat_zoom.min(), lat_zoom.max()])
+        ax2.coastlines(); ax2.add_feature(cfeature.BORDERS); ax2.add_feature(cfeature.LAND); ax2.add_feature(cfeature.OCEAN)
+
+        if not hasattr(update, "colorbar"):
+            update.colorbar = fig.colorbar(c1, ax=[ax1, ax2], orientation='vertical',
+                                        label="Ash concentration (g/m³)")
+            formatter = mticker.FuncFormatter(lambda x, _: f'{x:.2g}')
+            update.colorbar.ax.yaxis.set_major_formatter(formatter)
+            if use_log:
+                update.colorbar.ax.text(1.05, 1.02, "log scale", transform=update.colorbar.ax.transAxes,
+                                        fontsize=9, color='gray', rotation=90, ha='left', va='bottom')
+
+        if include_metadata:
+            ax1.annotate(legend_text, xy=(0.75, 0.99), xycoords='axes fraction',
+                        fontsize=8, ha='left', va='top',
+                        bbox=dict(boxstyle="round", facecolor="white", edgecolor="gray"))
+            for ax in [ax1, ax2]:
+                ax.text(0.01, 0.01,
+                        f"Source: NAME\nRes: {animator.x_res:.2f}°\n{meta.get('run_name', 'N/A')}",
+                        transform=ax.transAxes, fontsize=8, color='white',
+                        bbox=dict(facecolor='black', alpha=0.5))
+
+        for ax in [ax1, ax2]:
+            ax.text(0.01, 0.98, f"Time step T{t+1}", transform=ax.transAxes,
+                    fontsize=9, color='white', va='top', ha='left',
+                    bbox=dict(facecolor='black', alpha=0.4, boxstyle='round'))
+
+        if np.nanmax(valid_vals) > threshold:
+            alert_text = f"⚠ Exceeds {threshold} g/m³!"
+            for ax in [ax1, ax2]:
+                ax.text(0.99, 0.01, alert_text, transform=ax.transAxes,
+                        ha='right', va='bottom', fontsize=10, color='red',
+                        bbox=dict(facecolor='white', alpha=0.8, edgecolor='red'))
+            ax1.contour(animator.lons, animator.lats, interp, levels=[threshold], colors='red', linewidths=2, transform=proj)
+            ax2.contour(lon_zoom_grid, lat_zoom_grid, zoom_plot, levels=[threshold], colors='red', linewidths=2, transform=proj)
+
+        return []
+
+    ani = animation.FuncAnimation(fig, update, frames=valid_frames, blit=False)
+    os.makedirs(os.path.dirname(output_path), exist_ok=True)
+    ani.save(output_path, writer='pillow', fps=fps)
+    plt.close()
+    print(f"✅ Saved animation for Z={z_km} km to {output_path}")

ash_animator/animation_vertical.py

@@ -0,0 +1,360 @@
+
+import os
+import numpy as np
+import matplotlib.pyplot as plt
+import matplotlib.animation as animation
+import matplotlib.ticker as mticker
+import cartopy.crs as ccrs
+import cartopy.feature as cfeature
+import cartopy.io.shapereader as shpreader
+from .interpolation import interpolate_grid
+from .basemaps import draw_etopo_basemap
+
+# def animate_vertical_profile(animator, t_index: int, output_path: str, fps: int = 2, include_metadata: bool = True, threshold: float = 0.1):
+#     if not (0 <= t_index < len(animator.datasets)):
+#         print(f"Invalid time index {t_index}. Must be between 0 and {len(animator.datasets) - 1}.")
+#         return
+
+#     ds = animator.datasets[t_index]
+#     fig = plt.figure(figsize=(16, 7))
+#     proj = ccrs.PlateCarree()
+#     ax1 = fig.add_subplot(1, 2, 1, projection=proj)
+#     ax2 = fig.add_subplot(1, 2, 2, projection=proj)
+
+#     meta = ds.attrs
+#     legend_text = (
+#         f"Run name:         {meta.get('run_name', 'N/A')}\n"
+#         f"Run time:         {meta.get('run_time', 'N/A')}\n"
+#         f"Met data:         {meta.get('met_data', 'N/A')}\n"
+#         f"Start release:    {meta.get('start_of_release', 'N/A')}\n"
+#         f"End release:      {meta.get('end_of_release', 'N/A')}\n"
+#         f"Source strength:  {meta.get('source_strength', 'N/A')} g/s\n"
+#         f"Release loc:      {meta.get('release_location', 'N/A')}\n"
+#         f"Release height:   {meta.get('release_height', 'N/A')} m asl\n"
+#         f"Run duration:     {meta.get('run_duration', 'N/A')}"
+#     )
+
+#     valid_mask = np.stack([ds['ash_concentration'].values[z] for z in range(len(animator.levels))]).max(axis=0) > 0
+#     y_idx, x_idx = np.where(valid_mask)
+
+#     if y_idx.size == 0 or x_idx.size == 0:
+#         print(f"No valid data found for time T{t_index+1}. Skipping...")
+#         plt.close()
+#         return
+
+#     y_min, y_max = y_idx.min(), y_idx.max()
+#     x_min, x_max = x_idx.min(), x_idx.max()
+#     buffer_y = int((y_max - y_min) * 0.1)
+#     buffer_x = int((x_max - x_min) * 0.1)
+#     y_start = max(0, y_min - buffer_y)
+#     y_end = min(animator.lat_grid.shape[0], y_max + buffer_y + 1)
+#     x_start = max(0, x_min - buffer_x)
+#     x_end = min(animator.lon_grid.shape[1], x_max + buffer_x + 1)
+
+#     lat_zoom = animator.lats[y_start:y_end]
+#     lon_zoom = animator.lons[x_start:x_end]
+#     lon_zoom_grid, lat_zoom_grid = np.meshgrid(lon_zoom, lat_zoom)
+
+#     z_indices_with_data = []
+#     for z_index in range(len(animator.levels)):
+#         data = ds['ash_concentration'].values[z_index]
+#         interp = interpolate_grid(data, animator.lon_grid, animator.lat_grid)
+#         if np.isfinite(interp).sum() > 0:
+#             z_indices_with_data.append(z_index)
+
+#     if not z_indices_with_data:
+#         print(f"No valid Z-levels at time T{t_index+1}.")
+#         plt.close()
+#         return
+
+#     def update(z_index):
+#         ax1.clear()
+#         ax2.clear()
+
+#         data = ds['ash_concentration'].values[z_index]
+#         interp = interpolate_grid(data, animator.lon_grid, animator.lat_grid)
+#         interp = np.where(interp < 0, np.nan, interp)
+#         zoom_plot = interp[y_start:y_end, x_start:x_end]
+
+#         valid_vals = interp[np.isfinite(interp)]
+#         if valid_vals.size == 0:
+#             return []
+
+#         min_val = np.nanmin(valid_vals)
+#         max_val = np.nanmax(valid_vals)
+#         log_cutoff = 1e-3
+#         use_log = min_val > log_cutoff and (max_val / (min_val + 1e-6)) > 100
+
+#         levels = np.logspace(np.log10(log_cutoff), np.log10(max_val), 20) if use_log else np.linspace(0, max_val, 20)
+#         data_for_plot = np.where(interp > log_cutoff, interp, 0) if use_log else interp
+#         scale_label = "Log" if use_log else "Linear"
+
+#         draw_etopo_basemap(ax1, mode='stock')
+#         draw_etopo_basemap(ax2, mode='stock')
+
+#         c1 = ax1.contourf(animator.lons, animator.lats, data_for_plot, levels=levels,
+#                         cmap="rainbow", alpha=0.6, transform=proj)
+#         ax1.set_title(f"T{t_index+1} | Alt: {animator.levels[z_index]} km (Full - {scale_label})")
+#         ax1.set_extent([animator.lons.min(), animator.lons.max(), animator.lats.min(), animator.lats.max()])
+#         ax1.coastlines(); ax1.add_feature(cfeature.BORDERS, linestyle=':')
+#         ax1.add_feature(cfeature.LAND); ax1.add_feature(cfeature.OCEAN)
+
+#         c2 = ax2.contourf(lon_zoom_grid, lat_zoom_grid, zoom_plot, levels=levels,
+#                         cmap="rainbow", alpha=0.6, transform=proj)
+#         ax2.set_title(f"T{t_index+1} | Alt: {animator.levels[z_index]} km (Zoom - {scale_label})")
+#         ax2.set_extent([lon_zoom.min(), lon_zoom.max(), lat_zoom.min(), lat_zoom.max()])
+#         ax2.coastlines(); ax2.add_feature(cfeature.BORDERS, linestyle=':')
+#         ax2.add_feature(cfeature.LAND); ax2.add_feature(cfeature.OCEAN)
+
+#         for ax in [ax1, ax2]:
+#             ax.text(0.01, 0.98, f"Altitude: {animator.levels[z_index]:.2f} km", transform=ax.transAxes,
+#                     fontsize=9, color='white', va='top', ha='left',
+#                     bbox=dict(facecolor='black', alpha=0.4, boxstyle='round'))
+
+#             if include_metadata:
+#                 ax.text(0.01, 0.01,
+#                         f"Source: NAME\nRes: {animator.x_res:.2f}°\n{meta.get('run_name', 'N/A')}",
+#                         transform=ax.transAxes, fontsize=8, color='white',
+#                         bbox=dict(facecolor='black', alpha=0.5))
+
+#         if np.nanmax(valid_vals) > threshold:
+#             for ax in [ax1, ax2]:
+#                 ax.text(0.99, 0.01, f"⚠ Exceeds {threshold} g/m³!", transform=ax.transAxes,
+#                         ha='right', va='bottom', fontsize=10, color='red',
+#                         bbox=dict(facecolor='white', alpha=0.8, edgecolor='red'))
+#             ax1.contour(animator.lons, animator.lats, interp, levels=[threshold], colors='red', linewidths=2, transform=proj)
+#             ax2.contour(lon_zoom_grid, lat_zoom_grid, zoom_plot, levels=[threshold], colors='red', linewidths=2, transform=proj)
+
+#         if include_metadata and not hasattr(update, "legend_text"):
+#             ax1.annotate(legend_text, xy=(0.75, 0.99), xycoords='axes fraction',
+#                         fontsize=8, ha='left', va='top',
+#                         bbox=dict(boxstyle="round", facecolor="white", edgecolor="gray"))
+
+#         if not hasattr(update, "colorbar"):
+#             update.colorbar = fig.colorbar(c1, ax=[ax1, ax2], orientation='vertical',
+#                                         label="Ash concentration (g/m³)")
+#             formatter = mticker.FuncFormatter(lambda x, _: f'{x:.2g}')
+#             update.colorbar.ax.yaxis.set_major_formatter(formatter)
+
+#             if use_log:
+#                 update.colorbar.ax.text(1.05, 1.02, "log scale", transform=update.colorbar.ax.transAxes,
+#                                         fontsize=9, color='gray', rotation=90, ha='left', va='bottom')
+
+#         return []
+
+#     os.makedirs(os.path.dirname(output_path), exist_ok=True)
+#     ani = animation.FuncAnimation(fig, update, frames=z_indices_with_data, blit=False)
+#     ani.save(output_path, writer='pillow', fps=fps)
+#     plt.close()
+#     print(f"✅ Saved vertical profile animation for T{t_index+1} to {output_path}")
+
+# def animate_all_vertical_profiles(animator, output_folder: str, fps: int = 2, include_metadata: bool = True, threshold: float = 0.1):
+#     os.makedirs(output_folder, exist_ok=True)
+#     for t_index in range(len(animator.datasets)):
+#         output_path = os.path.join(output_folder, f"vertical_T{t_index+1:02d}.gif")
+#         print(f"🔄 Generating vertical profile animation for T{t_index+1}...")
+#         animate_vertical_profile(animator, t_index, output_path, fps, include_metadata, threshold)
+
+import os
+import numpy as np
+import matplotlib.pyplot as plt
+import matplotlib.animation as animation
+import matplotlib.ticker as mticker
+import cartopy.crs as ccrs
+import cartopy.feature as cfeature
+import cartopy.io.shapereader as shpreader
+from .interpolation import interpolate_grid
+from .basemaps import draw_etopo_basemap
+from adjustText import adjust_text
+
+def animate_vertical_profile(animator, t_index: int, output_path: str, fps: int = 2,
+                             include_metadata: bool = True, threshold: float = 0.1,
+                             zoom_width_deg: float = 6.0, zoom_height_deg: float = 6.0):
+    if not (0 <= t_index < len(animator.datasets)):
+        print(f"Invalid time index {t_index}. Must be between 0 and {len(animator.datasets) - 1}.")
+        return
+
+    countries_shp = shpreader.natural_earth(resolution='110m', category='cultural', name='admin_0_countries')
+    reader = shpreader.Reader(countries_shp)
+    country_geoms = list(reader.records())
+   
+    ds = animator.datasets[t_index]
+    fig = plt.figure(figsize=(18, 7))  # Wider for metadata outside
+    proj = ccrs.PlateCarree()
+    ax1 = fig.add_subplot(1, 2, 1, projection=proj)
+    ax2 = fig.add_subplot(1, 2, 2, projection=proj)
+
+    meta = ds.attrs
+    legend_text = (
+        f"Run name:         {meta.get('run_name', 'N/A')}\n"
+        f"Run time:         {meta.get('run_time', 'N/A')}\n"
+        f"Met data:         {meta.get('met_data', 'N/A')}\n"
+        f"Start release:    {meta.get('start_of_release', 'N/A')}\n"
+        f"End release:      {meta.get('end_of_release', 'N/A')}\n"
+        f"Source strength:  {meta.get('source_strength', 'N/A')} g/s\n"
+        f"Release loc:      {meta.get('release_location', 'N/A')}\n"
+        f"Release height:   {meta.get('release_height', 'N/A')} m asl\n"
+        f"Run duration:     {meta.get('run_duration', 'N/A')}"
+    )
+
+    # 🔍 Find most active point at this time step
+    max_conc = -np.inf
+    center_lat = center_lon = None
+    for z in range(len(animator.levels)):
+        data = ds['ash_concentration'].values[z]
+        if np.max(data) > max_conc:
+            max_conc = np.max(data)
+            max_idx = np.unravel_index(np.argmax(data), data.shape)
+            center_lat = animator.lat_grid[max_idx]
+            center_lon = animator.lon_grid[max_idx]
+
+    if center_lat is None or center_lon is None:
+        print(f"No valid data found for time T{t_index+1}. Skipping...")
+        plt.close()
+        return
+
+    # 🌍 Define fixed zoom extents
+    lon_zoom_min = center_lon - zoom_width_deg / 2
+    lon_zoom_max = center_lon + zoom_width_deg / 2
+    lat_zoom_min = center_lat - zoom_height_deg / 2
+    lat_zoom_max = center_lat + zoom_height_deg / 2
+
+    lat_zoom = animator.lats[(animator.lats >= lat_zoom_min) & (animator.lats <= lat_zoom_max)]
+    lon_zoom = animator.lons[(animator.lons >= lon_zoom_min) & (animator.lons <= lon_zoom_max)]
+    lon_zoom_grid, lat_zoom_grid = np.meshgrid(lon_zoom, lat_zoom)
+
+    z_indices_with_data = []
+    for z_index in range(len(animator.levels)):
+        data = ds['ash_concentration'].values[z_index]
+        interp = interpolate_grid(data, animator.lon_grid, animator.lat_grid)
+        if np.isfinite(interp).sum() > 0:
+            z_indices_with_data.append(z_index)
+
+    if not z_indices_with_data:
+        print(f"No valid Z-levels at time T{t_index+1}.")
+        plt.close()
+        return
+
+    def update(z_index):
+        ax1.clear()
+        ax2.clear()
+
+        data = ds['ash_concentration'].values[z_index]
+        interp = interpolate_grid(data, animator.lon_grid, animator.lat_grid)
+        interp = np.where(interp < 0, np.nan, interp)
+
+        lat_idx = np.where((animator.lats >= lat_zoom_min) & (animator.lats <= lat_zoom_max))[0]
+        lon_idx = np.where((animator.lons >= lon_zoom_min) & (animator.lons <= lon_zoom_max))[0]
+        zoom_plot = interp[np.ix_(lat_idx, lon_idx)]
+
+        valid_vals = interp[np.isfinite(interp)]
+        if valid_vals.size == 0:
+            return []
+
+        min_val = np.nanmin(valid_vals)
+        max_val = np.nanmax(valid_vals)
+        log_cutoff = 1e-3
+        use_log = min_val > log_cutoff and (max_val / (min_val + 1e-6)) > 100
+
+        levels = np.logspace(np.log10(log_cutoff), np.log10(max_val), 20) if use_log else np.linspace(0, max_val, 20)
+        data_for_plot = np.where(interp > log_cutoff, interp, 0) if use_log else interp
+        scale_label = "Log" if use_log else "Linear"
+
+        draw_etopo_basemap(ax1, mode='stock')
+        draw_etopo_basemap(ax2, mode='stock')
+
+        c1 = ax1.contourf(animator.lons, animator.lats, data_for_plot, levels=levels,
+                          cmap="rainbow", alpha=0.6, transform=proj)
+        ax1.set_title(f"T{t_index+1} | Alt: {animator.levels[z_index]} km (Full - {scale_label})")
+        ax1.set_extent([animator.lons.min(), animator.lons.max(), animator.lats.min(), animator.lats.max()])
+        ax1.coastlines(); ax1.add_feature(cfeature.BORDERS, linestyle=':')
+        ax1.add_feature(cfeature.LAND); ax1.add_feature(cfeature.OCEAN)
+
+        c2 = ax2.contourf(lon_zoom_grid, lat_zoom_grid, zoom_plot, levels=levels,
+                          cmap="rainbow", alpha=0.6, transform=proj)
+        ax2.set_title(f"T{t_index+1} | Alt: {animator.levels[z_index]} km (Zoom - {scale_label})")
+        ax2.set_extent([lon_zoom_min, lon_zoom_max, lat_zoom_min, lat_zoom_max])
+        ax2.coastlines(); ax2.add_feature(cfeature.BORDERS, linestyle=':')
+        ax2.add_feature(cfeature.LAND); ax2.add_feature(cfeature.OCEAN)
+
+        for ax in [ax1, ax2]:
+            ax.text(0.01, 0.98, f"Altitude: {animator.levels[z_index]:.2f} km", transform=ax.transAxes,
+                    fontsize=9, color='white', va='top', ha='left',
+                    bbox=dict(facecolor='black', alpha=0.4, boxstyle='round'))
+
+        if include_metadata:
+            fig.text(0.50, 0.1, legend_text, va='center', ha='left', fontsize=8,
+                     bbox=dict(facecolor='white', alpha=0.8, edgecolor='gray'),
+                     transform=fig.transFigure)
+
+        if np.nanmax(valid_vals) > threshold:
+            for ax in [ax1, ax2]:
+                ax.text(0.99, 0.01, f"⚠ Exceeds {threshold} g/m³!", transform=ax.transAxes,
+                        ha='right', va='bottom', fontsize=10, color='red',
+                        bbox=dict(facecolor='white', alpha=0.8, edgecolor='red'))
+            ax1.contour(animator.lons, animator.lats, interp, levels=[threshold], colors='red', linewidths=2, transform=proj)
+            ax2.contour(lon_zoom_grid, lat_zoom_grid, zoom_plot, levels=[threshold], colors='red', linewidths=2, transform=proj)
+
+        if not hasattr(update, "colorbar"):
+            update.colorbar = fig.colorbar(c1, ax=[ax1, ax2], orientation='vertical',
+                                           label="Ash concentration (g/m³)", shrink=0.75)
+            formatter = mticker.FuncFormatter(lambda x, _: f'{x:.2g}')
+            update.colorbar.ax.yaxis.set_major_formatter(formatter)
+
+            if use_log:
+                update.colorbar.ax.text(1.05, 1.02, "log scale", transform=update.colorbar.ax.transAxes,
+                                        fontsize=9, color='gray', rotation=90, ha='left', va='bottom')
+
+        ######################3
+        
+            
+        texts_ax1, texts_ax2 = [], []
+        for country in country_geoms:
+            name = country.attributes['NAME_LONG']
+            geom = country.geometry
+            try:
+                lon, lat = geom.centroid.x, geom.centroid.y
+                if (lon_zoom_min <= lon <= lon_zoom_max) and (lat_zoom_min <= lat <= lat_zoom_max):
+                    text = ax2.text(lon, lat, name, fontsize=6, transform=proj,
+                                    ha='center', va='center', color='white',
+                                    bbox=dict(facecolor='black', alpha=0.5, linewidth=0))
+                    texts_ax2.append(text)
+
+                if (animator.lons.min() <= lon <= animator.lons.max()) and (animator.lats.min() <= lat <= animator.lats.max()):
+                    text = ax1.text(lon, lat, name, fontsize=6, transform=proj,
+                                    ha='center', va='center', color='white',
+                                    bbox=dict(facecolor='black', alpha=0.5, linewidth=0))
+                    texts_ax1.append(text)
+            except:
+                continue
+
+        adjust_text(texts_ax1, ax=ax1, only_move={'points': 'y', 'text': 'y'},
+                    arrowprops=dict(arrowstyle="->", color='white', lw=0.5))
+        adjust_text(texts_ax2, ax=ax2, only_move={'points': 'y', 'text': 'y'},
+                    arrowprops=dict(arrowstyle="->", color='white', lw=0.5))
+        
+            
+            ############################################
+        
+        
+        
+        
+        return []
+
+    os.makedirs(os.path.dirname(output_path), exist_ok=True)
+    ani = animation.FuncAnimation(fig, update, frames=z_indices_with_data, blit=False)
+    ani.save(output_path, writer='pillow', fps=fps)
+    plt.close()
+    print(f"✅ Saved vertical profile animation for T{t_index+1} to {output_path}")
+
+
+def animate_all_vertical_profiles(animator, output_folder: str, fps: int = 2,
+                                  include_metadata: bool = True, threshold: float = 0.1,
+                                  zoom_width_deg: float = 10.0, zoom_height_deg: float = 6.0):
+    os.makedirs(output_folder, exist_ok=True)
+    for t_index in range(len(animator.datasets)):
+        output_path = os.path.join(output_folder, f"vertical_T{t_index+1:02d}.gif")
+        print(f"🔄 Generating vertical profile animation for T{t_index+1}...")
+        animate_vertical_profile(animator, t_index, output_path, fps,
+                                 include_metadata, threshold,
+                                 zoom_width_deg, zoom_height_deg)

ash_animator/basemaps.py

@@ -0,0 +1,131 @@
+
+# import contextily as ctx
+# from mpl_toolkits.basemap import Basemap
+# import cartopy.crs as ccrs
+# import cartopy.feature as cfeature
+
+# def draw_etopo_basemap(ax, mode="basemap", zoom=7):
+#     try:
+#         if mode == "stock":
+#             ax.stock_img()
+#         elif mode == "contextily":
+#             extent = ax.get_extent(ccrs.PlateCarree())
+#             ax.set_extent(extent, crs=ccrs.PlateCarree())
+#             ctx.add_basemap(ax, crs=ccrs.PlateCarree(), source=ctx.providers.CartoDB.Voyager, zoom=zoom)
+#         elif mode == "basemap":
+#             extent = ax.get_extent(ccrs.PlateCarree())
+#             m = Basemap(projection='cyl',
+#                         llcrnrlon=extent[0], urcrnrlon=extent[1],
+#                         llcrnrlat=extent[2], urcrnrlat=extent[3],
+#                         resolution='h', ax=ax)
+#             m.shadedrelief()
+#             m.drawcoastlines(linewidth=0.5)
+#             m.drawcountries(linewidth=0.7)
+#             m.drawmapboundary()
+#         else:
+#             raise ValueError(f"Unsupported basemap mode: {mode}")
+#     except Exception as e:
+#         print(f"[Relief Error - {mode} mode]:", e)
+#         ax.add_feature(cfeature.LAND)
+#         ax.add_feature(cfeature.OCEAN)
+
+import os
+import hashlib
+import contextily as ctx
+from mpl_toolkits.basemap import Basemap
+import cartopy.crs as ccrs
+import cartopy.feature as cfeature
+from PIL import Image
+import matplotlib.pyplot as plt
+
+# Define cache directories
+# Optional: Set tile cache directory (must be done before contextily downloads tiles)
+os.environ["XDG_CACHE_HOME"] = os.path.expanduser("~/.contextily_cache")
+
+CTX_TILE_CACHE_DIR = os.path.expanduser("~/.contextily_cache")
+BASEMAP_TILE_CACHE_DIR = os.path.expanduser("~/.basemap_cache")
+
+os.makedirs(CTX_TILE_CACHE_DIR, exist_ok=True)
+os.makedirs(BASEMAP_TILE_CACHE_DIR, exist_ok=True)
+
+def draw_etopo_basemap(ax, mode="basemap", zoom=11):
+    """
+    Draws a high-resolution basemap background on the provided Cartopy GeoAxes.
+
+    Parameters
+    ----------
+    ax : matplotlib.axes._subplots.AxesSubplot
+        The matplotlib Axes object (with Cartopy projection) to draw the map background on.
+
+    mode : str, optional
+        The basemap mode to use:
+        - "stock": Default stock image from Cartopy.
+        - "contextily": Web tile background (CartoDB Voyager), with caching.
+        - "basemap": High-resolution shaded relief using Basemap, with caching.
+        Default is "basemap".
+
+    zoom : int, optional
+        Tile zoom level (only for "contextily"). Higher = more detail. Default is 7.
+
+    Notes
+    -----
+    - Uses high resolution for Basemap (resolution='h') and saves figure at 300 DPI.
+    - Cached images are reused using extent-based hashing to avoid re-rendering.
+    - Basemap is deprecated; Cartopy with web tiles is recommended for new projects.
+    """
+    try:
+        if mode == "stock":
+            ax.stock_img()
+
+        elif mode == "contextily":
+            extent = ax.get_extent(crs=ccrs.PlateCarree())
+            ax.set_extent(extent, crs=ccrs.PlateCarree())
+            ctx.add_basemap(
+                ax,
+                crs=ccrs.PlateCarree(),
+                source=ctx.providers.CartoDB.Voyager,
+                zoom=zoom                
+            )
+
+        elif mode == "basemap":
+            extent = ax.get_extent(crs=ccrs.PlateCarree())
+
+            # Create a hash key for this extent
+            extent_str = f"{extent[0]:.4f}_{extent[1]:.4f}_{extent[2]:.4f}_{extent[3]:.4f}"
+            cache_key = hashlib.md5(extent_str.encode()).hexdigest()
+            cache_file = os.path.join(BASEMAP_TILE_CACHE_DIR, f"{cache_key}_highres.png")
+
+            if os.path.exists(cache_file):
+                img = Image.open(cache_file)
+                ax.imshow(img, extent=extent, transform=ccrs.PlateCarree())
+            else:
+                # Create a high-resolution temporary figure
+                temp_fig, temp_ax = plt.subplots(figsize=(12, 9),
+                                                 subplot_kw={'projection': ccrs.PlateCarree()})
+                temp_ax.set_extent(extent, crs=ccrs.PlateCarree())
+
+                m = Basemap(projection='cyl',
+                            llcrnrlon=extent[0], urcrnrlon=extent[1],
+                            llcrnrlat=extent[2], urcrnrlat=extent[3],
+                            resolution='f', ax=temp_ax)  # 'h' = high resolution
+
+                m.shadedrelief()
+                # m.drawcoastlines(linewidth=0.1)
+                # m.drawcountries(linewidth=0.1)
+                # m.drawmapboundary()
+
+                # Save high-DPI figure for clarity
+                temp_fig.savefig(cache_file, dpi=300, bbox_inches='tight', pad_inches=0)
+                plt.close(temp_fig)
+
+                # Load and display the cached image
+                img = Image.open(cache_file)
+                ax.imshow(img, extent=extent, transform=ccrs.PlateCarree())
+
+        else:
+            raise ValueError(f"Unsupported basemap mode: {mode}")
+
+    except Exception as e:
+        print(f"[Relief Error - {mode} mode]:", e)
+        ax.add_feature(cfeature.LAND)
+        ax.add_feature(cfeature.OCEAN)

ash_animator/converter.py

@@ -0,0 +1,414 @@
+# # Full updated and corrected version of NAMEDataConverter with sanitized metadata keys
+
+# import os
+# import re
+# import zipfile
+# import shutil
+# import numpy as np
+# import xarray as xr
+# import matplotlib.pyplot as plt
+# import matplotlib.animation as animation
+# from typing import List, Tuple
+
+# class NAMEDataConverter:
+#     def __init__(self, output_dir: str):
+#         self.output_dir = output_dir
+#         os.makedirs(self.output_dir, exist_ok=True)
+
+#     def _sanitize_key(self, key: str) -> str:
+#         # Replace non-alphanumeric characters with underscores, and ensure it starts with a letter
+#         key = re.sub(r'\W+', '_', key)
+#         if not key[0].isalpha():
+#             key = f"attr_{key}"
+#         return key
+
+#     def _parse_metadata(self, lines: List[str]) -> dict:
+#         metadata = {}
+#         for line in lines:
+#             if ":" in line:
+#                 key, value = line.split(":", 1)
+#                 clean_key = self._sanitize_key(key.strip().lower())
+#                 metadata[clean_key] = value.strip()
+
+#         try:
+#             metadata.update({
+#                 "x_origin": float(metadata["x_grid_origin"]),
+#                 "y_origin": float(metadata["y_grid_origin"]),
+#                 "x_size": int(metadata["x_grid_size"]),
+#                 "y_size": int(metadata["y_grid_size"]),
+#                 "x_res": float(metadata["x_grid_resolution"]),
+#                 "y_res": float(metadata["y_grid_resolution"]),
+#                 "prelim_cols": int(metadata["number_of_preliminary_cols"]),
+#                 "n_fields": int(metadata["number_of_field_cols"]),
+#             })
+#         except KeyError as e:
+#             raise ValueError(f"Missing required metadata field: {e}")
+#         except ValueError as e:
+#             raise ValueError(f"Invalid value in metadata: {e}")
+
+#         if metadata["x_res"] == 0 or metadata["y_res"] == 0:
+#             raise ZeroDivisionError("Grid resolution cannot be zero.")
+
+#         return metadata
+
+#     def _get_data_lines(self, lines: List[str]) -> List[str]:
+#         idx = next(i for i, l in enumerate(lines) if l.strip() == "Fields:")
+#         return lines[idx + 1:]
+
+#     def convert_3d_group(self, group: List[Tuple[int, str]], output_filename: str) -> str:
+#         first_file_path = group[0][1]
+#         with open(first_file_path, 'r') as f:
+#             lines = f.readlines()
+#         meta = self._parse_metadata(lines)
+
+#         lons = np.round(np.arange(meta["x_origin"], meta["x_origin"] + meta["x_size"] * meta["x_res"], meta["x_res"]), 6)
+#         lats = np.round(np.arange(meta["y_origin"], meta["y_origin"] + meta["y_size"] * meta["y_res"], meta["y_res"]), 6)
+
+#         z_levels = []
+#         z_coords = []
+
+#         for z_idx, filepath in group:
+#             with open(filepath, 'r') as f:
+#                 lines = f.readlines()
+#             data_lines = self._get_data_lines(lines)
+#             grid = np.zeros((meta["y_size"], meta["x_size"]), dtype=np.float32)
+
+#             for line in data_lines:
+#                 parts = [p.strip().strip(',') for p in line.strip().split(',') if p.strip()]
+#                 if len(parts) >= 5 and parts[0].isdigit() and parts[1].isdigit():
+#                     try:
+#                         x = int(parts[0]) - 1
+#                         y = int(parts[1]) - 1
+#                         val = float(parts[4])
+#                         if 0 <= x < meta["x_size"] and 0 <= y < meta["y_size"]:
+#                             grid[y, x] = val
+#                     except Exception:
+#                         continue
+#             z_levels.append(grid)
+#             z_coords.append(z_idx)
+
+#         z_cube = np.stack(z_levels, axis=0)
+#         ds = xr.Dataset(
+#             {
+#                 "ash_concentration": (['altitude', 'latitude', 'longitude'], z_cube)
+#             },
+#             coords={
+#                 "altitude": np.array(z_coords, dtype=np.float32),
+#                 "latitude": lats,
+#                 "longitude": lons
+#             },
+#             attrs={
+#                 "title": "Volcanic Ash Concentration",
+#                 "source": "NAME model output processed to NetCDF",
+#                 **{k: str(v) for k, v in meta.items()}  # Ensure all attrs are strings
+#             }
+#         )
+#         ds["ash_concentration"].attrs.update({
+#             "units": "g/m^3",
+#             "long_name": "Volcanic ash concentration"
+#         })
+#         ds["altitude"].attrs["units"] = "kilometers above sea level"
+#         ds["latitude"].attrs["units"] = "degrees_north"
+#         ds["longitude"].attrs["units"] = "degrees_east"
+
+#         out_path = os.path.join(self.output_dir, output_filename)
+#         ds.to_netcdf(out_path)
+#         return out_path
+
+#     def batch_process_zip(self, zip_path: str) -> List[str]:
+#         extract_dir = os.path.join(self.output_dir, "unzipped")
+#         os.makedirs(extract_dir, exist_ok=True)
+
+#         with zipfile.ZipFile(zip_path, 'r') as zip_ref:
+#             zip_ref.extractall(extract_dir)
+
+#         txt_files = []
+#         for root, _, files in os.walk(extract_dir):
+#             for file in files:
+#                 if file.endswith(".txt"):
+#                     txt_files.append(os.path.join(root, file))
+
+#         pattern = re.compile(r"_T(\d+)_.*_Z(\d+)\.txt$")
+#         grouped = {}
+#         for f in txt_files:
+#             match = pattern.search(f)
+#             if match:
+#                 t = int(match.group(1))
+#                 z = int(match.group(2))
+#                 grouped.setdefault(t, []).append((z, f))
+
+#         nc_files = []
+#         for t_key in sorted(grouped):
+#             group = sorted(grouped[t_key])
+#             out_nc = self.convert_3d_group(group, f"T{t_key}.nc")
+#             nc_files.append(out_nc)
+#         return nc_files
+
+# Re-defining the integrated class first
+import os
+import re
+import zipfile
+import numpy as np
+import xarray as xr
+from typing import List, Tuple
+import shutil
+
+
+class NAMEDataProcessor:
+    def __init__(self, output_root: str):
+        self.output_root = output_root
+        self.output_3d = os.path.join(self.output_root, "3D")
+        self.output_horizontal = os.path.join(self.output_root, "horizontal")
+        os.makedirs(self.output_3d, exist_ok=True)
+        os.makedirs(self.output_horizontal, exist_ok=True)
+
+    def _sanitize_key(self, key: str) -> str:
+        key = re.sub(r'\W+', '_', key)
+        if not key[0].isalpha():
+            key = f"attr_{key}"
+        return key
+
+    def _parse_metadata(self, lines: List[str]) -> dict:
+        metadata = {}
+        for line in lines:
+            if ":" in line:
+                key, value = line.split(":", 1)
+                clean_key = self._sanitize_key(key.strip().lower())
+                metadata[clean_key] = value.strip()
+
+        try:
+            metadata.update({
+                "x_origin": float(metadata["x_grid_origin"]),
+                "y_origin": float(metadata["y_grid_origin"]),
+                "x_size": int(metadata["x_grid_size"]),
+                "y_size": int(metadata["y_grid_size"]),
+                "x_res": float(metadata["x_grid_resolution"]),
+                "y_res": float(metadata["y_grid_resolution"]),
+            })
+        except KeyError as e:
+            raise ValueError(f"Missing required metadata field: {e}")
+        except ValueError as e:
+            raise ValueError(f"Invalid value in metadata: {e}")
+
+        if metadata["x_res"] == 0 or metadata["y_res"] == 0:
+            raise ZeroDivisionError("Grid resolution cannot be zero.")
+
+        return metadata
+
+    def _get_data_lines(self, lines: List[str]) -> List[str]:
+        idx = next(i for i, l in enumerate(lines) if l.strip() == "Fields:")
+        return lines[idx + 1:]
+
+    def _is_horizontal_file(self, filename: str) -> bool:
+        return "HorizontalField" in filename
+
+    def _convert_horizontal(self, filepath: str, output_filename: str) -> str:
+        with open(filepath, 'r') as f:
+            lines = f.readlines()
+
+        meta = self._parse_metadata(lines)
+        data_lines = self._get_data_lines(lines)
+
+        lons = np.round(np.arange(meta["x_origin"], meta["x_origin"] + meta["x_size"] * meta["x_res"], meta["x_res"]), 6)
+        lats = np.round(np.arange(meta["y_origin"], meta["y_origin"] + meta["y_size"] * meta["y_res"], meta["y_res"]), 6)
+
+        air_conc = np.zeros((meta["y_size"], meta["x_size"]), dtype=np.float32)
+        dry_depo = np.zeros((meta["y_size"], meta["x_size"]), dtype=np.float32)
+        wet_depo = np.zeros((meta["y_size"], meta["x_size"]), dtype=np.float32)
+
+        for line in data_lines:
+            parts = [p.strip().strip(',') for p in line.strip().split(',') if p.strip()]
+            if len(parts) >= 7 and parts[0].isdigit() and parts[1].isdigit():
+                try:
+                    x = int(parts[0]) - 1
+                    y = int(parts[1]) - 1
+                    air_val = float(parts[4])
+                    dry_val = float(parts[5])
+                    wet_val = float(parts[6])
+                    if 0 <= x < meta["x_size"] and 0 <= y < meta["y_size"]:
+                        air_conc[y, x] = air_val
+                        dry_depo[y, x] = dry_val
+                        wet_depo[y, x] = wet_val
+                except Exception:
+                    continue
+
+        ds = xr.Dataset(
+            {
+                "air_concentration": (['latitude', 'longitude'], air_conc),
+                "dry_deposition_rate": (['latitude', 'longitude'], dry_depo),
+                "wet_deposition_rate": (['latitude', 'longitude'], wet_depo)
+            },
+            coords={
+                "latitude": lats,
+                "longitude": lons
+            },
+            attrs={
+                "title": "Volcanic Ash Horizontal Output (Multiple Fields)",
+                "source": "NAME model output processed to NetCDF (horizontal multi-field)",
+                **{k: str(v) for k, v in meta.items()}
+            }
+        )
+
+        ds["air_concentration"].attrs.update({
+            "units": "g/m^3",
+            "long_name": "Boundary Layer Average Air Concentration"
+        })
+        ds["dry_deposition_rate"].attrs.update({
+            "units": "g/m^2/s",
+            "long_name": "Dry Deposition Rate"
+        })
+        ds["wet_deposition_rate"].attrs.update({
+            "units": "g/m^2/s",
+            "long_name": "Wet Deposition Rate"
+        })
+        ds["latitude"].attrs["units"] = "degrees_north"
+        ds["longitude"].attrs["units"] = "degrees_east"
+
+        out_path = os.path.join(self.output_horizontal, output_filename)
+        ds.to_netcdf(out_path, engine="netcdf4")
+
+        return out_path
+
+  
+    def _convert_3d_group(self, group: List[Tuple[int, str]], output_filename: str) -> str:
+        first_file_path = group[0][1]
+        with open(first_file_path, 'r') as f:
+            lines = f.readlines()
+        meta = self._parse_metadata(lines)
+
+        lons = np.round(np.arange(meta["x_origin"], meta["x_origin"] + meta["x_size"] * meta["x_res"], meta["x_res"]), 6)
+        lats = np.round(np.arange(meta["y_origin"], meta["y_origin"] + meta["y_size"] * meta["y_res"], meta["y_res"]), 6)
+
+        z_levels = []
+        z_coords = []
+
+        for z_idx, filepath in group:
+            with open(filepath, 'r') as f:
+                lines = f.readlines()
+            data_lines = self._get_data_lines(lines)
+            grid = np.zeros((meta["y_size"], meta["x_size"]), dtype=np.float32)
+
+            for line in data_lines:
+                parts = [p.strip().strip(',') for p in line.strip().split(',') if p.strip()]
+                if len(parts) >= 5 and parts[0].isdigit() and parts[1].isdigit():
+                    try:
+                        x = int(parts[0]) - 1
+                        y = int(parts[1]) - 1
+                        val = float(parts[4])
+                        if 0 <= x < meta["x_size"] and 0 <= y < meta["y_size"]:
+                            grid[y, x] = val
+                    except Exception:
+                        continue
+            z_levels.append(grid)
+            z_coords.append(z_idx)
+
+        z_cube = np.stack(z_levels, axis=0)
+        ds = xr.Dataset(
+            {
+                "ash_concentration": (['altitude', 'latitude', 'longitude'], z_cube)
+            },
+            coords={
+                "altitude": np.array(z_coords, dtype=np.float32),
+                "latitude": lats,
+                "longitude": lons
+            },
+            attrs={
+                "title": "Volcanic Ash Concentration (3D)",
+                "source": "NAME model output processed to NetCDF (3D fields)",
+                **{k: str(v) for k, v in meta.items()}
+            }
+        )
+
+        out_path = os.path.join(self.output_3d, output_filename)
+
+        # 🔥 Check if file exists, delete it first
+        # if os.path.exists(out_path):
+        #     os.remove(out_path)
+
+        # 🔥 Save NetCDF safely using netCDF4
+        ds.to_netcdf(out_path, engine="netcdf4")
+
+        return out_path
+
+
+    def batch_process_zip(self, zip_path: str) -> List[str]:
+        extract_dir = os.path.abspath("unzipped")
+
+        os.makedirs(extract_dir, exist_ok=True)
+        
+        ###
+        
+
+            # Function to empty folder contents
+        def empty_folder(folder_path):
+            import os
+            import glob
+            files = glob.glob(os.path.join(folder_path, '*'))
+            for f in files:
+                try:
+                    os.remove(f)
+                except IsADirectoryError:
+                    shutil.rmtree(f)
+
+        # 🛠 Clear cached open files and garbage collect before deleting
+        
+        # 🔥 Empty previous outputs, do not delete folders
+        if os.path.exists(self.output_3d):
+            empty_folder(self.output_3d)
+        else:
+            os.makedirs(self.output_3d, exist_ok=True)
+
+        # if os.path.exists(self.output_horizontal):
+        #     empty_folder(self.output_horizontal)
+        # else:
+        #     os.makedirs(self.output_horizontal, exist_ok=True)
+
+        # if os.path.exists(extract_dir):
+        #     shutil.rmtree(extract_dir)
+        # os.makedirs(extract_dir, exist_ok=True)
+
+        
+
+        
+        
+        #####
+
+        with zipfile.ZipFile(zip_path, 'r') as zip_ref:
+            zip_ref.extractall(extract_dir)
+
+        txt_files = []
+        for root, _, files in os.walk(extract_dir):
+            for file in files:
+                if file.endswith(".txt"):
+                    txt_files.append(os.path.join(root, file))
+
+        horizontal_files = []
+        grouped_3d = {}
+
+        pattern = re.compile(r"_T(\d+)_.*_Z(\d+)\.txt$")
+
+        for f in txt_files:
+            if self._is_horizontal_file(f):
+                horizontal_files.append(f)
+            else:
+                match = pattern.search(f)
+                if match:
+                    t = int(match.group(1))
+                    z = int(match.group(2))
+                    grouped_3d.setdefault(t, []).append((z, f))
+
+        nc_files = []
+
+        # Process horizontal
+        for f in sorted(horizontal_files):
+            base_name = os.path.splitext(os.path.basename(f))[0]
+            out_nc = self._convert_horizontal(f, f"{base_name}.nc")
+            nc_files.append(out_nc)
+
+        # Process 3D
+        for t_key in sorted(grouped_3d):
+            group = sorted(grouped_3d[t_key])
+            out_nc = self._convert_3d_group(group, f"T{t_key}.nc")
+            nc_files.append(out_nc)
+
+        return nc_files

ash_animator/export.py

@@ -0,0 +1,119 @@
+
+import os
+import numpy as np
+import matplotlib.pyplot as plt
+import matplotlib.ticker as mticker
+import cartopy.crs as ccrs
+import cartopy.feature as cfeature
+from .interpolation import interpolate_grid
+from .basemaps import draw_etopo_basemap
+
+def export_frames_as_jpgs(animator, output_folder: str, include_metadata: bool = True):
+    os.makedirs(output_folder, exist_ok=True)
+
+    meta = animator.datasets[0].attrs
+    legend_text = (
+        f"Run name:           {meta.get('run_name', 'N/A')}\n"
+        f"Run time:           {meta.get('run_time', 'N/A')}\n"
+        f"Met data:           {meta.get('met_data', 'N/A')}\n"
+        f"Start of release:   {meta.get('start_of_release', 'N/A')}\n"
+        f"End of release:     {meta.get('end_of_release', 'N/A')}\n"
+        f"Source strength:    {meta.get('source_strength', 'N/A')} g / s\n"
+        f"Release location:   {meta.get('release_location', 'N/A')}\n"
+        f"Release height:     {meta.get('release_height', 'N/A')} m asl\n"
+        f"Run duration:       {meta.get('run_duration', 'N/A')}"
+    )
+
+    for z_index, z_val in enumerate(animator.levels):
+        z_dir = os.path.join(output_folder, f"ash_T1-Tn_Z{z_index+1}")
+        os.makedirs(z_dir, exist_ok=True)
+
+        valid_mask = np.stack([
+            ds['ash_concentration'].values[z_index] for ds in animator.datasets
+        ]).max(axis=0) > 0
+        y_idx, x_idx = np.where(valid_mask)
+
+        if y_idx.size == 0 or x_idx.size == 0:
+            print(f"Z level {z_val} km has no valid data. Skipping...")
+            continue
+
+        y_min, y_max = y_idx.min(), y_idx.max()
+        x_min, x_max = x_idx.min(), x_idx.max()
+
+        for t in range(len(animator.datasets)):
+            data = animator.datasets[t]['ash_concentration'].values[z_index]
+            interp = interpolate_grid(data, animator.lon_grid, animator.lat_grid)
+            if np.isfinite(interp).sum() == 0:
+                continue
+
+            fig, (ax1, ax2) = plt.subplots(1, 2, figsize=(18, 8), subplot_kw={'projection': ccrs.PlateCarree()})
+            valid_vals = interp[np.isfinite(interp)]
+            min_val = np.nanmin(valid_vals)
+            max_val = np.nanmax(valid_vals)
+            log_cutoff = 1e-3
+            log_ratio = max_val / (min_val + 1e-6)
+            use_log = min_val > log_cutoff and log_ratio > 100
+
+            levels = np.logspace(np.log10(log_cutoff), np.log10(max_val), 20) if use_log else np.linspace(0, max_val, 20)
+            data_for_plot = np.where(interp > log_cutoff, interp, np.nan) if use_log else interp
+            scale_label = "Hybrid Log" if use_log else "Linear"
+
+            # Plot full
+            c1 = ax1.contourf(animator.lons, animator.lats, data_for_plot, levels=levels,
+                            cmap="rainbow", alpha=0.6, transform=ccrs.PlateCarree())
+            draw_etopo_basemap(ax1, mode='stock')
+            ax1.set_extent([animator.lons.min(), animator.lons.max(), animator.lats.min(), animator.lats.max()])
+            ax1.set_title(f"T{t+1} | Alt: {z_val} km (Full - {scale_label})")
+            ax1.coastlines(); ax1.add_feature(cfeature.BORDERS)
+            ax1.add_feature(cfeature.LAND); ax1.add_feature(cfeature.OCEAN)
+
+            # Zoom region
+            buffer_y = int((y_max - y_min) * 0.5)
+            buffer_x = int((x_max - x_min) * 0.5)
+
+            y_start = max(0, y_min - buffer_y)
+            y_end = min(data_for_plot.shape[0], y_max + buffer_y + 1)
+            x_start = max(0, x_min - buffer_x)
+            x_end = min(data_for_plot.shape[1], x_max + buffer_x + 1)
+
+            zoom = data_for_plot[y_start:y_end, x_start:x_end]
+            lon_zoom = animator.lons[x_start:x_end]
+            lat_zoom = animator.lats[y_start:y_end]
+
+            c2 = ax2.contourf(lon_zoom, lat_zoom, zoom, levels=levels,
+                            cmap="rainbow", alpha=0.6, transform=ccrs.PlateCarree())
+            draw_etopo_basemap(ax2, mode='stock')
+            ax2.set_extent([lon_zoom.min(), lon_zoom.max(), lat_zoom.min(), lat_zoom.max()])
+            ax2.set_title(f"T{t+1} | Alt: {z_val} km (Zoom - {scale_label})")
+            ax2.coastlines(); ax2.add_feature(cfeature.BORDERS)
+            ax2.add_feature(cfeature.LAND); ax2.add_feature(cfeature.OCEAN)
+
+            for ax in [ax1, ax2]:
+                ax.text(0.01, 0.98, f"Time step T{t+1}", transform=ax.transAxes,
+                        fontsize=9, color='white', va='top', ha='left',
+                        bbox=dict(facecolor='black', alpha=0.4, boxstyle='round'))
+
+            if include_metadata:
+                for ax in [ax1, ax2]:
+                    ax.text(0.01, 0.01,
+                            f"Source: NAME model\nRes: {animator.x_res:.2f}°\n{meta.get('run_name', 'N/A')}",
+                            transform=ax.transAxes, fontsize=8, color='white',
+                            bbox=dict(facecolor='black', alpha=0.5))
+                ax1.annotate(legend_text, xy=(0.75, 0.99), xycoords='axes fraction',
+                            fontsize=8, ha='left', va='top',
+                            bbox=dict(boxstyle="round", facecolor="white", edgecolor="gray"),
+                            annotation_clip=False)
+
+            cbar = fig.colorbar(c1, ax=[ax1, ax2], orientation='vertical', shrink=0.75, pad=0.03)
+            cbar.set_label("Ash concentration (g/m³)")
+            formatter = mticker.FuncFormatter(lambda x, _: f'{x:.2g}')
+            cbar.ax.yaxis.set_major_formatter(formatter)
+
+            if use_log:
+                cbar.ax.text(1.1, 1.02, "log scale", transform=cbar.ax.transAxes,
+                            fontsize=9, color='gray', rotation=90, ha='left', va='bottom')
+
+            frame_path = os.path.join(z_dir, f"frame_{t+1:04d}.jpg")
+            plt.savefig(frame_path, dpi=150, bbox_inches='tight')
+            plt.close(fig)
+            print(f"Saved {frame_path}")

ash_animator/interpolation.py

@@ -0,0 +1,14 @@
+
+import numpy as np
+from scipy.interpolate import griddata
+
+def interpolate_grid(data, lon_grid, lat_grid):
+    data = np.where(data < 0, np.nan, data)
+    mask = data > 0
+    if np.count_nonzero(mask) < 10:
+        return np.full_like(data, np.nan)
+    
+    points = np.column_stack((lon_grid[mask], lat_grid[mask]))
+    values = data[mask]
+    grid_z = griddata(points, values, (lon_grid, lat_grid), method='cubic')
+    return np.where(grid_z < 0, 0, grid_z)

ash_animator/plot_3dfield_data.py

@@ -0,0 +1,465 @@
+import os
+import numpy as np
+import matplotlib.pyplot as plt
+import matplotlib.animation as animation
+import matplotlib.ticker as mticker
+import cartopy.crs as ccrs
+import cartopy.feature as cfeature
+import cartopy.io.shapereader as shpreader
+from adjustText import adjust_text
+from .interpolation import interpolate_grid
+from .basemaps import draw_etopo_basemap
+import imageio.v2 as imageio
+import shutil
+
+class Plot_3DField_Data:
+    
+    """
+    A class for visualizing 3D spatiotemporal field data (e.g., ash concentration) across time and altitude levels.
+
+    This class uses matplotlib and cartopy to create:
+      - Animated GIFs of spatial fields at given altitudes
+      - Vertical profile animations over time
+      - Exported static frames with metadata annotations and zoomed views
+
+    Parameters
+    ----------
+    animator : object
+        A container holding the dataset, including:
+        - datasets: list of xarray-like DataArrays with 'ash_concentration'
+        - lons, lats: 1D longitude and latitude arrays
+        - lat_grid, lon_grid: 2D grid arrays for spatial mapping
+        - levels: 1D array of vertical altitude levels (e.g., in km)
+    output_dir : str
+        Base directory for saving all outputs. Defaults to "plots".
+    cmap : str
+        Matplotlib colormap name. Defaults to "rainbow".
+    fps : int
+        Frames per second for GIFs. Defaults to 2.
+    include_metadata : bool
+        Whether to annotate each figure with simulation metadata. Defaults to True.
+    threshold : float
+        Value threshold (e.g., in g/m³) to highlight exceedances. Defaults to 0.1.
+    zoom_width_deg : float
+        Width of the zoomed-in region in degrees. Defaults to 6.0.
+    zoom_height_deg : float
+        Height of the zoomed-in region in degrees. Defaults to 6.0.
+    zoom_level : int
+        Zoom level passed to basemap drawing. Defaults to 7.
+    basemap_type : str
+        Type of basemap to draw (passed to draw_etopo_basemap). Defaults to "basemap".
+
+    Methods
+    -------
+    plot_single_z_level(z_km, filename)
+        Generate animation over time at a specific altitude level.
+    
+    plot_vertical_profile_at_time(t_index, filename=None)
+        Generate vertical profile GIF for a single timestep.
+
+    animate_altitude(t_index, output_path)
+        Animate altitude slices for one timestep.
+
+    animate_all_altitude_profiles(output_folder='altitude_profiles')
+        Generate vertical animations for all time steps.
+
+    export_frames_as_jpgs(include_metadata=True)
+        Export individual frames as static `.jpg` images with annotations.
+    """
+    def __init__(self, animator, output_dir="plots", cmap="rainbow", fps=2,
+                 include_metadata=True, threshold=0.1,
+                 zoom_width_deg=6.0, zoom_height_deg=6.0, zoom_level=7, basemap_type="basemap"):
+        self.animator = animator
+        self.output_dir = os.path.abspath(os.path.join(os.getcwd(), output_dir))
+        os.makedirs(self.output_dir, exist_ok=True)
+        self.cmap = cmap
+        self.fps = fps
+        self.include_metadata = include_metadata
+        self.threshold = threshold
+        self.zoom_width = zoom_width_deg
+        self.zoom_height = zoom_height_deg
+        shp = shpreader.natural_earth(resolution='110m', category='cultural', name='admin_0_countries')
+        self.country_geoms = list(shpreader.Reader(shp).records())
+        self.zoom_level=zoom_level
+        self.basemap_type=basemap_type
+        
+        #############3
+        
+            
+        # Load shapefile once
+        countries_shp = shpreader.natural_earth(
+            resolution='110m',
+            category='cultural',
+            name='admin_0_countries'
+        )
+        self.country_geoms = list(shpreader.Reader(countries_shp).records())
+
+        # Cache extent bounds
+        self.lon_min = np.min(self.animator.lons)
+        self.lon_max = np.max(self.animator.lons)
+        self.lat_min = np.min(self.animator.lats)
+        self.lat_max = np.max(self.animator.lats)
+        
+        #####################3
+        
+    def _make_dirs(self, path):
+        path = os.path.abspath(os.path.join(os.getcwd(), os.path.dirname(path)))
+        os.makedirs(path, exist_ok=True)
+
+    def _get_zoom_indices(self, center_lat, center_lon):
+        lon_min = center_lon - self.zoom_width / 2
+        lon_max = center_lon + self.zoom_width / 2
+        lat_min = center_lat - self.zoom_height / 2
+        lat_max = center_lat + self.zoom_height / 2
+        lat_idx = np.where((self.animator.lats >= lat_min) & (self.animator.lats <= lat_max))[0]
+        lon_idx = np.where((self.animator.lons >= lon_min) & (self.animator.lons <= lon_max))[0]
+        return lat_idx, lon_idx, lon_min, lon_max, lat_min, lat_max
+
+    def _get_max_concentration_location(self):
+        max_conc = -np.inf
+        center_lat = center_lon = None
+        for ds in self.animator.datasets:
+            for z in range(len(self.animator.levels)):
+                data = ds['ash_concentration'].values[z]
+                if np.max(data) > max_conc:
+                    max_conc = np.max(data)
+                    max_idx = np.unravel_index(np.argmax(data), data.shape)
+                    center_lat = self.animator.lat_grid[max_idx]
+                    center_lon = self.animator.lon_grid[max_idx]
+        return center_lat, center_lon
+
+    def _add_country_labels(self, ax, extent):
+        proj = ccrs.PlateCarree()
+        texts = []
+        for country in self.country_geoms:
+            name = country.attributes['NAME_LONG']
+            geom = country.geometry
+            try:
+                lon, lat = geom.centroid.x, geom.centroid.y
+                if extent[0] <= lon <= extent[1] and extent[2] <= lat <= extent[3]:
+                    text = ax.text(lon, lat, name, fontsize=6, transform=proj,
+                                   ha='center', va='center', color='white',
+                                   bbox=dict(facecolor='black', alpha=0.5, linewidth=0))
+                    texts.append(text)
+            except:
+                continue
+        adjust_text(texts, ax=ax, only_move={'points': 'y', 'text': 'y'},
+                    arrowprops=dict(arrowstyle="->", color='white', lw=0.5))
+
+    def _plot_frame(self, ax, data, lons, lats, title, levels, scale_label, proj):
+        draw_etopo_basemap(ax, mode=self.basemap_type, zoom=self.zoom_level)
+        c = ax.contourf(lons, lats, data, levels=levels, cmap=self.cmap, alpha=0.6, transform=proj)
+        ax.contour(lons, lats, data, levels=levels, colors='black', linewidths=0.5, transform=proj)
+        ax.set_title(title)
+        ax.set_extent([lons.min(), lons.max(), lats.min(), lats.max()])
+        ax.coastlines()
+        ax.add_feature(cfeature.BORDERS, linestyle=':')
+        ax.add_feature(cfeature.LAND)
+        ax.add_feature(cfeature.OCEAN)
+        return c
+
+ 
+
+#  metadata placement function and usage
+
+    def _draw_metadata_sidebar(self, fig, meta_dict):
+        lines = [
+        f"Run name:        {meta_dict.get('run_name', 'N/A')}",
+        f"Run time:        {meta_dict.get('run_time', 'N/A')}",
+        f"Met data:        {meta_dict.get('met_data', 'N/A')}",
+        f"Start release:   {meta_dict.get('start_of_release', 'N/A')}",
+        f"End release:     {meta_dict.get('end_of_release', 'N/A')}",
+        f"Source strength: {meta_dict.get('source_strength', 'N/A')} g/s",
+        f"Release loc:     {meta_dict.get('release_location', 'N/A')}",
+        f"Release height:  {meta_dict.get('release_height', 'N/A')} m asl",
+        f"Run duration:    {meta_dict.get('run_duration', 'N/A')}"
+    ]
+        full_text = "\n".join(lines)  # ✅ actual newlines
+        fig.text(0.1, 0.095, full_text, va='center', ha='left',
+                fontsize=9, family='monospace', color='black',
+                bbox=dict(facecolor='white', alpha=0.8, edgecolor='gray'))
+
+
+
+    def plot_single_z_level(self, z_km, filename="z_level.gif"):
+       
+        if z_km not in self.animator.levels:
+            print(f"Z level {z_km} km not found.")
+            return
+        z_index = np.where(self.animator.levels == z_km)[0][0]
+        output_path = os.path.join(self.output_dir, "z_levels", filename)
+        fig = plt.figure(figsize=(16, 8))
+        proj = ccrs.PlateCarree()
+        ax1 = fig.add_subplot(1, 2, 1, projection=proj)
+        ax2 = fig.add_subplot(1, 2, 2, projection=proj)
+
+        center_lat, center_lon = self._get_max_concentration_location()
+        lat_idx, lon_idx, lon_min, lon_max, lat_min, lat_max = self._get_zoom_indices(center_lat, center_lon)
+        lat_zoom = self.animator.lats[lat_idx]
+        lon_zoom = self.animator.lons[lon_idx]
+        lon_zoom_grid, lat_zoom_grid = np.meshgrid(lon_zoom, lat_zoom)
+        
+       
+
+        meta = self.animator.datasets[0].attrs
+        valid_frames = []
+        for t in range(len(self.animator.datasets)):
+            interp = interpolate_grid(self.animator.datasets[t]['ash_concentration'].values[z_index],
+                                      self.animator.lon_grid, self.animator.lat_grid)
+            if np.isfinite(interp).sum() > 0:
+                valid_frames.append(t)
+        if not valid_frames:
+            print(f"No valid frames for Z={z_km} km.")
+            plt.close()
+            return
+
+        def update(t):
+            ax1.clear()
+            ax2.clear()
+
+            data = self.animator.datasets[t]['ash_concentration'].values[z_index]
+            interp = interpolate_grid(data, self.animator.lon_grid, self.animator.lat_grid)
+            interp = np.where(interp < 0, np.nan, interp)
+            zoom_plot = interp[np.ix_(lat_idx, lon_idx)]
+
+            valid_vals = interp[np.isfinite(interp)]
+            if valid_vals.size == 0:
+                return []
+
+            min_val, max_val = np.nanmin(valid_vals), np.nanmax(valid_vals)
+            log_cutoff = 1e-3
+            use_log = min_val > log_cutoff and (max_val / (min_val + 1e-6)) > 100
+
+            levels = (
+                np.logspace(np.log10(log_cutoff), np.log10(max_val), 20)
+                if use_log else
+                np.linspace(0, max_val, 20)
+            )
+            data_for_plot = np.where(interp > log_cutoff, interp, np.nan) if use_log else interp
+            scale_label = "Log" if use_log else "Linear"
+
+            c = self._plot_frame(ax1, data_for_plot, self.animator.lons, self.animator.lats,
+                                f"T{t+1} | Alt: {z_km} km (Full - {scale_label})", levels, scale_label, proj)
+            self._plot_frame(ax2, zoom_plot, lon_zoom, lat_zoom,
+                            f"T{t} | Alt: {z_km} km (Zoom - {scale_label})", levels, scale_label, proj)
+
+            self._add_country_labels(ax1, [self.animator.lons.min(), self.animator.lons.max(),
+                                        self.animator.lats.min(), self.animator.lats.max()])
+            self._add_country_labels(ax2, [lon_min, lon_max, lat_min, lat_max])
+
+            if not hasattr(update, "colorbar"):
+                update.colorbar = fig.colorbar(c, ax=[ax1, ax2], orientation='vertical',
+                                            label="Ash concentration (g/m³)")
+                formatter = mticker.FuncFormatter(lambda x, _: f'{x:.2g}')
+                update.colorbar.ax.yaxis.set_major_formatter(formatter)
+
+            # ✅ Draw threshold outline and label only if exceeded
+            if np.nanmax(valid_vals) > self.threshold:
+                ax1.contour(self.animator.lons, self.animator.lats, interp, levels=[self.threshold],
+                            colors='red', linewidths=2, transform=proj)
+                ax2.contour(lon_zoom, lat_zoom, zoom_plot, levels=[self.threshold],
+                            colors='red', linewidths=2, transform=proj)
+                ax2.text(0.99, 0.01, f"⚠ Max Thresold Exceed: {np.nanmax(valid_vals):.2f} > {self.threshold} g/m³",
+                        transform=ax2.transAxes, ha='right', va='bottom',
+                        fontsize=9, color='red',
+                        bbox=dict(facecolor='white', alpha=0.8, edgecolor='red'))
+
+            return []
+
+  
+
+
+        self._draw_metadata_sidebar(fig, meta)
+        self._make_dirs(output_path)
+        fig.tight_layout()
+        ani = animation.FuncAnimation(fig, update, frames=valid_frames, blit=False, cache_frame_data =False)
+        ani.save(output_path, writer='pillow', fps=self.fps, dpi=300)
+        plt.close()
+        print(f"✅ Saved Z-level animation to {output_path}")
+
+    def plot_vertical_profile_at_time(self, t_index, filename=None):
+        time_label = f"T{t_index+1}"
+        for z_index, z_val in enumerate(self.animator.levels):
+            filename = f"TimeSlices_Z{z_val:.1f}km.gif"
+            self.plot_single_z_level(z_val, filename=os.path.join("vertical_profiles_timeSlice", filename))
+
+    
+    ################################################
+    
+    
+    
+    def animate_altitude(self, t_index: int, output_path: str):
+        if not (0 <= t_index < len(self.animator.datasets)):
+            print(f"Invalid time index {t_index}. Must be between 0 and {len(self.animator.datasets) - 1}.")
+        
+
+        ds = self.animator.datasets[t_index]
+        fig = plt.figure(figsize=(18, 7))
+        proj = ccrs.PlateCarree()
+        ax1 = fig.add_subplot(1, 2, 1, projection=proj)
+        ax2 = fig.add_subplot(1, 2, 2, projection=proj)
+
+        meta = ds.attrs
+        center_lat, center_lon = self._get_max_concentration_location()
+        if center_lat is None or center_lon is None:
+            print(f"No valid data found for time T{t_index + 1}. Skipping...")
+            plt.close()
+            return
+
+        lat_idx, lon_idx, lon_min, lon_max, lat_min, lat_max = self._get_zoom_indices(center_lat, center_lon)
+        lat_zoom = self.animator.lats[lat_idx]
+        lon_zoom = self.animator.lons[lon_idx]
+        lon_zoom_grid, lat_zoom_grid = np.meshgrid(lon_zoom, lat_zoom)
+
+        z_indices_with_data = []
+        for z_index in range(len(self.animator.levels)):
+            data = ds['ash_concentration'].values[z_index]
+            interp = interpolate_grid(data, self.animator.lon_grid, self.animator.lat_grid)
+            if np.isfinite(interp).sum() > 0:
+                z_indices_with_data.append(z_index)
+
+        if not z_indices_with_data:
+            print(f"No valid Z-levels at time T{t_index + 1}.")
+            plt.close()
+            return
+
+        def update(z_index):
+            ax1.clear()
+            ax2.clear()
+
+            data = ds['ash_concentration'].values[z_index]
+            interp = interpolate_grid(data, self.animator.lon_grid, self.animator.lat_grid)
+            interp = np.where(interp < 0, np.nan, interp)
+            zoom_plot = interp[np.ix_(lat_idx, lon_idx)]
+
+            valid_vals = interp[np.isfinite(interp)]
+            if valid_vals.size == 0:
+                return []
+
+            min_val, max_val = np.nanmin(valid_vals), np.nanmax(valid_vals)
+            log_cutoff = 1e-3
+            use_log = min_val > log_cutoff and (max_val / (min_val + 1e-6)) > 100
+
+            levels = np.logspace(np.log10(log_cutoff), np.log10(max_val), 20) if use_log else np.linspace(0, max_val, 20)
+            data_for_plot = np.where(interp > log_cutoff, interp, np.nan) if use_log else interp
+            scale_label = "Log" if use_log else "Linear"
+
+            title1 = f"T{t_index + 1} | Alt: {self.animator.levels[z_index]} km (Full - {scale_label})"
+            title2 = f"T{t_index + 1} | Alt: {self.animator.levels[z_index]} km (Zoom - {scale_label})"
+
+            c1 = self._plot_frame(ax1, data_for_plot, self.animator.lons, self.animator.lats, title1, levels, scale_label, proj)
+            self._plot_frame(ax2, zoom_plot, lon_zoom, lat_zoom, title2, levels, scale_label, proj)
+
+            self._add_country_labels(ax1, [self.lon_min, self.lon_max, self.lat_min, self.lat_max])
+            self._add_country_labels(ax2, [lon_min, lon_max, lat_min, lat_max])
+
+            if self.include_metadata:
+                self._draw_metadata_sidebar(fig, meta)
+
+            if not hasattr(update, "colorbar"):
+                update.colorbar = fig.colorbar(c1, ax=[ax1, ax2], orientation='vertical',
+                                                label="Ash concentration (g/m³)", shrink=0.75)
+                formatter = mticker.FuncFormatter(lambda x, _: f'{x:.2g}')
+                update.colorbar.ax.yaxis.set_major_formatter(formatter)
+
+            if np.nanmax(valid_vals) > self.threshold:
+                ax1.contour(self.animator.lons, self.animator.lats, interp, levels=[self.threshold],
+                            colors='red', linewidths=2, transform=proj)
+                ax2.contour(lon_zoom, lat_zoom, zoom_plot, levels=[self.threshold],
+                            colors='red', linewidths=2, transform=proj)
+
+            
+                ax2.text(0.99, 0.01, f"⚠ Max Thresold Exceed: {np.nanmax(valid_vals):.2f} > {self.threshold} g/m³",
+                            transform=ax2.transAxes, ha='right', va='bottom',
+                            fontsize=9, color='red',
+                            bbox=dict(facecolor='white', alpha=0.8, edgecolor='red'))
+            return []
+
+        os.makedirs(os.path.dirname(output_path), exist_ok=True)
+        #fig.set_size_inches(18, 7)
+        fig.tight_layout(rect=[0.02, 0.02, 0.98, 0.98])
+        ani = animation.FuncAnimation(fig, update, frames=z_indices_with_data, blit=False, cache_frame_data =False)
+        ani.save(output_path, writer='pillow', fps=self.fps, dpi=300)
+        plt.close()
+        print(f"✅ Saved vertical profile animation for T{t_index + 1} to {output_path}")
+
+
+
+    def animate_all_altitude_profiles(self, output_folder='altitude_profiles'):
+        output_folder = os.path.join(self.output_dir, "altitude_profiles")
+        os.makedirs(output_folder, exist_ok=True)
+        for t_index in range(len(self.animator.datasets)):
+            output_path = os.path.join(output_folder, f"vertical_T{t_index + 1:02d}.gif")
+            print(f"🔄 Generating vertical profile animation for T{t_index + 1}...")
+            self.animate_altitude(t_index, output_path)
+
+            
+    
+
+
+    
+    def export_frames_as_jpgs(self, include_metadata: bool = True):
+        output_folder = os.path.join(self.output_dir, "frames")
+        os.makedirs(output_folder, exist_ok=True)
+        meta = self.animator.datasets[0].attrs
+        legend_text = "\\n".join([
+            f"Run name:        {meta.get('run_name', 'N/A')}",
+            f"Run time:        {meta.get('run_time', 'N/A')}",
+            f"Met data:        {meta.get('met_data', 'N/A')}",
+            f"Start release:   {meta.get('start_of_release', 'N/A')}",
+            f"End release:     {meta.get('end_of_release', 'N/A')}",
+            f"Strength:        {meta.get('source_strength', 'N/A')} g/s",
+            f"Location:        {meta.get('release_location', 'N/A')}",
+            f"Height:          {meta.get('release_height', 'N/A')} m asl",
+            f"Duration:        {meta.get('run_duration', 'N/A')}"
+        ])
+        for z_index, z_val in enumerate(self.animator.levels):
+            z_dir = os.path.join(output_folder, f"Z{z_val:.1f}km")
+            os.makedirs(z_dir, exist_ok=True)
+            for t in range(len(self.animator.datasets)):
+                data = self.animator.datasets[t]['ash_concentration'].values[z_index]
+                interp = interpolate_grid(data, self.animator.lon_grid, self.animator.lat_grid)
+                if not np.isfinite(interp).any():
+                    continue
+                fig = plt.figure(figsize=(16, 8))
+                proj = ccrs.PlateCarree()
+                ax1 = fig.add_subplot(1, 2, 1, projection=proj)
+                ax2 = fig.add_subplot(1, 2, 2, projection=proj)
+                valid_vals = interp[np.isfinite(interp)]
+                min_val, max_val = np.nanmin(valid_vals), np.nanmax(valid_vals)
+                log_cutoff = 1e-3
+                use_log = min_val > log_cutoff and (max_val / (min_val + 1e-6)) > 100
+                levels = np.logspace(np.log10(log_cutoff), np.log10(max_val), 20) if use_log else np.linspace(0, max_val, 20)
+                data_for_plot = np.where(interp > log_cutoff, interp, np.nan) if use_log else interp
+                scale_label = "Log" if use_log else "Linear"
+                center_lat, center_lon = self._get_max_concentration_location()
+                lat_idx, lon_idx, lon_min, lon_max, lat_min, lat_max = self._get_zoom_indices(center_lat, center_lon)
+                zoom_plot = interp[np.ix_(lat_idx, lon_idx)]
+                lon_zoom = self.animator.lons[lon_idx]
+                lat_zoom = self.animator.lats[lat_idx]
+                c1 = self._plot_frame(ax1, data_for_plot, self.animator.lons, self.animator.lats,
+                                      f"T{t+1} | Alt: {z_val} km (Full - {scale_label})", levels, scale_label, proj)
+                self._plot_frame(ax2, zoom_plot, lon_zoom, lat_zoom,
+                                 f"T{t+1} | Alt: {z_val} km (Zoom - {scale_label})", levels, scale_label, proj)
+                self._add_country_labels(ax1, [self.animator.lons.min(), self.animator.lons.max(),
+                                               self.animator.lats.min(), self.animator.lats.max()])
+                self._add_country_labels(ax2, [lon_min, lon_max, lat_min, lat_max])
+                if np.nanmax(valid_vals) > self.threshold:
+                    ax1.contour(self.animator.lons, self.animator.lats, interp, levels=[self.threshold],
+                                colors='red', linewidths=2, transform=proj)
+                    ax2.contour(lon_zoom, lat_zoom, zoom_plot, levels=[self.threshold],
+                                colors='red', linewidths=2, transform=proj)
+                    ax2.text(0.99, 0.01, f"⚠ Max: {np.nanmax(valid_vals):.2f} > {self.threshold} g/m³",
+                             transform=ax2.transAxes, ha='right', va='bottom',
+                             fontsize=9, color='red',
+                             bbox=dict(facecolor='white', alpha=0.8, edgecolor='red'))
+                if include_metadata:
+                    self._draw_metadata_sidebar(fig, meta)
+                cbar = fig.colorbar(c1, ax=[ax1, ax2], orientation='vertical', shrink=0.75, pad=0.03)
+                cbar.set_label("Ash concentration (g/m³)")
+                formatter = mticker.FuncFormatter(lambda x, _: f'{x:.2g}')
+                cbar.ax.yaxis.set_major_formatter(formatter)
+                frame_path = os.path.join(z_dir, f"frame_{t+1:04d}.jpg")
+                plt.savefig(frame_path, dpi=150, bbox_inches='tight')
+                plt.close(fig)
+                print(f"📸 Saved {frame_path}")

ash_animator/plot_horizontal_data.py

@@ -0,0 +1,564 @@
+''' import os
+import numpy as np
+import matplotlib.pyplot as plt
+import matplotlib.animation as animation
+import matplotlib.ticker as mticker
+import cartopy.crs as ccrs
+import cartopy.feature as cfeature
+import cartopy.io.shapereader as shpreader
+from adjustText import adjust_text
+from ash_animator.interpolation import interpolate_grid
+from ash_animator.basemaps import draw_etopo_basemap
+
+class Plot_Horizontal_Data:
+    def __init__(self, animator, output_dir="plots", cmap="rainbow", fps=2,
+                 include_metadata=True, threshold=0.1,
+                 zoom_width_deg=6.0, zoom_height_deg=6.0, zoom_level=7, static_frame_export=False):
+        self.animator = animator
+        self.output_dir = os.path.abspath(os.path.join(os.getcwd(), output_dir))
+        os.makedirs(self.output_dir, exist_ok=True)
+        self.cmap = cmap
+        self.fps = fps
+        self.include_metadata = include_metadata
+        self.threshold = threshold
+        self.zoom_width = zoom_width_deg
+        self.zoom_height = zoom_height_deg
+        shp = shpreader.natural_earth(resolution='110m', category='cultural', name='admin_0_countries')
+        self.country_geoms = list(shpreader.Reader(shp).records())
+        self.interpolate_grid= interpolate_grid
+        self._draw_etopo_basemap=draw_etopo_basemap
+        self.zoom_level=zoom_level
+        self.static_frame_export=static_frame_export
+
+    def _make_dirs(self, path):
+        os.makedirs(os.path.abspath(os.path.join(os.getcwd(), os.path.dirname(path))), exist_ok=True)
+
+    def _get_max_concentration_location(self, field):
+        max_val = -np.inf
+        lat = lon = None
+        for ds in self.animator.datasets:
+            data = ds[field].values
+            if np.max(data) > max_val:
+                max_val = np.max(data)
+                idx = np.unravel_index(np.argmax(data), data.shape)
+                lat = self.animator.lat_grid[idx]
+                lon = self.animator.lon_grid[idx]
+        return lat, lon
+
+    def _get_zoom_indices(self, center_lat, center_lon):
+        lon_min = center_lon - self.zoom_width / 2
+        lon_max = center_lon + self.zoom_width / 2
+        lat_min = center_lat - self.zoom_height / 2
+        lat_max = center_lat + self.zoom_height / 2
+        lat_idx = np.where((self.animator.lats >= lat_min) & (self.animator.lats <= lat_max))[0]
+        lon_idx = np.where((self.animator.lons >= lon_min) & (self.animator.lons <= lon_max))[0]
+        return lat_idx, lon_idx, lon_min, lon_max, lat_min, lat_max
+
+    def _add_country_labels(self, ax, extent):
+        proj = ccrs.PlateCarree()
+        texts = []
+        for country in self.country_geoms:
+            name = country.attributes['NAME_LONG']
+            geom = country.geometry
+            try:
+                lon, lat = geom.centroid.x, geom.centroid.y
+                if extent[0] <= lon <= extent[1] and extent[2] <= lat <= extent[3]:
+                    text = ax.text(lon, lat, name, fontsize=6, transform=proj,
+                                   ha='center', va='center', color='white',
+                                   bbox=dict(facecolor='black', alpha=0.5, linewidth=0))
+                    texts.append(text)
+            except:
+                continue
+        adjust_text(texts, ax=ax, only_move={'points': 'y', 'text': 'y'},
+                    arrowprops=dict(arrowstyle="->", color='white', lw=0.5))
+
+    def _draw_metadata_sidebar(self, fig, meta_dict):
+        lines = [
+        f"Run name:        {meta_dict.get('run_name', 'N/A')}",
+        f"Run time:        {meta_dict.get('run_time', 'N/A')}",
+        f"Met data:        {meta_dict.get('met_data', 'N/A')}",
+        f"Start release:   {meta_dict.get('start_of_release', 'N/A')}",
+        f"End release:     {meta_dict.get('end_of_release', 'N/A')}",
+        f"Source strength: {meta_dict.get('source_strength', 'N/A')} g/s",
+        f"Release loc:     {meta_dict.get('release_location', 'N/A')}",
+        f"Release height:  {meta_dict.get('release_height', 'N/A')} m asl",
+        f"Run duration:    {meta_dict.get('run_duration', 'N/A')}"
+        ]
+
+        # Split into two columns
+        mid = len(lines) // 2 + len(lines) % 2
+        left_lines = lines[:mid]
+        right_lines = lines[mid:]
+
+        left_text = "\n".join(left_lines)
+        right_text = "\n".join(right_lines)
+
+        # right column
+        fig.text(0.05, 0.05, left_text, va='bottom', ha='left',
+                fontsize=9, family='monospace', color='black',
+                bbox=dict(facecolor='white', alpha=0.8, edgecolor='gray'))
+
+        # left column
+        fig.text(0.3, 0.05, right_text, va='bottom', ha='left',
+                fontsize=9, family='monospace', color='black',
+                bbox=dict(facecolor='white', alpha=0.8, edgecolor='gray'))
+
+    
+    
+
+
+    def _plot_frame(self, ax, data, lons, lats, title, levels, scale_label, proj):
+        self._draw_etopo_basemap(ax, mode='basemap', zoom=self.zoom_level)
+        c = ax.contourf(lons, lats, data, levels=levels, cmap=self.cmap, alpha=0.6, transform=proj)
+        ax.set_title(title)
+        ax.set_extent([lons.min(), lons.max(), lats.min(), lats.max()])
+        ax.coastlines()
+        ax.add_feature(cfeature.BORDERS, linestyle=':')
+        ax.add_feature(cfeature.LAND)
+        ax.add_feature(cfeature.OCEAN)
+        return c
+
+    def get_available_2d_fields(self):
+        ds = self.animator.datasets[0]
+        return [v for v in ds.data_vars if ds[v].ndim == 2]
+
+    def plot_single_field_over_time(self, field, filename="field.gif"):
+        output_path = os.path.join(self.output_dir, "2d_fields", field, filename)
+        meta = self.animator.datasets[0].attrs
+        center_lat, center_lon = self._get_max_concentration_location(field)
+        lat_idx, lon_idx, lon_min, lon_max, lat_min, lat_max = self._get_zoom_indices(center_lat, center_lon)
+        lat_zoom = self.animator.lats[lat_idx]
+        lon_zoom = self.animator.lons[lon_idx]
+
+        valid_frames = []
+        for t in range(len(self.animator.datasets)):
+            data = self.animator.datasets[t][field].values
+            interp = self.interpolate_grid(data, self.animator.lon_grid, self.animator.lat_grid)
+            if np.isfinite(interp).sum() > 0:
+                valid_frames.append(t)
+
+        if not valid_frames:
+            print(f"No valid frames to plot for field '{field}'.")
+            return
+
+        fig = plt.figure(figsize=(16, 8))
+        proj = ccrs.PlateCarree()
+        ax1 = fig.add_subplot(1, 2, 1, projection=proj)
+        ax2 = fig.add_subplot(1, 2, 2, projection=proj)
+
+        def update(t):
+            ax1.clear()
+            ax2.clear()
+            data = self.animator.datasets[t][field].values
+            interp = self.interpolate_grid(data, self.animator.lon_grid, self.animator.lat_grid)
+            zoom = interp[np.ix_(lat_idx, lon_idx)]
+            valid = interp[np.isfinite(interp)]
+            if valid.size == 0:
+                return []
+
+            min_val, max_val = np.nanmin(valid), np.nanmax(valid)
+            log_cutoff = 1e-3
+            use_log = min_val > log_cutoff and (max_val / (min_val + 1e-6)) > 100
+            levels = np.logspace(np.log10(log_cutoff), np.log10(max_val), 20) if use_log else np.linspace(0, max_val, 20)
+            plot_data = np.where(interp > log_cutoff, interp, np.nan) if use_log else interp
+            scale_label = "Log" if use_log else "Linear"
+
+            c = self._plot_frame(ax1, plot_data, self.animator.lons, self.animator.lats,
+                                 f"T{t+1} | {field} (Full - {scale_label})", levels, scale_label, proj)
+            self._plot_frame(ax2, zoom, lon_zoom, lat_zoom,
+                             f"T{t+1} | {field} (Zoom - {scale_label})", levels, scale_label, proj)
+
+            self._add_country_labels(ax1, [self.animator.lons.min(), self.animator.lons.max(),
+                                           self.animator.lats.min(), self.animator.lats.max()])
+            self._add_country_labels(ax2, [lon_min, lon_max, lat_min, lat_max])
+
+           # Inside update() function:
+            if not hasattr(update, "colorbar"):
+                unit_label =  f"{field}:({self.animator.datasets[0][field].attrs.get("units", field)})" #self.animator.datasets[0][field].attrs.get("units", field)
+                update.colorbar = fig.colorbar(c, ax=[ax1, ax2], orientation='vertical', label=unit_label)
+                formatter = mticker.FuncFormatter(lambda x, _: f'{x:.2g}')
+                update.colorbar.ax.yaxis.set_major_formatter(formatter)
+
+            
+            if np.nanmax(valid) > self.threshold:
+                ax1.contour(self.animator.lons, self.animator.lats, interp, levels=[self.threshold],
+                        colors='red', linewidths=2, transform=proj)
+                ax2.contour(lon_zoom, lat_zoom, zoom, levels=[self.threshold],
+                            colors='red', linewidths=2, transform=proj)
+                ax2.text(0.99, 0.01, f"⚠ Max Thresold Exceed: {np.nanmax(valid):.2f} > {self.threshold}",
+                        transform=ax2.transAxes, ha='right', va='bottom',
+                        fontsize=9, color='red',
+                        bbox=dict(facecolor='white', alpha=0.8, edgecolor='red'))
+
+            if self.static_frame_export:
+                frame_folder = os.path.join(self.output_dir, "frames", field)
+            os.makedirs(frame_folder, exist_ok=True)
+            frame_path = os.path.join(frame_folder, f"frame_{t+1:04d}.jpg")
+            plt.savefig(frame_path, dpi=300, bbox_inches='tight')
+            print(f"🖼️ Saved static frame: {frame_path}")
+                    
+            return []
+
+        if self.include_metadata:
+            self._draw_metadata_sidebar(fig, meta)
+
+        self._make_dirs(output_path)
+        fig.tight_layout()
+        ani = animation.FuncAnimation(fig, update, frames=valid_frames, blit=False, cache_frame_data =False)
+        ani.save(output_path, writer='pillow', fps=self.fps)
+        plt.close()
+        print(f"✅ Saved enhanced 2D animation for {field} to {output_path}")
+
+    # def export_frames_as_jpgs(self, fields=None, include_metadata=True):
+    #     all_fields = self.get_available_2d_fields()
+    #     if fields:
+    #         fields = [f for f in fields if f in all_fields]
+    #     else:
+    #         fields = all_fields
+
+    #     meta = self.animator.datasets[0].attrs
+
+    #     for field in fields:
+    #         print(f"📤 Exporting frames for field: {field}")
+    #         output_folder = os.path.join(self.output_dir, "frames", field)
+    #         os.makedirs(output_folder, exist_ok=True)
+
+    #         center_lat, center_lon = self._get_max_concentration_location(field)
+    #         lat_idx, lon_idx, lon_min, lon_max, lat_min, lat_max = self._get_zoom_indices(center_lat, center_lon)
+    #         lat_zoom = self.animator.lats[lat_idx]
+    #         lon_zoom = self.animator.lons[lon_idx]
+
+    #         for t, ds in enumerate(self.animator.datasets):
+    #             data = ds[field].values
+    #             interp = self.interpolate_grid(data, self.animator.lon_grid, self.animator.lat_grid)
+    #             if not np.isfinite(interp).any():
+    #                 continue
+
+    #             fig = plt.figure(figsize=(16, 8))
+    #             proj = ccrs.PlateCarree()
+    #             ax1 = fig.add_subplot(1, 2, 1, projection=proj)
+    #             ax2 = fig.add_subplot(1, 2, 2, projection=proj)
+    #             zoom = interp[np.ix_(lat_idx, lon_idx)]
+    #             valid = interp[np.isfinite(interp)]
+    #             min_val, max_val = np.nanmin(valid), np.nanmax(valid)
+    #             log_cutoff = 1e-3
+    #             use_log = min_val > log_cutoff and (max_val / (min_val + 1e-6)) > 100
+    #             levels = np.logspace(np.log10(log_cutoff), np.log10(max_val), 20) if use_log else np.linspace(0, max_val, 20)
+    #             plot_data = np.where(interp > log_cutoff, interp, np.nan) if use_log else interp
+    #             scale_label = "Log" if use_log else "Linear"
+
+    #             c = self._plot_frame(ax1, plot_data, self.animator.lons, self.animator.lats,
+    #                                 f"T{t+1} | {field} (Full - {scale_label})", levels, scale_label, proj)
+    #             self._plot_frame(ax2, zoom, lon_zoom, lat_zoom,
+    #                             f"T{t+1} | {field} (Zoom - {scale_label})", levels, scale_label, proj)
+
+    #             self._add_country_labels(ax1, [self.animator.lons.min(), self.animator.lons.max(),
+    #                                         self.animator.lats.min(), self.animator.lats.max()])
+    #             self._add_country_labels(ax2, [lon_min, lon_max, lat_min, lat_max])
+
+    #             if include_metadata:
+    #                 self._draw_metadata_sidebar(fig, meta)
+
+    #             cbar = fig.colorbar(c, ax=[ax1, ax2], orientation='vertical', shrink=0.75, pad=0.03)
+    #             unit_label = f"{field}:({self.animator.datasets[0][field].attrs.get('units', field)})"
+    #             cbar.set_label(unit_label)
+    #             formatter = mticker.FuncFormatter(lambda x, _: f'{x:.2g}')
+    #             cbar.ax.yaxis.set_major_formatter(formatter)
+
+    #             if np.nanmax(valid) > self.threshold:
+    #                 ax1.contour(self.animator.lons, self.animator.lats, interp, levels=[self.threshold],
+    #                             colors='red', linewidths=2, transform=proj)
+    #                 ax2.contour(lon_zoom, lat_zoom, zoom, levels=[self.threshold],
+    #                             colors='red', linewidths=2, transform=proj)
+    #                 ax2.text(0.99, 0.01, f"⚠ Max: {np.nanmax(valid):.2f} > {self.threshold}",
+    #                         transform=ax2.transAxes, ha='right', va='bottom',
+    #                         fontsize=9, color='red',
+    #                         bbox=dict(facecolor='white', alpha=0.8, edgecolor='red'))
+
+    #             frame_path = os.path.join(output_folder, f"frame_{t+1:04d}.jpg")
+    #             plt.savefig(frame_path, dpi=150, bbox_inches='tight')
+    #             plt.close(fig)
+    #             print(f"📸 Saved {frame_path}")
+ '''
+ 
+import os
+import numpy as np
+import matplotlib.pyplot as plt
+import matplotlib.animation as animation
+import matplotlib.ticker as mticker
+import cartopy.crs as ccrs
+import cartopy.feature as cfeature
+import cartopy.io.shapereader as shpreader
+from adjustText import adjust_text
+from ash_animator.interpolation import interpolate_grid
+from ash_animator.basemaps import draw_etopo_basemap
+
+class Plot_Horizontal_Data:
+    def __init__(self, animator, output_dir="plots", cmap="rainbow", fps=2,
+                 include_metadata=True, threshold=0.1,
+                 zoom_width_deg=6.0, zoom_height_deg=6.0, zoom_level=7, static_frame_export=False):
+        self.animator = animator
+        self.output_dir = os.path.abspath(os.path.join(os.getcwd(), output_dir))
+        os.makedirs(self.output_dir, exist_ok=True)
+        self.cmap = cmap
+        self.fps = fps
+        self.include_metadata = include_metadata
+        self.threshold = threshold
+        self.zoom_width = zoom_width_deg
+        self.zoom_height = zoom_height_deg
+        shp = shpreader.natural_earth(resolution='110m', category='cultural', name='admin_0_countries')
+        self.country_geoms = list(shpreader.Reader(shp).records())
+        self.interpolate_grid= interpolate_grid
+        self._draw_etopo_basemap=draw_etopo_basemap
+        self.zoom_level=zoom_level
+        self.static_frame_export=static_frame_export
+
+    def _make_dirs(self, path):
+        os.makedirs(os.path.abspath(os.path.join(os.getcwd(), os.path.dirname(path))), exist_ok=True)
+
+    def _get_max_concentration_location(self, field):
+        max_val = -np.inf
+        lat = lon = None
+        for ds in self.animator.datasets:
+            data = ds[field].values
+            if np.max(data) > max_val:
+                max_val = np.max(data)
+                idx = np.unravel_index(np.argmax(data), data.shape)
+                lat = self.animator.lat_grid[idx]
+                lon = self.animator.lon_grid[idx]
+        return lat, lon
+
+    def _get_zoom_indices(self, center_lat, center_lon):
+        lon_min = center_lon - self.zoom_width / 2
+        lon_max = center_lon + self.zoom_width / 2
+        lat_min = center_lat - self.zoom_height / 2
+        lat_max = center_lat + self.zoom_height / 2
+        lat_idx = np.where((self.animator.lats >= lat_min) & (self.animator.lats <= lat_max))[0]
+        lon_idx = np.where((self.animator.lons >= lon_min) & (self.animator.lons <= lon_max))[0]
+        return lat_idx, lon_idx, lon_min, lon_max, lat_min, lat_max
+
+    def _add_country_labels(self, ax, extent):
+        proj = ccrs.PlateCarree()
+        texts = []
+        for country in self.country_geoms:
+            name = country.attributes['NAME_LONG']
+            geom = country.geometry
+            try:
+                lon, lat = geom.centroid.x, geom.centroid.y
+                if extent[0] <= lon <= extent[1] and extent[2] <= lat <= extent[3]:
+                    text = ax.text(lon, lat, name, fontsize=6, transform=proj,
+                                   ha='center', va='center', color='white',
+                                   bbox=dict(facecolor='black', alpha=0.5, linewidth=0))
+                    texts.append(text)
+            except:
+                continue
+        adjust_text(texts, ax=ax, only_move={'points': 'y', 'text': 'y'},
+                    arrowprops=dict(arrowstyle="->", color='white', lw=0.5))
+
+    def _draw_metadata_sidebar(self, fig, meta_dict):
+        lines = [
+        f"Run name:        {meta_dict.get('run_name', 'N/A')}",
+        f"Run time:        {meta_dict.get('run_time', 'N/A')}",
+        f"Met data:        {meta_dict.get('met_data', 'N/A')}",
+        f"Start release:   {meta_dict.get('start_of_release', 'N/A')}",
+        f"End release:     {meta_dict.get('end_of_release', 'N/A')}",
+        f"Source strength: {meta_dict.get('source_strength', 'N/A')} g/s",
+        f"Release loc:     {meta_dict.get('release_location', 'N/A')}",
+        f"Release height:  {meta_dict.get('release_height', 'N/A')} m asl",
+        f"Run duration:    {meta_dict.get('run_duration', 'N/A')}"
+        ]
+
+        # Split into two columns
+        mid = len(lines) // 2 + len(lines) % 2
+        left_lines = lines[:mid]
+        right_lines = lines[mid:]
+
+        left_text = "\n".join(left_lines)
+        right_text = "\n".join(right_lines)
+
+        # right column
+        fig.text(0.05, 0.05, left_text, va='bottom', ha='left',
+                fontsize=9, family='monospace', color='black',
+                bbox=dict(facecolor='white', alpha=0.8, edgecolor='gray'))
+
+        # left column
+        fig.text(0.3, 0.05, right_text, va='bottom', ha='left',
+                fontsize=9, family='monospace', color='black',
+                bbox=dict(facecolor='white', alpha=0.8, edgecolor='gray'))
+
+    
+    
+
+
+    def _plot_frame(self, ax, data, lons, lats, title, levels, scale_label, proj):
+        self._draw_etopo_basemap(ax, mode='basemap', zoom=self.zoom_level)
+        c = ax.contourf(lons, lats, data, levels=levels, cmap=self.cmap, alpha=0.6, transform=proj)
+        ax.set_title(title)
+        ax.set_extent([lons.min(), lons.max(), lats.min(), lats.max()])
+        ax.coastlines()
+        ax.add_feature(cfeature.BORDERS, linestyle=':')
+        ax.add_feature(cfeature.LAND)
+        ax.add_feature(cfeature.OCEAN)
+        return c
+
+    def get_available_2d_fields(self):
+        ds = self.animator.datasets[0]
+        return [v for v in ds.data_vars if ds[v].ndim == 2]
+
+    def plot_single_field_over_time(self, field, filename="field.gif"):
+        output_path = os.path.join(self.output_dir, "2d_fields", field, filename)
+        meta = self.animator.datasets[0].attrs
+        center_lat, center_lon = self._get_max_concentration_location(field)
+        lat_idx, lon_idx, lon_min, lon_max, lat_min, lat_max = self._get_zoom_indices(center_lat, center_lon)
+        lat_zoom = self.animator.lats[lat_idx]
+        lon_zoom = self.animator.lons[lon_idx]
+
+        valid_frames = []
+        for t in range(len(self.animator.datasets)):
+            data = self.animator.datasets[t][field].values
+            interp = self.interpolate_grid(data, self.animator.lon_grid, self.animator.lat_grid)
+            if np.isfinite(interp).sum() > 0:
+                valid_frames.append(t)
+
+        if not valid_frames:
+            print(f"No valid frames to plot for field '{field}'.")
+            return
+
+        fig = plt.figure(figsize=(16, 8))
+        proj = ccrs.PlateCarree()
+        ax1 = fig.add_subplot(1, 2, 1, projection=proj)
+        ax2 = fig.add_subplot(1, 2, 2, projection=proj)
+
+        def update(t):
+            ax1.clear()
+            ax2.clear()
+            data = self.animator.datasets[t][field].values
+            interp = self.interpolate_grid(data, self.animator.lon_grid, self.animator.lat_grid)
+            zoom = interp[np.ix_(lat_idx, lon_idx)]
+            valid = interp[np.isfinite(interp)]
+            if valid.size == 0:
+                return []
+
+            min_val, max_val = np.nanmin(valid), np.nanmax(valid)
+            log_cutoff = 1e-3
+            use_log = min_val > log_cutoff and (max_val / (min_val + 1e-6)) > 100
+            levels = np.logspace(np.log10(log_cutoff), np.log10(max_val), 20) if use_log else np.linspace(0, max_val, 20)
+            plot_data = np.where(interp > log_cutoff, interp, np.nan) if use_log else interp
+            scale_label = "Log" if use_log else "Linear"
+
+            c = self._plot_frame(ax1, plot_data, self.animator.lons, self.animator.lats,
+                                 f"T{t+1} | {field} (Full - {scale_label})", levels, scale_label, proj)
+            self._plot_frame(ax2, zoom, lon_zoom, lat_zoom,
+                             f"T{t+1} | {field} (Zoom - {scale_label})", levels, scale_label, proj)
+
+            self._add_country_labels(ax1, [self.animator.lons.min(), self.animator.lons.max(),
+                                           self.animator.lats.min(), self.animator.lats.max()])
+            self._add_country_labels(ax2, [lon_min, lon_max, lat_min, lat_max])
+
+           # Inside update() function:
+            if not hasattr(update, "colorbar"):
+                unit_label =  f"{field}:({self.animator.datasets[0][field].attrs.get('units', field)})" #self.animator.datasets[0][field].attrs.get("units", field)
+                update.colorbar = fig.colorbar(c, ax=[ax1, ax2], orientation='vertical', label=unit_label)
+                formatter = mticker.FuncFormatter(lambda x, _: f'{x:.2g}')
+                update.colorbar.ax.yaxis.set_major_formatter(formatter)
+
+            
+            if np.nanmax(valid) > self.threshold:
+                ax1.contour(self.animator.lons, self.animator.lats, interp, levels=[self.threshold],
+                        colors='red', linewidths=2, transform=proj)
+                ax2.contour(lon_zoom, lat_zoom, zoom, levels=[self.threshold],
+                            colors='red', linewidths=2, transform=proj)
+                ax2.text(0.99, 0.01, f"⚠ Max Thresold Exceed: {np.nanmax(valid):.2f} > {self.threshold}",
+                        transform=ax2.transAxes, ha='right', va='bottom',
+                        fontsize=9, color='red',
+                        bbox=dict(facecolor='white', alpha=0.8, edgecolor='red'))
+
+            if self.static_frame_export:
+                frame_folder = os.path.join(self.output_dir, "frames", field)
+            os.makedirs(frame_folder, exist_ok=True)
+            frame_path = os.path.join(frame_folder, f"frame_{t+1:04d}.jpg")
+            plt.savefig(frame_path, dpi=300, bbox_inches='tight')
+            print(f"🖼️ Saved static frame: {frame_path}")
+                    
+            return []
+
+        if self.include_metadata:
+            self._draw_metadata_sidebar(fig, meta)
+
+        self._make_dirs(output_path)
+        fig.tight_layout()
+        ani = animation.FuncAnimation(fig, update, frames=valid_frames, blit=False, cache_frame_data =False)
+        ani.save(output_path, writer='pillow', fps=self.fps)
+        plt.close()
+        print(f"✅ Saved enhanced 2D animation for {field} to {output_path}")
+
+    # def export_frames_as_jpgs(self, fields=None, include_metadata=True):
+    #     all_fields = self.get_available_2d_fields()
+    #     if fields:
+    #         fields = [f for f in fields if f in all_fields]
+    #     else:
+    #         fields = all_fields
+
+    #     meta = self.animator.datasets[0].attrs
+
+    #     for field in fields:
+    #         print(f"📤 Exporting frames for field: {field}")
+    #         output_folder = os.path.join(self.output_dir, "frames", field)
+    #         os.makedirs(output_folder, exist_ok=True)
+
+    #         center_lat, center_lon = self._get_max_concentration_location(field)
+    #         lat_idx, lon_idx, lon_min, lon_max, lat_min, lat_max = self._get_zoom_indices(center_lat, center_lon)
+    #         lat_zoom = self.animator.lats[lat_idx]
+    #         lon_zoom = self.animator.lons[lon_idx]
+
+    #         for t, ds in enumerate(self.animator.datasets):
+    #             data = ds[field].values
+    #             interp = self.interpolate_grid(data, self.animator.lon_grid, self.animator.lat_grid)
+    #             if not np.isfinite(interp).any():
+    #                 continue
+
+    #             fig = plt.figure(figsize=(16, 8))
+    #             proj = ccrs.PlateCarree()
+    #             ax1 = fig.add_subplot(1, 2, 1, projection=proj)
+    #             ax2 = fig.add_subplot(1, 2, 2, projection=proj)
+    #             zoom = interp[np.ix_(lat_idx, lon_idx)]
+    #             valid = interp[np.isfinite(interp)]
+    #             min_val, max_val = np.nanmin(valid), np.nanmax(valid)
+    #             log_cutoff = 1e-3
+    #             use_log = min_val > log_cutoff and (max_val / (min_val + 1e-6)) > 100
+    #             levels = np.logspace(np.log10(log_cutoff), np.log10(max_val), 20) if use_log else np.linspace(0, max_val, 20)
+    #             plot_data = np.where(interp > log_cutoff, interp, np.nan) if use_log else interp
+    #             scale_label = "Log" if use_log else "Linear"
+
+    #             c = self._plot_frame(ax1, plot_data, self.animator.lons, self.animator.lats,
+    #                                 f"T{t+1} | {field} (Full - {scale_label})", levels, scale_label, proj)
+    #             self._plot_frame(ax2, zoom, lon_zoom, lat_zoom,
+    #                             f"T{t+1} | {field} (Zoom - {scale_label})", levels, scale_label, proj)
+
+    #             self._add_country_labels(ax1, [self.animator.lons.min(), self.animator.lons.max(),
+    #                                         self.animator.lats.min(), self.animator.lats.max()])
+    #             self._add_country_labels(ax2, [lon_min, lon_max, lat_min, lat_max])
+
+    #             if include_metadata:
+    #                 self._draw_metadata_sidebar(fig, meta)
+
+    #             cbar = fig.colorbar(c, ax=[ax1, ax2], orientation='vertical', shrink=0.75, pad=0.03)
+    #             unit_label = f"{field}:({self.animator.datasets[0][field].attrs.get('units', field)})"
+    #             cbar.set_label(unit_label)
+    #             formatter = mticker.FuncFormatter(lambda x, _: f'{x:.2g}')
+    #             cbar.ax.yaxis.set_major_formatter(formatter)
+
+    #             if np.nanmax(valid) > self.threshold:
+    #                 ax1.contour(self.animator.lons, self.animator.lats, interp, levels=[self.threshold],
+    #                             colors='red', linewidths=2, transform=proj)
+    #                 ax2.contour(lon_zoom, lat_zoom, zoom, levels=[self.threshold],
+    #                             colors='red', linewidths=2, transform=proj)
+    #                 ax2.text(0.99, 0.01, f"⚠ Max: {np.nanmax(valid):.2f} > {self.threshold}",
+    #                         transform=ax2.transAxes, ha='right', va='bottom',
+    #                         fontsize=9, color='red',
+    #                         bbox=dict(facecolor='white', alpha=0.8, edgecolor='red'))
+
+    #             frame_path = os.path.join(output_folder, f"frame_{t+1:04d}.jpg")
+    #             plt.savefig(frame_path, dpi=150, bbox_inches='tight')
+    #             plt.close(fig)
+    #             print(f"📸 Saved {frame_path}")

ash_animator/utils.py

@@ -0,0 +1,23 @@
+
+from geopy.geocoders import Nominatim
+import numpy as np
+
+def create_grid(attrs):
+    x_origin = float(attrs["x_origin"])
+    y_origin = float(attrs["y_origin"])
+    x_res = float(attrs["x_res"])
+    y_res = float(attrs["y_res"])
+    x_grid_size = int(attrs["x_grid_size"])
+    y_grid_size = int(attrs["y_grid_size"])
+
+    lons = np.round(np.linspace(x_origin, x_origin + (x_grid_size - 1) * x_res, x_grid_size), 6)
+    lats = np.round(np.linspace(y_origin, y_origin + (y_grid_size - 1) * y_res, y_grid_size), 6)
+    return lons, lats, np.meshgrid(lons, lats)
+
+def get_country_label(lat, lon):
+    geolocator = Nominatim(user_agent="ash_animator")
+    try:
+        location = geolocator.reverse((lat, lon), language='en')
+        return location.raw['address'].get('country', 'Unknown')
+    except:
+        return "Unknown"

media/Taal_273070_20200112_scenario_yizhou.zip

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:9bb340a75132c3008a149557ff85f8bc05b4a46e70eee027503e30b9573fdd39
+size 181349

media/last_run.txt

@@ -0,0 +1 @@
+media\default_model.zip

unzipped/Taal_273070_20200112_scenario_yizhou/Taal_273070_20200112_0500_20250107041508.174287/AQOutput_3DField_C1_T10_202001121400_Z1.txt

@@ -0,0 +1,97 @@
+ NAME III (version 8.2)                                          
+ Run name:                   Taal_273070_20250107041508.174287
+ Run time:                   07/01/2025 04:15:10.918 UTC
+ Met data:                   NWP Flow.EC HRES Flow
+ Start of release:           12/01/2020 06:57 UTC
+ End of release:             12/01/2020 21:10 UTC
+ Source strength:            5.333333E+08 g / s
+ Release location:           120.9930E   14.0020N
+ Release height:             311.000 to 15311.000m asl
+ Run duration:               7day 0hr 0min
+ X grid origin:                 90.00000    
+ Y grid origin:                -15.00000    
+ X grid size:                         281
+ Y grid size:                         221
+ X grid resolution:            0.2500000    
+ Y grid resolution:            0.2500000    
+ Number of preliminary cols:            4
+ Number of field cols:                  1
+ 
+ Fields:
+                        ,                        ,                        ,                        ,                  VOLCANIC,
+                        ,                        ,                        ,                        ,               AirConc Ash,
+                        ,                        ,                        ,                        ,         Air Concentration,
+                        ,                        ,                        ,                        ,              VOLCANIC_ASH,
+                        ,                        ,                        ,                        ,                   g / m^3,
+                        ,                        ,                        ,                        ,               All sources,
+                        ,                        ,                        ,                        ,     No ensemble averaging,
+                        ,                        ,                        ,                        ,          1hr 0min average,
+                        ,                        ,                        ,                        ,   No horizontal averaging,
+                        ,                        ,                        ,                        ,     No vertical averaging,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,      12/01/2020 14:00 UTC,
+                        ,                        ,                        ,                        ,            Z = 1000 m agl,
+                        ,                        ,                        ,                        ,                          ,
+                 X Index,                 Y Index,            X (Lat-Long),            Y (Lat-Long),                          ,
+                     120,                     114,                  119.75,                   13.25,              7.345203E-05,
+                     120,                     115,                  119.75,                    13.5,              5.622633E-05,
+                     120,                     116,                  119.75,                   13.75,              2.600824E-05,
+                     121,                     113,                     120,                      13,              0.0001420568,
+                     121,                     114,                     120,                   13.25,               0.001363128,
+                     121,                     115,                     120,                    13.5,               0.003970164,
+                     121,                     116,                     120,                   13.75,                0.00291151,
+                     121,                     117,                     120,                      14,              9.206738E-05,
+                     121,                     118,                     120,                   14.25,              1.456495E-05,
+                     122,                     113,                  120.25,                      13,               0.001457789,
+                     122,                     114,                  120.25,                   13.25,                0.01133905,
+                     122,                     115,                  120.25,                    13.5,                0.03271282,
+                     122,                     116,                  120.25,                   13.75,                0.03133794,
+                     122,                     117,                  120.25,                      14,               0.003700373,
+                     123,                     112,                   120.5,                   12.75,              3.815254E-05,
+                     123,                     113,                   120.5,                      13,               0.001681373,
+                     123,                     114,                   120.5,                   13.25,                0.03288734,
+                     123,                     115,                   120.5,                    13.5,                0.07128608,
+                     123,                     116,                   120.5,                   13.75,                 0.1296768,
+                     123,                     117,                   120.5,                      14,                0.04034004,
+                     123,                     118,                   120.5,                   14.25,              5.493374E-05,
+                     124,                     113,                  120.75,                      13,              0.0002777606,
+                     124,                     114,                  120.75,                   13.25,                0.01638796,
+                     124,                     115,                  120.75,                    13.5,                0.03514561,
+                     124,                     116,                  120.75,                   13.75,                 0.1086908,
+                     124,                     117,                  120.75,                      14,                 0.1927676,
+                     124,                     118,                  120.75,                   14.25,              0.0002998679,
+                     124,                     119,                  120.75,                    14.5,              1.071569E-10,
+                     125,                     113,                     121,                      13,               0.000159862,
+                     125,                     114,                     121,                   13.25,               0.002424539,
+                     125,                     115,                     121,                    13.5,               0.002680934,
+                     125,                     116,                     121,                   13.75,               0.003586116,
+                     125,                     117,                     121,                      14,                  0.142053,
+                     125,                     118,                     121,                   14.25,               0.003128162,
+                     125,                     119,                     121,                    14.5,              6.248734E-05,
+                     126,                     113,                  121.25,                      13,              1.786754E-05,
+                     126,                     115,                  121.25,                    13.5,              1.350236E-05,
+                     126,                     116,                  121.25,                   13.75,               1.28469E-05,
+                     126,                     117,                  121.25,                      14,              0.0001430601,
+                     126,                     118,                  121.25,                   14.25,               0.001556279,
+                     126,                     119,                  121.25,                    14.5,               0.001372935,
+                     126,                     120,                  121.25,                   14.75,              0.0002339001,
+                     126,                     121,                  121.25,                      15,              3.106254E-05,
+                     127,                     118,                   121.5,                   14.25,              0.0002478267,
+                     127,                     119,                   121.5,                    14.5,               0.001072011,
+                     127,                     120,                   121.5,                   14.75,              0.0005181016,
+                     127,                     121,                   121.5,                      15,              6.368926E-05,
+                     128,                     119,                  121.75,                    14.5,              1.124057E-05,
+                     128,                     120,                  121.75,                   14.75,              0.0001651402,
+                     128,                     121,                  121.75,                      15,               0.000116237,
+                     128,                     122,                  121.75,                   15.25,               0.000122752,
+                     128,                     123,                  121.75,                    15.5,              3.474941E-05,
+                     128,                     124,                  121.75,                   15.75,              1.624418E-05,
+                     128,                     125,                  121.75,                      16,              4.155787E-06,
+                     129,                     121,                     122,                      15,              2.920656E-05,
+                     129,                     122,                     122,                   15.25,              5.199026E-05,
+                     129,                     123,                     122,                    15.5,                3.1246E-05,
+                     129,                     124,                     122,                   15.75,              1.447262E-06,
+                     130,                     123,                  122.25,                    15.5,              6.670825E-06,
+                     130,                     124,                  122.25,                   15.75,              1.719066E-05,

unzipped/Taal_273070_20200112_scenario_yizhou/Taal_273070_20200112_0500_20250107041508.174287/AQOutput_3DField_C1_T10_202001121400_Z10.txt

@@ -0,0 +1,37 @@
+ NAME III (version 8.2)                                          
+ Run name:                   Taal_273070_20250107041508.174287
+ Run time:                   07/01/2025 04:15:10.918 UTC
+ Met data:                   NWP Flow.EC HRES Flow
+ Start of release:           12/01/2020 06:57 UTC
+ End of release:             12/01/2020 21:10 UTC
+ Source strength:            5.333333E+08 g / s
+ Release location:           120.9930E   14.0020N
+ Release height:             311.000 to 15311.000m asl
+ Run duration:               7day 0hr 0min
+ X grid origin:                 90.00000    
+ Y grid origin:                -15.00000    
+ X grid size:                         281
+ Y grid size:                         221
+ X grid resolution:            0.2500000    
+ Y grid resolution:            0.2500000    
+ Number of preliminary cols:            4
+ Number of field cols:                  1
+ 
+ Fields:
+                        ,                        ,                        ,                        ,                  VOLCANIC,
+                        ,                        ,                        ,                        ,               AirConc Ash,
+                        ,                        ,                        ,                        ,         Air Concentration,
+                        ,                        ,                        ,                        ,              VOLCANIC_ASH,
+                        ,                        ,                        ,                        ,                   g / m^3,
+                        ,                        ,                        ,                        ,               All sources,
+                        ,                        ,                        ,                        ,     No ensemble averaging,
+                        ,                        ,                        ,                        ,          1hr 0min average,
+                        ,                        ,                        ,                        ,   No horizontal averaging,
+                        ,                        ,                        ,                        ,     No vertical averaging,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,      12/01/2020 14:00 UTC,
+                        ,                        ,                        ,                        ,           Z = 19000 m agl,
+                        ,                        ,                        ,                        ,                          ,
+                 X Index,                 Y Index,            X (Lat-Long),            Y (Lat-Long),                          ,

unzipped/Taal_273070_20200112_scenario_yizhou/Taal_273070_20200112_0500_20250107041508.174287/AQOutput_3DField_C1_T10_202001121400_Z11.txt

@@ -0,0 +1,37 @@
+ NAME III (version 8.2)                                          
+ Run name:                   Taal_273070_20250107041508.174287
+ Run time:                   07/01/2025 04:15:10.918 UTC
+ Met data:                   NWP Flow.EC HRES Flow
+ Start of release:           12/01/2020 06:57 UTC
+ End of release:             12/01/2020 21:10 UTC
+ Source strength:            5.333333E+08 g / s
+ Release location:           120.9930E   14.0020N
+ Release height:             311.000 to 15311.000m asl
+ Run duration:               7day 0hr 0min
+ X grid origin:                 90.00000    
+ Y grid origin:                -15.00000    
+ X grid size:                         281
+ Y grid size:                         221
+ X grid resolution:            0.2500000    
+ Y grid resolution:            0.2500000    
+ Number of preliminary cols:            4
+ Number of field cols:                  1
+ 
+ Fields:
+                        ,                        ,                        ,                        ,                  VOLCANIC,
+                        ,                        ,                        ,                        ,               AirConc Ash,
+                        ,                        ,                        ,                        ,         Air Concentration,
+                        ,                        ,                        ,                        ,              VOLCANIC_ASH,
+                        ,                        ,                        ,                        ,                   g / m^3,
+                        ,                        ,                        ,                        ,               All sources,
+                        ,                        ,                        ,                        ,     No ensemble averaging,
+                        ,                        ,                        ,                        ,          1hr 0min average,
+                        ,                        ,                        ,                        ,   No horizontal averaging,
+                        ,                        ,                        ,                        ,     No vertical averaging,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,      12/01/2020 14:00 UTC,
+                        ,                        ,                        ,                        ,           Z = 22500 m agl,
+                        ,                        ,                        ,                        ,                          ,
+                 X Index,                 Y Index,            X (Lat-Long),            Y (Lat-Long),                          ,

unzipped/Taal_273070_20200112_scenario_yizhou/Taal_273070_20200112_0500_20250107041508.174287/AQOutput_3DField_C1_T10_202001121400_Z12.txt

@@ -0,0 +1,37 @@
+ NAME III (version 8.2)                                          
+ Run name:                   Taal_273070_20250107041508.174287
+ Run time:                   07/01/2025 04:15:10.918 UTC
+ Met data:                   NWP Flow.EC HRES Flow
+ Start of release:           12/01/2020 06:57 UTC
+ End of release:             12/01/2020 21:10 UTC
+ Source strength:            5.333333E+08 g / s
+ Release location:           120.9930E   14.0020N
+ Release height:             311.000 to 15311.000m asl
+ Run duration:               7day 0hr 0min
+ X grid origin:                 90.00000    
+ Y grid origin:                -15.00000    
+ X grid size:                         281
+ Y grid size:                         221
+ X grid resolution:            0.2500000    
+ Y grid resolution:            0.2500000    
+ Number of preliminary cols:            4
+ Number of field cols:                  1
+ 
+ Fields:
+                        ,                        ,                        ,                        ,                  VOLCANIC,
+                        ,                        ,                        ,                        ,               AirConc Ash,
+                        ,                        ,                        ,                        ,         Air Concentration,
+                        ,                        ,                        ,                        ,              VOLCANIC_ASH,
+                        ,                        ,                        ,                        ,                   g / m^3,
+                        ,                        ,                        ,                        ,               All sources,
+                        ,                        ,                        ,                        ,     No ensemble averaging,
+                        ,                        ,                        ,                        ,          1hr 0min average,
+                        ,                        ,                        ,                        ,   No horizontal averaging,
+                        ,                        ,                        ,                        ,     No vertical averaging,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,      12/01/2020 14:00 UTC,
+                        ,                        ,                        ,                        ,           Z = 27500 m agl,
+                        ,                        ,                        ,                        ,                          ,
+                 X Index,                 Y Index,            X (Lat-Long),            Y (Lat-Long),                          ,

unzipped/Taal_273070_20200112_scenario_yizhou/Taal_273070_20200112_0500_20250107041508.174287/AQOutput_3DField_C1_T10_202001121400_Z2.txt

@@ -0,0 +1,112 @@
+ NAME III (version 8.2)                                          
+ Run name:                   Taal_273070_20250107041508.174287
+ Run time:                   07/01/2025 04:15:10.918 UTC
+ Met data:                   NWP Flow.EC HRES Flow
+ Start of release:           12/01/2020 06:57 UTC
+ End of release:             12/01/2020 21:10 UTC
+ Source strength:            5.333333E+08 g / s
+ Release location:           120.9930E   14.0020N
+ Release height:             311.000 to 15311.000m asl
+ Run duration:               7day 0hr 0min
+ X grid origin:                 90.00000    
+ Y grid origin:                -15.00000    
+ X grid size:                         281
+ Y grid size:                         221
+ X grid resolution:            0.2500000    
+ Y grid resolution:            0.2500000    
+ Number of preliminary cols:            4
+ Number of field cols:                  1
+ 
+ Fields:
+                        ,                        ,                        ,                        ,                  VOLCANIC,
+                        ,                        ,                        ,                        ,               AirConc Ash,
+                        ,                        ,                        ,                        ,         Air Concentration,
+                        ,                        ,                        ,                        ,              VOLCANIC_ASH,
+                        ,                        ,                        ,                        ,                   g / m^3,
+                        ,                        ,                        ,                        ,               All sources,
+                        ,                        ,                        ,                        ,     No ensemble averaging,
+                        ,                        ,                        ,                        ,          1hr 0min average,
+                        ,                        ,                        ,                        ,   No horizontal averaging,
+                        ,                        ,                        ,                        ,     No vertical averaging,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,      12/01/2020 14:00 UTC,
+                        ,                        ,                        ,                        ,            Z = 3000 m agl,
+                        ,                        ,                        ,                        ,                          ,
+                 X Index,                 Y Index,            X (Lat-Long),            Y (Lat-Long),                          ,
+                     120,                     113,                  119.75,                      13,              3.151353E-05,
+                     120,                     114,                  119.75,                   13.25,              2.210932E-05,
+                     120,                     115,                  119.75,                    13.5,              1.178464E-05,
+                     121,                     113,                     120,                      13,              0.0001126801,
+                     121,                     114,                     120,                   13.25,              0.0005374243,
+                     121,                     115,                     120,                    13.5,              0.0002840176,
+                     121,                     116,                     120,                   13.75,              4.521007E-05,
+                     122,                     112,                  120.25,                   12.75,              4.670541E-05,
+                     122,                     113,                  120.25,                      13,               0.001202281,
+                     122,                     114,                  120.25,                   13.25,               0.003869232,
+                     122,                     115,                  120.25,                    13.5,               0.001962312,
+                     122,                     116,                  120.25,                   13.75,              0.0001883732,
+                     123,                     112,                   120.5,                   12.75,              2.581522E-05,
+                     123,                     113,                   120.5,                      13,               0.002264641,
+                     123,                     114,                   120.5,                   13.25,                0.01127036,
+                     123,                     115,                   120.5,                    13.5,               0.004743796,
+                     123,                     116,                   120.5,                   13.75,               0.004018477,
+                     123,                     117,                   120.5,                      14,              9.492574E-05,
+                     124,                     113,                  120.75,                      13,              0.0008278259,
+                     124,                     114,                  120.75,                   13.25,               0.007400203,
+                     124,                     115,                  120.75,                    13.5,                 0.0391963,
+                     124,                     116,                  120.75,                   13.75,                0.07150318,
+                     124,                     117,                  120.75,                      14,               0.008536345,
+                     125,                     114,                     121,                   13.25,               0.001417874,
+                     125,                     115,                     121,                    13.5,                 0.0306792,
+                     125,                     116,                     121,                   13.75,                 0.1119654,
+                     125,                     117,                     121,                      14,                 0.2439914,
+                     125,                     118,                     121,                   14.25,                0.02892056,
+                     125,                     119,                     121,                    14.5,               0.001362004,
+                     125,                     120,                     121,                   14.75,              0.0002818799,
+                     125,                     121,                     121,                      15,              8.935516E-05,
+                     126,                     113,                  121.25,                      13,              9.283876E-06,
+                     126,                     114,                  121.25,                   13.25,              4.714714E-05,
+                     126,                     115,                  121.25,                    13.5,               0.002435901,
+                     126,                     116,                  121.25,                   13.75,                0.02259675,
+                     126,                     117,                  121.25,                      14,                0.06305796,
+                     126,                     118,                  121.25,                   14.25,                0.06351896,
+                     126,                     119,                  121.25,                    14.5,                0.02769424,
+                     126,                     120,                  121.25,                   14.75,                 0.0255998,
+                     126,                     121,                  121.25,                      15,                0.01439965,
+                     126,                     122,                  121.25,                   15.25,               0.002417035,
+                     126,                     123,                  121.25,                    15.5,              0.0002603215,
+                     126,                     124,                  121.25,                   15.75,              6.742119E-05,
+                     127,                     116,                   121.5,                   13.75,              0.0009422529,
+                     127,                     117,                   121.5,                      14,               0.007668528,
+                     127,                     118,                   121.5,                   14.25,                 0.0222777,
+                     127,                     119,                   121.5,                    14.5,                0.02496219,
+                     127,                     120,                   121.5,                   14.75,                0.02905941,
+                     127,                     121,                   121.5,                      15,                0.01414512,
+                     127,                     122,                   121.5,                   15.25,               0.002081324,
+                     127,                     123,                   121.5,                    15.5,              0.0002854613,
+                     127,                     124,                   121.5,                   15.75,               4.66012E-05,
+                     128,                     116,                  121.75,                   13.75,               1.17622E-05,
+                     128,                     117,                  121.75,                      14,              0.0001454951,
+                     128,                     118,                  121.75,                   14.25,               0.001557329,
+                     128,                     119,                  121.75,                    14.5,               0.003246944,
+                     128,                     120,                  121.75,                   14.75,               0.003654109,
+                     128,                     121,                  121.75,                      15,               0.002385811,
+                     128,                     122,                  121.75,                   15.25,              0.0004549951,
+                     128,                     123,                  121.75,                    15.5,              8.048277E-05,
+                     128,                     125,                  121.75,                      16,              1.627556E-05,
+                     129,                     119,                     122,                    14.5,              3.451304E-05,
+                     129,                     120,                     122,                   14.75,               0.000101785,
+                     129,                     121,                     122,                      15,              0.0001553481,
+                     129,                     122,                     122,                   15.25,              0.0002352085,
+                     129,                     123,                     122,                    15.5,              0.0002999381,
+                     129,                     124,                     122,                   15.75,               0.000136597,
+                     129,                     125,                     122,                      16,               6.32211E-05,
+                     129,                     126,                     122,                   16.25,              7.975153E-06,
+                     130,                     122,                  122.25,                   15.25,              7.096558E-06,
+                     130,                     123,                  122.25,                    15.5,              2.498302E-05,
+                     130,                     124,                  122.25,                   15.75,              0.0001287205,
+                     130,                     125,                  122.25,                      16,              6.148266E-05,
+                     130,                     126,                  122.25,                   16.25,              4.595343E-05,
+                     131,                     126,                   122.5,                   16.25,              5.254344E-06,

unzipped/Taal_273070_20200112_scenario_yizhou/Taal_273070_20200112_0500_20250107041508.174287/AQOutput_3DField_C1_T10_202001121400_Z3.txt

@@ -0,0 +1,98 @@
+ NAME III (version 8.2)                                          
+ Run name:                   Taal_273070_20250107041508.174287
+ Run time:                   07/01/2025 04:15:10.918 UTC
+ Met data:                   NWP Flow.EC HRES Flow
+ Start of release:           12/01/2020 06:57 UTC
+ End of release:             12/01/2020 21:10 UTC
+ Source strength:            5.333333E+08 g / s
+ Release location:           120.9930E   14.0020N
+ Release height:             311.000 to 15311.000m asl
+ Run duration:               7day 0hr 0min
+ X grid origin:                 90.00000    
+ Y grid origin:                -15.00000    
+ X grid size:                         281
+ Y grid size:                         221
+ X grid resolution:            0.2500000    
+ Y grid resolution:            0.2500000    
+ Number of preliminary cols:            4
+ Number of field cols:                  1
+ 
+ Fields:
+                        ,                        ,                        ,                        ,                  VOLCANIC,
+                        ,                        ,                        ,                        ,               AirConc Ash,
+                        ,                        ,                        ,                        ,         Air Concentration,
+                        ,                        ,                        ,                        ,              VOLCANIC_ASH,
+                        ,                        ,                        ,                        ,                   g / m^3,
+                        ,                        ,                        ,                        ,               All sources,
+                        ,                        ,                        ,                        ,     No ensemble averaging,
+                        ,                        ,                        ,                        ,          1hr 0min average,
+                        ,                        ,                        ,                        ,   No horizontal averaging,
+                        ,                        ,                        ,                        ,     No vertical averaging,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,      12/01/2020 14:00 UTC,
+                        ,                        ,                        ,                        ,            Z = 5000 m agl,
+                        ,                        ,                        ,                        ,                          ,
+                 X Index,                 Y Index,            X (Lat-Long),            Y (Lat-Long),                          ,
+                     124,                     120,                  120.75,                   14.75,              1.832862E-05,
+                     125,                     117,                     121,                      14,                 0.1071744,
+                     125,                     118,                     121,                   14.25,                 0.1898806,
+                     125,                     119,                     121,                    14.5,                 0.1062204,
+                     125,                     120,                     121,                   14.75,                0.04167035,
+                     125,                     121,                     121,                      15,               0.009898688,
+                     125,                     122,                     121,                   15.25,               0.001467171,
+                     125,                     123,                     121,                    15.5,              5.674901E-05,
+                     126,                     117,                  121.25,                      14,              0.0002987186,
+                     126,                     118,                  121.25,                   14.25,                0.02782325,
+                     126,                     119,                  121.25,                    14.5,                0.09352003,
+                     126,                     120,                  121.25,                   14.75,                 0.1199462,
+                     126,                     121,                  121.25,                      15,                 0.1002778,
+                     126,                     122,                  121.25,                   15.25,                0.04825792,
+                     126,                     123,                  121.25,                    15.5,               0.009866159,
+                     126,                     124,                  121.25,                   15.75,              0.0004914963,
+                     127,                     118,                   121.5,                   14.25,              0.0008210147,
+                     127,                     119,                   121.5,                    14.5,                0.01132668,
+                     127,                     120,                   121.5,                   14.75,                0.02896771,
+                     127,                     121,                   121.5,                      15,                0.03513165,
+                     127,                     122,                   121.5,                   15.25,                0.04076821,
+                     127,                     123,                   121.5,                    15.5,                0.01694665,
+                     127,                     124,                   121.5,                   15.75,               0.002089425,
+                     127,                     125,                   121.5,                      16,              9.950028E-06,
+                     128,                     118,                  121.75,                   14.25,              1.539078E-05,
+                     128,                     119,                  121.75,                    14.5,              0.0008586162,
+                     128,                     120,                  121.75,                   14.75,               0.003469678,
+                     128,                     121,                  121.75,                      15,               0.005778265,
+                     128,                     122,                  121.75,                   15.25,               0.004883057,
+                     128,                     123,                  121.75,                    15.5,               0.002288275,
+                     128,                     124,                  121.75,                   15.75,              0.0004972389,
+                     128,                     125,                  121.75,                      16,              1.796154E-05,
+                     128,                     126,                  121.75,                   16.25,              1.441912E-05,
+                     128,                     127,                  121.75,                    16.5,              3.396637E-06,
+                     129,                     120,                     122,                   14.75,              0.0003278529,
+                     129,                     121,                     122,                      15,               0.000854575,
+                     129,                     122,                     122,                   15.25,              0.0009055724,
+                     129,                     123,                     122,                    15.5,              0.0007337024,
+                     129,                     124,                     122,                   15.75,              0.0003872091,
+                     129,                     125,                     122,                      16,              0.0002032383,
+                     129,                     126,                     122,                   16.25,              2.154827E-05,
+                     129,                     127,                     122,                    16.5,              1.780571E-06,
+                     130,                     121,                  122.25,                      15,              0.0001244367,
+                     130,                     122,                  122.25,                   15.25,              0.0002427659,
+                     130,                     123,                  122.25,                    15.5,              0.0004279363,
+                     130,                     124,                  122.25,                   15.75,              0.0002095186,
+                     130,                     125,                  122.25,                      16,              0.0001560012,
+                     130,                     126,                  122.25,                   16.25,              7.090886E-05,
+                     130,                     127,                  122.25,                    16.5,              4.815324E-05,
+                     130,                     128,                  122.25,                   16.75,              1.677327E-05,
+                     131,                     122,                   122.5,                   15.25,              1.008342E-05,
+                     131,                     123,                   122.5,                    15.5,              5.903353E-05,
+                     131,                     124,                   122.5,                   15.75,              5.071654E-05,
+                     131,                     125,                   122.5,                      16,              4.200674E-05,
+                     131,                     126,                   122.5,                   16.25,              2.104882E-05,
+                     131,                     127,                   122.5,                    16.5,              1.786964E-05,
+                     131,                     128,                   122.5,                   16.75,              1.045481E-05,
+                     131,                     129,                   122.5,                      17,              3.892807E-06,
+                     132,                     125,                  122.75,                      16,              1.948814E-05,
+                     132,                     126,                  122.75,                   16.25,              2.796266E-05,
+                     132,                     129,                  122.75,                      17,               3.03299E-06,

unzipped/Taal_273070_20200112_scenario_yizhou/Taal_273070_20200112_0500_20250107041508.174287/AQOutput_3DField_C1_T10_202001121400_Z4.txt

@@ -0,0 +1,120 @@
+ NAME III (version 8.2)                                          
+ Run name:                   Taal_273070_20250107041508.174287
+ Run time:                   07/01/2025 04:15:10.918 UTC
+ Met data:                   NWP Flow.EC HRES Flow
+ Start of release:           12/01/2020 06:57 UTC
+ End of release:             12/01/2020 21:10 UTC
+ Source strength:            5.333333E+08 g / s
+ Release location:           120.9930E   14.0020N
+ Release height:             311.000 to 15311.000m asl
+ Run duration:               7day 0hr 0min
+ X grid origin:                 90.00000    
+ Y grid origin:                -15.00000    
+ X grid size:                         281
+ Y grid size:                         221
+ X grid resolution:            0.2500000    
+ Y grid resolution:            0.2500000    
+ Number of preliminary cols:            4
+ Number of field cols:                  1
+ 
+ Fields:
+                        ,                        ,                        ,                        ,                  VOLCANIC,
+                        ,                        ,                        ,                        ,               AirConc Ash,
+                        ,                        ,                        ,                        ,         Air Concentration,
+                        ,                        ,                        ,                        ,              VOLCANIC_ASH,
+                        ,                        ,                        ,                        ,                   g / m^3,
+                        ,                        ,                        ,                        ,               All sources,
+                        ,                        ,                        ,                        ,     No ensemble averaging,
+                        ,                        ,                        ,                        ,          1hr 0min average,
+                        ,                        ,                        ,                        ,   No horizontal averaging,
+                        ,                        ,                        ,                        ,     No vertical averaging,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,      12/01/2020 14:00 UTC,
+                        ,                        ,                        ,                        ,            Z = 7000 m agl,
+                        ,                        ,                        ,                        ,                          ,
+                 X Index,                 Y Index,            X (Lat-Long),            Y (Lat-Long),                          ,
+                     125,                     117,                     121,                      14,                 0.1234117,
+                     125,                     118,                     121,                   14.25,                0.01902798,
+                     125,                     119,                     121,                    14.5,               0.005364289,
+                     125,                     120,                     121,                   14.75,               0.000805156,
+                     125,                     121,                     121,                      15,              5.191433E-05,
+                     126,                     117,                  121.25,                      14,                0.06572944,
+                     126,                     118,                  121.25,                   14.25,                 0.1743895,
+                     126,                     119,                  121.25,                    14.5,                0.04336735,
+                     126,                     120,                  121.25,                   14.75,                0.00239888,
+                     126,                     121,                  121.25,                      15,              1.830715E-05,
+                     127,                     117,                   121.5,                      14,               0.000526721,
+                     127,                     118,                   121.5,                   14.25,                 0.1083765,
+                     127,                     119,                   121.5,                    14.5,                0.08831672,
+                     127,                     120,                   121.5,                   14.75,                0.01520912,
+                     127,                     121,                   121.5,                      15,               0.002765159,
+                     127,                     122,                   121.5,                   15.25,               0.001005686,
+                     127,                     123,                   121.5,                    15.5,              9.233864E-05,
+                     128,                     118,                  121.75,                   14.25,                0.01266538,
+                     128,                     119,                  121.75,                    14.5,                 0.0860876,
+                     128,                     120,                  121.75,                   14.75,                0.04378112,
+                     128,                     121,                  121.75,                      15,               0.009834636,
+                     128,                     122,                  121.75,                   15.25,               0.001592182,
+                     128,                     123,                  121.75,                    15.5,              0.0002373249,
+                     128,                     125,                  121.75,                      16,               1.53453E-05,
+                     128,                     126,                  121.75,                   16.25,              1.303039E-05,
+                     129,                     118,                     122,                   14.25,              0.0004872618,
+                     129,                     119,                     122,                    14.5,                0.02244982,
+                     129,                     120,                     122,                   14.75,                0.05446454,
+                     129,                     121,                     122,                      15,                0.02280708,
+                     129,                     122,                     122,                   15.25,               0.004015724,
+                     129,                     123,                     122,                    15.5,              0.0006667624,
+                     129,                     124,                     122,                   15.75,              0.0001274908,
+                     129,                     125,                     122,                      16,              0.0001149381,
+                     129,                     126,                     122,                   16.25,              2.609871E-05,
+                     129,                     127,                     122,                    16.5,              4.272111E-05,
+                     129,                     128,                     122,                   16.75,              7.941143E-06,
+                     130,                     119,                  122.25,                    14.5,                0.00229462,
+                     130,                     120,                  122.25,                   14.75,                0.02620347,
+                     130,                     121,                  122.25,                      15,                0.03568861,
+                     130,                     122,                  122.25,                   15.25,                0.01130614,
+                     130,                     123,                  122.25,                    15.5,               0.002651222,
+                     130,                     124,                  122.25,                   15.75,              0.0005461422,
+                     130,                     125,                  122.25,                      16,              0.0002027196,
+                     130,                     126,                  122.25,                   16.25,               0.000123466,
+                     130,                     127,                  122.25,                    16.5,              0.0001030938,
+                     130,                     128,                  122.25,                   16.75,              2.181705E-05,
+                     131,                     119,                   122.5,                    14.5,              0.0001928969,
+                     131,                     120,                   122.5,                   14.75,               0.004697453,
+                     131,                     121,                   122.5,                      15,                 0.0152602,
+                     131,                     122,                   122.5,                   15.25,                0.01426645,
+                     131,                     123,                   122.5,                    15.5,               0.006414582,
+                     131,                     124,                   122.5,                   15.75,               0.001753196,
+                     131,                     125,                   122.5,                      16,              0.0005218849,
+                     131,                     126,                   122.5,                   16.25,              0.0001514535,
+                     131,                     127,                   122.5,                    16.5,              4.750156E-05,
+                     131,                     128,                   122.5,                   16.75,              3.249941E-05,
+                     131,                     129,                   122.5,                      17,               3.10239E-05,
+                     132,                     119,                  122.75,                    14.5,              2.428079E-05,
+                     132,                     120,                  122.75,                   14.75,              0.0003906027,
+                     132,                     121,                  122.75,                      15,               0.002045316,
+                     132,                     122,                  122.75,                   15.25,               0.003867209,
+                     132,                     123,                  122.75,                    15.5,               0.003004558,
+                     132,                     124,                  122.75,                   15.75,               0.001598635,
+                     132,                     125,                  122.75,                      16,              0.0004885108,
+                     132,                     126,                  122.75,                   16.25,              0.0001285777,
+                     132,                     127,                  122.75,                    16.5,              6.977042E-05,
+                     132,                     128,                  122.75,                   16.75,              1.965358E-05,
+                     132,                     129,                  122.75,                      17,              4.237151E-05,
+                     132,                     130,                  122.75,                   17.25,              2.409082E-05,
+                     133,                     120,                     123,                   14.75,               4.00559E-05,
+                     133,                     121,                     123,                      15,              2.602069E-05,
+                     133,                     122,                     123,                   15.25,              0.0002770847,
+                     133,                     123,                     123,                    15.5,              0.0001807743,
+                     133,                     124,                     123,                   15.75,              8.627385E-05,
+                     133,                     125,                     123,                      16,              5.220342E-05,
+                     133,                     126,                     123,                   16.25,              1.164414E-05,
+                     133,                     127,                     123,                    16.5,              3.527872E-05,
+                     133,                     128,                     123,                   16.75,              4.068049E-05,
+                     133,                     129,                     123,                      17,              1.243638E-05,
+                     133,                     130,                     123,                   17.25,              2.116325E-05,
+                     133,                     131,                     123,                    17.5,               1.55598E-05,
+                     133,                     132,                     123,                   17.75,              6.152012E-06,
+                     134,                     128,                  123.25,                   16.75,              9.220726E-06,

unzipped/Taal_273070_20200112_scenario_yizhou/Taal_273070_20200112_0500_20250107041508.174287/AQOutput_3DField_C1_T10_202001121400_Z5.txt

@@ -0,0 +1,129 @@
+ NAME III (version 8.2)                                          
+ Run name:                   Taal_273070_20250107041508.174287
+ Run time:                   07/01/2025 04:15:10.918 UTC
+ Met data:                   NWP Flow.EC HRES Flow
+ Start of release:           12/01/2020 06:57 UTC
+ End of release:             12/01/2020 21:10 UTC
+ Source strength:            5.333333E+08 g / s
+ Release location:           120.9930E   14.0020N
+ Release height:             311.000 to 15311.000m asl
+ Run duration:               7day 0hr 0min
+ X grid origin:                 90.00000    
+ Y grid origin:                -15.00000    
+ X grid size:                         281
+ Y grid size:                         221
+ X grid resolution:            0.2500000    
+ Y grid resolution:            0.2500000    
+ Number of preliminary cols:            4
+ Number of field cols:                  1
+ 
+ Fields:
+                        ,                        ,                        ,                        ,                  VOLCANIC,
+                        ,                        ,                        ,                        ,               AirConc Ash,
+                        ,                        ,                        ,                        ,         Air Concentration,
+                        ,                        ,                        ,                        ,              VOLCANIC_ASH,
+                        ,                        ,                        ,                        ,                   g / m^3,
+                        ,                        ,                        ,                        ,               All sources,
+                        ,                        ,                        ,                        ,     No ensemble averaging,
+                        ,                        ,                        ,                        ,          1hr 0min average,
+                        ,                        ,                        ,                        ,   No horizontal averaging,
+                        ,                        ,                        ,                        ,     No vertical averaging,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,      12/01/2020 14:00 UTC,
+                        ,                        ,                        ,                        ,            Z = 9000 m agl,
+                        ,                        ,                        ,                        ,                          ,
+                 X Index,                 Y Index,            X (Lat-Long),            Y (Lat-Long),                          ,
+                     125,                     117,                     121,                      14,                0.06898191,
+                     125,                     118,                     121,                   14.25,                0.03289511,
+                     126,                     117,                  121.25,                      14,                0.00224039,
+                     126,                     118,                  121.25,                   14.25,                0.09919951,
+                     126,                     119,                  121.25,                    14.5,                0.06965803,
+                     126,                     120,                  121.25,                   14.75,                0.01552968,
+                     126,                     121,                  121.25,                      15,              0.0006118558,
+                     126,                     122,                  121.25,                   15.25,              8.398663E-05,
+                     127,                     118,                   121.5,                   14.25,               0.007041673,
+                     127,                     119,                   121.5,                    14.5,                0.03958223,
+                     127,                     120,                   121.5,                   14.75,                0.08249489,
+                     127,                     121,                   121.5,                      15,                0.04705694,
+                     127,                     122,                   121.5,                   15.25,               0.006514756,
+                     127,                     123,                   121.5,                    15.5,              0.0002950616,
+                     127,                     124,                   121.5,                   15.75,              4.134601E-05,
+                     127,                     125,                   121.5,                      16,              8.057184E-05,
+                     128,                     118,                  121.75,                   14.25,              2.034633E-05,
+                     128,                     119,                  121.75,                    14.5,               0.006565935,
+                     128,                     120,                  121.75,                   14.75,                  0.030691,
+                     128,                     121,                  121.75,                      15,                0.04808839,
+                     128,                     122,                  121.75,                   15.25,                0.04375883,
+                     128,                     123,                  121.75,                    15.5,                0.01544368,
+                     128,                     124,                  121.75,                   15.75,                0.00178602,
+                     128,                     125,                  121.75,                      16,              0.0003033282,
+                     128,                     126,                  121.75,                   16.25,              0.0002123726,
+                     128,                     127,                  121.75,                    16.5,              1.205982E-05,
+                     129,                     119,                     122,                    14.5,              0.0003113352,
+                     129,                     120,                     122,                   14.75,               0.005724736,
+                     129,                     121,                     122,                      15,                0.01940874,
+                     129,                     122,                     122,                   15.25,                0.03175062,
+                     129,                     123,                     122,                    15.5,                0.03573182,
+                     129,                     124,                     122,                   15.75,                0.02254891,
+                     129,                     125,                     122,                      16,               0.005114635,
+                     129,                     126,                     122,                   16.25,              0.0004420028,
+                     129,                     127,                     122,                    16.5,              0.0001147449,
+                     129,                     128,                     122,                   16.75,              5.181966E-05,
+                     129,                     129,                     122,                      17,              6.466838E-05,
+                     129,                     130,                     122,                   17.25,               5.45986E-05,
+                     129,                     131,                     122,                    17.5,              1.571672E-05,
+                     129,                     132,                     122,                   17.75,              1.559137E-05,
+                     130,                     120,                  122.25,                   14.75,              0.0002433661,
+                     130,                     121,                  122.25,                      15,               0.004868901,
+                     130,                     122,                  122.25,                   15.25,                0.01413328,
+                     130,                     123,                  122.25,                    15.5,                0.02152275,
+                     130,                     124,                  122.25,                   15.75,                0.02527227,
+                     130,                     125,                  122.25,                      16,                0.02232271,
+                     130,                     126,                  122.25,                   16.25,               0.007527761,
+                     130,                     127,                  122.25,                    16.5,              0.0005829639,
+                     130,                     128,                  122.25,                   16.75,              0.0002166384,
+                     130,                     129,                  122.25,                      17,              5.924731E-05,
+                     130,                     130,                  122.25,                   17.25,              7.314311E-05,
+                     130,                     131,                  122.25,                    17.5,               4.50703E-05,
+                     130,                     132,                  122.25,                   17.75,              9.010204E-06,
+                     131,                     120,                   122.5,                   14.75,              4.411209E-05,
+                     131,                     121,                   122.5,                      15,              0.0002816019,
+                     131,                     122,                   122.5,                   15.25,               0.003049549,
+                     131,                     123,                   122.5,                    15.5,               0.009221563,
+                     131,                     124,                   122.5,                   15.75,                0.01291798,
+                     131,                     125,                   122.5,                      16,                0.01417599,
+                     131,                     126,                   122.5,                   16.25,                0.01471124,
+                     131,                     127,                   122.5,                    16.5,               0.006280135,
+                     131,                     128,                   122.5,                   16.75,              0.0003908131,
+                     131,                     129,                   122.5,                      17,              4.026011E-05,
+                     131,                     130,                   122.5,                   17.25,              3.994577E-05,
+                     131,                     131,                   122.5,                    17.5,              5.481579E-05,
+                     131,                     133,                   122.5,                      18,              1.347075E-05,
+                     132,                     122,                  122.75,                   15.25,              0.0002512288,
+                     132,                     123,                  122.75,                    15.5,               0.001575867,
+                     132,                     124,                  122.75,                   15.75,               0.003163365,
+                     132,                     125,                  122.75,                      16,                0.00385646,
+                     132,                     126,                  122.75,                   16.25,               0.004527654,
+                     132,                     127,                  122.75,                    16.5,               0.004513398,
+                     132,                     128,                  122.75,                   16.75,               0.001677582,
+                     132,                     129,                  122.75,                      17,              0.0001914731,
+                     132,                     130,                  122.75,                   17.25,              3.960486E-05,
+                     132,                     131,                  122.75,                    17.5,               3.67114E-05,
+                     132,                     132,                  122.75,                   17.75,              2.488445E-05,
+                     132,                     133,                  122.75,                      18,               5.25589E-06,
+                     132,                     135,                  122.75,                    18.5,              7.131451E-06,
+                     133,                     122,                     123,                   15.25,              1.427139E-05,
+                     133,                     123,                     123,                    15.5,                0.00012912,
+                     133,                     124,                     123,                   15.75,              0.0001626896,
+                     133,                     125,                     123,                      16,              0.0002683933,
+                     133,                     126,                     123,                   16.25,              0.0003018458,
+                     133,                     127,                     123,                    16.5,              0.0004253907,
+                     133,                     128,                     123,                   16.75,              0.0004501775,
+                     133,                     129,                     123,                      17,              4.029605E-05,
+                     133,                     130,                     123,                   17.25,              3.655336E-05,
+                     133,                     131,                     123,                    17.5,              1.555869E-05,
+                     134,                     125,                  123.25,                      16,              1.443723E-05,
+                     134,                     127,                  123.25,                    16.5,              1.185754E-05,
+                     134,                     129,                  123.25,                      17,              1.642355E-05,

unzipped/Taal_273070_20200112_scenario_yizhou/Taal_273070_20200112_0500_20250107041508.174287/AQOutput_3DField_C1_T10_202001121400_Z6.txt

@@ -0,0 +1,194 @@
+ NAME III (version 8.2)                                          
+ Run name:                   Taal_273070_20250107041508.174287
+ Run time:                   07/01/2025 04:15:10.918 UTC
+ Met data:                   NWP Flow.EC HRES Flow
+ Start of release:           12/01/2020 06:57 UTC
+ End of release:             12/01/2020 21:10 UTC
+ Source strength:            5.333333E+08 g / s
+ Release location:           120.9930E   14.0020N
+ Release height:             311.000 to 15311.000m asl
+ Run duration:               7day 0hr 0min
+ X grid origin:                 90.00000    
+ Y grid origin:                -15.00000    
+ X grid size:                         281
+ Y grid size:                         221
+ X grid resolution:            0.2500000    
+ Y grid resolution:            0.2500000    
+ Number of preliminary cols:            4
+ Number of field cols:                  1
+ 
+ Fields:
+                        ,                        ,                        ,                        ,                  VOLCANIC,
+                        ,                        ,                        ,                        ,               AirConc Ash,
+                        ,                        ,                        ,                        ,         Air Concentration,
+                        ,                        ,                        ,                        ,              VOLCANIC_ASH,
+                        ,                        ,                        ,                        ,                   g / m^3,
+                        ,                        ,                        ,                        ,               All sources,
+                        ,                        ,                        ,                        ,     No ensemble averaging,
+                        ,                        ,                        ,                        ,          1hr 0min average,
+                        ,                        ,                        ,                        ,   No horizontal averaging,
+                        ,                        ,                        ,                        ,     No vertical averaging,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,      12/01/2020 14:00 UTC,
+                        ,                        ,                        ,                        ,           Z = 11000 m agl,
+                        ,                        ,                        ,                        ,                          ,
+                 X Index,                 Y Index,            X (Lat-Long),            Y (Lat-Long),                          ,
+                     124,                     128,                  120.75,                   16.75,              6.221109E-05,
+                     124,                     129,                  120.75,                      17,              4.036166E-05,
+                     124,                     130,                  120.75,                   17.25,              4.119542E-05,
+                     125,                     117,                     121,                      14,                 0.0622182,
+                     125,                     118,                     121,                   14.25,                0.01277359,
+                     125,                     119,                     121,                    14.5,              2.138454E-05,
+                     125,                     120,                     121,                   14.75,              8.514526E-05,
+                     125,                     121,                     121,                      15,              4.234628E-05,
+                     125,                     122,                     121,                   15.25,              2.128574E-05,
+                     125,                     127,                     121,                    16.5,              4.163329E-05,
+                     125,                     128,                     121,                   16.75,              0.0001412808,
+                     125,                     129,                     121,                      17,              7.697552E-05,
+                     125,                     130,                     121,                   17.25,              0.0001729393,
+                     125,                     131,                     121,                    17.5,              0.0002793811,
+                     125,                     132,                     121,                   17.75,              5.478346E-05,
+                     126,                     117,                  121.25,                      14,              0.0008748188,
+                     126,                     118,                  121.25,                   14.25,                 0.1041974,
+                     126,                     119,                  121.25,                    14.5,                0.03328305,
+                     126,                     120,                  121.25,                   14.75,               0.001406505,
+                     126,                     121,                  121.25,                      15,              0.0005954904,
+                     126,                     122,                  121.25,                   15.25,              0.0001699915,
+                     126,                     123,                  121.25,                    15.5,              0.0002946049,
+                     126,                     124,                  121.25,                   15.75,              4.199668E-05,
+                     126,                     125,                  121.25,                      16,              4.211965E-05,
+                     126,                     126,                  121.25,                   16.25,              8.194144E-05,
+                     126,                     127,                  121.25,                    16.5,              7.915337E-05,
+                     126,                     128,                  121.25,                   16.75,               3.97684E-05,
+                     126,                     129,                  121.25,                      17,              9.260629E-05,
+                     126,                     130,                  121.25,                   17.25,              0.0001086774,
+                     126,                     131,                  121.25,                    17.5,              0.0001386326,
+                     126,                     132,                  121.25,                   17.75,              0.0001915632,
+                     127,                     118,                   121.5,                   14.25,               0.005296591,
+                     127,                     119,                   121.5,                    14.5,                0.07859905,
+                     127,                     120,                   121.5,                   14.75,                0.03961777,
+                     127,                     121,                   121.5,                      15,               0.006926836,
+                     127,                     122,                   121.5,                   15.25,               0.001831552,
+                     127,                     123,                   121.5,                    15.5,              0.0003300227,
+                     127,                     124,                   121.5,                   15.75,              0.0003337682,
+                     127,                     125,                   121.5,                      16,              0.0003885732,
+                     127,                     126,                   121.5,                   16.25,              0.0002186491,
+                     127,                     127,                   121.5,                    16.5,               0.000131449,
+                     127,                     128,                   121.5,                   16.75,              9.575831E-05,
+                     127,                     129,                   121.5,                      17,              1.964502E-05,
+                     127,                     130,                   121.5,                   17.25,              3.632389E-05,
+                     127,                     133,                   121.5,                      18,              1.512874E-05,
+                     128,                     119,                  121.75,                    14.5,               0.006370666,
+                     128,                     120,                  121.75,                   14.75,                0.05709197,
+                     128,                     121,                  121.75,                      15,                0.04001419,
+                     128,                     122,                  121.75,                   15.25,                0.02055781,
+                     128,                     123,                  121.75,                    15.5,               0.007529017,
+                     128,                     124,                  121.75,                   15.75,               0.001310615,
+                     128,                     125,                  121.75,                      16,              0.0003127966,
+                     128,                     126,                  121.75,                   16.25,              0.0003177128,
+                     128,                     127,                  121.75,                    16.5,              0.0002474229,
+                     128,                     128,                  121.75,                   16.75,              0.0001769759,
+                     128,                     129,                  121.75,                      17,               0.000161892,
+                     128,                     130,                  121.75,                   17.25,              3.615832E-05,
+                     128,                     131,                  121.75,                    17.5,              5.506534E-05,
+                     128,                     132,                  121.75,                   17.75,               1.75275E-05,
+                     128,                     133,                  121.75,                      18,               2.89427E-05,
+                     129,                     120,                     122,                   14.75,               0.004740195,
+                     129,                     121,                     122,                      15,                0.04091293,
+                     129,                     122,                     122,                   15.25,                0.04057813,
+                     129,                     123,                     122,                    15.5,                0.02420357,
+                     129,                     124,                     122,                   15.75,                0.01466465,
+                     129,                     125,                     122,                      16,               0.004439455,
+                     129,                     126,                     122,                   16.25,              0.0005244176,
+                     129,                     127,                     122,                    16.5,              0.0007242206,
+                     129,                     128,                     122,                   16.75,              0.0002385112,
+                     129,                     129,                     122,                      17,              9.866249E-05,
+                     129,                     130,                     122,                   17.25,              0.0002000228,
+                     129,                     131,                     122,                    17.5,              0.0004704146,
+                     129,                     132,                     122,                   17.75,              0.0002639875,
+                     129,                     133,                     122,                      18,              9.922256E-05,
+                     129,                     134,                     122,                   18.25,              0.0001151264,
+                     129,                     135,                     122,                    18.5,              2.804919E-05,
+                     130,                     121,                  122.25,                      15,               0.003280296,
+                     130,                     122,                  122.25,                   15.25,                0.02504453,
+                     130,                     123,                  122.25,                    15.5,                0.03768711,
+                     130,                     124,                  122.25,                   15.75,                0.02522154,
+                     130,                     125,                  122.25,                      16,                0.02000674,
+                     130,                     126,                  122.25,                   16.25,                0.00986207,
+                     130,                     127,                  122.25,                    16.5,               0.002313988,
+                     130,                     128,                  122.25,                   16.75,              0.0008495215,
+                     130,                     129,                  122.25,                      17,              0.0005191759,
+                     130,                     130,                  122.25,                   17.25,              0.0006682072,
+                     130,                     131,                  122.25,                    17.5,              0.0005532792,
+                     130,                     132,                  122.25,                   17.75,              0.0002793283,
+                     130,                     133,                  122.25,                      18,              0.0001133961,
+                     130,                     134,                  122.25,                   18.25,              0.0001818698,
+                     130,                     135,                  122.25,                    18.5,              5.843351E-05,
+                     130,                     136,                  122.25,                   18.75,              9.999425E-06,
+                     131,                     121,                   122.5,                      15,              1.987706E-05,
+                     131,                     122,                   122.5,                   15.25,               0.001202978,
+                     131,                     123,                   122.5,                    15.5,                0.01218185,
+                     131,                     124,                   122.5,                   15.75,                0.02681912,
+                     131,                     125,                   122.5,                      16,                0.02582716,
+                     131,                     126,                   122.5,                   16.25,                0.02219759,
+                     131,                     127,                   122.5,                    16.5,                0.01519257,
+                     131,                     128,                   122.5,                   16.75,               0.003614416,
+                     131,                     129,                   122.5,                      17,              0.0007025765,
+                     131,                     130,                   122.5,                   17.25,              0.0005188695,
+                     131,                     131,                   122.5,                    17.5,              0.0005340927,
+                     131,                     132,                   122.5,                   17.75,              0.0002755789,
+                     131,                     133,                   122.5,                      18,              0.0002350702,
+                     131,                     134,                   122.5,                   18.25,               0.000112796,
+                     131,                     135,                   122.5,                    18.5,               0.000131118,
+                     131,                     136,                   122.5,                   18.75,              6.583513E-05,
+                     131,                     138,                   122.5,                   19.25,              1.433079E-05,
+                     132,                     123,                  122.75,                    15.5,              0.0002521633,
+                     132,                     124,                  122.75,                   15.75,               0.004151984,
+                     132,                     125,                  122.75,                      16,                0.01522794,
+                     132,                     126,                  122.75,                   16.25,                0.02182925,
+                     132,                     127,                  122.75,                    16.5,                0.01839288,
+                     132,                     128,                  122.75,                   16.75,               0.008324588,
+                     132,                     129,                  122.75,                      17,               0.001951292,
+                     132,                     130,                  122.75,                   17.25,              0.0006910883,
+                     132,                     131,                  122.75,                    17.5,              0.0007270788,
+                     132,                     132,                  122.75,                   17.75,              0.0005217993,
+                     132,                     133,                  122.75,                      18,              0.0003192426,
+                     132,                     134,                  122.75,                   18.25,               0.000137487,
+                     132,                     135,                  122.75,                    18.5,              0.0001577495,
+                     132,                     136,                  122.75,                   18.75,              0.0001022264,
+                     132,                     137,                  122.75,                      19,              6.035015E-05,
+                     132,                     138,                  122.75,                   19.25,              3.065452E-05,
+                     132,                     139,                  122.75,                    19.5,              1.765224E-05,
+                     133,                     124,                     123,                   15.75,              5.781758E-05,
+                     133,                     125,                     123,                      16,              0.0008737573,
+                     133,                     126,                     123,                   16.25,               0.004744236,
+                     133,                     127,                     123,                    16.5,               0.008771173,
+                     133,                     128,                     123,                   16.75,               0.005445542,
+                     133,                     129,                     123,                      17,               0.001555368,
+                     133,                     130,                     123,                   17.25,              0.0006647338,
+                     133,                     131,                     123,                    17.5,              0.0004687287,
+                     133,                     132,                     123,                   17.75,              0.0003556611,
+                     133,                     133,                     123,                      18,              0.0002114093,
+                     133,                     134,                     123,                   18.25,              0.0001475303,
+                     133,                     135,                     123,                    18.5,                0.00012588,
+                     133,                     136,                     123,                   18.75,              1.820795E-05,
+                     133,                     137,                     123,                      19,              3.518468E-05,
+                     133,                     138,                     123,                   19.25,              1.161282E-05,
+                     133,                     139,                     123,                    19.5,              1.765224E-05,
+                     134,                     126,                  123.25,                   16.25,              0.0001508185,
+                     134,                     127,                  123.25,                    16.5,              0.0006174166,
+                     134,                     128,                  123.25,                   16.75,               0.001200111,
+                     134,                     129,                  123.25,                      17,              0.0004430999,
+                     134,                     130,                  123.25,                   17.25,              0.0001755207,
+                     134,                     131,                  123.25,                    17.5,               8.36772E-05,
+                     134,                     132,                  123.25,                   17.75,              2.520311E-05,
+                     134,                     133,                  123.25,                      18,              1.265662E-05,
+                     134,                     134,                  123.25,                   18.25,              3.630448E-05,
+                     134,                     135,                  123.25,                    18.5,              3.370708E-05,
+                     134,                     136,                  123.25,                   18.75,               2.21591E-05,
+                     135,                     128,                   123.5,                   16.75,              1.772547E-05,
+                     135,                     129,                   123.5,                      17,              6.980081E-05,
+                     135,                     130,                   123.5,                   17.25,               1.49036E-05,
+                     135,                     135,                   123.5,                    18.5,              1.310325E-05,

unzipped/Taal_273070_20200112_scenario_yizhou/Taal_273070_20200112_0500_20250107041508.174287/AQOutput_3DField_C1_T10_202001121400_Z7.txt

@@ -0,0 +1,297 @@
+ NAME III (version 8.2)                                          
+ Run name:                   Taal_273070_20250107041508.174287
+ Run time:                   07/01/2025 04:15:10.918 UTC
+ Met data:                   NWP Flow.EC HRES Flow
+ Start of release:           12/01/2020 06:57 UTC
+ End of release:             12/01/2020 21:10 UTC
+ Source strength:            5.333333E+08 g / s
+ Release location:           120.9930E   14.0020N
+ Release height:             311.000 to 15311.000m asl
+ Run duration:               7day 0hr 0min
+ X grid origin:                 90.00000    
+ Y grid origin:                -15.00000    
+ X grid size:                         281
+ Y grid size:                         221
+ X grid resolution:            0.2500000    
+ Y grid resolution:            0.2500000    
+ Number of preliminary cols:            4
+ Number of field cols:                  1
+ 
+ Fields:
+                        ,                        ,                        ,                        ,                  VOLCANIC,
+                        ,                        ,                        ,                        ,               AirConc Ash,
+                        ,                        ,                        ,                        ,         Air Concentration,
+                        ,                        ,                        ,                        ,              VOLCANIC_ASH,
+                        ,                        ,                        ,                        ,                   g / m^3,
+                        ,                        ,                        ,                        ,               All sources,
+                        ,                        ,                        ,                        ,     No ensemble averaging,
+                        ,                        ,                        ,                        ,          1hr 0min average,
+                        ,                        ,                        ,                        ,   No horizontal averaging,
+                        ,                        ,                        ,                        ,     No vertical averaging,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,      12/01/2020 14:00 UTC,
+                        ,                        ,                        ,                        ,           Z = 13000 m agl,
+                        ,                        ,                        ,                        ,                          ,
+                 X Index,                 Y Index,            X (Lat-Long),            Y (Lat-Long),                          ,
+                     123,                     126,                   120.5,                   16.25,              0.0003881654,
+                     123,                     127,                   120.5,                    16.5,                0.00505147,
+                     123,                     128,                   120.5,                   16.75,               0.004085907,
+                     123,                     129,                   120.5,                      17,               0.002943351,
+                     123,                     130,                   120.5,                   17.25,                0.00121261,
+                     123,                     131,                   120.5,                    17.5,              0.0003039129,
+                     123,                     132,                   120.5,                   17.75,              6.521434E-05,
+                     123,                     133,                   120.5,                      18,               0.000152381,
+                     124,                     119,                  120.75,                    14.5,              2.138454E-05,
+                     124,                     120,                  120.75,                   14.75,              0.0001494056,
+                     124,                     121,                  120.75,                      15,              0.0001712197,
+                     124,                     122,                  120.75,                   15.25,              0.0003645199,
+                     124,                     123,                  120.75,                    15.5,              0.0001932626,
+                     124,                     124,                  120.75,                   15.75,              0.0005376139,
+                     124,                     125,                  120.75,                      16,               0.001420918,
+                     124,                     126,                  120.75,                   16.25,               0.005272218,
+                     124,                     127,                  120.75,                    16.5,               0.007810672,
+                     124,                     128,                  120.75,                   16.75,               0.008227875,
+                     124,                     129,                  120.75,                      17,                0.00767334,
+                     124,                     130,                  120.75,                   17.25,               0.006461089,
+                     124,                     131,                  120.75,                    17.5,               0.005390836,
+                     124,                     132,                  120.75,                   17.75,               0.002931942,
+                     124,                     133,                  120.75,                      18,               0.003352241,
+                     124,                     134,                  120.75,                   18.25,                0.00150418,
+                     124,                     135,                  120.75,                    18.5,               0.001200728,
+                     124,                     136,                  120.75,                   18.75,              0.0001749084,
+                     125,                     117,                     121,                      14,                0.03247498,
+                     125,                     118,                     121,                   14.25,                0.05699011,
+                     125,                     119,                     121,                    14.5,                0.02690178,
+                     125,                     120,                     121,                   14.75,                0.01589066,
+                     125,                     121,                     121,                      15,                0.01131044,
+                     125,                     122,                     121,                   15.25,                0.00895768,
+                     125,                     123,                     121,                    15.5,               0.007230231,
+                     125,                     124,                     121,                   15.75,               0.006018548,
+                     125,                     125,                     121,                      16,               0.006342597,
+                     125,                     126,                     121,                   16.25,                0.00572445,
+                     125,                     127,                     121,                    16.5,               0.004627066,
+                     125,                     128,                     121,                   16.75,               0.004009823,
+                     125,                     129,                     121,                      17,               0.004563737,
+                     125,                     130,                     121,                   17.25,               0.006406643,
+                     125,                     131,                     121,                    17.5,               0.006806058,
+                     125,                     132,                     121,                   17.75,               0.007142992,
+                     125,                     133,                     121,                      18,               0.006005429,
+                     125,                     134,                     121,                   18.25,               0.005190082,
+                     125,                     135,                     121,                    18.5,               0.004997081,
+                     125,                     136,                     121,                   18.75,                0.00166163,
+                     125,                     137,                     121,                      19,              0.0002624267,
+                     126,                     118,                  121.25,                   14.25,                0.02274891,
+                     126,                     119,                  121.25,                    14.5,                0.03958242,
+                     126,                     120,                  121.25,                   14.75,                0.02480255,
+                     126,                     121,                  121.25,                      15,                0.01712777,
+                     126,                     122,                  121.25,                   15.25,                0.01427649,
+                     126,                     123,                  121.25,                    15.5,                0.01022712,
+                     126,                     124,                  121.25,                   15.75,               0.009394526,
+                     126,                     125,                  121.25,                      16,               0.007164803,
+                     126,                     126,                  121.25,                   16.25,               0.006263139,
+                     126,                     127,                  121.25,                    16.5,               0.006382365,
+                     126,                     128,                  121.25,                   16.75,               0.005470656,
+                     126,                     129,                  121.25,                      17,               0.004426755,
+                     126,                     130,                  121.25,                   17.25,               0.004062616,
+                     126,                     131,                  121.25,                    17.5,               0.004195487,
+                     126,                     132,                  121.25,                   17.75,               0.004955451,
+                     126,                     133,                  121.25,                      18,               0.007160906,
+                     126,                     134,                  121.25,                   18.25,               0.005708982,
+                     126,                     135,                  121.25,                    18.5,               0.004431257,
+                     126,                     136,                  121.25,                   18.75,               0.002080839,
+                     126,                     137,                  121.25,                      19,                0.00135515,
+                     126,                     138,                  121.25,                   19.25,              0.0005042375,
+                     126,                     139,                  121.25,                    19.5,              0.0001098152,
+                     127,                     118,                   121.5,                   14.25,              6.408151E-05,
+                     127,                     119,                   121.5,                    14.5,               0.006733222,
+                     127,                     120,                   121.5,                   14.75,                  0.010721,
+                     127,                     121,                   121.5,                      15,                0.01588823,
+                     127,                     122,                   121.5,                   15.25,                0.01183864,
+                     127,                     123,                   121.5,                    15.5,               0.008447092,
+                     127,                     124,                   121.5,                   15.75,               0.006401335,
+                     127,                     125,                   121.5,                      16,               0.005647928,
+                     127,                     126,                   121.5,                   16.25,               0.005179127,
+                     127,                     127,                   121.5,                    16.5,               0.005061267,
+                     127,                     128,                   121.5,                   16.75,               0.005116696,
+                     127,                     129,                   121.5,                      17,               0.005707907,
+                     127,                     130,                   121.5,                   17.25,               0.005642754,
+                     127,                     131,                   121.5,                    17.5,                0.00470066,
+                     127,                     132,                   121.5,                   17.75,               0.003818045,
+                     127,                     133,                   121.5,                      18,               0.004331268,
+                     127,                     134,                   121.5,                   18.25,               0.005695854,
+                     127,                     135,                   121.5,                    18.5,               0.004896687,
+                     127,                     136,                   121.5,                   18.75,               0.003482735,
+                     127,                     137,                   121.5,                      19,                0.00286123,
+                     127,                     138,                   121.5,                   19.25,               0.001635549,
+                     127,                     139,                   121.5,                    19.5,               0.001053703,
+                     127,                     140,                   121.5,                   19.75,              0.0003519544,
+                     128,                     119,                  121.75,                    14.5,              6.309758E-05,
+                     128,                     120,                  121.75,                   14.75,               0.005846873,
+                     128,                     121,                  121.75,                      15,                0.02048152,
+                     128,                     122,                  121.75,                   15.25,                0.01427897,
+                     128,                     123,                  121.75,                    15.5,                0.01028029,
+                     128,                     124,                  121.75,                   15.75,               0.008981369,
+                     128,                     125,                  121.75,                      16,               0.006682611,
+                     128,                     126,                  121.75,                   16.25,               0.005272868,
+                     128,                     127,                  121.75,                    16.5,               0.004901115,
+                     128,                     128,                  121.75,                   16.75,               0.003646349,
+                     128,                     129,                  121.75,                      17,               0.004524055,
+                     128,                     130,                  121.75,                   17.25,               0.004674797,
+                     128,                     131,                  121.75,                    17.5,               0.005083202,
+                     128,                     132,                  121.75,                   17.75,               0.005147811,
+                     128,                     133,                  121.75,                      18,               0.004718282,
+                     128,                     134,                  121.75,                   18.25,               0.004913406,
+                     128,                     135,                  121.75,                    18.5,               0.005286446,
+                     128,                     136,                  121.75,                   18.75,                0.00563042,
+                     128,                     137,                  121.75,                      19,               0.004719276,
+                     128,                     138,                  121.75,                   19.25,               0.003617305,
+                     128,                     139,                  121.75,                    19.5,               0.002486874,
+                     128,                     140,                  121.75,                   19.75,               0.001274224,
+                     128,                     141,                  121.75,                      20,              0.0007270561,
+                     128,                     142,                  121.75,                   20.25,              0.0001765383,
+                     128,                     143,                  121.75,                    20.5,              2.210301E-05,
+                     129,                     120,                     122,                   14.75,              0.0001022483,
+                     129,                     121,                     122,                      15,               0.004356414,
+                     129,                     122,                     122,                   15.25,                0.01384246,
+                     129,                     123,                     122,                    15.5,                0.01279092,
+                     129,                     124,                     122,                   15.75,                0.01033123,
+                     129,                     125,                     122,                      16,               0.008920626,
+                     129,                     126,                     122,                   16.25,               0.006815142,
+                     129,                     127,                     122,                    16.5,               0.004981393,
+                     129,                     128,                     122,                   16.75,                0.00398336,
+                     129,                     129,                     122,                      17,                0.00337705,
+                     129,                     130,                     122,                   17.25,               0.003798835,
+                     129,                     131,                     122,                    17.5,               0.003652796,
+                     129,                     132,                     122,                   17.75,               0.003649437,
+                     129,                     133,                     122,                      18,               0.004836492,
+                     129,                     134,                     122,                   18.25,               0.004978335,
+                     129,                     135,                     122,                    18.5,               0.005616009,
+                     129,                     136,                     122,                   18.75,               0.005613013,
+                     129,                     137,                     122,                      19,               0.005793108,
+                     129,                     138,                     122,                   19.25,               0.005114507,
+                     129,                     139,                     122,                    19.5,               0.003745043,
+                     129,                     140,                     122,                   19.75,               0.002754437,
+                     129,                     141,                     122,                      20,               0.002090641,
+                     129,                     142,                     122,                   20.25,               0.001301664,
+                     129,                     143,                     122,                    20.5,              0.0005746784,
+                     129,                     144,                     122,                   20.75,              0.0001106967,
+                     130,                     121,                  122.25,                      15,               0.000100791,
+                     130,                     122,                  122.25,                   15.25,               0.001986217,
+                     130,                     123,                  122.25,                    15.5,               0.007703658,
+                     130,                     124,                  122.25,                   15.75,                0.01019076,
+                     130,                     125,                  122.25,                      16,               0.009386936,
+                     130,                     126,                  122.25,                   16.25,               0.008047561,
+                     130,                     127,                  122.25,                    16.5,               0.006762965,
+                     130,                     128,                  122.25,                   16.75,               0.005123602,
+                     130,                     129,                  122.25,                      17,               0.004430163,
+                     130,                     130,                  122.25,                   17.25,               0.003683947,
+                     130,                     131,                  122.25,                    17.5,               0.003290506,
+                     130,                     132,                  122.25,                   17.75,               0.002935608,
+                     130,                     133,                  122.25,                      18,               0.003057464,
+                     130,                     134,                  122.25,                   18.25,               0.003267714,
+                     130,                     135,                  122.25,                    18.5,               0.004716324,
+                     130,                     136,                  122.25,                   18.75,               0.004913819,
+                     130,                     137,                  122.25,                      19,               0.005429264,
+                     130,                     138,                  122.25,                   19.25,               0.005292431,
+                     130,                     139,                  122.25,                    19.5,               0.004847661,
+                     130,                     140,                  122.25,                   19.75,               0.003948504,
+                     130,                     141,                  122.25,                      20,               0.002281324,
+                     130,                     142,                  122.25,                   20.25,               0.002270003,
+                     130,                     143,                  122.25,                    20.5,               0.001502727,
+                     130,                     144,                  122.25,                   20.75,              0.0008191555,
+                     130,                     145,                  122.25,                      21,              0.0001995864,
+                     130,                     146,                  122.25,                   21.25,              4.442696E-05,
+                     130,                     147,                  122.25,                    21.5,              2.225164E-05,
+                     131,                     123,                   122.5,                    15.5,              0.0005285646,
+                     131,                     124,                   122.5,                   15.75,               0.002373407,
+                     131,                     125,                   122.5,                      16,               0.005884645,
+                     131,                     126,                   122.5,                   16.25,               0.007631014,
+                     131,                     127,                   122.5,                    16.5,                0.00852002,
+                     131,                     128,                   122.5,                   16.75,               0.007380202,
+                     131,                     129,                   122.5,                      17,                 0.0061512,
+                     131,                     130,                   122.5,                   17.25,               0.005145038,
+                     131,                     131,                   122.5,                    17.5,               0.004492051,
+                     131,                     132,                   122.5,                   17.75,               0.003933463,
+                     131,                     133,                   122.5,                      18,               0.003020111,
+                     131,                     134,                   122.5,                   18.25,               0.002440456,
+                     131,                     135,                   122.5,                    18.5,               0.002173362,
+                     131,                     136,                   122.5,                   18.75,               0.002705903,
+                     131,                     137,                   122.5,                      19,                0.00383835,
+                     131,                     138,                   122.5,                   19.25,                0.00377879,
+                     131,                     139,                   122.5,                    19.5,               0.003623716,
+                     131,                     140,                   122.5,                   19.75,               0.002984216,
+                     131,                     141,                   122.5,                      20,               0.002591837,
+                     131,                     142,                   122.5,                   20.25,               0.001667034,
+                     131,                     143,                   122.5,                    20.5,               0.001258502,
+                     131,                     144,                   122.5,                   20.75,               0.001173217,
+                     131,                     145,                   122.5,                      21,              0.0006873632,
+                     131,                     146,                   122.5,                   21.25,              0.0001999213,
+                     131,                     147,                   122.5,                    21.5,              0.0001112582,
+                     131,                     148,                   122.5,                   21.75,              4.458052E-05,
+                     132,                     124,                  122.75,                   15.75,              7.719002E-05,
+                     132,                     125,                  122.75,                      16,               0.000570726,
+                     132,                     126,                  122.75,                   16.25,               0.002881713,
+                     132,                     127,                  122.75,                    16.5,               0.005001624,
+                     132,                     128,                  122.75,                   16.75,               0.006472536,
+                     132,                     129,                  122.75,                      17,               0.005827757,
+                     132,                     130,                  122.75,                   17.25,               0.005286319,
+                     132,                     131,                  122.75,                    17.5,               0.003968958,
+                     132,                     132,                  122.75,                   17.75,               0.003610264,
+                     132,                     133,                  122.75,                      18,               0.002853944,
+                     132,                     134,                  122.75,                   18.25,               0.002301368,
+                     132,                     135,                  122.75,                    18.5,               0.001625787,
+                     132,                     136,                  122.75,                   18.75,               0.001204883,
+                     132,                     137,                  122.75,                      19,               0.001390813,
+                     132,                     138,                  122.75,                   19.25,               0.001797552,
+                     132,                     139,                  122.75,                    19.5,               0.001998109,
+                     132,                     140,                  122.75,                   19.75,               0.001786098,
+                     132,                     141,                  122.75,                      20,               0.001406355,
+                     132,                     142,                  122.75,                   20.25,               0.001065322,
+                     132,                     143,                  122.75,                    20.5,              0.0005294664,
+                     132,                     144,                  122.75,                   20.75,              0.0007522101,
+                     132,                     145,                  122.75,                      21,              0.0005319772,
+                     132,                     146,                  122.75,                   21.25,              0.0004663819,
+                     132,                     147,                  122.75,                    21.5,              8.900656E-05,
+                     132,                     148,                  122.75,                   21.75,              4.458052E-05,
+                     132,                     149,                  122.75,                      22,              2.232918E-05,
+                     133,                     125,                     123,                      16,              1.875221E-05,
+                     133,                     126,                     123,                   16.25,              5.408812E-05,
+                     133,                     127,                     123,                    16.5,              0.0008191921,
+                     133,                     128,                     123,                   16.75,               0.001746536,
+                     133,                     129,                     123,                      17,               0.002542191,
+                     133,                     130,                     123,                   17.25,               0.002469992,
+                     133,                     131,                     123,                    17.5,               0.002293412,
+                     133,                     132,                     123,                   17.75,               0.001636158,
+                     133,                     133,                     123,                      18,               0.001516576,
+                     133,                     134,                     123,                   18.25,               0.001340334,
+                     133,                     135,                     123,                    18.5,               0.001080037,
+                     133,                     136,                     123,                   18.75,              0.0006584466,
+                     133,                     137,                     123,                      19,               0.000354185,
+                     133,                     138,                     123,                   19.25,              0.0003647237,
+                     133,                     139,                     123,                    19.5,              0.0003446671,
+                     133,                     140,                     123,                   19.75,              0.0003778531,
+                     133,                     141,                     123,                      20,              0.0003135069,
+                     133,                     142,                     123,                   20.25,              0.0002992589,
+                     133,                     143,                     123,                    20.5,              0.0001755153,
+                     133,                     144,                     123,                   20.75,              6.641801E-05,
+                     133,                     145,                     123,                      21,              8.870506E-05,
+                     133,                     146,                     123,                   21.25,              0.0001110674,
+                     133,                     147,                     123,                    21.5,              4.450328E-05,
+                     134,                     127,                  123.25,                    16.5,              1.861714E-05,
+                     134,                     128,                  123.25,                   16.75,              4.981032E-05,
+                     134,                     129,                  123.25,                      17,              0.0002279336,
+                     134,                     130,                  123.25,                   17.25,              0.0003933623,
+                     134,                     131,                  123.25,                    17.5,              0.0003516745,
+                     134,                     132,                  123.25,                   17.75,              0.0004597068,
+                     134,                     133,                  123.25,                      18,              0.0001899822,
+                     134,                     134,                  123.25,                   18.25,              0.0001674486,
+                     134,                     135,                  123.25,                    18.5,              0.0001811963,
+                     134,                     136,                  123.25,                   18.75,              0.0001925258,
+                     134,                     137,                  123.25,                      19,              8.227721E-05,
+                     134,                     138,                  123.25,                   19.25,              4.711351E-05,
+                     134,                     139,                  123.25,                    19.5,              1.162471E-05,
+                     134,                     140,                  123.25,                   19.75,              5.894935E-05,
+                     135,                     131,                   123.5,                    17.5,               1.45547E-05,
+                     135,                     134,                   123.5,                   18.25,              3.725484E-05,

unzipped/Taal_273070_20200112_scenario_yizhou/Taal_273070_20200112_0500_20250107041508.174287/AQOutput_3DField_C1_T10_202001121400_Z8.txt

@@ -0,0 +1,208 @@
+ NAME III (version 8.2)                                          
+ Run name:                   Taal_273070_20250107041508.174287
+ Run time:                   07/01/2025 04:15:10.918 UTC
+ Met data:                   NWP Flow.EC HRES Flow
+ Start of release:           12/01/2020 06:57 UTC
+ End of release:             12/01/2020 21:10 UTC
+ Source strength:            5.333333E+08 g / s
+ Release location:           120.9930E   14.0020N
+ Release height:             311.000 to 15311.000m asl
+ Run duration:               7day 0hr 0min
+ X grid origin:                 90.00000    
+ Y grid origin:                -15.00000    
+ X grid size:                         281
+ Y grid size:                         221
+ X grid resolution:            0.2500000    
+ Y grid resolution:            0.2500000    
+ Number of preliminary cols:            4
+ Number of field cols:                  1
+ 
+ Fields:
+                        ,                        ,                        ,                        ,                  VOLCANIC,
+                        ,                        ,                        ,                        ,               AirConc Ash,
+                        ,                        ,                        ,                        ,         Air Concentration,
+                        ,                        ,                        ,                        ,              VOLCANIC_ASH,
+                        ,                        ,                        ,                        ,                   g / m^3,
+                        ,                        ,                        ,                        ,               All sources,
+                        ,                        ,                        ,                        ,     No ensemble averaging,
+                        ,                        ,                        ,                        ,          1hr 0min average,
+                        ,                        ,                        ,                        ,   No horizontal averaging,
+                        ,                        ,                        ,                        ,     No vertical averaging,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,      12/01/2020 14:00 UTC,
+                        ,                        ,                        ,                        ,           Z = 15000 m agl,
+                        ,                        ,                        ,                        ,                          ,
+                 X Index,                 Y Index,            X (Lat-Long),            Y (Lat-Long),                          ,
+                     122,                     126,                  120.25,                   16.25,              4.312949E-05,
+                     122,                     127,                  120.25,                    16.5,               6.47772E-05,
+                     122,                     128,                  120.25,                   16.75,              2.162074E-05,
+                     122,                     129,                  120.25,                      17,              0.0001082458,
+                     122,                     130,                  120.25,                   17.25,              6.503524E-05,
+                     122,                     131,                  120.25,                    17.5,              2.170807E-05,
+                     122,                     133,                  120.25,                      18,              2.176871E-05,
+                     123,                     121,                   120.5,                      15,              2.143361E-05,
+                     123,                     122,                   120.5,                   15.25,              0.0007725167,
+                     123,                     123,                   120.5,                    15.5,               0.003115276,
+                     123,                     124,                   120.5,                   15.75,               0.006732906,
+                     123,                     125,                   120.5,                      16,               0.009541231,
+                     123,                     126,                   120.5,                   16.25,                0.01004918,
+                     123,                     127,                   120.5,                    16.5,               0.004836697,
+                     123,                     128,                   120.5,                   16.75,               0.005318701,
+                     123,                     129,                   120.5,                      17,                0.00569373,
+                     123,                     130,                   120.5,                   17.25,               0.005267852,
+                     123,                     131,                   120.5,                    17.5,               0.003560125,
+                     123,                     132,                   120.5,                   17.75,               0.002130335,
+                     123,                     133,                   120.5,                      18,              0.0009578232,
+                     123,                     134,                   120.5,                   18.25,               0.000305196,
+                     123,                     135,                   120.5,                    18.5,              6.549429E-05,
+                     123,                     136,                   120.5,                   18.75,              2.186355E-05,
+                     124,                     118,                  120.75,                   14.25,              4.272101E-05,
+                     124,                     119,                  120.75,                    14.5,               0.009024283,
+                     124,                     120,                  120.75,                   14.75,                0.02042397,
+                     124,                     121,                  120.75,                      15,                 0.0222695,
+                     124,                     122,                  120.75,                   15.25,                0.02193085,
+                     124,                     123,                  120.75,                    15.5,                0.01959402,
+                     124,                     124,                  120.75,                   15.75,                0.01396059,
+                     124,                     125,                  120.75,                      16,                0.01012275,
+                     124,                     126,                  120.75,                   16.25,               0.004334517,
+                     124,                     127,                  120.75,                    16.5,              0.0004966251,
+                     124,                     128,                  120.75,                   16.75,              0.0003459318,
+                     124,                     129,                  120.75,                      17,              0.0008443168,
+                     124,                     130,                  120.75,                   17.25,               0.002601409,
+                     124,                     131,                  120.75,                    17.5,               0.004623821,
+                     124,                     132,                  120.75,                   17.75,                 0.0062171,
+                     124,                     133,                  120.75,                      18,               0.003896601,
+                     124,                     134,                  120.75,                   18.25,               0.004752336,
+                     124,                     135,                  120.75,                    18.5,               0.002510614,
+                     124,                     136,                  120.75,                   18.75,               0.001377404,
+                     124,                     137,                  120.75,                      19,              0.0003065496,
+                     124,                     138,                  120.75,                   19.25,              8.771741E-05,
+                     124,                     139,                  120.75,                    19.5,              2.196304E-05,
+                     125,                     117,                     121,                      14,                0.01482926,
+                     125,                     118,                     121,                   14.25,                0.02488494,
+                     125,                     119,                     121,                    14.5,                0.02037949,
+                     125,                     120,                     121,                   14.75,               0.009141549,
+                     125,                     121,                     121,                      15,                0.00613001,
+                     125,                     122,                     121,                   15.25,               0.005214489,
+                     125,                     123,                     121,                    15.5,               0.003781301,
+                     125,                     124,                     121,                   15.75,               0.002624234,
+                     125,                     125,                     121,                      16,              0.0006461334,
+                     125,                     130,                     121,                   17.25,              2.167841E-05,
+                     125,                     131,                     121,                    17.5,              8.683227E-05,
+                     125,                     132,                     121,                   17.75,               0.000391286,
+                     125,                     133,                     121,                      18,              0.0005006804,
+                     125,                     134,                     121,                   18.25,              0.0009591873,
+                     125,                     135,                     121,                    18.5,               0.001506368,
+                     125,                     136,                     121,                   18.75,               0.005925017,
+                     125,                     137,                     121,                      19,                0.00437928,
+                     125,                     138,                     121,                   19.25,               0.001951713,
+                     125,                     139,                     121,                    19.5,              0.0005051498,
+                     125,                     140,                     121,                   19.75,              0.0001099857,
+                     126,                     131,                  121.25,                    17.5,               2.16268E-05,
+                     126,                     132,                  121.25,                   17.75,              2.162661E-05,
+                     126,                     133,                  121.25,                      18,              0.0004561418,
+                     126,                     134,                  121.25,                   18.25,              0.0005431389,
+                     126,                     135,                  121.25,                    18.5,               0.001329941,
+                     126,                     136,                  121.25,                   18.75,                0.00290523,
+                     126,                     137,                  121.25,                      19,               0.004356808,
+                     126,                     138,                  121.25,                   19.25,               0.005679703,
+                     126,                     139,                  121.25,                    19.5,               0.004744015,
+                     126,                     140,                  121.25,                   19.75,               0.002089729,
+                     126,                     141,                  121.25,                      20,              0.0005948641,
+                     126,                     142,                  121.25,                   20.25,              6.620187E-05,
+                     126,                     143,                  121.25,                    20.5,              2.210301E-05,
+                     127,                     130,                   121.5,                   17.25,              2.150614E-05,
+                     127,                     131,                   121.5,                    17.5,              0.0002146032,
+                     127,                     132,                   121.5,                   17.75,              0.0009032274,
+                     127,                     133,                   121.5,                      18,              0.0006452485,
+                     127,                     134,                   121.5,                   18.25,               0.001077636,
+                     127,                     135,                   121.5,                    18.5,                0.00238579,
+                     127,                     136,                   121.5,                   18.75,               0.002894883,
+                     127,                     137,                   121.5,                      19,               0.002816882,
+                     127,                     138,                   121.5,                   19.25,               0.003132672,
+                     127,                     139,                   121.5,                    19.5,                0.00404057,
+                     127,                     140,                   121.5,                   19.75,                0.00453126,
+                     127,                     141,                   121.5,                      20,               0.004362336,
+                     127,                     142,                   121.5,                   20.25,               0.001963989,
+                     127,                     143,                   121.5,                    20.5,              0.0003315452,
+                     127,                     144,                   121.5,                   20.75,              6.641801E-05,
+                     127,                     145,                   121.5,                      21,              2.217627E-05,
+                     128,                     131,                  121.75,                    17.5,              6.369563E-05,
+                     128,                     132,                  121.75,                   17.75,              0.0001280711,
+                     128,                     133,                  121.75,                      18,              0.0003877443,
+                     128,                     134,                  121.75,                   18.25,               0.000580451,
+                     128,                     135,                  121.75,                    18.5,               0.001031155,
+                     128,                     136,                  121.75,                   18.75,               0.001320112,
+                     128,                     137,                  121.75,                      19,               0.001933896,
+                     128,                     138,                  121.75,                   19.25,               0.002359719,
+                     128,                     139,                  121.75,                    19.5,               0.002501227,
+                     128,                     140,                  121.75,                   19.75,               0.003518625,
+                     128,                     141,                  121.75,                      20,               0.003877133,
+                     128,                     142,                  121.75,                   20.25,               0.004281054,
+                     128,                     143,                  121.75,                    20.5,               0.003271247,
+                     128,                     144,                  121.75,                   20.75,              0.0009519915,
+                     128,                     145,                  121.75,                      21,              8.870506E-05,
+                     128,                     146,                  121.75,                   21.25,              4.442696E-05,
+                     129,                     134,                     122,                   18.25,              2.145771E-05,
+                     129,                     135,                     122,                    18.5,              0.0002791832,
+                     129,                     136,                     122,                   18.75,              0.0005564889,
+                     129,                     137,                     122,                      19,              0.0005789094,
+                     129,                     138,                     122,                   19.25,               0.001084929,
+                     129,                     139,                     122,                    19.5,               0.001726047,
+                     129,                     140,                     122,                   19.75,                0.00153522,
+                     129,                     141,                     122,                      20,               0.002533294,
+                     129,                     142,                     122,                   20.25,               0.002868436,
+                     129,                     143,                     122,                    20.5,               0.003735309,
+                     129,                     144,                     122,                   20.75,               0.003320901,
+                     129,                     145,                     122,                      21,                0.00166322,
+                     129,                     146,                     122,                   21.25,              0.0002887753,
+                     129,                     147,                     122,                    21.5,              4.450328E-05,
+                     130,                     136,                  122.25,                   18.75,              4.212198E-05,
+                     130,                     137,                  122.25,                      19,              0.0001492352,
+                     130,                     138,                  122.25,                   19.25,               0.000213492,
+                     130,                     139,                  122.25,                    19.5,              0.0005180273,
+                     130,                     140,                  122.25,                   19.75,              0.0008296919,
+                     130,                     141,                  122.25,                      20,               0.001141144,
+                     130,                     142,                  122.25,                   20.25,               0.001543421,
+                     130,                     143,                  122.25,                    20.5,               0.001790149,
+                     130,                     144,                  122.25,                   20.75,               0.002634481,
+                     130,                     145,                  122.25,                      21,               0.002772033,
+                     130,                     146,                  122.25,                   21.25,               0.001643798,
+                     130,                     147,                  122.25,                    21.5,              0.0004672845,
+                     130,                     148,                  122.25,                   21.75,              6.687077E-05,
+                     131,                     131,                   122.5,                    17.5,              1.600035E-05,
+                     131,                     132,                   122.5,                   17.75,              1.602249E-05,
+                     131,                     133,                   122.5,                      18,              1.604505E-05,
+                     131,                     136,                   122.5,                   18.75,               3.99442E-05,
+                     131,                     137,                   122.5,                      19,              4.186171E-05,
+                     131,                     138,                   122.5,                   19.25,              8.493321E-05,
+                     131,                     139,                   122.5,                    19.5,               6.34996E-05,
+                     131,                     140,                   122.5,                   19.75,              0.0002810433,
+                     131,                     141,                   122.5,                      20,              0.0002182945,
+                     131,                     142,                   122.5,                   20.25,               0.000462839,
+                     131,                     143,                   122.5,                    20.5,              0.0006629468,
+                     131,                     144,                   122.5,                   20.75,              0.0008855736,
+                     131,                     145,                   122.5,                      21,               0.001397105,
+                     131,                     146,                   122.5,                   21.25,               0.001732652,
+                     131,                     147,                   122.5,                    21.5,               0.001134834,
+                     131,                     148,                   122.5,                   21.75,              0.0005349661,
+                     131,                     149,                   122.5,                      22,              0.0001339751,
+                     132,                     141,                  122.75,                      20,              0.0001077375,
+                     132,                     142,                  122.75,                   20.25,               4.39075E-05,
+                     132,                     143,                  122.75,                    20.5,              0.0001546217,
+                     132,                     144,                  122.75,                   20.75,              0.0001548315,
+                     132,                     145,                  122.75,                      21,              0.0002881474,
+                     132,                     146,                  122.75,                   21.25,              0.0004886966,
+                     132,                     147,                  122.75,                    21.5,               0.000623046,
+                     132,                     148,                  122.75,                   21.75,              0.0005349661,
+                     132,                     149,                  122.75,                      22,              0.0002456209,
+                     132,                     150,                  122.75,                   22.25,              8.947555E-05,
+                     133,                     145,                     123,                      21,              2.217627E-05,
+                     133,                     146,                     123,                   21.25,              2.221348E-05,
+                     133,                     147,                     123,                    21.5,              6.675492E-05,
+                     133,                     148,                     123,                   21.75,              6.687077E-05,
+                     133,                     149,                     123,                      22,              6.698753E-05,
+                     133,                     150,                     123,                   22.25,              8.947555E-05,
+                     133,                     151,                     123,                    22.5,              2.240891E-05,

unzipped/Taal_273070_20200112_scenario_yizhou/Taal_273070_20200112_0500_20250107041508.174287/AQOutput_3DField_C1_T10_202001121400_Z9.txt

@@ -0,0 +1,39 @@
+ NAME III (version 8.2)                                          
+ Run name:                   Taal_273070_20250107041508.174287
+ Run time:                   07/01/2025 04:15:10.918 UTC
+ Met data:                   NWP Flow.EC HRES Flow
+ Start of release:           12/01/2020 06:57 UTC
+ End of release:             12/01/2020 21:10 UTC
+ Source strength:            5.333333E+08 g / s
+ Release location:           120.9930E   14.0020N
+ Release height:             311.000 to 15311.000m asl
+ Run duration:               7day 0hr 0min
+ X grid origin:                 90.00000    
+ Y grid origin:                -15.00000    
+ X grid size:                         281
+ Y grid size:                         221
+ X grid resolution:            0.2500000    
+ Y grid resolution:            0.2500000    
+ Number of preliminary cols:            4
+ Number of field cols:                  1
+ 
+ Fields:
+                        ,                        ,                        ,                        ,                  VOLCANIC,
+                        ,                        ,                        ,                        ,               AirConc Ash,
+                        ,                        ,                        ,                        ,         Air Concentration,
+                        ,                        ,                        ,                        ,              VOLCANIC_ASH,
+                        ,                        ,                        ,                        ,                   g / m^3,
+                        ,                        ,                        ,                        ,               All sources,
+                        ,                        ,                        ,                        ,     No ensemble averaging,
+                        ,                        ,                        ,                        ,          1hr 0min average,
+                        ,                        ,                        ,                        ,   No horizontal averaging,
+                        ,                        ,                        ,                        ,     No vertical averaging,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,      12/01/2020 14:00 UTC,
+                        ,                        ,                        ,                        ,           Z = 17000 m agl,
+                        ,                        ,                        ,                        ,                          ,
+                 X Index,                 Y Index,            X (Lat-Long),            Y (Lat-Long),                          ,
+                     128,                     141,                  121.75,                      20,                2.2032E-05,
+                     129,                     142,                     122,                   20.25,              2.206729E-05,

unzipped/Taal_273070_20200112_scenario_yizhou/Taal_273070_20200112_0500_20250107041508.174287/AQOutput_3DField_C1_T1_202001120500_Z1.txt

@@ -0,0 +1,37 @@
+ NAME III (version 8.2)                                          
+ Run name:                   Taal_273070_20250107041508.174287
+ Run time:                   07/01/2025 04:15:10.918 UTC
+ Met data:                   NWP Flow.EC HRES Flow
+ Start of release:           12/01/2020 06:57 UTC
+ End of release:             12/01/2020 21:10 UTC
+ Source strength:            5.333333E+08 g / s
+ Release location:           120.9930E   14.0020N
+ Release height:             311.000 to 15311.000m asl
+ Run duration:               7day 0hr 0min
+ X grid origin:                 90.00000    
+ Y grid origin:                -15.00000    
+ X grid size:                         281
+ Y grid size:                         221
+ X grid resolution:            0.2500000    
+ Y grid resolution:            0.2500000    
+ Number of preliminary cols:            4
+ Number of field cols:                  1
+ 
+ Fields:
+                        ,                        ,                        ,                        ,                  VOLCANIC,
+                        ,                        ,                        ,                        ,               AirConc Ash,
+                        ,                        ,                        ,                        ,         Air Concentration,
+                        ,                        ,                        ,                        ,              VOLCANIC_ASH,
+                        ,                        ,                        ,                        ,                   g / m^3,
+                        ,                        ,                        ,                        ,               All sources,
+                        ,                        ,                        ,                        ,     No ensemble averaging,
+                        ,                        ,                        ,                        ,          1hr 0min average,
+                        ,                        ,                        ,                        ,   No horizontal averaging,
+                        ,                        ,                        ,                        ,     No vertical averaging,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,      12/01/2020 05:00 UTC,
+                        ,                        ,                        ,                        ,            Z = 1000 m agl,
+                        ,                        ,                        ,                        ,                          ,
+                 X Index,                 Y Index,            X (Lat-Long),            Y (Lat-Long),                          ,

unzipped/Taal_273070_20200112_scenario_yizhou/Taal_273070_20200112_0500_20250107041508.174287/AQOutput_3DField_C1_T1_202001120500_Z10.txt

@@ -0,0 +1,37 @@
+ NAME III (version 8.2)                                          
+ Run name:                   Taal_273070_20250107041508.174287
+ Run time:                   07/01/2025 04:15:10.918 UTC
+ Met data:                   NWP Flow.EC HRES Flow
+ Start of release:           12/01/2020 06:57 UTC
+ End of release:             12/01/2020 21:10 UTC
+ Source strength:            5.333333E+08 g / s
+ Release location:           120.9930E   14.0020N
+ Release height:             311.000 to 15311.000m asl
+ Run duration:               7day 0hr 0min
+ X grid origin:                 90.00000    
+ Y grid origin:                -15.00000    
+ X grid size:                         281
+ Y grid size:                         221
+ X grid resolution:            0.2500000    
+ Y grid resolution:            0.2500000    
+ Number of preliminary cols:            4
+ Number of field cols:                  1
+ 
+ Fields:
+                        ,                        ,                        ,                        ,                  VOLCANIC,
+                        ,                        ,                        ,                        ,               AirConc Ash,
+                        ,                        ,                        ,                        ,         Air Concentration,
+                        ,                        ,                        ,                        ,              VOLCANIC_ASH,
+                        ,                        ,                        ,                        ,                   g / m^3,
+                        ,                        ,                        ,                        ,               All sources,
+                        ,                        ,                        ,                        ,     No ensemble averaging,
+                        ,                        ,                        ,                        ,          1hr 0min average,
+                        ,                        ,                        ,                        ,   No horizontal averaging,
+                        ,                        ,                        ,                        ,     No vertical averaging,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,      12/01/2020 05:00 UTC,
+                        ,                        ,                        ,                        ,           Z = 19000 m agl,
+                        ,                        ,                        ,                        ,                          ,
+                 X Index,                 Y Index,            X (Lat-Long),            Y (Lat-Long),                          ,

unzipped/Taal_273070_20200112_scenario_yizhou/Taal_273070_20200112_0500_20250107041508.174287/AQOutput_3DField_C1_T1_202001120500_Z11.txt

@@ -0,0 +1,37 @@
+ NAME III (version 8.2)                                          
+ Run name:                   Taal_273070_20250107041508.174287
+ Run time:                   07/01/2025 04:15:10.918 UTC
+ Met data:                   NWP Flow.EC HRES Flow
+ Start of release:           12/01/2020 06:57 UTC
+ End of release:             12/01/2020 21:10 UTC
+ Source strength:            5.333333E+08 g / s
+ Release location:           120.9930E   14.0020N
+ Release height:             311.000 to 15311.000m asl
+ Run duration:               7day 0hr 0min
+ X grid origin:                 90.00000    
+ Y grid origin:                -15.00000    
+ X grid size:                         281
+ Y grid size:                         221
+ X grid resolution:            0.2500000    
+ Y grid resolution:            0.2500000    
+ Number of preliminary cols:            4
+ Number of field cols:                  1
+ 
+ Fields:
+                        ,                        ,                        ,                        ,                  VOLCANIC,
+                        ,                        ,                        ,                        ,               AirConc Ash,
+                        ,                        ,                        ,                        ,         Air Concentration,
+                        ,                        ,                        ,                        ,              VOLCANIC_ASH,
+                        ,                        ,                        ,                        ,                   g / m^3,
+                        ,                        ,                        ,                        ,               All sources,
+                        ,                        ,                        ,                        ,     No ensemble averaging,
+                        ,                        ,                        ,                        ,          1hr 0min average,
+                        ,                        ,                        ,                        ,   No horizontal averaging,
+                        ,                        ,                        ,                        ,     No vertical averaging,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,      12/01/2020 05:00 UTC,
+                        ,                        ,                        ,                        ,           Z = 22500 m agl,
+                        ,                        ,                        ,                        ,                          ,
+                 X Index,                 Y Index,            X (Lat-Long),            Y (Lat-Long),                          ,

unzipped/Taal_273070_20200112_scenario_yizhou/Taal_273070_20200112_0500_20250107041508.174287/AQOutput_3DField_C1_T1_202001120500_Z12.txt

@@ -0,0 +1,37 @@
+ NAME III (version 8.2)                                          
+ Run name:                   Taal_273070_20250107041508.174287
+ Run time:                   07/01/2025 04:15:10.918 UTC
+ Met data:                   NWP Flow.EC HRES Flow
+ Start of release:           12/01/2020 06:57 UTC
+ End of release:             12/01/2020 21:10 UTC
+ Source strength:            5.333333E+08 g / s
+ Release location:           120.9930E   14.0020N
+ Release height:             311.000 to 15311.000m asl
+ Run duration:               7day 0hr 0min
+ X grid origin:                 90.00000    
+ Y grid origin:                -15.00000    
+ X grid size:                         281
+ Y grid size:                         221
+ X grid resolution:            0.2500000    
+ Y grid resolution:            0.2500000    
+ Number of preliminary cols:            4
+ Number of field cols:                  1
+ 
+ Fields:
+                        ,                        ,                        ,                        ,                  VOLCANIC,
+                        ,                        ,                        ,                        ,               AirConc Ash,
+                        ,                        ,                        ,                        ,         Air Concentration,
+                        ,                        ,                        ,                        ,              VOLCANIC_ASH,
+                        ,                        ,                        ,                        ,                   g / m^3,
+                        ,                        ,                        ,                        ,               All sources,
+                        ,                        ,                        ,                        ,     No ensemble averaging,
+                        ,                        ,                        ,                        ,          1hr 0min average,
+                        ,                        ,                        ,                        ,   No horizontal averaging,
+                        ,                        ,                        ,                        ,     No vertical averaging,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,      12/01/2020 05:00 UTC,
+                        ,                        ,                        ,                        ,           Z = 27500 m agl,
+                        ,                        ,                        ,                        ,                          ,
+                 X Index,                 Y Index,            X (Lat-Long),            Y (Lat-Long),                          ,

unzipped/Taal_273070_20200112_scenario_yizhou/Taal_273070_20200112_0500_20250107041508.174287/AQOutput_3DField_C1_T1_202001120500_Z2.txt

@@ -0,0 +1,37 @@
+ NAME III (version 8.2)                                          
+ Run name:                   Taal_273070_20250107041508.174287
+ Run time:                   07/01/2025 04:15:10.918 UTC
+ Met data:                   NWP Flow.EC HRES Flow
+ Start of release:           12/01/2020 06:57 UTC
+ End of release:             12/01/2020 21:10 UTC
+ Source strength:            5.333333E+08 g / s
+ Release location:           120.9930E   14.0020N
+ Release height:             311.000 to 15311.000m asl
+ Run duration:               7day 0hr 0min
+ X grid origin:                 90.00000    
+ Y grid origin:                -15.00000    
+ X grid size:                         281
+ Y grid size:                         221
+ X grid resolution:            0.2500000    
+ Y grid resolution:            0.2500000    
+ Number of preliminary cols:            4
+ Number of field cols:                  1
+ 
+ Fields:
+                        ,                        ,                        ,                        ,                  VOLCANIC,
+                        ,                        ,                        ,                        ,               AirConc Ash,
+                        ,                        ,                        ,                        ,         Air Concentration,
+                        ,                        ,                        ,                        ,              VOLCANIC_ASH,
+                        ,                        ,                        ,                        ,                   g / m^3,
+                        ,                        ,                        ,                        ,               All sources,
+                        ,                        ,                        ,                        ,     No ensemble averaging,
+                        ,                        ,                        ,                        ,          1hr 0min average,
+                        ,                        ,                        ,                        ,   No horizontal averaging,
+                        ,                        ,                        ,                        ,     No vertical averaging,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,                          ,
+                        ,                        ,                        ,                        ,      12/01/2020 05:00 UTC,
+                        ,                        ,                        ,                        ,            Z = 3000 m agl,
+                        ,                        ,                        ,                        ,                          ,
+                 X Index,                 Y Index,            X (Lat-Long),            Y (Lat-Long),                          ,