tiledbsoma.Collection.create

classmethod Collection.create(uri: str, *, platform_config: Dict[str, Mapping[str, Any]] | object | None = None, context: SOMATileDBContext | None = None, tiledb_timestamp: int | datetime | None = None) → Self

Creates and opens a new SOMA collection in storage.

This creates a new SOMA collection of the current type in storage and returns it opened for writing.

Parameters:

• uri – The location to create this SOMA collection at.

• platform_config – Platform-specific options used to create this collection. This may be provided as settings in a dictionary, with options located in the {'tiledb': {'create': ...}} key, or as a TileDBCreateOptions object. (Currently unused for collections.)

• context – If provided, the SOMATileDBContext to use when creating and opening this collection.

• tiledb_timestamp – If specified, overrides the default timestamp used to open this object. If unset, uses the timestamp provided by the context.

Raises:

• tiledbsoma.AlreadyExistsError – If the underlying object already exists at the given URI.

• tiledbsoma.NotCreateableError – If the URI is malformed for a particular storage backend.

• TileDBError – If unable to create the underlying object.

Lifecycle

Maturing.