@driftengine/chemistry 4.7.0 → 4.7.1

package/README.md

@@ -31,7 +31,7 @@ wants matter and no renderer pays for matter and no renderer.
 | **The parcels meet the air**         | A burning parcel draws the oxygen its reactions want out of the cell it sits in and pushes the gas they make into it. One relaxation, both directions                                                                                                                                                                                                                                                                                                                                                                                      |
 | **Ignition is a criterion**          | Five conditions, and `ignite` supplies one of them. **Holding a match to wet wood does nothing**, which is the API telling the truth about what a match is                                                                                                                                                                                                                                                                                                                                                                                 |
 | **Extinction is four**               | Fuel gone, oxygen below the limiting index, surface cooled, or blown off — and a smoulder survives air a flame cannot, which is why smothering leaves embers                                                                                                                                                                                                                                                                                                                                                                               |
-| **An event buffer**                  | Twenty-one kinds, drained per tick, in the shape `drift/physics`'s contact buffer established                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| **An event buffer**                  | Twenty-one kinds declared and drained per tick, in the shape `drift/physics`'s contact buffer established. Four are emitted today: ignition, extinction, and a smoulder starting and ending. The other seventeen, melting and boiling among them, are named and not yet raised, so a consumer watching for one reads the parcel's phase or temperature instead                                                                                                                                                                             |
 | **Char glows for an hour**           | Above about 800 K the chemistry outruns oxygen delivery, so the rate is transport, not kinetics. The two combine as a series resistance — and **blowing on an ember brightens it**                                                                                                                                                                                                                                                                                                                                                         |
 | **A smoulder's smoke is pale**       | Tar leaving a surface cracks to soot and burns where it is hot, and **condenses to droplets where it is not** — a 523 K dew point, which is Clausius-Clapeyron at the loading a plume carries rather than levoglucosan's 658 K boiling point. Two rates that climb with temperature against one gate that closes with it, so a flame blackens its own smoke and a smoulder whitens its own with nothing choosing. `aerosolAt` sums every carried species in the **liquid phase**, so the field never names a species this library invented |
 | **A log dries, smokes and catches**  | The whole of `§21`, asserted: the surface pins at the boiling point while the core stays cold, gas comes off, and it lights. **A green log at the same fire does not**                                                                                                                                                                                                                                                                                                                                                                     |

package/dist/field/atmosphere.d.ts

