x4d-devkit 0.44.0rc1__tar.gz → 0.45.0__tar.gz

{x4d_devkit-0.44.0rc1/x4d_devkit.egg-info → x4d_devkit-0.45.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: x4d-devkit
-Version: 0.44.0rc1
+Version: 0.45.0
 Summary: Official X-4D external SDK and CLI for datasets, platform APIs, training bridges, and automation
 Author: windzu
 License-Expression: Apache-2.0
@@ -97,18 +97,18 @@ platform-to-platform data flow. See
 generic identity model, and
 [docs/training-current-state-data.md](docs/training-current-state-data.md) for
 work-session materialization and conditional annotation writeback. Every
-Dataset 0.17 Clip carries its authoritative Label Schema snapshot at root
+Dataset 0.18 Clip carries its authoritative Label Schema snapshot at root
 `label_schema.json`.
 Shared validation rules for platform submit, X-Points preflight, local clip
 validation, and training consumers are documented in
 [docs/shared-contract-validation.md](docs/shared-contract-validation.md).
-The Dataset 0.17 native contract, exact nanosecond time, Multi-LiDAR layout,
+The Dataset 0.18 native contract, exact nanosecond time, Multi-LiDAR layout,
 and model materialization are documented in
-[docs/dataset-0.17.md](docs/dataset-0.17.md). The single-file annotation
+[docs/dataset-0.18.md](docs/dataset-0.18.md). The single-file annotation
 authority, semantic revision, and
 derived track views are documented in
 [docs/annotation-contract.md](docs/annotation-contract.md).
-Portable export producers and consumers share the exact `0.17` manifest
+Portable export producers and consumers share the exact `0.18` manifest
 parser documented in
 [docs/export-bundle-contract.md](docs/export-bundle-contract.md).
 `examples/current_state_identity_consumers.py` provides an offline downstream
@@ -133,7 +133,7 @@ Included:
 - Typed point-level semantic-scene authoring sessions, dirty semantic-chunk upload, and
   complete compare-and-set submit without a per-point mutation API.
 - Strict validation of `x4d-training-identity-v5` manifests.
-- Strict producer-option and manifest parsing for export bundle `0.17`.
+- Strict producer-option and manifest parsing for export bundle `0.18`.
 - Clip preannotation protocol, source-only inference adapter, and service
   wrapper for algorithm projects.
 
@@ -247,7 +247,7 @@ comparison = compare_project_label_schema_snapshots(project_schema, current)
 assert comparison.status == "same"
 ```
 
-The native Dataset 0.17 Clip stores the immutable identity in
+The native Dataset 0.18 Clip stores the immutable identity in
 `meta.label_schema` and the complete authoritative snapshot in root
 `label_schema.json`. Registry records are used when creating/binding Clips, not
 when loading or validating their current contents.
@@ -402,7 +402,7 @@ asset existence and point-cloud layout checks without downloading the assets.
 
 Third-party model projects should use `x4d-devkit[inference]` instead of
 hand-writing the X-4D preannotation protocol. The pipeline receives an
-annotation-isolated `InferenceClip` and returns one complete Dataset 0.17
+annotation-isolated `InferenceClip` and returns one complete Dataset 0.18
 annotation document.
 
 ```python

{x4d_devkit-0.44.0rc1 → x4d_devkit-0.45.0}/README.md

@@ -54,18 +54,18 @@ platform-to-platform data flow. See
 generic identity model, and
 [docs/training-current-state-data.md](docs/training-current-state-data.md) for
 work-session materialization and conditional annotation writeback. Every
-Dataset 0.17 Clip carries its authoritative Label Schema snapshot at root
+Dataset 0.18 Clip carries its authoritative Label Schema snapshot at root
 `label_schema.json`.
 Shared validation rules for platform submit, X-Points preflight, local clip
 validation, and training consumers are documented in
 [docs/shared-contract-validation.md](docs/shared-contract-validation.md).
-The Dataset 0.17 native contract, exact nanosecond time, Multi-LiDAR layout,
+The Dataset 0.18 native contract, exact nanosecond time, Multi-LiDAR layout,
 and model materialization are documented in
-[docs/dataset-0.17.md](docs/dataset-0.17.md). The single-file annotation
+[docs/dataset-0.18.md](docs/dataset-0.18.md). The single-file annotation
 authority, semantic revision, and
 derived track views are documented in
 [docs/annotation-contract.md](docs/annotation-contract.md).
-Portable export producers and consumers share the exact `0.17` manifest
+Portable export producers and consumers share the exact `0.18` manifest
 parser documented in
 [docs/export-bundle-contract.md](docs/export-bundle-contract.md).
 `examples/current_state_identity_consumers.py` provides an offline downstream
@@ -90,7 +90,7 @@ Included:
 - Typed point-level semantic-scene authoring sessions, dirty semantic-chunk upload, and
   complete compare-and-set submit without a per-point mutation API.
 - Strict validation of `x4d-training-identity-v5` manifests.
-- Strict producer-option and manifest parsing for export bundle `0.17`.
+- Strict producer-option and manifest parsing for export bundle `0.18`.
 - Clip preannotation protocol, source-only inference adapter, and service
   wrapper for algorithm projects.
 
@@ -204,7 +204,7 @@ comparison = compare_project_label_schema_snapshots(project_schema, current)
 assert comparison.status == "same"
 ```
 
-The native Dataset 0.17 Clip stores the immutable identity in
+The native Dataset 0.18 Clip stores the immutable identity in
 `meta.label_schema` and the complete authoritative snapshot in root
 `label_schema.json`. Registry records are used when creating/binding Clips, not
 when loading or validating their current contents.
@@ -359,7 +359,7 @@ asset existence and point-cloud layout checks without downloading the assets.
 
 Third-party model projects should use `x4d-devkit[inference]` instead of
 hand-writing the X-4D preannotation protocol. The pipeline receives an
-annotation-isolated `InferenceClip` and returns one complete Dataset 0.17
+annotation-isolated `InferenceClip` and returns one complete Dataset 0.18
 annotation document.
 
 ```python

{x4d_devkit-0.44.0rc1 → x4d_devkit-0.45.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "x4d-devkit"
-version = "0.44.0rc1"
+version = "0.45.0"
 description = "Official X-4D external SDK and CLI for datasets, platform APIs, training bridges, and automation"
 readme = "README.md"
 license = "Apache-2.0"

{x4d_devkit-0.44.0rc1 → x4d_devkit-0.45.0}/tests/test_contract_validation.py

@@ -24,9 +24,8 @@ def _time(value: int) -> dict[str, int]:
 def _meta(*, keyframe_count: int = 1) -> dict:
     return {
         "clip_id": "clip-a",
-        "schema_version": "0.17",
+        "schema_version": "0.18",
         "session_id": "session-a",
-        "vehicle_id": "vehicle-a",
         "capture_time": _time(1),
         "duration_s": float(max(0, keyframe_count - 1)),
         "keyframe_count": keyframe_count,
@@ -152,7 +151,7 @@ def _context(
 ) -> ClipValidationContext:
     return ClipValidationContext(
         clip_id="clip-a",
-        clip_schema_version="0.17",
+        clip_schema_version="0.18",
         label_schema=_schema(),
         samples=[_sample()] if samples is None else samples,
         sample_data=[_sample_data()] if sample_data is None else sample_data,
@@ -423,7 +422,7 @@ def test_context_rejects_non_list_payloads_and_invalid_meta():
     with pytest.raises(TypeError):
         ClipValidationContext(
             clip_id="clip-a",
-            clip_schema_version="0.17",
+            clip_schema_version="0.18",
             label_schema=_schema(),
             samples=(),
             sample_data=[],

{x4d_devkit-0.44.0rc1 → x4d_devkit-0.45.0}/tests/test_current_state.py

@@ -34,7 +34,7 @@ def _identity(**overrides):
         "vector_map_revision": None,
         "label_schema": schema_identity(),
         "business_metadata_revision": "business-metadata",
-        "clip_schema_version": "0.17",
+        "clip_schema_version": "0.18",
         "ready": True,
         "blockers": [],
     }
@@ -233,5 +233,5 @@ def test_normalize_clip_identity_rejects_removed_source_granularity(field):
 
 
 def test_normalize_clip_identity_rejects_non_current_clip_schema_version():
-    with pytest.raises(ValueError, match="clip_schema_version must be '0.17'"):
+    with pytest.raises(ValueError, match="clip_schema_version must be '0.18'"):
         normalize_clip_identity(_identity(clip_schema_version="0.10"))

{x4d_devkit-0.44.0rc1 → x4d_devkit-0.45.0}/tests/test_dataset_identity.py

@@ -49,7 +49,7 @@ def _identity(clip_id: str = "clip-a", **overrides):
         "vector_map_revision": None,
         "label_schema": schema_identity(),
         "business_metadata_revision": "sha256:business-metadata",
-        "clip_schema_version": "0.17",
+        "clip_schema_version": "0.18",
         "ready": True,
         "blockers": [],
     }

{x4d_devkit-0.44.0rc1 → x4d_devkit-0.45.0}/tests/test_export_bundle.py

@@ -20,7 +20,7 @@ def _manifest(*, include_sweeps: bool = True) -> dict:
     return {
         "export_id": "exp_20260711_a3f8c1d2",
         "exported_at": {"sec": 1_783_735_200, "nanosec": 123_456_000},
-        "schema_version": "0.17",
+        "schema_version": "0.18",
         "options": {
             "include_sweeps": include_sweeps,
             "pointcloud_format": "pcd_binary",
@@ -31,7 +31,7 @@ def _manifest(*, include_sweeps: bool = True) -> dict:
         "clips": [
             {
                 "clip_id": "20260711_G150-002_003",
-                "schema_version": "0.17",
+                "schema_version": "0.18",
                 "label_schema": schema_identity(),
                 "annotation_frame_id": "base_link",
                 "channels": ["cam_front", "lidar"],

{x4d_devkit-0.44.0rc1 → x4d_devkit-0.45.0}/tests/test_inference_input.py

@@ -30,7 +30,7 @@ def _inference_clip(tmp_path) -> tuple[ClipLoader, InferenceClip]:
         sweeps_revision=_digest("b"),
         calibration_revision="calibration-1",
         pose_revision="pose-1",
-        clip_schema_version="0.17",
+        clip_schema_version="0.18",
     )
     access = PreannotationClipAccess(
         project_id=7,
@@ -174,7 +174,7 @@ def test_inference_clip_rejects_a_mismatched_source_identity(tmp_path):
         sweeps_revision=clip.source_identity.sweeps_revision,
         calibration_revision=clip.source_identity.calibration_revision,
         pose_revision=clip.source_identity.pose_revision,
-        clip_schema_version="0.17",
+        clip_schema_version="0.18",
     )
 
     with pytest.raises(ValueError, match="source identity"):

{x4d_devkit-0.44.0rc1 → x4d_devkit-0.45.0}/tests/test_inference_schemas.py

@@ -37,7 +37,7 @@ def _request_payload() -> dict:
                 "sweeps_revision": _digest("f"),
                 "calibration_revision": "calibration-1",
                 "pose_revision": "pose-1",
-                "clip_schema_version": "0.17",
+                "clip_schema_version": "0.18",
             },
             "label_schema": schema_identity(),
             "base_annotation_revision": _digest("a"),
@@ -108,7 +108,7 @@ def test_source_identity_projects_only_pure_inference_dependencies():
             "semantic_scene_revision": _digest("d"),
             "vector_map_revision": None,
             "label_schema": schema_identity(),
-            "clip_schema_version": "0.17",
+            "clip_schema_version": "0.18",
             "ready": True,
             "blockers": [],
         }
@@ -120,7 +120,7 @@ def test_source_identity_projects_only_pure_inference_dependencies():
         "sweeps_revision": _digest("f"),
         "calibration_revision": "calibration-1",
         "pose_revision": "pose-1",
-        "clip_schema_version": "0.17",
+        "clip_schema_version": "0.18",
     }
 
 

{x4d_devkit-0.44.0rc1 → x4d_devkit-0.45.0}/tests/test_inference_service.py

@@ -83,7 +83,7 @@ def _fixture(tmp_path, pipeline=None, *, run_inline=True):
         sweeps_revision=_digest("e"),
         calibration_revision="calibration-1",
         pose_revision="pose-1",
-        clip_schema_version="0.17",
+        clip_schema_version="0.18",
     )
     selected = pipeline or FakePipeline()
 

{x4d_devkit-0.44.0rc1 → x4d_devkit-0.45.0}/tests/test_label_schemas.py

@@ -285,7 +285,7 @@ def test_batch_resolution_deduplicates_by_task_free_binding():
                 "vector_map_revision": None,
             "business_metadata_revision": "business-a",
             "label_schema": identity,
-            "clip_schema_version": "0.17",
+            "clip_schema_version": "0.18",
             "ready": True,
             "blockers": [],
         },
@@ -302,7 +302,7 @@ def test_batch_resolution_deduplicates_by_task_free_binding():
                 "vector_map_revision": None,
             "business_metadata_revision": "business-b",
             "label_schema": identity,
-            "clip_schema_version": "0.17",
+            "clip_schema_version": "0.18",
             "ready": True,
             "blockers": [],
         },

