Title: A Comprehensive R Tool for Zootechnical Metrics
Version: 1.1.1
Description: 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) <doi:10.13140/RG.2.2.27322.04808>.
License: GPL (≥ 3)
VignetteBuilder: knitr
URL: https://github.com/TellAnAx/aquacultuR
BugReports: https://github.com/TellAnAx/aquacultuR/issues
Encoding: UTF-8
LazyData: true
RoxygenNote: 7.3.3
Imports: dplyr, magrittr
Suggests: knitr, lubridate, tidyr, rmarkdown, testthat (≥ 3.0.0)
Config/testthat/edition: 3
Depends: R (≥ 3.5)
NeedsCompilation: no
Packaged: 2026-01-21 20:10:14 UTC; anil
Author: Anıl Axel Tellbüscher ORCID iD [aut, cre, cph], Davide Machado e Silva ORCID iD [aut], Simão Correia ORCID iD [aut], Madhav Karthikeyan ORCID iD [ctb], Tomáš Pěnka ORCID iD [dtc]
Maintainer: Anıl Axel Tellbüscher <atellbuscher@frov.jcu.cz>
Repository: CRAN
Date/Publication: 2026-01-26 16:50:08 UTC

Pipe operator

Description

See magrittr::%>% for details.

Usage

lhs %>% rhs

Arguments

lhs

A value or the magrittr placeholder.

rhs

A function call using the magrittr semantics.

Value

The result of calling 'rhs(lhs)'.


ADC of DM

Description

Function to calculate the Apparent Digestibility Coefficient (ADC) of the dry matter fraction of a compound diet.

Usage

adc_dm(std_diet, dm_diet = 1, std_feces)

Arguments

std_diet

a numeric value, resembling the inclusion rate of standard in the experimental feed given to the livestock.

dm_diet

a numeric value in the interval [0, 1], being the dry matter content of the feed. The default is 1 gram per gram

std_feces

a numeric value, resembling the inclusion rate of standard in the feces recovered during the digestibility trial.

Value

returns a single numeric value in the interval [0, 1], which is the relative ADC for the dry matter content of the diet. If the value is not within the interval, an additional warning is returned.

Author(s)

Anıl Axel Tellbüscher

References

Bureau, D. P., Harris, A. M. & Cho, C. Y. (1999): Apparent digestibility of rendered animal protein ingredients for rainbow trout (Oncorhynchus mykiss). Aquaculture, 180, p.345-358.

Examples

# use function to calculate a single ADC value

# 900 g/kg (90%) dry matter content of feed
# 10 g/kg (1%) digestibility standard in feed
# 45 g/kg (4.5%) digestibility standard in feces
adc_dm(dm_diet = 0.95, std_diet = 0.01, std_feces = 0.045)


# function can also be used within a tidyverse pipeline.
digestdm %>% 
  dplyr::group_by(diet) %>%  
  dplyr::summarise(
    `ADC DM` = adc_dm(dm = dm, 
                      std_diet = std_feed, 
                      std_feces = std_feces))


ADC of a feed ingredient (ADCingr)

Description

Function to calculate the Apparent Digestibility Coefficient of a nutrient contained in a feed ingredient of a compound diet. The calculation of the ADCingr is based on equation 4 proposed by Bureau & Hua (2006).

Usage

adc_ingr(
  adc_test,
  adc_ref,
  nut_ref,
  nut_ingr,
  dm_ref = 1,
  dm_ingr = 1,
  incl_ingr = 0.3
)

Arguments

adc_test

a numeric value in the interval [0,1] that represents the Apparent Digestibility Coefficient (ADC) of the diet that contains the ingredient to be tested.

adc_ref

a numeric value in the interval [0,1] that represents the Apparent Digestibility Coefficient (ADC) of the reference diet without the ingredient to be tested.

nut_ref

a numeric value in the interval [0,1] that represents the inclusion rate of the nutrient in the reference diet.

nut_ingr

a numeric value in the interval [0,1] that represents the inclusion rate of the nutrient in the test diet for which the Apparent Digestibility Coefficient (ADC) of the nutrient in the ingredient will be calculated.

dm_ref

a numeric value in the interval [0,1] (default: 1) that represents the dry matter content of the reference diet.

dm_ingr

a numeric value in the interval [0,1] (default: 1) that represents the dry matter content of the tested feed ingredient.

incl_ingr

a numeric value in the interval [0,1] (default: 0.3) that represents the inclusion rate of the ingredient in the test diet for which the Apparent Digestibility Coefficient (ADC) of the nutrient in an ingredient will be calculated.

Value

