@bradtech/sensor-soil 1.1.0

package/dist/SoilElectricalConductivityConverter.d.ts

@@ -0,0 +1,37 @@
+import { BaseSensorConverter, type ConversionContext, type ConversionOutput } from '@bradtech/sensor';
+/**
+ * Raw input reading for soil bulk electrical conductivity.
+ */
+export interface SoilEcInput {
+    /** Sensor depth probe location in centimeters */
+    depthCm: number;
+    /** Bulk electrical conductivity reading in mS/cm ($dS/m$) */
+    bulkEcMsCm: number;
+    /** Soil temperature at probe depth in °C */
+    soilTemperature?: number;
+}
+/**
+ * Soil Bulk Electrical Conductivity & Salinity Converter.
+ *
+ * Normalizes bulk EC readings to the international agronomic standard reference temperature of 25°C ($EC_{25}$):
+ * $$EC_{25} = \frac{EC_T}{1 + 0.019 \cdot (T_{soil} - 25)}$$
+ */
+export declare class SoilElectricalConductivityConverter extends BaseSensorConverter<SoilEcInput> {
+    /** Sensor domain family classification */
+    readonly sensorFamily = "soil";
+    /** Unique algorithmic model code */
+    readonly modelCode = "soil-ec-temperature-normalized";
+    /** Algorithm semver version */
+    readonly modelVersion = "1.0.0";
+    /** Human-readable model description */
+    readonly description = "Temperature-normalized soil electrical conductivity converter";
+    /**
+     * Converts raw bulk EC into normalized 25°C salinity metrics with agronomic salinity classification.
+     *
+     * @param raw - Object containing probe depth, measured EC, and soil temperature.
+     * @param _context - Optional environmental context.
+     * @returns Array containing the temperature-compensated EC metric in mS/cm.
+     */
+    convert(raw: SoilEcInput, _context?: ConversionContext): ConversionOutput[];
+}
+//# sourceMappingURL=SoilElectricalConductivityConverter.d.ts.map

package/dist/SoilElectricalConductivityConverter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SoilElectricalConductivityConverter.d.ts","sourceRoot":"","sources":["../src/SoilElectricalConductivityConverter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAErG;;GAEG;AACH,MAAM,WAAW,WAAW;IACzB,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAA;IACf,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAA;IAClB,4CAA4C;IAC5C,eAAe,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED;;;;;GAKG;AACH,qBAAa,mCAAoC,SAAQ,mBAAmB,CAAC,WAAW,CAAC;IACtF,0CAA0C;IAC1C,QAAQ,CAAC,YAAY,UAAS;IAC9B,oCAAoC;IACpC,QAAQ,CAAC,SAAS,oCAAmC;IACrD,+BAA+B;IAC/B,QAAQ,CAAC,YAAY,WAAU;IAC/B,uCAAuC;IACvC,QAAQ,CAAC,WAAW,mEAAkE;IAEtF;;;;;;OAMG;IACH,OAAO,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,EAAE;CAyB7E"}

package/dist/SoilElectricalConductivityConverter.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SoilElectricalConductivityConverter = void 0;
+const sensor_1 = require("@bradtech/sensor");
+/**
+ * Soil Bulk Electrical Conductivity & Salinity Converter.
+ *
+ * Normalizes bulk EC readings to the international agronomic standard reference temperature of 25°C ($EC_{25}$):
+ * $$EC_{25} = \frac{EC_T}{1 + 0.019 \cdot (T_{soil} - 25)}$$
+ */
+class SoilElectricalConductivityConverter extends sensor_1.BaseSensorConverter {
+    constructor() {
+        super(...arguments);
+        /** Sensor domain family classification */
+        this.sensorFamily = 'soil';
+        /** Unique algorithmic model code */
+        this.modelCode = 'soil-ec-temperature-normalized';
+        /** Algorithm semver version */
+        this.modelVersion = '1.0.0';
+        /** Human-readable model description */
+        this.description = 'Temperature-normalized soil electrical conductivity converter';
+    }
+    /**
+     * Converts raw bulk EC into normalized 25°C salinity metrics with agronomic salinity classification.
+     *
+     * @param raw - Object containing probe depth, measured EC, and soil temperature.
+     * @param _context - Optional environmental context.
+     * @returns Array containing the temperature-compensated EC metric in mS/cm.
+     */
+    convert(raw, _context) {
+        let ec25 = raw.bulkEcMsCm;
+        // Temperature compensation: EC_25 = EC_T / (1 + 0.019 * (T - 25))
+        if (raw.soilTemperature !== undefined) {
+            ec25 = raw.bulkEcMsCm / (1.0 + 0.019 * (raw.soilTemperature - 25.0));
+        }
+        const clamped = this.clampWithConfidence(ec25, 0, 20, 0, 10);
+        const depth = raw.depthCm || 10;
+        return [
+            {
+                metric: `okf:soil/conductivity/ec/${depth}cm`,
+                value: clamped.value,
+                unit: 'mS/cm',
+                qudtUri: 'qudt:unit/MilliS-PER-M',
+                confidence: clamped.confidence,
+                metadata: {
+                    depthCm: depth,
+                    salinityClass: ec25 < 2.0 ? 'non_saline' : ec25 < 4.0 ? 'slightly_saline' : 'moderately_saline',
+                },
+            },
+        ];
+    }
+}
+exports.SoilElectricalConductivityConverter = SoilElectricalConductivityConverter;
+//# sourceMappingURL=SoilElectricalConductivityConverter.js.map

