Man pages for fb4package
'Fish Bioenergetics 4.0' Model Implementation with High-Performance 'TMB' Backend

accumulate_validationsAccumulate multiple validation results
add_confidence_bandsAdd Confidence Bands to Plot
add_plot_annotationsAdd Standard Plot Annotations
add_strategy_metadataAdd standard strategy metadata to results
analysis-coreCore Analysis Functions for FB4 Results
analysis-extractionBasic Analysis and Extraction Functions for FB4 Results
analysis-nutritionalNutritional Analysis Functions for FB4 Results
analysis-sensitivitySensitivity and Comparative Analysis Functions for FB4...
analyze_composition_by_sizeAnalyze body composition by size range
analyze_composition_changesAnalyze composition changes with growth
analyze_energy_budgetAnalyze energy budget from FB4 results
analyze_feeding_performanceAnalyze feeding performance from FB4 results
analyze_growth_patternsAnalyze growth patterns from FB4 results
analyze_growth_temperature_sensitivityAnalyze growth rate sensitivity to temperature and feeding...
analyze_population_variationAnalyze population variation in hierarchical models
assess_diet_qualityAssess nutritional quality of diet
assign_energy_componentsFill energy budget components from a named source list
basic-validatorsBasic Validation Functions for FB4
binary_search_p_valueBinary search for optimal p_value
BioenergeticConstructor for Bioenergetic Objects
bioenergetic-classesS3 Classes for FB4 Bioenergetic Model
bioenergetic-methodsMethods for FB4 Bioenergetic Model
body-compositionBody Composition Functions for FB4 Model
bootstrap_p_valuesBootstrap estimation of p_values with optional parallel...
bootstrap_single_iterationExecute a single bootstrap iteration
build_composition_dfBuild a body-composition data frame from a list of...
build_fb4_result_unifiedBuild FB4 result object
build_individual_uncertaintyBuild individual-level uncertainty list for hierarchical...
build_population_uncertaintyBuild population-level uncertainty list for hierarchical...
build_tmb_uncertaintyBuild TMB uncertainty list for MLE results
calculate_activity_factor_respirationCalculate activity factor for respiration (Mid-level)
calculate_body_compositionCalculate complete body composition (Mid-level - Main...
calculate_combined_survivalCalculate combined daily survival (Low-level)
calculate_component_from_waterEstimate composition from water using Breck (2014) regression...
calculate_confidence_intervalsConfidence interval from estimate and standard error
calculate_consumptionCalculate daily consumption (Mid-level - Main function)
calculate_consumption_params_eq2Calculate additional parameters for consumption equation 2...
calculate_consumption_params_eq3Calculate additional parameters for consumption equation 3...
calculate_contaminant_accumulationCalculate contaminant accumulation (Mid-level - Main...
calculate_daily_consumptionCalculate daily consumption with multiple methods (Low-level)
calculate_daily_metabolismCalculate daily metabolic processes (Low-level)
calculate_daily_spawn_energyCalculate reproductive energy loss for the day (Low-level)
calculate_daily_weight_changeCalculate daily weight change (Low-level)
calculate_dissolved_fractionCalculate dissolved fraction of contaminant (Low-level)
calculate_egestionCalculate daily egestion (Mid-level - Main function)
calculate_energy_densityCalculate energy density from fat and protein (Low-level)
calculate_excretionCalculate daily excretion (Mid-level - Main function)
calculate_fat_by_subtractionCalculate fat content by subtraction (Low-level)
calculate_final_weight_fb4Calculate final weight using FB4 equations (Mid-level)
calculate_fish_water_partitionCalculate fish:water partition coefficient (Low-level)
calculate_gill_efficiencyCalculate gill uptake efficiency (Low-level)
calculate_growth_metricsCalculate Basic Growth Metrics
calculate_mortality_reproductionCalculate daily mortality and reproduction (Mid-level - Main...
calculate_np_ratiosCalculate N:P ratios for all processes
calculate_nutrient_allocationGeneric nutrient allocation in bioenergetic model (Low-level)
calculate_nutrient_balanceCalculate nutrient balance (Mid-level - Main function)
calculate_nutrient_efficienciesCalculate nutrient retention efficiencies
calculate_predator_energy_densityCalculate predator energy density (Mid-level - Main function)
calculate_progress_intervalCalculate appropriate progress reporting interval
calculate_reproductive_lossCalculate reproductive weight loss (Low-level)
calculate_respirationCalculate daily respiration (Mid-level - Main function)
calculate_respiration_params_eq2Calculate additional parameters for respiration equation 2...
calculate_sdaCalculate Specific Dynamic Action (SDA) (Low-level)
calculate_spawn_energyCalculate spawning energy loss (Low-level)
calculate_stoichiometric_balanceCalculate stoichiometric balance
calculate_temperature_dependent_mortalityCalculate temperature-dependent mortality (Low-level)
calculate_temperature_factor_consumptionCalculate temperature factor for consumption (Mid-level)
calculate_temperature_factor_respirationCalculate temperature factor for respiration (Mid-level)
calculate_weight_dependent_mortalityCalculate weight-dependent mortality (Low-level)
check_bioenergetic_readinessCheck Bioenergetic Object Readiness
check_numeric_valueCheck Numeric Value
check_target_achievementCheck if target was achieved for traditional methods
check_tmb_compilationCheck TMB model availability (simplified for installed...
check_weight_outliersCheck for outliers in weight data
clampClamp values to a range
close_save_deviceClose graphics device after saving
compare_individualsCompare individuals from hierarchical models
compare_scenariosCompare multiple FB4 results
compare_with_redfieldCompare N:P ratios with Redfield ratios
comprehensive_nutritional_analysisComprehensive nutritional analysis
compute_likelihood_profileCompute likelihood profile for p_value
consumption-functionsConsumption Functions for FB4 Model
consumption_temp_eq1Temperature function for consumption - Equation 1 (Low-level)
consumption_temp_eq2Temperature function for consumption - Equation 2 (Low-level)
consumption_temp_eq3Temperature function for consumption - Equation 3 (Low-level)
consumption_temp_eq4Temperature function for consumption - Equation 4 (Low-level)
contaminant-accumulationContaminant Accumulation Functions for FB4 Model
contaminant_model_1Contaminant model 1 - Food uptake only (Low-level)
contaminant_model_2Contaminant model 2 - With temperature and weight dependent...
contaminant_model_3Contaminant model 3 - Arnot & Gobas (2004) (Low-level)
convert_daily_results_to_dataframeConvert list of daily results to data frame
convert_respiration_to_energyConvert respiration from O2 to energy units (Utility)
convert_to_individual_dataConvert hierarchical observed_weights to individual_data...
core-validatorsCore Validation Functions for FB4
create_binary_search_strategyCreate Binary Search Strategy
create_bootstrap_strategyCreate Bootstrap Strategy
create_direct_strategyCreate Direct Strategy
create_empty_compositionCreate empty composition for invalid inputs (Utility)
create_error_resultCreate standardized error result
create_execution_planCreate execution plan for FB4 strategies
create_execution_summaryCreate execution summary for verbose output
create_fb4_strategyCreate FB4 strategy based on method
create_hierarchical_strategyCreate Hierarchical Strategy
create_individual_rankingsCreate individual rankings across metrics
create_individual_summaryCreate summary statistics for individual metric
create_method_specific_dataCreate method-specific data section
create_mle_strategyCreate MLE Strategy
create_optim_strategyCreate Optim Strategy
create_result_summaryComprehensive post-simulation analysis summary
create_unified_fit_infoCreate unified fit info section
create_unified_summaryBuild the '$summary' slot of an fb4_result object
data-processingData Processing Functions for FB4
data-validatorsData Validation Functions for FB4
detect_methodDetect method from raw results or execution plan
detect_result_typeDetect method and backend from fb4_result
egestion-excretionEgestion and Excretion Functions for FB4 Model
egestion_model_1Egestion model 1 - Basic (Low-level)
egestion_model_2Egestion model 2 - Elliott (1976) (Low-level)
egestion_model_3Egestion model 3 - Stewart et al. (1983) (Low-level)
egestion_model_4Egestion model 4 - Elliott (1976) without p_value (Low-level)
EQUATION_REQUIREMENTSEquation requirements for all FB4 components
excretion_model_1Excretion model 1 - Basic (Low-level)
excretion_model_2Excretion model 2 - With temperature and feeding dependence...
excretion_model_3Excretion model 3 - Variant of model 2 (Low-level)
excretion_model_4Excretion model 4 - Without feeding dependence (Low-level)
execute_daily_simulationExecute single day simulation (Mid-level)
execute_hierarchical_tmbExecute hierarchical TMB using unified architecture and...
execute_mle_tmbExecute MLE TMB using unified architecture
execute_simulation_with_methodExecute simulation with any method
extract_adreport_valuesExtract ADREPORT values from TMB report
extract_basic_parametersExtract parameters for basic model
extract_data_sourcesExtract data sources from bioenergetic object
extract_hierarchical_parametersExtract parameters for hierarchical model
extract_species_nameExtract Species Information for Titles
extract_strategy_parametersExtract common strategy parameters from execution plan
extract_tmb_resultsExtract comprehensive results from TMB optimization
fb4-analysis-plotsAnalysis Plots for FB4 Results (Uncertainty and Sensitivity)
fb4-bioenergetic-plotsBioenergetic Object Plots for Setup Validation
fb4-daily-plotsDaily Simulation Plots for FB4 Results
fb4package-packageFish Bioenergetics 4.0 Package
fb4-plot-coreCore Plotting Functions for FB4 Results
fb4-plotsFB4 Plotting Functions
FB4StrategyFB4 Strategy Interface
FB4-TMB-SharedFB4 TMB Shared Functions
fish4_parametersFish Bioenergetics 4.0 Official Parameters Database
fish4_parameters_metadataFish Bioenergetics 4.0 Parameters Database Metadata
fit_fb4_binary_searchFit FB4 model using binary search
fit_fb4_bootstrapFit FB4 model using bootstrap estimation with parallel option
fit_fb4_mleFit FB4 model using Maximum Likelihood Estimation
fit_fb4_optimFit FB4 model using optim()
format_statistics_textFormat Statistics Text for Plots
generate_reproduction_patternGenerate seasonal reproduction pattern (Low-level)
get_available_plot_typesGet Available Plot Types
get_color_schemeGet Color Scheme for Plots
get_consumption_uncertaintyGet consumption results with uncertainty
get_efficiency_uncertaintyGet efficiency results with uncertainty
get_energy_budget_uncertaintyGet energy budget components with uncertainty
get_individual_resultsGet individual results from hierarchical models
get_parameter_valueGet Parameter Value from Species Parameters
get_population_resultsGet population results from hierarchical models
has_uncertaintyCheck if result has uncertainty information
identify_best_scenariosIdentify best performing scenarios
interpolate_time_seriesInterpolate time series with error handling
is.BioenergeticTest if Object is Bioenergetic
is.fb4_resultTest if Object is fb4_result
log_execution_planLog execution plan details
main-validatorsMain Validation Functions for FB4
mle_estimate_p_value_lognormalMaximum Likelihood Estimation for p_value using log-normal...
mortality-reproductionMortality and Reproduction Functions for FB4 Model
neg_log_likelihood_lognormalCalculate negative log-likelihood for log-normal weight...
normalize_diet_proportionsNormalize diet proportions to sum to 1
nutrient_efficiency_blockCompute efficiency metrics for a single nutrient
nutrient-regenerationNutrient Regeneration Functions for FB4 Model
op-null-defaultNull-coalescing operator
optim_search_p_valueOptimization using optim() for optimal p_value
parameter-processingParameter Processing Functions for FB4
parameter-validatorsParameter Validation Functions for FB4
perform_scenario_testsPerform statistical tests between scenarios
plot_bio_dashboardPlot Bioenergetic dashboard
plot_bio_dietPlot Bioenergetic diet
plot.BioenergeticPlot Bioenergetic object setup
plot_bio_energyPlot Bioenergetic energy
plot_bio_temperaturePlot Bioenergetic temperature
plot_bootstrap_distributionsPlot bootstrap distributions
plot_bootstrap_uncertaintyPlot bootstrap uncertainty
plot_consumptionPlot consumption patterns
plot_dashboardCreate dashboard overview
plot_distributions.fb4_resultPlot parameter distributions for bootstrap and hierarchical...
plot_energyPlot energy budget components
plot_estimate_panelDraw a single parameter estimate panel with confidence...
plot.fb4_resultPlot FB4 simulation results
plot_growthPlot growth trajectory
plot_growth_temperature_sensitivityPlot sensitivity analysis
plot_growth_vs_temperaturePlot growth rate vs temperature
plot_hierarchical_distributionsPlot hierarchical distributions
plot_hierarchical_uncertaintyPlot hierarchical uncertainty
plot_mle_uncertaintyPlot MLE uncertainty
plot_sensitivity.fb4_resultPlot temperature sensitivity analysis for a Bioenergetic...
plot_temperaturePlot temperature profile
plot_uncertainty.fb4_resultPlot parameter uncertainty for probabilistic methods
predator-energy-densityPredator Energy Density Functions for FB4 Model
predator_energy_eq1Energy density from interpolated data - Equation 1...
predator_energy_eq2Linear piecewise energy density - Equation 2 (Low-level)
predator_energy_eq3Power function energy density - Equation 3 (Low-level)
predict_consumption_bootstrapBootstrap method for consumption uncertainty propagation
predict_consumption_deltaDelta method for consumption uncertainty propagation
prepare_simulation_dataPrepare all simulation data
print.BioenergeticPrint Method for Bioenergetic Objects
print.fb4_resultPrint Method for fb4_result Objects
process_bioenergetic_dataProcess Bioenergetic object temporal data for simulation
process_composition_paramsProcess body composition parameters
process_consumption_paramsProcess consumption parameters
process_contaminant_paramsProcess contaminant parameters
process_egestion_paramsProcess egestion parameters
process_excretion_paramsProcess excretion parameters
process_mortality_paramsProcess mortality parameters
process_nutrient_paramsProcess nutrient parameters
process_predator_energy_dataProcess predator energy data for equation 1 (PREDEDEQ = 1)
process_predator_paramsProcess predator energy density parameters
process_reproduction_dataProcess reproduction data
process_reproduction_patternProcess reproduction pattern
process_respiration_paramsProcess respiration parameters
process_simulation_settingsProcess simulation settings
process_species_parametersProcess all species parameters for simulation
process_temperatureProcess single temperature with all p-values
report_simulation_progressReport simulation progress
report_simulation_summaryReport final simulation summary
respiration-functionsRespiration Functions for FB4 Model
respiration_temp_eq1Temperature function for respiration - Equation 1 (Low-level)
respiration_temp_eq2Temperature function for respiration - Equation 2 (Low-level)
result-builders-unifiedResult Builders for FB4 Model
run_fb4Run FB4 Simulation
run_fb4.BioenergeticRun FB4 simulation on Bioenergetic object
run_fb4_direct_methodRun FB4 with direct method
run-fb4-orchestratorFB4 Main Orchestrator
run_fb4_simulationRun complete FB4 simulation (Mid-level - Main function)
run_final_simulationRun final simulation with optimal parameter
run_robust_optimizationRun robust optimization with multiple fallback strategies
run_single_optimizationRun single optimization attempt
safe_expSafe exponential
safe_extract_paramSafe parameter extraction with defaults
safe_sqrtSafe square root
sdr_assign_scalarsBatch-assign scalar estimate/SE pairs to a results list
sdr_pull_estPull a scalar estimate from an sdreport summary
sdr_pull_sePull a scalar standard error from an sdreport summary
sdr_pull_vecPull a vector of estimates and SEs from an sdreport summary
set_dietSet Diet Data for Bioenergetic Objects
set_environmentSet Environmental Data for Bioenergetic Objects
set_parameter_valueSet Parameter Value in Species Parameters
set_simulation_settingsSet Simulation Settings for Bioenergetic Objects
setup_plot_layoutSetup Plot Layout
setup_save_deviceSetup graphics device for saving
should_mark_as_fittedDetermine if bio_obj should be marked as fitted
simulation-engineSimulation Engine for FB4 Model
solve_weight_iterativeSolve weight using iterative method (Mid-level)
solve_weight_linear_segmentsSolve weight for linear segments (Low-level)
solve_weight_power_functionSolve weight for power function (Low-level)
strategy-binary-searchBinary Search Strategy for FB4 Model
strategy-bootstrapBootstrap Estimation Strategy for FB4 Model
strategy-commonsStrategy Commons for FB4 Model
strategy-directDirect Strategies for FB4 Model
strategy-hierarchicalHierarchical Estimation Strategy for FB4 Model
strategy-interfaceStrategy Interface and Factory for FB4 Model
strategy-mleMaximum Likelihood Estimation Strategy for FB4 Model
strategy-optimOptimisation Strategy for FB4 Model
summary.BioenergeticSummary Method for Bioenergetic Objects
summary.fb4_resultSummary Method for fb4_result Objects
test_metric_differencesTest differences between metric estimates
transform_to_tmb_basicTransform simulation data to TMB basic format
transform_to_tmb_hierarchicalTransform simulation data to TMB hierarchical format
uncertainty-predictionFB4 Uncertainty Propagation Functions
update_body_compositionUpdate body composition during simulation (Mid-level)
utilsUtility Functions for fb4package
validate_backend_compatibilityValidate backend compatibility
validate_basic_paramsValidate Basic Model Parameters
validate_bioenergetic_for_simulationComprehensive validation for Bioenergetic objects
validate_body_compositionValidate body composition
validate_category_equationValidate equation parameters for a specific category
validate_common_strategy_inputsValidate common strategy inputs
validate_complete_simulation_dataValidate complete simulation data
validate_contaminant_paramsValidate contaminant parameters
validate_data_consistencyValidate data consistency between components
validate_diet_consistencyValidate Consistency Between Diet and Energy Data
validate_equation_paramsValidate equation parameters against requirements
validate_fb4_inputsValidate inputs for FB4 simulation
validate_fb4_resultValidate unified result object structure
validate_fb4_systemValidate complete FB4 system ready for simulation
validate_fitting_settingsValidate fitting settings
validate_fit_to_strategy_concordanceValidate concordance between fit_to and strategy parameters
validate_fractionValidate fraction values (0-1 range)
validate_individual_dataValidate individual data for hierarchical models
validate_numeric_coreCore numeric validation with flexible handling strategies
validate_nutrient_concentrationsValidate nutrient concentrations
validate_parameter_rangesValidate parameter ranges
validate_plot_dataValidate Plot Data Availability
validate_positiveValidate positive values
validate_predator_energy_paramsValidate predator energy density parameters
validate_predator_requirementsValidate predator requirements (special data handling)
validate_range_coreCore range validation with multiple strategies
validate_respiration_requirementsValidate respiration requirements (multiple categories)
validate_species_equationsMain function to validate all species equations
validate_statistical_method_inputsValidate statistical strategy inputs
validate_structure_coreCore data structure validation
validate_temperatureValidate temperature values
validate_temporal_dataValidate temporal data
validate_time_series_dataValidate Time Series Data Structure (Basic Level)
validate_tmb_objectiveValidate TMB objective function
validation_resultCreate standardized validation result
fb4package documentation built on May 8, 2026, 1:07 a.m.