returns a single numeric value in the interval [0, 1], which is the relative ADC for the diet. If the value is not within the interval, an additional warning is returned.

Author(s)

Anıl Axel Tellbüscher

References

Bureau, D. P., & Hua, K. (2006): Letter to the Editor of Aquaculture. Aquaculture, 252, p.103–105.

Bureau, D. P., Harris, A. M., & Cho, C. Y. (1999): Apparent digestibility of rendered animal protein ingredients for rainbow trout (Oncorhynchus mykiss). Aquaculture 180, p.345-358.

Examples

# Example from Bureau et al. (1999) - Blood meal 2

# reference feed dry matter: 0.928 (92.8%)
# reference feed nutrient mass frac.: 0.45 (45%)
# reference feed apparent digestibility coef.: 0.923 (92.3%)
# test feed apparent digestibility coef.: 0.902 (90.2%)
# test ingredient dry matter: 0.895 (89.5%)
# test ingredient nutrient mass frac.: 0.846 (84.6%)

adc_ingr(adc_ref = 0.923, 
         nut_ref = 0.45, 
         dm_ref = 0.928,
         adc_test = 0.902, 
         nut_ingr = 0.846,
         dm_ingr = 0.895)


ADC of a nutrient (ADCnut)

Description

Function to calculate the Apparent Digestibility Coefficient of a nutrient in the dry matter fraction of a compound diet.

Usage

adc_nut(std_diet, std_feces, nut_diet, nut_feces)

Arguments

std_diet

numeric; value resembling the inclusion rate of standard in the experimental diet given to the livestock.

std_feces

numeric; value resembling the inclusion rate of standard in the feces recovered during the digestibility trial.

nut_diet

numeric; value representing the inclusion rate of the target nutrient in the diet.

nut_feces

numeric; value representing the inclusion rate of the target nutrient in the feces.

Value

returns a single numeric value in the interval [0, 1] which is the relative ADC for a single nutrient in the diet. If the value is not within the interval, an additional warning is returned.

Author(s)

Anıl Axel Tellbüscher

References

Bureau, D.P., & Hua, K. (2006): Letter to the Editor of Aquaculture. Aquaculture, 252, p.103–105.

Cho, C.Y., Slinger, S.J., & Bayley, H.S. (1982): Bioenergetics of salmonid fishes: energy intake, expenditure and productivity. Comp. Biochem. Physiol. 73B, p.25–41.

Examples

# 0.4 g/g (40%) CP on dry matter basis in feed
# 0.1 g/g (10%) CP on dry matter basis in feces
# 0.010 g/g (1%) digestibility standard in feed
# 0.045 g/g (4.5%) digestibility standard in feces

adc_nut(nut_diet = 0.4, nut_feces = 0.1, 
        std_diet = 0.01, std_feces = 0.045)


Absolute Growth (AG)

Description

A function that calculates the Absolute Growth (AG), also denoted as Absolute Weight Gain (AWG) based on the Initial Body weight (IBW; ibw) in gram (g) and the Final Body Weight (FBW; fbw) in gram (g).

Usage

ag(ibw, fbw)

weight_gain(ibw, fbw)

Arguments

ibw

numeric; value providing the initial bodyweight in grams.

fbw

numeric; value providing the final bodyweight in grams.

Value

returns a numeric value that is the AG.

Author(s)

Anıl Axel Tellbüscher

References

Lugert, V., Thaller, G., Tetens, J., Schulz, C., & Krieter, J. (2016): A review on fish growth calculation: multiple functions in fish production and their specific application. Reviews in Aquaculture, 8, p.30–42.

Examples

data(weight2)
dplyr::mutate(weight2, AG = ag(ibw_g, fbw_g))


Absolute Growth Rate (AGR)

Description

A function that calculates the Absolute Growth Rate (AGR), also denoted as Weight Gain (WG) when applied to weight data.

Usage

agr(ibw, fbw, duration)

Arguments

ibw

numeric; value that is providing the initial body weight in grams.

fbw

numeric; value that is providing the final body weight in grams.

duration

numeric value that is providing the duration of the experiment in days.

Value

returns a numeric value which is the total body weight change over the specified period of time.

Author(s)

Anıl Axel Tellbüscher

Madhav Karthikeyan

Davide A. Machado e Silva

References

Lugert, V., Thaller, G., Tetens, J., Schulz, C., & Krieter, J. (2016): A review on fish growth calculation: multiple functions in fish production and their specific application. Reviews in Aquaculture, 8, p.30–42.

Hopkins K.D. (1992) Reporting fish growth, a review of the basics. Journal of World Aquaculture Society, 23, p.173-179

Examples

