# Bayesian spatial capture-recapture
# https://tidyecology.com/posts/bayesian-spatial-capture-recapture/
#
# The R code of this Tidy Ecology tutorial, chunk by chunk, in the order of the post.
# Run it top to bottom in a fresh R session. Code the post shows but does not run
# is commented out. The prose, and the numbers it quotes, are in the post itself.
# Post last modified: 2026-10-01

## ---- setup ----
library(ggplot2)
paper <- "#f5f4ee"; ink <- "#16241d"; body <- "#2c3a31"; forest <- "#275139"
labelc <- "#46604a"; sage <- "#93a87f"; linec <- "#dad9ca"; faint <- "#5d6b61"
gold <- "#c9b458"; rust <- "#b5534e"
theme_te <- function(base_size = 12) {
  theme_minimal(base_size = base_size) +
    theme(
      plot.background  = element_rect(fill = paper, colour = NA),
      panel.background = element_rect(fill = paper, colour = NA),
      panel.grid.minor = element_blank(),
      panel.grid.major = element_line(colour = linec, linewidth = 0.3),
      axis.title = element_text(colour = body),
      axis.text  = element_text(colour = faint),
      plot.title = element_text(colour = ink, face = "bold"),
      plot.subtitle = element_text(colour = labelc),
      legend.title = element_text(colour = body),
      legend.text  = element_text(colour = body)
    )
}

## ---- simulate ----
set.seed(20260717)
tr    <- seq(1, 7, by = 1)
traps <- as.matrix(expand.grid(x = tr, y = tr)); J <- nrow(traps)
K     <- 6
g0_true <- 0.30; sig_true <- 0.70
buffer  <- 3
xl <- range(traps[, 1]) + c(-buffer, buffer)
yl <- range(traps[, 2]) + c(-buffer, buffer)
A  <- diff(xl) * diff(yl)
N_true <- 72; D_true <- N_true / A

sx <- runif(N_true, xl[1], xl[2]); sy <- runif(N_true, yl[1], yl[2])
d2 <- outer(sx, traps[, 1], "-")^2 + outer(sy, traps[, 2], "-")^2
p  <- g0_true * exp(-d2 / (2 * sig_true^2))
yfull  <- matrix(rbinom(N_true * J, K, p), N_true, J)
caught <- rowSums(yfull) > 0
Y <- yfull[caught, , drop = FALSE]; n <- nrow(Y)
spat_recap <- sum(rowSums(Y > 0) >= 2); tot_det <- sum(Y)

## ---- augment ----
M   <- 150
Yau <- rbind(Y, matrix(0, M - n, J))
z   <- c(rep(1, n), rep(0, M - n))
s   <- matrix(0, M, 2)
for (i in 1:n) { w <- Y[i, ]; s[i, ] <- c(sum(w * traps[, 1]), sum(w * traps[, 2])) / sum(w) }
s[(n + 1):M, 1] <- runif(M - n, xl[1], xl[2])
s[(n + 1):M, 2] <- runif(M - n, yl[1], yl[2])
g0 <- 0.2; sig <- 1.0; psi <- 0.5; sig_max <- 5

pmat <- function(s, g0, sig) {
  d2 <- outer(s[, 1], traps[, 1], "-")^2 + outer(s[, 2], traps[, 2], "-")^2
  g0 * exp(-d2 / (2 * sig^2))
}
ll_ind <- function(P, z) {                         # per-individual log-likelihood
  peff <- z * P
  rowSums(matrix(dbinom(as.vector(Yau), K, as.vector(peff), log = TRUE), M, J))
}

## ---- mcmc ----
set.seed(20260717)
niter <- 8000; burn <- 3000
s_s <- 1.05; s_g0 <- 0.20; s_sig <- 0.07
keepD <- keepN <- keepg0 <- keepsig <- numeric(niter)
acc_s <- acc_g0 <- acc_sig <- 0
smean <- matrix(0, n, 2); nkeep <- 0
track <- c(which.max(rowSums(Y > 0)), order(rowSums(Y > 0))[1],
           which.min(abs(rowSums(Y > 0) - 2)))
track <- unique(track)[1:3]
s_track <- vector("list", length(track))
for (t in seq_along(track)) s_track[[t]] <- matrix(NA, 0, 2)

