mirror of
https://github.com/bilawalsidhu/gods-eye-view.git
synced 2026-11-16 08:12:24 +00:00
Adds MIC-7522-Z30B, MIC-7502-Z30B and MIC-7130-PB4 (MIC IP starlight 7000 HD) from the CCTV Camera Database v2.29.0 model-enrichment extract. Colour siblings (B/G/W) share one datasheet, so they and the register's x wildcard (MIC-7522-Z30x) are aliases of one record. The MIC datasheets state FOV without an axis, so these records add specs but no horizontal FOV range. Refreshes the dataset size in the module header and DATA_SOURCES.md.
330 lines
13 KiB
JavaScript
330 lines
13 KiB
JavaScript
// src/layers/cctv/modelSpecs.test.mjs
|
||
// Hardware-model spec enrichment: lookup semantics (case-insensitive, alias
|
||
// matching, unknown → null — never a guess), datasheet-FOV parsing across the
|
||
// real fov_deg string shapes, and the HUD spec-summary line.
|
||
import { test } from 'node:test';
|
||
import assert from 'node:assert/strict';
|
||
import {
|
||
lookupModelSpec,
|
||
horizontalFovRangeDeg,
|
||
fixedHorizontalFovDeg,
|
||
specFovCapabilityToken,
|
||
isDatasheetFov,
|
||
specSummary,
|
||
} from './modelSpecs.js';
|
||
import { createCatalog } from './catalog.js';
|
||
|
||
test('lookupModelSpec matches case-insensitively and trims', () => {
|
||
const spec = lookupModelSpec(' q6135-le ');
|
||
assert.ok(spec);
|
||
assert.equal(spec.brand, 'Axis');
|
||
assert.equal(lookupModelSpec('Q6135-LE'), spec);
|
||
});
|
||
|
||
test('lookupModelSpec matches aliases', () => {
|
||
// A part number without letters needs the brand.
|
||
const byAlias = lookupModelSpec('01959-004', 'Axis');
|
||
assert.ok(byAlias);
|
||
assert.equal(byAlias.model, 'Q6135-LE');
|
||
});
|
||
|
||
test('vendored table covers the integrated catalogs published hardware', () => {
|
||
// Models the live packs publish: King County (Cohu, AUTODOME IP 5000i),
|
||
// Sarasota (Bosch AUTODOME 7000/VG4), Sioux Falls (Axis).
|
||
// King County publishes "3950" with Manufacturer "Cohu".
|
||
const cohu = lookupModelSpec('3950', 'Cohu');
|
||
assert.equal(cohu?.brand, 'Cohu');
|
||
const autodome = lookupModelSpec('AUTODOME IP 5000i');
|
||
assert.ok(autodome && horizontalFovRangeDeg(autodome).maxDeg > 0);
|
||
const vg4 = lookupModelSpec('VG4 AUTODOME H.264'); // Sarasota's string
|
||
assert.ok(vg4);
|
||
const axis = lookupModelSpec('Q6155-E'); // Sioux Falls
|
||
assert.deepEqual(horizontalFovRangeDeg(axis), { minDeg: 2.36, maxDeg: 66.7 });
|
||
});
|
||
|
||
test('verbose registry strings resolve via distinctive-token fallback', () => {
|
||
// Sioux Falls publishes the full product title, not the bare model.
|
||
assert.equal(
|
||
lookupModelSpec('AXIS Q6155-E PTZ Dome Network Camera')?.model,
|
||
'Q6155-E',
|
||
);
|
||
assert.equal(lookupModelSpec('AXIS Q6000-E Mk II')?.model, 'Q6000-E Mk II');
|
||
assert.equal(
|
||
lookupModelSpec('AUTODOME IP starlight 7000i camera')?.id,
|
||
'bosch-ndp-7512-z30',
|
||
);
|
||
// Punctuation around the model token doesn't defeat the match.
|
||
assert.equal(
|
||
lookupModelSpec('camera (P3707-PE), outdoor')?.model,
|
||
'P3707-PE',
|
||
);
|
||
});
|
||
|
||
test('token fallback never matches on generic words or wrong models', () => {
|
||
// Only generic descriptors — no distinctive hardware token — stays null.
|
||
assert.equal(lookupModelSpec('PTZ Dome Camera'), null);
|
||
assert.equal(lookupModelSpec('HD Network Camera'), null);
|
||
assert.equal(lookupModelSpec('Outdoor Dome Camera'), null);
|
||
// A real-looking but unknown model resolves to nothing, not a near neighbour.
|
||
assert.equal(lookupModelSpec('AXIS FooBar-9 Network Camera'), null);
|
||
// A generation token alone must not collide with a similar one: "7000"
|
||
// belongs to two records (dynamic / starlight 7000 HD), so a bare
|
||
// "AUTODOME 7000" is ambiguous → null rather than an arbitrary pick.
|
||
assert.equal(lookupModelSpec('AUTODOME 7000'), null);
|
||
});
|
||
|
||
test('exact match still wins over the token fallback', () => {
|
||
// "3965" is an alias of the 3960, not the 3950.
|
||
assert.equal(lookupModelSpec('3965', 'Cohu')?.id, 'cohu-3960');
|
||
assert.equal(lookupModelSpec('AUTODOME IP 5000i')?.id, 'bosch-ndp-5502-30');
|
||
});
|
||
|
||
test('lookupModelSpec returns null for unknown or empty input — never guesses', () => {
|
||
assert.equal(lookupModelSpec('NOT-A-REAL-MODEL'), null);
|
||
assert.equal(lookupModelSpec(''), null);
|
||
assert.equal(lookupModelSpec(null), null);
|
||
assert.equal(lookupModelSpec(undefined), null);
|
||
});
|
||
|
||
test('horizontalFovRangeDeg reads the full range across real fov_deg shapes', () => {
|
||
const range = (model) => horizontalFovRangeDeg(lookupModelSpec(model));
|
||
// PTZ zoom: both ends, not just the wide one.
|
||
assert.deepEqual(range('Q6135-LE'), { minDeg: 2.4, maxDeg: 58.3 });
|
||
// Vertical figures never count.
|
||
assert.deepEqual(range('XNP-6400RW'), { minDeg: 1.88, maxDeg: 65.66 });
|
||
// Lens options: parenthesized focal lengths are not FOV figures.
|
||
assert.deepEqual(range('DS-2CD2087G3-LI2UY'), {
|
||
minDeg: 93.3,
|
||
maxDeg: 108.8,
|
||
});
|
||
assert.deepEqual(range('F4105-LRE'), { minDeg: 110, maxDeg: 110 });
|
||
// The "360 combined" panoramic figure is not a horizontal lens FOV.
|
||
assert.deepEqual(range('Q6000-E Mk II'), { minDeg: 113, maxDeg: 152 });
|
||
assert.deepEqual(range('P3707-PE'), { minDeg: 54, maxDeg: 108 });
|
||
});
|
||
|
||
test('horizontalFovRangeDeg returns null when no numeric FOV is stated', () => {
|
||
assert.equal(horizontalFovRangeDeg({ fov_deg: '' }), null);
|
||
assert.equal(horizontalFovRangeDeg({ fov_deg: 'wide dynamic range' }), null);
|
||
assert.equal(horizontalFovRangeDeg({ fov_deg: '60 vertical' }), null);
|
||
assert.equal(horizontalFovRangeDeg({}), null);
|
||
assert.equal(horizontalFovRangeDeg(null), null);
|
||
});
|
||
|
||
test('fixedHorizontalFovDeg is the current FOV only for fixed single-lens hardware', () => {
|
||
// Fixed dome, one horizontal figure: the datasheet IS the optical state.
|
||
assert.equal(fixedHorizontalFovDeg(lookupModelSpec('F4105-LRE')), 110);
|
||
// Known hardware capability != known pose state: PTZ, multi-sensor, and a
|
||
// model sold in several lens options all stay estimated.
|
||
for (const model of [
|
||
'Q6135-LE',
|
||
'XNP-6400RW',
|
||
'AUTODOME IP 5000i',
|
||
'P3707-PE',
|
||
'Q6000-E Mk II',
|
||
'DS-2CD2087G3-LI2UY',
|
||
]) {
|
||
assert.equal(fixedHorizontalFovDeg(lookupModelSpec(model)), null, model);
|
||
}
|
||
assert.equal(fixedHorizontalFovDeg(null), null);
|
||
});
|
||
|
||
test('specFovCapabilityToken labels a datasheet range as capability, never as current FOV', () => {
|
||
assert.equal(
|
||
specFovCapabilityToken({ specFovMinDeg: 2.4, specFovMaxDeg: 58.3 }),
|
||
'SPEC FOV 2.4–58° (CAPABILITY)',
|
||
);
|
||
assert.equal(
|
||
specFovCapabilityToken({ specFovMinDeg: 113, specFovMaxDeg: 113 }),
|
||
'SPEC FOV 113° (CAPABILITY)',
|
||
);
|
||
// Already the camera's FOV (fixed lens) or nothing known: no token.
|
||
assert.equal(
|
||
specFovCapabilityToken({
|
||
fovSource: 'datasheet',
|
||
specFovMinDeg: 110,
|
||
specFovMaxDeg: 110,
|
||
}),
|
||
null,
|
||
);
|
||
assert.equal(specFovCapabilityToken({}), null);
|
||
assert.equal(specFovCapabilityToken(null), null);
|
||
});
|
||
|
||
/** Browser catalog with the pose math stubbed: only enrichment is under test. */
|
||
function browserCatalog() {
|
||
const model = {
|
||
safeNumber: (value, fallback = NaN) =>
|
||
Number.isFinite(Number(value)) ? Number(value) : fallback,
|
||
normalizeHeading: (deg) => ((deg % 360) + 360) % 360,
|
||
clamp: (value, lo, hi) => Math.min(hi, Math.max(lo, value)),
|
||
headingFromId: () => 0,
|
||
normalizeFeedType: (type) => type,
|
||
ensureCameraPose: () => {},
|
||
};
|
||
return createCatalog({
|
||
state: {},
|
||
services: { locations: { CITY_POIS: {} } },
|
||
parts: { model },
|
||
source: {},
|
||
});
|
||
}
|
||
|
||
test('catalog keeps the estimated FOV for PTZ hardware and fills only fixed-lens datasheets', () => {
|
||
const [ptz, fixed, unknown] = browserCatalog().buildCatalogFromSources([
|
||
{ id: 'ptz', lat: 47.7, lon: -122, fovDeg: 44, model: 'Q6135-LE' },
|
||
{ id: 'fixed', lat: 47.7, lon: -122, model: 'F4105-LRE' },
|
||
{ id: 'unknown', lat: 47.7, lon: -122, fovDeg: 44, model: 'NOPE-1' },
|
||
]);
|
||
|
||
// PTZ: the frustum keeps its estimate; the datasheet range is metadata.
|
||
assert.equal(ptz.fovDeg, 44);
|
||
assert.equal(ptz.fovSource, undefined);
|
||
assert.equal(ptz.specFovMinDeg, 2.4);
|
||
assert.equal(ptz.specFovMaxDeg, 58.3);
|
||
assert.equal(ptz.spec.model, 'Q6135-LE');
|
||
|
||
// Fixed lens: the datasheet figure is the optical state.
|
||
assert.equal(fixed.fovDeg, 110);
|
||
assert.equal(fixed.fovSource, 'datasheet');
|
||
|
||
// Unknown hardware changes nothing.
|
||
assert.equal(unknown.fovDeg, 44);
|
||
assert.equal(unknown.spec, undefined);
|
||
assert.equal(unknown.specFovMaxDeg, undefined);
|
||
});
|
||
|
||
test('codec, format and product words never identify hardware', () => {
|
||
// "h.264" is in the VG4 AUTODOME alias; it is a codec, not a model code.
|
||
assert.equal(lookupModelSpec('Axis Q1615 H.264 Network Camera'), null);
|
||
assert.equal(lookupModelSpec('H.264 Network Camera'), null);
|
||
assert.equal(lookupModelSpec('H.265 IP Camera'), null);
|
||
});
|
||
|
||
test('generation and suffix distinctions are preserved', () => {
|
||
// A Mk II is not the vendored (Mk I) Q6135-LE.
|
||
assert.equal(lookupModelSpec('AXIS Q6135-LE Mk II'), null);
|
||
// A longer part number is a different product...
|
||
assert.equal(lookupModelSpec('F4105-LRE-UNKNOWN'), null);
|
||
// ...unless the rest is a mains-frequency variant suffix.
|
||
assert.equal(lookupModelSpec('Q6155-E-60Hz')?.id, 'axis-q6155-e');
|
||
});
|
||
|
||
test('manufacturer must agree with the record brand', () => {
|
||
// Purely numeric models need a brand match.
|
||
assert.equal(lookupModelSpec('3950'), null);
|
||
assert.equal(lookupModelSpec('Pelco 3950'), null);
|
||
assert.equal(lookupModelSpec('3950', 'Pelco'), null);
|
||
// A model code under the wrong manufacturer is not that record either.
|
||
assert.equal(lookupModelSpec('Q6135-LE', 'Hikvision'), null);
|
||
// Case-insensitive, with company suffixes and aliases.
|
||
assert.equal(lookupModelSpec('3950', 'COHU')?.id, 'cohu-3950-iview');
|
||
assert.equal(
|
||
lookupModelSpec('Q6135-LE', 'Axis Communications AB')?.id,
|
||
'axis-q6135-le',
|
||
);
|
||
assert.equal(
|
||
lookupModelSpec('XNP-6400RW', 'Hanwha Vision')?.id,
|
||
'hanwha-xnp-6400rw',
|
||
);
|
||
assert.equal(
|
||
lookupModelSpec('XNP-6400RW', 'Wisenet')?.id,
|
||
'hanwha-xnp-6400rw',
|
||
);
|
||
});
|
||
|
||
test('King County snapshot model strings still resolve', () => {
|
||
// Model/Manufacturer pairs as published in the King County feed.
|
||
assert.equal(lookupModelSpec('3950', 'Cohu')?.id, 'cohu-3950-iview');
|
||
assert.equal(lookupModelSpec('3965', 'Cohu')?.id, 'cohu-3960');
|
||
assert.equal(lookupModelSpec('3925 Dome', 'Cohu')?.id, 'cohu-3920-idome');
|
||
assert.equal(lookupModelSpec('Q6135-LE', 'Axis')?.id, 'axis-q6135-le');
|
||
assert.equal(
|
||
lookupModelSpec('AUTODOME IP 5000i', 'BOSCH')?.id,
|
||
'bosch-ndp-5502-30',
|
||
);
|
||
});
|
||
|
||
test('Amsterdam camera register model strings resolve', () => {
|
||
// The register writes the Bosch MIC colour letter as `x`.
|
||
assert.equal(
|
||
lookupModelSpec('Bosch MIC-7522-Z30x')?.id,
|
||
'bosch-mic-7522-z30b',
|
||
);
|
||
assert.equal(
|
||
lookupModelSpec('Bosch MIC-7502-Z30x')?.id,
|
||
'bosch-mic-7502-z30b',
|
||
);
|
||
assert.equal(lookupModelSpec('Bosch MIC-7130-Px4')?.id, 'bosch-mic-7130-pb4');
|
||
assert.equal(lookupModelSpec('MIC-7522-Z30W')?.id, 'bosch-mic-7522-z30b');
|
||
// Its ANPR units are not in the table: unknown, never a guess.
|
||
assert.equal(lookupModelSpec('CSG-8800'), null);
|
||
// The MIC and AUTODOME starlight 7000 HD (code-less names, so the brand
|
||
// is needed) stay apart.
|
||
assert.equal(
|
||
lookupModelSpec('MIC IP starlight 7000 HD', 'Bosch')?.id,
|
||
'bosch-mic-7130-pb4',
|
||
);
|
||
assert.equal(
|
||
lookupModelSpec('AUTODOME IP starlight 7000 HD', 'Bosch')?.id,
|
||
'bosch-autodome-ip-starlight-7000-hd',
|
||
);
|
||
// The MIC datasheets state FOV without an axis, so no horizontal range.
|
||
assert.equal(horizontalFovRangeDeg(lookupModelSpec('MIC-7522-Z30B')), null);
|
||
});
|
||
|
||
test('catalog never overwrites an explicit FOV or a curated pose', () => {
|
||
const [explicit, curated, cohu, pelco] =
|
||
browserCatalog().buildCatalogFromSources([
|
||
{ id: 'explicit', lat: 47.7, lon: -122, fovDeg: 44, model: 'F4105-LRE' },
|
||
{
|
||
id: 'curated',
|
||
lat: 47.7,
|
||
lon: -122,
|
||
model: 'F4105-LRE',
|
||
poseSource: 'curated',
|
||
},
|
||
{ id: 'cohu', lat: 47.7, lon: -122, model: '3950', manufacturer: 'Cohu' },
|
||
{
|
||
id: 'pelco',
|
||
lat: 47.7,
|
||
lon: -122,
|
||
model: '3950',
|
||
manufacturer: 'Pelco',
|
||
},
|
||
]);
|
||
assert.equal(explicit.fovDeg, 44);
|
||
assert.equal(explicit.fovSource, undefined);
|
||
assert.equal(explicit.spec.model, 'F4105-LRE');
|
||
assert.equal(curated.fovDeg, 74);
|
||
assert.equal(curated.fovSource, undefined);
|
||
// The source's manufacturer reaches the lookup.
|
||
assert.equal(cohu.spec?.id, 'cohu-3950-iview');
|
||
assert.equal(pelco.spec, undefined);
|
||
});
|
||
|
||
test('the DATASHEET label drops once calibration moves the FOV', () => {
|
||
const camera = { fovSource: 'datasheet', fovDeg: 110 };
|
||
assert.equal(isDatasheetFov(camera), true);
|
||
assert.equal(isDatasheetFov({ ...camera, calibration: { fovDeg: 0 } }), true);
|
||
assert.equal(
|
||
isDatasheetFov({ ...camera, calibration: { fovDeg: 6 } }),
|
||
false,
|
||
);
|
||
assert.equal(isDatasheetFov({ fovDeg: 74 }), false);
|
||
assert.equal(isDatasheetFov(null), false);
|
||
});
|
||
|
||
test('specSummary renders the HUD line and degrades by omission', () => {
|
||
assert.equal(
|
||
specSummary(lookupModelSpec('Q6135-LE')),
|
||
'Axis Q6135-LE · 1080p · IR 250m · PTZ',
|
||
);
|
||
// No night vision / no PTZ → those segments are simply absent.
|
||
assert.equal(
|
||
specSummary({ brand: 'Axis', model: 'X', resolution: { label: '4K' } }),
|
||
'Axis X · 4K',
|
||
);
|
||
assert.equal(specSummary(null), '');
|
||
});
|