How artimonka3/gem works
ros2_sens is a ROS 2 PLC diagnostics and Siemens STL analysis workspace. Its main workflow acquires PLC telemetry and code, sends code through an analysis service, adapts dependencies into an industrial JSON graph, and persists telemetry, status, and analysis results. Separate source-collection lifecycle nodes and a debounced local-code monitor extend ingestion. Relationships among the core parser, adapter, analyzer, and storage are supported by source; other runtime connections follow explicit README descriptions, since not all node implementations were excerpted.
Main entry points: pipeline.py Control/dataflow analysis · source_lifecycle_manager.py Source lifecycle manager · stl_analyzer_node.py STL analyzer service · parser.py STL parser
Components 24
Acquisition
- PLC simulator
src/sens_drivers/sens_drivers/sim_plc_node.py - Source lifecycle manager
src/sens_analytics/sens_analytics/source_lifecycle_manager.py - File watcher
src/sens_analytics/sens_analytics/file_watcher_node.py - Git subscriber
src/sens_analytics/sens_analytics/git_subscriber_node.py - PLC scraper
src/sens_analytics/sens_analytics/plc_scraper_node.py - Semantic fallback
src/sens_analytics/sens_analytics/fallback_semantic_node.py - Code monitor
src/sens_analytics/sens_analytics/code_monitor_node.py
STL analysis
- STL analyzer service
src/sens_analytics/sens_analytics/stl_analyzer_node.py - STL parser
src/sens_analytics/sens_analytics/parser.py - Expression parser
src/sens_analytics/sens_analytics/expression_parser.py - Control/dataflow analysis
src/sens_analytics/sens_analytics/analysis/pipeline.py - Basic blocks and CFG
src/sens_analytics/sens_analytics/analysis/basic_blocks.py - Instruction CFG
src/sens_analytics/sens_analytics/analysis/instruction_cfg.py - Use/def analysis
src/sens_analytics/sens_analytics/analysis/dataflow.py - Reaching definitions
src/sens_analytics/sens_analytics/analysis/reaching_definitions.py - Def-use analysis
src/sens_analytics/sens_analytics/analysis/def_use.py - Dependency graph
src/sens_analytics/sens_analytics/analysis/dependency_graph.py - Industrial graph adapter
src/sens_analytics/sens_analytics/graph_adapter.py
ROS interfaces
- Code bridge
src/sens_analytics/sens_analytics/code_bridge_node.py - ROS message contracts
src/sens_interfaces/msg/AnalysisResult.msg
Persistence
- Storage receiver
src/sens_storage/sens_storage/storage_node.py - Database adapters
src/sens_storage/sens_storage/storage_adapters.py - SQLite / TimescaleDB
Other components
- PLC engineer / operator
Connections 23
- PLC simulator → Storage receiver: publishes telemetry
README.md - PLC simulator → Code bridge: publishes STL code
README.md - Code bridge → STL analyzer service: forwards code
README.md - STL analyzer service → STL parser: parses code
src/sens_analytics/sens_analytics/stl_analyzer_node.py - STL parser → Industrial graph adapter: adapts graph
src/sens_analytics/sens_analytics/stl_analyzer_node.py - STL parser → Expression parser: imports
src/sens_analytics/sens_analytics/parser.py - PLC engineer / operator → Code monitor: edits source
README.md - Code monitor → STL analyzer service: calls service
README.md - Source lifecycle manager → File watcher: manages lifecycle
README.md - Source lifecycle manager → Git subscriber: manages lifecycle
README.md - Source lifecycle manager → PLC scraper: manages lifecycle
README.md - Source lifecycle manager → Semantic fallback: manages lifecycle
README.md - PLC engineer / operator → Source lifecycle manager: selects source mode
README.md - Control/dataflow analysis → STL parser: parses input
src/sens_analytics/sens_analytics/analysis/pipeline.py - Control/dataflow analysis → Instruction CFG: builds CFG
src/sens_analytics/sens_analytics/analysis/pipeline.py - Control/dataflow analysis → Basic blocks and CFG: builds blocks
src/sens_analytics/sens_analytics/analysis/pipeline.py - Control/dataflow analysis → Use/def analysis: builds use/def
src/sens_analytics/sens_analytics/analysis/pipeline.py - Control/dataflow analysis → Reaching definitions: computes definitions
src/sens_analytics/sens_analytics/analysis/pipeline.py - Control/dataflow analysis → Def-use analysis: builds def-use
src/sens_analytics/sens_analytics/analysis/pipeline.py - Control/dataflow analysis → Dependency graph: builds graph
src/sens_analytics/sens_analytics/analysis/pipeline.py - Storage receiver → Database adapters: writes events via
src/sens_storage/sens_storage/storage_node.py - Database adapters → SQLite / TimescaleDB: persists records
src/sens_storage/sens_storage/storage_adapters.py - STL analyzer service → Storage receiver: publishes results
README.md