pm4py.algo.organizational_mining.local_diagnostics package#

This file is part of PM4Py (More Info: https://pm4py.fit.fraunhofer.de).

PM4Py is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

PM4Py is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with PM4Py. If not, see <https://www.gnu.org/licenses/>.

Submodules#

pm4py.algo.organizational_mining.local_diagnostics.algorithm module#

This file is part of PM4Py (More Info: https://pm4py.fit.fraunhofer.de).

PM4Py is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

PM4Py is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with PM4Py. If not, see <https://www.gnu.org/licenses/>.

class pm4py.algo.organizational_mining.local_diagnostics.algorithm.Parameters(value)[source]#

Bases: Enum

An enumeration.

RESOURCE_KEY = 'pm4py:param:resource_key'#
ACTIVITY_KEY = 'pm4py:param:activity_key'#
GROUP_KEY = 'pm4py:param:group_key'#
class pm4py.algo.organizational_mining.local_diagnostics.algorithm.Outputs(value)[source]#

Bases: Enum

An enumeration.

GROUP_RELATIVE_FOCUS = 'group_relative_focus'#
GROUP_RELATIVE_STAKE = 'group_relative_stake'#
GROUP_COVERAGE = 'group_coverage'#
GROUP_MEMBER_CONTRIBUTION = 'group_member_contribution'#
pm4py.algo.organizational_mining.local_diagnostics.algorithm.apply_from_clustering_or_roles(log_obj: Union[DataFrame, EventLog], ja_clustering_or_roles: Dict[str, List[str]], parameters: Optional[Dict[Any, str]] = None) Dict[str, Any][source]#

Provides the local diagnostics for the organizational model starting from a log object and the results of the similar activities clustering / the roles detection algorithm.

The approach implemented is the one described in: Yang, Jing, et al. “OrgMining 2.0: A Novel Framework for Organizational Model Mining from Event Logs.” arXiv preprint arXiv:2011.12445 (2020).

Parameters#

log_obj

Log object

ja_clustering_or_roles

Result of the similar activities clustering / the roles detection algorithm

parameters

Parameters of the algorithm, including: - pm4py:param:resource_key => the resource attribute - pm4py:param:activity_key => the activity attribute - pm4py:param:group_key => the group

Returns#

Dictionary containing four keys:
  • group_relative_focus => relative focus metric

  • group_relative_stake => relative stake metric

  • group_coverage => group coverage metric

  • group_member_contribution => group member contribution metric

pm4py.algo.organizational_mining.local_diagnostics.algorithm.apply_from_group_attribute(log_obj: Union[DataFrame, EventLog], parameters: Optional[Dict[Any, str]] = None) Dict[str, Any][source]#

Provides the local diagnostics for the organizational model starting from a log object and considering the group specified by the attribute

The approach implemented is the one described in: Yang, Jing, et al. “OrgMining 2.0: A Novel Framework for Organizational Model Mining from Event Logs.” arXiv preprint arXiv:2011.12445 (2020).

Parameters#

log_obj

Log object

parameters

Parameters of the algorithm, including: - pm4py:param:resource_key => the resource attribute - pm4py:param:activity_key => the activity attribute - pm4py:param:group_key => the group

Returns#

Dictionary containing four keys:
  • group_relative_focus => relative focus metric

  • group_relative_stake => relative stake metric

  • group_coverage => group coverage metric

  • group_member_contribution => group member contribution metric