@@ -214,12 +214,16 @@ export declare class AtmosphereField {
      * **The quantity `visibilityAt` is derived from**, and the one a consumer attenuating a light
      * along a ray actually needs: metres of visibility is one answer to it and `exp(−σ·d)` is another.
      * Exporting only the first would have every consumer inverting Koschmieder to get back here.
+     *
+     * **Soot and droplets both.** It counted soot alone, so a smoulder's smoke, which is droplets,
+     * hid nothing and was drawn at an alpha of about 1e-29 by `emitSmoke`: the pale half of smoke
+     * was in the field and nowhere on screen.
      */
     smokeDensityAt(x: number, y: number, z: number): number;
     /**
      * How far you can see, metres.
      *
-     * Koschmieder over the soot's extinction. Clamped at ten kilometres, past which the answer stops
+     * Koschmieder over the smoke's extinction, soot and droplets. Clamped at ten kilometres, past which the answer stops
      * being about the smoke.
      */
     visibilityAt(x: number, y: number, z: number): number;

package/dist/field/atmosphere.js

@@ -36,6 +36,15 @@ export const CHUNK_SIZE = 8;
  * rather than absorbs and runs lower.
  */
 const SOOT_EXTINCTION = 8700;
+/**
+ * Extinction per kilogram of droplets per cubic metre, m²/kg.
+ *
+ * The mass-specific extinction measured for smouldering-fire smoke, which is mostly liquid aerosol
+ * and scatters where soot absorbs: about half of flaming smoke's, per kilogram. One number for every
+ * droplet, which is right for tar condensing out of a smoulder, the aerosol this field was built
+ * for, and generous for coarse water droplets, which scatter less per kilogram.
+ */
+const AEROSOL_EXTINCTION = 4400;
 /** Koschmieder's constant: the contrast threshold that defines "can no longer see it". */
 const VISIBILITY_CONSTANT = 3.912;
 /**
@@ -583,14 +592,19 @@ export class AtmosphereField {
      * **The quantity `visibilityAt` is derived from**, and the one a consumer attenuating a light
      * along a ray actually needs: metres of visibility is one answer to it and `exp(−σ·d)` is another.
      * Exporting only the first would have every consumer inverting Koschmieder to get back here.
+     *
+     * **Soot and droplets both.** It counted soot alone, so a smoulder's smoke, which is droplets,
+     * hid nothing and was drawn at an alpha of about 1e-29 by `emitSmoke`: the pale half of smoke
+     * was in the field and nowhere on screen.
      */
     smokeDensityAt(x, y, z) {
-        return (this.sootAt(x, y, z) / this.cellVolume) * SOOT_EXTINCTION;
+        return ((this.sootAt(x, y, z) * SOOT_EXTINCTION + this.aerosolAt(x, y, z) * AEROSOL_EXTINCTION) /
+            this.cellVolume);
     }
     /**
      * How far you can see, metres.
      *
-     * Koschmieder over the soot's extinction. Clamped at ten kilometres, past which the answer stops
+     * Koschmieder over the smoke's extinction, soot and droplets. Clamped at ten kilometres, past which the answer stops
      * being about the smoke.
      */
     visibilityAt(x, y, z) {

package/dist/parcel/store.d.ts

@@ -294,6 +294,14 @@ export declare class ParcelStore {
      * simultaneously consuming, which is what makes drying visible.
      */
     wetnessOf(parcel: number): number;
+    /**
+     * Whether this parcel's substance can hold liquid water, which is what `wet` asks of it.
+     *
+     * A caller pouring rain over everything asks first: `wet` refuses a material with no water in its
+     * model, and refusing is right, but a loop over every parcel in the rain had no way to tell an
+     * iron nail from a log before it was told.
+     */
+    wettable(parcel: number): boolean;
     /**
      * Pour water on it: liquid water into the surface shell, where the boiling reaction will find it.
      *

package/dist/parcel/store.js

@@ -812,6 +812,18 @@ export class ParcelStore {
         const free = held - authored;
         return free > 0 ? free / area : 0;
     }
+    /**
+     * Whether this parcel's substance can hold liquid water, which is what `wet` asks of it.
+     *
+     * A caller pouring rain over everything asks first: `wet` refuses a material with no water in its
+     * model, and refusing is right, but a loop over every parcel in the rain had no way to tell an
+     * iron nail from a log before it was told.
+     */
+    wettable(parcel) {
+        const water = this.species.indexOf('H2O(l)');
+        const substance = this.substance[this.check(parcel)];
+        return water >= 0 && this.substances.localSlotOf(substance, water) >= 0;
+    }
     /**
      * Pour water on it: liquid water into the surface shell, where the boiling reaction will find it.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@driftengine/chemistry",
-  "version": "4.7.0",
+  "version": "4.7.1",
   "description": "Thermochemistry of bulk matter: elements, species, substances and what they turn into",
   "license": "Apache-2.0",
   "type": "module",

package/src/field/atmosphere.ts

@@ -49,6 +49,16 @@ export const CHUNK_SIZE = 8;
  */
 const SOOT_EXTINCTION = 8700;
 
+/**
+ * Extinction per kilogram of droplets per cubic metre, m²/kg.
+ *
+ * The mass-specific extinction measured for smouldering-fire smoke, which is mostly liquid aerosol
+ * and scatters where soot absorbs: about half of flaming smoke's, per kilogram. One number for every
+ * droplet, which is right for tar condensing out of a smoulder, the aerosol this field was built
+ * for, and generous for coarse water droplets, which scatter less per kilogram.
+ */
+const AEROSOL_EXTINCTION = 4400;
+
 /** Koschmieder's constant: the contrast threshold that defines "can no longer see it". */
 const VISIBILITY_CONSTANT = 3.912;
 
@@ -657,15 +667,22 @@ export class AtmosphereField {
    * **The quantity `visibilityAt` is derived from**, and the one a consumer attenuating a light
    * along a ray actually needs: metres of visibility is one answer to it and `exp(−σ·d)` is another.
    * Exporting only the first would have every consumer inverting Koschmieder to get back here.
+   *
+   * **Soot and droplets both.** It counted soot alone, so a smoulder's smoke, which is droplets,
+   * hid nothing and was drawn at an alpha of about 1e-29 by `emitSmoke`: the pale half of smoke
+   * was in the field and nowhere on screen.
    */
   smokeDensityAt(x: number, y: number, z: number): number {
-    return (this.sootAt(x, y, z) / this.cellVolume) * SOOT_EXTINCTION;
+    return (
+      (this.sootAt(x, y, z) * SOOT_EXTINCTION + this.aerosolAt(x, y, z) * AEROSOL_EXTINCTION) /
+      this.cellVolume
+    );
   }
 
   /**
    * How far you can see, metres.
    *
-   * Koschmieder over the soot's extinction. Clamped at ten kilometres, past which the answer stops
+   * Koschmieder over the smoke's extinction, soot and droplets. Clamped at ten kilometres, past which the answer stops
    * being about the smoke.
    */
   visibilityAt(x: number, y: number, z: number): number {

package/src/parcel/store.ts

@@ -915,6 +915,19 @@ export class ParcelStore {
     return free > 0 ? free / area : 0;
   }
 
+  /**
+   * Whether this parcel's substance can hold liquid water, which is what `wet` asks of it.
+   *
+   * A caller pouring rain over everything asks first: `wet` refuses a material with no water in its
+   * model, and refusing is right, but a loop over every parcel in the rain had no way to tell an
+   * iron nail from a log before it was told.
+   */
+  wettable(parcel: number): boolean {
+    const water = this.species.indexOf('H2O(l)');
+    const substance = this.substance[this.check(parcel)] as number;
+    return water >= 0 && this.substances.localSlotOf(substance, water) >= 0;
+  }
+
   /**
    * Pour water on it: liquid water into the surface shell, where the boiling reaction will find it.
    *