4. Map Tools

The pycsamt.map package is the code-first mapping layer for pyCSAMT surveys. It gives script and notebook users direct control over station maps, profile pseudosections, 3-D quick-look maps, overlays, multi-line survey loading, and figure export.

Use this section when you want to work with maps from Python code. The web and desktop applications can build on the same rendering layer, but UI state and callbacks do not live here.

Warning

3-D maps in pycsamt.map are pseudo-depth visualizations derived from apparent resistivity and period. They are useful for QC, screening, and communication, but they are not constrained inversion models.

• 4.1. Loading Map Data
  • 4.1.1. Loading Philosophy
  • 4.1.2. Input Types
  • 4.1.3. Single-Line Loading
  • 4.1.4. Multiple-Line Loading
  • 4.1.5. Grouping Modes
  • 4.1.6. Explicit Line Mapping
  • 4.1.7. Normalized Contract
  • 4.1.8. Pre-Flight Checks
  • 4.1.9. Handling Missing or Partial Data
  • 4.1.10. Using Loaded Data
  • 4.1.11. Troubleshooting
• 4.2. Station Maps
  • 4.2.1. What A Station Map Shows
  • 4.2.2. Function API
  • 4.2.3. Reusing Loaded Data
  • 4.2.4. Builder API
  • 4.2.5. Overlays
  • 4.2.6. Frequency-Based Overlays
  • 4.2.7. Labels, Lines, And Selection
  • 4.2.8. Basemaps
  • 4.2.9. Density And Contour Layers
  • 4.2.10. Themes And Color Scales
  • 4.2.11. Backends
  • 4.2.12. Coordinate Fallback
  • 4.2.13. Exporting Station Maps
  • 4.2.14. Troubleshooting
• 4.3. Profile Maps And Pseudosections
  • 4.3.1. Function API
  • 4.3.2. Builder API
  • 4.3.3. Quantities And Components
  • 4.3.4. Axes
  • 4.3.5. By-Line Grids
  • 4.3.6. Filtering And Value Ranges
  • 4.3.7. Backends
  • 4.3.8. Options Reference
  • 4.3.9. Troubleshooting
• 4.4. 3-D Quick-Look Maps
  • 4.4.1. What The 3-D Map Represents
  • 4.4.2. Data Preparation
  • 4.4.3. Function API
  • 4.4.4. Builder API
  • 4.4.5. Modes
  • 4.4.6. Mode Examples
  • 4.4.7. ModEM Inversion Volumes
  • 4.4.8. Filtering
  • 4.4.9. Components
  • 4.4.10. Line Spacing And Azimuth
  • 4.4.11. Topography And Terrain
  • 4.4.12. Station Markers
  • 4.4.13. Color And Theme Controls
  • 4.4.14. Exporting 3-D Views
  • 4.4.15. Troubleshooting
• 4.5. Map Overlays
  • 4.5.1. Coordinates Before Decoration
  • 4.5.2. Basemap Extent And Style
  • 4.5.3. Measured Points And Interpolated Surfaces
  • 4.5.4. Lines, Labels, And Response Values
  • 4.5.5. Multiple Lines Without Visual Crowding
  • 4.5.6. Topography Is Geometry, Not Response
  • 4.5.7. Composing A Custom Figure
  • 4.5.8. Troubleshooting
• 4.6. Exporting Map Figures
  • 4.6.1. Choosing An Export Helper
  • 4.6.2. Output Directories
  • 4.6.3. HTML
  • 4.6.4. Explicit Format
  • 4.6.5. PNG
  • 4.6.6. Other Static Image Formats
  • 4.6.7. JSON And Dict Export
  • 4.6.8. ExportOptions Reference
  • 4.6.9. Batch Export
  • 4.6.10. MapView Export
  • 4.6.11. Round-Trip And Testing Workflows
  • 4.6.12. Recommended Formats
  • 4.6.13. Troubleshooting
• 4.7. MapView Session
  • 4.7.1. Create And Inspect A Session
  • 4.7.2. Render Consistent Views
  • 4.7.3. Options, Defaults, And Overrides
  • 4.7.4. Generic Figure Dispatch
  • 4.7.5. Elevation And Topography Handoffs
  • 4.7.6. Export Reproducible Products
  • 4.7.7. Launch The Platform