Applications

Five user-facing applications built on the same pyCSAMT scientific core: a desktop GUI, a browser app, a conversational agent surface, a dedicated map workbench, and a standalone file-format converter. Each survey-analysis app’s guide starts with installation and launch and ends with exports and troubleshooting; the converter is narrow enough in scope to cover in one page — see Format Converter.

Prefer not to install anything locally? Three of the five surfaces also run as hosted instances you can open directly in a browser — see Hosted Applications.

• 1. Overview
  • 1.1. Install The App Extra
• 2. Hosted Applications
  • 2.1. Choosing Hosted Or Local
  • 2.2. Next Steps
• 3. Desktop GUI
  • 3.1. Overview
    • 3.1.1. Who This Guide Is For
    • 3.1.2. Guided First Session
    • 3.1.3. When To Use The Desktop
    • 3.1.4. What A Complete Desktop Session Produces
    • 3.1.5. Run The Desktop GUI
    • 3.1.6. Workflow Map
    • 3.1.7. Decision Points In The Workflow
    • 3.1.8. Main Concepts
    • 3.1.9. Screenshots
  • 3.2. Installation And Launch
    • 3.2.1. Why Installation Matters
    • 3.2.2. Choose An Installation Path
    • 3.2.3. Download A Ready-Made Installer
    • 3.2.4. Licensing
    • 3.2.5. Install The Desktop Extra
    • 3.2.6. Launch The Application
    • 3.2.7. Load A First EDI Survey
    • 3.2.8. What Success Looks Like
    • 3.2.9. First-Launch Checklist
    • 3.2.10. Recommended Environment
    • 3.2.11. Platform Notes
    • 3.2.12. Common Installation Problems
    • 3.2.13. Quick Verification
  • 3.3. Loading Data And Sessions
    • 3.3.1. Why Loading Is A Scientific Step
    • 3.3.2. Open Survey Data
    • 3.3.3. Choose Files Or Folders
    • 3.3.4. Common Selection Mistakes
    • 3.3.5. Choosing The Right Loading Scope
    • 3.3.6. What Happens During Loading
    • 3.3.7. How To Read The First Loaded State
    • 3.3.8. Station Search And Selection
    • 3.3.9. Recent Files
    • 3.3.10. Save And Restore The Desktop Session
    • 3.3.11. What The Session Does Not Save
    • 3.3.12. Loading Recomputed EDIs
    • 3.3.13. When To Reload Instead Of Continue
    • 3.3.14. Practical Loading Checklist
  • 3.4. Workspace And Navigation
    • 3.4.1. Why The Workspace Is Split Into Panels
    • 3.4.2. Main Window Regions
    • 3.4.3. Orientation After Loading
    • 3.4.4. Station List
    • 3.4.5. Survey Overview
    • 3.4.6. Station Detail Card
    • 3.4.7. Panel Windows
    • 3.4.8. Secondary And Advanced Tools
    • 3.4.9. Suggested Panel Combinations
    • 3.4.10. Toolbar And Menus
    • 3.4.11. Read Toolbar Actions As Workflow Stages
    • 3.4.12. Log Dock And Status Bar
    • 3.4.13. Status And Log Interpretation
    • 3.4.14. Recent Files
    • 3.4.15. Theme And Preferences
    • 3.4.16. Preferences That Affect Scientific Work
    • 3.4.17. Saved Session State
    • 3.4.18. Workspace Habits
  • 3.5. Maps And Profiles
    • 3.5.1. What These Viewers Help You Decide
    • 3.5.2. Recommended Inspection Order
    • 3.5.3. Open The Viewers
    • 3.5.4. Viewer State And Active Survey
    • 3.5.5. Map Viewer Overview
    • 3.5.6. Map Review Checklist
    • 3.5.7. Map Type Details
    • 3.5.8. Reading Map Evidence
    • 3.5.9. Coordinate System
    • 3.5.10. Frequency, Period, And Component
    • 3.5.11. Choosing A Component For Inspection
    • 3.5.12. Contours And Spatial Overlays
    • 3.5.13. Contour Interpretation Rules
    • 3.5.14. Selecting Stations From Maps
    • 3.5.15. Map-To-Profile Investigation Loop
    • 3.5.16. Profile Viewer Overview
    • 3.5.17. Profile Review Checklist
    • 3.5.18. Response Controls
    • 3.5.19. Reading Response Curves
    • 3.5.20. Profile Tabs
    • 3.5.21. Which Profile Tab To Use First
    • 3.5.22. Per-Tab Guidance
    • 3.5.23. Publication View
    • 3.5.24. Map And Profile Checks Before Processing
    • 3.5.25. Hand-Off To Other Desktop Workflows
    • 3.5.26. Export Figures
    • 3.5.27. Common Issues
  • 3.6. Processing Workflows
    • 3.6.1. Recommended Order
    • 3.6.2. Active Data Flow
    • 3.6.3. Processing Stage Gates
    • 3.6.4. Quality Control
    • 3.6.5. When QC Is Enough
    • 3.6.6. Data Corrections
    • 3.6.7. Correction Decision Rules
    • 3.6.8. Advanced Diagnostics
    • 3.6.9. When Advanced Diagnostics Are Required
    • 3.6.10. Forward Modelling
    • 3.6.11. Forward Model Readiness
    • 3.6.12. Inversion Preparation
    • 3.6.13. Ready For Inversion Checklist
    • 3.6.14. Processing Pipeline
    • 3.6.15. When To Use The Pipeline
    • 3.6.16. Agent-Assisted Review
    • 3.6.17. Outputs And Reproducibility
  • 3.7. Exports And Reproducibility
    • 3.7.1. Think In Data States
    • 3.7.2. Export Types
    • 3.7.3. Figure Export
    • 3.7.4. Figure Naming Pattern
    • 3.7.5. Batch Plot Export
    • 3.7.6. Minimum Evidence Set
    • 3.7.7. Survey Metadata Export
    • 3.7.8. Metadata Review Uses
    • 3.7.9. EDI Data Products
    • 3.7.10. EDI Product Safety Rules
    • 3.7.11. Recomputed EDIs
    • 3.7.12. Recompute Audit Checklist
    • 3.7.13. Pipeline Configurations
    • 3.7.14. Pipeline Export Package
    • 3.7.15. Inversion Exports
    • 3.7.16. Inversion Run Naming
    • 3.7.17. Interpretation Exports
    • 3.7.18. Session And Settings
    • 3.7.19. What Not To Rely On
    • 3.7.20. Recommended Project Layout
    • 3.7.21. Export Checklist
  • 3.8. Troubleshooting
    • 3.8.1. Troubleshooting Strategy
    • 3.8.2. Quick Checks
    • 3.8.3. Fast Recovery Path
    • 3.8.4. Missing PySide6
    • 3.8.5. Command Not Found
    • 3.8.6. Wrong Python Environment
    • 3.8.7. Desktop Opens But No Data Load
    • 3.8.8. Load Failed
    • 3.8.9. Raw, Corrected, Or Recomputed State Is Confusing
    • 3.8.10. No Data Dialog
    • 3.8.11. Station Count Is Wrong
    • 3.8.12. Blank Or Empty Plots
    • 3.8.13. Figure Export Says No Figure
    • 3.8.14. Batch Export Saves Fewer Figures Than Expected
    • 3.8.15. Coordinate Or Map Problems
    • 3.8.16. Static Shift Correction Looks Too Smooth
    • 3.8.17. Correction Was Committed By Mistake
    • 3.8.18. Pipeline Stops Or Exports Nothing
    • 3.8.19. Pipeline Output Does Not Match Manual Processing
    • 3.8.20. Inversion Workdir Or Binary Errors
    • 3.8.21. Occam2D Or Solver Result Will Not Plot
    • 3.8.22. Inversion Runs But Result Is Not Trustworthy
    • 3.8.23. AI Or Agent Runs Fail
    • 3.8.24. Session Or Layout Problems
    • 3.8.25. Export Folder Is Confusing Or Incomplete
    • 3.8.26. Windows PowerShell Profile Warning
    • 3.8.27. When To Rebuild Or Reinstall
    • 3.8.28. What To Include In A Bug Report
