MatchMetadata

MatchMetadata(
    agent,
    decision_criteria,
    certainty=1.0,
    created_at=datetime.now(),
    notes=None,
    algorithm_params=None,
)

Provenance information for a match claim.

Following the TTA manuscript’s requirement that matches must include the agent/author, decision criteria, and certainty level.

Attributes: agent: Who or what created this match (user ID, algorithm name). decision_criteria: How the match was determined (e.g., “manual”, “dynamic_time_warping”, “segment_correspondence”). certainty: Confidence level in [0, 1]. 1.0 = certain. created_at: When the match was created. notes: Additional human-readable notes. algorithm_params: Parameters used by the matching algorithm.

Examples: >>> meta = MatchMetadata( … agent=“analyst_jh”, … decision_criteria=“manual_segmentation”, … certainty=1.0, … )

>>> meta = MatchMetadata(
...     agent="dtw_v2",
...     decision_criteria="dynamic_time_warping",
...     certainty=0.85,
...     algorithm_params={"window_size": 100},
... )

Methods

Name	Description
from_dict	Deserialize from dictionary.
to_dict	Serialize to dictionary for storage.

from_dict

MatchMetadata.from_dict(data)

Deserialize from dictionary.

to_dict

MatchMetadata.to_dict()

Serialize to dictionary for storage.