Web Application#
The pyCSAMT web application is a browser-based studio for CSAMT, AMT, and MT survey work. It runs the same scientific package as the Python API and the desktop GUI, but presents it as a single-page Dash/Plotly application that you open in a web browser. Use it to load EDI data, inspect maps and profiles, run quality control, preview and apply corrections, produce advanced diagnostics, build forward and inversion models, browse inversion results, and drive the pyCSAMT agents — all without writing code.
The web app is not a separate science layer. Its callbacks delegate to the
same pycsamt.app.desktop.controllers used by the desktop GUI, so a survey
loaded here behaves exactly as it would in the desktop app or in plain Python.
What differs is the working style: the web app is built for shared servers,
team demonstrations, and cross-platform access from a browser.
An animated tour of the web studio: welcome, load a survey, inspect the interactive station map and profile pseudosections, run quality control and corrections, run an AI-assisted inversion, and view the 3-D resistivity scene. Each surface is documented on the pages below.#
Explore the Guide#
Pick a page to dive in. A good first pass, in order, is Installation → Navigation → Loading & Sessions → Maps & Profiles → Processing Pages → Exports → Deployment → Troubleshooting.
Install the app extra, launch pycsamt-web, and understand the
host/port/debug options.
The command bar, the navigation rail, the home dashboard, theme, and the Settings and Help drawers.
Load EDI folders, manage survey lines, recompute transfer functions, and save browser sessions.
The interactive station map, profile pseudosections, phase tensors, and the 3-D resistivity scene.
QC, corrections, advanced plots, TDEM, the pipeline, forward, inversion, results, and the agents.
Save Plotly and matplotlib figures, corrected EDIs, inversion products, and reproducible session files.
Run local-only or on an internal network, and understand cache and security expectations.
Diagnose launch, upload, callback, plotting, and agent problems.
When To Use The Web App#
Use the web application when you need to:
run the full CSAMT/AMT/MT workflow from a browser, without a local Python environment on every workstation;
share a running instance on an internal server so several people can review the same survey;
demonstrate loading, QC, correction, modelling, and interpretation to a team or class;
combine interactive Plotly maps and sections with matplotlib publication figures on one screen;
drive the pyCSAMT agents (LLM, processing, and inversion) from a chat or a runnable agent list.
For scripted or batch work, use the Python API. For local, single-user interactive review with native windows, use the desktop GUI. For a dedicated conversational surface, use Agent Master.
Run The Web App#
pycsamt-web
The launcher starts a local Dash server and opens the app in your default
browser. It prefers http://127.0.0.1:8050 and automatically chooses
another free port if that one is busy.
From a source checkout, the module entry point launches the same app:
python -m pycsamt.app.web
Common launch options:
pycsamt-web --no-browser # start the server without opening a browser
pycsamt-web --port 8060 # prefer a specific port
pycsamt-web --port 0 # always ask the OS for a free port
pycsamt-web --host 0.0.0.0 # allow access from other machines on the LAN
pycsamt-web --debug # enable Dash dev tools and callback debugging
See Installation And Launch for the full option list and Deployment Notes for host, port, and network guidance.
Main Concepts#
Concept |
Meaning In The Web App |
|---|---|
Active survey |
The loaded survey shared by every page — station list, maps, QC, corrections, modelling, and agents all read the same data. |
Survey lines |
Named subgroups of stations (usually one folder per line). Lines can be toggled Active so a page acts only on the lines you select. |
Command bar |
The persistent top bar: page indicator, Tools, Settings, Help, and the survey actions Load Data, +Lines, Recompute, Lines, Session, and Theme. |
Navigation rail |
The collapsible left sidebar that routes between pages; it can be collapsed to icons to widen the plotting area. |
Correction chain |
A non-destructive stack of correction steps, previewed before Apply, with per-step Undo and full Reset All. |
Browser session |
Auto-saved state kept in the browser (theme, API key, last view) plus a downloadable session JSON for sharing across machines. |
Exported product |
A figure, corrected EDI, inversion product, or session file meant to be reused outside the current browser state. |
Screenshots#
Screenshots are embedded inside the pages where they explain a real action or decision, not collected in a separate gallery. Launch and welcome screens are in Installation And Launch; the command bar, rail, and drawers are in Navigation And Layout; loading and line management are in Loading Data And Sessions; maps and profiles are in Maps And Profiles; and the processing, modelling, results, and agent surfaces are in Processing Pages.