Skip to article frontmatterSkip to article content

Coordinate Transformations

Title: Coordinate Transformations

Typearray
RequiredNo

Description: OME-Zarr Coordinate transforms.

Array restrictions
Min items1
Max itemsN/A
Items unicityTrue
Additional itemsFalse
Tuple validationSee below
Each item of this array must beDescription
root items-

1. Coordinate Transformations > root items

Typecombining
RequiredNo
Additional propertiesAny type allowed
All of(Requirement)
coordinateTransformation
item 1

1.1. Property Coordinate Transformations > root items > allOf > coordinateTransformation

Typecombining
RequiredNo
Additional propertiesAny type allowed
Defined in#/$defs/coordinateTransformation

Description: OME-NGFF coordinate transformation.

All of(Requirement)
item 0
item 1

1.1.1. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 0

Typeobject
RequiredNo
Additional propertiesAny type allowed
PropertyPatternTypeDeprecatedDefinitionTitle/Description
- nameNostringNo--
+ typeNostringNo--
1.1.1.1. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 0 > name
Typestring
RequiredNo
1.1.1.2. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 0 > type
Typestring
RequiredYes

1.1.2. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1

Typecombining
RequiredNo
Additional propertiesAny type allowed
One of(Option)
Identity Transformation
Map Axis Transformation
Scale Transformation
Translation Transformation
Affine Transformation
Rotation Transformation
Bijection Transformation
Sequence Transformation
By Dimension Transformation
Displacement Field Transformation
Coordinate Field Transformation
1.1.2.1. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Identity Transformation

Title: Identity Transformation

Typeobject
RequiredNo
Additional propertiesAny type allowed
Defined in#/$defs/identity

Description: Identity transformation that maps input coordinates directly to output coordinates without modification.

PropertyPatternTypeDeprecatedDefinitionTitle/Description
- typeNoconstNo--
1.1.2.1.1. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Identity Transformation > type
Typeconst
RequiredNo

Specific value: "identity"

1.1.2.2. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Map Axis Transformation

Title: Map Axis Transformation

Typeobject
RequiredNo
Additional propertiesAny type allowed
Defined in#/$defs/mapAxis

Description: Permute axes by mapping input axes to output axes.

PropertyPatternTypeDeprecatedDefinitionTitle/Description
- typeNoconstNo--
+ mapAxisNoarray of integerNo-An array of integers representing the new axis order as zero-based indices of the input axes.
1.1.2.2.1. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Map Axis Transformation > type
Typeconst
RequiredNo

Specific value: "mapAxis"

1.1.2.2.2. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Map Axis Transformation > mapAxis
Typearray of integer
RequiredYes

Description: An array of integers representing the new axis order as zero-based indices of the input axes.

Array restrictions
Min itemsN/A
Max itemsN/A
Items unicityFalse
Additional itemsFalse
Tuple validationSee below
Each item of this array must beDescription
mapAxis items-
1.1.2.2.2.1. Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Map Axis Transformation > mapAxis > mapAxis items
Typeinteger
RequiredNo
1.1.2.3. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Scale Transformation

Title: Scale Transformation

Typeobject
RequiredNo
Additional propertiesAny type allowed
Defined in#/$defs/scale

Description: Scale transformation that scales coordinates by specified factors along each axis.

PropertyPatternTypeDeprecatedDefinitionTitle/Description
- typeNoconstNo--
+ scaleNoarray of numberNo--
1.1.2.3.1. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Scale Transformation > type
Typeconst
RequiredNo

Specific value: "scale"

1.1.2.3.2. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Scale Transformation > scale
Typearray of number
RequiredYes
Array restrictions
Min itemsN/A
Max itemsN/A
Items unicityFalse
Additional itemsFalse
Tuple validationSee below
Each item of this array must beDescription
scale items-
1.1.2.3.2.1. Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Scale Transformation > scale > scale items
Typenumber
RequiredNo
Restrictions
Minimum> 0
1.1.2.4. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Translation Transformation

Title: Translation Transformation

Typeobject
RequiredNo
Additional propertiesAny type allowed
Defined in#/$defs/translation

Description: Translation transformation that shifts coordinates by specified offsets along each axis.

PropertyPatternTypeDeprecatedDefinitionTitle/Description
- typeNoconstNo--
+ translationNoarray of numberNo--
1.1.2.4.1. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Translation Transformation > type
Typeconst
RequiredNo

Specific value: "translation"