package/dist/SoilElectricalConductivityConverter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SoilElectricalConductivityConverter.js","sourceRoot":"","sources":["../src/SoilElectricalConductivityConverter.ts"],"names":[],"mappings":";;;AAAA,6CAAqG;AAcrG;;;;;GAKG;AACH,MAAa,mCAAoC,SAAQ,4BAAgC;IAAzF;;QACG,0CAA0C;QACjC,iBAAY,GAAG,MAAM,CAAA;QAC9B,oCAAoC;QAC3B,cAAS,GAAG,gCAAgC,CAAA;QACrD,+BAA+B;QACtB,iBAAY,GAAG,OAAO,CAAA;QAC/B,uCAAuC;QAC9B,gBAAW,GAAG,+DAA+D,CAAA;IAkCzF,CAAC;IAhCE;;;;;;OAMG;IACH,OAAO,CAAC,GAAgB,EAAE,QAA4B;QACnD,IAAI,IAAI,GAAG,GAAG,CAAC,UAAU,CAAA;QAEzB,kEAAkE;QAClE,IAAI,GAAG,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;YACrC,IAAI,GAAG,GAAG,CAAC,UAAU,GAAG,CAAC,GAAG,GAAG,KAAK,GAAG,CAAC,GAAG,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC,CAAA;QACvE,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,mBAAmB,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAA;QAC5D,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,IAAI,EAAE,CAAA;QAE/B,OAAO;YACJ;gBACG,MAAM,EAAE,4BAA4B,KAAK,IAAI;gBAC7C,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,wBAAwB;gBACjC,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,QAAQ,EAAE;oBACP,OAAO,EAAE,KAAK;oBACd,aAAa,EAAE,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,mBAAmB;iBACjG;aACH;SACH,CAAA;IACJ,CAAC;CACH;AA1CD,kFA0CC"}

package/dist/SoilMoistureConverter.d.ts

@@ -0,0 +1,43 @@
+import { BaseSensorConverter, type ConversionContext, type ConversionOutput } from '@bradtech/sensor';
+/**
+ * Raw input parameters for soil volumetric water content evaluation.
+ */
+export interface SoilMoistureInput {
+    /** Sensor depth probe location in centimeters (10, 20, 30 cm) */
+    depthCm: 10 | 20 | 30 | number;
+    /** Raw dielectric permittivity or capacitive reading from the probe */
+    rawValue: number;
+    /** Soil temperature at the same depth in °C for thermal drift compensation */
+    soilTemperature?: number;
+}
+/**
+ * Multi-depth Soil Moisture & Volumetric Water Content (VWC %) Converter.
+ *
+ * Implements:
+ * - Texture-specific linear regression calibration curves (Sand, Loam, Clay, Silt, Peat):
+ *   $$VWC = a \cdot \text{raw} + b$$
+ * - Custom plot-specific laboratory calibration model overrides ($y = \text{slope} \cdot x + \text{intercept}$).
+ * - Dielectric permittivity temperature compensation normalized to 20°C:
+ *   $$VWC_{comp} = VWC - (T_{soil} - 20) \cdot 0.04$$
+ */
+export declare class SoilMoistureConverter extends BaseSensorConverter<SoilMoistureInput> {
+    /** Sensor domain family classification */
+    readonly sensorFamily = "soil";
+    /** Unique algorithmic model code */
+    readonly modelCode = "soil-vwc-texture-calibrated";
+    /** Algorithm semver version */
+    readonly modelVersion = "1.0.0";
+    /** Human-readable model description */
+    readonly description = "Texture-calibrated multi-depth soil volumetric water content converter";
+    /** Standard USDA soil texture regression coefficients [slope a, intercept b] */
+    private static TEXTURE_COEFFICIENTS;
+    /**
+     * Converts raw capacitive probe readings into physical volumetric water content percentage (% VWC).
+     *
+     * @param raw - Raw sensor reading containing depth and uncalibrated value.
+     * @param context - Optional context providing soil texture classification or custom laboratory calibration models.
+     * @returns Array containing the calibrated soil moisture metric for the corresponding depth.
+     */
+    convert(raw: SoilMoistureInput, context?: ConversionContext): ConversionOutput[];
+}
+//# sourceMappingURL=SoilMoistureConverter.d.ts.map