• 4. Web Application
  • 4.1. Overview
    • 4.1.1. When To Use The Web App
    • 4.1.2. Run The Web App
    • 4.1.3. Navigation Map
    • 4.1.4. Main Concepts
    • 4.1.5. Screenshots
  • 4.2. Installation And Launch
    • 4.2.1. Install The App Extra
    • 4.2.2. Launch The Web App
    • 4.2.3. The Welcome Screen
    • 4.2.4. Command-Line Options
    • 4.2.5. Examples
    • 4.2.6. Verify The Launch
    • 4.2.7. Next Steps
  • 4.3. Navigation And Layout
    • 4.3.1. The App Shell
    • 4.3.2. The Command Bar
    • 4.3.3. The Navigation Rail
    • 4.3.4. The Home Dashboard
    • 4.3.5. Theme
    • 4.3.6. Settings Drawer
    • 4.3.7. Help / About
    • 4.3.8. Differences From The Desktop GUI
    • 4.3.9. Next Steps
  • 4.4. Loading Data And Sessions
    • 4.4.1. Loading A Survey
    • 4.4.2. Adding Lines To An Existing Survey
    • 4.4.3. Managing Survey Lines
    • 4.4.4. Recomputing Transfer Functions
    • 4.4.5. Browser Sessions
    • 4.4.6. Data Health After Loading
    • 4.4.7. Next Steps
  • 4.5. Maps And Profiles
    • 4.5.1. Recommended Inspection Order
    • 4.5.2. Map View
    • 4.5.3. Profile View
    • 4.5.4. Phase Tensor Pseudosection
    • 4.5.5. 3D Map
    • 4.5.6. Figure Export And Code Parity
    • 4.5.7. Common Issues
    • 4.5.8. Next Steps
  • 4.6. Processing Pages
    • 4.6.1. Shared Controls
    • 4.6.2. Quality Control
    • 4.6.3. Correction
    • 4.6.4. Advanced Plots
    • 4.6.5. TDEM
    • 4.6.6. Processing Pipeline
    • 4.6.7. Forward Modelling
    • 4.6.8. Inversion
    • 4.6.9. Results View
    • 4.6.10. Interpretation
    • 4.6.11. AI Agents
    • 4.6.12. Tools
    • 4.6.13. How Pages Delegate To The Package
    • 4.6.14. Next Steps
  • 4.7. Exports And Reproducibility
    • 4.7.1. Saving Figures
    • 4.7.2. Page And Tool Exports
    • 4.7.3. Batch Export
    • 4.7.4. Session Files
    • 4.7.5. Reproducing Web Output In Python
    • 4.7.6. Practical Export Habits
    • 4.7.7. Next Steps
  • 4.8. Deployment Notes
    • 4.8.1. Local-Only (Default)
    • 4.8.2. Internal-Network Access
    • 4.8.3. Choosing A Port
    • 4.8.4. Behind A Reverse Proxy
    • 4.8.5. Cache And Temporary Files
    • 4.8.6. Where State Lives
    • 4.8.7. Security Expectations
    • 4.8.8. Framework
    • 4.8.9. Next Steps
  • 4.9. Troubleshooting
    • 4.9.1. Launch Problems
    • 4.9.2. Loading Problems
    • 4.9.3. Page And Callback Problems
    • 4.9.4. Plotting Problems
    • 4.9.5. Agent Problems
    • 4.9.6. Browser Problems
    • 4.9.7. When To Use Debug Mode
    • 4.9.8. Still Stuck?
