RstoxFDA

Fisheries Dependent Analysis with Rstox. Documentation can be found at: https://stoxproject.github.io/RstoxFDA/index.html . Functions, data formats, and data objects are documented under 'Reference' while tutorials to get started are provided under 'Articles'.

Installation

1. Install the latest release:

   install.packages("RstoxFDA", repos = c("https://stoxproject.github.io/repo", "https://cloud.r-project.org"))

2. Install the latest version from GitHub:

   remotes::install_github("https://github.com/StoXProject/RstoxFDA")

StoX

RstoxFDA contains functions that adheres to StoX 3 function-contracts so that they can be included in StoX-processes via the StoX user interfaces. This includes functions for a StoX-Reca template. RstoxFDA does not come bundled with StoX, and needs to be installed in addition to the StoX packages, by following the instructions above.

Not StoX

RstoxFDA is an analysis-library that also works independently of StoX and not all functions are available in the StoX user interface. The functions that are available in the StoX user interface starts with a capital letter and are listed at https://stoxproject.github.io/RstoxFDA/reference/index.html#stox-functions.

Reporting problems

The preferred way to communicate problems is by raising an issue on the RstoxFDA github page. Users are encouraged to also report when documentation is lacking, erroneous or ambiguous.

When reporting bugs, please report the versions your were using of R, RstoxFDA, and operating system. Please also report any error messages, and if possible include instructions for how to reproduce the problem.

Reca

Reca is a library for estimating total catch at age from commerical catches. RstoxFDA contains functions for adapting data to Reca, running estimates, and plotting or tabulating results. These functions are available in the StoX user interface. In addition some functions are provided for adapting Reca to other data formats than just the ones supported by Stox. RstoxFDA development is otherwise independent of development of Reca, and Reca is only a suggested dependency. That means that RstoxFDA may be available for platforms (operating systems or R-versions) where Reca is not available, and functions dependent on Reca will not work in these cases.

Reca is primarily available at: https://github.com/NorskRegnesentral/Reca.

One may also consider installing from the fork at https://github.com/StoXProject/reca or from the StoX repository at https://stoxproject.github.io/repo/, but these resources should be considered experimental, and they are not backed by a maintenance policy:

  remotes::install_github("https://github.com/StoXProject/reca")

or

  install.packages("Reca", repos=c("https://stoxproject.github.io/repo/"))

Reca on managed systems

Special considerations may have to be made for managed systems, as Reca needs to start some programs bundled with the package and needs necessary system permission to do so. Problems related to executing Reca with insufficient system permissions are indicated by error messages stating that the program CAA_MA~1.EXE failed to run. For instance Windows-users at IMR may want to adress this by installing Reca in an R-session started as administrator. Installing Reca as administrator may lead to several copies of Reca being installed, and one also has to make sure that R chooses the right one. One way to ensure this is to first uninstall any Reca package that is installed in the more common way:

• open R as regular user
• uninstall Reca with remove.packages()
• close R
• open R as administrator
• install Reca, e.g.: install.packages("Reca", repos=c("https://stoxproject.github.io/repo/"))
• close R.

Maintainance policy

We are still in the process of developing a policy for exactly which versions of R and operating systems we will strive to keep RstoxFDA working for, and how often to revise that policy. This page will be updated as those policies av finalized, but users should be prepared that it will be necessary to keep their environment up to date for continued used of RstoxFDA. We will also make public a policy on backwards compatibility, in order for us to manage deprecation of functions.

Currently the latest release/pre-release of RstoxFDA is being tested for the following R versions:

• R 4.3 (mac, linux, windows)

and is tested with Reca for the following R versions:

• R 4.3 (linux, windows)