Troubleshooting#

Port already in use#

MapView defaults to port 8770. If another process (or a previous MapView instance) holds it, launch on a different port:

pycsamt-mapview --port 8780

No browser opens#

Some environments (WSL, remote shells, servers) cannot open a browser. Start with --no-browser and browse to the printed URL manually — http://127.0.0.1:8770 by default. From another machine, launch with --host 0.0.0.0 and use the server’s address.

The 3-D view is blank#

The 3-D scene needs WebGL. If the station map works but the 3-D canvas stays empty, enable hardware acceleration in the browser (or try another browser) — remote-desktop sessions often disable WebGL.

Stations plot in the wrong place#

Check Coordinate system in the Map inspector. Standard EDI files are geographic latitude/longitude (EPSG:4326); project files may use a UTM zone or a custom EPSG code. A wrong CRS stretches or displaces the station cloud.

The contour overlay looks blocky or misleading#

The contour is an interpolation over station locations. Lower the Levels, raise the Smoothing σ, or reduce the Grid resolution, and compare the contour against the station markers before reading structure into it.

Large surveys feel slow#

  • Toggle survey lines off in the line picker while you focus on one line.

  • On the Map, lower the contour Grid resolution — the interpolation grid dominates the figure cost — and hide station Labels in dense maps.

  • In 3-D, reduce the Depth slices and Iso-surfaces counts, and use a shorter Depth window (500 m / 1 km) instead of Full.

Data does not load#

  • The EDI stations tab expects station files with coordinates in their headers; files without any location can be placed only after loading stations that do have coordinates.

  • Inversion results without coordinates need Match coordinates from already-loaded EDI stations enabled — load the survey’s EDIs first, then the results.

  • Sessions are per browser tab: a second tab starts empty by design.

Where nothing else helps#

Run with --debug for the Dash traceback in the terminal, and check the browser console. The app never modifies your data folders, so a restart is always safe.