P <- pmat(s, g0, sig)
for (it in 1:niter) {
  # activity centres: joint Metropolis for all M
  sp  <- s + matrix(rnorm(M * 2, 0, s_s), M, 2)
  inb <- sp[, 1] >= xl[1] & sp[, 1] <= xl[2] & sp[, 2] >= yl[1] & sp[, 2] <= yl[2]
  Pp  <- pmat(sp, g0, sig)
  acc <- inb & (log(runif(M)) < (ll_ind(Pp, z) - ll_ind(P, z)))
  s[acc, ] <- sp[acc, ]; P[acc, ] <- Pp[acc, ]; acc_s <- acc_s + mean(acc)

  # inclusion indicators for augmented animals: Gibbs
  p0 <- exp(rowSums(K * log1p(-P)))
  au <- (n + 1):M
  z[au] <- rbinom(M - n, 1, psi * p0[au] / (psi * p0[au] + (1 - psi)))

  # inclusion probability: conjugate Beta
  Nz  <- sum(z); psi <- rbeta(1, 1 + Nz, 1 + M - Nz)

  # g0: Metropolis on logit scale, Uniform(0,1) prior (Jacobian g0(1-g0))
  lgp <- qlogis(g0) + rnorm(1, 0, s_g0); g0p <- plogis(lgp); Pg <- pmat(s, g0p, sig)
  if (log(runif(1)) < sum(ll_ind(Pg, z)) + log(g0p * (1 - g0p)) -
                       sum(ll_ind(P, z)) - log(g0 * (1 - g0))) {
    g0 <- g0p; P <- Pg; acc_g0 <- acc_g0 + 1
  }
  # sigma: Metropolis on log scale, Uniform(0, sig_max) prior (Jacobian sigma)
  sigp <- exp(log(sig) + rnorm(1, 0, s_sig))
  if (sigp < sig_max) {
    Ps <- pmat(s, g0, sigp)
    if (log(runif(1)) < sum(ll_ind(Ps, z)) + log(sigp) -
                         sum(ll_ind(P, z)) - log(sig)) {
      sig <- sigp; P <- Ps; acc_sig <- acc_sig + 1
    }
  }

  keepN[it] <- Nz; keepD[it] <- Nz / A; keepg0[it] <- g0; keepsig[it] <- sig
  if (it > burn) {
    nkeep <- nkeep + 1; smean <- smean + s[1:n, ]
    for (t in seq_along(track)) s_track[[t]] <- rbind(s_track[[t]], s[track[t], ])
  }
}
smean <- smean / nkeep; idx <- (burn + 1):niter
qD  <- quantile(keepD[idx],  c(.5, .025, .975))
qN  <- quantile(keepN[idx],  c(.5, .025, .975))
qg0 <- quantile(keepg0[idx], c(.5, .025, .975))
qs  <- quantile(keepsig[idx], c(.5, .025, .975))

## ---- fig-post ----
arr_area <- prod(apply(traps, 2, function(z) diff(range(z))))
D_arr    <- n / arr_area
dpost <- data.frame(D = keepD[idx])
p1 <- ggplot(dpost, aes(D)) +
  geom_histogram(bins = 45, fill = forest, colour = paper, linewidth = 0.2) +
  geom_vline(xintercept = D_true, colour = ink, linewidth = 0.8) +
  geom_vline(xintercept = D_arr, colour = rust, linewidth = 0.8, linetype = "dashed") +
  annotate("text", x = D_true, y = Inf, label = "true D", vjust = 1.6, hjust = -0.1,
           colour = ink, size = 3.4) +
  annotate("text", x = D_arr, y = Inf, label = "naive: count / array", vjust = 1.6,
           hjust = 1.1, colour = rust, size = 3.4) +
  labs(x = "density (animals per unit area)", y = "posterior draws",
       title = "Density is an estimable parameter under SCR",
       subtitle = paste0("posterior median ", round(qD[1], 3),
                         ", 95% CrI [", round(qD[2], 3), ", ", round(qD[3], 3), "]")) +
  theme_te()
p1

## ---- fig-centres ----
cols <- c(forest, gold, rust)
cl <- do.call(rbind, lapply(seq_along(track), function(t) {
  ntrap <- rowSums(Y > 0)[track[t]]
  data.frame(x = s_track[[t]][, 1], y = s_track[[t]][, 2],
             id = paste(ntrap, if (ntrap == 1) "trap" else "traps"), k = t)
}))
mn <- do.call(rbind, lapply(seq_along(track), function(t) {
  data.frame(x = mean(s_track[[t]][, 1]), y = mean(s_track[[t]][, 2]), k = t)
}))
lk <- do.call(rbind, lapply(seq_along(track), function(t) {
  js <- which(Y[track[t], ] > 0)
  data.frame(x = mn$x[t], y = mn$y[t], xe = traps[js, 1], ye = traps[js, 2], k = t)
}))
p2 <- ggplot() +
  geom_point(data = as.data.frame(traps), aes(x, y), shape = 3,
             colour = faint, size = 1.8, stroke = 0.5) +
  geom_point(data = cl, aes(x, y, colour = id), alpha = 0.05, size = 0.7) +
  geom_segment(data = lk, aes(x, y, xend = xe, yend = ye, colour = factor(k)),
               linewidth = 0.3, alpha = 0.6, show.legend = FALSE) +
  geom_point(data = cbind(mn, id = cl$id[match(mn$k, cl$k)]),
             aes(x, y, colour = id), size = 2.6) +
  scale_colour_manual(values = setNames(cols, unique(cl$id)),
                      breaks = unique(cl$id), name = "captures") +
  guides(colour = guide_legend(override.aes = list(alpha = 1, size = 2.4))) +
  coord_equal() +
  labs(x = "easting", y = "northing",
       title = "Posterior activity centres",
       subtitle = "more captures, tighter location") +
  theme_te() + theme(legend.position = "top")
p2

## ---- ppc ----
set.seed(99)
obs_sr <- sum(rowSums(Y > 0) >= 2)
gm <- qg0[1]; sm <- qs[1]; Dm <- qD[1]
ppc <- replicate(1000, {
  Nsim <- rpois(1, Dm * A)
  xs <- runif(Nsim, xl[1], xl[2]); ys <- runif(Nsim, yl[1], yl[2])
  d2s <- outer(xs, traps[, 1], "-")^2 + outer(ys, traps[, 2], "-")^2
  ys2 <- matrix(rbinom(Nsim * J, K, gm * exp(-d2s / (2 * sm^2))), Nsim, J)
  cc  <- rowSums(ys2) > 0
  sum(rowSums(ys2[cc, , drop = FALSE] > 0) >= 2)
})
bp <- mean(ppc >= obs_sr)

## ---- thumb ----
ggsave("thumbnail.png", p2 + labs(title = NULL, subtitle = NULL) +
         theme(legend.position = "none"),
       width = 7.5, height = 5.4, dpi = 100, bg = paper)
