villa/foundation/volume-registration/transform_schema.json at main · brkzak/villa · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "version": "1.0.0",
  "type": "object",
  "required": [
    "schema_version",
    "fixed_volume",
    "transformation_matrix",
    "fixed_landmarks",
    "moving_landmarks"
  ],
  "properties": {
    "schema_version": {
      "type": "string",
      "const": "1.0.0",
      "description": "Version of the transformation data format schema"
    },
    "fixed_volume": {
      "type": "string",
      "description": "Path or identifier of the fixed volume to which this volume is registered"
    },
    "transformation_matrix": {
      "type": "array",
      "description": "3x4 affine transformation matrix in XYZ coordinate order (homogeneous coordinate row omitted). First 3x3 is the affine linear component, last column is the translation vector. Applied as p_fixed = M @ p_moving after the homogeneous row is added to the matrix. The fixed side is always the fixed volume's XYZ coordinate system. The moving side is the moving source's native XYZ coordinate system: moving-volume voxel coordinates for zarr-to-zarr registration, or native mesh XYZ coordinates for zarr-to-mesh registration.",
      "items": {
        "type": "array",
        "items": {
          "type": "number"
        },
        "minItems": 4,
        "maxItems": 4
      },
      "minItems": 3,
      "maxItems": 3
    },
    "fixed_landmarks": {
      "type": "array",
      "description": "Array of (x, y, z) points in the fixed volume (voxel coordinates)",
      "items": {
        "type": "array",
        "items": {
          "type": "number"
        },
        "minItems": 3,
        "maxItems": 3
      }
    },
    "moving_landmarks": {
      "type": "array",
      "description": "Corresponding (x, y, z) points in the moving source's native XYZ coordinate system. For moving zarr volumes these are moving-volume voxel coordinates; for moving meshes these are native mesh XYZ coordinates.",
      "items": {
        "type": "array",
        "items": {
          "type": "number"
        },
        "minItems": 3,
        "maxItems": 3
      }
    }
  },
  "additionalProperties": false
}