{"id":21539506,"url":"https://github.com/bluegreen-labs/geoloctools","last_synced_at":"2025-03-17T21:43:25.281Z","repository":{"id":39986006,"uuid":"449069404","full_name":"bluegreen-labs/geoloctools","owner":"bluegreen-labs","description":"A Geolocation Tracking Toolbox","archived":false,"fork":false,"pushed_at":"2022-12-31T13:25:08.000Z","size":189449,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-24T08:11:25.855Z","etag":null,"topics":["animal-behavior","ecology","geolocation","geolocator","logging","migration","movement-ecology"],"latest_commit_sha":null,"homepage":"https://bluegreen-labs.github.io/geoloctools/","language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bluegreen-labs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-01-17T22:40:55.000Z","updated_at":"2023-11-04T19:37:21.000Z","dependencies_parsed_at":"2023-01-31T19:15:59.888Z","dependency_job_id":null,"html_url":"https://github.com/bluegreen-labs/geoloctools","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bluegreen-labs%2Fgeoloctools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bluegreen-labs%2Fgeoloctools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bluegreen-labs%2Fgeoloctools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bluegreen-labs%2Fgeoloctools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bluegreen-labs","download_url":"https://codeload.github.com/bluegreen-labs/geoloctools/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244116813,"owners_count":20400733,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["animal-behavior","ecology","geolocation","geolocator","logging","migration","movement-ecology"],"created_at":"2024-11-24T04:15:36.367Z","updated_at":"2025-03-17T21:43:25.247Z","avatar_url":"https://github.com/bluegreen-labs.png","language":"R","funding_links":[],"categories":[],"sub_categories":[],"readme":"# GeoLocTools \u003cimg src='logo.png' align=\"right\" height=\"138.5\" /\u003e\n\nA set of functions to pre-process geolocation tracking data. This includes \nboth light loggers, GPS loggers of all kinds, and tries to ensure \ninterchangeability between various devices and formats\nfor synthesis and analysis. Currently the set of functions is limited but we\nare sure this set will grow over time, due to personal use or user\ncontributions.\n\nDue to the inclusion of a high resolution geoid map the package is fairly large\n(97 MB). This is less than ideal, yet functional. A solution will be sought for\nthis situation to be more CRAN compliant.\n\nWarning: this package is made on personal request and therefore is a temporary\nconvenience tool. Although the intention is to solidify some of this more\npermanently, when and how is to be seen. The package might therefore change\nname and function at any time. Do not rely on this code operationally in\nan online workflow.\n\n## Installation\n\n### development release\n\nTo install the development releases of the package run the following\ncommands:\n\n``` r\nif(!require(devtools)){install.packages(\"devtools\")}\ndevtools::install_github(\"bluegreen-labs/geoloctools\")\nlibrary(\"geoloctools\")\n```\n\n## Use\n\n### Reading PathTrack position (.pos) files\n\nThe `glt_read_pos()` function reads in PathTrack position files into a\ndata frame. By default the altitudes are reported as values above mean sea\nlevel (corrected from ellipsoide heights to topographic heights by\ncompensating for [egm2008 one degree geoid model](https://geographiclib.sourceforge.io/1.18/geoid.html)). We do note that due to\nthe bilinear interpolation instead of cubic interpolation a slight loss in\naccuracy is noted. However, with an error of 0.025m this value is well below\nthe error on commercial animal loggers.\n\n```r\nlibrary(geoloctools)\ndf \u003c- glt_read_pos(\"your_position_file.pos\")\n```\n\n### Converting Migrate Technology data to PAMLr formatting\n\nIf you've installed the package you can also generate activity and light logging\nplot (based upon the code in the `PAMLr` documentation) by converting Migrate\nTechnology light logger files to the `PAMLr` R package format for further\nprocessing.\n\n```r\nlibrary(geoloctools)\nlibrary(pamlr)\nlibrary(tidyverse)\n\n# load demo data from Migrate Technologies files\nPAM \u003c- glt_migtech_pamlr(\n  system.file(\n    \"extdata\",\n    package = \"geoloctools\",\n    mustWork = TRUE),\n  drift_adj = FALSE\n)\n\n# grab one particular logger (subset main list)\nPAM_data \u003c- PAM$CC893\n\n# plot activity and light levels as shown in the\n# PAMLr documentation\npar( mfrow= c(1,2), oma=c(0,2,0,6))\npar(mar =  c(4,2,4,2))\n\nplot_sensorimage(PAM_data$acceleration$date, ploty=FALSE,\n                 log(PAM_data$acceleration$act+0.001), main = \"Activity\",\n                 col=c(\"black\",viridis::cividis(90)), cex=1.2, cex.main = 2)\n\nplot_sensorimage(PAM_data$light$date, labely=FALSE,\n                 PAM_data$light$obs,  main=\"Light\",\n                 col=c(\"black\",viridis::cividis(90)), cex=1.2, cex.main = 2)\n\n# loop over all available items in the list and\n# plot them\n\nlapply(PAM, function(PAM_subset){\n\n  # plot activity and light levels as shown in the\n  # PAMLr documentation\n  par( mfrow= c(1,2), oma=c(0,2,0,6))\n  par(mar =  c(4,2,4,2))\n\n  plot_sensorimage(PAM_subset$acceleration$date, ploty=FALSE,\n                   log(PAM_subset$acceleration$act+0.001), main = \"Activity\",\n                   col=c(\"black\",viridis::cividis(90)), cex=1.2, cex.main = 2)\n\n  plot_sensorimage(PAM_subset$light$date, labely=FALSE,\n                   PAM_subset$light$obs,  main=\"Light\",\n                   col=c(\"black\",viridis::cividis(90)), cex=1.2, cex.main = 2)\n})\n\n```\n\n![](https://raw.githubusercontent.com/bluegreen-labs/geoloctools/main/sensor_image.png)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbluegreen-labs%2Fgeoloctools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbluegreen-labs%2Fgeoloctools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbluegreen-labs%2Fgeoloctools/lists"}