deepset-ai--haystack/test/components/evaluators/test_document_mrr.py

# SPDX-FileCopyrightText: 2022-present deepset GmbH <info@deepset.ai>
#
# SPDX-License-Identifier: Apache-2.0

import pytest

from haystack import Document, default_from_dict
from haystack.components.evaluators.document_mrr import DocumentMRREvaluator


def test_to_dict():
    evaluator = DocumentMRREvaluator()
    data = evaluator.to_dict()
    assert data == {
        "type": "haystack.components.evaluators.document_mrr.DocumentMRREvaluator",
        "init_parameters": {"document_comparison_field": "content"},
    }


def test_to_dict_custom_field():
    evaluator = DocumentMRREvaluator(document_comparison_field="id")
    data = evaluator.to_dict()
    assert data == {
        "type": "haystack.components.evaluators.document_mrr.DocumentMRREvaluator",
        "init_parameters": {"document_comparison_field": "id"},
    }


def test_from_dict():
    data = {
        "type": "haystack.components.evaluators.document_mrr.DocumentMRREvaluator",
        "init_parameters": {"document_comparison_field": "id"},
    }
    evaluator = default_from_dict(DocumentMRREvaluator, data)
    assert evaluator.document_comparison_field == "id"


def test_run_with_id_comparison():
    evaluator = DocumentMRREvaluator(document_comparison_field="id")
    result = evaluator.run(
        ground_truth_documents=[[Document(id="doc1", content="foo")], [Document(id="doc2", content="bar")]],
        retrieved_documents=[[Document(id="doc1", content="different")], [Document(id="wrong", content="bar")]],
    )
    assert result == {"individual_scores": [1.0, 0.0], "score": 0.5}


def test_run_with_meta_comparison():
    evaluator = DocumentMRREvaluator(document_comparison_field="meta.file_id")
    result = evaluator.run(
        ground_truth_documents=[
            [Document(content="x", meta={"file_id": "a"})],
            [Document(content="y", meta={"file_id": "b"})],
        ],
        retrieved_documents=[
            [Document(content="z", meta={"file_id": "a"})],
            [Document(content="w", meta={"file_id": "c"})],
        ],
    )
    assert result == {"individual_scores": [1.0, 0.0], "score": 0.5}


def test_run_with_nested_meta_comparison():
    evaluator = DocumentMRREvaluator(document_comparison_field="meta.source.url")
    result = evaluator.run(
        ground_truth_documents=[
            [Document(content="x", meta={"source": {"url": "https://a.com"}})],
            [Document(content="y", meta={"source": {"url": "https://b.com"}})],
        ],
        retrieved_documents=[
            [Document(content="z", meta={"source": {"url": "https://a.com"}})],
            [Document(content="w", meta={"source": {"url": "https://c.com"}})],
        ],
    )
    assert result == {"individual_scores": [1.0, 0.0], "score": 0.5}


def test_run_with_all_matching():
    evaluator = DocumentMRREvaluator()
    result = evaluator.run(
        ground_truth_documents=[[Document(content="Berlin")], [Document(content="Paris")]],
        retrieved_documents=[[Document(content="Berlin")], [Document(content="Paris")]],
    )

    assert result == {"individual_scores": [1.0, 1.0], "score": 1.0}


def test_run_with_no_matching():
    evaluator = DocumentMRREvaluator()
    result = evaluator.run(
        ground_truth_documents=[[Document(content="Berlin")], [Document(content="Paris")]],
        retrieved_documents=[[Document(content="Paris")], [Document(content="London")]],
    )

    assert result == {"individual_scores": [0.0, 0.0], "score": 0.0}


def test_run_with_partial_matching():
    evaluator = DocumentMRREvaluator()
    result = evaluator.run(
        ground_truth_documents=[[Document(content="Berlin")], [Document(content="Paris")]],
        retrieved_documents=[[Document(content="Berlin")], [Document(content="London")]],
    )

    assert result == {"individual_scores": [1.0, 0.0], "score": 0.5}


def test_run_with_complex_data():
    evaluator = DocumentMRREvaluator()
    result = evaluator.run(
        ground_truth_documents=[
            [Document(content="France")],
            [Document(content="9th century"), Document(content="9th")],
            [Document(content="classical music"), Document(content="classical")],
            [Document(content="11th century"), Document(content="the 11th")],
            [Document(content="Denmark, Iceland and Norway")],
            [Document(content="10th century"), Document(content="10th")],
        ],
        retrieved_documents=[
            [Document(content="France")],
            [Document(content="10th century"), Document(content="9th century"), Document(content="9th")],
            [Document(content="rock music"), Document(content="dubstep"), Document(content="classical")],
            [Document(content="11th"), Document(content="the 11th"), Document(content="11th century")],
            [Document(content="Denmark"), Document(content="Norway"), Document(content="Iceland")],
            [
                Document(content="10th century"),
                Document(content="the first half of the 10th century"),
                Document(content="10th"),
                Document(content="10th"),
            ],
        ],
    )

    assert result == {
        "individual_scores": [1.0, 0.5, 0.3333333333333333, 0.5, 0.0, 1.0],
        "score": pytest.approx(0.555555555555555),
    }


def test_run_with_different_lengths():
    with pytest.raises(ValueError):
        evaluator = DocumentMRREvaluator()
        evaluator.run(
            ground_truth_documents=[[Document(content="Berlin")]],
            retrieved_documents=[[Document(content="Berlin")], [Document(content="London")]],
        )

    with pytest.raises(ValueError):
        evaluator = DocumentMRREvaluator()
        evaluator.run(
            ground_truth_documents=[[Document(content="Berlin")], [Document(content="Paris")]],
            retrieved_documents=[[Document(content="Berlin")]],
        )