data(weight2)
dplyr::mutate(weight2, AGR = agr(ibw_g, fbw_g, duration = 84))


Fish body composition

Description

This dataset contains compositional data on the proximate composition and some key minerals in the body of Atlantic salmon (Salmo salar) at the beginning and the end of a trial. The original dataset ('BodyComposition_tank') was published by Liland et al. (2024) and is from the first out of two trials ('Trial A'). Alterations to the original data structure were done by 1) converting the double-row column names into single-row column names and 2) removing the 'sex' column.

Format

A tibble with 12 rows and 14 columns:

date

date; date of data recording.

treatment

factor; treatment identifier.

tank

factor; rearing tank identifier.

dm

numeric; dry matter content of fish tissue in g/g.

water

numeric; content of fish tissue in g/g.

ash

numeric; content of fish tissue in g/g on dry matter basis.

energy

numeric; gross energy content of fish tissue in kJ/g on dry matter basis.

fat

numeric; crude fat content of fish tissue in g/g on dry matter basis.

protein

numeric; crude protein content of fish tissue in g/g on dry matter basis.

ca

numeric; calcium content of fish tissue in mg/kg on dry matter basis.

k

numeric; potassium content of fish tissue in mg/kg on dry matter basis.

mg

numeric; magnesium content of fish tissue in mg/kg on dry matter basis.

na

numeric; sodium content of fish tissue in mg/kg on dry matter basis.

phosphorus

numeric; content of fish tissue in mg/kg on dry matter basis.

References

Liland, N., Rønnestad, I., Azevedo, M., Lai, F., Oulie, F., Conceição, L., Soares, F. (2024): Dataset on the performance of Atlantic salmon (Salmo salar) reared at different dissolved oxygen levels under experimental conditions. Data in Brief 57, 110983. https://doi.org/10.1016/j.dib.2024.110983

Examples

bodycomp


Digestibility of dry matter

Description

This dataset contains example data to calculate the apparent digestibility of two diets that differ in their dry matter mass fraction and in the mass fraction of digestibility markers in the feces.

Format

A tibble with two rows and four columns:

diet

character; feed identifier.

dm

numeric; mass fraction of dry matter in the feed. Data reported as value between 0 and 1, corresponding to g/g.

std_feed

numeric; mass fraction of digestibility marker in feed. Data reported as value between 0 and 1, corresponding to g/g.

std_feces

numeric; mass fraction of digestibility marker in feces. Data reported as value between 0 and 1, corresponding to g/g.

Examples

digestdm


Digestibility of a feed ingredient

Description

This dataset contains example data for the determination of the apparent digestibility of feed ingredients by using a reference diet and replacing a part (usually 30 The dataset is based on Bureau et al. (1999) but was presented in its complete form in Bureau & Hua (2006).

Format

A tibble with one row and eight columns

diet_reference

character; reference feed identifier.

ingredient

character; feed ingredient identifier.

adc_reference

numeric; apparent digestibility coefficient of the reference feed. The data is a value between 0 and 1.

adc_test

numeric; apparent digestibility coefficient of the test feed. The data is a value between 0 and 1.

dm_reference

numeric; mass fraction of dry matter in the reference feed. Data reported as value between 0 and 1, corresponding to g/g.

dm_ingr

numeric; mass fraction of dry matter in the feed ingredient. Data reported as value between 0 and 1, corresponding to g/g.

CP_reference

numeric; mass fraction of crude protein in the pelleted reference feed reported as value between 0 and 1, corresponding to g/g.

CP_ingr

numeric; mass fraction of crude protein in the feed ingredient. Data reported as value between 0 and 1, corresponding to g/g.

References

Bureau, D. P. & Hua, K. (2006). Letter to the Editor of Aquaculture. Aquaculture, 252(2-4), 103–105. https://doi.org/10.1016/j.aquaculture.2006.01.028

Bureau, D. P., Harris, A. M. & Cho, C. Y. (1999). Apparent digestibility of rendered animal protein ingredients for rainbow trout (Oncorhynchus mykiss). Aquaculture, 180, 345–358. https://doi.org/10.1016/S0044-8486(99)00210-0

Examples

digestingr


Digestibility of feed nutrients

Description

This dataset contains example data for the calculation of apparent digestibility coefficients for the digestibility of nitrogen in the dry matter fraction of an aquaculture feed.

Format

A tibble with two rows and six columns:

diet

character; feed identifier.

dm

numeric; mass fraction of dry matter in the feed. Data reported as value between 0 and 1, corresponding to g/g.

N_feed

numeric; mass fraction of nitrogen in feed. Data reported as value between 0 and 1, corresponding to g/g.

std_feed

numeric; mass fraction of digestibility marker in feed. Data reported as value between 0 and 1, corresponding to g/g.

N_feces

numeric; mass fraction of nitrogen in feces in g/kg.

std_feces

numeric; mass fraction of digestibility marker in feces. Data reported as value between 0 and 1, corresponding to g/g.

Examples

digestnut


Feed conversion efficiency (FCE)

Description

A function that calculates the feed conversion efficiency (FCE), which is the inverse of the feed conversion ratio (FCR). As FCR, this metric measures how effectively cultivated species convert feed into weight. However, contrarily to FCR, the higher the FCE the more efficient the feed conversion is.

Usage

fce(ibw, fbw, feed, dm = 1)

Arguments

ibw

numeric; value that is providing the initial body weight in grams.

fbw

numeric; value that is providing the final body weight in grams.

feed

numeric; value providing the total feed fed in grams during the experiment.

dm

numeric; value indicating the dry matter content of the feed. Value in the interval of (0:1). Default is 1.

Value

a numeric value that is the feed conversion efficiency (FCE)

Author(s)

Anıl Axel Tellbüscher

Davide A. Machado e Silva

Madhav Karthikeyan

Examples

# Feed intake = 1500 g
# Feed dry matter = 0.96 g/g (= 96%)
# Initial bodyweight = 100 g
# Final bodyweight = 1000 g

fce(100, 1000, 1500, 0.96)


Feed Conversion Ratio (FCR)

Description

A function that calculates the Feed Conversion Ratio (FCR) based on the Initial Body weight (IBW; ibw) in gram (g), the Final Body Weight (FBW; fbw) in gram (g), the Feed fed (Ff; ff) in gram and the dry matter (DM; dm) content of the feed in percent.

Usage

fcr(ibw, fbw, feed, dm = 1)

Arguments

ibw

numeric; value that is providing the initial weight in grams.

fbw

numeric; value that is providing the final weight in grams.

feed

numeric; value providing the feed fed in grams during the experiment.

dm

numeric; value within the interval of ]0:1], indicating the relative dry matter content of the feed.