{x4d_devkit-0.44.0rc1 → x4d_devkit-0.45.0}/tests/test_loader.py

@@ -28,7 +28,7 @@ def loader(tmp_path):
 
 def test_loader_builds_current_typed_models_and_indexes(loader):
     assert isinstance(loader.meta, ClipMeta)
-    assert loader.schema_version == "0.17"
+    assert loader.schema_version == "0.18"
     assert loader.annotation_revision.startswith("sha256:")
     assert all(isinstance(item, Sample) for item in loader.samples)
     assert all(isinstance(item, Annotation) for item in loader.annotations)

{x4d_devkit-0.44.0rc1 → x4d_devkit-0.45.0}/tests/test_models.py

@@ -82,9 +82,8 @@ def test_clip_meta_serializes_exact_current_metadata():
     sensors = {"cam_front": SensorInfo("camera", "cam_front")}
     meta = ClipMeta(
         clip_id="clip-a",
-        schema_version="0.17",
+        schema_version="0.18",
         session_id="session-a",
-        vehicle_id="vehicle-a",
         capture_time=TimeNs(1, 2),
         duration_s=1.0,
         num_keyframes=1,
@@ -96,7 +95,7 @@ def test_clip_meta_serializes_exact_current_metadata():
         scene_tags=["urban"],
     )
     wire = meta.to_dict()