• 5. Agent Master
  • 5.1. Overview
    • 5.1.1. What Agent Master Does
    • 5.1.2. A Complete Request, Start To Finish
    • 5.1.3. When To Use It
    • 5.1.4. Run Agent Master
    • 5.1.5. The Interface At A Glance
  • 5.2. Installation And Launch
    • 5.2.1. Install The App Extra
    • 5.2.2. Launch
    • 5.2.3. Options
    • 5.2.4. The Welcome Screen
    • 5.2.5. Verify
    • 5.2.6. Next Steps
  • 5.3. Welcome Screen And Chat
    • 5.3.1. Welcome Screen
    • 5.3.2. The Main Window
    • 5.3.3. Loading EDI Data
    • 5.3.4. Chatting
    • 5.3.5. Sessions And History
    • 5.3.6. Next Steps
  • 5.4. Workflows And Agents
    • 5.4.1. The Workflow Catalogue
    • 5.4.2. Making A Request
    • 5.4.3. Choosing Lines
    • 5.4.4. Providing Parameters
    • 5.4.5. Orchestration, Traces, And Cost
    • 5.4.6. Chaining Requests
    • 5.4.7. Next Steps
  • 5.5. LLM Configuration
    • 5.5.1. The Settings Drawer
    • 5.5.2. Choosing A Provider And Model
    • 5.5.3. Privacy And Keys
    • 5.5.4. Running Without A Model
    • 5.5.5. Next Steps
  • 5.6. Local language models
    • 5.6.1. Setup
    • 5.6.2. Limits and behavior
    • 5.6.3. Privacy and failure behavior
    • 5.6.4. Python use
  • 5.7. Generating and editing scripts
    • 5.7.1. Follow-up edits
    • 5.7.2. Validation limits
    • 5.7.3. Python interface
  • 5.8. Generated-code validation and repair
    • 5.8.1. Bounded repair
    • 5.8.2. Execution boundary
  • 5.9. Developer source questions
    • 5.9.1. Search boundaries
    • 5.9.2. Python interface
  • 5.10. Tools, Memory, And Outputs
    • 5.10.1. Step Traces And Provenance
    • 5.10.2. The Figures Panel
    • 5.10.3. Generated Code
    • 5.10.4. Sessions And Pinned Prompts
    • 5.10.5. What To Keep
    • 5.10.6. Next Steps
  • 5.11. Conversation context and stopping work
    • 5.11.1. Long conversations
    • 5.11.2. Answers and artifacts
    • 5.11.3. Stopping a request
  • 5.12. Agent Master And The Other Apps
    • 5.12.1. One Set Of Agents, Several Front Ends
    • 5.12.2. Choosing A Surface
    • 5.12.3. Moving Between Them
    • 5.12.4. Failure Recovery
    • 5.12.5. Next Steps
  • 5.13. Evaluating answers and scripts
    • 5.13.1. The benchmark
    • 5.13.2. Outcomes
    • 5.13.3. Running the benchmark
    • 5.13.4. Metrics
    • 5.13.5. Tests
    • 5.13.6. Limitations
  • 5.14. Troubleshooting
    • 5.14.1. Launch
    • 5.14.2. Model Provider
    • 5.14.3. Data And Workflows
    • 5.14.4. Session And Browser
    • 5.14.5. When You Need More Detail
    • 5.14.6. See Also
