cortado

cortado

Cortado es una herramienta de minería de procesos dedicada al descubrimiento de procesos interactivos/incrementales.

Funcionalidad general

• Importar registros de eventos .xes y modelos de procesos iniciales .ptml
• Explore visualmente los registros de eventos con el explorador de variantes
• Descubra modelos de procesos iniciales a partir del comportamiento de procesos seleccionados por el usuario.
• Ampliar incrementalmente los modelos de procesos según el comportamiento del proceso seleccionado por el usuario.
• Edite manualmente los modelos de proceso en construcción en cualquier momento
• Exporte modelos de procesos descubiertos como archivos .ptml o .pnml
• Análisis de rendimiento temporal, tanto basado en modelos como independiente del modelo.

Descargas

Las compilaciones independientes para Windows 10/11 , Linux y macOS (solo Apple Silicon) están disponibles en la página de lanzamientos de GitHub.

Manifestación

Cortado_Demo.mp4

Estructura del repositorio

• src/ contiene el código fuente de Cortado
  • src/backend contiene el backend basado en Python de Cortado
  • src/frontend contiene la interfaz de Cortado que se basa en tecnologías web, es decir, una aplicación web Angular integrada en un ejecutable con Electron
• build_scripts/ contiene scripts para crear ejecutables independientes para los tres sistemas operativos principales: Windows, Linux y macOS. (Asegúrese de seguir correctamente las instrucciones de configuración antes de ejecutar los scripts de compilación).
• LICENSE.txt
• README.md
• CHANGELOG.md contiene un historial de lanzamientos de Cortado

Configuración

Instalar dependencias frontend

• Instale la última versión LTS de Node.js: 18.13.0 (https://nodejs.org/en/download/)
• Instale todos los paquetes requeridos por la interfaz
  • Vaya a src/frontend/
  • Ejecute npm install (este comando instala todas las dependencias enumeradas en src/frontend/package.json )
    Al crear Cortado como una aplicación independiente, queremos asegurarnos de que el paquete de aplicaciones solo incluya las dependencias necesarias. Como las dependencias de Angular se incluyen a través de un paquete web, no queremos incluirlas. Por lo tanto, las dependencias que solo se usan en el código base de Angular deben incluirse bajo la palabra clave devDependencies en el archivo package.json . Todas las dependencias que se utilizan en el código base de Electron deben incluirse bajo la palabra clave dependencies ).

Instalar dependencias de backend