-    assert wire["schema_version"] == "0.17"
+    assert wire["schema_version"] == "0.18"
     assert wire["capture_time"] == {"sec": 1, "nanosec": 2}
     assert wire["scene_tags"] == ["urban"]
     assert "route_tag" not in wire

{x4d_devkit-0.44.0rc1 → x4d_devkit-0.45.0}/tests/test_preannotation_client.py

@@ -117,7 +117,7 @@ def _portable_candidate() -> dict:
             "sweeps_revision": _digest("f"),
             "calibration_revision": "calibration-1",
             "pose_revision": "pose-1",
-            "clip_schema_version": "0.17",
+            "clip_schema_version": "0.18",
         },
         "label_schema": schema_identity(),
         "base_annotation_revision": _digest("0"),

{x4d_devkit-0.44.0rc1 → x4d_devkit-0.45.0}/tests/test_sdk_api.py

@@ -11,14 +11,14 @@ from x4d_devkit.eval.matching import MetricData
 
 
 def test_package_version_is_current_release():
-    assert x4d_devkit.__version__ == "0.44.0rc1"
+    assert x4d_devkit.__version__ == "0.45.0"
 
 
 def test_loader_exposes_and_enforces_only_current_schema(tmp_path):
     loader = ClipLoader(write_current_clip(tmp_path / "current"))
