MagSurveyPy: Archaeological Magnetometry Prospection Suite

MagSurveyPy v1.0.1 is a consistency and presentation update focused on the public command-line interface, automatic processing figures, output organization, documentation, and citation metadata.

Main changes

• More consistent public CLI syntax using --project, --input, --from, --output, and --increment.

• Earlier positional command forms remain available for compatibility.

• Standardized automatic PNG output organization:

  • PNG/Comparison/
  • PNG/Products/
  • PNG/QC/
  • PNG/Diagnostics/

• Improved adaptive colorbar labeling, including large absolute total-field values.

• Routine processing previews are separated from cartographic figures; north arrows, scale bars, CRS badges, and similar decoration are reserved for explicit figure/map-export workflows.

• More consistent comparison figures across interpolation, cleaning, enhancement, filtering, total-field, and multichannel workflows.

• Expanded README and documentation with software-architecture, processing-domain, native PRM, and local GIS figures.

• Updated citation metadata with the MagSurveyPy preprint:

  Hegyi, A. (2026). MagSurveyPy: An Open-Source Framework for Archaeological Magnetometry Processing and Spatial Analysis (Version 1). Zenodo.

  https://doi.org/10.5281/zenodo.22709406

Scientific compatibility

This release does not intentionally change the core scientific processing algorithms. Regression testing confirmed numerical equivalence of representative quantitative outputs between the tested v1.0.0 and v1.0.1 workflows.

Installation

python -m pip install magsurveypy==1.0.1

Documentation

See the repository README and the docs/ directory for workflow, processing, interpolation, filtering, georeferencing, native PRM, GIS, and reproducibility documentation.