cortado

Cortado

Cortado est un outil d'exploration de processus dédié à la découverte de processus interactifs/incrémentaux

Présentation des fonctionnalités

• Importer les journaux d'événements .xes et les modèles de processus initiaux .ptml
• Explorez visuellement les journaux d'événements avec l'explorateur de variantes
• Découvrez les modèles de processus initiaux à partir du comportement de processus sélectionné par l'utilisateur
• Étendre progressivement les modèles de processus en fonction du comportement de processus sélectionné par l'utilisateur
• Modifiez manuellement les modèles de processus en construction à tout moment
• Exporter les modèles de processus découverts sous forme de fichiers .ptml ou .pnml
• Analyse des performances temporelles, à la fois basée sur un modèle et indépendante du modèle

Téléchargements

Les versions autonomes pour Windows 10/11 , Linux et macOS (Apple Silicon uniquement) sont disponibles sur la page des versions de GitHub.

Démo

Cortado_Demo.mp4

Structure du référentiel

• src/ contient le code source de Cortado
  • src/backend contient le backend basé sur Python de Cortado
  • src/frontend contient le frontend de Cortado basé sur les technologies Web, c'est-à-dire une application Web Angular intégrée dans un exécutable avec Electron
• build_scripts/ contient des scripts pour créer les exécutables autonomes pour les trois principaux systèmes d'exploitation : Windows, Linux et macOS. (Veuillez vous assurer de suivre correctement les instructions d'installation avant d'exécuter les scripts de construction.)
• LICENSE.txt
• README.md
• CHANGELOG.md contient un historique des versions de Cortado

Installation

Installer les dépendances frontales

• Installez la dernière version LTS de Node.js : 18.13.0 (https://nodejs.org/en/download/)
• Installez tous les packages requis par le frontend
  • Accédez à src/frontend/
  • Exécutez npm install (cette commande installe toutes les dépendances répertoriées dans src/frontend/package.json )
    Lors de la création de Cortado en tant qu'application autonome, nous voulons nous assurer que le bundle d'applications inclut uniquement les dépendances requises. Comme les dépendances angulaires sont regroupées via webpack, nous ne souhaitons pas les inclure. Par conséquent, les dépendances qui ne sont utilisées que dans la base de code Angular doivent être incluses sous le mot-clé devDependencies dans le fichier package.json . Toutes les dépendances utilisées dans la base de code Electron doivent être incluses sous le mot-clé dependencies .)

Installer les dépendances backend

