ebi 0.3.14

A stochastic process mining utility and library
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
116
117
118

use crate::{
    ebi_framework::{
        ebi_command::EbiCommand,
        ebi_input::EbiInputType,
        ebi_output::{EbiOutput, EbiOutputType},
        ebi_trait::EbiTrait,
    },
    ebi_info,
    ebi_traits::ebi_trait_event_log_trace_attributes::EbiTraitEventLogTraceAttributes,
    techniques::association::Associations,
};
use ebi_objects::anyhow::{Context, anyhow};
use std::io::Write;

pub const DEFAULT_NUMBER_OF_SAMPLES: usize = 500;

pub const EBI_ASSOCIATION: EbiCommand = EbiCommand::Group {
    name_short: "asso",
    name_long: Some("association"),
    explanation_short: "Compute associations between a process and other aspects.",
    explanation_long: None,
    children: &[&EBI_ASSOCIATION_ATTRIBUTE, &EBI_ASSOCIATION_ATTRIBUTES],
};

pub const EBI_ASSOCIATION_ATTRIBUTE: EbiCommand = EbiCommand::Command {
    name_short: "att",
    name_long: Some("trace-attribute"),
    explanation_short: "Compute the association between the process and a trace attribute.",
    explanation_long: None,
    latex_link: Some("\\cite{DBLP:journals/tkde/LeemansMPH23}"),
    cli_command: None,
    exact_arithmetic: true,
    input_types: &[
        &[&EbiInputType::Trait(EbiTrait::EventLogTraceAttributes)],
        &[&EbiInputType::String(None, None)],
        &[&EbiInputType::Usize(
            Some(1),
            None,
            Some(DEFAULT_NUMBER_OF_SAMPLES),
        )],
    ],
    input_names: &["FILE", "ATTRIBUTE", "SAMPLES"],
    input_helps: &[
        "The event log for which association is to be computed.",
        concat!(
            concat!(
                "The trace attribute for which association is to be computed. The trace attributes of a log can be found using `Ebi ",
                ebi_info!()
            ),
            "`."
        ),
        "The number of samples.",
    ],
    execute: |mut inputs, _| {
        let event_log = inputs
            .remove(0)
            .to_type::<dyn EbiTraitEventLogTraceAttributes>()?;
        let attribute_label = inputs.remove(0).to_type::<String>()?;
        let number_of_samples = inputs.remove(0).to_type::<usize>()?;

        let attribute = event_log
            .attribute_key()
            .label_to_attribute(&attribute_label)
            .ok_or_else(|| anyhow!("the log does not contain the attribute {}", attribute_label))?;

        let ass = event_log
            .association(*number_of_samples, attribute)
            .with_context(|| format!("attribute {}", attribute))?;

        Ok(EbiOutput::ContainsRoot(ass))
    },
    output_type: &EbiOutputType::ContainsRoot,
};

pub const EBI_ASSOCIATION_ATTRIBUTES: EbiCommand = EbiCommand::Command {
    name_short: "atts",
    name_long: Some("all-trace-attributes"),
    explanation_short: "Compute the association between the process and trace attributes.",
    explanation_long: None,
    latex_link: Some("\\cite{DBLP:journals/tkde/LeemansMPH23}"),
    cli_command: None,
    exact_arithmetic: true,
    input_types: &[
        &[&EbiInputType::Trait(EbiTrait::EventLogTraceAttributes)],
        &[&EbiInputType::Usize(
            Some(1),
            None,
            Some(DEFAULT_NUMBER_OF_SAMPLES),
        )],
    ],
    input_names: &["FILE", "SAMPLES"],
    input_helps: &[
        "The event log for which association is to be computed.",
        "The number of samples taken.",
    ],
    execute: |mut inputs, _| {
        let event_log = inputs
            .remove(0)
            .to_type::<dyn EbiTraitEventLogTraceAttributes>()?;
        let number_of_samples = inputs.remove(0).to_type::<usize>()?;

        let result = event_log.associations(*number_of_samples);

        let mut f = vec![];
        for (x, y) in result {
            let y = y?;
            writeln!(
                f,
                "Trace atribute `{}` has an association of approximately {}. Exact value: {:?}",
                x,
                &y.approximate(),
                &y
            )?;
        }
        Ok(EbiOutput::String(String::from_utf8(f).unwrap()))
    },
    output_type: &EbiOutputType::String,
};