knitr::opts_chunk$set( collapse = TRUE, comment = "#>" )
The results compiled by the migration() function include those of the explore() function. To keep the vignettes shorter, I will only detail new outputs here:
section.movements list contains the section-level movement events created during the movement compressing process. Here is an example:
|Section | Events| Detections|First.array |Last.array |First.time |Last.time |Time.travelling |Time.in.section | |:--------|------:|----------:|:------------|:-----------|:----------|:---------|:---------------|:---------------| |River | 3| 10|River1 |River3 |... |... |11:45 |0:00 | |Fjord | 2| 5|Fjord1 |Fjord2 |... |... |14:00 |03:32 | |Sea | 2| 7|Sea1 |Sea1 |... |... |26:27 |15:59 | (Timestamps were trimmed so the table fits better in the page)
status.df is a data frame that combines both the timetable data and your biometrics into a single, organised table. If you have stored any comments during the analysis process, they will show up in a reserved column in this table.
status.df also contains the recorded fate for each fish (i.e. disappeared somewhere or succeeded at crossing the study area), and summary information on the number and length of the recorded backwards movements. This table can be quite big, so it may be a good idea to use
head(status.df) the first time you look at it.
This small table is automatically generated with data extracted from the
status.df. For each fish group, it details the number of fish that disappeared on any section and those that passed to the next. It is very helpful to get a quick overview of the results, and is incorporated in the actel report. Here is an example:
| | Total| Disap..in.River| Migrated.to.Sea| Disap..in.Sea| Succeeded| |:--------|-----:|---------------:|---------------:|-------------:|---------:| |Hatchery | 40| 30| 10| 3| 7| |Wild | 40| 24| 16| 2| 14|
array.overview shows you the number of known and estimated fish, per group, to have passed each of your arrays.
: These only take into account forward movements. I.e., if the fish moved backwards, the results displayed in array.overview will no longer match the known survival. When looking for survival estimates, you should always refer back to the
section.overview object for confirmation of the number of fish that entered/left each section.
If you activated the report option, this table is then converted into a graphic, which can be found in the actel migration report, under the section "Progression".
In this object you will find the matrix/matrices that were used for efficiency estimations during CJS modelling. Note that these matrices only represent the forward movements. You can read more about it below, in the description of the
This object contains the results of the efficiency estimations performed by actel. During the migration analysis, actel calculates forward efficiency only to improve the accuracy of the efficiency measurement. You can learn more about how these one-way efficiency estimations are made in this manual page.
If you provided intra-array estimates in the replicates argument, actel will estimate intra-array efficiencies for the target arrays. These results are stored in the object
intra.array.CJS, and the combined efficiency estimate is used to complement the overall CJS.
The migration function saves outputs similar to those saved by explore. The main differences are in the two elements listed below.
To make sure that you don't accidentally loose your results, actel stores them right away in the target folder. The results present in this file are the same as the ones you obtain directly in your R console (see above). It differs from the explore() output both in name and content.
This is the main non-R output. If you activated the
report option, actel will compile an html report for you. The migration report contains the same sections as the explore report, plus the following:
Here you can see how efficient your receiver arrays were at detecting the fish that moved past them. These results can also be found in the
overall.CJS object, which is in your results in R. If you supplied replicates, the results of the intra-array estimations will also show up here.
The survival is displayed both as a table and a figure, both of which use the content of the
section.overview object, which is in your results in R.
The progression plot is a visual representation of the
overall.CJS object, which is in your results in R.
You can also examine the detailed values per group in the tables supplied (i.e. the
As the name suggests, this plot compares variables across all your fish: The total number of detections, and the time to/time in each of your study area sections. To simplify the visualisation, for each variable, the top 10% of the data is painted in red, and the bottom 10% of the data is painted in blue.
This plot is meant to help you find fish with uncommon behaviour. Fish with a lot of detections are likely staying for a very long time within receiver range; a fish that moves too fast in comparison to the remaining may have been carried by a predator. It is up to you to look at these graphics and decide if anything looks odd. If it does, then note down the tag number, so you can have a closer look at the respective plot of detections.
These graphics contain more information than those created by the explore function: the vertical grey dashed lines show the assigned moments of entry and exit for each study area section, and the assigned fate of the fish is shown in the header.
It is a good idea to have a good look at all of these graphics and verify that everything is looking correct (i.e. actel has assigned fates and entry/exit points correctly). This is also a good chance to have a closer look at the tags you flagged as suspicious during the analysis.
Fish with strange behaviour can be complicated to analyse. While actel's functions have been designed to deal with this as best as possible, you can always enter manual mode if you find out that actel has miss-assigned something. I.e. has a movement event been invalidated that seems valid, or vice-versa? Are part of the movements detected characteristic of predator behaviour?
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.