Module docstring
{"# Inequalities on iterates
In this file we prove some inequalities comparing f^[n] x and g^[n] x where f and g are
two self-maps that commute with each other.
Current selection of inequalities is motivated by formalization of the rotation number of a circle homeomorphism. ","### Comparison of two sequences
If $f$ is a monotone function, then $∀ k, x{k+1} ≤ f(xk)$ implies that $xk$ grows slower than
$f^k(x0)$, and similarly for the reversed inequalities. If $xk$ and $yk$ are two sequences such
that $x{k+1} ≤ f(xk)$ and $y{k+1} ≥ f(yk)$ for all $k < n$, then $x0 ≤ y0$ implies
$xn ≤ yn$, see Monotone.seq_le_seq.
If some of the inequalities in this lemma are strict, then we have $xn < yn$. The rest of the lemmas in this section formalize this fact for different inequalities made strict. ","### Iterates of two functions
In this section we compare the iterates of a monotone function f : α → α to iterates of any
function g : β → β. If h : β → α satisfies h ∘ g ≤ f ∘ h, then h (g^[n] x) grows slower
than f^[n] (h x), and similarly for the reversed inequality.
Then we specialize these two lemmas to the case β = α, h = id.
","### Comparison of iterations and the identity function
If $f(x) ≤ x$ for all $x$ (we express this as f ≤ id in the code), then the same is true for
any iterate of $f$, and similarly for the reversed inequality.
","### Iterates of commuting functions
If f and g are monotone and commute, then f x ≤ g x implies f^[n] x ≤ g^[n] x, see
Function.Commute.iterate_le_of_map_le. We also prove two strict inequality versions of this lemma,
as well as iff versions.
"}