# Load libraries for data processing, modelling, and visualisation
library(tidyverse)
library(openxlsx2)
library(MASS)
library(corrplot)
library(DT)
library(climwin)
library(jtools)
library(DHARMa)
library(lavaan)
library(DiagrammeR)
library(lmtest)
library(glmmTMB)
library(scales)

1 Load and Process Data

# Load daily extreme weather event (EWE) data
extreme_weather <- wb_to_df("Breeding_colony_ewes/Bull_ewes.xlsx") %>%
                   dplyr::mutate(across(4:20, ~ ifelse(is.na(.), 0, .)))  
                   

# Create binary version: 1 = event occurred, 0 = no event, NA = missing
extreme_weather_binary <- extreme_weather %>%
                          dplyr::mutate(across(4:20, ~ ifelse(!is.na(.) & . != 0, 1, ifelse(is.na(.), NA, 0))))


# Note:
# Missing values in extreme weather data are replaced with zero. This is critical because the slidingwin method ("method1" and "method2") internally calculates means when NA values are present, which is not suitable when assessing extreme values. We are specifically interested in whether an extreme event occurred, not in average conditions.
# A small number of missing values are present in the dataset, and replacing them with zero ensures consistency without introducing bias in this context.


# Load breeding data
breeding_data <- wb_to_df("Breeding_data/AUFS.xlsx", sheet = "Bull_Rock") %>%
                 dplyr::filter(!is.na(pup))  # Remove seasons without productivity data


# Record sample size
sample_size <- nrow(breeding_data)


# Assess normality of response variable
# If p > 0.05, the data does not significantly deviate from normality.
shapiro.test(breeding_data$pup)
## 
##  Shapiro-Wilk normality test
## 
## data:  breeding_data$pup
## W = 0.86475, p-value = 0.04452
# Histogram with density curve
hist(breeding_data$pup,
     main = "Histogram of Pup Count",
     xlab = "Pup Count",
     col = "#a6d6fa",
     border = "white",
     prob = TRUE  
)

# Overlay kernel density estimate
lines(density(breeding_data$pup, na.rm = TRUE), col = "#0D92F4", lwd = 2)

# Q-Q plot
ggplot(breeding_data, aes(sample = pup)) +
  stat_qq() +
  stat_qq_line(colour = "red") +
  labs(title = "Q-Q Plot of Pup count",
       x = "Theoretical Quantiles",
       y = "Sample Quantiles") +
  theme_classic()

# Calculate mean and variance
mean(breeding_data$pup)
## [1] 37.84615
var(breeding_data$pup)
## [1] 260.4744

The Shapiro–Wilk test did not indicate a significant deviation from normality (W = 0.86475, p = 0.04452); therefore, we reject the null hypothesis that the data are normally distributed. Visual assessments, including the histogram and Q–Q plot, also support the assumption that the data does not approximate a normal distribution.

Furthermore, the mean (37.84615) and variance (260.4744) differ substantially, indicating overdispersion and suggesting that a Poisson distribution—where the mean and variance are expected to be equal—is not appropriate for this dataset. Therefore, we will use a Negative Binomial distribution to model the data.

2 Sliding window analysis

2.1 Actual above threshold values

# Run the sliding window analysis using actual (non-binary) values
output1 <- slidingwin(xvar = list(warm_day                 = extreme_weather$warm_day,
                                  warm_night               = extreme_weather$warm_night,
                                  heatwave                 = extreme_weather$heatwave,
                                  cool_day                 = extreme_weather$cool_day,
                                  cool_night               = extreme_weather$cool_night,
                                  coldwave                 = extreme_weather$coldwave,
                                  wet_day                  = extreme_weather$wet_day,
                                  heavy_rain_day           = extreme_weather$heavy_rain_day,
                                  very_heavy_rain_day      = extreme_weather$very_heavy_rain_day,
                                  ewdp                     = extreme_weather$ewdp,
                                  vwdp                     = extreme_weather$vwdp,
                                  extreme_wind_day         = extreme_weather$extreme_wind_day,
                                  extreme_wave_energy_day  = extreme_weather$extreme_wave_energy_day,
                                  extreme_wbt_day          = extreme_weather$extreme_wbt_day,
                                  extreme_wbgt_day         = extreme_weather$extreme_wbgt_day,
                                  extreme_at_day           = extreme_weather$extreme_at_day,
                                  extreme_wind_chill_day   = extreme_weather$extreme_wind_chill_day),
                      cdate     = extreme_weather$date,                       # Daily climate record dates
                      bdate     = breeding_data$date,                         # Biological event dates (pup count dates)
                      baseline  = glm.nb(pup ~ 1,
                                         link = "log",
                                         data = breeding_data),               # Baseline model: Negative Binomial
                      cohort    = breeding_data$season,                       # Group by season
                      refday    = c(21, 01),                                  # Last day of monitoring across the seasons
                      cinterval = "day",                                      # Daily resolution
                      range     = c(87, 0),                                   # Test all possible windows within the range
                      type      = "absolute",                                 # Absolute to each biological event date
                      stat      = "sum",                                      # Sum of EWE values over the window
                      func      = "lin"                                       # Test linear relationships
                      )

