linked-rolls 0.67.0 → 0.68.0

package/lib/analysis/text.d.ts

@@ -10,6 +10,11 @@ export declare const placedCarriersOf: (edition: Pick<Edition, 'copies'>, symbol
  * Where along the roll the symbol lies, as its carriers put it, or
  * nothing for a symbol no copy carries.
  *
+ * Either end is the median of the carriers' rather than their mean, so
+ * that a copy which puts the symbol well away from the rest, torn,
+ * stretched or badly aligned there, does not draw it away from where
+ * the others agree it lies. Two carriers have the two alike.
+ *
  * Only the place is measured. Which track the symbol sits on is not
  * a measurement but a question for a tracker bar, since a note of
  * one pitch sits on exactly one position of a given bar: ask
@@ -20,7 +25,7 @@ export declare const placedCarriersOf: (edition: Pick<Edition, 'copies'>, symbol
  * position a semitone away on either bar.
  */
 export declare const placeOf: (edition: Pick<Edition, 'copies'>, symbol: AnySymbol) => Readonly<HorizontalSpan> | undefined;
-/** Where the symbol begins, as the mean onset of its carriers, or nothing for a symbol without a place. */
+/** Where the symbol begins, as the median onset of its carriers, or nothing for a symbol without a place. */
 export declare const onsetOf: (edition: Pick<Edition, 'copies'>, symbol: AnySymbol) => Millimeters | undefined;
 /**
  * The symbols the version shows: what it and its ancestors insert,

package/lib/analysis/text.js

@@ -1,7 +1,7 @@
 import { isPlaced } from "../model/Feature.js";
 import { deletedBy, insertedBy } from "../model/Version.js";
 import { idsOf } from "../model/Assumption.js";
-import { mean } from "../model/Quantity.js";
+import { medianOf } from "../collation/statistics.js";
 import { featuresIn } from "../lookup/lookup.js";
 import { perState } from "../lookup/perState.js";
 import { lineageOf } from "./stemma.js";
@@ -12,6 +12,11 @@ export const placedCarriersOf = (edition, symbol) => carriersOf(edition, symbol)
  * Where along the roll the symbol lies, as its carriers put it, or
  * nothing for a symbol no copy carries.
  *
+ * Either end is the median of the carriers' rather than their mean, so
+ * that a copy which puts the symbol well away from the rest, torn,
+ * stretched or badly aligned there, does not draw it away from where
+ * the others agree it lies. Two carriers have the two alike.
+ *
  * Only the place is measured. Which track the symbol sits on is not
  * a measurement but a question for a tracker bar, since a note of
  * one pitch sits on exactly one position of a given bar: ask
@@ -23,15 +28,13 @@ export const placedCarriersOf = (edition, symbol) => carriersOf(edition, symbol)
  */
 export const placeOf = (edition, symbol) => {
     const carriers = placedCarriersOf(edition, symbol);
-    if (carriers.length === 0)
+    const from = medianOf(carriers.map(carrier => carrier.horizontal.from));
+    const to = medianOf(carriers.map(carrier => carrier.horizontal.to));
+    if (from === undefined || to === undefined)
         return;
-    return {
-        unit: 'mm',
-        from: mean(carriers.map(carrier => carrier.horizontal.from)),
-        to: mean(carriers.map(carrier => carrier.horizontal.to))
-    };
+    return { unit: 'mm', from, to };
 };
-/** Where the symbol begins, as the mean onset of its carriers, or nothing for a symbol without a place. */
+/** Where the symbol begins, as the median onset of its carriers, or nothing for a symbol without a place. */
 export const onsetOf = (edition, symbol) => placeOf(edition, symbol)?.from;
 /** The symbols by onset, those without a place first; symbols at one place keep their order. */
 const inOrderOfPlace = (edition, symbols) => symbols

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "linked-rolls",
-  "version": "0.67.0",
+  "version": "0.68.0",
   "description": "Digital editions of piano rolls: import, collation, editorial assumptions, JSON-LD export, and emulation through a reproducing system",
   "license": "MIT",
   "repository": {