@woosh/meep-engine 2.129.4 → 2.131.0

package/src/core/math/complex/complex_add.js

@@ -0,0 +1,11 @@
+/**
+ * Add two complex numbers
+ * @param {number[]} result
+ * @param {number[]} a
+ * @param {number[]} b
+ */
+export function complex_add(result, a, b) {
+    result[0] = a[0] + b[0];
+    result[1] = a[1] + b[1];
+}
+

package/src/core/math/complex/complex_div.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Divide two complex numbers
+ * @param {number[]} result
+ * @param {number[]} a
+ * @param {number[]} b
+ */
+export function complex_div(result: number[], a: number[], b: number[]): void;
+//# sourceMappingURL=complex_div.d.ts.map

package/src/core/math/complex/complex_div.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"complex_div.d.ts","sourceRoot":"","sources":["../../../../../src/core/math/complex/complex_div.js"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,oCAJW,MAAM,EAAE,KACR,MAAM,EAAE,KACR,MAAM,EAAE,QAOlB"}

package/src/core/math/complex/complex_div.js

@@ -0,0 +1,12 @@
+/**
+ * Divide two complex numbers
+ * @param {number[]} result
+ * @param {number[]} a
+ * @param {number[]} b
+ */
+export function complex_div(result, a, b) {
+    const sqr_norm_b = b[0] * b[0] + b[1] * b[1];
+
+    result[0] = (a[0] * b[0] + a[1] * b[1]) / sqr_norm_b;
+    result[1] = (a[1] * b[0] - a[0] * b[1]) / sqr_norm_b;
+}

package/src/core/math/complex/complex_mul.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Multiply two complex numbers
+ * @param {number[]} result
+ * @param {number[]} a
+ * @param {number[]} b
+ */
+export function complex_mul(result: number[], a: number[], b: number[]): void;
+//# sourceMappingURL=complex_mul.d.ts.map

package/src/core/math/complex/complex_mul.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"complex_mul.d.ts","sourceRoot":"","sources":["../../../../../src/core/math/complex/complex_mul.js"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,oCAJW,MAAM,EAAE,KACR,MAAM,EAAE,KACR,MAAM,EAAE,QAKlB"}

package/src/core/math/complex/complex_mul.js

@@ -0,0 +1,10 @@
+/**
+ * Multiply two complex numbers
+ * @param {number[]} result
+ * @param {number[]} a
+ * @param {number[]} b
+ */
+export function complex_mul(result, a, b) {
+    result[0] = a[0] * b[0] - a[1] * b[1];
+    result[1] = a[0] * b[1] + a[1] * b[0];
+}

package/src/core/math/complex/complex_sub.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Subtract two complex numbers
+ * @param {number[]} result
+ * @param {number[]} a
+ * @param {number[]} b
+ */
+export function complex_sub(result: number[], a: number[], b: number[]): void;
+//# sourceMappingURL=complex_sub.d.ts.map

package/src/core/math/complex/complex_sub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"complex_sub.d.ts","sourceRoot":"","sources":["../../../../../src/core/math/complex/complex_sub.js"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,oCAJW,MAAM,EAAE,KACR,MAAM,EAAE,KACR,MAAM,EAAE,QAKlB"}

package/src/core/math/complex/complex_sub.js

@@ -0,0 +1,10 @@
+/**
+ * Subtract two complex numbers
+ * @param {number[]} result
+ * @param {number[]} a
+ * @param {number[]} b
+ */
+export function complex_sub(result, a, b) {
+    result[0] = a[0] - b[0];
+    result[1] = a[1] - b[1];
+}

package/src/core/math/physics/mie/MIE_PARTICLES_STANDARD.d.ts

@@ -0,0 +1,40 @@
+/**
+ * 📚 A standard library of common atmospheric particles for use in rendering.
+ *
+ * This list provides physically-based, wavelength-dependent presets.
+ *
+ * Note: the medium is Air.
+ */
+export type MIE_PARTICLES_STANDARD = any;
+export namespace MIE_PARTICLES_STANDARD {
+    namespace CONTINENTAL_HAZE_SMALL {
+        export { diameter_m as diameter };
+        export { radius };
+        export { refraction as particle_refraction };
+        export let cross_section_scattering: number[];
+        export let cross_section_extinction: number[];
+        export let extinction_intercept: number[];
+    }
+    namespace CONTINENTAL_HAZE_MEDIUM { }
+    namespace CONTINENTAL_HAZE_LARGE { }
+    namespace MARITIME_HAZE_SMALL { }
+    namespace MARITIME_HAZE_MEDIUM { }
+    namespace MARITIME_HAZE_LARGE { }
+    namespace FOG_DROPLET_SMALL { }
+    namespace FOG_DROPLET_MEDIUM { }
+    namespace CLOUD_DROPLET_LARGE { }
+    namespace SMOKE_PARTICLE_SMALL { }
+    namespace SMOKE_PARTICLE_MEDIUM { }
+    namespace SMOKE_PARTICLE_LARGE { }
+    namespace SOOT_PARTICLE_SMALL { }
+    namespace SOOT_AGGREGATE_MEDIUM { }
+    namespace SOOT_AGGREGATE_LARGE { }
+    namespace FINE_DUST_SMALL { }
+    namespace COARSE_DUST_MEDIUM { }
+    namespace COARSE_DUST_LARGE { }
+    namespace POLLEN_PARTICLE_MEDIUM { }
+    namespace POLLEN_PARTICLE_LARGE { }
+}
+declare const radius: number;
+export {};
+//# sourceMappingURL=MIE_PARTICLES_STANDARD.d.ts.map

package/src/core/math/physics/mie/MIE_PARTICLES_STANDARD.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MIE_PARTICLES_STANDARD.d.ts","sourceRoot":"","sources":["../../../../../../src/core/math/physics/mie/MIE_PARTICLES_STANDARD.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmBI,6BAAgC"}

package/src/core/math/physics/mie/MIE_PARTICLES_STANDARD.js

@@ -0,0 +1,124 @@
+import { compute_mie_particle_properties_rgb } from "./compute_mie_particle_properties_rgb.js";
+import { ri_air } from "./ri_air.js";
+import { ri_ammonium_sulfate } from "./ri_ammonium_sulfate.js";
+import { ri_brine } from "./ri_brine.js";
+import { ri_dust } from "./ri_dust.js";
+import { ri_pollen } from "./ri_pollen.js";
+import { ri_smoke } from "./ri_smoke.js";
+import { ri_soot } from "./ri_soot.js";
+import { ri_water } from "./ri_water.js";
+
+
+/**
+ * Helper function to build a standard particle definition.
+ * Assumes the medium is air (n=1.0).
+ * Computes the spectrally-averaged RGB Mie properties.
+ * @param {number} diameter_m (in meters)
+ * @param {function(result:number[], wavelength:number):number[]} refraction refraction [n, k] - Complex refractive index of the particle. (n=real, k=imaginary)
+ */
+function make(diameter_m, refraction){
+    const radius = diameter_m * 0.5;
+
+    // perform the full spectral sweep (380nm-780nm) and integrate against sRGB CMFs.
+    const mie = compute_mie_particle_properties_rgb(
+        radius,
+        refraction,
+        ri_air,
+    );
+
+    return {
+        diameter: diameter_m,
+        radius,
+        particle_refraction: refraction,
+        cross_section_scattering: mie.scattering_coefficients, // [R_sca, G_sca, B_sca]
+        cross_section_extinction: mie.extinction_coefficients, // [R_ext, G_ext, B_ext]
+        extinction_intercept: mie.extinction_intercept,
+    }
+}
+
+// TODO we can pre-compute these, as integration can be a little time intense
+
+
+/**
+ * 📚 A standard library of common atmospheric particles for use in rendering.
+ *
+ * This list provides physically-based, wavelength-dependent presets.
+ *
+ * Note: the medium is Air.
+ * @enum
+ */
+export const MIE_PARTICLES_STANDARD = {
+    // --- 💧 Water-Based (Haze, Fog, Clouds) ---
+
+    /**
+     * Continental haze (ammonium sulfate surrogate)
+     * SMALL — faint land/city haze: distant skyline slightly washed out on a sunny day.
+     */
+    CONTINENTAL_HAZE_SMALL: make(0.1e-6, ri_ammonium_sulfate), // 100 nm
+    /** MEDIUM — typical daytime urban/valley haze with gentle desaturation. */
+    CONTINENTAL_HAZE_MEDIUM: make(0.5e-6, ri_ammonium_sulfate), // 500 nm
+    /** LARGE — thicker land haze; think post‑inversion murk softening hills. */
+    CONTINENTAL_HAZE_LARGE: make(1.0e-6, ri_ammonium_sulfate), // 1.0 µm
+
+    /**
+     * Maritime haze (sea‑salt/brine)
+     * SMALL — light coastal humidity haze over the ocean.
+     */
+    MARITIME_HAZE_SMALL: make(0.1e-6, ri_brine), // 100 nm
+    /** MEDIUM — bright, milky air on a breezy beach or around harbors. */
+    MARITIME_HAZE_MEDIUM: make(0.5e-6, ri_brine), // 500 nm
+    /** LARGE — thick marine layer look before it becomes fog. */
+    MARITIME_HAZE_LARGE: make(1.0e-6, ri_brine), // 1.0 µm
+
+    /** Larger droplets that create classic white fog and clouds */
+    /** SMALL — light mist: dawn over a lake, waterfall spray, breath fog. */
+    FOG_DROPLET_SMALL: make(2.0e-6, ri_water), // 2.0 µm
+    /** MEDIUM — typical road fog reducing visibility to a few hundred meters. */
+    FOG_DROPLET_MEDIUM: make(10.0e-6, ri_water), // 10.0 µm
+    /** LARGE — bright, thick cloud core or dense sea fog. */
+    CLOUD_DROPLET_LARGE: make(20.0e-6, ri_water), // 20.0 µm
+
+
+    // --- 🔥 Combustion (Smoke & Soot) ---
+
+    /**
+     * Biomass Smoke (e.g., Wood, Wildfire) — "Brown Carbon"
+     * SMALL — fresh wood‑smoke right above the flames.
+     */
+    SMOKE_PARTICLE_SMALL: make(0.1e-6, ri_smoke), // 100 nm
+    /** MEDIUM — typical wildfire/chimney smoke drifting across a valley. */
+    SMOKE_PARTICLE_MEDIUM: make(0.25e-6, ri_smoke), // 250 nm
+    /** LARGE — aged regional smoke layers that turn the sun orange. */
+    SMOKE_PARTICLE_LARGE: make(0.5e-6, ri_smoke), // 500 nm
+
+    /**
+     * Soot (e.g., Diesel Exhaust) — "Black Carbon"
+     * SMALL — very dark sooty exhaust: candle wick zone or fresh tailpipe soot.
+     */
+    SOOT_PARTICLE_SMALL: make(0.05e-6, ri_soot), // 50 nm (Primary particle)
+    /** MEDIUM — traffic/industrial pollution haze mixing into city air. */
+    SOOT_AGGREGATE_MEDIUM: make(0.2e-6, ri_soot), // 200 nm (Clumped)
+    /** LARGE — heavy dirty smoke near source: burning oil/tires. */
+    SOOT_AGGREGATE_LARGE: make(0.4e-6, ri_soot), // 400 nm (Clumped)
+
+
+    // --- 💨 Solid Particulates (Dust & Pollen) ---
+
+    /**
+     * Mineral Dust (e.g., Desert, Sand)
+     * SMALL — far‑range dusty air softening distant mountains.
+     */
+    FINE_DUST_SMALL: make(1.5e-6, ri_dust), // 1.5 µm
+    /** MEDIUM — moving dust clouds from vehicles or field winds. */
+    COARSE_DUST_MEDIUM: make(5.0e-6, ri_dust), // 5.0 µm
+    /** LARGE — sandstorm wall: near‑camera blowing sand/tan curtains. */
+    COARSE_DUST_LARGE: make(15.0e-6, ri_dust), // 15.0 µm
+
+    /**
+     * Pollen (Organic)
+     * MEDIUM — seasonal pollen haze; yellow‑green tint in spring air.
+     */
+    POLLEN_PARTICLE_MEDIUM: make(15.0e-6, ri_pollen), // 15.0 µm
+    /** LARGE — visible puffs from trees (e.g., pine) or catkins in forests. */
+    POLLEN_PARTICLE_LARGE: make(30.0e-6, ri_pollen), // 30.0 µm
+}

package/src/core/math/physics/mie/MIE_PARTICLES_STANDARD_PRECOMPUTED.d.ts

@@ -0,0 +1,168 @@
+/**
+ * 📚 Precomputed standard atmospheric particle library for rendering (zero runtime compute).
+ *
+ * This file is GENERATED. Do not edit by hand.
+ * Generation settings: 380–780 nm, step_count=74, sRGB CMFs, medium=air.
+ * Source: MIE_PARTICLES_STANDARD at generation time.
+ */
+export type MIE_PARTICLES_STANDARD_PRECOMPUTED = any;
+export namespace MIE_PARTICLES_STANDARD_PRECOMPUTED {
+    namespace CONTINENTAL_HAZE_SMALL {
+        let radius: number;
+        let cross_section_scattering: number[];
+        let cross_section_extinction: number[];
+    }
+    namespace CONTINENTAL_HAZE_MEDIUM {
+        let radius_1: number;
+        export { radius_1 as radius };
+        let cross_section_scattering_1: number[];
+        export { cross_section_scattering_1 as cross_section_scattering };
+        let cross_section_extinction_1: number[];
+        export { cross_section_extinction_1 as cross_section_extinction };
+    }
+    namespace CONTINENTAL_HAZE_LARGE {
+        let radius_2: number;
+        export { radius_2 as radius };
+        let cross_section_scattering_2: number[];
+        export { cross_section_scattering_2 as cross_section_scattering };
+        let cross_section_extinction_2: number[];
+        export { cross_section_extinction_2 as cross_section_extinction };
+    }
+    namespace MARITIME_HAZE_SMALL {
+        let radius_3: number;
+        export { radius_3 as radius };
+        let cross_section_scattering_3: number[];
+        export { cross_section_scattering_3 as cross_section_scattering };
+        let cross_section_extinction_3: number[];
+        export { cross_section_extinction_3 as cross_section_extinction };
+    }
+    namespace MARITIME_HAZE_MEDIUM {
+        let radius_4: number;
+        export { radius_4 as radius };
+        let cross_section_scattering_4: number[];
+        export { cross_section_scattering_4 as cross_section_scattering };
+        let cross_section_extinction_4: number[];
+        export { cross_section_extinction_4 as cross_section_extinction };
+    }
+    namespace MARITIME_HAZE_LARGE {
+        let radius_5: number;
+        export { radius_5 as radius };
+        let cross_section_scattering_5: number[];
+        export { cross_section_scattering_5 as cross_section_scattering };
+        let cross_section_extinction_5: number[];
+        export { cross_section_extinction_5 as cross_section_extinction };
+    }
+    namespace FOG_DROPLET_SMALL {
+        let radius_6: number;
+        export { radius_6 as radius };
+        let cross_section_scattering_6: number[];
+        export { cross_section_scattering_6 as cross_section_scattering };
+        let cross_section_extinction_6: number[];
+        export { cross_section_extinction_6 as cross_section_extinction };
+    }
+    namespace FOG_DROPLET_MEDIUM {
+        let radius_7: number;
+        export { radius_7 as radius };
+        let cross_section_scattering_7: number[];
+        export { cross_section_scattering_7 as cross_section_scattering };
+        let cross_section_extinction_7: number[];
+        export { cross_section_extinction_7 as cross_section_extinction };
+    }
+    namespace CLOUD_DROPLET_LARGE {
+        let radius_8: number;
+        export { radius_8 as radius };
+        let cross_section_scattering_8: number[];
+        export { cross_section_scattering_8 as cross_section_scattering };
+        let cross_section_extinction_8: number[];
+        export { cross_section_extinction_8 as cross_section_extinction };
+    }
+    namespace SMOKE_PARTICLE_SMALL {
+        let radius_9: number;
+        export { radius_9 as radius };
+        let cross_section_scattering_9: number[];
+        export { cross_section_scattering_9 as cross_section_scattering };
+        let cross_section_extinction_9: number[];
+        export { cross_section_extinction_9 as cross_section_extinction };
+    }
+    namespace SMOKE_PARTICLE_MEDIUM {
+        let radius_10: number;
+        export { radius_10 as radius };
+        let cross_section_scattering_10: number[];
+        export { cross_section_scattering_10 as cross_section_scattering };
+        let cross_section_extinction_10: number[];
+        export { cross_section_extinction_10 as cross_section_extinction };
+    }
+    namespace SMOKE_PARTICLE_LARGE {
+        let radius_11: number;
+        export { radius_11 as radius };
+        let cross_section_scattering_11: number[];
+        export { cross_section_scattering_11 as cross_section_scattering };
+        let cross_section_extinction_11: number[];
+        export { cross_section_extinction_11 as cross_section_extinction };
+    }
+    namespace SOOT_PARTICLE_SMALL {
+        let radius_12: number;
+        export { radius_12 as radius };
+        let cross_section_scattering_12: number[];
+        export { cross_section_scattering_12 as cross_section_scattering };
+        let cross_section_extinction_12: number[];
+        export { cross_section_extinction_12 as cross_section_extinction };
+    }
+    namespace SOOT_AGGREGATE_MEDIUM {
+        let radius_13: number;
+        export { radius_13 as radius };
+        let cross_section_scattering_13: number[];
+        export { cross_section_scattering_13 as cross_section_scattering };
+        let cross_section_extinction_13: number[];
+        export { cross_section_extinction_13 as cross_section_extinction };
+    }
+    namespace SOOT_AGGREGATE_LARGE {
+        let radius_14: number;
+        export { radius_14 as radius };
+        let cross_section_scattering_14: number[];
+        export { cross_section_scattering_14 as cross_section_scattering };
+        let cross_section_extinction_14: number[];
+        export { cross_section_extinction_14 as cross_section_extinction };
+    }
+    namespace FINE_DUST_SMALL {
+        let radius_15: number;
+        export { radius_15 as radius };
+        let cross_section_scattering_15: number[];
+        export { cross_section_scattering_15 as cross_section_scattering };
+        let cross_section_extinction_15: number[];
+        export { cross_section_extinction_15 as cross_section_extinction };
+    }
+    namespace COARSE_DUST_MEDIUM {
+        let radius_16: number;
+        export { radius_16 as radius };
+        let cross_section_scattering_16: number[];
+        export { cross_section_scattering_16 as cross_section_scattering };
+        let cross_section_extinction_16: number[];
+        export { cross_section_extinction_16 as cross_section_extinction };
+    }
+    namespace COARSE_DUST_LARGE {
+        let radius_17: number;
+        export { radius_17 as radius };
+        let cross_section_scattering_17: number[];
+        export { cross_section_scattering_17 as cross_section_scattering };
+        let cross_section_extinction_17: number[];
+        export { cross_section_extinction_17 as cross_section_extinction };
+    }
+    namespace POLLEN_PARTICLE_MEDIUM {
+        let radius_18: number;
+        export { radius_18 as radius };
+        let cross_section_scattering_18: number[];
+        export { cross_section_scattering_18 as cross_section_scattering };
+        let cross_section_extinction_18: number[];
+        export { cross_section_extinction_18 as cross_section_extinction };
+    }
+    namespace POLLEN_PARTICLE_LARGE {
+        let radius_19: number;
+        export { radius_19 as radius };
+        let cross_section_scattering_19: number[];
+        export { cross_section_scattering_19 as cross_section_scattering };
+        let cross_section_extinction_19: number[];
+        export { cross_section_extinction_19 as cross_section_extinction };
+    }
+}
+//# sourceMappingURL=MIE_PARTICLES_STANDARD_PRECOMPUTED.d.ts.map

package/src/core/math/physics/mie/MIE_PARTICLES_STANDARD_PRECOMPUTED.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MIE_PARTICLES_STANDARD_PRECOMPUTED.d.ts","sourceRoot":"","sources":["../../../../../../src/core/math/physics/mie/MIE_PARTICLES_STANDARD_PRECOMPUTED.js"],"names":[],"mappings":""}

package/src/core/math/physics/mie/MIE_PARTICLES_STANDARD_PRECOMPUTED.js

@@ -0,0 +1,163 @@
+/**
+ * 📚 Precomputed standard atmospheric particle library for rendering (zero runtime compute).
+ *
+ * This file is GENERATED. Do not edit by hand.
+ * Generation settings: 380–780 nm, step_count=74, sRGB CMFs, medium=air.
+ * Source: MIE_PARTICLES_STANDARD at generation time.
+ * @see MIE_PARTICLES_STANDARD
+ * @see generate_precomputed_mie_particles.mjs
+ * @enum
+ */
+export const MIE_PARTICLES_STANDARD_PRECOMPUTED = {
+  // --- 💧 Water-Based (Haze, Fog, Clouds) ---
+
+  /**
+   * Continental haze (ammonium sulfate surrogate)
+   * SMALL — faint land/city haze: distant skyline slightly washed out on a sunny day.
+   */
+  CONTINENTAL_HAZE_SMALL: {
+    radius: 0.05e-6,
+    cross_section_scattering: [1.0372407655007736e-16, 2.1697944057740125e-16, 4.9834807086220629e-16],
+    cross_section_extinction: [1.0390516262084864e-16, 2.1717567402093127e-16, 4.9879160600450892e-16],
+  },
+  /** MEDIUM — typical daytime urban/valley haze with gentle desaturation. */
+  CONTINENTAL_HAZE_MEDIUM: {
+    radius: 0.25e-6,
+    cross_section_scattering: [5.4565604512921649e-13, 6.8622003246048663e-13, 8.2870024363643223e-13],
+    cross_section_extinction: [5.4570929795444263e-13, 6.8627297263235853e-13, 8.2882026711065046e-13],
+  },
+  /** LARGE — thicker land haze; think post‑inversion murk softening hills. */
+  CONTINENTAL_HAZE_LARGE: {
+    radius: 0.5e-6,
+    cross_section_scattering: [3.0366197068566991e-12, 2.1644339349300699e-12, 1.3934801792509724e-12],
+    cross_section_extinction: [3.0370663616112397e-12, 2.1649140149488240e-12, 1.3945032069537524e-12],
+  },
+
+  /**
+   * Maritime haze (sea‑salt/brine)
+   * SMALL — light coastal humidity haze over the ocean.
+   */
+  MARITIME_HAZE_SMALL: {
+    radius: 0.05e-6,
+    cross_section_scattering: [5.5914464254699590e-17, 1.1568131262669868e-16, 2.6209633277373954e-16],
+    cross_section_extinction: [5.5915758170359112e-17, 1.1568241778493796e-16, 2.6209809109662223e-16],
+  },
+  /** MEDIUM — bright, milky air on a breezy beach or around harbors. */
+  MARITIME_HAZE_MEDIUM: {
+    radius: 0.25e-6,
+    cross_section_scattering: [2.7132968972073048e-13, 4.0042274695424540e-13, 5.5420130011596224e-13],
+    cross_section_extinction: [2.7132995584828778e-13, 4.0042298657367437e-13, 5.5420166908930809e-13],
+  },
+  /** LARGE — thick marine layer look before it becomes fog. */
+  MARITIME_HAZE_LARGE: {
+    radius: 0.5e-6,
+    cross_section_scattering: [3.0886981238491608e-12, 3.1506290546356762e-12, 2.6753797206317263e-12],
+    cross_section_extinction: [3.0887005785916678e-12, 3.1506311260919391e-12, 2.6753829166661686e-12],
+  },
+
+  /** Larger droplets that create classic white fog and clouds */
+  /** SMALL — light mist: dawn over a lake, waterfall spray, breath fog. */
+  FOG_DROPLET_SMALL: {
+    radius: 1.0e-6,
+    cross_section_scattering: [6.6871570270074052e-12, 5.4309427410389770e-12, 7.5575449765853189e-12],
+    cross_section_extinction: [6.6871595378323066e-12, 5.4309431516598268e-12, 7.5575452925636131e-12],
+  },
+  /** MEDIUM — typical road fog reducing visibility to a few hundred meters. */
+  FOG_DROPLET_MEDIUM: {
+    radius: 5.0e-6,
+    cross_section_scattering: [1.7316926453733402e-10, 1.6605756824151961e-10, 1.6592498324988880e-10],
+    cross_section_extinction: [1.7316959394334112e-10, 1.6605760278267214e-10, 1.6592500282854191e-10],
+  },
+  /** LARGE — bright, thick cloud core or dense sea fog. */
+  CLOUD_DROPLET_LARGE: {
+    radius: 10.0e-6,
+    cross_section_scattering: [6.5197095812758498e-10, 6.5349550921083126e-10, 6.5384329788317203e-10],
+    cross_section_extinction: [6.5197199508475796e-10, 6.5349565822644719e-10, 6.5384339898122785e-10],
+  },
+
+  // --- 🔥 Combustion (Smoke & Soot) ---
+
+  /**
+   * Biomass Smoke (e.g., Wood, Wildfire) — "Brown Carbon"
+   * SMALL — fresh wood‑smoke right above the flames.
+   */
+  SMOKE_PARTICLE_SMALL: {
+    radius: 0.05e-6,
+    cross_section_scattering: [1.1385189064946861e-16, 2.4068885318662801e-16, 5.6703231058527902e-16],
+    cross_section_extinction: [1.2608332795772137e-16, 2.5983427495073982e-16, 6.0993192464455740e-16],
+  },
+  /** MEDIUM — typical wildfire/chimney smoke drifting across a valley. */
+  SMOKE_PARTICLE_MEDIUM: {
+    radius: 0.125e-6,
+    cross_section_scattering: [2.3785570711758885e-14, 4.0444762406195023e-14, 8.1882149645316101e-14],
+    cross_section_extinction: [2.4061852555120587e-14, 4.0934032778509765e-14, 8.3203081374883472e-14],
+  },
+  /** LARGE — aged regional smoke layers that turn the sun orange. */
+  SMOKE_PARTICLE_LARGE: {
+    radius: 0.25e-6,
+    cross_section_scattering: [6.0660578316854483e-13, 7.2285541567565703e-13, 8.4663317340238114e-13],
+    cross_section_extinction: [6.1046973791426257e-13, 7.2817186974654381e-13, 8.5854543364273271e-13],
+  },
+
+  /**
+   * Soot (e.g., Diesel Exhaust) — "Black Carbon"
+   * SMALL — very dark sooty exhaust: candle wick zone or fresh tailpipe soot.
+   */
+  SOOT_PARTICLE_SMALL: {
+    radius: 0.025e-6,
+    cross_section_scattering: [4.9471330718737624e-18, 1.1425655620156528e-17, 3.3950347490168058e-17],
+    cross_section_extinction: [4.9469990103109046e-16, 6.4148353040364531e-16, 9.4380273910433696e-16],
+  },
+  /** MEDIUM — traffic/industrial pollution haze mixing into city air. */
+  SOOT_AGGREGATE_MEDIUM: {
+    radius: 0.1e-6,
+    cross_section_scattering: [1.6352854546128040e-14, 2.6526194830212333e-14, 3.7046093596342311e-14],
+    cross_section_extinction: [5.6514530217559579e-14, 7.3826969343710883e-14, 8.8338535647949242e-14],
+  },
+  /** LARGE — heavy dirty smoke near source: burning oil/tires. */
+  SOOT_AGGREGATE_LARGE: {
+    radius: 0.2e-6,
+    cross_section_scattering: [1.6063642291966415e-13, 1.6542559814548711e-13, 1.6709610840580629e-13],
+    cross_section_extinction: [3.6165278413413643e-13, 3.6212327105835705e-13, 3.5517888510337905e-13],
+  },
+
+  // --- 💨 Solid Particulates (Dust & Pollen) ---
+
+  /**
+   * Mineral Dust (e.g., Desert, Sand)
+   * SMALL — far‑range dusty air softening distant mountains.
+   */
+  FINE_DUST_SMALL: {
+    radius: 0.75e-6,
+    cross_section_scattering: [2.6567716108736166e-12, 3.7000600340351709e-12, 4.5461877128947888e-12],
+    cross_section_extinction: [2.8817016426305008e-12, 4.1013539958892520e-12, 5.1657861830223932e-12],
+  },
+  /** MEDIUM — moving dust clouds from vehicles or field winds. */
+  COARSE_DUST_MEDIUM: {
+    radius: 2.5e-6,
+    cross_section_scattering: [3.5402159937399897e-11, 3.4676838822224554e-11, 3.3935776143602683e-11],
+    cross_section_extinction: [4.2922059842758115e-11, 4.3544295684829637e-11, 4.3786612417574868e-11],
+  },
+  /** LARGE — sandstorm wall: near‑camera blowing sand/tan curtains. */
+  COARSE_DUST_LARGE: {
+    radius: 7.5e-6,
+    cross_section_scattering: [3.2009871370816270e-10, 2.9679915057976214e-10, 2.7170050898778131e-10],
+    cross_section_extinction: [3.7268701202180954e-10, 3.7040732546910420e-10, 3.6975018275072762e-10],
+  },
+
+  /**
+   * Pollen (Organic)
+   * MEDIUM — seasonal pollen haze; yellow‑green tint in spring air.
+   */
+  POLLEN_PARTICLE_MEDIUM: {
+    radius: 7.5e-6,
+    cross_section_scattering: [3.6436190053386620e-10, 3.5570447403441868e-10, 3.3822498357554905e-10],
+    cross_section_extinction: [3.7552155775356996e-10, 3.7011487872242141e-10, 3.6844677025827028e-10],
+  },
+  /** LARGE — visible puffs from trees (e.g., pine) or catkins in forests. */
+  POLLEN_PARTICLE_LARGE: {
+    radius: 15.0e-6,
+    cross_section_scattering: [1.4020197769557275e-9, 1.3777156444096327e-9, 1.2798203157720485e-9],
+    cross_section_extinction: [1.4599679536172092e-9, 1.4588039863597781e-9, 1.4514473917124675e-9],
+  },
+};

package/src/core/math/physics/mie/compute_bhmie_optical_properties.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Canonical Bohren–Huffman Mie solver (reference implementation)
+ * Computes scattering/extinction cross-sections and asymmetry parameter for a
+ * homogeneous sphere embedded in a host medium.
+ *
+ * @param {number} wavelength Vacuum wavelength (meters)
+ * @param {number} radius Sphere radius (meters)
+ * @param {[number,number]} n_p Particle complex RI [n, k]
+ * @param {[number,number]} n_med Medium complex RI [n, k]
+ * @returns {{sigma_a_med:number, C_ext:number, C_sca:number, g:number}}
+ */
+export function compute_bhmie_optical_properties(wavelength: number, radius: number, n_p: [number, number], n_med: [number, number]): {
+    sigma_a_med: number;
+    C_ext: number;
+    C_sca: number;
+    g: number;
+};
+//# sourceMappingURL=compute_bhmie_optical_properties.d.ts.map

package/src/core/math/physics/mie/compute_bhmie_optical_properties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute_bhmie_optical_properties.d.ts","sourceRoot":"","sources":["../../../../../../src/core/math/physics/mie/compute_bhmie_optical_properties.js"],"names":[],"mappings":"AAUA;;;;;;;;;;GAUG;AACH,6DANW,MAAM,UACN,MAAM,OACN,CAAC,MAAM,EAAC,MAAM,CAAC,SACf,CAAC,MAAM,EAAC,MAAM,CAAC;iBACA,MAAM;WAAQ,MAAM;WAAQ,MAAM;OAAI,MAAM;EAmIrE"}