MagSurveyPy v1.0.4 — profile magnetometry extension

MagSurveyPy v1.0.4 is a targeted extension of the exact public v1.0.3 source. Existing multichannel, gridded total-field, fluxgate, interpolation, filtering, figure, Web GIS, export and supporting scientific modules are retained unchanged unless required for command routing/version metadata.

New functionality

• Dedicated mspy survey profile --protocol total-field workflow for 1-D total-field profiles.
• Single profile, profile-ID tables and directory-of-profile-files input.
• CSV, DAT, TXT, ASC, XYZ and TSV text input with delimiter autodetection and explicit column mapping.
• Latitude/longitude, projected X/Y, optional distance and elevation support.
• Common base-station/observatory correction with explicit direct and variation-only equations.
• Exact, nearest and linear time synchronization, optional time offset/max gap, and no silent time extrapolation.
• Separate mspy process normal-field stage with linear nT/km gradient correction and optional ppigrf IGRF correction.
• mspy analyze profile --gradient along-profile QC in the dimensionally correct nT/m unit.
• mspy filter observations --profile-gradient-max non-destructive profile rejection/cleaning workflow.
• Profile-specific CSV, QC, GIS, PNG and JSON report products.
• mspy figure profile profile-figure regeneration.
• RawData/Profile/ project folder and profile project/import category.

Validation

The GEO4120 Lake Balaton exercise is included as the main regression dataset in tests/data/ using CSV extracts from the supplied teaching workbook. Tests cover exact time matching, direct and variation-only correction, linear normal-field correction, gradient QC, delimiter handling, multiple-profile layouts and incomplete base-station coverage.

A regression guard records SHA-256 hashes for the existing analysis.py, figures.py and point_filters.py scientific modules from the uploaded public v1.0.3 source so unrelated numerical-processing changes are detected. Web GIS functionality is unchanged apart from version metadata.

Scientific clarification

The GEO4120 worksheet gives the along-profile gradient formula as a field difference divided by distance along the profile. Because the supplied distance is in metres, MagSurveyPy reports this QC quantity in nT/m. It does not reproduce the worksheet's isolated nT/km label.