A Comprehensive R Tool for Zootechnical Metrics

A collection of functions to compute frequently used metrics for nutrition trials in aquaculture. Implementations include metrics to calculate growth, feed conversion, nutrient use efficiency, and feed digestibility. The package supports reproducible workflows for summarising experimental results and reduces manual calculation errors. For additional information see Machado e Silva, Karthikeyan and Tellbüscher (2025) .


aquacultuR

R-CMD-check Codecov testcoverage

aquacultuR is an R package providing functions for the calculation of growth and feed conversion metrics. The provided example datasets originate from studies in the field of aquaculture.

Notes

merge into cran, not into main!

Why using aquacultuR?

Until now, a comprehensive collection of equations that are commonly used in animal nutrition does not exist. This can make it difficult for people entering the field to understand how values were obtained. Also, the use of incorrect equations might not be recognized by reviewers in some cases. The advantages of wrapping those equations up in an R package in comparison to an Excel file are

  • superior reproducibility
  • reduced susceptibility to human errors
  • having a citeable resource on hand that can be referred to

Installation

You can install aquacultuR from CRAN using:

install.packages("aquacultuR")

You can also install aquacultuR from GitHub if you prefer the latest development version by using:

require(devtools)
devtools::install_github("TellAnAx/aquacultuR")

In both cases, the package can eventually be loaded using:

library(aquacultuR)

Functionalities

Function Metric Synonym
gbw() Geometric bodyweight
mbw() Metabolic bodyweight
ag() Absolute growth (AG) Weight gain
agr() Absolute growth rate (AGR)
rgr() Relative growth rate (RGR)
sgr() Specific growth rate (SGR)
tgc() Thermal growth coefficient (TGC)
fr() Feeding rate (FR)
rfr() Relative feeding rate Feeding rate
nr() Nutrient retention
fcr() Feed conversion ratio (FCR)
fce() Feed conversion efficiency (FCE)
ner() Nutrient efficiency ratio (NER) Protein/Energy/X efficiency ratio
adc_dm() Apparent digestibility coefficient (ADC)
adc_nut() Apparent digestibility coefficient (ADC)
adc_ingr() Apparent digestibility coefficient (ADC)

About

Authors:

Contributors:

  • Madhav Karthikeyan

Logo design:

  • Tomáš Pěnka

Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.

install.packages("aquacultuR")

1.1.1 by Anıl Axel Tellbüscher, 8 months ago


https://github.com/TellAnAx/aquacultuR


Report a bug at https://github.com/TellAnAx/aquacultuR/issues


Browse source code at https://github.com/cran/aquacultuR


Authors: Anıl Axel Tellbüscher [aut, cre, cph] (ORCID: , Davide Machado e Silva [aut] (ORCID: , Simão Correia [aut] , Madhav Karthikeyan [ctb] (ORCID: , Tomáš Pěnka [dtc]


Documentation:   PDF Manual  


GPL (>= 3) license


Imports dplyr, magrittr

Suggests knitr, lubridate, tidyr, rmarkdown, testthat


See at CRAN