GeoMagR v0.3.1
Main
-
Fix missing stationary-period IDs turning magnetic likelihood maps into
NA. -
Compute flight acceleration averages over non-missing measurements. Calibration results change when flight samples have partially missing acceleration axes; results are unchanged on
14DM.
Minor
-
Report
rmse_Ias an inclination angle residual. The reported diagnostic changes from the residual ofsin(I)to degrees; calibration itself is unchanged. - Correct the projected-frame documentation and acceleration plot labels to z up. Numerical values are unchanged.
-
Respect
quiet = TRUEfor calibration-data messages and warn whenever intensity calibration lacks a known-location anchor. -
Make
tag_static(use_activity = TRUE)deterministic without advancing the random seed. - Record an unknown WMM version for reference maps without provenance.
- Shorten the getting-started vignette maps, keep one basemap behind the likelihood, and make areas outside the 99% likelihood region transparent.
Full Changelog: https://github.com/GeoPressure/GeoMagR/compare/v0.3.0...v0.3.1
GeoMagR 0.3.0
Calibration
geomag_calib() now has a single gravity-aided fit, chosen from a benchmark on 77 tags of 13 species (5-min to 6-hourly logging). Results change for every tag.
- The fit makes the field intensity and the inclination measured against gravity constant within each stationary period (or day without
stap_id), anchored to the WMM at stationary periods with a known location. The sensor scale is kept. Median static inclination error on stationary periods of unknown location: 2.1° (previous defaultellipse_stap: 2.3°, which failed on 5 tags). -
calib_methodis"ellipse"(default) or"sphere"."near-sphere","sphere_stap"and"ellipse_stap"are retired and map to the new fit with a warning. - Only static samples are used. With field data, flights of at least 12 samples are added with the flight-mean acceleration (birds that rest in a single orientation, e.g. owls), and all flight samples are tilt-corrected with the flight-mean acceleration instead of single snapshots.
- Give a stationary period with a known location (e.g. the equipment site): without it, the intensity is not anchored and
geomag_calib()warns. -
calib_thr_extremeis now the maximum difference from the median raw norm, not an absolute norm. The preliminary sphere fit and MAD filter ofrm_outlierare removed. - A missing calibration directory now gives an error instead of silently using field data.
-
geomag_calib_rotate()is vectorised (same output, about 1000 times faster on 5-min data).
Behaviour changes
-
tag_static()now usesstatic_thr_hard = 0.1by default (was 0.15), the same asgeomag_calib(), so acceleration plots of an uncalibrated tag match the calibration. -
plot_mag(type = "histogram"): the observation panel now shows each sample minus its stationary-period mean, whose SD estimatessd_e_*. It previously showed observation minus WMM, whose SD mixessd_e_*andsd_m_*.
GeoMagR 0.2.3
Faster likelihood maps and documentation updates. Results are unchanged (all.equal() to 0.2.2 on the bundled 14DM example).
-
geomag_map()computes the likelihood with its closed form, a Gaussian of the mean of the observations with variancesd_m^2 + sd_e^2 / n, instead of looping over every map cell. It is about 20 times faster on the14DMexample and more than 100 times faster on large maps. - Simpler code for
geomag_map_ref()and the sample selection ofgeomag_map(). - The documentation now gives the units of the
sd_*arguments, which samples are used, the return value ofgeomag_map_ref()(a two-layerSpatRaster), and theuse_activitystep oftag_static(). - The getting-started vignette now calls
tag_set_map()beforegeomag_calib(), so theellipse_stapcalibration uses the known breeding site as in the movement-model vignette.
GeoMagR 0.2.2
Bug fixes only. Results on the bundled 14DM example are unchanged, except for one calibration sample that was wrongly dropped before.
Magnetic likelihood
-
geomag_map(quiet = TRUE)no longer shows the progress bar of the default reference map. -
clean_I()now excludes non-finite inclination. A singleNAinclination on a static sample previously turned the whole inclination likelihood map of its stationary period intoNA.
Calibration
-
geomag_calib()no longer fails when the magnetic data containNA: incomplete rows are removed before the calibration outlier filter. - The centred-norm filter of the calibration data (
0.25 < norm < 0.65) was misaligned, which added all-NArows and dropped valid samples. -
geomag_calib()now errors whencalib_datais a path to a directory that does not exist, instead of silently using field data. - The
sphere_stapmethod now uses the optimisercontrolsettings likeellipse_stap. - The
*_stapmethods no longer need R >= 4.4 (%||%removed). -
tag$param$geomag_calib$rotMis now the identity (not a permutation) for thesphereandsphere_stapmethods. Calibrated values are unchanged. -
tag_static()keeps samples with missing acceleration asNAinstead of failing, anduse_activity = TRUEno longer depends on the row order oftag$magnetic.
Plots
-
plot_mag(type = "timeseries"): outlier legend labels for intensity and inclination were swapped. -
plot_mag(type = "histogram"): facet labels now show σ instead of the literalσ. - Plots with a
pathwork on R 4.1 and 4.2, and the WMM reference no longer depends on the session time zone. - The colour palette has the right length when there is a single stationary period.