Details

The Feed Conversion Ratio (FCR) describes the amount of feed on dry matter (DM) basis that is required to gain 1 kg of body weight on wet weight basis. Depending on whether the Feed fed refers to the total amount of feed administered or the total amount corrected for non-eaten feed, the result resembles the economic FCR (eFCR) or the biological FCR (bFCR), respectively (Glencross et al., 2024).

Value

returns a numeric value that is the FCR.

Author(s)

Anıl Axel Tellbüscher

References

Lugert, V., Thaller, G., Tetens, J., Schulz, C., & Krieter, J. (2016): A review on fish growth calculation: multiple functions in fish production and their specific application. Reviews in Aquaculture, 8, p.30–42.

Glencross, B., Bachis, E., Robb, D., & Newton, R. (2024): The evolution of sustainability metrics for the marine ingredient sector: Moving towards holistic assessments of aquaculture feed. Reviews in Fisheries Science & Aquaculture, 32(4), p.545-561.

Examples

# Feed intake = 1500 g
# Feed dry matter = 0.96 g/g (= 96%)
# Initial bodyweight = 100 g
# Final bodyweight = 1000 g

fcr(100, 1000, 1500, 0.96)


Daily feed intake

Description

This dataset contains daily feed intake data from a feeding trial with Atlantic salmon (Salmo salar). The original dataset ("FeedIntake") was published by Liland et al. (2024) and is from the first out of two trials ("Trial A"). Alterations to the original data structure were done by 1) converting the double-row column names into single-row column names, 2) shortening the column names, and 3) converting the table into long format by moving the tank IDs into a separate column. NA values have been replaced by the recalculated feed intakes for the respective day.

Format

A tibble with 270 rows and 4 columns:

date

date; date of data recording.

tank

factor; rearing tank identifier.

daily_feed_intake

numeric; daily feed intake in gram per fish.

cumulative_feed_intake

numeric; cumulatic feed intake in gram per fish.

References

Liland, N., Rønnestad, I., Azevedo, M., Lai, F., Oulie, F., Conceição, L., Soares, F. (2024): Dataset on the performance of Atlantic salmon (Salmo salar) reared at different dissolved oxygen levels under experimental conditions. Data in Brief 57, 110983. https://doi.org/10.1016/j.dib.2024.110983

Examples

feed_intake


Feed composition

Description

This dataset contains compositional data of Skretting Protec, a commercial fish feed. The data comprises the proximate composition, phosphorus, and some essential amino acids.

Format

A tibble with one row and 25 columns:

diet

character; feed name.

dry_matter

numeric; content of feed in g/g.

crude_protein

numeric; content of feed in g/g as fed.

crude_lipids

numeric; content of feed in g/g as fed.

ash

numeric; content of feed in g/g as fed.

gross_energy

numeric; content of feed in MJ per kg as fed.

phosphorus

numeric; content of feed in g/g as fed.

arginine

numeric; content of feed in g/g as fed.

histidine

numeric; content of feed in g/g as fed.

isoleucine

numeric; content of feed in g/g as fed.

leucine

numeric; content of feed in g/g as fed.

lysine

numeric; content of feed in g/g as fed.

threonine

numeric; content of feed in g/g as fed.

tryptophan

numeric; content of feed in g/g as fed.

valine

numeric; content of feed in g/g as fed.

methionine

numeric; content of feed in g/g as fed.

cysteine

numeric; content of feed in g/g as fed.

phenylalanine

numeric; content of feed in g/g as fed.

tyrosine

numeric; content of feed in g/g as fed.

aspartic_acid

numeric; content of feed in g/g as fed.

glutamic_acid

numeric; content of feed in g/g as fed.

alanine

numeric; content of feed in g/g as fed.

glycine

numeric; content of feed in g/g as fed.

proline

numeric; content of feed in g/g as fed.

serine

numeric; content of feed in g/g as fed.

References

Liland, N., Rønnestad, I., Azevedo, M., Lai, F., Oulie, F., Conceição, L., Soares, F. (2024): Dataset on the performance of Atlantic salmon (Salmo salar) reared at different dissolved oxygen levels under experimental conditions. Data in Brief 57, 110983. https://doi.org/10.1016/j.dib.2024.110983

Examples

feedcomp


Daily count of live and dead fish

Description

This dataset contains the daily count of dead and alive fish during a 29-day feeding trial with Atlantic salmon (Salmo salar). The original dataset ('NumberOfFish') was published by Liland et al. (2024) and is from the first out of two trials ('Trial A'). Alterations to the original data structure were done by 1) converting the double-row column names into single-row column names, 2) shortening the column names, and 3) converting the table into long format by moving the tank IDs into a separate column.

Format

A tibble with 270 rows and 4 columns:

date

date; date of data recording.

tank

factor; rearing tank identifier.

total_number

numeric; count of fish stocked at the beginning of the experiment.

dead

numeric; count of dead fish on each recorded day of the experiment.

References

Liland, N., Rønnestad, I., Azevedo, M., Lai, F., Oulie, F., Conceição, L., Soares, F. (2024): Dataset on the performance of Atlantic salmon (Salmo salar) reared at different dissolved oxygen levels under experimental conditions. Data in Brief 57, 110983. https://doi.org/10.1016/j.dib.2024.110983

Examples

fishcount


Geometric Mean Bodyweight (GMBW)

Description

A function that calculates the geometric mean of the initial and final bodyweight.

Usage

gbw(ibw, fbw)

Arguments

ibw

numeric; initial bodyweight weight in grams.

fbw

numeric; final bodyweight in grams.

Details

While the arithmetic mean assumes a linear relationship between the averaged numbers, the geometric mean accounts for the non-linear and potentially variable nature of animal growth.

Value

numeric value that is the geometric mean bodyweight.

Author(s)

Anıl Axel Tellbüscher

Examples

data(weight2)
dplyr::mutate(weight2, GMBW = gbw(ibw_g, fbw_g))


Metabolic bodyweight (MBW)

Description

The metabolic bodyweight is the rate of energy expenditure in dependence of the bodyweight of an organism. The metabolism of larger animals is generally slower per Kg when comparing with smaller animals. An exponent between 0-1 takes that relationship into account in a fairly simple equation.

Usage

mbw(ibw, fbw, mb_exp = 0.8)

Arguments

ibw

a numeric value that is providing the initial weight in grams.

fbw

a numeric value that is providing the final weight in grams.

mb_exp

a numeric value between 0-1 providing the exponent. Default is 0.8 adapted to most fish species.

Details

The default exponent is suited to fish only. It was set to 0.8 based on Lupatsch et al. (2003) and should be adjusted to other scenarios.

Value

returns a numeric value that is the metabolic bodyweight.

Author(s)

Anıl Axel Tellbüscher

Davide A. Machado e Silva

Madhav Karthikeyan

References

Lupatsch, I. et al. (2003): Comparison of energy and protein efficiency among three fish species gilthead sea bream (Sparus aurata), European sea bass (Dicentrarchus labrax) and white grouper (Epinephelus aeneus): energy expenditure for protein and lipid deposition. Aquaculture 225, p.175-189.

Examples

data(weight2)
dplyr::mutate(weight2, MBW = mbw(ibw_g, fbw_g))


Nutrient Efficiency Ratio (NER)

Description

Function to calculate the Nutrient Efficiency Ratio (NER). The NER belongs to the Nutrient Use Efficiency metrics and relates the intake of a compound with the bodyweight increase. If the feed intake (FI) is restricted and the administered diets are of comparable digestibility, then potential differences in growth could be related to differences in the sub-composition of target nutrients that are also controlled for. This would be reflected by the NER.

Usage

ner(ibw, fbw, fi, nut_f, dm = 1)

Arguments

ibw

a numeric value for the initial weight (either average weight of the individuals or the total biomass) of the livestock at the beginning of the feeding trial.

fbw

a numeric value for the final weight (either average weight of the individuals or the total biomass) of the livestock at the end of the feeding trial.

fi

numeric; value providing the total feed intake in grams during the experiment.

nut_f

numeric; value within the interval of (0,1), indicating the inclusion rate of the nutrient of interest in the feed fed.

dm

numeric; value within the interval of (0,1), indicating the dry matter content of the feed. Default is 1 (100%).

Value

returns a single numeric value

Author(s)

Anıl Axel Tellbüscher

Examples

# Initial bodyweight = 10 g
# Final bodyweight = 100 g
# Feed intake = 240 g
# Nutrient mass fraction in feed = 0.5 g/g
ner(ibw = 10, fbw = 100, fi = 240, nut_f = 0.5)


Nutrient retention (NR)

Description

Function to calculate the Nutrient Retention (NR). The NR belongs to the Nutrient Use Efficiency metrics and is a measure for the proportion of a consumed nutrient that is retained in the tissue.

Usage

nr(ibw, fbw, ibn, fbn, fi, nut_f, dm = 1, dm_ib = 1, dm_fb = 1)

Arguments

ibw

numeric; initial weight in grams

fbw

numeric; final weight in grams

ibn

numeric; initial mass fraction of the target nutrient in the tissue of the experimental animal (on dry matter basis). The value must be between 0 and 1.

fbn

numeric; final mass fraction of the target nutrient in the tissue of the experimental animal (on dry matter basis). The value must be between 0 and 1.

fi

numeric; mass of feed given.

nut_f

numeric; mass fraction of nutrient in the diet. The value must be between 0 and 1.

dm

numeric; dry matter content of feed. Default is 1.

dm_ib

numeric; initial dry matter content of body tissue. Default is 1.

dm_fb

numeric; final dry matter content of body tissue. Default is 1.

Value

a numeric value. Multiply by 100 to convert into percentage.

Author(s)

Anıl Axel Tellbüscher

References

Willer, D.F., Newton, R., Malcorps, W. et al. Wild fish consumption can balance nutrient retention in farmed fish. Nat Food 5, 221–229 (2024). https://doi.org/10.1038/s43016-024-00932-z

Examples

# initial bodyweight = 10 g (0.01 kg)
# final bodyweight = 100 g (0.1 kg)
# initial mass fraction of N = 128 g/kg (80% CP on DM basis)
# final mass fraction of N = 132 g/kg (82.5% CP on DM basis)
# feed intake = 200 g (0.2 kg)
# N in feed = 72 g/kg (45% CP)

nr(10, 100, 0.128, 0.132, 200, 0.072) * 100

# 82.7% of the provided N has been retained


# multiple fish
nr(ibw = 10, fbw = c(93, 102, 99, 98, 101, 132),
   ibn = 0.128, fbn = 0.132,
   fi = 200, nut_f = 0.072)


Rearing data from the first polyculture experiment

Description

A dataset containing feed quantities fed per tank and the average water temperature over all tanks stocked with pikeperch oder sturgeon. The variables are as follows:

Format

A data frame containing 24 rows and four columns:

tank

character; unique identifier for each fish tank.

feed_g

numeric; total feed input in gram over the duration of the experiment.

temp_C

numeric; average water temperature in degrees Celsius.

duration

numeric; total duration of the experiment in days.

Examples

rearing


Relative Growth (RG)

Description

A function that calculates the Relative Growth (RG) based on the Initial Body weight (IBW; ibw) and the Final Body Weight (FBW; fbw) in grams (g).

Usage

rg(ibw, fbw)

Arguments

ibw

numeric; value providing the initial weight in grams.

fbw

numeric; value providing the final weight in grams.

Value

returns a numeric value that is the Relative Growth. Multiply by 100 for conversion into a percentage.

Author(s)

Anıl Axel Tellbüscher

Examples

data(weight2)
dplyr::mutate(weight2, RG = rg(ibw_g, fbw_g))


Relative Growth Rate (RGR)

Description

A function that calculates the Relative Growth Rate (RGR), which is the relative weight increase per time unit.

Usage

rgr(ibw, fbw, duration, mean_fun = "init")

Arguments

ibw

numeric; provides the initial weight in gram.

fbw

numeric; provides the final weight in gram.

duration

numeric; duration of the growth experiment.

mean_fun

character; specifies how ("init", "geometric" or "arithmetic") to calculate the denominator. Default: "init".

Value

either a single numeric value or vector holding the calculated RGR values. Multiply by 100 for conversion into percentage.

Author(s)

Anıl Axel Tellbüscher

References

Lugert, V., Thaller, G., Tetens, J., Schulz, C., & Krieter, J. (2016): A review on fish growth calculation: multiple functions in fish production and their specific application. Reviews in Aquaculture, 8, p.30–42.

Examples

data(weight2)
dplyr::mutate(weight2, RGR = rgr(ibw_g, fbw_g, duration = 84))


Sampling data

Description

This dataset contains the fish weight, fork length, sex, liver weight, hepatosomatic index, heart weight, cardiosomatic index, gonad weight, gonadosomatic index, viscera weight, and viscerosomatic index from a feeding trial with Atlantic salmon (Salmo salar). The original dataset ('FeedIntake') was published by Liland et al. (2024) and is from the first out of two trials ('Trial A'). Alterations to the original data structure were done by 1) converting the double-row column names into single-row column names, and 2) removing the 'sex' column.

Format

A tibble with 181 rows and 14 columns:

date

date; date of data recording.

tank

factor; rearing tank identifier.

replicate

factor; replicate identifier.

sample_type

factor; type of sample.

fish_weight

numeric; weight of fish in gram.

fork_length

numeric; length of fish from the tip of the snout to the end of the middle caudal fin rays in centimeter.

liver_weight

numeric; weight of the liver in gram.

hsi

numeric; hepatosomatic index in percent.

heart_weight

numeric; weight of the heart in gram.

csi

numeric; cardiosomatic index in percent.

gonad_weight

numeric; weight of the gonads in gram.

gsi

numeric; gonadosomatic index in percent.

viscera_weight

numeric; weight of the viscera in gram.

vsi

numeric; viscerosomatic index in percent.

References

Liland, N., Rønnestad, I., Azevedo, M., Lai, F., Oulie, F., Conceição, L., Soares, F. (2024): Dataset on the performance of Atlantic salmon (Salmo salar) reared at different dissolved oxygen levels under experimental conditions. Data in Brief 57, 110983. https://doi.org/10.1016/j.dib.2024.110983

Examples

samplings


Specific Growth Rate (SGR)

Description

This function calculates the Specific Growth Rate (SGR) based on the Instantaneous Growth Rate (IGR). The IGR is a useful metric, although hard to interpret. The SGR, derived from IGR, can then be easily interpreted as the percentage of Body Weight gained each day. The SGR is a growth metric for aquaculture products (e.g., fish, crustaceans, bivalves, algae), describing the increase in body weight over a period of time. Body weight can be substituted by other metrics, such as length. However, body weight is the used in the vast majority of studies and alternatives are not advised for the sake of consistency.

Usage

sgr(ibw, fbw, duration, return_igr = FALSE)

Arguments

ibw

numeric; value that is providing the initial body weight in grams.

fbw

numeric; value that is providing the final body weight in grams.

duration

numeric value that is providing the duration of the experiment in days.

return_igr

logical; default is FALSE. Indicates whether the instantaneous growth rate shall be returned together with the SGR or not.

Value

Returns a numeric, which is the SGR as percentage of the body weight gain per day, or a list containing the SGR and the IGR.

Author(s)

Anıl Axel Tellbüscher

Davide A. Machado e Silva

References

Crane, D.P., Ogle, D.H. and Shoup, D.E. (2020), Use and misuse of a common growth metric: guidance for appropriately calculating and reporting specific growth rate. Rev Aquacult, 12: 1542-1547. https://doi.org/10.1111/raq.12396

Examples

dplyr::mutate(weight2, SGR = sgr(ibw_g, fbw_g, duration = 84))


Thermal Growth Coefficient (TGC)

Description

A function that calculates Thermal Growth Coefficient (TGC) based on the Initial Body weight (IBW) in grams (g), the Final Body Weight (FBW) in grams (g) and the average water temperature (Temp.) in Celsius (°C) for the duration of the trial.

