PM4PY - 事件过滤的简化接口的使用

1. log = pm4py.filter_end_activities(log, admitted_end_activities)
   描述：在提供的列表中过滤具有结束活动的案例。
   
   参数：
   log ：log对象
   admitted_end_activities：指定的结束活动列表
   返回：过滤后的log对象

2. log = pm4py.filter_start_activities(log, admitted_start_activities)
   描述：在提供的列表中过滤具有开始活动的案例。
   
   参数：
   log ：log对象
   admitted_start_activities：指定的开始活动列表
   返回：过滤后的log对象

3. log = pm4py.filter_time_range(log, dt1, dt2, mode='events')
   描述：根据指定的时间范围过滤。
   
   参数：
   log ：log对象
   dt1：区间左极值
   dt2：区间右极值
   mode：过滤模式（events, traces_contained, traces_intersecting），默认为events。如果过滤模式为，events：任何在时间范围内的事件都会被保留；traces_contained：保留完全包含在时间范围内的traces（即一个case从开始到结束的时间跨度在指定时间范围内则保留）；traces_intersecting：保留与时间范围相交的traces（即一个case从开始到结束的时间跨度只要与指定时间范围有交叉则保留）。
   返回：过滤后的log对象

4. log = pm4py.filter_directly_follows_relation(log, relations, retain=True)
   描述：保留包含任何指定“直接跟随”关系的traces。例如，指定relations == [(‘a’,’b’),(‘a’,’c’)]，log为[{a,b,c},{a,c,b},{a,d,b}]，返回log对象包含[{a,b,c},{a,c,b}]
   
   参数：
   log ：log对象
   relations：保留/不保留的活动名称的列表
   retain：如果为True则保留，False则剔除。
   返回：过滤后的log对象

5. log = pm4py.filter_eventually_follows_relation(log, relations, retain=True)
   描述：保留包含任何指定的“最终遵循”关系的traces。例如，指定relations == [(‘a’,’b’),(‘a’,’c’)]，log为 [{a,b,c},{a,c,b},{a,d,b}]，返回log对象包含[{a,b,c},{a,c,b},{a,d,b}]
   
   参数：
   log ：log对象
   relations：保留/不保留的活动名称的列表
   retain：如果为True则保留，False则剔除。
   返回：过滤后的log对象

6. log = pm4py.filter_variants(log, admitted_variants, retain=True)
   描述：根据指定的变体过滤日志。
   
   参数：
   log ：log对象
   admitted_variants：要过滤的变体集合列表。应将变体指定为活动名称列表，如：[‘a’,‘b’,‘c’]或[‘a,b,c’]。传的参数必须是个列表，里面包含活动名称列表，如：[[‘a,b,c’], [‘a,c’]]
   retain：如果为True则保留，False则剔除。
   返回：过滤后的log对象

7. log = pm4py.filter_case_size(log, min_size, max_size)
   描述：根据指定的case大小过滤。
   
   参数：
   log ：log对象
   min_size：case包含的事件数量最小值
   max_size：case包含的时间数量最大值，若两值相等则保留固定大小的case。
   返回：过滤后的log对象

8. log = pm4py.filter_between(log, act1, act2)
   描述：查找从日志中具有活动“act1”的事件到具有活动“act2”的事件的所有子case，并返回仅包含它们的日志。
   
   例如：
   Log
   A B C D E F
   A B E F C
   A B F C B C B E F C

   act1 = B
   act2 = C

   Returned sub-cases:
   B C (from the first case)
   B E F C (from the second case)
   B F C (from the third case)
   B C (from the third case)
   B E F C (from the third case)
   
   参数：
   log ：log对象
   act1：子case的起始
   act2：子case的结束
   返回：过滤后的log对象

*若对本文有疑问（例如：笔记中知识点或表达有误），欢迎指出，共同学习进步。