edfcore 0.6.26 → 0.6.27
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/constants.d.ts +1 -1
- package/dist/constants.js +1 -1
- package/dist/header/lookup.d.ts.map +1 -1
- package/dist/header/lookup.js +46 -5
- package/dist/header/lookup.js.map +1 -1
- package/docs/CHANGELOG.md +21 -0
- package/package.json +1 -1
- package/src/constants.ts +1 -1
- package/src/header/lookup.ts +50 -5
package/dist/constants.d.ts
CHANGED
|
@@ -109,5 +109,5 @@ export declare const SIGNAL_FIELD_BLOCK_OFFSETS: {
|
|
|
109
109
|
readonly reserved: 224;
|
|
110
110
|
};
|
|
111
111
|
/** Published package version. Kept in sync with package.json by a test. */
|
|
112
|
-
export declare const VERSION = "0.6.
|
|
112
|
+
export declare const VERSION = "0.6.27";
|
|
113
113
|
//# sourceMappingURL=constants.d.ts.map
|
package/dist/constants.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"lookup.d.ts","sourceRoot":"","sources":["../../src/header/lookup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGxD;AAED,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,SAAS,EAAE,CAGlF;
|
|
1
|
+
{"version":3,"file":"lookup.d.ts","sourceRoot":"","sources":["../../src/header/lookup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGxD;AAED,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,SAAS,EAAE,CAGlF;AA6CD;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAsCjF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAQpE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,GAC3C,SAAS,SAAS,EAAE,CAKtB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAEjE"}
|
package/dist/header/lookup.js
CHANGED
|
@@ -30,8 +30,43 @@ export function findSignals(header, label) {
|
|
|
30
30
|
const wanted = trimEdfField(label);
|
|
31
31
|
return Object.freeze(header.signals.filter((signal) => signal.label === wanted));
|
|
32
32
|
}
|
|
33
|
-
|
|
34
|
-
|
|
33
|
+
/**
|
|
34
|
+
* Enough labels to recognise the file, few enough to read in a terminal.
|
|
35
|
+
*
|
|
36
|
+
* Every other listing this package prints is capped — 24 bytes of hex, 16 bytes of field evidence,
|
|
37
|
+
* twenty diagnostics — and this one was not, in the one message whose length grows with the file.
|
|
38
|
+
* A mistyped label on a 512-signal recording put five thousand characters on one line behind
|
|
39
|
+
* `edfcore: `, and `inspect.ts` names a 512-signal file as the realistic one. The full list is
|
|
40
|
+
* still on the error, as `availableLabels`, for a program that wants it.
|
|
41
|
+
*/
|
|
42
|
+
const LABELS_SHOWN = 12;
|
|
43
|
+
/** The whole label list, capped, saying how many it withheld — never silently truncated. */
|
|
44
|
+
function quoteLabels(header, first) {
|
|
45
|
+
const labels = header.signals.map((signal) => signal.label);
|
|
46
|
+
const ordered = first === undefined ? labels : [first, ...labels.filter((label) => label !== first)];
|
|
47
|
+
const shown = ordered.slice(0, LABELS_SHOWN).map((label) => JSON.stringify(label));
|
|
48
|
+
const hidden = ordered.length - shown.length;
|
|
49
|
+
return hidden > 0 ? `${shown.join(', ')}, and ${hidden} more` : shown.join(', ');
|
|
50
|
+
}
|
|
51
|
+
/**
|
|
52
|
+
* `String.prototype.toLowerCase`, not `toLocaleLowerCase`: the second one folds `'I'` to a dotless
|
|
53
|
+
* `'ı'` under a Turkish locale, and this package's output is deterministic and locale-free.
|
|
54
|
+
*/
|
|
55
|
+
const foldCase = (text) => trimEdfField(text).toLowerCase().replace(/\s+/g, ' ');
|
|
56
|
+
/**
|
|
57
|
+
* The label that differs from the selector only in case or in internal spacing, if there is one.
|
|
58
|
+
*
|
|
59
|
+
* The module note above says why matching is exact and case-sensitive: `'Fp1'` and `'FP1'` are
|
|
60
|
+
* written by different systems and edfcore has no montage vocabulary to decide they are the same
|
|
61
|
+
* electrode. That is a decision about MATCHING, not a reason to make the reader work out what
|
|
62
|
+
* happened — the message said "is case-sensitive" while holding the label that proves it is what
|
|
63
|
+
* bit them.
|
|
64
|
+
*
|
|
65
|
+
* Naming it changes nothing about which signal is returned. It is still refused.
|
|
66
|
+
*/
|
|
67
|
+
function differsOnlyInCase(header, selector) {
|
|
68
|
+
const wanted = foldCase(selector);
|
|
69
|
+
return header.signals.find((signal) => foldCase(signal.label) === wanted)?.label;
|
|
35
70
|
}
|
|
36
71
|
/**
|
|
37
72
|
* One signal, by index or by label.
|
|
@@ -53,9 +88,15 @@ export function getSignal(header, selector) {
|
|
|
53
88
|
const matches = findSignals(header, selector);
|
|
54
89
|
const first = matches[0];
|
|
55
90
|
if (first === undefined) {
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
91
|
+
const near = differsOnlyInCase(header, selector);
|
|
92
|
+
throw new EdfChannelNotFoundError(`no signal is labelled ${JSON.stringify(trimEdfField(selector))} in this file. ` +
|
|
93
|
+
(near === undefined
|
|
94
|
+
? ''
|
|
95
|
+
: `This file has ${JSON.stringify(near)}, which differs only in case or spacing. `) +
|
|
96
|
+
`Labels, in signal order: ${quoteLabels(header, near)}. Matching is exact on the ` +
|
|
97
|
+
'trimmed label and is case-sensitive. Next: pass ' +
|
|
98
|
+
(near === undefined ? 'one of those labels' : `${JSON.stringify(near)}`) +
|
|
99
|
+
', or select by index.', { selector, availableLabels: header.signals.map((signal) => signal.label) });
|
|
59
100
|
}
|
|
60
101
|
if (matches.length === 1)
|
|
61
102
|
return first;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"lookup.js","sourceRoot":"","sources":["../../src/header/lookup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC/E,OAAO,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGjD;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACpC,OAAO,OAAO,KAAK,qBAAqB,IAAI,OAAO,KAAK,qBAAqB,CAAC;AAChF,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,WAAW,CAAC,MAAiB,EAAE,KAAa;IAC1D,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACnC,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC;AACnF,CAAC;AAED,SAAS,WAAW,CAAC,MAAiB;
|
|
1
|
+
{"version":3,"file":"lookup.js","sourceRoot":"","sources":["../../src/header/lookup.ts"],"names":[],"mappings":"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"}
|
package/docs/CHANGELOG.md
CHANGED
|
@@ -6,6 +6,27 @@ alone does not tell you whether you were affected.
|
|
|
6
6
|
edfcore is pre-1.0. Patch releases have carried behaviour changes where the old behaviour was a
|
|
7
7
|
defect; those are called out below.
|
|
8
8
|
|
|
9
|
+
## 0.6.27
|
|
10
|
+
|
|
11
|
+
- **Changed** the "no signal is labelled" refusal to name the label that differs only in case or
|
|
12
|
+
spacing. `lookup.ts` explains why matching is exact and case-sensitive — `'Fp1'` and `'FP1'` are
|
|
13
|
+
written by different systems and edfcore has no montage vocabulary to decide they are the same
|
|
14
|
+
electrode — and the message said "matching is exact on the trimmed label and is case-sensitive"
|
|
15
|
+
while holding the label that proves that is what went wrong, and printing it somewhere in a list
|
|
16
|
+
of every other label for the reader to spot.
|
|
17
|
+
- That decision is about which signal comes back, and it is unchanged: `getSignal(header, 'FP1')`
|
|
18
|
+
on a file with `'Fp1'` still throws. It was never a reason to make the reader do the comparison.
|
|
19
|
+
The near miss is named, put first in the list, and repeated in the `Next:` clause.
|
|
20
|
+
- **Changed** the list of labels to be capped at twelve, saying how many it withheld. Every other
|
|
21
|
+
listing this package prints is capped — 24 bytes of hex, 16 of field evidence, twenty
|
|
22
|
+
diagnostics, `--limit` events — and this was the one that was not, in the one message whose
|
|
23
|
+
length grows with the file. A mistyped label on a 512-signal recording put five thousand
|
|
24
|
+
characters on one line behind `edfcore: `, and `inspect.ts` names a 512-signal file as the
|
|
25
|
+
realistic one.
|
|
26
|
+
- `availableLabels` on the error still carries every label, so nothing a program reads was capped.
|
|
27
|
+
Case is folded with `toLowerCase` rather than `toLocaleLowerCase`, which would fold `'I'` to a
|
|
28
|
+
dotless `'ı'` under a Turkish locale and make this message depend on where it ran.
|
|
29
|
+
|
|
9
30
|
## 0.6.26
|
|
10
31
|
|
|
11
32
|
- **Changed** `NOT_AN_EDF_FILE` to say which archive it was handed, when the first bytes say so.
|
package/package.json
CHANGED
package/src/constants.ts
CHANGED
package/src/header/lookup.ts
CHANGED
|
@@ -35,8 +35,47 @@ export function findSignals(header: EdfHeader, label: string): readonly EdfSigna
|
|
|
35
35
|
return Object.freeze(header.signals.filter((signal) => signal.label === wanted));
|
|
36
36
|
}
|
|
37
37
|
|
|
38
|
-
|
|
39
|
-
|
|
38
|
+
/**
|
|
39
|
+
* Enough labels to recognise the file, few enough to read in a terminal.
|
|
40
|
+
*
|
|
41
|
+
* Every other listing this package prints is capped — 24 bytes of hex, 16 bytes of field evidence,
|
|
42
|
+
* twenty diagnostics — and this one was not, in the one message whose length grows with the file.
|
|
43
|
+
* A mistyped label on a 512-signal recording put five thousand characters on one line behind
|
|
44
|
+
* `edfcore: `, and `inspect.ts` names a 512-signal file as the realistic one. The full list is
|
|
45
|
+
* still on the error, as `availableLabels`, for a program that wants it.
|
|
46
|
+
*/
|
|
47
|
+
const LABELS_SHOWN = 12;
|
|
48
|
+
|
|
49
|
+
/** The whole label list, capped, saying how many it withheld — never silently truncated. */
|
|
50
|
+
function quoteLabels(header: EdfHeader, first?: string): string {
|
|
51
|
+
const labels = header.signals.map((signal) => signal.label);
|
|
52
|
+
const ordered =
|
|
53
|
+
first === undefined ? labels : [first, ...labels.filter((label) => label !== first)];
|
|
54
|
+
const shown = ordered.slice(0, LABELS_SHOWN).map((label) => JSON.stringify(label));
|
|
55
|
+
const hidden = ordered.length - shown.length;
|
|
56
|
+
return hidden > 0 ? `${shown.join(', ')}, and ${hidden} more` : shown.join(', ');
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
/**
|
|
60
|
+
* `String.prototype.toLowerCase`, not `toLocaleLowerCase`: the second one folds `'I'` to a dotless
|
|
61
|
+
* `'ı'` under a Turkish locale, and this package's output is deterministic and locale-free.
|
|
62
|
+
*/
|
|
63
|
+
const foldCase = (text: string): string => trimEdfField(text).toLowerCase().replace(/\s+/g, ' ');
|
|
64
|
+
|
|
65
|
+
/**
|
|
66
|
+
* The label that differs from the selector only in case or in internal spacing, if there is one.
|
|
67
|
+
*
|
|
68
|
+
* The module note above says why matching is exact and case-sensitive: `'Fp1'` and `'FP1'` are
|
|
69
|
+
* written by different systems and edfcore has no montage vocabulary to decide they are the same
|
|
70
|
+
* electrode. That is a decision about MATCHING, not a reason to make the reader work out what
|
|
71
|
+
* happened — the message said "is case-sensitive" while holding the label that proves it is what
|
|
72
|
+
* bit them.
|
|
73
|
+
*
|
|
74
|
+
* Naming it changes nothing about which signal is returned. It is still refused.
|
|
75
|
+
*/
|
|
76
|
+
function differsOnlyInCase(header: EdfHeader, selector: string): string | undefined {
|
|
77
|
+
const wanted = foldCase(selector);
|
|
78
|
+
return header.signals.find((signal) => foldCase(signal.label) === wanted)?.label;
|
|
40
79
|
}
|
|
41
80
|
|
|
42
81
|
/**
|
|
@@ -62,10 +101,16 @@ export function getSignal(header: EdfHeader, selector: number | string): EdfSign
|
|
|
62
101
|
const matches = findSignals(header, selector);
|
|
63
102
|
const first = matches[0];
|
|
64
103
|
if (first === undefined) {
|
|
104
|
+
const near = differsOnlyInCase(header, selector);
|
|
65
105
|
throw new EdfChannelNotFoundError(
|
|
66
|
-
`no signal is labelled ${JSON.stringify(trimEdfField(selector))} in this file.
|
|
67
|
-
|
|
68
|
-
|
|
106
|
+
`no signal is labelled ${JSON.stringify(trimEdfField(selector))} in this file. ` +
|
|
107
|
+
(near === undefined
|
|
108
|
+
? ''
|
|
109
|
+
: `This file has ${JSON.stringify(near)}, which differs only in case or spacing. `) +
|
|
110
|
+
`Labels, in signal order: ${quoteLabels(header, near)}. Matching is exact on the ` +
|
|
111
|
+
'trimmed label and is case-sensitive. Next: pass ' +
|
|
112
|
+
(near === undefined ? 'one of those labels' : `${JSON.stringify(near)}`) +
|
|
113
|
+
', or select by index.',
|
|
69
114
|
{ selector, availableLabels: header.signals.map((signal) => signal.label) },
|
|
70
115
|
);
|
|
71
116
|
}
|