2.2 Binary above threshold values

# Run the sliding window analysis using binary event indicators
output2 <- slidingwin(xvar = list(warm_day_bi                 = extreme_weather_binary$warm_day,
                                  warm_night_bi               = extreme_weather_binary$warm_night,
                                  heatwave_bi                 = extreme_weather_binary$heatwave,
                                  cool_day_bi                 = extreme_weather_binary$cool_day,
                                  cool_night_bi               = extreme_weather_binary$cool_night,
                                  codlwave_bi                 = extreme_weather_binary$coldwave,
                                  wet_day_bi                  = extreme_weather_binary$wet_day,
                                  heavy_rain_day_bi           = extreme_weather_binary$heavy_rain_day,
                                  very_heavy_rain_day_bi      = extreme_weather_binary$very_heavy_rain_day,
                                  ewdp_bi                     = extreme_weather_binary$ewdp,
                                  vwdp_bi                     = extreme_weather_binary$vwdp,
                                  extreme_wind_day_bi         = extreme_weather_binary$extreme_wind_day,
                                  extreme_wave_energy_day_bi  = extreme_weather_binary$extreme_wave_energy_day,
                                  extreme_wbt_day_bi          = extreme_weather_binary$extreme_wbt_day,
                                  extreme_wbgt_day_bi         = extreme_weather_binary$extreme_wbgt_day,
                                  extreme_at_day_bi           = extreme_weather_binary$extreme_at_day,
                                  extreme_wind_chill_day_bi   = extreme_weather_binary$extreme_wind_chill_day),
                      cdate     = extreme_weather_binary$date,                # Daily climate record dates
                      bdate     = breeding_data$date,                         # Biological event dates (pup count dates)
                      baseline  = glm.nb(pup ~ 1,
                                         link = "log",
                                         data = breeding_data),               # Baseline model: Negative Binomial
                      cohort    = breeding_data$season,                       # Group by season
                      refday    = c(21, 01),                                  # Last day of monitoring across the seasons
                      cinterval = "day",                                      # Daily resolution
                      range     = c(87, 0),                                   # Test all possible windows within the range
                      type      = "absolute",                                 # Absolute to each biological event date
                      stat      = "sum",                                      # Sum of EWE values over the window
                      func      = "lin"                                       # Test linear relationships
                      )

2.3 Wave direction

# Calculate the circular mean of directional data (in degrees)
# This function returns the mean direction of angular values (e.g. wave or wind direction), accounting for circularity (i.e. wrap-around at 360°).
circ_mean <- function(x) {
  # Convert degrees to radians
  radians <- x * pi / 180
  
  # Compute mean sine and cosine
  mean_sin <- mean(sin(radians), na.rm = TRUE)
  mean_cos <- mean(cos(radians), na.rm = TRUE)
  
  # Calculate circular mean in radians and convert back to degrees
  mean_angle <- atan2(mean_sin, mean_cos) * 180 / pi
  
  # Ensure result is within 0–360 degrees
  if (mean_angle < 0) mean_angle + 360 else mean_angle
}


# Run the sliding window analysis with daily mean wave direction data
output3 <- slidingwin(xvar      = list(wave_direction = extreme_weather$wave_direction),
                      cdate     = extreme_weather$date,                       # Daily climate record dates
                      bdate     = breeding_data$date,                         # Biological event dates (pup count dates)
                      baseline  = glm.nb(pup ~ 1,
                                         link = "log",
                                         data = breeding_data),               # Baseline model: Negative Binomial
                      cohort    = breeding_data$season,                       # Group by season
                      refday    = c(21, 01),                                  # Last day of monitoring across the seasons
                      cinterval = "day",                                      # Daily resolution
                      range     = c(87, 0),                                   # Test all possible windows within the range
                      type      = "absolute",                                 # Absolute to each biological event date
                      stat      = "circ_mean",                                # Circular mean of daily wave direction values over the window
                      func      = c("lin", "quad")                            # Test linear and quadratic relationships
                      )
                

# Examine the tested combinations
datatable(output3$combos %>% 
          dplyr::mutate(WindowDuration = WindowOpen - WindowClose + 1),
          options = list(pageLength = 10, orderClasses = TRUE)
          )

2.4 Merge the results

# Combine output from actual and binary sliding window analyses
output <- merge_results(output1, output2)


# View merged model combinations with calculated window duration
datatable(output$combos %>% 
          dplyr::mutate(WindowDuration = WindowOpen - WindowClose + 1),
          options = list(pageLength = 10, orderClasses = TRUE))

2.5 Check best model for each variable

Before running the randomisation process, we need to identify the best-performing model for each extreme weather variable. This ensures that we are testing the most likely biologically relevant window against random expectation.

What we are doing here: For each weather variable (e.g., heavy rain, wet days), we extract the model with:

The lowest AIC value, and

A window duration longer than 14 days, to focus on ecologically meaningful timeframes.

These best models represent the strongest climate–breeding success relationships, and will be used for the randomisation test to assess whether the relationship is likely to have occurred by chance.

2.5.1 Cool night

# Summary of the best model
summary(output[[5]]$BestModel)
## 
## Call:
## glm.nb(formula = yvar ~ climate, data = modeldat, init.theta = 17.81306978, 
##     link = "log")
## 
## Coefficients:
##             Estimate Std. Error z value Pr(>|z|)    
## (Intercept)  3.11338    0.17555   17.73  < 2e-16 ***
## climate     -0.08085    0.02503   -3.23  0.00124 ** 
## ---
## Signif. codes:  0 '***' 0.001 '**' 0.01 '*' 0.05 '.' 0.1 ' ' 1
## 
## (Dispersion parameter for Negative Binomial(17.8131) family taken to be 1)
## 
##     Null deviance: 25.502  on 12  degrees of freedom
## Residual deviance: 13.818  on 11  degrees of freedom
## AIC: 104.34
## 
## Number of Fisher Scoring iterations: 1
## 
## 
##               Theta:  17.8 
##           Std. Err.:  11.0 
## 
##  2 x log-likelihood:  -98.338
# Calculate the median window from models within 95% confidence interval of the best model
medwin(output[[5]]$Dataset)
## $`Median Window Open`
## [1] 64
## 
## $`Median Window Close`
## [1] 27
# Randomisation test to assess if the detected signal is likely by chance
cool_night_randwin <- randwin(repeats   = 10,
                              window    = "sliding",
                              xvar      = list(cool_night = extreme_weather$cool_night),
                              cdate     = extreme_weather$date,
                              bdate     = breeding_data$date,
                              baseline  = glm.nb(pup ~ 1,
                                                 link = "log",
                                                  data = breeding_data),
                              cohort    = breeding_data$season,
                              cinterval = "day",
                              refday    = c(21, 01),
                              range     = c(87, 0),
                              type      = "absolute",
                              stat      = c("sum"),
                              func      = c("lin")
                              )
# Calculate the p-value using Climwin Metric C
climwin::pvalue(dataset     = output[[5]]$Dataset,
                datasetrand = cool_night_randwin[[1]],
                metric      = "C",
                sample.size = sample_size
                )
## [1] 0.5828375
# Plot sliding window and randomisation result
climwin::plotall(dataset        = output[[5]]$Dataset,
                 datasetrand    = cool_night_randwin[[1]],
                 bestmodel      = output[[5]]$BestModel,
                 bestmodeldata  = output[[5]]$BestModelData,
                 arrow          = TRUE
                 )

2.5.2 Extreme wave energy

# Summary of the best model
summary(output[[13]]$BestModel)
## 
## Call:
## glm.nb(formula = yvar ~ climate, data = modeldat, init.theta = 26.731882, 
##     link = "log")
## 
## Coefficients:
##              Estimate Std. Error z value Pr(>|z|)    
## (Intercept)  3.918333   0.095077  41.212  < 2e-16 ***
## climate     -0.024756   0.005497  -4.504 6.68e-06 ***
## ---
## Signif. codes:  0 '***' 0.001 '**' 0.01 '*' 0.05 '.' 0.1 ' ' 1
## 
## (Dispersion parameter for Negative Binomial(26.7319) family taken to be 1)
## 
##     Null deviance: 32.786  on 12  degrees of freedom
## Residual deviance: 11.758  on 11  degrees of freedom
## AIC: 99.023
## 
## Number of Fisher Scoring iterations: 1
## 
## 
##               Theta:  26.7 
##           Std. Err.:  16.7 
## 
##  2 x log-likelihood:  -93.023
# Calculate the median window from models within 95% confidence interval of the best model
medwin(output[[13]]$Dataset)
## $`Median Window Open`
## [1] 59
## 
## $`Median Window Close`
## [1] 34
# Randomisation test to assess if the detected signal is likely by chance
extreme_wave_energy_randwin <- randwin(repeats   = 10,
                                       window    = "sliding",
                                       xvar      = list(extreme_wave_energy_day = extreme_weather$extreme_wave_energy_day),
                                       cdate     = extreme_weather$date,
                                       bdate     = breeding_data$date,
                                       baseline  = glm.nb(pup ~ 1,
                                                          link = "log",
                                                          data = breeding_data),
                                       cohort    = breeding_data$season,
                                       cinterval = "day",
                                       refday    = c(21, 01),
                                       range     = c(87, 0),
                                       type      = "absolute",
                                       stat      = c("sum"),
                                       func      = c("lin")
                                       )
# Calculate the p-value using Climwin Metric C
climwin::pvalue(dataset     = output[[13]]$Dataset,
                datasetrand = extreme_wave_energy_randwin[[1]],
                metric      = "C",
                sample.size = sample_size
                )
## [1] 0.2303757
# Plot sliding window and randomisation result
climwin::plotall(dataset        = output[[13]]$Dataset,
                 datasetrand    = extreme_wave_energy_randwin[[1]],
                 bestmodel      = output[[13]]$BestModel,
                 bestmodeldata  = output[[13]]$BestModelData,
                 arrow          = TRUE
                 )

2.5.3 Heavy rain

# Summary of the best model
summary(output[[8]]$BestModel)
## 
## Call:
## glm.nb(formula = yvar ~ climate, data = modeldat, init.theta = 21.78521652, 
##     link = "log")
## 
## Coefficients:
##              Estimate Std. Error z value Pr(>|z|)    
## (Intercept)  3.998950   0.123506  32.379  < 2e-16 ***
## climate     -0.017268   0.004471  -3.862 0.000113 ***
## ---
## Signif. codes:  0 '***' 0.001 '**' 0.01 '*' 0.05 '.' 0.1 ' ' 1
## 
## (Dispersion parameter for Negative Binomial(21.7852) family taken to be 1)
## 
##     Null deviance: 29.020  on 12  degrees of freedom
## Residual deviance: 13.528  on 11  degrees of freedom
## AIC: 102.37
## 
## Number of Fisher Scoring iterations: 1
## 
## 
##               Theta:  21.8 
##           Std. Err.:  14.0 
## 
##  2 x log-likelihood:  -96.371
# Calculate the median window from models within 95% confidence interval of the best model
medwin(output[[8]]$Dataset)
## $`Median Window Open`
## [1] 60
## 
## $`Median Window Close`
## [1] 20
# Randomisation test to assess if the detected signal is likely by chance
heavy_rain_randwin <- randwin(repeats   = 10,
                              window    = "sliding",
                              xvar      = list(heavy_rain_day = extreme_weather$heavy_rain_day),
                              cdate     = extreme_weather$date,
                              bdate     = breeding_data$date,
                              baseline  = glm.nb(pup ~ 1,
                                                 link = "log",
                                                  data = breeding_data),
                              cohort    = breeding_data$season,
                              cinterval = "day",
                              refday    = c(21, 01),
                              range     = c(87, 0),
                              type      = "absolute",
                              stat      = c("sum"),
                              func      = c("lin")
                              )
# Calculate the p-value using Climwin Metric C
climwin::pvalue(dataset     = output[[8]]$Dataset,
                datasetrand = heavy_rain_randwin[[1]],
                metric      = "C",
                sample.size = sample_size
                )
## [1] 0.4644487
# Plot sliding window and randomisation result
climwin::plotall(dataset        = output[[8]]$Dataset,
                 datasetrand    = heavy_rain_randwin[[1]],
                 bestmodel      = output[[8]]$BestModel,
                 bestmodeldata  = output[[8]]$BestModelData,
                 arrow          = TRUE
                 )

2.5.4 VWDP

# Summary of the best model
summary(output[[28]]$BestModel)
## 
## Call:
## glm.nb(formula = yvar ~ climate, data = modeldat, init.theta = 104.7080703, 
##     link = "log")
## 
## Coefficients:
##             Estimate Std. Error z value Pr(>|z|)    
## (Intercept)  4.12664    0.09048  45.609  < 2e-16 ***
## climate     -0.34244    0.05367  -6.381 1.76e-10 ***
## ---
## Signif. codes:  0 '***' 0.001 '**' 0.01 '*' 0.05 '.' 0.1 ' ' 1
## 
## (Dispersion parameter for Negative Binomial(104.7081) family taken to be 1)
## 
##     Null deviance: 57.690  on 12  degrees of freedom
## Residual deviance: 14.899  on 11  degrees of freedom
## AIC: 94.947
## 
## Number of Fisher Scoring iterations: 1
## 
## 
##               Theta:  105 
##           Std. Err.:  174 
## 
##  2 x log-likelihood:  -88.947
# Calculate the median window from models within 95% confidence interval of the best model
medwin(output[[28]]$Dataset)
## $`Median Window Open`
## [1] 48
## 
## $`Median Window Close`
## [1] 10
# Randomisation test to assess if the detected signal is likely by chance
vwdp_randwin <- randwin(repeats   = 10,
                        window    = "sliding",
                        xvar      = list(vwdp_bi = extreme_weather_binary$vwdp),
                        cdate     = extreme_weather_binary$date,
                        bdate     = breeding_data$date,
                        baseline  = glm.nb(pup ~ 1,
                                           link = "log",
                                           data = breeding_data),
                        cohort    = breeding_data$season,
                        cinterval = "day",
                        refday    = c(21, 01),
                        range     = c(87, 0),
                        type      = "absolute",
                        stat      = c("sum"),
                        func      = c("lin")
                        )           
# Calculate the p-value using Climwin Metric C
climwin::pvalue(dataset     = output[[28]]$Dataset,
                datasetrand = vwdp_randwin[[1]],
                metric      = "C",
                sample.size = sample_size
                )
## [1] 0.05728878
# Plot sliding window and randomisation result
climwin::plotall(dataset        = output[[28]]$Dataset,
                 datasetrand    = vwdp_randwin[[1]],
                 bestmodel      = output[[28]]$BestModel,
                 bestmodeldata  = output[[28]]$BestModelData,
                 arrow          = TRUE
                 )

2.5.5 Warm day

# Summary of the best model
summary(output[[1]]$BestModel)
## 
## Call:
## glm.nb(formula = yvar ~ climate, data = modeldat, init.theta = 37.57000985, 
##     link = "log")
## 
## Coefficients:
##             Estimate Std. Error z value Pr(>|z|)    
## (Intercept) 3.082946   0.125752  24.516  < 2e-16 ***
## climate     0.013422   0.002627   5.109 3.24e-07 ***
## ---
## Signif. codes:  0 '***' 0.001 '**' 0.01 '*' 0.05 '.' 0.1 ' ' 1
## 
## (Dispersion parameter for Negative Binomial(37.57) family taken to be 1)
## 
##     Null deviance: 39.301  on 12  degrees of freedom
## Residual deviance: 12.925  on 11  degrees of freedom
## AIC: 97.859
## 
## Number of Fisher Scoring iterations: 1
## 
## 
##               Theta:  37.6 
##           Std. Err.:  29.3 
## 
##  2 x log-likelihood:  -91.859
# Calculate the median window from models within 95% confidence interval of the best model
medwin(output[[1]]$Dataset)
## $`Median Window Open`
## [1] 69
## 
## $`Median Window Close`
## [1] 29
# Randomisation test to assess if the detected signal is likely by chance
warm_day_randwin <- randwin(repeats   = 10,
                            window    = "sliding",
                            xvar      = list(warm_day = extreme_weather$warm_day),
                            cdate     = extreme_weather$date,
                            bdate     = breeding_data$date,
                            baseline  = glm.nb(pup ~ 1,
                                               link = "log",
                                                data = breeding_data),
                            cohort    = breeding_data$season,
                            cinterval = "day",
                            refday    = c(21, 01),
                            range     = c(87, 0),
                            type      = "absolute",
                            stat      = c("sum"),
                            func      = c("lin")
                            )           
# Calculate the p-value using Climwin Metric C
climwin::pvalue(dataset     = output[[1]]$Dataset,
                datasetrand = warm_day_randwin[[1]],
                metric      = "C",
                sample.size = sample_size
                )
## [1] 0.5059229
# Plot sliding window and randomisation result
climwin::plotall(dataset        = output[[1]]$Dataset,
                 datasetrand    = warm_day_randwin[[1]],
                 bestmodel      = output[[1]]$BestModel,
                 bestmodeldata  = output[[1]]$BestModelData,
                 arrow          = TRUE
                 )