panlabel 0.6.0

The universal annotation converter
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115

//! Diff report types and text formatting.

use serde::Serialize;
use std::fmt;

/// Dataset diff report.
#[derive(Clone, Debug, Default, Serialize)]
pub struct DiffReport {
    /// Image-level counts.
    pub images: DiffCounts,
    /// Category-level counts.
    pub categories: DiffCounts,
    /// Annotation-level counts.
    pub annotations: DiffAnnotationCounts,
    /// Optional detail section.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub detail: Option<DiffDetail>,
}

/// Shared / only-in-A / only-in-B counts.
#[derive(Clone, Debug, Default, Serialize)]
pub struct DiffCounts {
    pub shared: usize,
    pub only_in_a: usize,
    pub only_in_b: usize,
}

/// Annotation diff counts.
#[derive(Clone, Debug, Default, Serialize)]
pub struct DiffAnnotationCounts {
    pub shared: usize,
    pub only_in_a: usize,
    pub only_in_b: usize,
    pub modified: usize,
}

/// Optional detail section for text/json output.
#[derive(Clone, Debug, Default, Serialize)]
pub struct DiffDetail {
    pub images_only_in_a: Vec<String>,
    pub images_only_in_b: Vec<String>,
    pub modified_annotations: Vec<ModifiedAnnotation>,
    pub max_items: usize,
}

/// One modified annotation item.
#[derive(Clone, Debug, Serialize)]
pub struct ModifiedAnnotation {
    pub file_name: String,
    pub annotation_id: u64,
    pub reason: String,
}

impl fmt::Display for DiffReport {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        writeln!(
            f,
            "Images:      {} shared, {} only in A, {} only in B",
            self.images.shared, self.images.only_in_a, self.images.only_in_b
        )?;
        writeln!(
            f,
            "Categories:  {} shared, {} only in A, {} only in B",
            self.categories.shared, self.categories.only_in_a, self.categories.only_in_b
        )?;
        writeln!(
            f,
            "Annotations: {} shared, {} only in A, {} only in B",
            self.annotations.shared, self.annotations.only_in_a, self.annotations.only_in_b
        )?;
        writeln!(f, "             modified ({})", self.annotations.modified)?;

        if let Some(detail) = &self.detail {
            writeln!(f)?;
            writeln!(f, "Images only in A:")?;
            if detail.images_only_in_a.is_empty() {
                writeln!(f, "  - (none)")?;
            } else {
                for name in &detail.images_only_in_a {
                    writeln!(f, "  - {name}")?;
                }
            }

            writeln!(f)?;
            writeln!(f, "Images only in B:")?;
            if detail.images_only_in_b.is_empty() {
                writeln!(f, "  - (none)")?;
            } else {
                for name in &detail.images_only_in_b {
                    writeln!(f, "  - {name}")?;
                }
            }

            writeln!(f)?;
            writeln!(
                f,
                "Annotations modified (showing first {}):",
                detail.max_items
            )?;
            if detail.modified_annotations.is_empty() {
                writeln!(f, "  - (none)")?;
            } else {
                for item in &detail.modified_annotations {
                    writeln!(
                        f,
                        "  - {} ann#{}: {}",
                        item.file_name, item.annotation_id, item.reason
                    )?;
                }
            }
        }

        Ok(())
    }
}