Documentation

Copula.ExtremeValue.Pickands

← Copula mathematical handbook

Pickands dependence functions and bivariate extreme-value copulas #

A Pickands dependence function is a convex function A : [0,1] → ℝ with max(t, 1 - t) ≤ A(t) ≤ 1. The associated stable tail dependence function is ℓ_A(x,y) = (x + y) A(y / (x + y)) on [0,∞)², and the Pickands copula is

C_A(u,v) = exp(log(uv) A(log v / log(uv))) = exp(-ℓ_A(-log u, -log v))

for u, v ∈ (0,1], extended by zero on the two lower edges.

Main results:

The converse (every bivariate extreme-value copula is a Pickands copula) is in Copula.ExtremeValue.PickandsConverse.

References: J. Pickands, Multivariate extreme value distributions (1981); G. Gudendorf and J. Segers, Extreme-value copulas, in Copula Theory and Its Applications (2010); H. Joe, Dependence Modeling with Copulas (2014); F. Durante and C. Sempi, Principles of Copula Theory (2016).

A Pickands dependence function: convex on [0,1] with max(t, 1 - t) ≤ A(t) ≤ 1 there. Values outside [0,1] are irrelevant.

Instances For
    noncomputable def ProbabilityTheory.Copula.pickandsTail (A : ℝ → ℝ) (x y : ℝ) :

    The stable tail dependence function ℓ_A(x,y) = (x + y) A(y / (x + y)) of a Pickands function (with ℓ_A(0,0) = 0).

    Equations
    Instances For
      theorem ProbabilityTheory.Copula.pickands_ratio_mem {x y : ℝ} (hx : 0 ≤ x) (hy : 0 ≤ y) :
      y / (x + y) ∈ Set.Icc 0 1

      The reflected function t ↦ A(1 - t) (the Pickands function of the transposed copula).

      theorem ProbabilityTheory.Copula.IsPickandsFunction.eq_max_iff {A : ℝ → ℝ} (hA : IsPickandsFunction A) :
      A (1 / 2) = 1 / 2 ↔ Set.EqOn A (fun (t : ℝ) => max t (1 - t)) (Set.Icc 0 1)

      A Pickands function lies below the chord max(t, 1-t) iff it touches it at 1/2.

      theorem ProbabilityTheory.Copula.pickandsTail_smul (A : ℝ → ℝ) {s : ℝ} (hs : s ≠ 0) (x y : ℝ) :
      pickandsTail A (s * x) (s * y) = s * pickandsTail A x y
      theorem ProbabilityTheory.Copula.pickandsTail_le_add {A : ℝ → ℝ} (hA : IsPickandsFunction A) {x y : ℝ} (hx : 0 ≤ x) (hy : 0 ≤ y) :
      pickandsTail A x y ≤ x + y
      theorem ProbabilityTheory.Copula.max_le_pickandsTail {A : ℝ → ℝ} (hA : IsPickandsFunction A) {x y : ℝ} (hx : 0 ≤ x) (hy : 0 ≤ y) :
      max x y ≤ pickandsTail A x y
      theorem ProbabilityTheory.Copula.pickandsTail_nonneg {A : ℝ → ℝ} (hA : IsPickandsFunction A) {x y : ℝ} (hx : 0 ≤ x) (hy : 0 ≤ y) :
      theorem ProbabilityTheory.Copula.pickandsTail_swap (A : ℝ → ℝ) (x y : ℝ) :
      pickandsTail A x y = pickandsTail (fun (t : ℝ) => A (1 - t)) y x

      The perspective r ↦ ℓ_A(1, r) is convex on [0, ∞).

      theorem ProbabilityTheory.Copula.pickandsTail_one_mono {A : ℝ → ℝ} (hA : IsPickandsFunction A) {r r' : ℝ} (hr : 0 ≤ r) (hrr : r ≤ r') :
      theorem ProbabilityTheory.Copula.pickandsTail_mono_right {A : ℝ → ℝ} (hA : IsPickandsFunction A) {x y y' : ℝ} (hx : 0 ≤ x) (hy : 0 ≤ y) (hyy : y ≤ y') :

      ℓ_A is nondecreasing in its second variable.

      theorem ProbabilityTheory.Copula.pickandsTail_mono_left {A : ℝ → ℝ} (hA : IsPickandsFunction A) {x x' y : ℝ} (hx : 0 ≤ x) (hxx : x ≤ x') (hy : 0 ≤ y) :

      ℓ_A is nondecreasing in its first variable.

      theorem ProbabilityTheory.Copula.pickandsTail_submodular {A : ℝ → ℝ} (hA : IsPickandsFunction A) {x x' y y' : ℝ} (hx : 0 ≤ x) (hxx : x ≤ x') (hy : 0 ≤ y) (hyy : y ≤ y') :

      ℓ_A is submodular on [0,∞)²: for x ≤ x', y ≤ y', ℓ(x,y) + ℓ(x',y') ≤ ℓ(x,y') + ℓ(x',y).

      theorem ProbabilityTheory.Copula.pickandsTail_le_of_le {A B : ℝ → ℝ} (h : ∀ t ∈ Set.Icc 0 1, A t ≤ B t) {x y : ℝ} (hx : 0 ≤ x) (hy : 0 ≤ y) :
      noncomputable def ProbabilityTheory.Copula.pickandsCDF (A : ℝ → ℝ) (u v : ↑unitInterval) :

      The Pickands CDF formula exp(-ℓ_A(-log u, -log v)), zero on the lower edges.

      Equations
      Instances For
        theorem ProbabilityTheory.Copula.pickandsCDF_mono {A : ℝ → ℝ} (hA : IsPickandsFunction A) {u u' v v' : ↑unitInterval} (hu : u ≤ u') (hv : v ≤ v') :
        theorem ProbabilityTheory.Copula.pickandsCDF_rect {A : ℝ → ℝ} (hA : IsPickandsFunction A) {a b c e : ↑unitInterval} (hab : a ≤ b) (hce : c ≤ e) :

        The bivariate extreme-value copula C_A of a Pickands dependence function A.

        Equations
        Instances For
          theorem ProbabilityTheory.Copula.cdf_pickandsCopula_eq_exp {A : ℝ → ℝ} (hA : IsPickandsFunction A) {u v : ↑unitInterval} (hu : u ≠ 0) (hv : v ≠ 0) :
          (pickandsCopula A hA).cdf ![u, v] = Real.exp (Real.log (↑u * ↑v) * A (Real.log ↑v / Real.log (↑u * ↑v)))

          The classical Pickands formula C_A(u,v) = exp(log(uv) A(log v / log(uv))) on (0,1]².

          Pickands copulas are extreme-value copulas (max-stable).

          The point exp(-max(s, 0)) of the unit interval.

          Equations
          Instances For

            Evaluation of C_A on the curve (e^{-(1-t)}, e^{-t}) recovers A.

            The constant Pickands function 1.

            The lower boundary max(t, 1 - t) is a Pickands function.

            theorem ProbabilityTheory.Copula.pickandsTail_max {x y : ℝ} (hx : 0 ≤ x) (hy : 0 ≤ y) :
            pickandsTail (fun (t : ℝ) => max t (1 - t)) x y = max x y

            A = max(t, 1 - t) gives the comonotonicity copula M.

            Every Pickands copula is positively quadrant dependent (A ≤ 1).

            Pointwise order of Pickands functions reverses the pointwise order of copulas.

            A ≤ B on [0,1] if and only if C_B ≤ C_A pointwise.

            A ↦ C_A is injective: two Pickands copulas agree iff the functions agree on [0,1].

            The diagonal of C_A is t ^ (2 A(1/2)).

            The extremal coefficient of C_A is 2 A(1/2).

            C_A = M iff A(1/2) = 1/2 (iff A = max(t, 1-t) on [0,1]).

            C_A = Π iff A ≡ 1 on [0,1].