package/dist/SoilMoistureConverter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SoilMoistureConverter.d.ts","sourceRoot":"","sources":["../src/SoilMoistureConverter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAErG;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC/B,iEAAiE;IACjE,OAAO,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,MAAM,CAAA;IAC9B,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAA;IAChB,8EAA8E;IAC9E,eAAe,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED;;;;;;;;;GASG;AACH,qBAAa,qBAAsB,SAAQ,mBAAmB,CAAC,iBAAiB,CAAC;IAC9E,0CAA0C;IAC1C,QAAQ,CAAC,YAAY,UAAS;IAC9B,oCAAoC;IACpC,QAAQ,CAAC,SAAS,iCAAgC;IAClD,+BAA+B;IAC/B,QAAQ,CAAC,YAAY,WAAU;IAC/B,uCAAuC;IACvC,QAAQ,CAAC,WAAW,4EAA2E;IAE/F,gFAAgF;IAChF,OAAO,CAAC,MAAM,CAAC,oBAAoB,CAOlC;IAED;;;;;;OAMG;IACH,OAAO,CAAC,GAAG,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,EAAE;CA2ClF"}

package/dist/SoilMoistureConverter.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SoilMoistureConverter = void 0;
+const sensor_1 = require("@bradtech/sensor");
+/**
+ * Multi-depth Soil Moisture & Volumetric Water Content (VWC %) Converter.
+ *
+ * Implements:
+ * - Texture-specific linear regression calibration curves (Sand, Loam, Clay, Silt, Peat):
+ *   $$VWC = a \cdot \text{raw} + b$$
+ * - Custom plot-specific laboratory calibration model overrides ($y = \text{slope} \cdot x + \text{intercept}$).
+ * - Dielectric permittivity temperature compensation normalized to 20°C:
+ *   $$VWC_{comp} = VWC - (T_{soil} - 20) \cdot 0.04$$
+ */
+class SoilMoistureConverter extends sensor_1.BaseSensorConverter {
+    constructor() {
+        super(...arguments);
+        /** Sensor domain family classification */
+        this.sensorFamily = 'soil';
+        /** Unique algorithmic model code */
+        this.modelCode = 'soil-vwc-texture-calibrated';
+        /** Algorithm semver version */
+        this.modelVersion = '1.0.0';
+        /** Human-readable model description */
+        this.description = 'Texture-calibrated multi-depth soil volumetric water content converter';
+    }
+    /**
+     * Converts raw capacitive probe readings into physical volumetric water content percentage (% VWC).
+     *
+     * @param raw - Raw sensor reading containing depth and uncalibrated value.
+     * @param context - Optional context providing soil texture classification or custom laboratory calibration models.
+     * @returns Array containing the calibrated soil moisture metric for the corresponding depth.
+     */
+    convert(raw, context) {
+        var _a;
+        const textureKey = (context === null || context === void 0 ? void 0 : context.soilTexture) || 'default';
+        const presetCoeff = SoilMoistureConverter.TEXTURE_COEFFICIENTS[textureKey] || SoilMoistureConverter.TEXTURE_COEFFICIENTS.default;
+        // Check for plot-specific custom linear regression calibration model: y = slope * x + intercept
+        const customRegression = (context === null || context === void 0 ? void 0 : context.soilLinearRegression) || ((_a = context === null || context === void 0 ? void 0 : context.calibration) === null || _a === void 0 ? void 0 : _a.linearRegression);
+        const slope = typeof (customRegression === null || customRegression === void 0 ? void 0 : customRegression.slope) === 'number' ? customRegression.slope : presetCoeff.slope;
+        const intercept = typeof (customRegression === null || customRegression === void 0 ? void 0 : customRegression.intercept) === 'number' ? customRegression.intercept : presetCoeff.intercept;
+        const calibrationType = customRegression ? 'custom_linear_regression' : 'texture_preset';
+        // Apply linear regression calibration: VWC (%) = a * raw + b
+        let vwc = raw.rawValue * slope + intercept;
+        // Apply temperature compensation if soil temperature is known (standard reference at 20°C)
+        if (raw.soilTemperature !== undefined) {
+            const tempDelta = raw.soilTemperature - 20.0;
+            // Dielectric permittivity of water decreases ~0.4%/°C
+            vwc = vwc - tempDelta * 0.04;
+        }
+        // Clamp between 0% (oven dry) and 100% (free water saturation)
+        const clamped = this.clampWithConfidence(vwc, 0, 100, 0, 70);
+        const depth = raw.depthCm || 10;
+        return [
+            {
+                metric: `okf:soil/moisture/${depth}cm`,
+                value: clamped.value,
+                unit: '%',
+                qudtUri: 'qudt:unit/PERCENT',
+                confidence: clamped.confidence,
+                metadata: {
+                    depthCm: depth,
+                    soilTexture: textureKey,
+                    calibrationType,
+                    calibrationSlope: slope,
+                    calibrationIntercept: intercept,
+                    customModelLabel: customRegression === null || customRegression === void 0 ? void 0 : customRegression.modelLabel,
+                    rawInput: raw.rawValue,
+                },
+            },
+        ];
+    }
+}
+exports.SoilMoistureConverter = SoilMoistureConverter;
+/** Standard USDA soil texture regression coefficients [slope a, intercept b] */
+SoilMoistureConverter.TEXTURE_COEFFICIENTS = {
+    sand: { slope: 0.92, intercept: -0.5 },
+    loam: { slope: 1.0, intercept: 0.0 },
+    clay: { slope: 1.15, intercept: 1.2 },
+    silt: { slope: 1.05, intercept: 0.5 },
+    peat: { slope: 1.25, intercept: 2.0 },
+    default: { slope: 1.0, intercept: 0.0 },
+};
+//# sourceMappingURL=SoilMoistureConverter.js.map

