fiftyone.core.singletons.SampleSingleton

class documentation

class SampleSingleton(DocumentSingleton): (source)

This metaclass maintains a weakref dictionary of all in-memory fiftyone.core.sample.Sample instances keyed by [collection name][sample ID].

Method	`__new__`	Undocumented
Method	`_clear`	Removes all samples for the given collection from the cache.
Method	`_clear_fields`	Clears the values for the given fields (i.e., sets them to None) on all in-memory samples in the collection.
Method	`_get_instance`	Retrieves the `fiftyone.core.document.Document` instance for the given document, if one exists.
Method	`_purge_fields`	Removes the fields from all in-memory samples in the collection.
Method	`_register_instance`	Registers the given instance in the weakref dictionary.
Method	`_reload_doc`	Reloads the backing document for the given sample if it is in-memory.
Method	`_reload_docs`	Reloads the backing documents for in-memory samples in the collection.
Method	`_reload_instance`	Reloads the backing document for the given instance (or view), if a reference exists to it.
Method	`_rename_fields`	Renames the field on all in-memory samples in the collection.
Method	`_reset_docs`	Resets the backing documents for in-memory samples in the collection.
Method	`_sync_docs`	Syncs the backing documents for all in-memory samples in the collection according to the following rules:

def __new__(metacls, *args, **kwargs): (source) ¶

Undocumented

def _clear(cls, collection_name): (source) ¶

Removes all samples for the given collection from the cache.

def _clear_fields(cls, collection_name, field_names): (source) ¶

Clears the values for the given fields (i.e., sets them to None) on all in-memory samples in the collection.

def _get_instance(cls, doc): (source) ¶

overrides fiftyone.core.singletons.DocumentSingleton._get_instance

Retrieves the fiftyone.core.document.Document instance for the given document, if one exists.

Parameters
cls	Undocumented
doc	a `fiftyone.core.odm.document.Document`
Returns
a `fiftyone.core.document.Document` instance, or None

def _purge_fields(cls, collection_name, field_names): (source) ¶

Removes the fields from all in-memory samples in the collection.

def _register_instance(cls, obj): (source) ¶

overrides fiftyone.core.singletons.DocumentSingleton._register_instance

Registers the given instance in the weakref dictionary.

def _reload_doc(cls, collection_name, sample_id, hard=False): (source) ¶

Reloads the backing document for the given sample if it is in-memory.

def _reload_docs(cls, collection_name, sample_ids=None, hard=False): (source) ¶

Reloads the backing documents for in-memory samples in the collection.

If sample_ids are provided, only those samples are reloaded.

def _reload_instance(cls, obj): (source) ¶

overrides fiftyone.core.singletons.DocumentSingleton._reload_instance

Reloads the backing document for the given instance (or view), if a reference exists to it.

def _rename_fields(cls, collection_name, field_names, new_field_names): (source) ¶

Renames the field on all in-memory samples in the collection.

def _reset_docs(cls, collection_name, sample_ids=None): (source) ¶

Resets the backing documents for in-memory samples in the collection.

Reset samples will no longer belong to their parent dataset.

If sample_ids are provided, only those samples are reset.

def _sync_docs(cls, collection_name, sample_ids, hard=False): (source) ¶

Syncs the backing documents for all in-memory samples in the collection according to the following rules: