{"id":22079755,"url":"https://github.com/hugomflavio/actel","last_synced_at":"2025-04-07T15:09:55.565Z","repository":{"id":53399704,"uuid":"190181871","full_name":"hugomflavio/actel","owner":"hugomflavio","description":"Standardised analysis of acoustic telemetry data from fish moving through receiver arrays","archived":false,"fork":false,"pushed_at":"2025-02-20T20:07:13.000Z","size":31674,"stargazers_count":26,"open_issues_count":33,"forks_count":6,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-03-31T13:18:57.203Z","etag":null,"topics":["acoustic-telemetry","fish-packages","r","telemetry-data"],"latest_commit_sha":null,"homepage":"https://hugomflavio.github.io/actel-website","language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hugomflavio.png","metadata":{"files":{"readme":"README.md","changelog":"NEWS.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-06-04T10:42:27.000Z","updated_at":"2025-02-20T20:07:16.000Z","dependencies_parsed_at":"2024-02-10T20:25:55.330Z","dependency_job_id":"af30a0df-5eb2-480c-8835-977a6be0fb28","html_url":"https://github.com/hugomflavio/actel","commit_stats":{"total_commits":1254,"total_committers":2,"mean_commits":627.0,"dds":0.04226475279106856,"last_synced_commit":"8f2062eb61db565513966b2cde4d69d52cdde1b3"},"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hugomflavio%2Factel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hugomflavio%2Factel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hugomflavio%2Factel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hugomflavio%2Factel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hugomflavio","download_url":"https://codeload.github.com/hugomflavio/actel/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247675607,"owners_count":20977377,"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":["acoustic-telemetry","fish-packages","r","telemetry-data"],"created_at":"2024-11-30T23:10:31.884Z","updated_at":"2025-04-07T15:09:55.543Z","avatar_url":"https://github.com/hugomflavio.png","language":"R","funding_links":[],"categories":[],"sub_categories":[],"readme":"Jump to [**installation instructions**](#installing-actel)\n\n# actel\u003cimg src=\"vignettes/actel_logo.png\" align=\"right\" width=\"120\" /\u003e\n\n[![R-CMD-check](https://github.com/hugomflavio/actel/actions/workflows/R-CMD-check.yml/badge.svg)](https://github.com/hugomflavio/actel/actions)\n[![CRAN\\_Status\\_Badge](https://www.r-pkg.org/badges/version/actel)](https://cran.r-project.org/package=actel)\n[![CRAN RStudio mirror downloads](https://cranlogs.r-pkg.org/badges/actel)](https://cran.r-project.org/package=actel)\n\n[![codecov](https://codecov.io/github/hugomflavio/actel/branch/master/graphs/badge.svg)](https://app.codecov.io/github/hugomflavio/actel)\u003csup\u003e of non-interactive code*\u003c/sup\u003e\n\nRead the [latest news here!](https://github.com/hugomflavio/actel/blob/master/NEWS.md#news)\n\nNOTE: actel now has a dedicated [website!](https://hugomflavio.github.io/actel-website/)\n\n## Overview\n\nIf you are using acoustic telemetry to track animals as they move inside a study area or as they migrate somewhere, actel is the package for you.\nBy bringing together the study area configuration and the recorded detections, actel provides a systematic way of analysing animal migration and residency data.\n\n\u003cimg src=\"vignettes/mb_arrays.svg\" alt=\"drawing\" width=\"870\"/\u003e\n\n### Main functions:\n\n**1. explore()**\n\n explore() allows you to quickly get a summary of your data. You can use explore() to get a general feel for the study results, and check if the input files are behaving as expected. It is also a good candidate if you just want to validate your detections for later use in other analyses.\n\n**2. migration()**\n\n  The migration() analysis runs the same initial checks as explore(), but on top of it, it analyses the animal behaviour. By selecting the arrays that lead to success, you can define whether or not your animals survived the migration. Additional plots help you find out if some animal/tag has been acting odd. Multiple options allow you to tweak the analysis to fit your study perfectly.\n\n**3. residency()**\n\n  The residency() analysis runs the same initial checks as explore(), but, similarly to migration, explores particular points of the animal behaviour. If you want to know where your animals were in each day of the study, how many animals were in each section each day, and other residency-focused variables, this is the analysis you are looking for!\n\n## Unlock actel's full potential\n\nTo truly learn how to operate actel, you must read the package vignettes. These have been arranged so that you can\nprepare your analysis as you learn; quite soon you will get your first results!\n\nHere are some examples:\n\n**Movement tables:**\n\n|Array  | Detections|First station |Last station |First time          |Last time           |Time travelling |Time on array |\n|:------|----------:|:-------------|:------------|:-------------------|:-------------------|---------------:|-------------:|\n|River1 |         14|St.1          |St.2         |2019-05-15 10:30:00 |2019-05-15 13:00:00 |        25:20:14|       2:30:00|\n|River2 |          3|St.4          |St.4         |2019-05-15 13:50:00 |2019-05-15 14:40:00 |         0:50:00|       0:50:00|\n|River3 |          8|St.5          |St.6         |2019-05-15 16:00:00 |2019-05-15 16:20:00 |         1:20:00|       0:20:00|\n|Fjord2 |         21|St.10         |St.11        |2019-05-16 15:10:00 |2019-05-16 18:00:00 |        22:50:00|       2:50:00|\n|Sea1   |          1|St.18         |St.18        |2019-05-18 09:45:00 |2019-05-18 09:45:00 |        15:45:00|       0:00:00|\n\n**Detection graphics**\n\n\u003cimg src=\"vignettes/R64K-4521.png\" alt=\"drawing\" width=\"400\"/\u003e \u003cimg src=\"vignettes/R64K-4526.png\" alt=\"drawing\" width=\"400\"/\u003e\n\n**Times of arrival and summary information**\n\n\u003cimg src=\"vignettes/times_River3.svg\" alt=\"drawing\" width=\"410\"/\u003e \u003cimg src=\"vignettes/LaTeX_example_survival.svg\" alt=\"drawing\" height=\"370\"/\u003e\n\n**Array efficiency and tag progression**\n\n\u003cimg src=\"vignettes/mb_efficiency.svg\" alt=\"drawing\" width=\"870\"/\u003e\n\n**Individual residency**\n\n\u003cimg src=\"vignettes/readme_individual_residency.png\" alt=\"drawing\" width=\"870\"/\u003e\n\n**Global residency**\n\n\u003cimg src=\"vignettes/readme_global_residency.png\" alt=\"drawing\" width=\"870\"/\u003e\n\n## Installing actel\n\n**CRAN version: 1.3.0**\n\nactel is available on CRAN. To install the latest stable version, simply run:\n\n    install.packages(\"actel\")\n\n\n**Development version**\n\nIf you would like to install the [latest updates](https://github.com/hugomflavio/actel/blob/master/NEWS.md#news) (which have not been integrated to CRAN yet), you can run the line below. Note that you need to have the package `remotes` installed!\n\n    remotes::install_github(\"hugomflavio/actel\", build_opts = c(\"--no-resave-data\", \"--no-manual\"), build_vignettes = TRUE)\n\n\n**Have a look at the manual:**\n\nAfter installing, you should read the manual, which can now be found in [actel's website](https://hugomflavio.github.io/actel-website/index.html).\n\n**Note:**\n\n1. If you are getting \"pandoc document conversion\" errors during the package installation, try installing the [newest version of pandoc](https://pandoc.org/installing.html), restarting R and trying again.\n\n\n\u003csup\u003e* interactive code (i.e. code that expects user input) cannot be tested automatically using codecov and, as such, was excluded from the codecov scope.\u003c/sup\u003e\n\n\n\n## Works using or relating to actel\n\n**2024** (1)\n\n- Waters, C., Cotter, D., O’Neill, R., Drumm, A., Cooney, J., Bond, N., Rogan, G., \u0026 Maoiléidigh, N. Ó. (2024). The use of predator tags to explain reversal movement patterns in Atlantic salmon smolts (_Salmo salar_ L.). Journal of Fish Biology. https://doi.org/10.1111/jfb.15658\n\n\n**2023** (15)\n\n- Becker, A., Fielder, D. S., Lowry, M. B., \u0026 Taylor, M. D. (2023). Suitability of saltmarsh creeks as release locations for stocked Mulloway (Argyrosomus japonicus). Estuarine, Coastal and Shelf Science, 108455. https://doi.org/10.1016/j.ecss.2023.108455\n\n- Davey, J., Clarke, T. M., Niella, Y., Dennis, J. D., \u0026 Huveneers, C. (2023). Seasonal variation in space use and residency of the southern eagle ray _Myliobatis tenuicaudatus_ in a temperate ecosystem. Marine Ecology Progress Series, 705, 77–94. https://doi.org/10.3354/meps14232\n\n- Davies, P., Britton, J. R., Castro-Santos, T., Crundwell, C., Dodd, J. R., Nunn, A. D., Velterop, R., \u0026 Bolland, J. D. (2023). Tracking anadromous fish over successive freshwater migrations reveals the influence of tagging effect, previous success and abiotic factors on upstream passage over barriers. Canadian Journal of Fisheries and Aquatic Sciences. https://doi.org/10.1139/cjfas-2022-0196\n\n- Dhellemmes, F., Aspillaga, E., Rittweg, T., Alós, J., Möller, P., \u0026 Arlinghaus, R. (2023). Body size scaling of space use in coastal pike (_Esox lucius_) in brackish lagoons of the southern Baltic Sea. Fisheries Research, 260, 106560. https://doi.org/10.1016/j.fishres.2022.106560\n\n- Dhellemmes, F., Aspillaga, E., \u0026 Monk, C. T. (2023). ATfiltR: A solution for managing and filtering detections from passive acoustic telemetry data. MethodsX, 10, 102222. https://doi.org/10.1016/j.mex.2023.102222\n\n- English, G., Wilson, B. M., Lawrence, M. J., Black, M., Hawkes, J. P., Hardie, D. C., Daniels, J. M., Carr, J. W., Rycroft, C., Crossin, G. T., Whoriskey, F., den Heyer, C. E., Bordeleau, X., McKindsey, C. W., \u0026 Trudel, M. (2023). Determining early marine survival and predation by endothermic predators on acoustically-tagged Atlantic salmon (\u003ci\u003eSalmo salar\u003c/i\u003e) post-smolts. Canadian Journal of Fisheries and Aquatic Sciences. https://doi.org/10.1139/cjfas-2023-0206\n\n- Flink, H., Tibblin, P., Hall, M., Hellström, G., \u0026 Nordahl, O. (2023). Variation among bays in spatiotemporal aggregation of Baltic Sea pike highlights management complexity. Fisheries Research, 259, 106579. https://doi.org/10.1016/j.fishres.2022.106579\n\n- Höhne, L., Freese, M., Pohlmann, J.-D., Diekmann, M., Fladung, E., Huisman, J. B. J., Hanel, R., \u0026 Marohn, L. (2023). Overestimating management progress—Modelled vs. Monitored silver eel escapement in a North Sea draining river. ICES Journal of Marine Science, fsad122. https://doi.org/10.1093/icesjms/fsad122\n\n- Huisman, J. B. J., Höhne, L., Hanel, R., Kuipers, H., Schollema, P. P., \u0026 Nagelkerke, L. (2023). Factors influencing the downstream passage of European silver eels (_Anguilla anguilla_) through a tidal sluice. Journal of Fish Biology, (in press). https://doi.org/10.1111/jfb.15398\n\n- Kraft, S., Gandra, M., Lennox, R. J., Mourier, J., Winkler, A. C., \u0026 Abecasis, D. (2023). Residency and space use estimation methods based on passive acoustic telemetry data. Movement Ecology, 11(1), 12. https://doi.org/10.1186/s40462-022-00364-z\n\n- Kressler, M. M., Dall, S. R. X., \u0026 Sherley, R. B. (2023). A framework for studying ecological energy in the contemporary marine environment. ICES Journal of Marine Science, 80(6), 1580–1593. https://doi.org/10.1093/icesjms/fsad082\n\n- Nordli, E., Strøm, J., Bøhn, T., Thorstad, E., Serra-Llinares, R., Nilsen, R., \u0026 Bjørn, P. (2023). Behaviour and habitat use of first-time migrant Arctic charr: Novel insights from a subarctic marine area. Marine Ecology Progress Series, 709, 77–90. https://doi.org/10.3354/meps14279\n\n- O’Connor, B. (2023). Linking spatial stream network modeling and telemetry data to investigate thermal habitat use by adult arctic grayling [Master of Science, University of Northern British Columbia]. https://doi.org/10.24124/2023/59378\n\n- Stoot, L. J., Butler, G. L., Niella, Y., Doran, G. S., Thiem, J. D., Taylor, M. D., \u0026 Baumgartner, L. J. (2023). Environmental Effects on the Seasonal Distribution of an Estuarine Species _Neoarius graeffei_ in Northern New South Wales, Australia. Estuaries and Coasts. https://doi.org/10.1007/s12237-023-01269-9\n\n- van Leeuwen, C. H. A., de Leeuw, J. J., van Keeken, O. A., Volwater, J. J. J., Seljee, F., van Aalderen, R., van Emmerik, W. A. M., \u0026 Bakker, E. S. (2023). Multispecies fish tracking across newly created shallow and deep habitats in a forward-restored lake. Movement Ecology, 11(1), 43. https://doi.org/10.1186/s40462-023-00405-1\n\n\n**2022** (5)\n\n- Edwards, M. L., McCallister, M., Brewster, L. R., Bangley, C. W., Curtis, T. H., Ogburn, M. B., \u0026 Ajemian, M. J. (2022). Multi-year assessment of immature bull shark \u003ci\u003eCarcharhinus leucas\u003c/i\u003e residency and activity spaces in an expansive estuarine nursery. Marine Ecology Progress Series, 695, 125–138. https://doi.org/10.3354/meps14113\n\n- Hewitt, D. E., Niella, Y., Johnson, D. D., Suthers, I. M., \u0026 Taylor, M. D. (2022). Crabs Go With the Flow: Declining Conductivity and Cooler Temperatures Trigger Spawning Migrations for Female Giant Mud Crabs (\u003ci\u003eScylla serrata\u003c/i\u003e) in Subtropical Estuaries. Estuaries and Coasts. https://doi.org/10.1007/s12237-022-01061-1\n\n- Hollins, J., Pettitt-Wade, H., Gallagher, C. P., Lea, E. V., Loseto, L. L., \u0026 Hussey, N. E. (2022). Distinct freshwater migratory pathways in Arctic char (\u003ci\u003eSalvelinus alpinus\u003c/i\u003e) coincide with separate patterns of marine spatial habitat-use across a large coastal landscape. Canadian Journal of Fisheries and Aquatic Sciences. https://doi.org/10.1139/cjfas-2021-0291\n\n- Thorkildsen, T. B. (2022). Anadromous Arctic charr: Mapping of migration and habitat use in Isfjorden, Svalbard [Master thesis, Norwegian University of Life Sciences, Ås]. https://nmbu.brage.unit.no/nmbu-xmlui/handle/11250/3018496\n\n- Thorstensen, M. J., Vandervelde, C. A., Bugg, W. S., Michaleski, S., Vo, L., Mackey, T. E., Lawrence, M. J., \u0026 Jeffries, K. M. (2022). Non-Lethal Sampling Supports Integrative Movement Research in Freshwater Fish. Frontiers in Genetics, 13. https://www.frontiersin.org/articles/10.3389/fgene.2022.795355\n\n\n**2021** (7)\n\n- Flávio, H., \u0026 Baktoft, H. (2021). actel: Standardised analysis of acoustic telemetry data from animals moving through receiver arrays. Methods in Ecology and Evolution, 12(1), 196–203. https://doi.org/10.1111/2041-210X.13503\n\n- Flávio, H., Caballero, P., Jepsen, N., \u0026 Aarestrup, K. (2021). Atlantic salmon living on the edge: Smolt behaviour and survival during seaward migration in River Minho. Ecology of Freshwater Fish, 30(1), 61–72. https://doi.org/10.1111/eff.12564\n\n- Niella, Y., Smoothey, A. F., Taylor, M. D., Peddemors, V. M., \u0026 Harcourt, R. (2021). Environmental Drivers of Fine-Scale Predator and Prey Spatial Dynamics in Sydney Harbour, Australia, and Adjacent Coastal Waters. Estuaries and Coasts. https://doi.org/10.1007/s12237-021-01020-2\n\n- Nordli, E. (2021). The behaviour of anadromous Arctic charr during their first marine migration [Master thesis, Arctic University of Norway]. https://munin.uit.no/handle/10037/21752\n\n- Winter, E. R. (2021). The movement ecology of common bream _Abramis brama_ in a highly connected wetland using acoustic telemetry. [Doctoral thesis, Bournemouth University]. http://eprints.bournemouth.ac.uk/35141/\n\n- Winter, E. R., Hindes, A. M., Lane, S., \u0026 Britton, J. R. (2021a). Movements of common bream _Abramis brama_ in a highly connected, lowland wetland reveal sub-populations with diverse migration strategies. Freshwater Biology, 66(7), 1410–1422. https://doi.org/10.1111/fwb.13726\n\n- Winter, E. R., Hindes, A. M., Lane, S., \u0026 Britton, J. R. (2021b). Acoustic telemetry reveals strong spatial preferences and mixing during successive spawning periods in a partially migratory common bream population. Aquatic Sciences, 83(3), 52. https://doi.org/10.1007/s00027-021-00804-9\n\n\n**2020** (2)\n\n- Flávio, H., Kennedy, R., Ensing, D., Jepsen, N., \u0026 Aarestrup, K. (2020). Marine mortality in the river? Atlantic salmon smolts under high predation pressure in the last kilometres of a river monitored for stock assessment. Fisheries Management and Ecology, 27(1), 92–101. https://doi.org/10.1111/fme.12405\n\n- Niella, Y., Flávio, H., Smoothey, A. F., Aarestrup, K., Taylor, M. D., Peddemors, V. M., \u0026 Harcourt, R. (2020). Refined Shortest Paths (RSP): Incorporation of topography in space use estimation from node-based telemetry data. Methods in Ecology and Evolution, 11(12), 1733–1742. https://doi.org/10.1111/2041-210X.13484\n\n\nIs your paper not here? Let me know!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhugomflavio%2Factel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhugomflavio%2Factel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhugomflavio%2Factel/lists"}