# processmining-in-logistics/psm architecture

> Architecture diagram of the GitHub repository processmining-in-logistics/psm, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/processmining-in-logistics/psm
- Repository: https://github.com/processmining-in-logistics/psm

## Overview

Performance Spectrum Miner (PSM) transforms CSV/XES event logs into a persisted performance-spectrum representation, then opens it for interactive exploration. Its documented analysis includes performance patterns and performance-based feature export; the repository also contains inter-case predictive-feature generation and conveyor simulation/ML experiments. The main workflow is documented in the README; some implementation links are omitted because their source was not sampled.

Main entry points: [`perf_spec/src/main/scala/org/processmining/scala/viewers/spectrum/builder`](https://github.com/processmining-in-logistics/psm/tree/master/perf_spec/src/main/scala/org/processmining/scala/viewers/spectrum/builder) (Spectrum transformation), [`perf_spec/src/main/scala/org/processmining/scala/log/common/enhancment/segments/parallel`](https://github.com/processmining-in-logistics/psm/tree/master/perf_spec/src/main/scala/org/processmining/scala/log/common/enhancment/segments/parallel) (Segment processing), [`perf_spec/src/main/scala/org/processmining/scala/viewers/spectrum/model/FileStorage.scala`](https://github.com/processmining-in-logistics/psm/blob/master/perf_spec/src/main/scala/org/processmining/scala/viewers/spectrum/model/FileStorage.scala) (Spectrum storage), [`perf_spec/src/main/scala/org/processmining/scala/log/common/unified/log/parallel/UnifiedEventLog.scala`](https://github.com/processmining-in-logistics/psm/blob/master/perf_spec/src/main/scala/org/processmining/scala/log/common/unified/log/parallel/UnifiedEventLog.scala) (Unified event log)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingest["Log ingestion"]
  node_csvread["CSV reader<br/>[CsvReader.scala]"]
  node_xesread["XES reader"]
  node_unifiedevent["Unified events<br/>[UnifiedEvent.scala]"]
  node_unifiedlog["Unified event log"]
end

subgraph group_spectrum["Spectrum processing"]
  node_transform["Spectrum transformation"]
  node_segment["Segment processing"]
  node_bins["Spectrum bins<br/>[BinsImpl.scala]"]
  node_segmentdata["Segment data<br/>[SegmentImpl.scala]"]
  node_filenames["Spectrum file layout"]
  node_storage[("Spectrum storage<br/>[FileStorage.scala]")]
end

subgraph group_analysis["Analysis and UI"]
  node_datasource["Spectrum data access"]
  node_ui["Spectrum viewer"]
  node_patterns["Pattern detection"]
  node_featureexport["Feature dataset export"]
end

subgraph group_prediction["Predictive features"]
  node_intercase["Inter-case encoding"]
  node_sample["Training samples<br/>[Sample.scala]"]
  node_datasetprep["Dataset preparation"]
end

subgraph group_simulation["Simulation and ML"]
  node_conveyor["Conveyor simulation"]
  node_equipment["Equipment model"]
  node_sorter["Sorter<br/>[Sorter.scala]"]
  node_ml["Prediction experiments<br/>[experiment.py]"]
  node_mlutils["ML data utilities<br/>[my_utils.py]"]
end

node_user(("Analyst"))
node_eventlog["CSV / XES log"]

node_user -->|"selects"| node_eventlog
node_eventlog -->|"transforms"| node_transform
node_transform -->|"persists spectrum"| node_storage
node_storage -.->|"opens data"| node_datasource
node_datasource -.->|"supplies spectrum"| node_ui
node_user -->|"explores"| node_ui
node_ui -.->|"reveals patterns"| node_patterns
node_transform -.->|"processes segments"| node_segment
node_segment -.->|"builds bins"| node_bins
node_segment -.->|"builds segments"| node_segmentdata
node_storage -->|"resolves files"| node_filenames
node_user -->|"exports features"| node_featureexport
node_eventlog -.->|"reads CSV"| node_csvread
node_eventlog -.->|"reads XES"| node_xesread
node_csvread -->|"parses events"| node_unifiedlog
node_unifiedevent -->|"forms log events"| node_unifiedlog
node_unifiedlog -->|"encodes prefixes"| node_intercase
node_intercase -.->|"creates samples"| node_sample
node_sample -->|"normalizes and splits"| node_datasetprep
node_conveyor -->|"moves equipment"| node_equipment
node_conveyor -->|"dispatches sorter"| node_sorter
node_ml -->|"loads and saves"| node_mlutils
node_datasetprep -.->|"provides training data"| node_ml

click node_csvread "https://github.com/processmining-in-logistics/psm/blob/master/perf_spec/src/main/scala/org/processmining/scala/log/common/csv/parallel/CsvReader.scala"
click node_xesread "https://github.com/processmining-in-logistics/psm/tree/master/perf_spec/src/main/scala/org/processmining/scala/log/common/xes/parallel"
click node_unifiedevent "https://github.com/processmining-in-logistics/psm/blob/master/perf_spec/src/main/scala/org/processmining/scala/log/common/unified/event/UnifiedEvent.scala"
click node_unifiedlog "https://github.com/processmining-in-logistics/psm/blob/master/perf_spec/src/main/scala/org/processmining/scala/log/common/unified/log/parallel/UnifiedEventLog.scala"
click node_transform "https://github.com/processmining-in-logistics/psm/tree/master/perf_spec/src/main/scala/org/processmining/scala/viewers/spectrum/builder"
click node_segment "https://github.com/processmining-in-logistics/psm/tree/master/perf_spec/src/main/scala/org/processmining/scala/log/common/enhancment/segments/parallel"
click node_bins "https://github.com/processmining-in-logistics/psm/blob/master/perf_spec/src/main/scala/org/processmining/scala/log/common/enhancment/segments/common/BinsImpl.scala"
click node_segmentdata "https://github.com/processmining-in-logistics/psm/blob/master/perf_spec/src/main/scala/org/processmining/scala/log/common/enhancment/segments/common/SegmentImpl.scala"
click node_filenames "https://github.com/processmining-in-logistics/psm/blob/master/perf_spec/src/main/scala/org/processmining/scala/log/common/enhancment/segments/common/SpectrumFileNames.scala"
click node_storage "https://github.com/processmining-in-logistics/psm/blob/master/perf_spec/src/main/scala/org/processmining/scala/viewers/spectrum/model/FileStorage.scala"
click node_datasource "https://github.com/processmining-in-logistics/psm/blob/master/perf_spec/src/main/scala/org/processmining/scala/viewers/spectrum/model/AbstractDataSource.scala"
click node_ui "https://github.com/processmining-in-logistics/psm/tree/master/perf_spec/src/main/scala/org/processmining/scala/viewers/spectrum/view"
click node_patterns "https://github.com/processmining-in-logistics/psm/blob/master/perf_spec/src/main/scala/org/processmining/scala/viewers/spectrum/patterns/OneSegmentPatternsDetector.scala"
click node_featureexport "https://github.com/processmining-in-logistics/psm/blob/master/perf_spec/src/main/scala/org/processmining/scala/viewers/spectrum/features/SpectrumToDataset.scala"
click node_intercase "https://github.com/processmining-in-logistics/psm/blob/master/ppm/src/main/scala/org/processmining/scala/intercase/DdeInterCaseFeatureEncoder.scala"
click node_sample "https://github.com/processmining-in-logistics/psm/blob/master/ppm/src/main/scala/org/processmining/scala/intercase/Sample.scala"
click node_datasetprep "https://github.com/processmining-in-logistics/psm/blob/master/ppm/src/main/scala/org/processmining/scala/intercase/BaseDdeInterCaseFeatureEncodingSession.scala"
click node_conveyor "https://github.com/processmining-in-logistics/psm/blob/master/ppm/src/main/scala/org/processmining/scala/sim/conveyors/impl/AbstractEngine.scala"
click node_equipment "https://github.com/processmining-in-logistics/psm/blob/master/ppm/src/main/scala/org/processmining/scala/sim/conveyors/api/AbstractEquipment.scala"
click node_sorter "https://github.com/processmining-in-logistics/psm/blob/master/ppm/src/main/scala/org/processmining/scala/sim/conveyors/impl/Sorter.scala"
click node_ml "https://github.com/processmining-in-logistics/psm/blob/master/ppm/ML/experiment.py"
click node_mlutils "https://github.com/processmining-in-logistics/psm/blob/master/ppm/ML/my_utils.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_csvread,node_xesread,node_unifiedevent,node_unifiedlog toneBlue
class node_transform,node_segment,node_bins,node_segmentdata,node_filenames,node_storage toneAmber
class node_datasource,node_ui,node_patterns,node_featureexport toneMint
class node_intercase,node_sample,node_datasetprep toneRose
class node_conveyor,node_equipment,node_sorter,node_ml,node_mlutils,node_user,node_eventlog toneIndigo
```

## Components

### Log ingestion

- [CSV reader](https://github.com/processmining-in-logistics/psm/blob/master/perf_spec/src/main/scala/org/processmining/scala/log/common/csv/parallel/CsvReader.scala): `perf_spec/src/main/scala/org/processmining/scala/log/common/csv/parallel/CsvReader.scala`
- [XES reader](https://github.com/processmining-in-logistics/psm/tree/master/perf_spec/src/main/scala/org/processmining/scala/log/common/xes/parallel): `perf_spec/src/main/scala/org/processmining/scala/log/common/xes/parallel`
- [Unified events](https://github.com/processmining-in-logistics/psm/blob/master/perf_spec/src/main/scala/org/processmining/scala/log/common/unified/event/UnifiedEvent.scala): `perf_spec/src/main/scala/org/processmining/scala/log/common/unified/event/UnifiedEvent.scala`
- [Unified event log](https://github.com/processmining-in-logistics/psm/blob/master/perf_spec/src/main/scala/org/processmining/scala/log/common/unified/log/parallel/UnifiedEventLog.scala): `perf_spec/src/main/scala/org/processmining/scala/log/common/unified/log/parallel/UnifiedEventLog.scala`

### Spectrum processing

- [Spectrum transformation](https://github.com/processmining-in-logistics/psm/tree/master/perf_spec/src/main/scala/org/processmining/scala/viewers/spectrum/builder): `perf_spec/src/main/scala/org/processmining/scala/viewers/spectrum/builder`
- [Segment processing](https://github.com/processmining-in-logistics/psm/tree/master/perf_spec/src/main/scala/org/processmining/scala/log/common/enhancment/segments/parallel): `perf_spec/src/main/scala/org/processmining/scala/log/common/enhancment/segments/parallel`
- [Spectrum bins](https://github.com/processmining-in-logistics/psm/blob/master/perf_spec/src/main/scala/org/processmining/scala/log/common/enhancment/segments/common/BinsImpl.scala): `perf_spec/src/main/scala/org/processmining/scala/log/common/enhancment/segments/common/BinsImpl.scala`
- [Segment data](https://github.com/processmining-in-logistics/psm/blob/master/perf_spec/src/main/scala/org/processmining/scala/log/common/enhancment/segments/common/SegmentImpl.scala): `perf_spec/src/main/scala/org/processmining/scala/log/common/enhancment/segments/common/SegmentImpl.scala`
- [Spectrum file layout](https://github.com/processmining-in-logistics/psm/blob/master/perf_spec/src/main/scala/org/processmining/scala/log/common/enhancment/segments/common/SpectrumFileNames.scala): `perf_spec/src/main/scala/org/processmining/scala/log/common/enhancment/segments/common/SpectrumFileNames.scala`
- [Spectrum storage](https://github.com/processmining-in-logistics/psm/blob/master/perf_spec/src/main/scala/org/processmining/scala/viewers/spectrum/model/FileStorage.scala): `perf_spec/src/main/scala/org/processmining/scala/viewers/spectrum/model/FileStorage.scala`

### Analysis and UI

- [Spectrum data access](https://github.com/processmining-in-logistics/psm/blob/master/perf_spec/src/main/scala/org/processmining/scala/viewers/spectrum/model/AbstractDataSource.scala): `perf_spec/src/main/scala/org/processmining/scala/viewers/spectrum/model/AbstractDataSource.scala`
- [Spectrum viewer](https://github.com/processmining-in-logistics/psm/tree/master/perf_spec/src/main/scala/org/processmining/scala/viewers/spectrum/view): `perf_spec/src/main/scala/org/processmining/scala/viewers/spectrum/view`
- [Pattern detection](https://github.com/processmining-in-logistics/psm/blob/master/perf_spec/src/main/scala/org/processmining/scala/viewers/spectrum/patterns/OneSegmentPatternsDetector.scala): `perf_spec/src/main/scala/org/processmining/scala/viewers/spectrum/patterns/OneSegmentPatternsDetector.scala`
- [Feature dataset export](https://github.com/processmining-in-logistics/psm/blob/master/perf_spec/src/main/scala/org/processmining/scala/viewers/spectrum/features/SpectrumToDataset.scala): `perf_spec/src/main/scala/org/processmining/scala/viewers/spectrum/features/SpectrumToDataset.scala`

### Predictive features

- [Inter-case encoding](https://github.com/processmining-in-logistics/psm/blob/master/ppm/src/main/scala/org/processmining/scala/intercase/DdeInterCaseFeatureEncoder.scala): `ppm/src/main/scala/org/processmining/scala/intercase/DdeInterCaseFeatureEncoder.scala`
- [Training samples](https://github.com/processmining-in-logistics/psm/blob/master/ppm/src/main/scala/org/processmining/scala/intercase/Sample.scala): `ppm/src/main/scala/org/processmining/scala/intercase/Sample.scala`
- [Dataset preparation](https://github.com/processmining-in-logistics/psm/blob/master/ppm/src/main/scala/org/processmining/scala/intercase/BaseDdeInterCaseFeatureEncodingSession.scala): `ppm/src/main/scala/org/processmining/scala/intercase/BaseDdeInterCaseFeatureEncodingSession.scala`

### Simulation and ML

- [Conveyor simulation](https://github.com/processmining-in-logistics/psm/blob/master/ppm/src/main/scala/org/processmining/scala/sim/conveyors/impl/AbstractEngine.scala): `ppm/src/main/scala/org/processmining/scala/sim/conveyors/impl/AbstractEngine.scala`
- [Equipment model](https://github.com/processmining-in-logistics/psm/blob/master/ppm/src/main/scala/org/processmining/scala/sim/conveyors/api/AbstractEquipment.scala): `ppm/src/main/scala/org/processmining/scala/sim/conveyors/api/AbstractEquipment.scala`
- [Sorter](https://github.com/processmining-in-logistics/psm/blob/master/ppm/src/main/scala/org/processmining/scala/sim/conveyors/impl/Sorter.scala): `ppm/src/main/scala/org/processmining/scala/sim/conveyors/impl/Sorter.scala`
- [Prediction experiments](https://github.com/processmining-in-logistics/psm/blob/master/ppm/ML/experiment.py): `ppm/ML/experiment.py`
- [ML data utilities](https://github.com/processmining-in-logistics/psm/blob/master/ppm/ML/my_utils.py): `ppm/ML/my_utils.py`

### Other components

- **Analyst**
- **CSV / XES log**

## Connections

- Analyst → CSV / XES log: selects (evidence: `README.md`)
- CSV / XES log → Spectrum transformation: transforms (evidence: `README.md`)
- Spectrum transformation → Spectrum storage: persists spectrum (evidence: `README.md`)
- Spectrum storage → Spectrum data access: opens data
- Spectrum data access → Spectrum viewer: supplies spectrum (evidence: `perf_spec/src/main/scala/org/processmining/scala/viewers/spectrum/view/TimeDiffController.scala`)
- Analyst → Spectrum viewer: explores (evidence: `README.md`)
- Spectrum viewer → Pattern detection: reveals patterns (evidence: `perf_spec/src/main/scala/org/processmining/scala/viewers/spectrum/view/TimeDiffController.scala`)
- Spectrum transformation → Segment processing: processes segments
- Segment processing → Spectrum bins: builds bins
- Segment processing → Segment data: builds segments
- Spectrum storage → Spectrum file layout: resolves files (evidence: `perf_spec/src/main/scala/org/processmining/scala/viewers/spectrum/model/FileStorage.scala`)
- Analyst → Feature dataset export: exports features (evidence: `README.md`)
- CSV / XES log → CSV reader: reads CSV
- CSV / XES log → XES reader: reads XES
- CSV reader → Unified event log: parses events (evidence: `ppm/src/main/scala/org/processmining/scala/sim/conveyors/experiments/SimLogDdeInterCaseFeatureEncodingSession.scala`)
- Unified events → Unified event log: forms log events (evidence: `ppm/src/main/scala/org/processmining/scala/sim/conveyors/experiments/SimLogDdeInterCaseFeatureEncodingSession.scala`)
- Unified event log → Inter-case encoding: encodes prefixes (evidence: `ppm/src/main/scala/org/processmining/scala/sim/conveyors/experiments/SimLogDdeInterCaseFeatureEncodingSession.scala`)
- Inter-case encoding → Training samples: creates samples (evidence: `ppm/src/main/scala/org/processmining/scala/intercase/DdeInterCaseFeatureEncoder.scala`)
- Training samples → Dataset preparation: normalizes and splits (evidence: `ppm/src/main/scala/org/processmining/scala/intercase/BaseDdeInterCaseFeatureEncodingSession.scala`)
- Conveyor simulation → Equipment model: moves equipment (evidence: `ppm/src/main/scala/org/processmining/scala/sim/conveyors/impl/AbstractEngine.scala`)
- Conveyor simulation → Sorter: dispatches sorter (evidence: `ppm/src/main/scala/org/processmining/scala/sim/conveyors/impl/AbstractEngine.scala`)
- Prediction experiments → ML data utilities: loads and saves (evidence: `ppm/ML/experiment.py`)
- Dataset preparation → Prediction experiments: provides training data
