@mailwoman/soil 9.2.0

package/out/sdk/build-soil.js

@@ -0,0 +1,434 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Build `soil.db` — the sealed polygon layer, from the survey areas NRCS publishes.
+ *
+ *   THE ACCUMULATION IS IN SQL, NOT IN A MAP. Classification is per delineation and shared with the
+ *   resolution measurement, but where the touches GO differs on purpose: the measuring instrument holds
+ *   them in memory because it is comparing candidate resolutions in one pass, and the builder streams them
+ *   into a temporary table because memory has to stay flat in row count. A polygon layer's touches
+ *   outnumber its features, and Iowa is 99 survey areas.
+ *
+ *   ABSENCE IS NO ROW, IN EVERY TABLE. Land outside a published survey area gets no `layer_coverage` row and
+ *   no summary row — never a zero, never an empty histogram. Inside a published area the coverage row says
+ *   `designated` at completeness 1.0, because NRCS declares its own mapping complete for those areas at its
+ *   own scale; a coverage cell reached ONLY by `NOTCOM` and access-denied polygons gets no row either,
+ *   because the polygon exists and the soil mapping behind it does not.
+ *
+ *   A COVERAGE ROW LICENSES ONLY THAT THE AUTHORITY MAPPED HERE. The reading is the class distribution, and
+ *   a cell that is 100% `unrated_share` is `designated`-complete and carries no capability reading
+ *   whatsoever. That pairing is not a corner case: 17.1% of national components carry no capability rating,
+ *   and for the irrigated rating the figure is 85.1%.
+ *
+ *   THE AREA CROSS-CHECK USES THE AUTHORITY'S OWN PUBLISHED FIGURE. `legend.areaacres` is what NRCS states
+ *   the survey area covers — 378,800 acres for `IA153`, which is 1,532.9 km² against the 1,532.5 km² an
+ *   independent projected measurement of the same shapefile reports. Comparing the spherical ring sum
+ *   against it catches a hole read as an exterior ring, whose absence is silent: such a polygon is
+ *   well-formed and simply answers "inside" for ground the authority did not map.
+ */
+import { readFileSize } from "@mailwoman/core/fs/readers";
+import { areaAgreementFrom, createLayerCoverageTable, createLayerManifestTable, designatedCoverageCells, polygonLayerManifest, writeLayerCoverage, writeLayerManifest, } from "@mailwoman/core/layers";
+import { resolveModulePath } from "@mailwoman/core/module/resolvers";
+import { ingestChunkArguments, mergeCountsInto, runChunkProcess } from "@mailwoman/core/utils";
+import { arealPolygons, geometryContains, interiorCoverageCells, shortCellToInt, } from "@mailwoman/spatial";
+import { buildSealedArtifact } from "@mailwoman/sqlite/sealed-build";
+import { cellToLatLng } from "h3-js";
+import { createSoilTables } from "#schema";
+import { reduceCells, resolveCells } from "#sdk/cell-tiers";
+import { ingestSoilChunk } from "#sdk/ingest-chunk";
+import { WEIGHT_LATTICE_DEPTH } from "#sdk/reduce";
+import { SOIL_SHARE_WEIGHTING, SOIL_SHARE_WEIGHTING_DESCRIPTION, soilLayerName, SSURGO_ATTRIBUTION, SSURGO_LICENSE, SSURGO_SOURCE, } from "#vocabulary";
+/**
+ * Schema version of the domain tables. Bumped when a column changes meaning, never for an added column a reader can
+ * ignore.
+ */
+export const SOIL_SCHEMA_VERSION = 1;
+/**
+ * Delineation ids per chunk process.
+ *
+ * Sized against the ceiling the flood layer measured rather than guessed: single-process runs over that product died
+ * after roughly 510,000 and 798,000 features as h3's WASM heap fragmented. 100,000 leaves five times that margin, and
+ * the cost of a smaller number is one interpreter start per chunk. Iowa's largest survey area holds well under it, so
+ * on this build the bound costs one process per area — which is what makes an area's failure nameable.
+ */
+export const DEFAULT_CHUNK_SIZE = 100_000;
+/**
+ * Square metres in an acre — the unit `legend.areaacres` publishes in.
+ */
+const M2_PER_ACRE = 4046.8564224;
+/**
+ * The relative gap between the ring-area total and the authority's own published acreage that fails the build.
+ *
+ * Two percent. The comparison is a spherical ring area against a figure NRCS itself warns "may differ from that
+ * measured using GIS software due to different measuring techniques and rounding practices, or due to the fact that the
+ * value has been adjusted so that the sum total of all map units in the legend equals that listed for soil survey area"
+ * — so an exact test would be brittle. Two percent sits far above the 0.03% `IA153` measures and far below the error a
+ * hole-blind read produces, which the zoning survey measured at 4.1% over a whole national layer.
+ */
+const AREA_TOLERANCE = 0.02;
+/**
+ * Build the layer.
+ *
+ * @throws {Error} On a delineation the classifier refuses, a streamed count that disagrees with the shapefile's own
+ *   declaration, an area total that disagrees with the authority's published acreage, or a set of outlines that yields
+ *   no interior coverage cell at all.
+ */
+export async function buildSoilDatabase(options) {
+    if (options.coverageResolution >= options.indexResolution) {
+        throw new Error(`soil build: the coverage resolution (${options.coverageResolution}) must be coarser than the index resolution (${options.indexResolution}) — a row's coverage cell is the PARENT of its index cell`);
+    }
+    if (!options.areas.length) {
+        throw new Error("soil build: no survey areas were supplied — an empty build writes an artifact that answers unknown everywhere while reporting success");
+    }
+    const built = await buildSealedArtifact({
+        out: options.out,
+        createTables: async (kdb) => {
+            await createSoilTables(kdb);
+            await createLayerManifestTable(kdb);
+            await createLayerCoverageTable(kdb);
+            // The touch table exists only for this build and is dropped before the artifact is sealed. No primary key while
+            // loading: the resolution queries below read it through indexes created once the load is done, and a clustered
+            // key would sort every insert against an ingest order nothing controls.
+            kdb.exec("CREATE TABLE build_cell_touch (h3_cell INTEGER NOT NULL, resolution INTEGER NOT NULL, area_id TEXT NOT NULL, is_full INTEGER NOT NULL)");
+        },
+        ingest: async (kdb) => {
+            // Attributes FIRST because the ingest needs one thing out of them — which map units have no soil mapping behind
+            // them — and because a delineation whose map unit is missing must fail while the artifact is still empty rather
+            // than after millions of geometry rows are written.
+            writeAttributes(kdb, options.areas);
+            if (!options.inProcess)
+                return undefined;
+            return aggregateChunks(await ingestInProcess(kdb, options));
+        },
+        ...(options.inProcess
+            ? {}
+            : { batched: async (tmpPath) => aggregateChunks(await runBatchedIngest(tmpPath, options)) }),
+        finish: async (kdb, ingested) => {
+            assertDelineationCounts(options.areas, ingested);
+            const area = assertAreaAgreement(options.areas, ingested);
+            options.onProgress?.(`${ingested.delineations.toLocaleString()} delineations written · resolving cells`);
+            const cells = resolveCells(kdb, options.indexResolution);
+            options.onProgress?.(`${cells.wholeRows.toLocaleString()} whole (compacted) · ${cells.partialRows.toLocaleString()} partial · reducing`);
+            const reduced = reduceCells(kdb, options.indexResolution, options.onProgress);
+            const coverage = buildCoverageCells(options, ingested);
+            await writeLayerCoverage(kdb, coverage.cells);
+            writeSurveyAreaRows(kdb, options, coverage.cellsByArea);
+            writeVocabularyRows(kdb, options.areas);
+            // THE SPINE KEY NAMES THE TABLE A CONSUMER JOINS ON, table-qualified, per the layer contract. For this layer
+            // that is the REDUCTION rather than the containment index: `soil_capability_cell` holds one row per cell at one
+            // resolution, which `soil_map_unit_cell` does not — it is keyed `(cell, delineation)` and is mixed-resolution by
+            // construction, so it is a tier the reader walks rather than a key a consumer joins.
+            await writeLayerManifest(kdb, polygonLayerManifest(options, {
+                name: soilLayerName(options.region),
+                schemaVersion: SOIL_SCHEMA_VERSION,
+                license: SSURGO_LICENSE,
+                attribution: SSURGO_ATTRIBUTION,
+                source: SSURGO_SOURCE,
+                cellColumn: "soil_capability_cell.h3_cell",
+            }));
+            kdb.exec("DROP TABLE build_cell_touch");
+            const totalCellRows = cells.wholeRows + cells.partialRows;
+            return {
+                out: options.out,
+                region: options.region,
+                surveyAreas: options.areas.length,
+                delineations: ingested.delineations,
+                mapUnits: options.areas.reduce((sum, input) => sum + input.attributes.mapUnits.length, 0),
+                components: options.areas.reduce((sum, input) => sum + input.attributes.components.length, 0),
+                indexResolution: options.indexResolution,
+                coverageResolution: options.coverageResolution,
+                wholeCellRows: cells.wholeRows,
+                partialCellRows: cells.partialRows,
+                storedPartialShare: totalCellRows ? cells.partialRows / totalCellRows : 0,
+                capabilityCells: reduced.cells,
+                sampledCells: reduced.sampled,
+                topClassUnderHalfCells: reduced.topClassUnderHalf,
+                topClassUnderHalfShare: reduced.cells ? reduced.topClassUnderHalf / reduced.cells : 0,
+                classlessCells: reduced.classless,
+                unsampledCells: reduced.unsampled,
+                meanDelineationsPerCell: reduced.cells ? reduced.candidatePairs / reduced.cells : 0,
+                coarsenedFeatures: ingested.coarsened,
+                storedResolutions: cells.resolutions,
+                coverageCells: coverage.cells.length,
+                coverageCellsWithoutMapping: coverage.withoutMapping,
+                area,
+            };
+        },
+    });
+    return { ...built, sizeBytes: await readFileSize(options.out) };
+}
+/**
+ * Add up what the chunks reported.
+ *
+ * Exported for its own test: the coverage-cell arithmetic is the one part of the batched path a fixture build cannot
+ * reach, and getting it wrong produces a well-formed artifact that under-reports how many delineations a cell holds.
+ */
+export function aggregateChunks(chunks) {
+    const byArea = new Map();
+    const observedByCoverageCell = new Map();
+    const mappedByCoverageCell = new Map();
+    let delineations = 0;
+    let coarsened = 0;
+    let nestedM2 = 0;
+    let allExteriorM2 = 0;
+    for (const chunk of chunks) {
+        delineations += chunk.delineations;
+        coarsened += chunk.coarsened;
+        nestedM2 += chunk.area.nestedM2;
+        allExteriorM2 += chunk.area.allExteriorM2;
+        byArea.set(chunk.areaSymbol, (byArea.get(chunk.areaSymbol) ?? 0) + chunk.delineations);
+        // A coverage cell straddles chunk boundaries — a range of feature ids is not a region, and a coverage cell can
+        // straddle two survey areas — so the counts ADD rather than replace.
+        mergeCountsInto(observedByCoverageCell, chunk.observedByCoverageCell);
+        mergeCountsInto(mappedByCoverageCell, chunk.mappedByCoverageCell);
+    }
+    return { delineations, coarsened, byArea, observedByCoverageCell, mappedByCoverageCell, nestedM2, allExteriorM2 };
+}
+/**
+ * Refuse a build that streamed fewer delineations than a survey area declares.
+ *
+ * A short read builds a smaller county and reports success, which is the partial result that must throw.
+ */
+function assertDelineationCounts(areas, streamed) {
+    for (const area of areas) {
+        const declared = area.declaredFeatureCount ?? area.source?.declaredFeatureCount;
+        if (declared === undefined)
+            continue;
+        const actual = streamed.byArea.get(area.attributes.areasymbol) ?? 0;
+        if (actual !== declared) {
+            throw new Error(`soil build: ${area.attributes.areasymbol} streamed ${actual} delineations, its shapefile declares ${declared} — a short read builds a smaller survey area and reports success`);
+        }
+    }
+}
+/**
+ * Refuse an artifact whose rings do not add up to the acreage the authority publishes.
+ *
+ * The message carries the hole-blind total beside the nested one, because the gap between them is the diagnosis: a hole
+ * read as an exterior ring answers "inside" for every point in it. A build over survey areas that publish no acreage
+ * has no witness — the reading's own type says so, and the `known` count is what a receipt names.
+ */
+function assertAreaAgreement(areas, streamed) {
+    let publishedAcres = 0;
+    let known = 0;
+    for (const input of areas) {
+        if (input.attributes.areaAcres !== null) {
+            publishedAcres += input.attributes.areaAcres;
+            known++;
+        }
+    }
+    const area = areaAgreementFrom({ nestedM2: streamed.nestedM2, allExteriorM2: streamed.allExteriorM2 }, known ? publishedAcres * M2_PER_ACRE : undefined);
+    if (area.witness === "source" && area.relativeGap > AREA_TOLERANCE) {
+        throw new Error(`soil build: the encoded rings total ${area.nestedKM2.toFixed(1)} km² against the ${area.sourceKM2.toFixed(1)} km² the authority publishes for these ${known} survey areas ` +
+            `(${(area.relativeGap * 100).toFixed(2)}% apart, tolerance ${(AREA_TOLERANCE * 100).toFixed(0)}%). Read without their holes the same rings total ` +
+            `${area.allExteriorKM2.toFixed(1)} km², so compare the two: a hole-blind read answers "inside" for every point in a hole`);
+    }
+    return area;
+}
+/**
+ * Write every survey area's map units, components and vocabulary before any geometry is streamed.
+ */
+function writeAttributes(database, areas) {
+    const insertMapUnit = database.prepare("INSERT OR REPLACE INTO soil_map_unit (mukey, areasymbol, musym, muname, mukind, mustatus, farmlndcl, farmland_scope, niccdcd, niccdcdpct, no_mapping) " +
+        "VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)");
+    const insertComponent = database.prepare("INSERT OR REPLACE INTO soil_component (cokey, mukey, comppct_r, compname, compkind, nirrcapcl, nirrcapscl, irrcapcl, irrcapscl, nccpi_v3) " +
+        "VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)");
+    database.exec("BEGIN");
+    for (const area of areas) {
+        for (const mapUnit of area.attributes.mapUnits) {
+            insertMapUnit.run(mapUnit.mukey, mapUnit.areasymbol, mapUnit.musym, mapUnit.muname, mapUnit.mukind, mapUnit.mustatus, mapUnit.farmlndcl, mapUnit.farmland_scope, mapUnit.niccdcd, mapUnit.niccdcdpct, mapUnit.no_mapping);
+        }
+        for (const component of area.attributes.components) {
+            insertComponent.run(component.cokey, component.mukey, component.comppct_r, component.compname, component.compkind, component.nirrcapcl, component.nirrcapscl, component.irrcapcl, component.irrcapscl, component.nccpi_v3);
+        }
+    }
+    database.exec("COMMIT");
+}
+/**
+ * The map units with no soil mapping behind them, from what was just written.
+ */
+function noMappingMukeys(areas) {
+    const mukeys = new Set();
+    for (const area of areas) {
+        for (const mapUnit of area.attributes.mapUnits) {
+            if (mapUnit.no_mapping) {
+                mukeys.add(mapUnit.mukey);
+            }
+        }
+    }
+    return mukeys;
+}
+/**
+ * The in-process ingest — one chunk per survey area, all in this interpreter. Fixtures only.
+ */
+async function ingestInProcess(database, options) {
+    const noMapping = noMappingMukeys(options.areas);
+    const chunks = [];
+    for (const area of options.areas) {
+        if (!area.source) {
+            throw new Error(`soil build: ${area.attributes.areasymbol} was built in-process without a feature source — the in-process path is for fixtures, which supply one`);
+        }
+        chunks.push(await ingestSoilChunk(database, {
+            source: area.source,
+            indexResolution: options.indexResolution,
+            coverageResolution: options.coverageResolution,
+            noMappingMukeys: noMapping,
+            ...(options.onProgress ? { onProgress: options.onProgress } : {}),
+        }));
+    }
+    return chunks;
+}
+/**
+ * Run the ingest as a sequence of bounded child processes, one per range of one survey area's FIDs. The shared chunk
+ * contract — the parent's no-handle rule, and the fail-loud handling of a chunk that dies or prints nothing — lives
+ * with `ingestChunkArguments` and `runChunkProcess`.
+ */
+async function runBatchedIngest(tmpPath, options) {
+    const chunkSize = options.chunkSize ?? DEFAULT_CHUNK_SIZE;
+    const script = resolveModulePath("@mailwoman/soil/scripts/ingest-chunk");
+    const noMapping = [...noMappingMukeys(options.areas)];
+    const chunks = [];
+    for (const area of options.areas) {
+        if (!area.shapefilePath) {
+            throw new Error(`soil build: ${area.attributes.areasymbol} has no shapefile path, so no chunk process can open it`);
+        }
+        const declared = area.declaredFeatureCount ?? 0;
+        for (let from = 0; from < Math.max(declared, 1); from += chunkSize) {
+            const to = Math.min(from + chunkSize - 1, declared - 1);
+            options.onProgress?.(`${area.attributes.areasymbol}: FID ${from}–${to}`);
+            chunks.push(await runChunkProcess({
+                script,
+                context: "soil build",
+                subject: `chunk ${area.attributes.areasymbol} FID ${from}–${to}`,
+                args: ingestChunkArguments({
+                    database: tmpPath,
+                    args: [
+                        "--shapefile",
+                        area.shapefilePath,
+                        "--area-symbol",
+                        area.attributes.areasymbol,
+                        "--fid-from",
+                        String(from),
+                        "--fid-to",
+                        String(to),
+                        "--no-mapping-mukeys",
+                        noMapping.join(","),
+                    ],
+                    indexResolution: options.indexResolution,
+                    coverageResolution: options.coverageResolution,
+                }),
+            }));
+        }
+    }
+    return chunks;
+}
+/**
+ * The coverage rows: one per interior cell of the built footprint that soil mapping actually reaches, and none outside.
+ *
+ * THE INTERIOR TEST RUNS ONCE OVER THE UNION OF EVERY OUTLINE BUILT, NOT PER SURVEY AREA, and the difference is most of
+ * a state. The test is conservative — it keeps only cells lying WHOLLY inside — so applied per area it drops every cell
+ * a county border crosses. Measured on Polk County alone at resolution 6: 20 interior cells against the roughly 42 the
+ * county spans by area, so more than half of it would read `unknown` while sitting inside a survey the build had
+ * ingested. Run over the union, only the OUTER border of the built set is dropped, which is the honest edge: beyond it
+ * lies ground this artifact does not hold.
+ *
+ * The conservatism itself stays. A cell wrongly called interior would state that an authority determined a location it
+ * never looked at, and a point in the dropped strip reading `unknown` is the truthful answer for ground the built set
+ * may or may not reach.
+ *
+ * `observed_rows` counts the delineations reaching the cell, which is what the contract's column means. A cell reached
+ * only by `NOTCOM` and access-denied polygons gets NO ROW — the polygon exists, the soil mapping behind it does not,
+ * and the survey's §3.2 puts that case with the absences rather than with the coverage.
+ */
+function buildCoverageCells(options, streamed) {
+    const footprint = {
+        type: "MultiPolygon",
+        coordinates: options.areas.flatMap((input) => outlinePolygons(input.outline)),
+    };
+    const interior = interiorCoverageCells(footprint, options.coverageResolution);
+    if (!interior.length) {
+        throw new Error(`soil build: the ${options.areas.length} built outline(s) yield no interior cell at resolution ${options.coverageResolution} — the artifact would carry no coverage rows and answer "unknown" everywhere while reporting success`);
+    }
+    const mapped = (h3Cell) => (streamed.mappedByCoverageCell.get(h3Cell) ?? 0) > 0;
+    const cells = designatedCoverageCells(interior.map((cell) => shortCellToInt(cell)), streamed.observedByCoverageCell, { include: mapped });
+    const cellsByArea = new Map();
+    let withoutMapping = 0;
+    for (const cell of interior) {
+        if (!mapped(shortCellToInt(cell))) {
+            withoutMapping++;
+            continue;
+        }
+        // Attributed by the cell's CENTRE, so each row is counted for exactly one survey area even where the cell straddles
+        // two. The count is a per-area receipt, not part of the coverage claim — the claim is the row set itself.
+        const [latitude, longitude] = cellToLatLng(cell);
+        const owner = options.areas.find((input) => geometryContains(input.outline, longitude, latitude));
+        if (owner) {
+            const symbol = owner.attributes.areasymbol;
+            cellsByArea.set(symbol, (cellsByArea.get(symbol) ?? 0) + 1);
+        }
+    }
+    return { cells, cellsByArea, withoutMapping };
+}
+/**
+ * One outline's polygons, in the `MultiPolygon` coordinate shape, whichever areal type it arrived as.
+ *
+ * @throws {TypeError} When the outline is not areal. A survey area whose footprint cannot be read would silently
+ *   contribute nothing to the union, and the coverage over it would simply be absent.
+ */
+function outlinePolygons(outline) {
+    const polygons = arealPolygons(outline);
+    if (polygons)
+        return polygons;
+    throw new TypeError(`soil build: a survey-area outline is a ${outline.type}, which bounds no area — its coverage would be silently absent rather than refused`);
+}
+/**
+ * Insert one row per survey area.
+ */
+function writeSurveyAreaRows(database, options, cellsByArea) {
+    const insert = database.prepare("INSERT OR REPLACE INTO soil_survey_area (areasymbol, areaname, saverest, saversion, survey_source_date, survey_source_title, source_scale, mapping_scale, area_acres, min_lat, min_lon, max_lat, max_lon, coverage_cells, coverage_resolution) " +
+        "VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)");
+    database.exec("BEGIN");
+    for (const area of options.areas) {
+        const bounds = database
+            .prepare("SELECT min(min_lat) AS min_lat, min(min_lon) AS min_lon, max(max_lat) AS max_lat, max(max_lon) AS max_lon FROM soil_map_unit_area WHERE areasymbol = ?")
+            .get(area.attributes.areasymbol);
+        const row = {
+            areasymbol: area.attributes.areasymbol,
+            areaname: area.attributes.areaname,
+            saverest: area.attributes.saverest,
+            saversion: area.attributes.saversion,
+            survey_source_date: area.attributes.surveySourceDate,
+            survey_source_title: area.attributes.surveySourceTitle,
+            source_scale: area.attributes.sourceScale,
+            mapping_scale: area.attributes.mappingScale,
+            area_acres: area.attributes.areaAcres,
+            min_lat: bounds.min_lat ?? 0,
+            min_lon: bounds.min_lon ?? 0,
+            max_lat: bounds.max_lat ?? 0,
+            max_lon: bounds.max_lon ?? 0,
+            coverage_cells: cellsByArea.get(area.attributes.areasymbol) ?? 0,
+            coverage_resolution: options.coverageResolution,
+        };
+        insert.run(row.areasymbol, row.areaname, row.saverest, row.saversion, row.survey_source_date, row.survey_source_title, row.source_scale, row.mapping_scale, row.area_acres, row.min_lat, row.min_lon, row.max_lat, row.max_lon, row.coverage_cells, row.coverage_resolution);
+    }
+    database.exec("COMMIT");
+}
+/**
+ * Insert the authority's declared domains, plus the weighting the shares were produced under.
+ *
+ * The weighting rides in the vocabulary table as well as on every row: the row-level copy is what a consumer reads, and
+ * this one carries the sentence that says what it MEANS, which no column can.
+ */
+function writeVocabularyRows(database, areas) {
+    const insert = database.prepare("INSERT OR REPLACE INTO soil_vocabulary (domain, code, definition, sequence) VALUES (?, ?, ?, ?)");
+    database.exec("BEGIN");
+    for (const area of areas) {
+        for (const member of area.attributes.domains) {
+            insert.run(member.domain, member.code, member.definition, member.sequence);
+        }
+    }
+    insert.run("share_weighting", SOIL_SHARE_WEIGHTING, SOIL_SHARE_WEIGHTING_DESCRIPTION, WEIGHT_LATTICE_DEPTH);
+    database.exec("COMMIT");
+}
+//# sourceMappingURL=build-soil.js.map

