---
author: ""
---
(schemas:coordinate_systems)=

# Coordinate systems

- [1. Coordinate systems > coordinateSystem](#autogenerated_heading_2)
  - [1.1. Property `Coordinate systems > root items > name`](#items_name)
  - [1.2. Property `Coordinate systems > root items > axes`](#items_axes)
    - [1.2.1. Property `Coordinate systems > root items > axes > oneOf > item 0`](#items_axes_oneOf_i0)
    - [1.2.2. Property `Coordinate systems > root items > axes > oneOf > item 1`](#items_axes_oneOf_i1)
    - [1.2.3. Coordinate systems > root items > axes > axis](#autogenerated_heading_3)
      - [1.2.3.1. Property `Coordinate systems > root items > axes > axes items > name`](#items_axes_items_name)
      - [1.2.3.2. Property `Coordinate systems > root items > axes > axes items > longName`](#items_axes_items_longName)
      - [1.2.3.3. Property `Coordinate systems > root items > axes > axes items > type`](#items_axes_items_type)
      - [1.2.3.4. Property `Coordinate systems > root items > axes > axes items > discrete`](#items_axes_items_discrete)
      - [1.2.3.5. Property `Coordinate systems > root items > axes > axes items > unit`](#items_axes_items_unit)

**Title:** Coordinate systems

|              |         |
| ------------ | ------- |
| **Type**     | `array` |
| **Required** | No      |

**Description:** OME-Zarr coordinate system.

|                      | Array restrictions |
| -------------------- | ------------------ |
| **Min items**        | N/A                |
| **Max items**        | N/A                |
| **Items unicity**    | True               |
| **Additional items** | False              |
| **Tuple validation** | See below          |

| Each item of this array must be | Description                     |
| ------------------------------- | ------------------------------- |
| [coordinateSystem](#items)      | Coordinate Systems for OME-NGFF |

## <a name="autogenerated_heading_2"></a>1. Coordinate systems > coordinateSystem

|                           |                                                                           |
| ------------------------- | ------------------------------------------------------------------------- |
| **Type**                  | `object`                                                                  |
| **Required**              | No                                                                        |
| **Additional properties** | [[Any type: allowed]](# "Additional Properties of any type are allowed.") |
| **Defined in**            | #/$defs/coordinateSystem                                                  |

**Description:** Coordinate Systems for OME-NGFF

| Property               | Pattern | Type   | Deprecated | Definition     | Title/Description                                                       |
| ---------------------- | ------- | ------ | ---------- | -------------- | ----------------------------------------------------------------------- |
| + [name](#items_name ) | No      | string | No         | -              | Name of coordinate system. Must be unique among all coordinate systems. |
| + [axes](#items_axes ) | No      | array  | No         | In axes.schema | OME-Zarr Axes.                                                          |

### <a name="items_name"></a>1.1. Property `Coordinate systems > root items > name`

|              |          |
| ------------ | -------- |
| **Type**     | `string` |
| **Required** | Yes      |

**Description:** Name of coordinate system. Must be unique among all coordinate systems.

| Restrictions   |   |
| -------------- | - |
| **Min length** | 1 |

### <a name="items_axes"></a>1.2. Property `Coordinate systems > root items > axes`

|                |             |
| -------------- | ----------- |
| **Type**       | `combining` |
| **Required**   | Yes         |
| **Defined in** | axes.schema |

**Description:** OME-Zarr Axes.

| One of(Option)                 |
| ------------------------------ |
| [item 0](#items_axes_oneOf_i0) |
| [item 1](#items_axes_oneOf_i1) |

#### <a name="items_axes_oneOf_i0"></a>1.2.1. Property `Coordinate systems > root items > axes > oneOf > item 0`

|                           |                                                                           |
| ------------------------- | ------------------------------------------------------------------------- |
| **Type**                  | `object`                                                                  |
| **Required**              | No                                                                        |
| **Additional properties** | [[Any type: allowed]](# "Additional Properties of any type are allowed.") |

#### <a name="items_axes_oneOf_i1"></a>1.2.2. Property `Coordinate systems > root items > axes > oneOf > item 1`

|                           |                                                                           |
| ------------------------- | ------------------------------------------------------------------------- |
| **Type**                  | `object`                                                                  |
| **Required**              | No                                                                        |
| **Additional properties** | [[Any type: allowed]](# "Additional Properties of any type are allowed.") |

|                      | Array restrictions |
| -------------------- | ------------------ |
| **Min items**        | 1                  |
| **Max items**        | 5                  |
| **Items unicity**    | True               |
| **Additional items** | False              |
| **Tuple validation** | See below          |

| Each item of this array must be | Description |
| ------------------------------- | ----------- |
| [axis](#items_axes_items)       | -           |

#### <a name="autogenerated_heading_3"></a>1.2.3. Coordinate systems > root items > axes > axis

|                           |                                                                           |
| ------------------------- | ------------------------------------------------------------------------- |
| **Type**                  | `object`                                                                  |
| **Required**              | No                                                                        |
| **Additional properties** | [[Any type: allowed]](# "Additional Properties of any type are allowed.") |
| **Defined in**            | #/$defs/axis                                                              |

| Property                                  | Pattern | Type    | Deprecated | Definition | Title/Description                                              |
| ----------------------------------------- | ------- | ------- | ---------- | ---------- | -------------------------------------------------------------- |
| + [name](#items_axes_items_name )         | No      | string  | No         | -          | Name of the axis. Must be unique within the coordinate system. |
| - [longName](#items_axes_items_longName ) | No      | string  | No         | -          | Longer name or description of the axis.                        |
| - [type](#items_axes_items_type )         | No      | string  | No         | -          | Type of the axis. Can be a predefined type or custom type.     |
| - [discrete](#items_axes_items_discrete ) | No      | boolean | No         | -          | Whether the dimension is discrete                              |
| - [unit](#items_axes_items_unit )         | No      | string  | No         | -          | Unit for the axis                                              |

##### <a name="items_axes_items_name"></a>1.2.3.1. Property `Coordinate systems > root items > axes > axes items > name`

|              |          |
| ------------ | -------- |
| **Type**     | `string` |
| **Required** | Yes      |

**Description:** Name of the axis. Must be unique within the coordinate system.

| Restrictions   |   |
| -------------- | - |
| **Min length** | 1 |

##### <a name="items_axes_items_longName"></a>1.2.3.2. Property `Coordinate systems > root items > axes > axes items > longName`

|              |          |
| ------------ | -------- |
| **Type**     | `string` |
| **Required** | No       |

**Description:** Longer name or description of the axis.

##### <a name="items_axes_items_type"></a>1.2.3.3. Property `Coordinate systems > root items > axes > axes items > type`

|              |          |
| ------------ | -------- |
| **Type**     | `string` |
| **Required** | No       |

**Description:** Type of the axis. Can be a predefined type or custom type.

##### <a name="items_axes_items_discrete"></a>1.2.3.4. Property `Coordinate systems > root items > axes > axes items > discrete`

|              |           |
| ------------ | --------- |
| **Type**     | `boolean` |
| **Required** | No        |

**Description:** Whether the dimension is discrete

##### <a name="items_axes_items_unit"></a>1.2.3.5. Property `Coordinate systems > root items > axes > axes items > unit`

|              |          |
| ------------ | -------- |
| **Type**     | `string` |
| **Required** | No       |

**Description:** Unit for the axis

----------------------------------------------------------------------------------------------------------------------------
Generated using [json-schema-for-humans](https://github.com/coveooss/json-schema-for-humans) on 2026-04-01 at 17:39:10 +0000