How processmining-in-logistics/psm works
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: builder Spectrum transformation · parallel Segment processing · FileStorage.scala Spectrum storage · UnifiedEventLog.scala Unified event log
Components 24
Log ingestion
- CSV reader
perf_spec/src/main/scala/org/processmining/scala/log/common/csv/parallel/CsvReader.scala - XES reader
perf_spec/src/main/scala/org/processmining/scala/log/common/xes/parallel - Unified events
perf_spec/src/main/scala/org/processmining/scala/log/common/unified/event/UnifiedEvent.scala - Unified event log
perf_spec/src/main/scala/org/processmining/scala/log/common/unified/log/parallel/UnifiedEventLog.scala
Spectrum processing
- Spectrum transformation
perf_spec/src/main/scala/org/processmining/scala/viewers/spectrum/builder - Segment processing
perf_spec/src/main/scala/org/processmining/scala/log/common/enhancment/segments/parallel - Spectrum bins
perf_spec/src/main/scala/org/processmining/scala/log/common/enhancment/segments/common/BinsImpl.scala - Segment data
perf_spec/src/main/scala/org/processmining/scala/log/common/enhancment/segments/common/SegmentImpl.scala - Spectrum file layout
perf_spec/src/main/scala/org/processmining/scala/log/common/enhancment/segments/common/SpectrumFileNames.scala - Spectrum storage
perf_spec/src/main/scala/org/processmining/scala/viewers/spectrum/model/FileStorage.scala
Analysis and UI
- Spectrum data access
perf_spec/src/main/scala/org/processmining/scala/viewers/spectrum/model/AbstractDataSource.scala - Spectrum viewer
perf_spec/src/main/scala/org/processmining/scala/viewers/spectrum/view - Pattern detection
perf_spec/src/main/scala/org/processmining/scala/viewers/spectrum/patterns/OneSegmentPatternsDetector.scala - Feature dataset export
perf_spec/src/main/scala/org/processmining/scala/viewers/spectrum/features/SpectrumToDataset.scala
Predictive features
- Inter-case encoding
ppm/src/main/scala/org/processmining/scala/intercase/DdeInterCaseFeatureEncoder.scala - Training samples
ppm/src/main/scala/org/processmining/scala/intercase/Sample.scala - Dataset preparation
ppm/src/main/scala/org/processmining/scala/intercase/BaseDdeInterCaseFeatureEncodingSession.scala
Simulation and ML
- Conveyor simulation
ppm/src/main/scala/org/processmining/scala/sim/conveyors/impl/AbstractEngine.scala - Equipment model
ppm/src/main/scala/org/processmining/scala/sim/conveyors/api/AbstractEquipment.scala - Sorter
ppm/src/main/scala/org/processmining/scala/sim/conveyors/impl/Sorter.scala - Prediction experiments
ppm/ML/experiment.py - ML data utilities
ppm/ML/my_utils.py
Other components
- Analyst
- CSV / XES log
Connections 23
- Analyst → CSV / XES log: selects
README.md - CSV / XES log → Spectrum transformation: transforms
README.md - Spectrum transformation → Spectrum storage: persists spectrum
README.md - Spectrum storage → Spectrum data access: opens data
- Spectrum data access → Spectrum viewer: supplies spectrum
perf_spec/src/main/scala/org/processmining/scala/viewers/spectrum/view/TimeDiffController.scala - Analyst → Spectrum viewer: explores
README.md - Spectrum viewer → Pattern detection: reveals patterns
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
perf_spec/src/main/scala/org/processmining/scala/viewers/spectrum/model/FileStorage.scala - Analyst → Feature dataset export: exports features
README.md - CSV / XES log → CSV reader: reads CSV
- CSV / XES log → XES reader: reads XES
- CSV reader → Unified event log: parses events
ppm/src/main/scala/org/processmining/scala/sim/conveyors/experiments/SimLogDdeInterCaseFeatureEncodingSession.scala - Unified events → Unified event log: forms log events
ppm/src/main/scala/org/processmining/scala/sim/conveyors/experiments/SimLogDdeInterCaseFeatureEncodingSession.scala - Unified event log → Inter-case encoding: encodes prefixes
ppm/src/main/scala/org/processmining/scala/sim/conveyors/experiments/SimLogDdeInterCaseFeatureEncodingSession.scala - Inter-case encoding → Training samples: creates samples
ppm/src/main/scala/org/processmining/scala/intercase/DdeInterCaseFeatureEncoder.scala - Training samples → Dataset preparation: normalizes and splits
ppm/src/main/scala/org/processmining/scala/intercase/BaseDdeInterCaseFeatureEncodingSession.scala - Conveyor simulation → Equipment model: moves equipment
ppm/src/main/scala/org/processmining/scala/sim/conveyors/impl/AbstractEngine.scala - Conveyor simulation → Sorter: dispatches sorter
ppm/src/main/scala/org/processmining/scala/sim/conveyors/impl/AbstractEngine.scala - Prediction experiments → ML data utilities: loads and saves
ppm/ML/experiment.py - Dataset preparation → Prediction experiments: provides training data