-
tensorstore.Schema(*, rank: int | None =
None
, dtype: dtype | None =None
, domain: IndexDomain | None =None
, shape: Sequence[int] | None =None
, chunk_layout: ChunkLayout | None =None
, codec: CodecSpec | None =None
, fill_value: ArrayLike | None =None
, dimension_units: Sequence[Unit | str | Real | tuple[Real, str] | None] | None =None
, schema: Schema | None =None
) Constructs from component parts.
Example
>>> ts.Schema(dtype=ts.uint8, ... chunk_layout=ts.ChunkLayout(grid_origin=[1, 2, 3], ... inner_order=[0, 2, 1])) Schema({ 'chunk_layout': {'grid_origin': [1, 2, 3], 'inner_order': [0, 2, 1]}, 'dtype': 'uint8', 'rank': 3, })
- Parameters:¶
- rank: int | None =
None
¶ Constrains the rank of the TensorStore. If there is an index transform, the rank constraint must match the rank of the input space.
- dtype: dtype | None =
None
¶ Constrains the data type of the TensorStore. If a data type has already been set, it is an error to specify a different data type.
- domain: IndexDomain | None =
None
¶ Constrains the domain of the TensorStore. If there is an existing domain, the specified domain is merged with it as follows:
The rank must match the existing rank.
All bounds must match, except that a finite or explicit bound is permitted to match an infinite and implicit bound, and takes precedence.
If both the new and existing domain specify non-empty labels for a dimension, the labels must be equal. If only one of the domains specifies a non-empty label for a dimension, the non-empty label takes precedence.
Note that if there is an index transform, the domain must match the input space, not the output space.
- shape: Sequence[int] | None =
None
¶ Constrains the shape and origin of the TensorStore. Equivalent to specifying a
domain
ofts.IndexDomain(shape=shape)
.Note
This option also constrains the origin of all dimensions to be zero.
- chunk_layout: ChunkLayout | None =
None
¶ Constrains the chunk layout. If there is an existing chunk layout constraint, the constraints are merged. If the constraints are incompatible, an error is raised.
- codec: CodecSpec | None =
None
¶ Constrains the codec. If there is an existing codec constraint, the constraints are merged. If the constraints are incompatible, an error is raised.
- fill_value: ArrayLike | None =
None
¶ Specifies the fill value for positions that have not been written.
The fill value data type must be convertible to the actual data type, and the shape must be broadcast-compatible with the domain.
If an existing fill value has already been set as a constraint, it is an error to specify a different fill value (where the comparison is done after normalization by broadcasting).
- dimension_units: Sequence[Unit | str | Real | tuple[Real, str] | None] | None =
None
¶ Specifies the physical units of each dimension of the domain.
The physical unit for a dimension is the physical quantity corresponding to a single index increment along each dimension.
A value of
None
indicates that the unit is unknown. A dimension-less quantity can be indicated by a unit of""
.- schema: Schema | None =
None
¶ Additional schema constraints to merge with existing constraints.
- rank: int | None =