package/dist/SoilMoistureConverter.js.map

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

package/dist/SoilTemperatureConverter.d.ts

@@ -0,0 +1,33 @@
+import { BaseSensorConverter, type ConversionContext, type ConversionOutput } from '@bradtech/sensor';
+/**
+ * Raw input reading for depth-specific soil temperature.
+ */
+export interface SoilTemperatureInput {
+    /** Sensor depth probe location in centimeters (e.g. 10, 20, 30 cm) */
+    depthCm: number;
+    /** Soil temperature in °C */
+    temperature: number;
+}
+/**
+ * Multi-depth Soil Temperature Profile Converter.
+ * Normalizes multi-depth soil thermistor measurements with agronomic plausibility clamping.
+ */
+export declare class SoilTemperatureConverter extends BaseSensorConverter<SoilTemperatureInput> {
+    /** Sensor domain family classification */
+    readonly sensorFamily = "soil";
+    /** Unique algorithmic model code */
+    readonly modelCode = "soil-temperature-evaluator";
+    /** Algorithm semver version */
+    readonly modelVersion = "1.0.0";
+    /** Human-readable model description */
+    readonly description = "Multi-depth soil profile temperature converter";
+    /**
+     * Converts raw soil temperature into depth-tagged physical metric records.
+     *
+     * @param raw - Object containing probe depth and measured temperature.
+     * @param _context - Optional environmental context.
+     * @returns Array containing the depth-tagged soil temperature metric.
+     */
+    convert(raw: SoilTemperatureInput, _context?: ConversionContext): ConversionOutput[];
+}
+//# sourceMappingURL=SoilTemperatureConverter.d.ts.map

