edf2csv 0.2.12 → 0.2.13

package/CHANGELOG.md

@@ -3,6 +3,23 @@
 Notable changes to edf2csv. Versions follow [semantic versioning](https://semver.org); while the
 major version is 0, a minor bump may contain breaking changes.
 
+## 0.2.13
+
+### Fixed: the precision ceiling collapsed distinct samples on the finest channels
+
+Decimal places are derived per channel so that two adjacent digital codes never round to the same
+text — that is the invariant the whole precision rule exists to hold. The ceiling was 15, which the
+comment beside it justified by pointing at channels calibrated in volts and tesla.
+
+Tesla was in fact fine. Femtotesla was not, which is the unit MEG is actually recorded in: a channel
+spanning ±1e-12 T over a 16-bit converter has a step near 3e-17 and needs 19 places, so at 15 it
+printed **96 of every 100 adjacent codes identically**. Distinct measurements became the same string,
+silently — exactly the outcome the rule is meant to prevent.
+
+The ceiling is now 20, and `--decimals` accepts 0–20 to match. Adjacent codes stay distinct from
+microvolts down to attotesla. Ordinary channels are untouched: a µV EEG channel still derives 3
+places and a volt-scale channel still derives 9.
+
 ## 0.2.12
 
 ### Fixed: annotation channels were never pluralised

package/dist/cli.js

@@ -289,8 +289,8 @@ function optionalDecimals(raw) {
         throw new OptionError('--decimals needs a number, for example --decimals 3.');
     }
     const value = Number(text);
-    if (!Number.isInteger(value) || value < 0 || value > 15) {
-        throw new OptionError(`--decimals must be a whole number between 0 and 15, got "${String(raw)}".`);
+    if (!Number.isInteger(value) || value < 0 || value > 20) {
+        throw new OptionError(`--decimals must be a whole number between 0 and 20, got "${String(raw)}".`);
     }
     return value;
 }

package/dist/edf/scale.d.ts

@@ -37,7 +37,7 @@ export declare function quantizationStep(signal: EdfSignal): number;
  * resolution the hardware actually recorded, without padding the file with digits
  * that carry no information.
  *
- * The ceiling is 15 rather than a tidier number because a channel calibrated in
+ * The ceiling is 20 rather than a tidier number because a channel calibrated in
  * volts rather than microvolts has a step near 1e-7, and one in tesla smaller
  * still. A lower cap would round genuinely different samples to the same text. It
  * costs nothing for ordinary channels, whose step lands them at three or four.

package/dist/edf/scale.js

@@ -67,12 +67,12 @@ export function quantizationStep(signal) {
  * resolution the hardware actually recorded, without padding the file with digits
  * that carry no information.
  *
- * The ceiling is 15 rather than a tidier number because a channel calibrated in
+ * The ceiling is 20 rather than a tidier number because a channel calibrated in
  * volts rather than microvolts has a step near 1e-7, and one in tesla smaller
  * still. A lower cap would round genuinely different samples to the same text. It
  * costs nothing for ordinary channels, whose step lands them at three or four.
  */
-export function decimalsForSignal(signal, max = 15) {
+export function decimalsForSignal(signal, max = 20) {
     const step = quantizationStep(signal);
     if (!(step > 0) || !Number.isFinite(step))
         return 3;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "edf2csv",
-  "version": "0.2.12",
+  "version": "0.2.13",
   "description": "Convert EDF, EDF+ and BDF biosignal recordings (European Data Format) to CSV from the command line. Local, streaming, and never resamples or alters units.",
   "keywords": [
     "edf",