public interface RewritableDatastore
RewritableDatastores are Datastores that allow images and SummaryMetadata
to be deleted or overwritten after they have been inserted. They also
publish additional events when those actions are performed. You can create
an RewritableDatastore using the DataManager. Note that not all types of
Datastores support rewriting (e.g. file-based Datastores).
Nested Class Summary
Nested classes/interfaces inherited from interface org.micromanager.data.Datastore
Insert an image into the Datastore. Posts a NewImageEvent to the event
bus. Unlike the base Datastore method, this method will allow images to
be overwritten (i.e. will not cause a DatastoreRewriteException), if an
image with the same coordinates is already in the Datastore. An
ImageOverwrittenEvent will be published on the Datastore's EventBus if
This method will also update the axisOrder property of the Datastore's
SummaryMetadata, if appropriate.
java.lang.IllegalArgumentException - if the image's axes do not match the
axes of images previously added to the Datastore. All images
in a Datastore are required to have the same set of axes in
their Coords objects.
Delete all images from the Datastore whose coordinates match the provided
Coords object, which may be underspecified. All images whose coordinate
positions match all positions in the Coords will be deleted (with a
corresponding ImageDeletedEvent posted on the Datastore's event bus).
For example, calling this method with a Coords of <"z" = 9>
would delete all Images whose Z coordinate is 9. Calling this method
with an empty Coords object will delete every image in the Datastore,
as per deleteAllImages() except without posting a DatastoreClearedEvent.
This method may potentially remove no images.
coords - Potentially-underspecified coordinates of the image(s) to
java.io.IOException - if an IO error occurred.
Delete all images from the Datastore. An ImageDeletedEvent will be
published on the Datastore's event bus for each image, as will a