package/dist/SoilTemperatureConverter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SoilTemperatureConverter.d.ts","sourceRoot":"","sources":["../src/SoilTemperatureConverter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAErG;;GAEG;AACH,MAAM,WAAW,oBAAoB;IAClC,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAA;IACf,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAA;CACrB;AAED;;;GAGG;AACH,qBAAa,wBAAyB,SAAQ,mBAAmB,CAAC,oBAAoB,CAAC;IACpF,0CAA0C;IAC1C,QAAQ,CAAC,YAAY,UAAS;IAC9B,oCAAoC;IACpC,QAAQ,CAAC,SAAS,gCAA+B;IACjD,+BAA+B;IAC/B,QAAQ,CAAC,YAAY,WAAU;IAC/B,uCAAuC;IACvC,QAAQ,CAAC,WAAW,oDAAmD;IAEvE;;;;;;OAMG;IACH,OAAO,CAAC,GAAG,EAAE,oBAAoB,EAAE,QAAQ,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,EAAE;CAetF"}

package/dist/SoilTemperatureConverter.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SoilTemperatureConverter = void 0;
+const sensor_1 = require("@bradtech/sensor");
+/**
+ * Multi-depth Soil Temperature Profile Converter.
+ * Normalizes multi-depth soil thermistor measurements with agronomic plausibility clamping.
+ */
+class SoilTemperatureConverter extends sensor_1.BaseSensorConverter {
+    constructor() {
+        super(...arguments);
+        /** Sensor domain family classification */
+        this.sensorFamily = 'soil';
+        /** Unique algorithmic model code */
+        this.modelCode = 'soil-temperature-evaluator';
+        /** Algorithm semver version */
+        this.modelVersion = '1.0.0';
+        /** Human-readable model description */
+        this.description = 'Multi-depth soil profile temperature converter';
+    }
+    /**
+     * Converts raw soil temperature into depth-tagged physical metric records.
+     *
+     * @param raw - Object containing probe depth and measured temperature.
+     * @param _context - Optional environmental context.
+     * @returns Array containing the depth-tagged soil temperature metric.
+     */
+    convert(raw, _context) {
+        const depth = raw.depthCm || 10;
+        const clamped = this.clampWithConfidence(raw.temperature, -20, 60, -10, 45);
+        return [
+            {
+                metric: `okf:soil/temperature/${depth}cm`,
+                value: clamped.value,
+                unit: '°C',
+                qudtUri: 'qudt:unit/DEG_C',
+                confidence: clamped.confidence,
+                metadata: { depthCm: depth },
+            },
+        ];
+    }
+}
+exports.SoilTemperatureConverter = SoilTemperatureConverter;
+//# sourceMappingURL=SoilTemperatureConverter.js.map

package/dist/SoilTemperatureConverter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SoilTemperatureConverter.js","sourceRoot":"","sources":["../src/SoilTemperatureConverter.ts"],"names":[],"mappings":";;;AAAA,6CAAqG;AAYrG;;;GAGG;AACH,MAAa,wBAAyB,SAAQ,4BAAyC;IAAvF;;QACG,0CAA0C;QACjC,iBAAY,GAAG,MAAM,CAAA;QAC9B,oCAAoC;QAC3B,cAAS,GAAG,4BAA4B,CAAA;QACjD,+BAA+B;QACtB,iBAAY,GAAG,OAAO,CAAA;QAC/B,uCAAuC;QAC9B,gBAAW,GAAG,gDAAgD,CAAA;IAwB1E,CAAC;IAtBE;;;;;;OAMG;IACH,OAAO,CAAC,GAAyB,EAAE,QAA4B;QAC5D,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,IAAI,EAAE,CAAA;QAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;QAE3E,OAAO;YACJ;gBACG,MAAM,EAAE,wBAAwB,KAAK,IAAI;gBACzC,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,IAAI,EAAE,IAAI;gBACV,OAAO,EAAE,iBAAiB;gBAC1B,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,QAAQ,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE;aAC9B;SACH,CAAA;IACJ,CAAC;CACH;AAhCD,4DAgCC"}

package/dist/SoilWaterPotentialConverter.d.ts

