sample_id.ann.ann module¶

class sample_id.ann.ann.Matcher(metadata)[source]¶

Bases: abc.ABC

Nearest neighbor matcher that may use one of various implementations under the hood.

add_fingerprint(fingerprint, dedupe=True)[source]¶

Add a Fingerprint to the matcher.

Return type: Matcher

add_fingerprints(fingerprints, **kwargs)[source]¶

Add Fingerprints to the matcher.

Return type: Matcher

can_add_fingerprint(fingerprint)[source]¶

Check if fingerprint can be added to matcher.

Return type: Boolean

classmethod create(sr=None, hop_length=None, **kwargs)[source]¶

Create an instance, pass any kwargs needed by the subclass.

Return type: Matcher

classmethod from_fingerprint(fp, **kwargs)[source]¶

Useful for determining metadata for the Matcher based on the data being added.

Return type: Matcher

classmethod from_fingerprints(fingerprints, **kwargs)[source]¶

My data is small, just create and train the entire matcher.

Return type: Matcher

abstract init_model()[source]¶

Initialize the model.

Return type: Any

classmethod load(filepath)[source]¶

Load a matcher from disk.

Return type: Matcher

abstract load_model(filepath)[source]¶

Load this matcher’s model from disk.

Return type: Any

save(filepath, compress=True)[source]¶

Save this matcher to disk.

Return type: None

abstract save_model(filepath)[source]¶

Save this matcher’s model to disk.

Return type: str

unload()[source]¶

Unload things from memory and cleanup any temporary files.

Return type: None

class sample_id.ann.ann.MatcherMetadata(sr=None, hop_length=None, index_to_id=None, index_to_ms=None, index_to_kp=None, **kwargs)[source]¶

Bases: object

Metadata for a Matcher object.

classmethod load(filepath)[source]¶

Load this matcher’s metadata from disk.

Return type: MatcherMetadata

save(filepath, compress=True)[source]¶

Save this matcher’s metadata to disk.

Return type: None