How andre-hjr/flog works
Flog is a desktop well-log interpretation application. Users open or import well data, select curves for linked depth-track plotting, and can interactively compute interpretations or extend the workflow with plugins. The Agent offers a separate natural-language route to application tools over rpc-x; it can run plugins or sandboxed Python and write results back. The graph includes documented imaging, export, and petrophysical capabilities. Source excerpts establish core assembly and storage relationships; README.md supports documented product flows where implementation was not sampled.
Main entry points: repository.py Curve Repository · app.py App Assembly · session.py Agent Session · main_window.py Main Window
Components 28
Application
- App Assembly
src/flog/app.py - Main Window
src/flog/ui/main_window.py - Configuration
src/flog/config.py
Well Data
- Curve Repository
src/flog/data/repository.py - SQLite Workspace
src/flog/data/database.py - LAS Import/Export
src/flog/data/wellio.py - Sampling Alignment
src/flog/data/sampling.py - Curve References
src/flog/core/refs.py
Interpretation
- Quanti Solver
src/flog/quanti/engine.py - Quanti Controller
src/flog/quanti/controller.py - Petrophysics
src/flog/petrophysics/numpy_kernels.py - Plugin Registry
src/flog/plugins/registry.py - Plugin Contract
src/flog/plugins/base.py
Agent and RPC
- Agent Panel
src/flog/agent/panel.py - Agent Session
src/flog/agent/session.py - RPC Client
src/flog/rpcx/client.py - RPC Server
src/flog/rpcx/server.py - RPC Tools
src/flog/rpcx/tools.py - LLM Providers
src/flog/agent/providers/base.py - Python Sandbox
src/flog/agent/sandbox.py
Visualization
- Plot View
src/flog/plot/view.py - Track Rendering
src/flog/plot/tracks.py - Plot Specification
src/flog/plot/spec.py - Viewer Registry
src/flog/viewers/registry.py - FMI/NMR Imaging
src/flog/imaging/image_track.py - Plot Export
src/flog/plot/exporters.py
Other components
- Geoscientist
- LLM Service
Connections 41
- Geoscientist → Main Window: uses
README.md - App Assembly → SQLite Workspace: opens
src/flog/app.py - App Assembly → Curve Repository: constructs
src/flog/app.py - App Assembly → Main Window: creates
src/flog/app.py - App Assembly → Plugin Registry: loads
src/flog/app.py - App Assembly → Viewer Registry: loads
src/flog/app.py - App Assembly → RPC Server: starts
src/flog/app.py - App Assembly → Configuration: reads
src/flog/app.py - Main Window → Curve Repository: uses
src/flog/ui/main_window.py - Main Window → Plot View: wires
src/flog/ui/main_window.py - Geoscientist → LAS Import/Export: imports LAS
README.md - LAS Import/Export → Curve Repository: writes dataset
src/flog/data/wellio.py - Curve Repository → SQLite Workspace: reads/writes
src/flog/data/repository.py - Curve Repository → Sampling Alignment: uses axes
src/flog/data/repository.py - Curve Repository → Curve References: returns records
src/flog/data/repository.py - Plot View → Curve Repository: loads curves
- Plot View → Track Rendering: renders
- Track Rendering → Plot Specification: uses specs
src/flog/plot/tracks.py - Track Rendering → Curve References: identifies curves
src/flog/plot/tracks.py - Viewer Registry → FMI/NMR Imaging: registers viewer
- Geoscientist → Quanti Controller: adjusts parameters
README.md - Quanti Controller → Quanti Solver: runs solver
src/flog/quanti/controller.py - Quanti Solver → Curve Repository: loads curves
src/flog/quanti/engine.py - Quanti Solver → Sampling Alignment: aligns inputs
src/flog/quanti/engine.py - Geoscientist → Plugin Registry: extends workflow
README.md - Plugin Registry → Plugin Contract: registers plugins
src/flog/plugins/registry.py - Plugin Contract → Curve Repository: reads curves
src/flog/plugins/base.py - Geoscientist → Agent Panel: asks interpretation
README.md - Main Window → Agent Panel: hosts panel
src/flog/ui/main_window.py - Agent Panel → Agent Session: starts session
- Agent Session → LLM Providers: queries model
src/flog/agent/session.py - LLM Providers → LLM Service: requests completion
- Agent Session → RPC Client: calls tools
src/flog/agent/session.py - RPC Client → RPC Server: sends requests
src/flog/rpcx/client.py - RPC Server → RPC Tools: dispatches tools
src/flog/rpcx/server.py - RPC Tools → Curve Repository: reads/writes data
src/flog/rpcx/tools.py - Agent Session → Python Sandbox: runs Python
src/flog/agent/session.py - Agent Session → Plugin Registry: executes plugin
README.md - RPC Tools → Quanti Solver: runs interpretation
- Plot View → Plot Export: exports plot
- Quanti Solver → Petrophysics: uses kernels