@@ -0,0 +1,41 @@
+import { BaseSensorConverter, type ConversionContext, type ConversionOutput } from '@bradtech/sensor';
+/**
+ * Input parameters for matric water potential and pF calculation.
+ */
+export interface SoilWaterPotentialInput {
+    /** Sensor depth probe location in centimeters */
+    depthCm: number;
+    /** Volumetric water content in % (0 - 100) */
+    vwcPercent: number;
+}
+/**
+ * Soil Matric Water Potential ($\Psi_m$ in kPa) & pF Retention Converter.
+ *
+ * Implements the Mualem-van Genuchten hydraulic retention model to relate volumetric
+ * water content ($\theta$) to matric suction pressure head ($h$ in cm of water) and logarithmic pF scale:
+ *
+ * $$S_e = \frac{\theta - \theta_r}{\theta_s - \theta_r}, \quad m = 1 - \frac{1}{n}$$
+ * $$h = \frac{1}{\alpha} \left(S_e^{-1/m} - 1\right)^{1/n}, \quad \Psi_m = -h \cdot 0.0980665 \text{ kPa}$$
+ * $$pF = \log_{10}(h_{cm})$$
+ */
+export declare class SoilWaterPotentialConverter extends BaseSensorConverter<SoilWaterPotentialInput> {
+    /** Sensor domain family classification */
+    readonly sensorFamily = "soil";
+    /** Unique algorithmic model code */
+    readonly modelCode = "soil-water-potential-van-genuchten";
+    /** Algorithm semver version */
+    readonly modelVersion = "1.0.0";
+    /** Human-readable model description */
+    readonly description = "Van Genuchten soil water retention and pF water potential calculator";
+    /** Van Genuchten soil hydraulic retention parameters [$\alpha$, $n$, $\theta_r$, $\theta_s$] */
+    private static SOIL_VG_PARAMS;
+    /**
+     * Converts volumetric water content percentage into matric water potential (kPa) and pF availability scale.
+     *
+     * @param raw - Object containing probe depth and VWC percentage.
+     * @param context - Optional context specifying soil textural class.
+     * @returns Array containing both matric potential (kPa) and pF metrics.
+     */
+    convert(raw: SoilWaterPotentialInput, context?: ConversionContext): ConversionOutput[];
+}
+//# sourceMappingURL=SoilWaterPotentialConverter.d.ts.map

package/dist/SoilWaterPotentialConverter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SoilWaterPotentialConverter.d.ts","sourceRoot":"","sources":["../src/SoilWaterPotentialConverter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAErG;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACrC,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAA;IACf,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAA;CACpB;AAED;;;;;;;;;GASG;AACH,qBAAa,2BAA4B,SAAQ,mBAAmB,CAAC,uBAAuB,CAAC;IAC1F,0CAA0C;IAC1C,QAAQ,CAAC,YAAY,UAAS;IAC9B,oCAAoC;IACpC,QAAQ,CAAC,SAAS,wCAAuC;IACzD,+BAA+B;IAC/B,QAAQ,CAAC,YAAY,WAAU;IAC/B,uCAAuC;IACvC,QAAQ,CAAC,WAAW,0EAAyE;IAE7F,gGAAgG;IAChG,OAAO,CAAC,MAAM,CAAC,cAAc,CAM5B;IAED;;;;;;OAMG;IACH,OAAO,CAAC,GAAG,EAAE,uBAAuB,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,EAAE;CA+CxF"}

