[eye-diagram-basic] Signal Integrity Eye Diagram

[MarkusNeusinger]

Description

An eye diagram created by overlaying many periods of a digital signal on a single time window (1-2 UI). The resulting pattern reveals signal quality: a wide-open "eye" indicates good signal integrity, while a closed eye indicates jitter, noise, or ISI.

Key Visual Elements

• Overlaid signal traces forming eye-shaped opening
• Time axis spanning 1-2 unit intervals (UI)
• Amplitude axis showing voltage levels
• Eye opening height and width annotated
• Mask/template overlay for compliance testing (optional)
• Color intensity showing trace density

Applications

• Telecommunications: characterizing high-speed serial links
• PCB design: validating signal integrity
• Fiber optics: assessing optical signal quality
• Semiconductor testing: SerDes validation

Domain

Telecommunications / Signal Processing

[claude]

✅ Spec ID: eye-diagram-basic

Rationale: Uses eye-diagram as the plot type (a well-established visualization in telecommunications/signal processing) with basic variant, covering the standard overlaid-signal eye pattern with density coloring.

No duplicates or similar specs found in the existing catalog. This is a valuable addition for the engineering/telecommunications domain.

Add label approved to begin generation.

[github-actions]

✅ Specification Ready: eye-diagram-basic

PR: #4591

---

specification.md

eye-diagram-basic: Signal Integrity Eye Diagram

Description

An eye diagram visualizes signal integrity by overlaying many periods of a digital signal onto a single time window spanning 1-2 unit intervals (UI). The overlapping traces form a characteristic eye-shaped opening whose height, width, and clarity reveal signal quality metrics such as jitter, noise, and inter-symbol interference (ISI). A wide-open eye indicates clean signal transmission, while a closed or blurred eye signals degradation.

Applications

• Telecommunications engineering: characterizing high-speed serial links (PCIe, USB, HDMI) for compliance testing
• PCB design: validating signal integrity across traces, connectors, and backplanes
• Semiconductor testing: evaluating SerDes transmitter and receiver performance
• Fiber optics: assessing optical signal quality and link budget margins

Data

• time (float) - Time within one unit interval, normalized to [0, 2] UI
• voltage (float) - Signal amplitude in volts at each time sample
• trace_id (int) - Identifier for each overlaid signal period (used to draw individual traces)
• Size: 200-500 overlaid traces, each with 100-200 samples per UI
• Example: Simulated NRZ (Non-Return-to-Zero) signal with random bit sequences, additive Gaussian noise, and random jitter applied to transition times

Notes

• Use color intensity (density heatmap coloring) to show where traces overlap most frequently, with hot colors indicating high trace density
• Time axis should be labeled in unit intervals (UI), not absolute time
• Voltage axis should show signal levels (e.g., 0 and 1 for NRZ)
• Generate synthetic data by simulating a random bit stream with controlled noise (sigma ~5% of amplitude) and jitter (sigma ~3% of UI)
• Smooth transitions between bit levels using a raised-cosine or sigmoid filter to simulate realistic bandwidth-limited signals
• Optionally annotate eye height and eye width measurements on the diagram

---

Next: Add approved label to merge this specification to main.

---

🤖 spec-create workflow

[github-actions]

🚀 Specification Merged!

Specification: eye-diagram-basic
PR: #4591 (merged)

The specification is now in main and synced to PostgreSQL.

---

Next: Add generate:{library} labels to start generating implementations.

Available libraries: matplotlib, seaborn, plotly, bokeh, altair, plotnine, pygal, highcharts, letsplot

Or use workflow dispatch for bulk operations.

---

🤖 spec-create workflow