chore(pointcloud_metainfo): add pointcloud metainfo class

[SamratThapa120]

This pull requests updates the PointCloud dataclass to accept a metainfo field with the following structure (example):

{
    "stamp": {
        "sec": 1753168580,
        "nanosec": 47682048
    },
    "sources": [
        {
            "stamp": {
                "sec": 1753168580,
                "nanosec": 48760832
            },
            "idx_begin": 112575,
            "length": 23322,
            "source_id": "REAR_UPPER"
        },
        {
            "stamp": {
                "sec": 1753168580,
                "nanosec": 47682048
            },
            "idx_begin": 100753,
            "length": 11822,
            "source_id": "REAR_LOWER"
        },

In addition, it adds validators to check if the sources cover the entire point cloud and provides helper functions to get the list of source ids.

[github-actions]

☂️ Python Coverage

current status: ❌

Overall Coverage

Lines	Covered	Coverage	Threshold	Status
3957	3255	82%	50%	🟢

New Files

No new covered files...

Modified Files

File	Coverage	Status
t4_devkit/dataclass/pointcloud.py	40%	🔴
TOTAL	40%	🔴

updated for commit: 219b857 by action🐍

[Copilot]

Pull Request Overview

This pull request adds metadata support to the point cloud data handling system. The main changes introduce three new dataclasses (Stamp, PointcloudSourceInfo, and PointCloudMetainfo) to represent structured metadata about point cloud sources, timestamps, and coverage intervals, along with validation logic to ensure metadata consistency.

Key Changes:

• Added metadata dataclasses with JSON loading capabilities for representing timestamps and source information
• Implemented validation to ensure source intervals are contiguous, non-overlapping, and cover all points
• Updated all point cloud classes to accept optional metadata via a new metainfo_filepath parameter in their from_file methods

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[ktro2828]

@SamratThapa120 Thank you for your PR! Your updates seem good to me. I left some minor comments, please check them out!

[ktro2828]

@SamratThapa120 I also opened PR to bump the version to v0.5.0. Let me know if you want to include this PR as well, I will release the new version after merging this PR. #229

[ktro2828]

LGTM

[amadeuszsz]

Thank you, LGTM!