Collections

A saved configuration with layers, tools, and properties.

In NimbusImage, "collections" and "configurations" are the same thing.

nimbusimage.collections.Collection

A NimbusImage collection (configuration).

Contains layer settings, tool definitions, property registrations, snapshots, and scales for a dataset view.

folder_id property

The parent folder ID this collection belongs to.

layers property

Layer settings (channel, color, contrast, visibility).

tools property

Tool definitions.

property_ids property

Registered property IDs.

snapshots property

Saved view snapshots.

scales property

Scale settings (pixel size, z step, time step).

url()

URL for the collection/configuration page.

open()

Open the collection page in the default browser.

nimbusimage.collections.CollectionAccessor

Access collections for a specific dataset.

This accessor finds collections via dataset_views, which link datasets to collections.

layers property

Layer settings from the first collection.

Used by ImageAccessor.get_composite() for contrast and color.

property_ids property

Property IDs registered in the first collection.

list_views()

List dataset views for this dataset.

Each view links this dataset to a collection and stores per-user view state (last location, contrast overrides, etc.).

get(collection_id=None)

Get a collection for this dataset.

Parameters:

Name	Type	Description	Default
collection_id	str | None	Specific collection ID. If None, returns the collection from the first dataset view.	None

Returns:

Type	Description
Collection | None	Collection object, or None if no views/collections exist.

list()

List all collections linked to this dataset via views.

Note

Makes one HTTP call per unique collection. No batch-by-IDs endpoint exists yet on the server.

get_raw(collection_id=None)

Get a collection as a raw dict.

Parameters:

Name	Type	Description	Default
collection_id	str | None	Specific collection ID. If None, returns the first collection for this dataset.	None

Returns:

Type	Description
dict	Raw collection dict, or empty dict if none exist.

refresh()

Clear cached collection. Next access will re-fetch from server.