DOCS: temporal alignment docs improvements

[leshy]

https://github.com/dimensionalOS/dimos/blob/ivan-docs-5/docs/api/sensor_streams/temporal_alignment.md

[chatgpt-codex-connector]

Codex usage limits have been reached for code reviews. Please check with the admins of this repo to increase the limits by adding credits.
Credits must be used to enable repository wide code reviews.

[greptile-apps]

Greptile Summary

Replaced abstract toy examples with real sensor data demonstrations using Unitree Go2 robot recordings. The documentation now shows practical temporal alignment with actual video/lidar streams, including three progressively sophisticated scenarios with visual timeline plots.

• Replaced Subject() toy examples with TimedSensorReplay using real robot data
• Added three visualization examples showing alignment behavior at different tolerances (25ms, 50ms) and with quality filtering
• Added nested <details> tag for Pikchr diagram sources
• Removed sections on "Multiple Secondary Streams", "With Backpressure", and "Edge Cases" (may want to restore these in a follow-up)
• Added three PNG timeline visualizations generated by matplotlib helper function

Confidence Score: 4/5

• This documentation PR is safe to merge with minor comment fixes needed
• Documentation improvements are solid and demonstrate real-world usage, but contains three typos/inconsistencies in comments that should be corrected for accuracy
• Fix comment typos in docs/api/sensor_streams/temporal_alignment.md before merging

Important Files Changed

Filename	Overview
docs/api/sensor_streams/temporal_alignment.md	Replaced toy examples with real sensor data from Unitree Go2 robot, added visualization timeline plots

Sequence Diagram

sequenceDiagram
    participant User as Documentation Reader
    participant Doc as temporal_alignment.md
    participant Replay as TimedSensorReplay
    participant Video as video_stream
    participant Lidar as lidar_stream
    participant Align as align_timestamped
    participant Plot as plot_alignment_timeline

    User->>Doc: Read Basic Usage section
    Doc->>Replay: Load unitree_go2_bigoffice data
    Replay->>Video: Create video stream (30fps)
    Replay->>Lidar: Create lidar stream (10Hz)
    
    Note over Video,Lidar: Streams emit at different rates
    
    Video->>Align: Emit video frames
    Lidar->>Align: Emit lidar scans
    Align->>Align: Match within tolerance (25ms)
    Align-->>Doc: Return 11/29 aligned pairs
    
    Doc->>Plot: Generate timeline visualization
    Plot-->>User: Display alignment_timeline.png
    
    Note over User,Doc: Example 2: Looser tolerance
    
    Video->>Align: Same video frames
    Lidar->>Align: Same lidar scans
    Align->>Align: Match within 50ms tolerance
    Align-->>Doc: Return 23/58 aligned pairs
    
    Doc->>Plot: Generate timeline visualization
    Plot-->>User: Display alignment_timeline2.png
    
    Note over User,Doc: Example 3: With quality filter
    
    Video->>Video: Apply sharpness_barrier(3.0)
    Video->>Align: Emit 6 quality-filtered frames
    Lidar->>Align: Emit lidar scans
    Align->>Align: Match within 25ms tolerance
    Align-->>Doc: Return 1/6 aligned pairs
    
    Doc->>Plot: Generate timeline visualization
    Plot-->>User: Display alignment_timeline3.png

Loading

[greptile-apps]

_{1 file reviewed, 3 comments}

_{Edit Code Review Agent Settings | Greptile}