• Instale Python 3.10.x (https://www.python.org/downloads/). Asegúrese de instalar una versión de 64 bits.
• Opcional (recomendado): instale Graphviz (requerido por PM4Py) y agréguelo a su RUTA, consulte https://graphviz.org/download/ y https://pm4py.fit.fraunhofer.de/static/assets/api/2.3 .0/instalar.html
• Opcional (recomendado): cree un entorno virtual (https://docs.python.org/3/library/venv.html) y actívelo
• Instale todos los paquetes requeridos por el backend
  • Vaya a src/backend/
  • Ejecute pip install -r requirements.txt

Ejecutar Cortado desde Código

Iniciar backend

• Vaya a src/backend/
• Ejecutar python main.py
• Para la recarga dinámica de archivos de código fuente, establezca la variable de entorno CORTADO_DEBUG en 1

Iniciar interfaz

• En un navegador web
  • Vaya a src/frontend/
  • Ejecute npm start para construir y ejecutar la interfaz de Cortado
  • Abra su navegador en http://localhost:4444/
• En una ventana dedicada del sistema operativo actual
  • Vaya a src/frontend/
  • Ejecute npm start para construir y ejecutar la interfaz de Cortado
  • Ejecute npm run electron-live-reload que inicia una ventana con Cortado

Crear Cortado: aplicación independiente

Para crear ejecutables a partir del código fuente, se deben convertir tanto el backend como el frontend. Usamos PyInstaller (https://pyinstaller.org/) para agrupar todos los archivos relacionados con el backend en un único ejecutable. Usamos Electron (https://www.electronjs.org/) para generar un ejecutable del Frontend.

En build_scripts/ hay scripts para que cada sistema operativo principal construya Cortado.

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

Tenga en cuenta que el sistema operativo debe coincidir con el script; de lo contrario, la compilación fallará. Por lo tanto, si está compilando Cortado para Windows, debe ejecutar el script correspondiente en una máquina con Windows.

Después de la ejecución exitosa del script de compilación, la compilación se ubica en src/frontend/

Contribuyendo

Linting y calidad del código

Para mantener una calidad de código consistente y un formato crucial, hemos integrado flujos de trabajo de Github junto con scripts npm para linting y corrección manual de errores de formato.

Flujo de trabajo de Github

Nuestro flujo de trabajo de Github juega un papel fundamental para garantizar la calidad del código. Cada vez que se envían cambios al repositorio, el flujo de trabajo activa automáticamente comprobaciones de linting utilizando varias herramientas. Tenemos trabajos separados dentro del flujo de trabajo para manejar TypeScript, HTML y SASS linting, así como también comprobaciones de formato de código Python. Si se detecta algún problema, el flujo de trabajo proporciona comentarios rápidos, lo que ayuda a los contribuyentes a abordar los problemas en las primeras etapas del ciclo de desarrollo.

scripts npm

Además del flujo de trabajo automatizado, hemos configurado scripts npm que facilitan el desarrollo local y las comprobaciones manuales de errores de formato.

• Para realizar un linting completo en archivos TypeScript, HTML y SASS, utilice: npm run lint

• Si se detectan problemas de linting, puede iniciar correcciones automáticas para archivos TypeScript y SASS usando: npm run lint-scripts-fix y npm run lint-styles-fix

• Para archivos HTML, puede revisar y solucionar manualmente los problemas identificados por el linter.

• También admitimos comprobaciones de formato de código Python mediante el comando: black --check .

Estas herramientas y scripts están diseñados para agilizar el proceso de desarrollo, garantizando que nuestro código base permanezca limpio, consistente y de alta calidad. Antes de enviar sus contribuciones, asegúrese de ejecutar estas comprobaciones localmente y solucionar cualquier problema para facilitar las revisiones e integración del código.

Publicaciones relevantes para Cortado

Publicación	Autores	Año
Análisis de procesos sanitarios con descubrimiento de procesos incremental: conocimientos prácticos de una aplicación del mundo real	Schuster, D., Benevento, E., Aloini, D., van der Aalst, WMP	2024
Definir y visualizar variantes de ejecución de procesos a partir de datos de eventos parcialmente ordenados	Schuster, D., Zerbato, F., van Zelst, SJ, van der Aalst, WMP	2024
Descubrimiento incremental de modelos de procesos utilizando fragmentos de seguimiento	Schuster, D., Föcking, N., van Zelst, SJ, van der Aalst, WMP	2023
Minería de patrones infijos frecuentes a partir de una variante de ejecución de procesos consciente de la concurrencia	Martini, M., Schuster, D., Wil MP van der Aalst	2023
Cortado: una herramienta de minería de procesos dedicada para el descubrimiento de procesos interactivos	Schuster, D., van Zelst, SJ, van der Aalst, WMP	2023
Consulta basada en flujo de control de ejecuciones de procesos a partir de datos de eventos parcialmente ordenados	Schuster, D., Martini, M., van Zelst, SJ, van der Aalst, WMP	2022
Comprobación de conformidad para fragmentos de seguimiento mediante alineaciones infijas y postfijas	Schuster, D., Föcking, N., van Zelst, SJ, van der Aalst, WMP	2022
Análisis de rendimiento temporal para modelos de procesos estructurados en bloques en Cortado	Schuster, D., Schade, L., van Zelst, SJ, van der Aalst, WMP	2022
Un marco genérico de ordenación de seguimiento para el descubrimiento de procesos incrementales	Schuster, D., Domnitsch, E., van Zelst, SJ, van der Aalst, WMP	2022
Congelar submodelos durante el descubrimiento de procesos incrementales	Schuster, D., van Zelst, SJ, van der Aalst, WMP	2021
Visualización de variantes de seguimiento a partir de datos de eventos parcialmente ordenados	Schuster, D., Schade, L., van Zelst, SJ, van der Aalst, WMP	2021
Cortado: una herramienta interactiva para el descubrimiento y modelado de procesos basados ​​en datos	Schuster, D., van Zelst, SJ, van der Aalst, WMP	2021
Descubrimiento incremental de modelos de procesos jerárquicos	Schuster, D., van Zelst, SJ, van der Aalst, WMP	2020

Citando a Cortado

Si utiliza o hace referencia a Cortado en un trabajo científico, cite a Cortado de la siguiente manera.

Schuster, D., van Zelst, SJ, van der Aalst, WMP (2023). Cortado: una herramienta de minería de procesos dedicada para el descubrimiento de procesos interactivos. SoftwareX vol. 22. Elsevier. https://doi.org/10.1016/j.softx.2023.101373.

Descargar cita https://www.sciencedirect.com/science/article/pii/S2352711023000699

DOI 10.1016/j.softx.2023.101373

Contacto

Si está interesado en Cortado, póngase en contacto si tiene alguna pregunta o solicitud personalizada por correo electrónico: [email protected]