Documentation

Copula.ExtremeValue.Archimax

← Copula mathematical handbook

Archimax copulas #

Capéraà, Fougères and Genest (2000) combine an Archimedean generator with a Pickands dependence function. For a bivariate Archimedean generator g (inverse generator ψ = g.toFun, generator φ = g.invFun) and a Pickands function A, the Archimax copula is

C_{ψ,A}(u,v) = ψ(ℓ_A(φ(u), φ(v))) = ψ((φ(u) + φ(v)) A(φ(v) / (φ(u) + φ(v))))

on (0,1]² (zero on the lower edges), where ℓ_A = pickandsTail A is the stable tail dependence function. We use the library's convention for A (that of pickandsCopula, where C_A(u,v) = exp(-ℓ_A(-log u, -log v))); Capéraà–Fougères–Genest write A(φ(u)/(φ(u)+φ(v))), i.e. their A is our t ↦ A(1 - t) (archimaxCopula_comp_one_sub relates the two).

Main results:

References: P. Capéraà, A.-L. Fougères and C. Genest, Bivariate distributions with given extreme value attractor, J. Multivariate Anal. 72 (2000) 30–49; F. Durante and C. Sempi, Principles of Copula Theory (2016), Section 6.6 (Archimax copulas).

The Archimax CDF ψ(ℓ_A(φ(u), φ(v))), zero on the lower edges.