-    assert loader.schema_version == "0.17"
-    loader.require_schema_version("0.17")
-    loader.require_schema_version({"0.17"})
+    assert loader.schema_version == "0.18"
+    loader.require_schema_version("0.18")
+    loader.require_schema_version({"0.18"})
     with pytest.raises(SchemaVersionMismatch):
         loader.require_schema_version("0.10")
     with pytest.raises(SchemaVersionMismatch):

x4d_devkit-0.45.0/tests/test_source_attributes.py

@@ -0,0 +1,54 @@
+"""Vehicle-free metadata and the independent business-metadata boundary."""
+
+import copy
+
+import pytest
+
+from tests.current_clip_fixtures import current_clip_tables, write_current_clip
+from x4d_devkit.core.loader import ClipLoader
+from x4d_devkit.dataset_contract import (
+    DatasetContractError,
+    parse_clip_meta,
+    project_business_metadata,
+    project_source_metadata,
+)
+
+
+def test_vehicle_free_clip_loads_and_roundtrips(tmp_path):
+    tables = current_clip_tables()
+    clip_dir = write_current_clip(tmp_path / "test-clip")
+    clip = ClipLoader(clip_dir)
+    assert clip.meta.source_attributes is None
+    assert clip.meta.to_dict() == tables["meta.json"]
+
+
+def test_source_attributes_change_only_business_metadata():
+    meta = current_clip_tables()["meta.json"]
+    candidate = copy.deepcopy(meta)
+    candidate["source_attributes"] = {"vehicle_id": "V01", "vehicle_model": "车型 A"}
+    parsed = parse_clip_meta(candidate, include_label_schema=True)
+    assert parsed == candidate
+    assert project_source_metadata(meta) == project_source_metadata(candidate)
+    assert project_business_metadata(meta) == {}
+    assert project_business_metadata(candidate) == {
+        "source_attributes": candidate["source_attributes"]
+    }
+
+
+@pytest.mark.parametrize("attributes", [{}, [], {"a": None}, {"a": 1}, {"a": " x"}, {"a": ""}, {"Bad key": "x"}])
+def test_source_attributes_reject_inexact_values(attributes):
+    meta = current_clip_tables()["meta.json"]
+    meta["source_attributes"] = attributes
+    with pytest.raises(DatasetContractError):
+        parse_clip_meta(meta, include_label_schema=True)
+
+
+def test_previous_vehicle_field_and_dataset_version_are_rejected():
+    meta = current_clip_tables()["meta.json"]
+    meta["vehicle_id"] = "V01"
+    with pytest.raises(DatasetContractError):
+        parse_clip_meta(meta, include_label_schema=True)
+    del meta["vehicle_id"]
+    meta["schema_version"] = "0.17"
+    with pytest.raises(DatasetContractError):
+        parse_clip_meta(meta, include_label_schema=True)

