38 lines
1.9 KiB
JavaScript
38 lines
1.9 KiB
JavaScript
|
// © 2026 TechnoLibre (http://www.technolibre.ca)
|
|||
|
|
// License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl)
|
|||
|
|
|
|||
|
|
// Les statistiques du temps par image (§ 19.10) : une liste d'intervalles
|
|||
|
|
// entre images, en millisecondes, rend son nombre, sa médiane, son p95 et
|
|||
|
|
// son maximum. Module pur, sans import : il se charge sous node comme dans la
|
|||
|
|
// page du banc, où mesurerImages (navigateur.js) relève les intervalles.
|
|||
|
|
//
|
|||
|
|
// Le p95 est celui du rang le plus proche : l'intervalle de rang ⌈0,95 n⌉
|
|||
|
|
// dans la liste croissante, un intervalle mesuré et non une interpolation
|
|||
|
|
// entre deux.
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* @param {number[]} intervallesMs au moins un ; chacun un nombre fini ≥ 0
|
|||
|
|
* @returns {{images: number, medianeMs: number, p95Ms: number, maxMs: number}}
|
|||
|
|
* images : le nombre d'intervalles, une image chacun ; medianeMs : celui du
|
|||
|
|
* milieu de la liste triée, ou la moyenne des deux du milieu pour une
|
|||
|
|
* longueur paire. La liste reçue n'est pas modifiée.
|
|||
|
|
* @throws {TypeError} sur autre chose qu'une liste
|
|||
|
|
* @throws {RangeError} sur une liste vide, ou un intervalle qui n'est pas un
|
|||
|
|
* nombre fini positif ou nul, nommé
|
|||
|
|
*/
|
|||
|
|
export function statistiques(intervallesMs) {
|
|||
|
|
if (!Array.isArray(intervallesMs)) throw new TypeError('statistiques : une liste d’intervalles est attendue');
|
|||
|
|
if (intervallesMs.length === 0) throw new RangeError('statistiques : aucun intervalle');
|
|||
|
|
for (const valeur of intervallesMs) {
|
|||
|
|
if (typeof valeur !== 'number' || !Number.isFinite(valeur) || valeur < 0) {
|
|||
|
|
throw new RangeError(`statistiques : intervalle refusé, ${String(valeur)}`);
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
const triees = [...intervallesMs].sort((a, b) => a - b);
|
|||
|
|
const n = triees.length;
|
|||
|
|
const milieu = Math.floor(n / 2);
|
|||
|
|
const medianeMs = n % 2 === 1 ? triees[milieu] : (triees[milieu - 1] + triees[milieu]) / 2;
|
|||
|
|
const rang95 = Math.ceil((95 * n) / 100);
|
|||
|
|
return { images: n, medianeMs, p95Ms: triees[rang95 - 1], maxMs: triees[n - 1] };
|
|||
|
|
}
|