@mailwoman/soil 9.4.0 → 10.1.0

package/out/index.js

@@ -3,42 +3,9 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   The `soil.db` reader — what the soil survey assigns at a coordinate, and on what basis.
- *
- *   THREE ANSWERS, AND KEEPING THEM APART IS THE WHOLE JOB.
- *
- *   1. `designated` — the survey mapped this location and the cell's class distribution is the answer.
- *   2. `designated_no_rating` — the survey mapped this location and rated nothing there. A cell that is
- *      100% `unrated_share` or `notrateable_share` is `designated`-complete and carries no capability
- *      reading whatsoever, and that is not a corner case: 17.1% of national components carry no capability
- *      rating.
- *   3. `unknown` — no coverage row. Outside any published survey area, or inside one where the polygon
- *      exists and the soil mapping behind it does not.
- *
- *   READINGS 2 AND 3 LOOK THE SAME FROM A CLASS CODE AND ARE OPPOSITE ANSWERS FROM THE READER. A layer that
- *   could not tell them apart would report unmapped ground as unrated ground, which is one of the four
- *   absences this whole layer exists to keep separate.
- *
- *   THE ANSWER IS A DISTRIBUTION, AND THE TOP CLASS ALWAYS ARRIVES WITH THE SHARE IT RESTS ON. NRCS's own
- *   `muaggatt` ships `niccdcd` beside `niccdcdpct` for exactly this reason, with an observed minimum of 2%.
- *   A caller that wants one class may take `topClass`; it cannot take it without also being handed
- *   `topClassShare`, because a 2% plurality and an 85% majority are different claims.
- *
- *   NEITHER READING IS A STATEMENT ABOUT WHETHER THE LAND CAN BE FARMED. The layer reports what the soil
- *   survey assigns to the map unit covering a location, which is a fact about the map. NRCS states that its
- *   data "do not eliminate the need for onsite sampling, testing, and detailed study of specific sites for
- *   intensive uses" and are "intended for planning purposes only" — so `limits` carries the authority's own
- *   exclusions on every answer.
- *
- *   THE PROBE IS ONE PRIMARY-KEY READ. The reduction is single-resolution and one row per cell, which is
- *   what makes it the spine key: a coordinate becomes a cell, the cell becomes a row, and the geometry tier
- *   underneath is never touched at read time. The unsimplified rings are there for a caller that wants to
- *   re-derive the claim, not for the probe.
- *
- *   THE READER IS SYNCHRONOUS AND USES RAW PREPARED STATEMENTS, matching the resolution ladder's existing
- *   shape. The DDL that created these tables IS Kysely — see `schema.ts`.
+ *   Synchronous reader for `soil.db` that returns the soil survey's capability-class distribution at a coordinate.
  */
-import { parseJSONStrict } from "@mailwoman/core/json";
+import { parseJSONStrict, stringifyJSON } from "@mailwoman/core/json";
 import { assertCoverageNotEmpty, singleManifestRow, toLayerManifest, } from "@mailwoman/core/layers";
 import { shortCellToInt } from "@mailwoman/spatial";
 import { readCoverageAt } from "@mailwoman/spatial/h3/coverage";