package/dist/SoilWaterPotentialConverter.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SoilWaterPotentialConverter = void 0;
+const sensor_1 = require("@bradtech/sensor");
+/**
+ * Soil Matric Water Potential ($\Psi_m$ in kPa) & pF Retention Converter.
+ *
+ * Implements the Mualem-van Genuchten hydraulic retention model to relate volumetric
+ * water content ($\theta$) to matric suction pressure head ($h$ in cm of water) and logarithmic pF scale:
+ *
+ * $$S_e = \frac{\theta - \theta_r}{\theta_s - \theta_r}, \quad m = 1 - \frac{1}{n}$$
+ * $$h = \frac{1}{\alpha} \left(S_e^{-1/m} - 1\right)^{1/n}, \quad \Psi_m = -h \cdot 0.0980665 \text{ kPa}$$
+ * $$pF = \log_{10}(h_{cm})$$
+ */
+class SoilWaterPotentialConverter extends sensor_1.BaseSensorConverter {
+    constructor() {
+        super(...arguments);
+        /** Sensor domain family classification */
+        this.sensorFamily = 'soil';
+        /** Unique algorithmic model code */
+        this.modelCode = 'soil-water-potential-van-genuchten';
+        /** Algorithm semver version */
+        this.modelVersion = '1.0.0';
+        /** Human-readable model description */
+        this.description = 'Van Genuchten soil water retention and pF water potential calculator';
+    }
+    /**
+     * Converts volumetric water content percentage into matric water potential (kPa) and pF availability scale.
+     *
+     * @param raw - Object containing probe depth and VWC percentage.
+     * @param context - Optional context specifying soil textural class.
+     * @returns Array containing both matric potential (kPa) and pF metrics.
+     */
+    convert(raw, context) {
+        const textureKey = (context === null || context === void 0 ? void 0 : context.soilTexture) || 'default';
+        const params = SoilWaterPotentialConverter.SOIL_VG_PARAMS[textureKey] || SoilWaterPotentialConverter.SOIL_VG_PARAMS.default;
+        const theta = Math.min(params.thetaS - 0.1, Math.max(params.thetaR + 0.1, raw.vwcPercent));
+        const Se = (theta - params.thetaR) / (params.thetaS - params.thetaR); // Effective saturation
+        const m = 1.0 - 1.0 / params.n;
+        // Matric suction head (h in cm of water column): h = (1/alpha) * (Se^(-1/m) - 1)^(1/n)
+        const hCm = (1.0 / params.alpha) * Math.pow(Math.pow(Se, -1.0 / m) - 1.0, 1.0 / params.n);
+        // Convert head cm to matric potential in kPa: 1 cm H2O ≈ 0.0980665 kPa
+        const potentialKpa = -(hCm * 0.0980665);
+        // pF = log10(h in cm)
+        const pF = Math.log10(Math.max(1.0, hCm));
+        const pFClamped = this.clampWithConfidence(pF, 0, 7.0);
+        const kpaClamped = this.clampWithConfidence(potentialKpa, -2000, 0);
+        const depth = raw.depthCm || 10;
+        return [
+            {
+                metric: `okf:soil/potential/matric/${depth}cm`,
+                value: kpaClamped.value,
+                unit: 'kPa',
+                qudtUri: 'qudt:unit/KiloPA',
+                confidence: pFClamped.confidence,
+                metadata: {
+                    depthCm: depth,
+                    soilTexture: textureKey,
+                },
+            },
+            {
+                metric: `okf:soil/potential/pf/${depth}cm`,
+                value: pFClamped.value,
+                unit: 'pF',
+                qudtUri: 'qudt:unit/UNITLESS',
+                confidence: pFClamped.confidence,
+                metadata: {
+                    depthCm: depth,
+                    soilTexture: textureKey,
+                    waterAvailabilityState: pF < 2.0 ? 'saturated' : pF < 2.5 ? 'field_capacity' : pF < 3.8 ? 'readily_available' : pF < 4.2 ? 'water_stress' : 'wilting_point',
+                },
+            },
+        ];
+    }
+}
+exports.SoilWaterPotentialConverter = SoilWaterPotentialConverter;
+/** Van Genuchten soil hydraulic retention parameters [$\alpha$, $n$, $\theta_r$, $\theta_s$] */
+SoilWaterPotentialConverter.SOIL_VG_PARAMS = {
+    sand: { alpha: 0.145, n: 2.68, thetaR: 4.5, thetaS: 43.0 },
+    loam: { alpha: 0.036, n: 1.56, thetaR: 7.8, thetaS: 43.0 },
+    clay: { alpha: 0.008, n: 1.09, thetaR: 6.8, thetaS: 38.0 },
+    silt: { alpha: 0.016, n: 1.37, thetaR: 3.4, thetaS: 46.0 },
+    default: { alpha: 0.036, n: 1.56, thetaR: 7.8, thetaS: 43.0 },
+};
+//# sourceMappingURL=SoilWaterPotentialConverter.js.map

package/dist/SoilWaterPotentialConverter.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from './SoilMoistureConverter';
+export * from './SoilWaterPotentialConverter';
+export * from './SoilTemperatureConverter';
+export * from './SoilElectricalConductivityConverter';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAA;AACvC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,4BAA4B,CAAA;AAC1C,cAAc,uCAAuC,CAAA"}