1.1.2.4.2. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Translation Transformation > translation
Typearray of number
RequiredYes
Array restrictions
Min itemsN/A
Max itemsN/A
Items unicityFalse
Additional itemsFalse
Tuple validationSee below
Each item of this array must beDescription
translation items-
1.1.2.4.2.1. Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Translation Transformation > translation > translation items
Typenumber
RequiredNo
1.1.2.5. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Affine Transformation

Title: Affine Transformation

Typecombining
RequiredNo
Additional propertiesAny type allowed
Defined in#/$defs/affine

Description: Affine transformation represented by a transformation matrix.

PropertyPatternTypeDeprecatedDefinitionTitle/Description
- typeNoconstNo--
One of(Option)
item 0
item 1
1.1.2.5.1. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Affine Transformation > oneOf > item 0
Typeobject
RequiredNo
Additional propertiesAny type allowed
PropertyPatternTypeDeprecatedDefinitionTitle/Description
+ pathNostringNo-Path to a zarr array containing the affine matrix.
1.1.2.5.1.1. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Affine Transformation > oneOf > item 0 > path
Typestring
RequiredYes

Description: Path to a zarr array containing the affine matrix.

1.1.2.5.2. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Affine Transformation > oneOf > item 1
Typeobject
RequiredNo
Additional propertiesAny type allowed
PropertyPatternTypeDeprecatedDefinitionTitle/Description
+ affineNoarray of arrayNo--
1.1.2.5.2.1. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Affine Transformation > oneOf > item 1 > affine
Typearray of array
RequiredYes
Array restrictions
Min itemsN/A
Max itemsN/A
Items unicityFalse
Additional itemsFalse
Tuple validationSee below
Each item of this array must beDescription
affine items-
1.1.2.5.2.1.1. Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Affine Transformation > oneOf > item 1 > affine > affine items
Typearray of number
RequiredNo
Array restrictions
Min itemsN/A
Max itemsN/A
Items unicityFalse
Additional itemsFalse
Tuple validationSee below
Each item of this array must beDescription
affine items items-
1.1.2.5.2.1.1.1. Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Affine Transformation > oneOf > item 1 > affine > affine items > affine items items
Typenumber
RequiredNo
1.1.2.5.3. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Affine Transformation > type
Typeconst
RequiredNo

Specific value: "affine"

1.1.2.6. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Rotation Transformation

Title: Rotation Transformation

Typecombining
RequiredNo
Additional propertiesAny type allowed
Defined in#/$defs/rotation

Description: Rotation transformation represented by a rotation matrix.

PropertyPatternTypeDeprecatedDefinitionTitle/Description
- typeNoconstNo--
One of(Option)
item 0
item 1
1.1.2.6.1. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Rotation Transformation > oneOf > item 0
Typeobject
RequiredNo
Additional propertiesAny type allowed
PropertyPatternTypeDeprecatedDefinitionTitle/Description
+ pathNostringNo-Path to a zarr array containing the rotation matrix.
1.1.2.6.1.1. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Rotation Transformation > oneOf > item 0 > path
Typestring
RequiredYes

Description: Path to a zarr array containing the rotation matrix.

1.1.2.6.2. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Rotation Transformation > oneOf > item 1
Typeobject
RequiredNo
Additional propertiesAny type allowed
PropertyPatternTypeDeprecatedDefinitionTitle/Description
+ rotationNoarray of arrayNo--
1.1.2.6.2.1. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Rotation Transformation > oneOf > item 1 > rotation
Typearray of array
RequiredYes
Array restrictions
Min itemsN/A
Max itemsN/A
Items unicityFalse
Additional itemsFalse
Tuple validationSee below
Each item of this array must beDescription
rotation items-
1.1.2.6.2.1.1. Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Rotation Transformation > oneOf > item 1 > rotation > rotation items
Typearray of number
RequiredNo
Array restrictions
Min itemsN/A
Max itemsN/A
Items unicityFalse
Additional itemsFalse
Tuple validationSee below
Each item of this array must beDescription
rotation items items-
1.1.2.6.2.1.1.1. Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Rotation Transformation > oneOf > item 1 > rotation > rotation items > rotation items items
Typenumber
RequiredNo
1.1.2.6.3. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Rotation Transformation > type
Typeconst
RequiredNo

Specific value: "rotation"

1.1.2.7. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Bijection Transformation

Title: Bijection Transformation

Typeobject
RequiredNo
Additional propertiesAny type allowed
Defined in#/$defs/bijection

Description: A pair of forward and inverse coordinate transformations.