{x4d_devkit-0.44.0rc1 → x4d_devkit-0.45.0}/tests/test_training_identity.py

@@ -38,7 +38,7 @@ def _clip(**overrides):
         "annotation_revision": "ann",
         "semantic_scene_revision": None,
         "label_schema": schema_identity(),
-        "clip_schema_version": "0.17",
+        "clip_schema_version": "0.18",
         "materialization_policy": "keyframes_only",
     }
     data.update(overrides)
@@ -133,7 +133,7 @@ def test_training_identity_file_rejects_duplicate_json_fields(tmp_path):
 
 
 def test_training_identity_rejects_non_current_clip_schema_version():
-    with pytest.raises(ValueError, match="clip_schema_version must be '0.17'"):
+    with pytest.raises(ValueError, match="clip_schema_version must be '0.18'"):
         build_training_identity_manifest(
             projects=_projects(),
             clips=[_clip(clip_schema_version="0.10")]
@@ -251,7 +251,7 @@ def test_project_training_identities_are_dataset_diff_ready(tmp_path):
         "annotation_revision": "ann",
         "semantic_scene_revision": None,
         "label_schema": schema_identity(),
-        "clip_schema_version": "0.17",
+        "clip_schema_version": "0.18",
     }]
 
 

{x4d_devkit-0.44.0rc1 → x4d_devkit-0.45.0}/tests/test_work_session.py