package/dist/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./SoilMoistureConverter"), exports);
+__exportStar(require("./SoilWaterPotentialConverter"), exports);
+__exportStar(require("./SoilTemperatureConverter"), exports);
+__exportStar(require("./SoilElectricalConductivityConverter"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0DAAuC;AACvC,gEAA6C;AAC7C,6DAA0C;AAC1C,wEAAqD"}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@bradtech/sensor-soil",
+  "version": "1.1.0",
+  "description": "Multi-depth capacitive volumetric water content, soil matric water potential pF, EC, and soil temperature converters",
+  "author": "Olivier Lépine <olivier@lepine.fr>",
+  "license": "AGPL-3.0-or-later",
+  "copyright": "Copyright (C) 2026 Olivier Lépine",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bradtech-oss/stack.git",
+    "directory": "packages/sensor-soil"
+  },
+  "keywords": [
+    "iot",
+    "soil-moisture",
+    "vwc",
+    "matric-potential",
+    "pf-curve",
+    "van-genuchten",
+    "soil-ec",
+    "soil-temperature",
+    "agronomy",
+    "irrigation",
+    "brad",
+    "agpl-v3"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "bun": "./src/index.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "LICENSE",
+    "README.md",
+    "HOWTO.md",
+    "!**/*.test.ts"
+  ],
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "tsc",
+    "wbuild": "tsc --watch",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "@bradtech/sensor": "workspace:*"
+  },
+  "devDependencies": {
+    "@tsconfig/recommended": "^1.0.1",
+    "@types/node": "^22.10.1",
+    "typescript": "^5.1.5"
+  }
+}

package/src/SoilElectricalConductivityConverter.ts

@@ -0,0 +1,63 @@
+import { BaseSensorConverter, type ConversionContext, type ConversionOutput } from '@bradtech/sensor'
+
+/**
+ * Raw input reading for soil bulk electrical conductivity.
+ */
+export interface SoilEcInput {
+   /** Sensor depth probe location in centimeters */
+   depthCm: number
+   /** Bulk electrical conductivity reading in mS/cm ($dS/m$) */
+   bulkEcMsCm: number
+   /** Soil temperature at probe depth in °C */
+   soilTemperature?: number
+}
+
+/**
+ * Soil Bulk Electrical Conductivity & Salinity Converter.
+ *
+ * Normalizes bulk EC readings to the international agronomic standard reference temperature of 25°C ($EC_{25}$):
+ * $$EC_{25} = \frac{EC_T}{1 + 0.019 \cdot (T_{soil} - 25)}$$
+ */
+export class SoilElectricalConductivityConverter extends BaseSensorConverter<SoilEcInput> {
+   /** Sensor domain family classification */
+   readonly sensorFamily = 'soil'
+   /** Unique algorithmic model code */
+   readonly modelCode = 'soil-ec-temperature-normalized'
+   /** Algorithm semver version */
+   readonly modelVersion = '1.0.0'
+   /** Human-readable model description */
+   readonly description = 'Temperature-normalized soil electrical conductivity converter'
+
+   /**
+    * Converts raw bulk EC into normalized 25°C salinity metrics with agronomic salinity classification.
+    *
+    * @param raw - Object containing probe depth, measured EC, and soil temperature.
+    * @param _context - Optional environmental context.
+    * @returns Array containing the temperature-compensated EC metric in mS/cm.
+    */
+   convert(raw: SoilEcInput, _context?: ConversionContext): ConversionOutput[] {
+      let ec25 = raw.bulkEcMsCm
+
+      // Temperature compensation: EC_25 = EC_T / (1 + 0.019 * (T - 25))
+      if (raw.soilTemperature !== undefined) {
+         ec25 = raw.bulkEcMsCm / (1.0 + 0.019 * (raw.soilTemperature - 25.0))
+      }
+
+      const clamped = this.clampWithConfidence(ec25, 0, 20, 0, 10)
+      const depth = raw.depthCm || 10
+
+      return [
+         {
+            metric: `okf:soil/conductivity/ec/${depth}cm`,
+            value: clamped.value,
+            unit: 'mS/cm',
+            qudtUri: 'qudt:unit/MilliS-PER-M',
+            confidence: clamped.confidence,
+            metadata: {
+               depthCm: depth,
+               salinityClass: ec25 < 2.0 ? 'non_saline' : ec25 < 4.0 ? 'slightly_saline' : 'moderately_saline',
+            },
+         },
+      ]
+   }
+}