Calculates food-egg outputs for chickens over the assessment period.
Usage
calc_egg_production(
species_short,
cohort_short,
egg_human_consumption_yield,
egg_average_weight,
simulation_duration,
cohort_stock_size,
egg_protein_fraction = 0.125,
nondemo_productive_phase_id = NA_real_,
is_egg_producing = FALSE
)Arguments
- species_short
Character. Code identifying the livestock species. Supported values include:
CHK: chickens
- cohort_short
Character. Sex-specific cohort code describing the age and/or the production stage of the animals. Supported values include:
FA: adult females (from age at first parturition)FS: sub-adult females (from weaning to age at first parturition)FJ: juvenile females (from birth to weaning)MA: adult males (from age at first breeding)MS: sub-adult males (from weaning to age at first breeding)MJ: juvenile males (from birth to weaning)FN: non-demographic femalesMN: non-demographic males
- egg_human_consumption_yield
Numeric. Number of eggs produced for human consumption in one year by hen (eggs/year/animal). Used for
CHK.- egg_average_weight
Numeric. Average egg weight (kg/egg).
- simulation_duration
Numeric. Length of the assessment period (days).
- cohort_stock_size
Numeric. Average population size of the assessed cohort (# heads).
- egg_protein_fraction
Numeric. Protein content of whole egg (kg protein/kg egg).
- nondemo_productive_phase_id
Numeric. Optional productive phase identifier for non-demographic cohorts (
FN,MN). Takes value1for phase 1 and optionally2for phase 2.- is_egg_producing
Logical. Cohort-level flag identifying egg-producing
CHKcohorts. This can beTRUEonly forFAand forFNwithnondemo_productive_phase_id = 2.
Details
Food-egg production is computed only for cohorts flagged with
is_egg_producing = TRUE. Validation restricts this flag to
demographic laying hens (FA) and to non-demographic FN phase 2
when intensive layers are represented in the non-demographic pathway.
Reproductive eggs from FA are excluded from these food outputs.
The following equations are applied:
$$ egg\_production\_number\_cohort = \frac{egg\_human\_consumption\_yield}{365} \times cohort\_stock\_size \times simulation\_duration $$
$$ egg\_production\_mass\_cohort = egg\_production\_number\_cohort \times egg\_average\_weight $$
$$ egg\_production\_protein\_cohort = egg\_production\_mass\_cohort \times egg\_protein\_fraction $$
where the default egg_protein_fraction is 0.125 kg protein/kg egg
mass, following the poultry integration assumptions used in GLEAM-X.