qat.experimental.system_data.materialisers.purr.validators.couplings module

Coupling and CR/CRC validation rules for PuRR ingress payloads.

This module validates both coupling-list integrity and cross-resonance channel consistency. In particular it covers the following responsibilities:

  1. Coupling directions must reference known qubit indices.

  2. Missing coupling quality values are surfaced as warnings.

  3. Every CR channel mapping must have a corresponding CRC counterpart.

  4. Every declared coupling edge must have both CR and CRC channel mappings.

Additional checks enforce consistency between CR/CRC key names, nested channel identifiers, and optional auxiliary-target metadata.