# mstabc/cc_node2vec architecture

> Architecture diagram of the GitHub repository mstabc/cc_node2vec, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mstabc/cc_node2vec
- Repository: https://github.com/mstabc/cc_node2vec

## Overview

##### Project type and purpose
- This is a command-line, research‐oriented Python pipeline for conformance checking of process models. It ingests Petri net definitions and event logs (.pnml and .xes), constructs graph representations, derives trace embeddings using random walks (Node2Vec), computes distance metrics, performs PCA for visualization, and writes out results for static and context-aware modes.
- Key indicators: a single “src” folder with Python modules, a “data” folder for input PNML and XES, a “results” folder for outputs, and README instructions on running “main.py case” or “main.py mined.”

##### File structure
- Top-level directories and files:
- data/ — contains subfolders per dataset, each with multiple .pnml files
- src/ — code modules: main.py, petri_builder.py, graph_encoding.py, random_walks.py, distance_cal.py, utils.py
- results/ — output visualizations and CSVs
- mined_results/ — (presumably intermediate or alternate outputs for static mode)
- Architectural patterns: a linear pipeline architecture. main.py orchestrates reading data → building Petri nets → generating graphs → encoding via random walks → embedding comparison → output.
- Configuration/deployment: no web server or database; invoked purely as a CLI script.

##### README for additional insights
- Describes two modes: “case” (context-aware) and “mined” (static).
- Highlights output artifacts: PCA plots, CSV distance tables.
- Mentions core functions and reference to Petri net and Node2Vec‐based GCN research.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Input Layer
    Input["Input Layer\n(data/ PNML & XES)"]:::input
    click Input "https://github.com/mstabc/cc_node2vec/tree/main/data/"

    %% Pipeline Orchestration
    Main["Pipeline Orchestration\n(src/main.py)"]:::control
    click Main "https://github.com/mstabc/cc_node2vec/blob/main/src/main.py"

    %% Mode Decision
    Decision{"Mode?\ncase or mined"}:::decision

    %% Pipeline Modules
    Petri["Petri Net Construction\n(src/petri_builder.py)"]:::module
    click Petri "https://github.com/mstabc/cc_node2vec/blob/main/src/petri_builder.py"

    Random["Graph Generation\n(src/random_walks.py)"]:::module
    click Random "https://github.com/mstabc/cc_node2vec/blob/main/src/random_walks.py"

    Encode["Graph Encoding\n(src/graph_encoding.py)"]:::module
    click Encode "https://github.com/mstabc/cc_node2vec/blob/main/src/graph_encoding.py"

    Dist["Distance Computation\n(src/distance_cal.py)"]:::module
    click Dist "https://github.com/mstabc/cc_node2vec/blob/main/src/distance_cal.py"

    Vis["Visualization & Export\n(src/utils.py)"]:::module
    click Vis "https://github.com/mstabc/cc_node2vec/blob/main/src/utils.py"

    %% Outputs
    CaseOut["Context-aware Outputs\n(results/)"]:::output
    click CaseOut "https://github.com/mstabc/cc_node2vec/tree/main/results/"

    StaticOut["Static-mode Outputs\n(mined_results/)"]:::output
    click StaticOut "https://github.com/mstabc/cc_node2vec/tree/main/mined_results/"

    %% Flow
    Input --> Main
    Main --> Decision
    Decision -->|case| Petri
    Decision -->|mined| Petri
    Petri --> Random
    Random --> Encode
    Encode --> Dist
    Dist --> Vis
    Vis --> CaseOut
    Vis --> StaticOut

    %% Styles
    classDef input fill:#D6EAF8,stroke:#2980B9,color:#154360;
    classDef control fill:#FCF3CF,stroke:#B9770E,color:#7D6608;
    classDef decision fill:#FADBD8,stroke:#C0392B,color:#641E16,shape:diamond;
    classDef module fill:#D5F5E3,stroke:#27AE60,color:#145A32;
    classDef output fill:#F9E79F,stroke:#B7950B,color:#7D6608;
```