Equations
Instances For
    theorem ProbabilityTheory.Copula.BivariateGenerator.archimaxCDF_mono (g : BivariateGenerator) {A : ℝ → ℝ} (hA : IsPickandsFunction A) {u u' v v' : ↑unitInterval} (hu : u ≤ u') (hv : v ≤ v') :
    g.archimaxCDF A u v ≤ g.archimaxCDF A u' v'
    theorem ProbabilityTheory.Copula.BivariateGenerator.add_le_add_of_submodular (g : BivariateGenerator) {p q r s : ℝ} (hp : 0 ≤ p) (hq : 0 ≤ q) (hpr : p ≤ r) (hps : p ≤ s) (hqrs : q ≤ r + s - p) :
    g.toFun r + g.toFun s ≤ g.toFun p + g.toFun q

    Supermodularity of ψ ∘ ℓ: for a convex nonincreasing ψ on [0,∞), p ≤ r, p ≤ s, 0 ≤ q ≤ r + s - p imply ψ(r) + ψ(s) ≤ ψ(p) + ψ(q).

    theorem ProbabilityTheory.Copula.BivariateGenerator.archimaxCDF_rect (g : BivariateGenerator) {A : ℝ → ℝ} (hA : IsPickandsFunction A) {a b c e : ↑unitInterval} (hab : a ≤ b) (hce : c ≤ e) :
    0 ≤ g.archimaxCDF A b e - g.archimaxCDF A a e - g.archimaxCDF A b c + g.archimaxCDF A a c

    The Archimax copula C_{ψ,A}(u,v) = ψ(ℓ_A(φ(u), φ(v))) of a bivariate Archimedean generator and a Pickands dependence function (Capéraà–Fougères–Genest 2000).

    Equations
    Instances For
      theorem ProbabilityTheory.Copula.BivariateGenerator.cdf_archimaxCopula_eq (g : BivariateGenerator) {A : ℝ → ℝ} (hA : IsPickandsFunction A) {u v : ↑unitInterval} (hu : u ≠ 0) (hv : v ≠ 0) :
      (g.archimaxCopula A hA).cdf ![u, v] = g.toFun ((g.invFun u + g.invFun v) * A (g.invFun v / (g.invFun u + g.invFun v)))

      The Capéraà–Fougères–Genest formula C(u,v) = ψ((φ(u) + φ(v)) A(φ(v) / (φ(u) + φ(v)))) on (0,1]².

      Special cases #

      A ≡ 1 gives the Archimedean copula of the generator.

      ψ = exp(-·) (φ = -log) gives the extreme-value copula C_A.

      A(t) = max(t, 1-t) gives the upper Fréchet bound M, whatever the generator.

      Order #

      A pointwise larger Pickands function gives a pointwise smaller Archimax copula.

      Every Archimax copula dominates the Archimedean copula of its generator.

      The transpose of an Archimax copula is the Archimax copula of t ↦ A(1 - t).

      theorem ProbabilityTheory.Copula.BivariateGenerator.cdf_archimaxCopula_comp_one_sub (g : BivariateGenerator) {A : ℝ → ℝ} (hA : IsPickandsFunction A) {u v : ↑unitInterval} (hu : u ≠ 0) (hv : v ≠ 0) :
      (g.archimaxCopula (fun (t : ℝ) => A (1 - t)) ⋯).cdf ![u, v] = g.toFun ((g.invFun u + g.invFun v) * A (g.invFun u / (g.invFun u + g.invFun v)))

      The Capéraà–Fougères–Genest convention: with A' (t) = A (1 - t), the copula is ψ((φ(u) + φ(v)) A'(φ(u) / (φ(u) + φ(v)))).

      Diagonal, Blomqvist's beta and tail dependence #

      The diagonal section δ(t) = ψ(2A(1/2) φ(t)) for t ≠ 0.

      Blomqvist's beta of an Archimax copula: β = 4ψ(2A(1/2) φ(1/2)) - 1.

      theorem ProbabilityTheory.Copula.BivariateGenerator.hasDerivWithinAt_diagonal_archimaxCopula_one (g : BivariateGenerator) {A : ℝ → ℝ} (hA : IsPickandsFunction A) {m : ℝ} (h : Filter.Tendsto (fun (x : ℝ) => (1 - g.toFun (2 * A (1 / 2) * x)) / (1 - g.toFun x)) (nhdsWithin 0 (Set.Ioi 0)) (nhds m)) :
      HasDerivWithinAt (fun (x : ℝ) => (g.archimaxCopula A hA).diagonal (Set.projIcc 0 1 ⋯ x)) m (Set.Icc 0 1) 1

      The left derivative of the Archimax diagonal at one: if (1 - ψ(κx)) / (1 - ψ(x)) → m as x → 0+ with κ = 2A(1/2), then δ'(1⁻) = m.

      Upper tail dependence of Archimax copulas (Capéraà–Fougères–Genest 2000): λ_U = 2 - lim_{x → 0+} (1 - ψ(2A(1/2) x)) / (1 - ψ(x)) whenever the limit exists.

      theorem ProbabilityTheory.Copula.BivariateGenerator.tendsto_archimaxRatio_of_hasDerivWithinAt (g : BivariateGenerator) {d κ : ℝ} (hd : HasDerivWithinAt g.toFun d (Set.Ici 0) 0) (hd0 : d ≠ 0) (hκ : 0 < κ) :
      Filter.Tendsto (fun (x : ℝ) => (1 - g.toFun (κ * x)) / (1 - g.toFun x)) (nhdsWithin 0 (Set.Ioi 0)) (nhds κ)

      If ψ has a finite nonzero right derivative at 0, then (1 - ψ(κx)) / (1 - ψ(x)) → κ as x → 0+ for every κ > 0.

      Upper tail coefficient λ_U = 2(1 - A(1/2)) of an Archimax copula whose inverse generator has a finite nonzero right derivative at 0 (equivalently φ'(1⁻) ≠ 0; the Archimedean part then has no upper tail dependence and the tail behaviour is that of the extreme-value attractor C_A, Capéraà–Fougères–Genest 2000, Section 4).

      The lower tail ratio along the generator: δ(t) / t = ψ(2A(1/2) φ(t)) / ψ(φ(t)).

      Lower tail dependence of Archimax copulas with a strict generator: λ_L = lim_{x → ∞} ψ(2A(1/2) x) / ψ(x) whenever this limit exists.