@@ -51,9 +51,8 @@ def _manifest() -> dict:
         "label_schema": clip_schema_snapshot(),
         "meta": {
             "clip_id": "clip-a",
-            "schema_version": "0.17",
+            "schema_version": "0.18",
             "session_id": "session-a",
-            "vehicle_id": "vehicle-a",
             "capture_time": {"sec": 0, "nanosec": 1000},
             "duration_s": 0.0,
             "keyframe_count": 1,
@@ -327,7 +326,7 @@ class _FakeX4DClient:
 
 def test_work_session_wire_has_one_meta_source_for_version_and_frames():
     manifest = parse_clip_work_session(_manifest())
-    assert manifest.clip_schema_version == "0.17"
+    assert manifest.clip_schema_version == "0.18"
     assert manifest.annotation_frame_id == "base_link"
     assert manifest.ego_pose_frame_id == "base_link"
     assert manifest.instances == [
@@ -372,7 +371,7 @@ def test_loader_from_work_session_supports_current_transforms_and_assets():
         parse_clip_work_session(_manifest()),
         api_url="http://x4d.local",
     )
-    assert loader.schema_version == "0.17"
+    assert loader.schema_version == "0.18"
     assert loader.annotation_frame_id == "base_link"
     assert loader.frame_id_for_channel("lidar") == "base_link"
     assert loader.point_format("lidar").bytes_per_point == 24
@@ -634,7 +633,7 @@ def test_adopt_work_session_cache_fails_closed_without_changing_markers(
     else:
         meta_path = tmp_path / "meta.json"
         meta = json.loads(meta_path.read_text())
-        meta["vehicle_id"] = "different"
+        meta["source_attributes"] = {"vehicle_id": "different"}
         meta_path.write_text(json.dumps(meta))
 
     with pytest.raises(ValueError, match="cache adoption"):

{x4d_devkit-0.44.0rc1 → x4d_devkit-0.45.0}/x4d_devkit/annotation_contract.py

@@ -1,4 +1,4 @@
-"""Strict Dataset 0.17 annotation document and derived track views."""
+"""Strict Dataset 0.18 annotation document and derived track views."""
 
 from __future__ import annotations
 
@@ -115,7 +115,7 @@ def build_clip_annotations(
     annotation_frame_id: str,
     annotations: list[Mapping[str, Any]],
 ) -> ClipAnnotationDocument:
-    """Build the only canonical Dataset 0.17 annotation document."""
+    """Build the only canonical Dataset 0.18 annotation document."""
 
     canonical = _canonical_annotation_rows(annotations)
     parsed_clip_id = _portable_token(clip_id, path="annotation.clip_id")

{x4d_devkit-0.44.0rc1 → x4d_devkit-0.45.0}/x4d_devkit/cli.py

@@ -242,7 +242,7 @@ def cmd_screening_plan(args):
     for clip in result["valid_clips"]:
         print(
             f"  bags={clip['bag_ids']} duration={clip['duration_s']:.1f}s "
-            f"vehicle={clip['vehicle_id']}"
+            f"session={clip['session_id']}"
         )
     for flagged in result["flagged"]:
         print(f"  flagged bag={flagged['bag_id']} reason={flagged['reason']}")

{x4d_devkit-0.44.0rc1 → x4d_devkit-0.45.0}/x4d_devkit/core/loader.py

@@ -342,7 +342,6 @@ class ClipLoader:
             clip_id=d["clip_id"],
             schema_version=d["schema_version"],
             session_id=d["session_id"],
-            vehicle_id=d["vehicle_id"],
             capture_time=TimeNs.from_dict(d["capture_time"]),
             duration_s=d["duration_s"],
             num_keyframes=d["keyframe_count"],
@@ -351,6 +350,7 @@ class ClipLoader:
             annotation_frame_id=d["annotation_frame_id"],
             ego_pose_frame_id=d["ego_pose_frame_id"],
             label_schema=dict(d["label_schema"]),
+            source_attributes=d.get("source_attributes"),
             route_tag=d.get("route_tag"),
             weather=d.get("weather"),
             time_of_day=d.get("time_of_day"),
@@ -493,7 +493,7 @@ class ClipLoader:
 
     @property
     def has_semantic_scene(self) -> bool:
-        """Whether this local Dataset 0.17 Clip contains a semantic scene."""
+        """Whether this local Dataset 0.18 Clip contains a semantic scene."""
 
         return (self._clip_dir / "semantic_scene" / "manifest.json").is_file()
 
@@ -550,7 +550,7 @@ class ClipLoader:
         Example::
 
             loader = ClipLoader(path)
-            loader.require_schema_version("0.17")  # raises if not 0.17
+            loader.require_schema_version("0.18")  # raises if not 0.18
         """
         actual = self._meta.schema_version
         if isinstance(expected, str):
@@ -798,14 +798,14 @@ class ClipLoader:
     ) -> np.ndarray:
         """Reject the removed homogeneous point-cloud representation.
 
-        Dataset 0.17 mixes ``float32`` spatial fields with an absolute
+        Dataset 0.18 mixes ``float32`` spatial fields with an absolute
         ``uint64 timestamp_ns``. A homogeneous NumPy matrix cannot preserve
         both contracts. Use :meth:`load_point_records` for native data or the
         explicit model materialization API for derived ``float32 xyzit``.
         """
 
         raise ValueError(
-            "load_point_cloud() is unavailable for Dataset 0.17 because a "
+            "load_point_cloud() is unavailable for Dataset 0.18 because a "
             "homogeneous array loses uint64 timestamp_ns precision; use "
             "load_point_records() or transform_concat_v1()"
         )

{x4d_devkit-0.44.0rc1 → x4d_devkit-0.45.0}/x4d_devkit/core/models.py

@@ -120,7 +120,7 @@ class PointFormat:
 
 @dataclass(frozen=True)
 class PointTime:
-    """Exact Dataset 0.17 per-point time semantics."""
+    """Exact Dataset 0.18 per-point time semantics."""
 
     field: str
     representation: str
@@ -136,7 +136,7 @@ class PointTime:
             "epoch": "unix",
             "timescale": "posix",
         }:
-            raise ValueError("PointTime must match the Dataset 0.17 contract")
+            raise ValueError("PointTime must match the Dataset 0.18 contract")
 
     @classmethod
     def from_dict(cls, value: dict[str, Any]) -> PointTime:
@@ -195,7 +195,7 @@ class SensorInfo:
             or self.point_format.bytes_per_point != CANONICAL_POINT_BYTES
         ):
             raise ValueError(
-                "point-cloud SensorInfo requires canonical Dataset 0.17 layout"
+                "point-cloud SensorInfo requires canonical Dataset 0.18 layout"
             )
         if not isinstance(self.point_time, PointTime):
             raise TypeError("point-cloud SensorInfo requires PointTime")
@@ -241,7 +241,7 @@ class ClipMeta:
         clip_id: Unique clip identifier (e.g. "20180724_n015_scene-0061_000").
         schema_version: X4D format version (e.g. "0.5").
         session_id: Recording session identifier.
-        vehicle_id: Vehicle identifier.
+        source_attributes: Optional descriptive provenance, independent of identity.
         capture_time: Exact capture timestamp.
         duration_s: Clip duration in seconds.
         num_keyframes: Number of keyframes (annotated frames).
@@ -260,7 +260,6 @@ class ClipMeta:
     clip_id: str
     schema_version: str
     session_id: str
-    vehicle_id: str
     capture_time: TimeNs
     duration_s: float
     num_keyframes: int
@@ -269,6 +268,7 @@ class ClipMeta:
     annotation_frame_id: str
     ego_pose_frame_id: str
     label_schema: dict[str, Any]
+    source_attributes: dict[str, str] | None = None
     route_tag: str | None = None
     weather: str | None = None
     time_of_day: str | None = None
@@ -281,7 +281,6 @@ class ClipMeta:
             "clip_id": self.clip_id,
             "schema_version": self.schema_version,
             "session_id": self.session_id,
-            "vehicle_id": self.vehicle_id,
             "capture_time": self.capture_time.to_dict(),
             "duration_s": self.duration_s,
             "keyframe_count": self.num_keyframes,
@@ -294,6 +293,7 @@ class ClipMeta:
             "label_schema": copy.deepcopy(self.label_schema),
         }
         for key in (
+            "source_attributes",
             "route_tag",
             "weather",
             "time_of_day",