2.2) Inspecting the explore() results

detections

The detections list contains the detections found in your detections file which match your target tags, split by each of the tags. This is the base data with which actel worked. Here is an example:

valid.detections

The valid.detections object only contains the detections that were deemed valid during the analysis.

spatial

The spatial list contains the stations, release sites and some more summary information. This object may come in handy if you have to go back to your results some time after you completed the analysis, so you can verify the study area design and match the stations names to their locations.

deployments

The deployments data frame is similar to t deployments.csv file, with the exception that unique serial numbers have been created for receivers which were deployed more than once.

arrays

The arrays list contains detailed information for each array: Which arrays are directly before, which arrays are directly after, which arrays are valid efficiency peers, which arrays are directly OR indirectly after, and more.

movements

The movements list contains the movement events created during the detection sorting process. These records can become very useful if you need to go back to a given fish and inspect its behaviour in more detail. Here is an example:

valid.movements

The valid.movements represents a refined version of the movements object, where all movements deemed invalid during the analysis were removed.

times

The times data frame contains the timestamps of first valid detection in each array, for each fish. These are used to draw the circular plots in the report (like the ones below), but you can also use them to test for differences between groups!

dist.mat

If a valid distance matrix was supplied for the analysis, it will be returned together with the results. This allows you to easily check speeds between specific movements of particular interest, and can serve as a basis for other relevant metrics.

If you said “y” during the relevant analysis questions:

Would you like to save a copy of the analysis log to [timestamp].actel.log.txt?(y/N)

Stray tags were detected in your study area. Would you like to save a summary to stray_tags.csv?(y/N) 

actel_explore_report.html (if report = TRUE)

This is the main non-R output. If you activated the report option, actel will compile an html report for you. For the explore function, this report contains the following sections:

1. Summary

Contains brief information on the study. It is useful to check up if anything looks wrong (e.g. the number of target tags, the data range).

2. Stations, Deployments and Releases

These sections contain tables listing the stations, deployments and release sites considered for the analysis. Any unknown receivers found during the analysis will also show up here. Since the station names can vary wildly, actel creates standard names for your stations (e.g. “St.1”, “St.2”). When looking at the individual detection graphics, you can refer back to the spatial table to match the standard names to the respective station names.

3. Warning messages

These represent warnings, errors and particularly important messages that were displayed during the analysis. By having them extracted and put together here, you can easily find out what went wrong.

4. User comments

Should you type in any comments during the analysis, they will be displayed here, so you can quickly remember that lingering detail you didn’t want to forget while looking at the fish’s movement table.

5. Biometrics

Actel crawls through you biometrics file in search for columns containing the keywords length, weight or mass. Should it find any matching column, it will print boxplots of the distribution of the selected variables, split by each fish group listed in the same file. This can be very helpful in quickly finding typos in the data (e.g. a displaced decimal separator).

6. Time of arrival at each array

For each of your study area’s arrays, a circular plot will be drawn of the first arrival time of each fish. The fish are grouped by the groups listed in the biometrics.csv file. These plots are saved in .svg format in the Report folder, so you can easily use them elsewhere, if needed.

7. Graphics of detected tags

This section contains a plot for each of your target tags, showing all the detections found in the data for the respective fish. The detections are coloured by array. The vertical black dashed line shows the time of release.

The full dark-grey line moving between detections shows the movement events considered valid, while the dashed dark-grey line shows the movement events considered invalid. The movement event lines move straight between the first and last station of each event (i.e. in-between detections will not be individually linked by the line).

Note that fish where you had to manually intervene during the analysis will be highlighted with a yellow border, and fish that were manually overridden through the override argument will be highlighted with a red border.

Lastly, the total number of detections for the fish is displayed in the header, between brackets.

8. Sensor data

If actel finds valid sensor data in the detections, that data will be plotted here per tag. For tags with more than one sensor, two or more panels will be drawn, one for each sensor unit.

9. Actel log

This section contains the same information as the actel log saved in your target folder. It is useful to have a look at a few things. For example, the number of target tags, the detection data range or the number of ALS (i.e. receivers) can help you spot any missing data (i.e. if you tagged 100 fish and had only 80 target tags, some tags are missing from your input files!).