How zhengyangfang/geosage works
GeoSAGE is a geophysical modeling and interpretation package, with an optional PyHydroGeophysX Professional Studio assistant. The primary workflow accepts a case configuration and local survey data, runs or reuses a gravity–magnetic inversion, builds pseudo-geological models, then prepares interpretation and reports. Studio adds task planning, approvals, visualization, and provider-backed review; notebooks and shared plotting support assessment and presentation. Edges are limited to README statements and relationships visible in the supplied excerpts or SOURCE INDEX; unsampled implementations are represented without speculative links.
Main entry points: runner.py Workflow Runner · multi_agent_runner.py Agent Interpretation · tools.py Workflow Tools · existing_results.py Existing Results
Components 22
Workflow Orchestration
- Run Configuration
configs - Workflow Runner
src/geosage/runner.py
Scientific Modeling
- Joint Inversion
src/geosage/gravity_mag_joint_inversion.py - Existing Results
src/geosage/existing_results.py - Geological Modeling
src/geosage/geo_modeling_workflow.py - Models and Results
Interpretation
- Agent Interpretation
src/geosage/multi_agent_runner.py - Evidence Bundles
src/geosage/evidence_bundle.py - Interpretation Comparison
src/geosage/compare_interpretations.py - Study Area Survey
src/geosage/studio_survey.py
Studio Integration
- Studio Configuration
src/geosage/pyhydrogeophysx/configuration.py - Task Lifecycle
src/geosage/pyhydrogeophysx/lifecycle.py - Studio Workflow
src/geosage/pyhydrogeophysx/workflow.py - Workflow Tools
src/geosage/pyhydrogeophysx/tools.py - Result Visualization
src/geosage/pyhydrogeophysx/visualization.py - LLM Providers
src/geosage/pyhydrogeophysx/providers.py
Shared Support
- Workspace Paths
src/geosage/paths.py - Input Validation
src/geosage/validation.py - Scientific Figures
src/geosage/plotting/paper.py - Display Scales
src/geosage/plotting/scales.py
Other components
- Researcher
- Professional Studio
Connections 26
- Researcher → Run Configuration: specifies run
README.md - Run Configuration → Workflow Runner: configures
README.md - Workflow Runner → Joint Inversion: runs inversion
src/geosage/runner.py - Workflow Runner → Existing Results: loads existing
src/geosage/runner.py - Workflow Runner → Geological Modeling: builds geology
src/geosage/runner.py - Joint Inversion → Models and Results: writes models
src/geosage/gravity_mag_joint_inversion.py - Existing Results → Models and Results: loads models
src/geosage/existing_results.py - Workflow Runner → Agent Interpretation: enables interpretation
src/geosage/multi_agent_runner.py - Agent Interpretation → Evidence Bundles: prepares evidence
src/geosage/multi_agent_runner.py - Agent Interpretation → Existing Results: reuses results
src/geosage/multi_agent_runner.py - Interpretation Comparison → Agent Interpretation: uses agents
src/geosage/compare_interpretations.py - Interpretation Comparison → Existing Results: loads results
src/geosage/compare_interpretations.py - Workflow Runner → Workspace Paths: resolves paths
src/geosage/runner.py - Workflow Runner → Input Validation: validates inputs
- Geological Modeling → Input Validation: validates models
src/geosage/geo_modeling_workflow.py - Scientific Figures → Display Scales: uses scales
src/geosage/plotting/paper.py - Professional Studio → Studio Configuration: provides task inputs
README.md - Studio Configuration → Workflow Runner: builds run config
src/geosage/pyhydrogeophysx/configuration.py - Studio Workflow → Task Lifecycle: uses lifecycle
src/geosage/pyhydrogeophysx/workflow.py - Studio Workflow → Workflow Tools: dispatches tools
src/geosage/pyhydrogeophysx/workflow.py - Task Lifecycle → Workflow Tools: plans tools
src/geosage/pyhydrogeophysx/lifecycle.py - Workflow Tools → Workflow Runner: runs workflow
src/geosage/pyhydrogeophysx/tools.py - Workflow Tools → Result Visualization: exports results
src/geosage/pyhydrogeophysx/tools.py - Result Visualization → Scientific Figures: renders figures
src/geosage/pyhydrogeophysx/visualization.py - LLM Providers → Agent Interpretation: backs LLM
src/geosage/pyhydrogeophysx/providers.py - Study Area Survey → Models and Results: assesses study data