@@ -47,29 +14,28 @@ import { latLngToCell } from "h3-js";
 import { SOIL_LAYER_NAME_PREFIX, SSURGO_PRODUCT_LIMITS } from "#vocabulary";
 export { FarmlandScope, farmlandScope, SSURGO_PRODUCT_LIMITS } from "#vocabulary";
 /**
- * What the layer can say about a coordinate.
+ * The kinds of answer the layer gives for a coordinate, where `DesignatedNoRating`
+ * and `Unknown` must stay apart.
  */
 export const SoilReadingKind = {
     /**
-     * The survey mapped this location and assigns at least one capability class here.
+     * The survey mapped this location and assigns at least one capability class.
      */
     Designated: "designated",
     /**
-     * The survey mapped this location and rated nothing here — every share is an absence share.
+     * The survey mapped this location and assigned no rating.
+     * Every share is reported as an absence share.
      */
     DesignatedNoRating: "designated_no_rating",
     /**
-     * No coverage row. Unmapped by this authority, and never a low-capability reading.
+     * The layer has no coverage for this location.
+     * This does not imply low capability.
      */
     Unknown: "unknown",
 };
 /**
- * Read a sealed `soil.db`.
- *
- * Everything that would make the reader answer a well-formed wrong thing is refused at CONSTRUCTION rather than at
- * query time: a manifest naming a different product, a coverage table with no rows, a vocabulary with no classes. Each
- * of those would otherwise present as a reader that simply always answers `unknown`, which on a receipt is
- * indistinguishable from a region the authority genuinely has not surveyed.
+ * Reads a sealed `soil.db`, throwing at construction on a manifest for a different product,
+ * an empty coverage table, an empty class vocabulary, or a missing share weighting.
  */
 export class SoilCapabilityLookup {
     identity;
@@ -96,14 +62,13 @@ export class SoilCapabilityLookup {
         this.#selectCoverage = this.#database.prepare("SELECT h3_cell, completeness, basis, observed_rows FROM layer_coverage WHERE h3_cell = ?");
     }
     /**
-     * What the soil survey assigns at this coordinate.
+     * Returns what the soil survey assigns at this coordinate.
      */
     lookup(latitude, longitude) {
         const indexCell = latLngToCell(latitude, longitude, this.identity.indexResolution);
         const coverage = this.#readCoverage(indexCell);
-        // COVERAGE QUALIFIES THE READING, and without it there is nothing to report. Unlike a polygon hit — which is a
-        // determination at a location and needs no coverage row to be true — every answer this layer gives is a per-cell
-        // summary, so a summary row without a coverage row would state a determination outside the authority's footprint.
+        // Every answer is a per-cell summary, so a cell outside the coverage table
+        // is unknown even if a summary row exists.
         if (!coverage) {
             return {
                 kind: SoilReadingKind.Unknown,
@@ -113,9 +78,8 @@ export class SoilCapabilityLookup {
         }
         const row = this.#selectCell.get(shortCellToInt(indexCell));
         if (!row) {
-            // A coverage row without a summary row means the coverage cell is designated and this finer cell holds nothing —
-            // the survey-area edge. Unknown rather than "no rating": the authority's statement covers the coverage cell, and
-            // this location may be outside the delineations it covers.
+            // At a survey-area edge the coarser coverage cell is covered and this index cell
+            // has no delineation, so the location may be outside the survey.
             return {
                 kind: SoilReadingKind.Unknown,
                 coverage,
@@ -150,23 +114,15 @@ export class SoilCapabilityLookup {
     [Symbol.dispose]() {
         this.#database.destroy();
     }
-    /**
-     * The coverage row for the index cell's parent at the coverage resolution.
-     */
     #readCoverage(indexCell) {
         return readCoverageAt(this.#selectCoverage, indexCell, this.identity.coverageResolution);
     }
     /**
-     * Which survey area a coordinate falls in, by the delineation bounds each area's row carries.
+     * Returns the first survey area whose bounding rectangle contains the coordinate.
+     * overlapping rectangles may give the wrong area near a corner.
      *
-     * A rectangle rather than the outline, and that is honest about what it is: the answer names WHICH published survey
-     * the reading came from, and two neighbouring counties' rectangles overlap at their corners. The reading itself does
-     * not depend on it — the cell row is the answer — so a corner ambiguity costs a label rather than a determination.
-     *
-     * A LINEAR SCAN, WHICH THE PILOT'S 99 SURVEY AREAS MAKE FREE AND A NATIONAL BUILD WOULD NOT. It returns on the first
-     * containing rectangle, so the pilot costs a few dozen comparisons per geocode. At the 3,380 survey areas the country
-     * holds this wants a bounding-box index; it is left as a scan because a structure sized for a set this build does not
-     * hold would be untested at the size it was built for.
+     * This affects only the `surveyArea` label.
+     * A spatial index would be needed to avoid the linear scan for thousands of areas.
      */
     #surveyAreaAt(latitude, longitude) {
         for (const [index, bounds] of this.#bounds.entries()) {
@@ -180,18 +136,14 @@ export class SoilCapabilityLookup {
         return undefined;
     }
 }
-/**
- * Read and check the layer's identity.
- */
 function readIdentity(database, databasePath) {
     const manifestRows = database.prepare("SELECT * FROM layer_manifest").all();
-    // The name's SUFFIX names the region a build covers, so the reader checks the prefix rather than a whole name — which
-    // is why it asserts its own identity instead of taking `parseManifestRows`: one authority, one product, one rating
-    // vocabulary per artifact, over whichever survey areas were built.
+    // The layer name ends with the region the build covers, so the reader checks only the prefix
+    // rather than `parseManifestRows`, which compares whole names.
     const row = singleManifestRow(manifestRows, `soil reader: ${databasePath}`);
     const name = String(row.name);
     if (!name.startsWith(SOIL_LAYER_NAME_PREFIX)) {
-        throw new Error(`soil reader: ${databasePath} is layer ${JSON.stringify(name)}, which is not a ${JSON.stringify(SOIL_LAYER_NAME_PREFIX)} layer — one authority, one product, one rating vocabulary per artifact`);
+        throw new Error(`soil reader: ${databasePath} is layer ${stringifyJSON(name)}, which is not a ${stringifyJSON(SOIL_LAYER_NAME_PREFIX)} layer — one authority, one product, one rating vocabulary per artifact`);
     }
     const manifest = toLayerManifest(row);
     const spineKeys = manifest.spineKeys;
@@ -241,7 +193,7 @@ function readIdentity(database, databasePath) {
             })),
             classCodes: [...definitions.keys()],
             weighting: { code: weighting.code, description: weighting.definition },
-            databasePath,
+            databasePath: databasePath.toString(),
         },
         definitions,
         bounds: areaRows.map((area) => ({

package/out/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"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"}

package/out/paths.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Where the soil layer database and its download caches live under the data root's `db/` group.
+ */
+import type { PathBuilder, PathBuilderLike } from "path-ts";
+/**
+ * `<dataRoot>/db/soil`.
+ */
+export declare function soilDatabaseRoot(dataRoot: PathBuilderLike): PathBuilder;
+/**
+ * `$MAILWOMAN_DATA_ROOT/db/soil`, read when a path is requested.
+ *
+ * @see {@link soilDatabaseRoot} for another data root.
+ */
+export declare const soilDatabasePath: PathBuilder;
+//# sourceMappingURL=paths.d.ts.map

package/out/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../lib/paths.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE3D;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,eAAe,GAAG,WAAW,CAEvE;AAED;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,WAA8C,CAAA"}

package/out/paths.js

@@ -0,0 +1,21 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Where the soil layer database and its download caches live under the data root's `db/` group.
+ */
+import { databaseRootPath, dataRootPath } from "@mailwoman/core/data-root";
+/**
+ * `<dataRoot>/db/soil`.
+ */
+export function soilDatabaseRoot(dataRoot) {
+    return databaseRootPath(dataRoot)("soil");
+}
+/**
+ * `$MAILWOMAN_DATA_ROOT/db/soil`, read when a path is requested.
+ *
+ * @see {@link soilDatabaseRoot} for another data root.
+ */
+export const soilDatabasePath = soilDatabaseRoot(dataRootPath());
+//# sourceMappingURL=paths.js.map

package/out/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../lib/paths.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAG1E;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAyB;IACzD,OAAO,gBAAgB,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAA;AAC1C,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAgB,gBAAgB,CAAC,YAAY,EAAE,CAAC,CAAA"}