GeoPressureR v3.9.1
Main
-
Add
tag_label_check(): short stationary periods, short flights and large hourly pressure changes as data.frames. The TRAINSET Check panel andplot_tag_pressure()now use it. -
Add
pressurepath_check()(renamed): the error of each stationary period and elevation level (empirical sd vs thesdused, offset, outliers), as inplot_pressurepath(type = "histogram"), which now uses it. It also works on ageopressure_timeseries()output. -
Add
tag_label_stapelev(): TRAINSET’s automatic stapelev for one stationary period at a position, from a script. It returns thetagwith the labels of that stationary period replaced, as TRAINSET’s Apply does. The algorithm moved frominst/trainset/into the package, and TRAINSET uses the same functions. -
Add a per-stapelev table to the pressure maps (
tag$map_pressure$stapelev) and a warning ingeopressure_map_mismatch(): one row per map requested with its number of samples, land pixels, pixels passing the mask and smallest MSE, before the elevation levels of a stationary period are combined. When no pixel of a stationary period passes the mask, a warning names it and the levels responsible. -
Add
keep_mask_splittogeopressure_map(): GeoPressureAPI also returns the share of samples above and below the ground, summarised asfrac_aboveandfrac_belowin the stapelev table, and the warning says whether a masked level is mostly above or below the ground. It needs a GeoPressureAPI version withincludeMaskSplit; older versions warn and continue without it. -
Record provenance of every step:
param$provenance$geopressure_map,$pressurepath_create(in the Template) and$graph_add_wind, and the attributeprovenanceofgeopressure_timeseries()andpressurepath_create()outputs, with the same fields: GeoPressureR version, date, source ("GeoPressureAPI","arco","api", or the wind source"cds","gcs","unknown"), ERA5 dataset, altitude formula and the GeoPressureAPI provenance objects (NULLwith older API versions).print.param()lists it, and GeoPressureAPI errors show the API version. The pressurepath attributessourceandera5_datasetare kept for this release. -
Add
twilight_check(): the solar zenith angle of each twilight at the position of its stationary period and whether it falls outside the calibrated range, asplot_twl_calib(tag, path)flags per stationary period. The plot now uses it.
Minor
-
Download the pressure maps with
httr2::req_perform_parallel()instead offutureworker sessions: the download step ofgeopressure_map()takes about 1–2 s instead of 5 s on 18LX, with the same steps, progress bar, error messages and files.future,future.applyandprogressrare no longer dependencies, andhttr2(>= 1.1.1) is required. -
Send
pressurepath_create()requests to GeoPressureAPI in chunks of about 500 points (workers = "auto"), about twice as fast with identical results. -
Read wind files with ascending pressure levels (old CDS files made with
grib_to_netcdf), detected from the levels of each file. They aborted since 3.8.0. From 3.6.0 to 3.7.x, wind computed with such files used the wrong pressure level (e.g. the 950 hPa wind for a bird at 980 hPa): results ofgraph_add_wind()andedge_add_wind()from these versions with old CDS files should be recomputed. -
Make
tag_label_auto()deterministic: the k-means clustering starts from the lowest and highest activity instead of random centres (without using the random number generator), and the sampling interval is the median interval instead of the first one. Labels of the example tags are unchanged. -
Fix
plot_pressurepath()with a singlesdon a pressurepath whosestap_idis not 1 (e.g. ageopressure_timeseries()output of one stationary period): the outlier thresholds and the histogram colours wereNA. -
Share the parsing of
elev_nlabels betweengeopressure_map_preprocess(),geopressure_timeseries(),pressurepath_create()andplot_pressurepath().
Behaviour that users relied on has changed:
- Pressure maps at
scale = 4computed through GeoPressureAPI move by one ERA5 row in latitude, because/map/now takes the same ERA5 cell as/timeseries/,/pressurePath/and ARCO (GeoPressureAPI#38). Results computed before and after differ slightly. This is a server-side change: it applies to every GeoPressureR version calling the API. -
geopressure_timeseries()andpressurepath_create()with the API now abort (HTTP 416) for dates after the end of ERA5, instead of silently dropping those points (GeoPressureAPI#38). - Wind computed in 3.6.0–3.7.x from wind files with ascending pressure levels (old CDS files) used the wrong pressure level and should be recomputed. These files now give the same wind as descending files.
-
future,future.applyandprogressrare no longer imported, so they are no longer installed with GeoPressureR.httr2(>= 1.1.1) is required.
Full Changelog: https://github.com/GeoPressure/GeoPressureR/compare/v3.9.0...v3.9.1
GeoPressureR v3.9.0
Main
-
Add
source = "gcs"totag_download_wind()to read ERA5 pressure levels from the public Google ARCO-ERA5 store on Google Cloud Storage, which has no CDS queue (#189). It writes the same files assource = "cds", andworkersdefaults to 6 for it. -
Write smaller wind files in
tag_download_wind(): only the flight hours, values packed as 16-bit integers (wind to 0.01 m/s), with CF attributes (units,long_name,standard_name) taken from one ERA5 variable table. Existing files still work withedge_add_wind()andgraph_add_wind(). -
Lower the default
workersoftag_download_wind()from 19 to 2 forsource = "cds": the CDS rejects queued requests beyond about 2–3 per account and dataset, so the old default lost most flights without speeding anything up. -
Speed up
graph_add_wind(), process its edges in blocks and prunethr_asedges on flat vectors: about 2–3× faster and with lower peak memory on large graphs, with identical results. A graph disconnected bythr_asnow aborts with a message suggesting a largerthr_as. -
Add
constant_speedtograph_add_wind()andedge_add_wind(): withconstant_speed = "airspeed", the bird flies a constant air velocity (speed and heading) and the wind is averaged along the track curved by the wind (approximated by the straight edge plus the drift by the wind anomaly along it) instead of along the straight edge flown at constant groundspeed (default, unchanged results). It takes about 1.5–3 times longer and mostly matters for long flights (> 8 h). The choice is stored inparam$graph_add_wind(and can be set inconfig.yml) and followed byedge_add_wind(), which can also refine the wind along a path on its own. -
Deprecate
interp_spatial_linearingraph_add_wind()andedge_add_wind(): wind is always taken from the nearest ERA5 grid cell. Bilinear interpolation changed airspeed by about 0.3 km/h (median) for a 4–6× longer run time.pracmais no longer a dependency. -
Abort
tag_create()on an unreadable SOI.settingsfile instead of printing a message and continuing without the clock drift and magnetic data. -
Always warn when
tag_create()drops SOI magnetic data: when the hardware version cannot be read from the.settingsfile, or there is no.settingsfile, the magnetic and acceleration data are not imported. This was silent withquiet = TRUE(e.g. ingeopressuretemplate()) or without a.settingsfile. -
Validate
crop_startandcrop_endintag_create(): a date that does not parse fully (e.g."2018-07-015", read as 1 July before) now aborts.
Minor
-
Bind a list of
knownrecords by row intag_set_map(), e.g. YAML- stap_id: 1items, instead of keeping only the first with a warning. -
Warn in
geopressuretemplate_config()whenconfig.ymlhas no entry for the tag id (onlydefaultis used) and when function arguments (e.g.crop_start) sit directly under the tag id, where they are ignored. -
Warn when
geopressuretemplate_graph()fails: the graph is still returned without saving, but with a warning carrying the original error instead of a printed message, so a failure in a batch run is no longer mistaken for a success. -
Explain how to fix
map_lightwithout light data ingeopressuretemplate_tag()instead of the error “light is not a data frame”. -
Abort
plot.map()on an unknown palette name withplot_leaflet = FALSEinstead of silently using the default palette, and draw"magma"and the other viridis palettes in static plots, which used to fall back to a blue ramp. -
Correct the ERA5 availability warning in
geopressure_map(): ERA5 on Google Earth Engine lags about a week, not three months, so the warning now only flags data from the last two weeks. - Documentation: the elevation mask of
geopressure_map()uses the Copernicus GLO DEM, not SRTM-90; Trainset Save always writes{id}-labeled.csvintag_label(); twilight labels come from GeoLightViz intwilight_label_read(), not TRAINSET; corrected page range of the 2023 trajectory paper in the citation. - Internal changes without change in results: validation only at public entry points (tag readers, TRAINSET files, light refinement),
cliandgluemessages,codemeta.jsonremoved and docs updated to roxygen2 8.1.1.
Full Changelog: https://github.com/GeoPressure/GeoPressureR/compare/v3.8.0...v3.9.0
GeoPressureR v3.8.0
Main
Map SOI magnetic axes as forward = raw y, right = raw x for all hardware versions (
mag_axis = c("right", "forward", "down")) intag_create(). The previous mappings were 180° off for hardware ≤ 2.3 and used the wrong axis for ≥ 2.4. Magnetic and acceleration x/y of SOI tags change, and so do headings computed from them; intensity and inclination do not. A warning flags tags resting tilted backwards (possibly mounted reversed).Normalize each stationary period in
graph_marginal(). Map shapes are unchanged, but each stationary period is now a probability map scaled by the global maximum, and long tracks no longer fail with numerical underflow.Integrate wind exactly over each flight in
edge_add_wind()andgraph_add_wind(). The first and last hours were weighted about twice too much, so wind and airspeed change, most for short flights.Compute
pressurepath_create()one trajectory at a time for paths with several trajectories (columnj, e.g.path_simulation).Return the crosswind component from
windsupport(drift = TRUE)as documented.Simplify GeoPressureViz: remove position interpolation, the Save button writing to
data/interim/and the returned path. Use the app’sExport CSVbutton to keep an edited path.Abort
tag_set_map()on new parameters when likelihood maps exist instead of prompting to delete them; start again fromtag_create().Use
terra::rast(map)to convert amapto a SpatRaster;rast.map()is no longer exported.Add a
mag_axisargument totag_create()for SOI tags mounted reversed or at 90°.Keep objects such as
path_geopressurevizwhengeopressuretemplate_graph()re-saves the interim file.geopressuretemplate_pressurepath()computes onlymost_likelyandsimulation; for other paths (e.g. exported from GeoPressureViz) callpressurepath_create()directly (#162).Store logger metadata under
param$tag_create:settings(the manufacturer settings with normalisedmodel,firmwareand, for SOI,clock_drift) andmag_axis, replacingparam$soi_settings,param$migratec_model,param$driftandparam$mag_axis. Released together with GeoLocatoR, which reads both layouts.Weight edges spanning several flights by flight duration in
edge_add_wind(); weights now sum to 1 per edge, as ingraph_add_wind().Fix the end of stationary periods in
tag_label_stap()for irregularly sampled data.
Minor
-
Guess
twl_offsetwith a circular mean of daylight hours, fixing tags at longitudes beyond about ±130°. -
Use a centred smoothing window in
geopressure_map_preprocess(), removing a +30 min shift for hourly and 20 min pressure data. - Round ERA5-Land latitude ties the same way in all ARCO queries.
-
Use the land cover fraction in
map_add_mask_water()so thatland_thresholdtakes effect. -
Keep the basemap choice in
plot.map(). -
Keep valid edges on large grids in
graph_create()and stay-in-place edges ingraph_add_wind(). - Regenerate the 18LX example outputs and fix typos in messages.
- Rename
map_add_tiles()toleaflet_add_basemaps()and thestap2duration()argumentstap_pathtostap; the old names are deprecated.geolightviz(quiet)is deprecated. -
tag_label_stap()andtag_stap_daily()also addstap_idto temperature sensors (sensor names defined once). - Internal refactoring without change in results: one wind interpolation code path, shared ERA5 grid, land-sea mask and validation helpers (the ERA5-Land altitude deprecation warning now also applies to
source = "api"), simpler tag readers andtag_assert(), dead code removed and Shiny server files split. - Fix smaller issues found in the review: clearer errors (fewer than two stationary periods, airspeed without wind, all-known twilights), NA pressure sent as JSON
nullto GeoPressureAPI,map[["stap"]]and a defaultstap$includeinmap_create()(tag, map and template), 3-cyclemag_axisrotations, background Shiny apps that fail to start, and TRAINSET and GeoPressureViz interactions. - Final review fixes: order path rows in
path2edge(), requirepressureingraph_add_wind(), stopgeopressuretemplate()after a failed graph step, keep small islands inmap_add_mask_water()by default, exact ERA5 grid ties, GeoLightViz labels and predicted lines, smaller tag fixes and a documentation review.
Full Changelog: https://github.com/GeoPressure/GeoPressureR/compare/v3.7.1...v3.8.0
GeoPressureR v3.7.1
Main
-
Fix
gsandwsassigned to the wrong edges bypath2edge()when several paths share a transition. Affectsedge_simulationsince v3.2.0; single paths are unaffected. -
Stop
geopressuretemplate_graph()from overwriting saved outputs when a step fails. -
Stop
geopressure_map_preprocess()from creating pressure samples inside gaps longer than about 1.5 h (discard runs,elev_nsegments) since v3.0.0. -
Keep times of day when
read_stap()reads a CSV written bywrite.csv(). -
Store Migrate Technology and PresTag temperature as
temperature_externalinstead oftemperature.
Minor
-
Rename the
tag_stap_daily()output columnstap0tostap_long. Scripts usingtag$stap$stap0should usetag$stap$stap_longinstead. -
Fix GeoPressureViz display of marginal maps with very small values by normalizing each stationary period before projection, consistent with
plot.map(). -
Show night periods in
plot_pressurepath(). - Default TRAINSET automatic elevation labelling to the latest cached pressure query.
- Fix about 65 smaller bugs and crashes, including sensor-file detection in
tag_create(),tag_set_map()overwrites, stalestap_idintag_stap_daily(), duplicated rows in multi-pathpressurepath_create()and graph pruning. - Fix the Shiny apps: GeoPressureViz position interpolation, save location and return value; GeoLightViz twilight clicks; TRAINSET time zones outside UTC.
- Fix typos and documentation throughout.
Full Changelog: https://github.com/GeoPressure/GeoPressureR/compare/v3.7.0...v3.7.1
GeoPressureR v3.7.0
Main
-
Default altitude retrieval to ERA5
"single-levels"inpressurepath_create(),pressurepath_create_api(),pressurepath_create_arco(),geopressure_timeseries()andgeopressure_timeseries_arco(), based on the altitude validation findings."land"and"both"remain supported, but computing"altitude"with them now gives a deprecation warning. Scripts relying on the previous defaults should specify their dataset explicitly to preserve their results. -
Default pressure maps to ERA5
"single-levels"ingeopressure_map()andgeopressure_map_mismatch(). Explicit dataset overrides remain supported without deprecation warnings.tag_set_map()now defaults toscale = 4(0.25°) and warns for higher values, which interpolate ERA5 single-levels data (#166). -
Default pressure-path altitude to virtual temperature, matching GeoPressureAPI PR #32, based on the altitude validation.
altitude_formula = "virtual"uses ERA5 2 m dewpoint to account for humidity and the temperature lapse rate of the GPT3 empirical troposphere model (Landskron & Böhm 2018), whose 1° grid is downloaded once from TU Wien and cached. On held-out radiosonde stations, bird-weighted altitude bias improves from −11.9 m to −3.2 m and mean absolute error from 16.4 m to 13.1 m. GeoPressureAPI still computes"virtual"with the lapse rate varying with season and latitude of PR #32 until it adopts GPT3. Usealtitude_formula = "standard"inpressurepath_create()or its backend shortcuts to reproduce the previous formula. The pressure-path change requires coordinated deployment with GeoPressureAPI PR #32. -
Use virtual altitude by default for time series too in
geopressure_timeseries()and its API/ARCO shortcuts. Both backends honouraltitude_formula = "virtual"or"standard"andera5_dataset = "single-levels"(default) or"land". Fix the seasonal lapse rate when one latitude is used for multiple dates. The API time-series change and shared Python altitude implementation are included in GeoPressureAPI PR #32, justified by the altitude validation. -
Fix ARCO altitude using the elevation of the wrong longitude in
pressurepath_create()andgeopressure_timeseries(). Recent GDAL reads the ECMWF geopotential and land-sea mask grids already on −180…180, so forcing a 0…360 extent and rotating them shifted both by 180°: altitude used the surface elevation of the antipodal longitude (often ~0 m ocean), giving strongly negative ground and flight altitudes over high terrain (e.g. −1150 m instead of ~470 m in Valais). Pressure paths computed withsource = "arco"should be recomputed. -
Read
path2elevation()ground elevation from precomputed Copernicus GLO-90 statistics instead of GeoPressureAPI. The minimum, 10th–90th percentiles and maximum of the 90 m DEM within each cell of thetag_set_map()grids (scale1, 2, 4, 5, 10) are built reproducibly bydata-raw/ground_elevation.R, published as theground-elevation-v1release and downloaded once per scale (0.4–33 MB). Arguments, defaults and output columns are unchanged. Percentiles now describe the real terrain within a cell (the API layers were smoothed, with valley floors up to ~1000 m too high, GeoPressureAPI#33),percentilealso accepts0(minimum) and100(maximum),lon/latare the centres of the cells read, and a call takes ~0.05 s instead of 2–10 s.
Minor
Validate
path2elevation()percentiles locally before reading the precomputed terrain grid. Supported values are0, 10, ..., 100; unsupported values fail with an actionable error.Clarify
path2elevation()computation and returned columns: document Copernicus DEM percentiles, elevation grid resolution versus sampling distance, missing positions and DEM values, and distance-based fractionalstap_id. Add an example mapping median ground elevation onto a pressure path and computing altitude above ground level, assuming constant speed along each flight segment.Add offline virtual-altitude regression tests for numerical parity, seasons and hemispheres, standard-formula reproducibility, API parameters, dewpoint retrieval and output structure. Replace the map-default test’s
rlang::abort()withcli::cli_abort().Report why
geopressure_map_mismatch()failed. When GeoPressureAPI returns no url for a stapelev, report the reason returned by Earth Engine instead of assuming ERA5 data are unavailable. A total failure still aborts and a partial failure still warns, naming the failing stapelev and the server’s explanation.Match every measurement to its nearest ERA5 hour on the ARCO backends of
pressurepath_create()andgeopressure_timeseries(), including the first. Measurements before the first full hour previously used the next hour, matching a GeoPressureAPI bug fixed in GeoPressureAPI#31.
Full Changelog: https://github.com/GeoPressure/GeoPressureR/compare/v3.6.8...v3.7.0
GeoPressureR v3.6.8
Main
- Redesign automatic elevation labeling in TRAINSET with a compact table, user-defined levels and time ranges, per-level pressure tolerances, day/night selection and optional continuity filtering. Initialize offsets from shared settings or adjust checked levels, then preview before replacing the selected stationary period’s non-flight labels.
Minor
- Restore unfinished elevation proposals from local drafts and add shared Undo/Redo for manual and automatic label edits. Automatic backups no longer mark unsaved edits as saved.
- Reduce TRAINSET plot payloads by removing repeated hover metadata and redundant date-axis categories, preserving plotted measurements and selection indices.
- Fix pressure preprocessing for short stationary periods that contain a single hourly reading, with a regression test covering these periods.
-
Remove floating-point artifacts when importing Migrate Technology pressure data in
tag_create(): retain 15 significant digits after converting Pa to hPa, preserving measurement precision and avoiding spurious decimal digits in datapackage exports. - Warn and continue when a sensor data file contains no measurements.
Full Changelog: https://github.com/GeoPressure/GeoPressureR/compare/v3.6.7...v3.6.8
GeoPressureR v3.6.6
Main
-
Read the air and body temperature of SOI tags with firmware 2.4 and later in
tag_create(). The SOI decoder names these files*.AirTemperatureand*.BodyTemperature, which the case-sensitive file detection missed, so they were silently skipped. Sensor file arguments are now matched as case-insensitive wildcard patterns (*matches any characters), and"*.temperature"no longer matches*.BodyTemperature. -
Set SOI decoder gaps to
NA. The decoder writes-2in every column of rows it could not reconstruct. These rows are nowNAinacceleration(includingmean_acceleration_z),temperature_internalandmagnetic, where they previously appeared as measurements (magnetic gap rows became near-zero vectors). Intemperature_external,-2cannot be told apart from a −2 °C measurement and is kept.
Minor
-
Store the SOI clock drift with its sign:
tag$param$driftis the tag clock minus the reference clock at download, in minutes, positive when the tag clock is ahead (previously its absolute value). The drift is skipped instead of failing when*.settingslacksRecordingStopor the stop times. -
Document the meaning, units and resolution of each SOI sensor in
tag_create(), and how to correct the SOI clock drift withtime_drift. -
Fill interactive maps to the viewport height in
plot.map()andplot_path().
Full Changelog: https://github.com/GeoPressure/GeoPressureR/compare/v3.6.5...v3.6.6
GeoPressureR v3.6.5
Main
-
Run examples offline from a shipped 18LX fixture. The precomputed output of
geopressuretemplate("18LX")is now included ininst/extdata/data/interim/18LX.RData(regenerated withdata-raw/fixtures.R) and loaded withload_interim()in examples, soR CMD checkno longer queries GeoPressureAPI and example time drops from about 6 minutes to under 30 seconds. Examples that need GeoPressureAPI (geopressure_map(),geopressure_timeseries(),pressurepath_create(),path2elevation()) run only on the pkgdown site, and the examples ofload_interim(),path2edge(),graph_assert(),ts2mat(),speed2bearing()andwindsupport()now run. -
Split tests into offline, online and full levels selected with the
GEOPRESSURER_TESTenvironment variable (default"offline").R CMD checkruns the offline level on all platforms, the coverage workflow adds tests querying GeoPressureAPI, ARCO and elevation ("online"), and the"full"level reruns the fixture workflow, the Shiny apps and the CDS wind downloads. -
Make trajectories visible on dark basemaps:
plot_path()draws the leaflet trajectory in grey, with a fainter dashed line across missing positions, andplot.map()opens on the first stationary period without known position.
Minor
-
Fix wind support for NetCDF files currently returned by the CDS:
edge_add_wind()andgraph_add_wind()failed on downloaded wind files because the CDS now stores variables under their GRIB short names (u,v,t). - Cancel superseded pull-request CI runs.
-
Silence progress messages in examples with
quiet = TRUE.
Full Changelog: https://github.com/GeoPressure/GeoPressureR/compare/v3.6.4...v3.6.5
GeoPressureR v3.6.4
Main
-
Keep the trajectory index
jon the flight rows ofpressurepath_create()output. Rows between two stationary periods (fractionalstap_id) found no match inpathand were left withj = NA, so joins ontypeandjsilently dropped them (GeoPressureR <= 3.6.3). Every published GeoLocator Data Package withpressurepathsis affected; GeoLocatoR repairs them on read, and GeoLocator-DP v1.2 requiresj.
Full Changelog: https://github.com/GeoPressure/GeoPressureR/compare/v3.6.3...v3.6.4
GeoPressureR v3.6.3
Main
Validate graph outputs and simulation count after applying direct template parameter overrides.
Use
path_simulationwhen creating simulation pressure paths ingeopressuretemplate().Add sensor clock drift correction to
tag_create(), alongsidetime_shift(hours):time_driftis in hours per 365.25-day year, with positive values adding time. Both accept a scalar for all sensors or a named list; omitted sensors receive zero correction.time_referencedefaults to the earliest original measurement across all sensors, or accepts an explicit UTC timestamp. Corrections use original timestamps and a shared reference, independently of recording duration, before cropping (#177).Round all sensor timestamps to milliseconds after correction and before cropping, including when no correction is supplied. Warn when rounding creates new duplicate timestamps, even with
quiet = TRUE, while retaining all measurements. Timestamp-based labels cannot distinguish colliding readings.Preserve millisecond timestamps throughout label files, TRAINSET saves, downloads, backups and chart selections, light grids and measured/astronomical twilights. Restore original measurement timestamps before joining pressure API responses that truncate times to whole seconds; stop on ambiguous incomplete responses. Keep exact label matching, tolerate millisecond rounding in sampling checks, and use complete daily light grids and whole-hour pressure grids. Rerun analysis from original raw data and regenerate timestamp-dependent labels when changing clock corrections.
Breaking change: rename the
geolight_map()argument and stored configuration keyrefine_fitted_location_scale_kmtorefine_fitted_location_scale. Update scripts, configuration files andparam$geolight_map; the old name is no longer accepted. Units remain kilometres and the default remains 20. Internalscale_km,radius_lat_kmandradius_lon_kmlikewise becomescale,radius_latandradius_lon.
Minor
Keep TRAINSET measurement and elevation-proposal charts on date axes, preserving millisecond timestamps while displaying readable automatic date/time ticks at each zoom level.
Add fast, offline regression tests for template parameter handling, output selection and ARCO processing, and ARCO chunk reuse.
Document the argument naming convention in
AGENTS.md: public and internal argument names omit unit suffixes; parameter documentation states fixed units and duration conventions for rates.Add regression tests for corrections, millisecond rounding and collisions, label round trips, TRAINSET saves and selections, twilights, API joins and processing grids. Validate the supplied 29JH data (21,272 pressure readings) with zero and ±12 minutes/year drift and live API queries. The full test suite passes with one existing wind-test skip and one unrelated API altitude warning; formatting and lint checks pass.
Full Changelog: https://github.com/GeoPressure/GeoPressureR/compare/v3.6.2...v3.6.3
GeoPressureR v3.6.2
Main
-
Document that
era5_dataset = "single-levels"gives the most accurate altitude inpressurepath_create(),pressurepath_create_api(),pressurepath_create_arco(),geopressure_timeseries()andgeopressure_timeseries_arco(): against 271 NOAA ISD stations, altitude mean absolute error is 9 m, against 55 m for"land"and"both". Defaults are unchanged in this release. -
Validate
variableagainst the resolved backend and ERA5 product, with an error naming a working configuration and suggestions for near-misses, instead of returning all-NAcolumns. Addpressurepath_variable_available()to list the variables eachsourceandera5_datasetcan return. - Extend the ARCO backend to 20 ERA5 single-levels and 16 ERA5-Land variables, up from surface pressure alone, using the same variable names as GeoPressureAPI.
-
Give both pressurepath backends one output contract: columns are now always ordered as
date,stap_id,pressure_tag,label,lat,lon, then the requested variables in the order asked for, any other columns, and finallysurface_pressure_norm,sunsetandsunrise. The ARCO backend no longer addssurface_pressurewhen it is not invariable, matching the API backend, andera5_dataset,sourceandvariableare recorded as attributes. -
Use one variable vocabulary across the wind pipeline:
edge_add_wind()now takes the same long names astag_download_wind()(GRIB short names are deprecated) and itsvarcolumn holds long names;tag_download_wind()validatesvariable.
Minor
-
Record more analysis parameters in
paramfor provenance (geopressure_map(),geolight_map(),tag_label_auto(),tag_stap_daily(),graph_add_wind()). -
Document
pressurepath_create_api()andpressurepath_create_arco()on thepressurepath_create()page and fix equation rendering on the pkgdown site, and likewisegeopressure_timeseries_api()andgeopressure_timeseries_arco()on thegeopressure_timeseries()page. - Improve GeoLightViz labeling controls and documentation.
-
Surface the
warningfield returned by GeoPressureAPI instead of silently discarding it. - Document the accuracy of pressure-derived altitude: ~3 m for relative altitude changes at a fixed location and ~10 m mean absolute error for absolute altitude.
- Document that accumulated ERA5-Land variables differ between backends: hourly increments from the API, accumulated from 00 UTC from ARCO.
Full Changelog: https://github.com/GeoPressure/GeoPressureR/compare/v3.6.1...v3.6.2
GeoPressureR v3.6.1
Main
- Add direct ECMWF ARCO backends for ERA5 time-series and pressure-path retrieval, with automatic selection when ECMWF credentials are available (a29023d3, 56be206e).
- Add automatic elevation-label proposals to Trainset.
- Add configurable basemap layers to maps and visualization apps.
- Process graph candidate pairs in bounded blocks for more scalable graph construction.
Minor
- Refine fitted calibration locations and fix GeoLightViz calibration stationary-period selection.
- Improve twilight and actogram plots, including labelled flights and GeoLightViz styling (89478ebf, 111ae8ad).
- Preserve CSV timestamp seconds and handle missing sensor readings in wind workflows.
- Improve graph and labeling diagnostics and GeoPressureViz background-query lookup.
Full Changelog: https://github.com/GeoPressure/GeoPressureR/compare/v3.6.0...v3.6.1
GeoPressureR v3.6.0
Main
Prepare for the release of GeoPathSampleR package and GeoTwilight paper:
- Strengthen fitted-location estimation with multi-start optimization, normalized twilight residuals, and a zenith-angle prior.
- Refine fitted calibration anchors using local twilight likelihoods before global calibration.
- Expose fitted-anchor diagnostics in the calibration workflow and plotting functions.
Minor
- Add experimental
geopressure_timeseries_arco()access to ERA5 and ERA5-Land ARCO data, with optional altitude computation and the same CDS credentials configured byecmwfr::wf_set_key(). - Add experimental
pressurepath_create_arco()for direct ARCO surface-pressure and altitude retrieval along stationary periods and flights. -
Add
time_shifttotag_create()with corresponding parameter display and test coverage. -
Improve
find_stap()handling of non-regular stationary-period IDs while preserving the correct IDs. -
Add
land_thresholdtomask_water()for configurable land masking. -
Rename
max_twl_gap_hourstomax_twl_gapin daily stationary-period generation. -
Rename
tag_stap_daily()arguments:stap0becomesstap_longandtwl_groupingbecomesmovement_period, with deprecated aliases retained for compatibility. -
Allow
plot_twl_calib()without a zenith column by defaulting to known zenith values. - Improve Plotly relayout and range-selection handling, including epoch-millisecond event times and hidden overview traces (8efc6f9c, 51efd0e5).
- Fix map-setting invalidation when labels change and handle missing values in logical indexing.
-
Add grouped Leaflet layers to
plot_path()for clearer posterior-path visualization. -
Preserve pressure metadata during
geopressure_timeseries()normalization. -
Fix the
maxSamplerequest parameter used bygeopressure_map_mismatch(). - Improve GeoPressureViz background pressure queries when running from a development source tree (f13c1e7a, f61a3fff) and provide clearer query errors.
- Add an explicit close button to the Trainset Checks modal.
- Expose likelihood and distance helpers for companion packages while keeping them internal to GeoPressureR.
GeoPressureR v3.5.4
Main
-
Refactor wind extraction for large graphs:
graph_add_wind()now computes averagedu/vwind directly in memory-efficient chunks, whileedge_add_wind()returns detailed edge/time/variable values. Thegraph_add_wind(variable)andedge_add_wind(return_averaged_variable)arguments are deprecated, and GeoPressureViz now aggregates the detailed output explicitly. -
Improve
graph_create()memory use by releasing intermediate graph chunks while building the final graph vectors. -
Document and export
tag_status()for companion packages.
Full Changelog: https://github.com/GeoPressure/GeoPressureR/compare/v3.5.3...v3.5.4
GeoPressureR v3.5.3
Minor
- Improve read_stap input handling and docs
- Improve
geopressure_map()debugging by writing request bodies and full HTTP traces to temp log files. - Improve
geopressure_map()download failures error message. - Strengthen
era5_datasetdocumentation to warn that"both"is slower and can trigger memory failures on long stationary periods. - Fix the
.Rbuildignoretrailing newline warning during package build.
Full Changelog: https://github.com/GeoPressure/GeoPressureR/compare/v3.5.2...v3.5.3
GeoPressureR v3.5.1
Minor
- Labeling / Quiet behavior: Fix missing quiet checks in labeling paths
- Remove experimental lifecycle badge from trainset
Full Changelog: https://github.com/GeoPressure/GeoPressureR/compare/v3.5.0...v3.5.1
GeoPressureR v3.5.0
New functions related to light
- Add tag_stap_daily() to build stap from twilight midpoints and add read_stap() to validate/read stap files
- Add map_add_mask_water() for water masking and mask water pixels in plot.map() filtering
- Create geolight_fit_location(), refactor geolight mapping pipeline, and modularize geolight map flow
- Create twilight calibration plotting (plot_twl_calib)
Minor fixes
- Make stap filtering robust to missing columns
- Fix missing known lat/lon edge case
- Restrict merged path columns in pressurepath creation
- Move ecmwfr and ncdf4 to Suggests with runtime checks
- Use vapply and memory-focused cleanups, opt pass 1, opt pass 2
- Refine messaging / remove multiline cli text
- Switch formatting/lint workflow to air+jarl (follow-up fixes)
- Refactor plot.tag() dispatch/modularity
- Refactor plot.map() args/path plotting
- Refactor plot_path() customization/static mode
- Improve plot_graph_movement() options and annotations / visual polish
Full Changelog: https://github.com/GeoPressure/GeoPressureR/compare/v3.4.5...v3.5.0
GeoPressureR v3.4.5
Main
- Add ability to not read a sensor file with
file= "" - Improve the computation of the decimal of stap_id during flight in
find_stap() - Remove bearing value of 0 when no movement and Normalize bearing to 0-360 degrees in path2edge
- Add twl_time_tolerance parameter to time series functions
- Improving tag_create: fix issue with multiple col and Simplify the approach avoiding memory error
- Switch from lintr+styler to air+jarl link
Minor fixes
- Remove unused ‘directory’ argument from tag_create_dataframe
- Refactor trainset_read to use trainset_read_raw helper
- Remove
timeoutin pressurepath_create, geopressure_timeseries() and path2elevation() - Add fix for migratech “invalid” keyword in file
- Fix issue when migratech deg file has no pressure
- Refine twilight threshold calculation logic
- Swap point colors in plot_tag_twilight function
- Refactor test setup to use temporary extdata directory
- Improve messaging 1 2, 3
GeoPressureR v3.4.4
What’s Changed
Refactored wind
filepath argument to accept bothstap_idandtag_id.[1] [2] [3] [4] [5] [6] [7] [8]Enhanced the
print.graphandprint.tag[1] [2] [3] Improved CLI section headers to include the relevant id in several workflow functions, providing better context for the user. [1] [2] [3]Added an
assert_tagparameter togeopressuretemplate_config[1] [2] [3] [4] Added an assertion for scientific_name type early in bird_create to ensure input validity, and removed a redundant assertion later in the function. [1] [2]Updated progress messages and clarified output in several places. [1] [2] Improved handling of return values in error cases for geopressuretemplate_graph. [1] [2] Cleaned up and clarified documentation and comments, including removal of outdated references and minor formatting fixes. [1] [2]
Fixed a logical error in plot_path_leaflet when checking the interp field.
Ensured likelihood maps are retrieved and displayed more clearly in graph_create.
Added a Year: 2022 field to the DESCRIPTION file.
Full Changelog: https://github.com/GeoPressure/GeoPressureR/compare/v3.4.3...v3.4.4
GeoPressureR v3.4.3
Moderate
Memory Optimization on Graph Creation
- Replaced the use of
geospherefunctions with custom memory-efficient implementations for distance and bearing calculations. - Improved graph creation by introducing distance filtering before distance calculation and adding progress messages for better user feedback.
- Added cleanup steps (
rmandgc) in theedge_add_windfunction to free memory by removing unused variables and closing netCDF files.
Minor
- Use an interp=1 by default in geopressureviz
- Temporarily set default era5_dataset to land
- Removed redundant retry logic in
httr2requests across multiple functions (geopressure_map_mismatch,geopressure_timeseries) to simplify the code (f227a90).
Full Changelog: https://github.com/GeoPressure/GeoPressureR/compare/v3.4.2...v3.4.3
GeoPressureR v3.3.3
Minor
- Minor fixes of plot_path
- Minor fix on plot_twilight
- Minor edits on docs and website
Full Changelog: https://github.com/GeoPressure/GeoPressureR/compare/v3.3.2...v3.3.3
GeoPressureR v3.3.2
Major update
- Change the computation of distance of edges in the graph by removing the fix that added 1 resolution to the distance to account for large grid square and short flight distance. Instead, add warning message in case there might be such an issue (flight distance < grid resolution) ddbd07d.
- Add
zero_speed_thresholdparameter that allow to encourage bird to stay at the same location. This is typically the case for short flight that don’t seems to affect the position. Quite similar to astap_elev2060790 - Add other type of pressurepath in interim 8d7f1d1
GeoPressureR v3.3.1
Major update
-
Update of param structure to
function_name$param_name. The structure of the param has been reorganised: this named list stored inside of tag and graph stores parameters used during the building of tag and graph. We standardized this structure as param{function_name}{argument_name}. See the migration instructions in the GeoPressureR wiki. This will mean you’ll need to update your config.yml structure - sorry for that. - Add geopressuretemplate() functions. The main improvement is related to the use of a single function to run the entire workflow: geopressuretemplate. Read more about this in the corresponding chapter of the GeoPressureManual.
New Contributors
- @PabloCapilla made their first contribution in #125
Full Changelog: https://github.com/GeoPressure/GeoPressureR/compare/v3.3.0...v3.3.1
GeoPressureR v3.3
Major
- Read all sensors type and allow reading sensor without pressure
assert_pressure = FALSE(d11f8cc, 85ffe94) - Update to ecmwfr v2. Change to cds_token. We use the Climate Data Store to download the wind data during the flight. They have recently updated their infrastructure and their login procedure has changed. You’ll need an ECMWF login with an Access Token. See updated procedure in the chapter Trajectory with wind of the GeoPressureManual.
- Improvement of tag_label_auto() with post-processing step. Based on a simple classification of prolonged high activity, migratory flight classification was often not very performant, e.g. when a bird was gliding during the flight. I have now added a post-processing step in the automatic classification to fix this. Read more in the detail section of tag_label_auto()..
- Create path2twilight.R and Add twilight_line in plot_twilight. You can now compute the theoretical twilight of a path, or more interestingly, of a pressurepath. It’s also used in pressurepath_create(), returning a column with sunrise and sunset. Its original purpose was to be able to check the twilight labeling by comparing it to a path generated, e.g., with GeoPressureViz. See the last section of the light map chapter for more info.
Minor
- Fix issue with tag_plot_twilight() when twilight was not yet computed
- Update documentation of windsupport/drift
- Make twilight works with NA in light
- Add type to path as attribute
- Accept known as list and convert it if so
- Fix bug in compute_known in geolight_map()
- Improve progress_bar, remove extra
\f, improveprint - Change default map height
- fix plot_twilight() for twl_offset
- update all actions
GeoPressureR v3.2
Major
- Use the new GeoPressureAPI pressurepath entry point for
geopressurepath_create() - Update to GeoPressureAPI v2 for
geopressure_timeseries()https://github.com/GeoPressure/GeoPressureR/pull/103/commits/732d1a02cc241dc7d2dde3401c8747fa860650c6 - Fix major bug https://github.com/GeoPressure/GeoPressureR/pull/103/commits/05c3203ef1588bbc1f769050377cadf5f1aadcbd
- Migrate from
httrtohttr2 - Fix major bug with saving environment variable in param 9bcbf790
- Add functions
speed2bearing()andwindsupport()fe244f60 - Use interpolated
stap_idfor flight instead of0d7491c2a - Create
edge_add_wind()36412dc8 - Create
path2elevation()using GeoPressureAPI to compute ground elevation from a path
Minor
- Add
workersargument ingraph_create()e1ce4588 - Add
codemeta.jsonhttps://github.com/GeoPressure/GeoPressureR/pull/105/commits/4f7f7bce8875b4af59db3fc1ce403d41d6317469 - Add project status badge https://github.com/GeoPressure/GeoPressureR/pull/105/commits/ecd8f61ec49dcd376748e54d19dfb2000675d302
- Fix leaflet tile provider with Stadia change https://github.com/GeoPressure/GeoPressureR/pull/106/commits/8d9bd159874deb87d61907ea14911eca12877038
- Add
WORDLISTforspellingpackage. - Remove the use of
indin path f7b38e1c - Read temperature sensor 17524658
- Only download wind data for non-existing file by default (instead of all flights) b6a2c414
- Remove
pressurepath2altitude()now computed inpressurepath_create()
GeoPressureR v3.1
Major
- Update to GeoPressureAPI v2, using
thr_maskingeopressure_map_mismatch()and splittingkeep_mse_mask. - Adjust computation of ground speed to account for grid resolution.
GeoPressureR v3.0
Guiding principles of v3
This new version consists of a significant revamp of the entire code centred around these themes:
- Name more general than SOI sensors (e.g., use
taginstead ofpam) - Focus the workflow on pressure sensor (but still allows for acceleration or light data)
- Update the notion of graph into State-Space Model notations (e.g. probability -> likelihood)
- More memory efficient (store minimum graph info) while minimizing computational expense of the “slow” functions
- Shorter workflow #69
- Ease of labelling #67
- Reproducibility and long-term storage with
param. - Use of S3 class object with print and plot generic function.
- Compatible with pipe
|>or%>% - Use of cli for message and progress bar.
- Be able to update
tagandpressurepathwithout re-computing everything. - See #55 for details on the functions named change
- See the migration wiki for a small guide to transition from v2.
Major
- Use of GeoPressureR object:
tag,graph,param,bird - Many new plot functions including update of
geopressureviz() - Transition from
rastertoterra#59 - New label scheme with test and messaging for troubleshooting #67 #73 #83
- Create
tag_update()andpressurepath_update() - Review the structure of a path and edges.
GeoPressureR v2.6-beta
Minor
- fixes for reading pam data
- various fixes (see #42)
GeoPressureR v2.4-beta
Major
- Accept request over water and display warning message. See #15
- Add logging of error and return JSON file of the request in case of error for troubleshooting
- Change downloading and reading of geotiff file to work on windows. See #16
- Remove the artificial increase of flight duration at the creation of graph 696566e8
- Compute groundspeed in parallel in graph creation b1466c73
Minor
- minor fixes for
sta_id=0orNA - minor fixes in
geopressureviz() - add dummy graph test to improve coverage.
- compute windspeed for short flight happening during the same hour
- typos, code readability and
stlyer
GeoPressureR v2.3-beta
Major
- Major fix of wind computation bearing to angle and m/s -> km/h
- Major fix of twilight uncertainty using kernel density. The gamma fitting was very wrong 5acfb136
- Major update in the data location to avoid being loaded when using the package. Move all data to
inst/extdatato avoid having them loaded with 65c8f806 - Add more information on various dataset to be able to load in GeoPressureViz
- Change to the graph 4aeed9ab
Minor
- Multiple test file and add
covr - Optimize
sta_pam() - Re-write
find_twilights - Create function graph_path2edge
- Add energy figure
- Multiple improvements on GeoPressureViz
- Add citation and contribution file
- use 100 character width
- Add link to GeoPressureTemplate
GeoPressureR v2.2-beta
Major
- New function
geopressure_map2pathwith return of index of lat-lon option - New function
geopressure_ts_pathto compute multiplegeopressure_tsfunction on a full path - Update GeoPressureViz (demo app) to accept
geopressure_ts_pathoutput
GeoPressureR v2.1-beta
Major
- Graph Addition of wind: https://geopressure.org/GeoPressureManual/trajectory-with-wind.html
- Movement model function: converting airspeed/groundspeed to probability.
GeoPressureR v2.0-beta
New Contributors
- @jsocolar made their first contribution in #7