package/out/sdk/build-soil.js.map

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

package/out/sdk/cell-tiers.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   The two phases between the streamed touches and the artifact a consumer reads: the stored containment
+ *   index, and the reduction above it.
+ *
+ *   BOTH READ THE TOUCH TABLE, AND ONLY ONE OF THEM COMPACTS. `resolveCells` writes the tiers a probe walks
+ *   and collapses uniform interiors parent-ward; `reduceCells` reads the UNCOMPACTED touches, because a
+ *   compacted parent no longer names the cells the reduction has to answer.
+ *
+ *   THE REDUCTION IS THE SLOW PHASE AND ITS MEMORY IS BOUNDED BY CONSTRUCTION. A lattice of 49 point tests
+ *   per sampled cell, over a delineation cache that is cleared whole rather than evicted one entry at a
+ *   time — see {@link GEOMETRY_CACHE_ENTRIES}. Memory stays flat in row count, which is the property the poi
+ *   build lost when a reader materialized instead of streaming.
+ */
+import type { DatabaseClient } from "@mailwoman/sqlite/client";
+import { type SoilDatabase } from "#schema";
+/**
+ * Resolve the touch table into the stored containment index.
+ *
+ * Compaction happens HERE and only on the whole side. It is expected to yield close to nothing on this layer, which is
+ * the inversion the survey predicts: compaction needs a uniform interior, and 85.4% of `IA153`'s delineations are
+ * smaller than one resolution-9 cell.
+ */
+export declare function resolveCells(database: DatabaseClient<SoilDatabase>, indexResolution: number): {
+    wholeRows: number;
+    partialRows: number;
+    resolutions: number[];
+};
+/**
+ * Reduce the touch table into `soil_capability_cell`.
+ *
+ * Reads the touch table rather than `soil_map_unit_cell` on purpose: the stored index is compacted on the whole side,
+ * so a compacted parent no longer names the cells the reduction has to answer. The touch table is the uncompacted truth
+ * about which delineation reaches which cell.
+ */
+export declare function reduceCells(database: DatabaseClient<SoilDatabase>, indexResolution: number, onProgress?: (message: string) => void): {
+    cells: number;
+    sampled: number;
+    topClassUnderHalf: number;
+    classless: number;
+    unsampled: number;
+    candidatePairs: number;
+};
+//# sourceMappingURL=cell-tiers.d.ts.map

package/out/sdk/cell-tiers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cell-tiers.d.ts","sourceRoot":"","sources":["../../lib/sdk/cell-tiers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAG9D,OAAO,EAAqD,KAAK,YAAY,EAAE,MAAM,SAAS,CAAA;AAG9F;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC3B,QAAQ,EAAE,cAAc,CAAC,YAAY,CAAC,EACtC,eAAe,EAAE,MAAM,GACrB;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAA;CAAE,CA4DnE;AA8BD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAC1B,QAAQ,EAAE,cAAc,CAAC,YAAY,CAAC,EACtC,eAAe,EAAE,MAAM,EACvB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GACpC;IACF,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,iBAAiB,EAAE,MAAM,CAAA;IACzB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,MAAM,CAAA;CACtB,CAoHA"}