Add add_new_level to Image2D

python-spec/src/somacore/ephemeral/collections.py

@@ -5,7 +5,9 @@
     MutableMapping,
     NoReturn,
     Optional,
+    Sequence,
     TypeVar,
+    Union,
 )
 
 import pyarrow as pa
@@ -169,6 +171,17 @@ class Image2D(  # type: ignore[misc]   # __eq__ false positive
 
     __slots__ = ()
 
+    def add_new_level(
+        self,
+        key: str,
+        *,
+        uri: Optional[str] = None,
+        type: pa.DataType,
+        shape: Sequence[int],
+        axes: Union[str, Sequence[str]],
+    ) -> data.DenseNDArray:
+        raise NotImplementedError()
+
     @property
     def level_count(self) -> int:
         raise NotImplementedError()

python-spec/src/somacore/images.py

@@ -1,7 +1,7 @@
 """Implementation of the SOMA image collection for spatial data"""
 
 import abc
-from typing import Generic, Optional, Tuple, TypeVar
+from typing import Generic, Optional, Sequence, Tuple, TypeVar, Union
 
 import pyarrow as pa
 from typing_extensions import Final, Protocol
@@ -58,6 +58,18 @@ def name(self) -> str:
         def shape(self) -> Tuple[int, ...]:
             """Number of pixels for each dimension of the image."""
 
+    @abc.abstractmethod
+    def add_new_level(
+        self,
+        key: str,
+        *,
+        uri: Optional[str] = None,
+        type: pa.DataType,
+        shape: Sequence[int],
+        axes: Union[str, Sequence[str]],
+    ) -> data.DenseNDArray:
+        raise NotImplementedError()
+
     @property
     @abc.abstractmethod
     def level_count(self) -> int: