DOI: 10.5281/zenodo.10695709
title: Reassessment of French breeding bird population sizes using citizen science and accounting for species detectability

description: Reproducibility data for the manuscript "Reassessment of French breeding bird population sizes using citizen science and accounting for species detectability", it contains data and script for :





The R script 01_HDSfreq_Calibration.R of the developed approach to estimate national breeding bird population size using Hierarchical Distance Sampling (HDS) and the secondary candidate set model selection method (Morin et al., 2020)




The R script 02_pglmm_figures.R for the calibration of the Phylogenetic Generalised Mixed Model (PGLMM) used in the manuscript to compare previous population size estimates to ones modelled using 01_HDSfreq_Calibration.R, while accounting for species phylogenetic relatedness




The R script 03_results_tables.R, used to generate supplementary tables S2.1-3 and S6.1-2.







Column names are highlighted in italics.



Data description

A. BirdPhylo_Burleigh_et_al.tre

A phylogenetic tree from Burleigh et al., 2015. Phylogenetic distances are used as random effect for the PGLMM in script 02_pglmm_figures.R

B. Conservation_status.txt

A .txt file of the conservation status for France (Statut_FR) and Europe (Statut_EU) for the studied species retrieved from (UICN France et al., 2016). Only Statut_FR is used for the table S6.1.

C. FBBS_trends_20122023.txt

A .txt file containing species trend of the French Breeding Bird Survey data from 2012 to 2023.





Species names (English, French) associated with FBBS trend estimated using data collected from 2012 - 2023




Hab_specialization, determined from Julliard et al. 2006 approach




infPrec, supPerc, estimate, se, pval : Species trends over 2012-2023 period in % | lower and upper confidence intervals, mean, standard error and significance



D. PrepData_HDS.RData

A file containing .RData environment required to run 01_HDSfreq_Calibration.R script, it contains :





ATLAS12 : A dataframe with breeding status information from 2012 breeding bird atlas (used to restrict model prediction grid, in regard of 2012 known breeding locations)




ConcordTBL : A concordance table for species names (English, French and scientific notation)




EPOC_ODF : observation dataset, each line corresponds to detected individuals





UUID, Ref, ID_liste, ID, ID_place, Grid_10x10 : Columns used to identify observations, lists, sites, locations, 10x10 grids




ID_species_Biolovision, Nom_espece, english_name, scientific_name : Species ID and names




Date, Day, Month, Year, Julian_date, Obs_hour, Hour_list, Complete_checklist, Commentary, Project_name, Scheme, Observer, List_time, List_diversity, List_abundance : Lists and Observation related effort covariates and metadata




X_Lambert93_m, Y_Lambert93_m : Observation locations in (crs = 2154)




GPS_loc_observer : Logical, TRUE : location of observers corresponds to true GPS information ; FALSE : observer's location approximated as the barycenter of observations




X_barycentre_L93, Y_barycentre_L93 : Observers location in (crs = 2154)




Use_distance_sampling, Observation_distance_m, Distance_bin_logical, Distance_class_0_25, Distance_class_25_100, Distance_class_100_200, Distance_class_200_more : Distance sampling related informations




Abudance_brut, Estimate, Number, Nb_male_identified, Nb_female_identified, Nb_juvenile_identified, Nb_grounded, Nb_flying, Nb_auditory, Nb_NA : Observation metadata, used in case of a priori filter over male detection.






grid_pred_envvar : Prediction grid with environmental covariates, see appendix S3 of the manuscript, covering metropolitan France




grid_pred.sf : corresponding sf object




L93_10x10 : sf object corresponding to 10x10 grid used in 2012 atlas




ObsVar_EPOCODF : dataframe specifying lists effort covariates




OCCU_EPOC_ODF : Environmental covariate agregated over lists




OCCU_EPOC_ODF_sites_envvar : Environmental covariate agregated over sites




table.pheno : species table specifying related phenology filter



E. ReadOutput_HDSfreq_comparison.csv

A .csv table of species population size estimated using 2021-2023 EPOC-ODF data over areas determined as breeding in the 2012 atlas. Predictions were restrained over location known as breeding in 2012 for the sake of comparison.





HDS_estimUnfenced_XXX : average pop. size estimated with confidence interval before prediction post-treatment (describe in fig 2. of the manuscript)




HDS_estim_ExtrapolFence_XXX : average pop. size estimated with confidence interval after prediction post-treatment




NB_data_calib : Number of observations (distance data, not sites) used for calibration




MALE_FILTERING : (logical) indicating if female individuals could be detected in the same proportion of males during list recording. FALSE : we considered that estimated pop.size corresponded to the number of individuals leading to a division by 2 for the comparison with the previous atlas (in pairs). (cf . line 88-90 in 02_pglmm_figures.R)




EcartDTF_filtrage_maleOnly : If MALE_FILTERING == T, proportion of the remaining data used for calibration after removal of list with individual tagged as female/juvenile (in %)




Max_dist_breaks : Maximal distance for detection function, after right-side truncation of 5%




Chat : Coefficient of overdisperion of the best model in the second candidate set




MED_MEAN_Prob_Detect (.._SE) : weighted averaged median of intercept from the availability state from HDS models, weigthed AICc-wise




MED_MEAN_Density : weighted averaged median of intercept from the abundance state from HDS models, weigthed AICc-wise




Significant_phi/lambda : Categorial (Significant/Near/Not), are availability/abundance intercepts significatively different from 0 (significant : alpha = 0.05, near : alpha = 0.1)




KeyFun_used : Key function used for distance sampling




Mixtured_used : Mixture used in the abundance state for HDS



F. ReadOutput_HDSfreq_comparison_20212022.csv

A .csv table of species population size estimated using 2021-2022 EPOC-ODF data over areas determined as breeding in the 2012 atlas. Used for the robustness analysis of HDS estimated population size, see appendix S2 and table S2.2 of the manuscript.

G. ReadOutput_HDSfreq_EstimMetropole.csv

A .csv table of species population size estimated using 2021-2023 EPOC-ODF data over metropolitan France.





HDS_estimUnfenced_XXX : average pop. size estimated with confidence interval before prediction post-treatment (describe in fig 2. of the manuscript)




HDS_estim_ExtrapolFence_XXX : average pop. size estimated with confidence interval after prediction post-treatment




MALE_FILTERING : (logical) indicating if female individuals could be detected in the same proportion of males during list recording. FALSE : we considered that estimated pop.size corresponded to the number of individuals leading to a division by 2 for conversion to pop. size in breeding pairs




Chat : Coefficient of overdisperion of the best model in the second candidate set




KeyFun_used : Key function used for distance sampling




Mixtured_used : Mixture used in the abundance state for HDS



H. TABLE_SpeciesFilters_and_2012Estimates.txt

A .txt table containing species names (English, French and scientific notation), filters and 2012 French atlas pop. size estimates





debut_jour : starting day of the month for phenology filter




debut_mois : starting month for phenology filter




fin_jour : ending day of the month for phenology filter




fin_mois : ending month for phenology filter




Estim_low/up_Atlas2012 : Lower and Upper interval of estimated pop. size in 2012 (number in breeding pairs)




gregarious : logical (0,1) specifying if the species is considered gregarious during its breeding season



I. sessionInfo_script_XX

User R session information, obtained from sessionInfo() R function, used for running R script.

Code

A. 01_HDSfreq_Calibration.R

R script showcasing data formatting and model calibration of the HDS based upon frequentist aproach from unmarked R package. For more details of the model calibration approach, see appendix S4 of the manuscript.

B. 02_pglmm_figures.R

Script for the calibration of the PGLMM and generation of figure 5 of the manuscript.

C. 03_results_tables.R

Script to generate tables depicted in Appendices S2 (S2.1-3) and S6 (S6.1-2)

D. HDS_functions.R

R script called in 01_HDSfreq_Calibration.R, contains 2 functions:





Try_HDS() : Function implementing a try-catch permitting calibration of multiple species in a loop.





Species with non convergent models are skipped sending a notification to the user R interface.




Used in all sub-candidate sets (i.e. "null", "p", "phi", "lambda")




When phase="ALL" corresponding to the second candidate set (i.e. ensemble of best model candidates, with delta_AIC <= 10, from previous sub-candidate sets), it permits the use of previous sub-candidates set coefficients as starting values, with StartValues argument




Later part of the function hack the call of the unmarkedFit class, in order to accommodate from calibrating a gdistsamp using characters formulas






fitstats() : Function from unmarked::parboot(), available with help(parboot). Allow estimation of multiple goodness-of-git statistic (Freeman-Tukey, Chi-squared and Sum of Squared Estimate of errors) through parametric bootstrap. In the manuscript, only chi-squared metric is used.



E. dsmextra_modif_function.R

R script called in 01_HDSfreq_Calibration.R. Miscellaneous adjustment of core function from dsmextra package (main change being the integration of tolerance argument (tol) in the chain of function.

F. misc_unmarked.R

R script called in 01_HDSfreq_Calibration.R. modify Setmethods for unmarked function, in particular for unmarked::parboot, allowing parallelization of parametric bootstrap with prior unmarked version (unmarked < 1.3.0).

References

Data was derived from the following sources:





Burleigh, J.G., Kimball, R.T., Braun, E.L., 2015. Building the avian tree of life using a large-scale, sparse supermatrix. Molecular Phylogenetics and Evolution 84, 53–63. https://doi.org/10.1016/j.ympev.2014.12.003



Other sources :





Julliard, R., Clavel, J., Devictor, V., Jiguet, F., Couvet, D., 2006. Spatial segregation of specialists and generalists in bird communities. Ecology Letters 9, 1237–1244. https://doi.org/10.1111/j.1461-0248.2006.00977.x




Morin, D.J., Yackulic, C.B., Diffendorfer, J.E., Lesmeister, D.B., Nielsen, C.K., Reid, J., Schauber, E.M., 2020. Is your ad hoc model selection strategy affecting your multimodel inference? Ecosphere 11, e02997. https://doi.org/10.1002/ecs2.2997




UICN France, MNHN, LPO, SEOF, ONCFS, 2016. La Liste rouge des espèces menacées en France - Chapitre Oiseaux de France métropolitaine. Paris, France.