Skip to content

Io 3dbag Feature Files

Real-geometry 3DBAG slice stored as one file per feature. Targets filesystem access patterns including open/close overhead, metadata lookup, and random versus sequential access.

Case

  • id: io_3dbag_feature_files
  • layer: workload
  • family: io
  • artifact_mode: acquired
  • source_kind: real-geometry
  • representation: feature-files
  • path: cases/workloads/io_3dbag_feature_files

Files

  • acquisition: cases/workloads/io_3dbag_feature_files/acquisition.json

Source JSON

case.json

{
  "artifact_mode": "acquired",
  "artifact_paths": {
    "acquisition": "cases/workloads/io_3dbag_feature_files/acquisition.json"
  },
  "assertions": [
    "file_count_preserved",
    "layout_stable"
  ],
  "cityjson_version": "2.0",
  "description": "Real-geometry 3DBAG slice stored as one file per feature. Targets filesystem access patterns including open/close overhead, metadata lookup, and random versus sequential access.",
  "family": "io",
  "geometry_kind": "real-preserved",
  "id": "io_3dbag_feature_files",
  "layer": "workload",
  "representation": "feature-files",
  "source_kind": "real-geometry",
  "version": 2
}

invariants.json

{
  "checks": [
    {
      "description": "The feature-file count remains stable.",
      "id": "file_count_preserved"
    },
    {
      "description": "The layout stays stable during feature lookup.",
      "id": "layout_stable"
    }
  ],
  "id": "io_3dbag_feature_files",
  "kind": "positive",
  "version": 1
}

acquisition.json

{
  "dataset": "3DBAG",
  "id": "io_3dbag_feature_files",
  "license": "Use the upstream 3DBAG license terms until the corpus release metadata is published.",
  "notes": "The same real-geometry 3DBAG slice split into one file per feature. This is a filesystem-heavy layout case for open/close overhead, metadata lookup, and random-access behavior.",
  "outputs": [
    {
      "byte_size": null,
      "checksum": null,
      "derivation": "materialized",
      "derived_from": [
        "artifacts/acquired/3dbag/v20250903/10-758-50.city.jsonl"
      ],
      "path": "artifacts/acquired/3dbag/v20250903/10-758-50.feature-files",
      "producer": "cityjson-corpus",
      "published": true,
      "representation": "feature-files",
      "validation_role": "benchmark-only"
    }
  ],
  "owner": "cjindex",
  "preprocessing": [
    "Run the shared 3DBAG acquisition script in cityjson-corpus.",
    "Export the published raw CityJSON tile as JSONL with cjio.",
    "Split the validated JSONL stream into metadata.json and one feature file per CityJSONFeature."
  ],
  "reference": "Use `just acquire-3dbag` in cityjson-corpus to split the pinned JSONL stream into one file per feature.",
  "selector": "Pinned v20250903 tile: 10-758-50.",
  "status": "published",
  "upstream_url": "https://data.3dbag.nl/v20250903/",
  "upstream_version": "2025.09.03",
  "version": 2
}