The TGC is an alternative growth metric for fishes, describing the increase in bodyweight over a period of time. It is suitable for poikilothermic animals due to its standardisation for temperature. It should, however, be taken into account, that the temperature during the experiment should remain within the optimum range. It is also noteworthy that the equation is optimized for a constant temperature throughout the experiment.

Usage

tgc(ibw, fbw, duration, temp, scale_coef = 1000)

Arguments

ibw

a numeric value that is providing the initial body weight in grams.

fbw

a numeric value that is providing the final body weight in grams.

duration

a numeric value that is providing the duration of the experiment in days.

temp

a numeric value that is providing the average temperature during the experiment in degrees Celsius.

scale_coef

Scaling coefficient. A numeric value that scales the TGC result so it is more intuitive and interpretable. Default is 1000.

Value

Returns a numeric value that is the TGC.

Author(s)

Anıl Axel Tellbüscher

Davide A. Machado e Silva

Madhav Karthikeyan

References

Lugert, V., Thaller, G., Tetens, J., Schulz, C., & Krieter, J. (2016): A review on fish growth calculation: multiple functions in fish production and their specific application. Reviews in Aquaculture, 8, p.30–42.

Jobling, M. (2003): The thermal growth coefficient (TGC) model of fish growth: a cautionary note. Aquaculture Research, 34, p. 581–584.


Treatments

Description

This dataset contains the rearing tank and respective treatment assigned to it. It represents the metadata from a feeding trial with Atlantic salmon (Salmo salar). The related dataset was published by Liland et al. (2024) and is from the first out of two trials ("Trial A").

Format

A tibble with nine rows and two columns:

tank

factor; rearing tank identifier.

treatment

factor; treatment identifier.

References

Liland, N., Rønnestad, I., Azevedo, M., Lai, F., Oulie, F., Conceição, L., Soares, F. (2024): Dataset on the performance of Atlantic salmon (Salmo salar) reared at different dissolved oxygen levels under experimental conditions. Data in Brief 57, 110983. https://doi.org/10.1016/j.dib.2024.110983

Examples

treatments


Daily water parameters

Description

This dataset contains daily readings of water temperature, salinity, and dissolved oxygen from a feeding trial with Atlantic salmon (Salmo salar). The original dataset ("WaterParametersDaily") was published by Liland et al. (2024) and is from the first out of two trials ("Trial A"). Alterations to the original data structure were done by 1) converting the double-row column names into single-row column names, 2) shortening the column names, and 3) converting the table into long format by moving the tank IDs into a separate column.

Format

A tibble with 270 rows and 6 columns:

date

date; date of data recording.

tank

factor; rearing tank identifier.

temp

numeric; water temperature in degrees Celsius.

salinity

numeric; salinity in parts per thousand.

do_perc

numeric; dissolved oxygen in percentage saturation.

do_conc

numeric; dissolved oxygen concentration in mg/L.

References

Liland, N., Rønnestad, I., Azevedo, M., Lai, F., Oulie, F., Conceição, L., Soares, F. (2024): Dataset on the performance of Atlantic salmon (Salmo salar) reared at different dissolved oxygen levels under experimental conditions. Data in Brief 57, 110983. https://doi.org/10.1016/j.dib.2024.110983

Examples

water_params


Fish biomass and bodyweights from the first polyculture experiment

Description

A dataset containing fish weights from a polyculture experiment with pikeperch (Sander lucioperca) and Russian sturgeon.

Format

A tibble with 24 rows and eight columns:

tank

character; rearing tank identifier.

treat_id

character; treatment identifier.

count_start

numeric; fish count at the beginning of the experiment.

count_end

numeric; fish count at the end of the experiment.

biomass_kg_start

numeric; total fish biomass in kg at the beginning of the experiment.

biomass_kg_end

numeric; total fish biomass in kg at the end of the experiment.

Examples

weight


Individual fish bodyweights during a polyculture experiment

Description

A dataset holding weight data of tagged individuals of two different fish species, pikeperch (Sander lucioperca) and largemouth bass (Micropterus salmoides), at the beginning and the end of a polyculture experiment for aquaculture purposes.

Format

A tibble with 396 rows and four columns:

species

character; species identifier.

culture_sys

character; culture system identifier.

ibw_g

numeric; initial bodyweight in gram.

fbw_g

numeric; final bodyweight in gram.

References

Pěnka T., Malinovskyi O., Křišťan J., Imentai A., Policar T. (2021): Effect of density and mixed culture with pikeperch (Sander lucioperca) on effectivity of largemouth bass (Micropterus salmoides) intensive culture. Czech Journal of Animal Science, 66: 428–440.

Examples

weight2

mirror server hosted at Truenetwork, Russian Federation.