PropertyPatternTypeDeprecatedDefinitionTitle/Description
- typeNoconstNo--
+ forwardNoobjectNoSame as items_allOf_i0OME-NGFF coordinate transformation.
+ inverseNoobjectNoSame as items_allOf_i0OME-NGFF coordinate transformation.
1.1.2.7.1. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Bijection Transformation > type
Typeconst
RequiredNo

Specific value: "bijection"

1.1.2.7.2. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Bijection Transformation > forward
Typecombining
RequiredYes
Additional propertiesAny type allowed
Same definition asitems_allOf_i0

Description: OME-NGFF coordinate transformation.

1.1.2.7.3. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Bijection Transformation > inverse
Typecombining
RequiredYes
Additional propertiesAny type allowed
Same definition asitems_allOf_i0

Description: OME-NGFF coordinate transformation.

1.1.2.8. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Sequence Transformation

Title: Sequence Transformation

Typeobject
RequiredNo
Additional propertiesAny type allowed
Defined in#/$defs/sequence

Description: A sequence of transformations applied in order.

PropertyPatternTypeDeprecatedDefinitionTitle/Description
- typeNoconstNo--
+ transformationsNoarrayNo--
1.1.2.8.1. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Sequence Transformation > type
Typeconst
RequiredNo

Specific value: "sequence"

1.1.2.8.2. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Sequence Transformation > transformations
Typearray
RequiredYes
Array restrictions
Min itemsN/A
Max itemsN/A
Items unicityFalse
Additional itemsFalse
Tuple validationSee below
Each item of this array must beDescription
coordinateTransformationOME-NGFF coordinate transformation.
1.1.2.8.2.1. Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Sequence Transformation > transformations > coordinateTransformation
Typecombining
RequiredNo
Additional propertiesAny type allowed
Same definition asitems_allOf_i0

Description: OME-NGFF coordinate transformation.

1.1.2.9. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > By Dimension Transformation

Title: By Dimension Transformation

Typeobject
RequiredNo
Additional propertiesAny type allowed
Defined in#/$defs/byDimension

Description: A set of transformations applied independently to each dimension.

PropertyPatternTypeDeprecatedDefinitionTitle/Description
- typeNoconstNo--
+ transformationsNoarrayNo--
1.1.2.9.1. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > By Dimension Transformation > type
Typeconst
RequiredNo

Specific value: "byDimension"

1.1.2.9.2. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > By Dimension Transformation > transformations
Typearray
RequiredYes
Array restrictions
Min itemsN/A
Max itemsN/A
Items unicityFalse
Additional itemsFalse
Tuple validationSee below
Each item of this array must beDescription
byDimensionTransformationTransformation used inside a byDimension transformation
1.1.2.9.2.1. Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > By Dimension Transformation > transformations > byDimensionTransformation
Typecombining
RequiredNo
Additional propertiesAny type allowed
Defined in#/$defs/byDimensionTransformation

Description: Transformation used inside a byDimension transformation

All of(Requirement)
coordinateTransformation
item 1
1.1.2.9.2.1.1. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > By Dimension Transformation > transformations > transformations items > allOf > coordinateTransformation
Typecombining
RequiredNo
Additional propertiesAny type allowed
Same definition asitems_allOf_i0

Description: OME-NGFF coordinate transformation.

1.1.2.9.2.1.2. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > By Dimension Transformation > transformations > transformations items > allOf > item 1
Typeobject
RequiredNo
Additional propertiesAny type allowed
PropertyPatternTypeDeprecatedDefinitionTitle/Description
+ input_axesNoarray of stringNo-Names of the input axes for this transformation.
+ output_axesNoarray of stringNo-Names of the output axes for this transformation.
1.1.2.9.2.1.2.1. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > By Dimension Transformation > transformations > transformations items > allOf > item 1 > input_axes
Typearray of string
RequiredYes

Description: Names of the input axes for this transformation.

Array restrictions
Min itemsN/A
Max itemsN/A
Items unicityFalse
Additional itemsFalse
Tuple validationSee below
Each item of this array must beDescription
input_axes items-
1.1.2.9.2.1.2.1.1. Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > By Dimension Transformation > transformations > transformations items > allOf > item 1 > input_axes > input_axes items
Typestring
RequiredNo
1.1.2.9.2.1.2.2. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > By Dimension Transformation > transformations > transformations items > allOf > item 1 > output_axes
Typearray of string
RequiredYes

Description: Names of the output axes for this transformation.

