How castiel0312/kala-tel works
This repository is a collection of drilling-data tools rather than one unified runtime: NWIS ingests and searches well information, a React component visualizes graph data, lithology scripts train and evaluate models, and kick-detector modules score drilling signals. The clearest user workflows are document upload/search through NWIS and signal scoring through the detector. The README is empty, and several subsystems were not sampled; edges below are limited to indexed references or explicit excerpted calls, so no unverified storage or model-training pipeline is asserted.
Main entry points: force2020_lithology.py FORCE 2020 Utilities · main.py FastAPI Service · pipeline.py Ingestion Pipeline · Graph3DView.jsx 3D Graph View
Components 29
NWIS Data Service
- FastAPI Service
DATA_LAYER/src/api/main.py - Settings
DATA_LAYER/src/config/settings.py - Ingestion Pipeline
DATA_LAYER/src/ingestion/pipeline.py - PDF Processing
DATA_LAYER/src/ingestion/pdf_processor.py - NLP Extraction
DATA_LAYER/src/ingestion/nlp_extractor.py - Hybrid Retrieval
DATA_LAYER/src/retrieval/hybrid_engine.py - Graph API
DATA_LAYER/src/api/graph_viz.py
Graph Visualization
- 3D Graph View
DATA_LAYER/graph3d-ui/src/Graph3DView.jsx - Graph Stream Hook
DATA_LAYER/graph3d-ui/src/useGraphStream.js - Graph Transform
DATA_LAYER/graph3d-ui/src/graphTransform.js - Graph Styles
DATA_LAYER/graph3d-ui/src/styles.js - Graph Theme
DATA_LAYER/graph3d-ui/src/theme.js
Lithology Modeling
- FORCE 2020 Utilities
data/ml/common/force2020_lithology.py - GBDT Baseline
data/ml/lithology/training/train_gbdt_baseline.py - GBDT Feature Set
data/ml/lithology/training/train_gbdt_feature_set.py - Random Forest
data/ml/lithology/training/train_rf_baseline.py - CNN Baseline
data/ml/lithology/training/train_cnn_baseline.py - Feature Ablation
data/ml/lithology/training/train_feature_ablation.py - GBDT Evaluation
data/ml/lithology/evaluation/evaluate_gbdt_baseline.py - RF Evaluation
data/ml/lithology/evaluation/evaluate_rf_baseline.py
Kick Detection
- Kick Detector
kick_detector_35f/kickdet/detector.py - Signal Features
kick_detector_35f/kickdet/features.py - Channel Definitions
kick_detector_35f/kickdet/columns.py - Model Ensemble
kick_detector_35f/kickdet/ensemble.py - Episode Analysis
kick_detector_35f/kickdet/episodes.py
Other components
- API Client
- Graph UI User
- Model Developer
- Signal Consumer
Connections 32
- API Client → FastAPI Service: uploads or searches
DATA_LAYER/src/api/main.py - FastAPI Service → Ingestion Pipeline: dispatches ingestion
DATA_LAYER/src/api/main.py - FastAPI Service → Hybrid Retrieval: dispatches search
DATA_LAYER/src/api/main.py - FastAPI Service → Graph API: routes graph requests
DATA_LAYER/src/api/main.py - Ingestion Pipeline → PDF Processing: uses processor
DATA_LAYER/src/ingestion/pipeline.py - Ingestion Pipeline → NLP Extraction: uses extractor
DATA_LAYER/src/ingestion/pipeline.py - FastAPI Service → Settings: uses settings
DATA_LAYER/src/api/main.py - Ingestion Pipeline → Settings: uses settings
DATA_LAYER/src/ingestion/pipeline.py - Hybrid Retrieval → Settings: uses settings
DATA_LAYER/src/retrieval/hybrid_engine.py - Graph UI User → 3D Graph View: views graph
- 3D Graph View → Graph Stream Hook: reads live graph
DATA_LAYER/graph3d-ui/src/Graph3DView.jsx - 3D Graph View → Graph Styles: uses styles
DATA_LAYER/graph3d-ui/src/Graph3DView.jsx - 3D Graph View → Graph Theme: uses colors
DATA_LAYER/graph3d-ui/src/Graph3DView.jsx - Graph Stream Hook → Graph Transform: applies snapshots
DATA_LAYER/graph3d-ui/src/useGraphStream.js - Model Developer → GBDT Baseline: trains model
- Model Developer → GBDT Feature Set: trains model
- Model Developer → Random Forest: trains model
- Model Developer → CNN Baseline: trains model
- Model Developer → Feature Ablation: runs ablation
- GBDT Baseline → FORCE 2020 Utilities: uses shared utilities
data/ml/lithology/training/train_gbdt_baseline.py - GBDT Feature Set → FORCE 2020 Utilities: uses shared utilities
data/ml/lithology/training/train_gbdt_feature_set.py - Random Forest → FORCE 2020 Utilities: uses shared utilities
data/ml/lithology/training/train_rf_baseline.py - Feature Ablation → FORCE 2020 Utilities: uses shared utilities
data/ml/lithology/training/train_feature_ablation.py - GBDT Evaluation → FORCE 2020 Utilities: uses shared utilities
data/ml/lithology/evaluation/evaluate_gbdt_baseline.py - RF Evaluation → FORCE 2020 Utilities: uses shared utilities
data/ml/lithology/evaluation/evaluate_rf_baseline.py - Model Developer → GBDT Evaluation: evaluates model
- Model Developer → RF Evaluation: evaluates model
- Signal Consumer → Kick Detector: scores signal
- Kick Detector → Signal Features: builds features
kick_detector_35f/kickdet/detector.py - Kick Detector → Model Ensemble: uses ensemble
kick_detector_35f/kickdet/detector.py - Kick Detector → Episode Analysis: uses episodes
kick_detector_35f/kickdet/detector.py - Signal Features → Channel Definitions: uses channel definitions
kick_detector_35f/kickdet/features.py