• Installez Python 3.10.x (https://www.python.org/downloads/). Assurez-vous d'installer une version 64 bits.
• Facultatif (recommandé) : installez Graphviz (requis par PM4Py) et ajoutez-le à votre PATH, voir https://graphviz.org/download/ et https://pm4py.fit.fraunhofer.de/static/assets/api/2.3 .0/install.html
• Facultatif (recommandé) : Créez un environnement virtuel (https://docs.python.org/3/library/venv.html) et activez-le
• Installez tous les packages requis par le backend
  • Accédez à src/backend/
  • Exécutez pip install -r requirements.txt

Exécuter Cortado à partir du code

Démarrer le back-end

• Accédez à src/backend/
• Exécutez python main.py
• Pour le rechargement dynamique des fichiers de code source, définissez la variable d'environnement CORTADO_DEBUG sur 1

Démarrer l'interface utilisateur

• Dans un navigateur Web
  • Accédez à src/frontend/
  • Exécutez npm start pour créer et exécuter l'interface de Cortado
  • Ouvrez votre navigateur sur http://localhost:4444/
• Dans une fenêtre dédiée du système d'exploitation actuel
  • Accédez à src/frontend/
  • Exécutez npm start pour créer et exécuter l'interface de Cortado
  • Exécutez npm run electron-live-reload qui démarre une fenêtre avec Cortado

Construire Cortado – Application autonome

Pour créer des exécutables à partir du code source, le backend et le frontend doivent être convertis. Nous utilisons PyInstaller (https://pyinstaller.org/) pour regrouper tous les fichiers liés au backend dans un seul exécutable. Nous utilisons Electron (https://www.electronjs.org/) pour générer un exécutable du Frontend.

Dans build_scripts/ il existe des scripts pour chaque système d'exploitation majeur permettant de créer Cortado.

• Windows build_scripts/build_cortado_windows.ps1
• MacOS build_scripts/build_cortado_macos.sh
• Linux build_scripts/build_cortado_linux.sh

Notez que le système d'exploitation doit correspondre au script, sinon la construction échouera. Ainsi, si vous créez Cortado pour Windows, vous devez exécuter le script correspondant sur une machine Windows.

Après l'exécution réussie du script de build, la build se trouve dans src/frontend/

Contribuer

Pelucheux et qualité du code

Pour maintenir une qualité de code cohérente et un formatage crucial, nous avons intégré les flux de travail Github ainsi que des scripts npm pour le peluchage et la correction manuelle des erreurs de formatage.

Flux de travail Github

Notre workflow Github joue un rôle central pour garantir la qualité du code. Chaque fois que des modifications sont transférées vers le référentiel, le flux de travail déclenche automatiquement des vérifications de peluchage à l'aide de divers outils. Nous avons des tâches distinctes dans le flux de travail pour gérer le peluchage TypeScript, HTML et SASS, ainsi que les vérifications de formatage du code Python. Si des problèmes sont détectés, le flux de travail fournit un retour rapide, aidant les contributeurs à résoudre les problèmes dès le début du cycle de développement.

Scripts npm

En plus du flux de travail automatisé, nous avons mis en place des scripts npm qui facilitent le développement local et la vérification manuelle des erreurs de formatage.

• Pour effectuer un peluchage complet sur les fichiers TypeScript, HTML et SASS, utilisez : npm run lint

• Si des problèmes de peluchage sont détectés, vous pouvez lancer des correctifs automatiques pour les fichiers TypeScript et SASS en utilisant : npm run lint-scripts-fix et npm run lint-styles-fix

• Pour les fichiers HTML, vous pouvez examiner et résoudre manuellement les problèmes identifiés par le linter.

• Nous prenons également en charge les vérifications de formatage du code Python à l'aide de la commande : black --check .

Ces outils et scripts sont conçus pour rationaliser le processus de développement, garantissant que notre base de code reste propre, cohérente et de haute qualité. Avant de soumettre vos contributions, assurez-vous d'effectuer ces vérifications localement et de résoudre tout problème afin de faciliter les révisions et l'intégration du code.

Publications pertinentes pour Cortado

Publication	Auteurs	Année
Analyser les processus de soins de santé avec la découverte incrémentielle des processus : informations pratiques issues d'une application réelle	Schuster, D., Benevento, E., Aloini, D., van der Aalst, WMP	2024
Définir et visualiser des variantes d'exécution de processus à partir de données d'événements partiellement ordonnées	Schuster, D., Zerbato, F., van Zelst, SJ, van der Aalst, WMP	2024
Découverte incrémentielle de modèles de processus à l'aide de fragments de trace	Schuster, D., Föcking, N., van Zelst, SJ, van der Aalst, WMP	2023
Exploration de modèles d'infixes fréquents à partir d'une variante d'exécution de processus prenant en compte la concurrence	Martini, M., Schuster, D., Wil MP van der Aalst	2023
Cortado : un outil d'exploration de processus dédié pour la découverte interactive de processus	Schuster, D., van Zelst, SJ, van der Aalst, WMP	2023
Interrogation basée sur le flux de contrôle des exécutions de processus à partir de données d'événements partiellement ordonnées	Schuster, D., Martini, M., van Zelst, SJ, van der Aalst, WMP	2022
Vérification de la conformité des fragments de trace à l'aide des alignements Infix et Postfix	Schuster, D., Föcking, N., van Zelst, SJ, van der Aalst, WMP	2022
Analyse des performances temporelles pour les modèles de processus structurés en blocs dans Cortado	Schuster, D., Schade, L., van Zelst, SJ, van der Aalst, WMP	2022
Un cadre générique de commande de traces pour la découverte incrémentielle de processus	Schuster, D., Domnitsch, E., van Zelst, SJ, van der Aalst, WMP	2022
Gel des sous-modèles lors de la découverte incrémentielle de processus	Schuster, D., van Zelst, SJ, van der Aalst, WMP	2021
Visualisation des variantes de trace à partir de données d'événements partiellement ordonnées	Schuster, D., Schade, L., van Zelst, SJ, van der Aalst, WMP	2021
Cortado : un outil interactif pour la découverte et la modélisation de processus basés sur les données	Schuster, D., van Zelst, SJ, van der Aalst, WMP	2021
Découverte incrémentielle de modèles de processus hiérarchiques	Schuster, D., van Zelst, SJ, van der Aalst, WMP	2020

Citer Cortado

Si vous utilisez ou faites référence à Cortado dans des travaux scientifiques, veuillez citer Cortado comme suit.

Schuster, D., van Zelst, SJ, van der Aalst, WMP (2023). Cortado : un outil d'exploration de processus dédié pour la découverte interactive de processus. LogicielX Vol. 22. Elsevier. https://doi.org/10.1016/j.softx.2023.101373.

Télécharger la citation https://www.sciencedirect.com/science/article/pii/S2352711023000699

DOI 10.1016/j.softx.2023.101373

Contact

Si vous êtes intéressé par Cortado, contactez-nous si vous avez des questions ou une demande personnalisée via Mail - [email protected]