Applications

Four user-facing applications built on the same pyCSAMT scientific core: a desktop GUI, a browser app, a conversational agent surface, and a dedicated map workbench. Each guide starts with installation and launch and ends with exports and troubleshooting.

Prefer not to install anything locally? Three of the four 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. Install The Desktop Extra
    • 3.2.4. Launch The Application
    • 3.2.5. Load A First EDI Survey
    • 3.2.6. What Success Looks Like
    • 3.2.7. First-Launch Checklist
    • 3.2.8. Recommended Environment
    • 3.2.9. Platform Notes
    • 3.2.10. Common Installation Problems
    • 3.2.11. 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. Tools, Memory, And Outputs
    • 5.6.1. Step Traces And Provenance
    • 5.6.2. The Figures Panel
    • 5.6.3. Generated Code
    • 5.6.4. Sessions And Pinned Prompts
    • 5.6.5. What To Keep
    • 5.6.6. Next Steps
  • 5.7. Agent Master And The Other Apps
    • 5.7.1. One Set Of Agents, Several Front Ends
    • 5.7.2. Choosing A Surface
    • 5.7.3. Moving Between Them
    • 5.7.4. Failure Recovery
    • 5.7.5. Next Steps
  • 5.8. Troubleshooting
    • 5.8.1. Launch
    • 5.8.2. Model Provider
    • 5.8.3. Data And Workflows
    • 5.8.4. Session And Browser
    • 5.8.5. When You Need More Detail
    • 5.8.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