Array restrictions
Min itemsN/A
Max itemsN/A
Items unicityFalse
Additional itemsFalse
Tuple validationSee below
Each item of this array must beDescription
output_axes items-
1.1.2.9.2.1.2.2.1. Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > By Dimension Transformation > transformations > transformations items > allOf > item 1 > output_axes > output_axes items
Typestring
RequiredNo
1.1.2.10. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Displacement Field Transformation

Title: Displacement Field Transformation

Typeobject
RequiredNo
Additional propertiesAny type allowed
Defined in#/$defs/displacements

Description: Transformation defined by a displacement field stored in a zarr array.

PropertyPatternTypeDeprecatedDefinitionTitle/Description
- typeNoconstNo--
+ pathNostringNo-Path to the zarr array containing the displacement field.
- interpolationNoenum (of string)No-Interpolation method to use when applying the displacement field.
1.1.2.10.1. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Displacement Field Transformation > type
Typeconst
RequiredNo

Specific value: "displacements"

1.1.2.10.2. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Displacement Field Transformation > path
Typestring
RequiredYes

Description: Path to the zarr array containing the displacement field.

1.1.2.10.3. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Displacement Field Transformation > interpolation
Typeenum (of string)
RequiredNo
Default"linear"

Description: Interpolation method to use when applying the displacement field.

Must be one of:

1.1.2.11. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Coordinate Field Transformation

Title: Coordinate Field Transformation

Typeobject
RequiredNo
Additional propertiesAny type allowed
Defined in#/$defs/coordinates

Description: Transformation defined by a coordinate field stored in a zarr array.

PropertyPatternTypeDeprecatedDefinitionTitle/Description
- typeNoconstNo--
+ pathNostringNo-Path to the zarr array containing the coordinate field.
- interpolationNoenum (of string)No-Interpolation method to use when applying the coordinate field.
1.1.2.11.1. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Coordinate Field Transformation > type
Typeconst
RequiredNo

Specific value: "coordinates"

1.1.2.11.2. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Coordinate Field Transformation > path
Typestring
RequiredYes

Description: Path to the zarr array containing the coordinate field.

1.1.2.11.3. Property Coordinate Transformations > root items > allOf > item 0 > allOf > item 1 > oneOf > Coordinate Field Transformation > interpolation
Typeenum (of string)
RequiredNo
Default"linear"

Description: Interpolation method to use when applying the coordinate field.

Must be one of:

1.2. Property Coordinate Transformations > root items > allOf > item 1

Typeobject
RequiredNo
Additional propertiesAny type allowed
PropertyPatternTypeDeprecatedDefinitionTitle/Description
+ inputNoCombinationNo--
+ outputNoCombinationNo--

1.2.1. Property Coordinate Transformations > root items > allOf > item 1 > input

Typecombining
RequiredYes
Additional propertiesAny type allowed
One of(Option)
item 0
item 1
1.2.1.1. Property Coordinate Transformations > root items > allOf > item 1 > input > oneOf > item 0
Typestring
RequiredNo
1.2.1.2. Property Coordinate Transformations > root items > allOf > item 1 > input > oneOf > item 1
Typeobject
RequiredNo
Additional propertiesAny type allowed
PropertyPatternTypeDeprecatedDefinitionTitle/Description
- nameNostringNo--
- pathNostringNo--
1.2.1.2.1. Property Coordinate Transformations > root items > allOf > item 1 > input > oneOf > item 1 > name
Typestring
RequiredNo
1.2.1.2.2. Property Coordinate Transformations > root items > allOf > item 1 > input > oneOf > item 1 > path
Typestring
RequiredNo

1.2.2. Property Coordinate Transformations > root items > allOf > item 1 > output

Typecombining
RequiredYes
Additional propertiesAny type allowed
One of(Option)
item 0
item 1
1.2.2.1. Property Coordinate Transformations > root items > allOf > item 1 > output > oneOf > item 0
Typestring
RequiredNo
1.2.2.2. Property Coordinate Transformations > root items > allOf > item 1 > output > oneOf > item 1
Typeobject
RequiredNo
Additional propertiesAny type allowed
PropertyPatternTypeDeprecatedDefinitionTitle/Description
- nameNostringNo--
- pathNostringNo--
1.2.2.2.1. Property Coordinate Transformations > root items > allOf > item 1 > output > oneOf > item 1 > name
Typestring
RequiredNo
1.2.2.2.2. Property Coordinate Transformations > root items > allOf > item 1 > output > oneOf > item 1 > path
Typestring
RequiredNo

Generated using json-schema-for-humans on 2026-01-26 at 10:45:36 +0000