Skip to content

v0.9.0 — OFEC bit for bit, and a block's own spectrum in the studio

Choose a tag to compare

@ehsun-sh ehsun-sh released this 19 Sep 02:23
· 122 commits to main since this release

pip install maiman==0.9.0

Two things 0.8.0 did not have: the FEC that coherent pluggables actually run, and a way to look inside a single photonic block. Both are opt-in, so no result from an earlier release moves.

OFEC, bit for bit

maiman.ofec implements the Open ROADM MSA 6.0 W-Port encoder from the normative text. It has four encoders, each a semi-infinite staircase of 16 × 16 blocks, in which every bit is the front of one extended BCH(256, 239) codeword and the back of another twenty block-rows later. After them come the intra-block permutation of Table 8 and the inter-block interleaver.

It is checked against the specification's own test vectors, and no bit differs:

  • the encoders turn TP2 into TP5;
  • the interleavers turn TP5 into TP6.

That covers 2,752,512 bits for DP-QPSK and 5,505,024 for DP-16QAM. The text leaves two things open: which encoder each bit of a codec block feeds, and whether TP6 is merged from the two interleavers. Only one reading of each reproduces the vectors, and that is the one implemented.

The vectors come with no licence to redistribute, so they are not in the repository:

  • setting MAIMAN_OFEC_VECTORS to where they unzip runs them;
  • without them, a fingerprint of the output, taken while it matched, keeps it from drifting.

The specification leaves decoding open, so the decoder is this project's own. It is soft-in soft-out Chase on each bit's two codewords:

  • at 1 % raw BER the output is clean;
  • at the specification's 2.0e-2 threshold, three passes of Chase-4 leave one bit in eighty wrong;
  • six passes of Chase-6 leave 17 in 1e5.

The gap to the threshold is the decoder's, not the code's, and the documentation says so.

This release also corrects what the project said about OFEC: it belongs to Open ROADM, G.709.6, OpenZR+ and 800ZR, not to OIF 400ZR, which uses another code.

A block's own spectrum in the studio

Select a grating, a ring, a coupler or any other photonic block. Its properties now offer Show its S-matrix spectrum. The new S-matrix tab plots every entry of the block's scattering matrix across a wavelength window, as power, phase or group delay, with no link run through it.

  • Each device opens on the window worth looking at, such as a grating's line or four free spectral ranges of a ring, and the window can be moved.
  • POST /api/spectrum builds the block from the same node a run would, then calls ScatteringDevice.spectrum(). A script can make the same call.
  • Group delay is a local derivative, not a differenced unwrap of the sampled phase. The unwrap turned a straight waveguide's 14 ps into −1 ps once the grid was coarser than the delay.
  • Where an entry is 40 dB below its own peak, its phase means nothing. The delay is left undefined there, and the plot shows a gap instead of a spike.

A 10 mm Bragg grating reads 48 ps away from its line, which is one transit, and 72 ps at its band edge.


64 components, 1714 tests, every physics block checked against a closed-form or independently computed result in CI.

🤖 Generated with Claude Code