• 6. MapView
  • 6.1. Overview
    • 6.1.1. When To Use MapView
    • 6.1.2. The Two Views
    • 6.1.3. Run MapView
    • 6.1.4. Main Concepts
  • 6.2. Installation And Launch
    • 6.2.1. Launching
    • 6.2.2. Preloading Data
    • 6.2.3. Verify
  • 6.3. Loading Data And Sessions
    • 6.3.1. Inversion Results
    • 6.3.2. EDI Stations
    • 6.3.3. Sites
    • 6.3.4. Sessions
  • 6.4. Views And Controls
    • 6.4.1. The Shell
    • 6.4.2. Map View
    • 6.4.3. 3-D View
    • 6.4.4. Inversion Results In 3-D
  • 6.5. Exports
    • 6.5.1. Interactive HTML
    • 6.5.2. Static Figures And Beyond
  • 6.6. Troubleshooting
    • 6.6.1. Port already in use
    • 6.6.2. No browser opens
    • 6.6.3. The 3-D view is blank
    • 6.6.4. Stations plot in the wrong place
    • 6.6.5. The contour overlay looks blocky or misleading
    • 6.6.6. Large surveys feel slow
    • 6.6.7. Data does not load
    • 6.6.8. Where nothing else helps
• 7. Format Converter
  • 7.1. Install And Launch
  • 7.2. Compiling A Standalone Build
  • 7.3. Finding Your Way Around
  • 7.4. Source Detection
  • 7.5. Inversion → PCSF/PCSM
  • 7.6. PCSF ⇄ PCSM / Validate / Info
  • 7.7. EDI ⇄ EMTF-XML
  • 7.8. Build PCBH (Borehole)
  • 7.9. Build PCGL (Geology Legend)
  • 7.10. Build PCGS (Structure)
  • 7.11. Build PCPT (Points)
  • 7.12. Batch Queue
  • 7.13. Settings
  • 7.14. Troubleshooting