diff --git a/inequality.md b/inequality.md
new file mode 100644
index 0000000..d70f9f2
--- /dev/null
+++ b/inequality.md
@@ -0,0 +1,1091 @@
+---
+jupytext:
+  text_representation:
+    extension: .md
+    format_name: myst
+    format_version: 0.13
+    jupytext_version: 1.16.1
+kernelspec:
+  display_name: Python 3 (ipykernel)
+  language: python
+  name: python3
+---
+
+# 收入与财富不平等
+
+## 概览
+
+在{doc}`long_run_growth` 中，我们研究了在某些国家和地区，人均国内生产总值是如何变化的。
+
+人均 GDP 很重要，我们能通过这一经济指标了解到某个特定国家的家庭平均收入。
+
+然而，当我们研究收入和财富问题时，平均数只是其中的一个方面。
+
+```{prf:example}
+:label: ie_ex_av
+
+例如，假设有两个社会，每个社会都有 100 万人，其中
+
+* 在第一个社会中，一个人的年收入是 $100,000,000，其他人的年收入为零。
+
+* 在第二个社会中，每个人的年收入都是 100 美元
+
+这些国家的人均收入相同（平均收入为 100 美元），但人民的生活却大不相同（例如，在第一个社会中，几乎每个人都在挨饿，尽管有一个人非常富有）。
+```
+
+上面的例子表明，我们在研究收入和财富问题时，不应该仅仅局限于简单的平均数。
+
+这就引出了经济不平等的话题，即研究收入和财富（以及其他资源的数量）如何在人口中分配的话题。
+
+在本讲座中，我们将研究不平等问题，首先探讨不平等的衡量标准，然后将其应用于美国和其他国家的财富和收入数据。
+
+
+### 一些历史
+
+许多历史学家认为，在罗马共和国衰落这一历史事件中，不平等这一问题起到了重要作用（参见{cite}`levitt2019did`等）。
+
+罗马打败了迦太基，并入侵了西班牙，在这之后，资金从帝国各地流入罗马，掌权者变得极为富有。
+
+但与此同时，普通公民却从农业生产中被抽调出来，进行长期作战，这使得他们的财富不断减少。
+
+由此导致的持续加剧的不平等成为罗马共和国政治动荡背后的重要驱动因素，深深地动摇了共和国的根基。
+
+最终，罗马共和国让位于一系列独裁政权 -- 从公元前 27 年的[屋大维](https://en.wikipedia.org/wiki/Augustus)（奥古斯都）开始。
+
+这段历史告诉我们，不平等问题很关键，它可以推动世界的重大事件发生。
+
+当然还有其他原因使得不平等问题很关键，比如它如何影响人类福祉。
+
+基于这些原因，我们开始思考什么是不平等，以及如何量化和分析不平等。
+
+
+### 测量
+
+在政界和大众媒体中，“不平等 ”一词的使用往往相当宽泛，没有任何确切的定义。
+
+我们必须从严谨的定义出发，从科学的角度来看待不平等这一话题。
+
+因此，我们首先讨论经济研究中衡量不平等的方法。
+
+我们需要安装以下的Python包
+
+```{code-cell} ipython3
+:tags: [hide-output]
+
+!pip install wbgapi plotly
+```
+
+我们还将使用以下导入。
+
+```{code-cell} ipython3
+import pandas as pd
+import numpy as np
+import matplotlib.pyplot as plt
+import random as rd
+import wbgapi as wb
+import plotly.express as px
+
+import matplotlib as mpl
+FONTPATH = "fonts/SourceHanSerifSC-SemiBold.otf"
+mpl.font_manager.fontManager.addfont(FONTPATH)
+plt.rcParams['font.family'] = ['Source Han Serif SC']
+```
+
+## 洛伦兹曲线
+
+洛伦兹曲线是衡量不平等的一个常用指标。
+
+在本节中，我们将讨论洛伦兹曲线的定义和性质。
+
+
+### 定义
+
+洛伦兹曲线选取一个样本 $w_1，\ldots，w_n$，并生成一条曲线 $L$。
+
+我们假设样本从小到大排序。
+
+为了便于解释，假设样本衡量的是财富 
+
+* $w_1$ 是人口中最贫穷成员的财富，而
+* $w_n$ 是人口中最富有成员的财富。
+
+曲线 $L$ 就是我们可以绘制和解释的函数 $y = L(x)$。
+
+要绘制这条曲线，我们首先要根据以下公式生成数据点 $(x_i，y_i)$
+
+```{prf:definition}
+:label: define-lorenz
+
+$$
+x_i = \frac{i}{n},
+\qquad
+y_i = \frac{\sum_{j \leq i} w_j}{\sum_{j \leq n} w_j},
+\qquad i = 1, \ldots, n
+$$
+```
+
+现在，根据这些数据点，我们用插值法绘制得到洛伦兹曲线 $L$。
+
+如果我们使用 `matplotlib` 中的线形图，它将自动帮我们完成插值。
+
+洛伦兹曲线 $y = L(x)$ 的含义是，最底层的 $(100 \times x$ \% 的人拥有$（100 \times y）$\% 的财富。
+
+* 如果 $x=0.5$，$y=0.1$，那么最底层的 50%人口拥有 10%的财富。
+
+在上面的讨论中，我们重点讨论了财富，但同样的观点也适用于收入、消费等。
+
+
+### 洛伦兹曲线的模拟数据
+
+让我们来看一些例子，并加强理解。
+
+首先，让我们构建一个可以在下面模拟中使用的 `lorenz_curve` 函数。
+
+构造这样一个函数很有用，因为它能将收入或财富数据的数组转换为个人（或家庭）的累积份额和收入（或财富）的累积份额。
+
+```{code-cell} ipython3
+def lorenz_curve(y):
+    """
+    计算洛伦兹曲线，这是收入或财富分配的图形表示。
+
+    它返回人口累积份额（x轴）和赚取的收入的累积份额。
+
+    参数
+    ----------
+    y : array_like(float or int, ndim=1)
+        每个个体的收入/财富数组。
+        无序或有序皆可。
+
+    返回值
+    -------
+    cum_people : array_like(float, ndim=1)
+        每个人的人口累积份额指数（i/n）
+    cum_income : array_like(float, ndim=1)
+        每个人的收入累积份额指数
+
+
+    参考文献
+    ----------
+    .. [1] https://en.wikipedia.org/wiki/Lorenz_curve
+
+    示例
+    --------
+    >>> a_val, n = 3, 10_000
+    >>> y = np.random.pareto(a_val, size=n)
+    >>> f_vals, l_vals = lorenz(y)
+
+    """
+
+    n = len(y)
+    y = np.sort(y)
+    s = np.zeros(n + 1)
+    s[1:] = np.cumsum(y)
+    cum_people = np.zeros(n + 1)
+    cum_income = np.zeros(n + 1)
+    for i in range(1, n + 1):
+        cum_people[i] = i / n
+        cum_income[i] = s[i] / s[n]
+    return cum_people, cum_income
+```
+
+在下图中，我们从对数正态分布中生成了 $n=2000$ 个样本，并将这些样本视为我们的总体。
+
+其中45 度线（$x=L(x)$ 对于所有 $x$）对应于完全平等的情况。
+
+对数正态分布的样本产生了一个不那么平等的分布。
+
+例如，如果我们将这些样本看作是家庭财富的观测值，那么虚线表明，底层 80\% 的家庭仅拥有总财富的 40\% 多一点。
+
+```{code-cell} ipython3
+---
+mystnb:
+  figure:
+    caption: "\u6A21\u62DF\u8D22\u5BCC\u6570\u636E\u7684\u6D1B\u4F26\u5179\u66F2\u7EBF"
+    name: lorenz_simulated
+---
+n = 2000
+sample = np.exp(np.random.randn(n))
+
+fig, ax = plt.subplots()
+
+f_vals, l_vals = lorenz_curve(sample)
+ax.plot(f_vals, l_vals, label='对数正态样本', lw=2)
+ax.plot(f_vals, f_vals, label='平等', lw=2)
+
+ax.vlines([0.8], [0.0], [0.43], alpha=0.5, colors='k', ls='--')
+ax.hlines([0.43], [0], [0.8], alpha=0.5, colors='k', ls='--')
+ax.set_xlim((0, 1))
+ax.set_xlabel("家庭份额")
+ax.set_ylim((0, 1))
+ax.set_ylabel("财富份额")
+ax.legend()
+plt.show()
+```
+
+### 洛伦兹曲线（美国数据）
+
+接下来，我们来看一看美国的收入数据和财富数据。
+
+(data:survey-consumer-finance)=
+下面的代码导入了2016年的`SCF_plus`数据集的一个子集，
+该数据集来源于[消费者财务调查](https://en.wikipedia.org/wiki/Survey_of_Consumer_Finances)（SCF）。
+
+```{code-cell} ipython3
+url = 'https://github.com/QuantEcon/high_dim_data/raw/main/SCF_plus/SCF_plus_mini.csv'
+df = pd.read_csv(url)
+df_income_wealth = df.dropna()
+```
+
+```{code-cell} ipython3
+df_income_wealth.head(n=5)
+```
+
+接下来的代码使用存储在数据框 `df_income_wealth` 中的数据来生成洛伦兹曲线。
+
+（代码稍微复杂一些，因为我们需要根据 SCF 提供的人口权重来调整数据。）
+
+```{code-cell} ipython3
+:tags: [hide-input]
+
+df = df_income_wealth 
+
+varlist = ['n_wealth',    # 净财富
+           't_income',    # 总收入
+           'l_income']    # 劳动收入
+
+years = df.year.unique()
+
+# 创建列表储存洛伦兹曲线数据
+
+F_vals, L_vals = [], []
+
+for var in varlist:
+    # 创建列表储存洛伦兹曲线数据
+    f_vals = []
+    l_vals = []
+    for year in years:
+
+        # 根据他们的权重来重复这些观测值
+        counts = list(round(df[df['year'] == year]['weights'] )) 
+        y = df[df['year'] == year][var].repeat(counts)
+        y = np.asarray(y)
+        
+        # 打乱y的序列来改善图形形状
+        rd.shuffle(y)    
+               
+        # 计算并储存洛伦兹曲线数据
+        f_val, l_val = lorenz_curve(y)
+        f_vals.append(f_val)
+        l_vals.append(l_val)
+        
+    F_vals.append(f_vals)
+    L_vals.append(l_vals)
+
+f_vals_nw, f_vals_ti, f_vals_li = F_vals
+l_vals_nw, l_vals_ti, l_vals_li = L_vals
+```
+
+现在我们绘制2016年美国的净财富、总收入和劳动收入的洛伦兹曲线。
+
+总收入是家庭所有收入来源的总和，包括劳动收入但不包括资本收益。
+
+(所有收入均用税前收入衡量。)
+
+```{code-cell} ipython3
+---
+mystnb:
+  figure:
+    caption: "2016\u5E74\u7F8E\u56FD\u6D1B\u4F26\u5179\u66F2\u7EBF"
+    name: lorenz_us
+  image:
+    alt: lorenz_us
+---
+fig, ax = plt.subplots()
+ax.plot(f_vals_nw[-1], l_vals_nw[-1], label=f'净财富')
+ax.plot(f_vals_ti[-1], l_vals_ti[-1], label=f'总收入')
+ax.plot(f_vals_li[-1], l_vals_li[-1], label=f'劳动收入')
+ax.plot(f_vals_nw[-1], f_vals_nw[-1], label=f'平等')
+ax.set_xlabel("家庭份额")
+ax.set_ylabel("收入/财富份额")
+ax.legend()
+plt.show()
+```
+
+从图中可以得到一个关键发现，财富不平等比收入不平等更为极端。
+
+## 基尼系数
+
+洛伦兹曲线提供了不平等分布的可视化表示。
+
+另一种研究收入和财富不平等的方法是通过基尼系数。
+
+在本节中，我们讨论基尼系数及其与洛伦兹曲线的关系。
+
+### 定义
+
+如前所述，假设样本 $w_1, \ldots, w_n$ 已按从小到大的顺序排列。
+
+基尼系数的定义如下
+
+```{prf:definition}
+:label: define-gini
+
+$$
+G :=
+\frac{\sum_{i=1}^n \sum_{j = 1}^n |w_j - w_i|}
+     {2n\sum_{i=1}^n w_i}.
+$$
+```
+
+基尼系数与洛伦兹曲线密切相关。
+
+事实上，可以证明基尼系数的值是平等线与洛伦兹曲线之间面积的两倍（例如，{numref}`lorenz_gini` 中的阴影区域）。
+
+其思想是，$G=0$ 表示完全平等，而 $G=1$ 表示完全不平等。
+
+```{code-cell} ipython3
+---
+mystnb:
+  figure:
+    caption: "\u57FA\u5C3C\u7CFB\u6570\uFF08\u6A21\u62DF\u8D22\u5BCC\u6570\u636E\uFF09"
+    name: lorenz_gini
+---
+fig, ax = plt.subplots()
+f_vals, l_vals = lorenz_curve(sample)
+ax.plot(f_vals, l_vals, label=f'对数正态样本', lw=2)
+ax.plot(f_vals, f_vals, label='平等线', lw=2)
+ax.fill_between(f_vals, l_vals, f_vals, alpha=0.06)
+ax.set_ylim((0, 1))
+ax.set_xlim((0, 1))
+ax.text(0.04, 0.5, r'$G = 2 \times$ 阴影区域')
+ax.set_xlabel("家庭份额 (%)")
+ax.set_ylabel("财富份额 (%)")
+ax.legend()
+plt.show()
+```
+
+事实上，基尼系数还可以表示为
+
+$$
+G = \frac{A}{A+B}
+$$
+
+其中 $A$ 是45度的完美平等线与洛伦兹曲线之间的区域的面积，$B$ 是洛伦兹曲线以下的区域的面积 —— 参见 {numref}`lorenz_gini2`。
+
+```{code-cell} ipython3
+---
+mystnb:
+  figure:
+    caption: "\u6D1B\u4F26\u5179\u66F2\u7EBF\u548C\u57FA\u5C3C\u7CFB\u6570"
+    name: lorenz_gini2
+---
+fig, ax = plt.subplots()
+f_vals, l_vals = lorenz_curve(sample)
+ax.plot(f_vals, l_vals, label='对数正态样本', lw=2)
+ax.plot(f_vals, f_vals, label='平等线', lw=2)
+ax.fill_between(f_vals, l_vals, f_vals, alpha=0.06)
+ax.fill_between(f_vals, l_vals, np.zeros_like(f_vals), alpha=0.06)
+ax.set_ylim((0, 1))
+ax.set_xlim((0, 1))
+ax.text(0.55, 0.4, 'A')
+ax.text(0.75, 0.15, 'B')
+ax.set_xlabel("家庭份额")
+ax.set_ylabel("财富份额")
+ax.legend()
+plt.show()
+```
+
+```{seealso}
+在全球数据网站上有一个用图表阐述[洛伦兹曲线和基尼系数](https://ourworldindata.org/what-is-the-gini-coefficient)的网页
+```
+
+
+### 模拟数据的基尼系数
+
+让我们通过一些模拟数据来研究基尼系数。
+
+下面的代码将从样本中计算基尼系数。
+
+(code:gini-coefficient)=
+
+```{code-cell} ipython3
+def gini_coefficient(y):
+    r"""
+    实现的基尼不平等指数
+
+    参数
+    ----------
+    y : array_like(float)
+        每个个体的收入/财富数组。
+        排序与否均可
+
+    返回值
+    -------
+    基尼指数: float
+        描述收入/财富数组不平等的基尼指数
+
+    参考资料
+    ----------
+
+    https://en.wikipedia.org/wiki/Gini_coefficient
+    """
+    n = len(y)
+    i_sum = np.zeros(n)
+    for i in range(n):
+        for j in range(n):
+            i_sum[i] += abs(y[i] - y[j])
+    return np.sum(i_sum) / (2 * n * np.sum(y))
+```
+
+现在我们可以计算五个不同总体的基尼系数。
+
+其中，每个总体都是从参数为 $\mu$（均值）和 $\sigma$（标准差）的对数正态分布中生成的。
+
+为了创建这五个总体，我们在 $0.2$ 到 $4$ 的网格上变化 $\sigma$，网格长度为 $5$。
+
+在每种情况下，我们都设定 $\mu = - \sigma^2 / 2$。
+
+这意味着分布的均值不会随 $\sigma$ 改变。
+
+你可以通过查找对数正态分布均值的表达式来验证这一点。
+
+```{code-cell} ipython3
+%%time
+k = 5
+σ_vals = np.linspace(0.2, 4, k)
+n = 2_000
+
+ginis = []
+
+for σ in σ_vals:
+    μ = -σ**2 / 2
+    y = np.exp(μ + σ * np.random.randn(n))
+    ginis.append(gini_coefficient(y))
+```
+
+让我们构建一个返回图形的函数（我们可以在讲义后面的部分中使用它）。
+
+```{code-cell} ipython3
+def plot_inequality_measures(x, y, legend, xlabel, ylabel):
+    fig, ax = plt.subplots()
+    ax.plot(x, y, marker='o', label=legend)
+    ax.set_xlabel(xlabel)
+    ax.set_ylabel(ylabel)
+    ax.legend()
+    return fig, ax
+```
+
+```{code-cell} ipython3
+---
+mystnb:
+  figure:
+    caption: "\u6A21\u62DF\u6570\u636E\u7684\u57FA\u5C3C\u7CFB\u6570"
+    name: gini_simulated
+---
+fix, ax = plot_inequality_measures(σ_vals, 
+                                  ginis, 
+                                  '模拟数据', 
+                                  '$\sigma$', 
+                                  '基尼系数')
+plt.show()
+```
+
+根据基尼系数，图表显示不平等随着 $\sigma$ 增加而上升。
+
+### 美国收入的基尼系数
+
+让我们来看一下美国收入分布的基尼系数。
+
+我们使用 [wbgapi](https://blogs.worldbank.org/opendata/introducing-wbgapi-new-python-package-accessing-world-bank-data)，从世界银行获得预先计算的基尼系数（基于收入）。
+
+我们使用前面导入的 `wbgapi` 包，搜索世界银行数据中的基尼系数以找到系列 ID。
+
+```{code-cell} ipython3
+wb.search("gini")
+```
+
+我们现在知道系列 ID 是 `SI.POV.GINI`。
+
+(另一种找到系列 ID 的方法是使用 [世界银行数据门户](https://data.worldbank.org) 并使用 `wbgapi` 提取数据。)
+
+为了快速掌握数据概况，我们来绘制世界银行数据集中所有国家和所有年份的基尼系数直方图。
+
+```{code-cell} ipython3
+---
+mystnb:
+  figure:
+    caption: "\u5404\u56FD\u57FA\u5C3C\u7CFB\u6570\u76F4\u65B9\u56FE"
+    name: gini_histogram
+---
+# 获取所有国家的基尼数据
+gini_all = wb.data.DataFrame("SI.POV.GINI")
+# 移除索引中的 'YR' 并将其转为整数
+gini_all.columns = gini_all.columns.map(lambda x: int(x.replace('YR',''))) 
+
+# 创建带有多重索引的长系列数据，以获取全球的最大值和最小值
+gini_all = gini_all.unstack(level='economy').dropna()
+
+# 构建直方图
+ax = gini_all.plot(kind="hist", bins=20)
+ax.set_xlabel("基尼系数")
+ax.set_ylabel("频率")
+plt.show()
+```
+
+我们可以在 {numref}`gini_histogram` 中看到，根据50年的数据和所有国家的数据，该指标在20到65之间变化。
+
+现在，我们来看看美国在过去几十年的基尼系数变化。
+
+```{code-cell} ipython3
+data = wb.data.DataFrame("SI.POV.GINI", "USA")
+data.head(n=5)
+# 移除索引中的 'YR' 并将其转换为整数
+data.columns = data.columns.map(lambda x: int(x.replace('YR','')))
+```
+
+（这个数据包通常会返回包含年份信息的列。这在使用 pandas 进行简单绘图时并不总是很方便，因此在绘图之前将结果转置可能会有帮助。）
+
+```{code-cell} ipython3
+data = data.T           # 将年份作为行
+data_usa = data['USA']  # 获取美国数据的 pd.Series
+```
+
+让我们来看一下美国的数据。
+
+```{code-cell} ipython3
+---
+mystnb:
+  figure:
+    caption: "\u7F8E\u56FD\u6536\u5165\u5206\u5E03\u7684\u57FA\u5C3C\u7CFB\u6570"
+    name: gini_usa1
+---
+fig, ax = plt.subplots()
+ax = data_usa.plot(ax=ax)
+ax.set_ylim(data_usa.min()-1, data_usa.max()+1)
+ax.set_ylabel("基尼系数（收入）")
+ax.set_xlabel("年份")
+plt.show()
+```
+
+如 {numref}`gini_usa1` 所示，从1980年到2020年，美国的收入基尼系数呈上升趋势，然后在COVID疫情开始后下降。
+
+(compare-income-wealth-usa-over-time)=
+### 财富的基尼系数
+
+在上一节中，我们重点使用美国的数据研究了收入的基尼系数。
+
+现在让我们来看一下财富分布的基尼系数。
+
+我们将使用 {ref}`消费者金融调查<data:survey-consumer-finance>` 的美国数据。
+
+```{code-cell} ipython3
+df_income_wealth.year.describe()
+```
+
+[此笔记本](https://github.com/QuantEcon/lecture-python-intro/tree/main/lectures/_static/lecture_specific/inequality/data.ipynb) 可以用于计算整个数据集中的此信息。
+
+```{code-cell} ipython3
+data_url = 'https://github.com/QuantEcon/lecture-python-intro/raw/main/lectures/_static/lecture_specific/inequality/usa-gini-nwealth-tincome-lincome.csv'
+ginis = pd.read_csv(data_url, index_col='year')
+ginis.head(n=5)
+```
+
+让我们绘制净财富的基尼系数图表。
+
+```{code-cell} ipython3
+---
+mystnb:
+  figure:
+    caption: "\u7F8E\u56FD\u51C0\u8D22\u5BCC\u7684\u57FA\u5C3C\u7CFB\u6570"
+    name: gini_wealth_us
+---
+fig, ax = plt.subplots()
+ax.plot(years, ginis["n_wealth"], marker='o')
+ax.set_xlabel("年份")
+ax.set_ylabel("基尼系数")
+plt.show()
+```
+
+财富基尼系数的时间序列呈现出 U 形走势，在20世纪80年代初之前，基尼系数呈下降趋势，然后迅速上升。
+
+导致这种变化的一个可能的原因是技术的驱动。
+
+然而，我们将在下文中看到，并非所有发达经济体都经历了类似的不平等问题的增长。
+
+### 跨国收入不平等的比较
+
+在本讲义的前面部分，我们使用 `wbgapi` 获取了多个国家的基尼数据，并将其保存在名为 `gini_all` 的变量中。
+
+在本节中，我们将使用这些数据来比较几个发达经济体，并看一看它们各自的收入基尼系数的变化。
+
+```{code-cell} ipython3
+data = gini_all.unstack()
+data.columns
+```
+
+此数据包中涵盖了167个国家的数据。
+
+我们来比较三个发达经济体：美国、英国和挪威。
+
+```{code-cell} ipython3
+---
+mystnb:
+  figure:
+    caption: "\u6536\u5165\u57FA\u5C3C\u7CFB\u6570\uFF08\u7F8E\u56FD\u3001\u82F1\u56FD\
+      \u548C\u632A\u5A01\uFF09"
+    name: gini_usa_gbr_nor1
+---
+ax = data[['USA','GBR', 'NOR']].plot()
+ax.set_xlabel('年份')
+ax.set_ylabel('基尼系数')
+ax.legend(labels=["美国", "英国", "挪威"], title="") 
+plt.show()
+```
+
+我们发现挪威的数据时间序列较短。
+
+让我们仔细查看底层数据，看看是否可以修正这个问题。
+
+```{code-cell} ipython3
+data[['NOR']].dropna().head(n=5)
+```
+
+此数据包中挪威的数据可以追溯到1979年，但时间序列中存在空缺，所以matplotlib 没有显示这些数据点。
+
+我们可以使用 `.ffill()` 方法来复制并前移序列中的最后已知值，以填补这些空缺。
+
+```{code-cell} ipython3
+---
+mystnb:
+  figure:
+    caption: "\u6536\u5165\u57FA\u5C3C\u7CFB\u6570\uFF08\u7F8E\u56FD\u3001\u82F1\u56FD\
+      \u548C\u632A\u5A01\uFF09"
+    name: gini_usa_gbr_nor2
+---
+data['NOR'] = data['NOR'].ffill()
+ax = data[['USA','GBR', 'NOR']].plot()
+ax.set_xlabel('年份')
+ax.set_ylabel('基尼系数')
+ax.legend(labels=["美国", "英国", "挪威"], title="") 
+plt.show()
+```
+
+从这个图中我们可以观察到，与英国和挪威相比，美国的基尼系数更高（即收入不平等程度更高）。
+
+挪威在这三个经济体中基尼系数最低，而且基尼系数没有上升的趋势。
+
+### 基尼系数与人均GDP（随时间变化）
+
+我们还可以看一看基尼系数与人均GDP的比较（随时间变化）。
+
+让我们再次关注美国、挪威和英国。
+
+```{code-cell} ipython3
+countries = ['USA', 'NOR', 'GBR']
+gdppc = wb.data.DataFrame("NY.GDP.PCAP.KD", countries)
+# 移除索引中的 'YR' 并将其转换为整数
+gdppc.columns = gdppc.columns.map(lambda x: int(x.replace('YR',''))) 
+gdppc = gdppc.T
+```
+
+我们可以重新整理数据，以便绘制不同时期的基尼系数和人均GDP。
+
+```{code-cell} ipython3
+plot_data = pd.DataFrame(data[countries].unstack())
+plot_data.index.names = ['country', 'year']
+plot_data.columns = ['gini']
+```
+
+现在我们将人均GDP数据整理成可以与 `plot_data` 合并的格式。
+
+```{code-cell} ipython3
+pgdppc = pd.DataFrame(gdppc.unstack())
+pgdppc.index.names = ['country', 'year']
+pgdppc.columns = ['gdppc']
+plot_data = plot_data.merge(pgdppc, left_index=True, right_index=True)
+plot_data.reset_index(inplace=True)
+```
+
+现在我们使用 Plotly 绘制一张图表，其中 y 轴表示人均GDP，x 轴表示基尼系数。
+
+```{code-cell} ipython3
+min_year = plot_data.year.min()
+max_year = plot_data.year.max()
+```
+
+这三个国家的时间序列开始和结束的年份不同。
+
+我们将在数据中添加一个年份掩码来提高图表的清晰度，包含每个国家时间序列的不同结束年份。
+
+```{code-cell} ipython3
+labels = [1979, 1986, 1991, 1995, 2000, 2020, 2021, 2022] + \
+         list(range(min_year,max_year,5))
+plot_data.year = plot_data.year.map(lambda x: x if x in labels else None)
+```
+
+(fig:plotly-gini-gdppc-years)=
+
+```{code-cell} ipython3
+fig = px.line(plot_data, 
+              x = "gini", 
+              y = "gdppc", 
+              color = "country", 
+              text = "year", 
+              height = 800,
+              labels = {"gini" : "基尼系数", "gdppc" : "人均GDP"}
+             )
+fig.for_each_trace(lambda t: t.update(name={'USA': '美国', 'GBR': '英国', 'NOR': '挪威'}[t.name]))
+
+fig.update_traces(textposition="bottom right")
+fig.show()
+```
+
+```{only} latex
+此图表是使用 `plotly` 创建的，详见 {ref}`网站上的图表<fig:plotly-gini-gdppc-years>`。
+```
+
+此图表显示，所有三个西方经济体的人均GDP随着时间增长，而基尼系数则有所波动。
+
+从80年代初开始，英国和美国的经济都经历了收入不平等程度的增加。
+
+有趣的是，自2000年以来，英国的收入不平等程度有所下降，而美国则表现出持续且稳定的水平，基尼系数约为40。
+
+## 前10%比例
+
+另一个受欢迎的不平等衡量指标是前10%比例。
+
+在本节中，我们展示如何计算前10%比例。
+
+### 定义
+
+如前所述，假设样本 $w_1, \ldots, w_n$ 已按从小到大的顺序排列。
+
+给定上面定义的洛伦兹曲线 $y = L(x)$，前 $100 \times p \%$ 的比例定义为
+
+```{prf:definition}
+:label: top-shares
+
+$$
+T(p) = 1 - L (1-p) 
+    \approx \frac{\sum_{j\geq i} w_j}{ \sum_{j \leq n} w_j}, \quad i = \lfloor n (1-p)\rfloor
+$$ (topshares)
+```
+
+这里 $\lfloor \cdot \rfloor$ 是向下取整函数，它将任何数字向下取整为小于或等于该数的整数。
+
+以下代码使用数据框 `df_income_wealth` 中的数据生成另一个数据框 `df_topshares`。
+
+`df_topshares` 存储了1950年至2016年美国总收入、劳动收入和净财富的前10%比例。
+
+```{code-cell} ipython3
+:tags: [hide-input]
+
+# 将调查权重从绝对值转换为相对值
+df1 = df_income_wealth
+df2 = df1.groupby('year').sum(numeric_only=True).reset_index()
+df3 = df2[['year', 'weights']]
+df3.columns = 'year', 'r_weights'
+df4 = pd.merge(df3, df1, how="left", on=["year"])
+df4['r_weights'] = df4['weights'] / df4['r_weights']
+
+# 创建加权的净财富、总收入和劳动收入
+df4['weighted_n_wealth'] = df4['n_wealth'] * df4['r_weights']
+df4['weighted_t_income'] = df4['t_income'] * df4['r_weights']
+df4['weighted_l_income'] = df4['l_income'] * df4['r_weights']
+
+# 提取按净财富和总收入分组的前10%群体
+df6 = df4[df4['nw_groups'] == 'Top 10%']
+df7 = df4[df4['ti_groups'] == 'Top 10%']
+
+# 分别计算按净财富、总收入和劳动收入加权的前10%的总和
+df5 = df4.groupby('year').sum(numeric_only=True).reset_index()
+df8 = df6.groupby('year').sum(numeric_only=True).reset_index()
+df9 = df7.groupby('year').sum(numeric_only=True).reset_index()
+
+df5['weighted_n_wealth_top10'] = df8['weighted_n_wealth']
+df5['weighted_t_income_top10'] = df9['weighted_t_income']
+df5['weighted_l_income_top10'] = df9['weighted_l_income']
+
+# 计算这三个变量的前10%比例
+df5['topshare_n_wealth'] = df5['weighted_n_wealth_top10'] / \
+    df5['weighted_n_wealth']
+df5['topshare_t_income'] = df5['weighted_t_income_top10'] / \
+    df5['weighted_t_income']
+df5['topshare_l_income'] = df5['weighted_l_income_top10'] / \
+    df5['weighted_l_income']
+
+# 我们只需要这些变量来计算前10%的比例
+df_topshares = df5[['year', 'topshare_n_wealth',
+                    'topshare_t_income', 'topshare_l_income']]
+```
+
+接下来让我们绘制前10%比例的图表。
+
+```{code-cell} ipython3
+---
+mystnb:
+  figure:
+    caption: "\u7F8E\u56FD\u524D10%\u6BD4\u4F8B"
+    name: top_shares_us
+---
+fig, ax = plt.subplots()
+ax.plot(years, df_topshares["topshare_l_income"],
+        marker='o', label="劳动收入")
+ax.plot(years, df_topshares["topshare_n_wealth"],
+        marker='o', label="净财富")
+ax.plot(years, df_topshares["topshare_t_income"],
+        marker='o', label="总收入")
+ax.set_xlabel("年份")
+ax.set_ylabel("前 $10\%$ 比例")
+ax.legend()
+plt.show()
+```
+
+## 练习
+```{exercise}
+:label: inequality_ex1
+
+使用模拟数据来计算对数正态分布的前10%份额，这些对数正态分布与随机变量 $w_\sigma = \exp(\mu + \sigma Z)$ 相关联，其中 $Z \sim N(0, 1)$ 且 $\sigma$ 在一个从 $0.2$ 到 $4$ 的有限网格上变化。
+
+随着 $\sigma$ 的增加，$w_\sigma$ 的方差也在增加。
+
+为了关注波动性，在每个步骤调整 $\mu$ ，以保持等式 $\mu = -\sigma^2 / 2$ 成立。
+
+对于每个 $\sigma$，生成2000个 $w_\sigma$ 的独立抽样，并计算洛伦兹曲线和基尼系数。
+
+证明更高的方差会在样本中产生更多的分散，从而导致更大的不平等。
+```
+
+```{solution-start} inequality_ex1
+:class: dropdown
+```
+
+这是一种解法：
+
+```{code-cell} ipython3
+def calculate_top_share(s, p=0.1):
+    # 对 s 进行排序
+    s = np.sort(s)
+    n = len(s)
+    index = int(n * (1 - p))
+    return s[index:].sum() / s.sum()
+```
+
+继续使用上面定义的 `calculate_top_share` 函数和之前定义的 `lorenz_curve` 以及 `gini_coefficient` 函数，我们可以为各个 $\sigma$ 值生成统计数据，并绘制变化趋势。
+
+```{code-cell} ipython3
+k = 5
+σ_vals = np.linspace(0.2, 4, k)
+n = 2_000
+
+topshares = []
+ginis = []
+f_vals = []
+l_vals = []
+
+for σ in σ_vals:
+    μ = -σ ** 2 / 2
+    y = np.exp(μ + σ * np.random.randn(n))
+    f_val, l_val = lorenz_curve(y)
+    f_vals.append(f_val)
+    l_vals.append(l_val)
+    ginis.append(gini_coefficient(y))
+    topshares.append(calculate_top_share(y))
+```
+
+```{code-cell} ipython3
+---
+mystnb:
+  figure:
+    caption: "\u6A21\u62DF\u6570\u636E\u7684\u524D10%\u6BD4\u4F8B"
+    name: top_shares_simulated
+  image:
+    alt: top_shares_simulated
+---
+fig, ax = plot_inequality_measures(σ_vals, 
+                                  topshares, 
+                                  "模拟数据", 
+                                  "$\sigma$", 
+                                  "前 $10\%$ 比例") 
+plt.show()
+```
+
+```{code-cell} ipython3
+---
+mystnb:
+  figure:
+    caption: "\u6A21\u62DF\u6570\u636E\u7684\u57FA\u5C3C\u7CFB\u6570"
+    name: gini_coef_simulated
+  image:
+    alt: gini_coef_simulated
+---
+fig, ax = plot_inequality_measures(σ_vals, 
+                                  ginis, 
+                                  "模拟数据", 
+                                  "$\sigma$", 
+                                  "基尼系数")
+plt.show()
+```
+
+```{code-cell} ipython3
+---
+mystnb:
+  figure:
+    caption: "\u6A21\u62DF\u6570\u636E\u7684\u6D1B\u4F26\u5179\u66F2\u7EBF"
+    name: lorenz_curve_simulated
+  image:
+    alt: lorenz_curve_simulated
+---
+fig, ax = plt.subplots()
+ax.plot([0,1],[0,1], label=f"平等线")
+for i in range(len(f_vals)):
+    ax.plot(f_vals[i], l_vals[i], label=f"$\sigma$ = {σ_vals[i]}")
+plt.legend()
+plt.show()
+```
+
+```{solution-end}
+```
+
+
+```{exercise}
+:label: inequality_ex2
+
+根据前10%比例的定义 {eq}`topshares`，我们也可以使用洛伦兹曲线计算前百分位比例。
+
+使用洛伦兹曲线数据 ``f_vals_nw, l_vals_nw`` 和线性插值，计算美国净财富的前10%比例。
+
+绘制由洛伦兹曲线生成的前10%比例与从数据近似得出的前10%比例。
+```
+
+```{solution-start} inequality_ex2
+:class: dropdown
+```
+
+这是一种解法：
+
+```{code-cell} ipython3
+def lorenz2top(f_val, l_val, p=0.1):
+    t = lambda x: np.interp(x, f_val, l_val)
+    return 1- t(1 - p)
+```
+
+```{code-cell} ipython3
+top_shares_nw = []
+for f_val, l_val in zip(f_vals_nw, l_vals_nw):
+    top_shares_nw.append(lorenz2top(f_val, l_val))
+```
+
+```{code-cell} ipython3
+---
+mystnb:
+  figure:
+    caption: "\u7F8E\u56FD\u524D10%\u6BD4\u4F8B\uFF1A\u8FD1\u4F3C\u503C vs \u6D1B\u4F26\
+      \u5179\u66F2\u7EBF"
+    name: top_shares_us_al
+  image:
+    alt: top_shares_us_al
+---
+fig, ax = plt.subplots()
+
+ax.plot(years, df_topshares["topshare_n_wealth"], marker='o',   label="净财富-近似值")
+ax.plot(years, top_shares_nw, marker='o', label="净财富-洛伦兹曲线")
+
+ax.set_xlabel("年份")
+ax.set_ylabel("前 $10\%$ 比例")
+ax.legend()
+plt.show()
+```
+
+```{solution-end}
+```
+
+```{exercise}
+:label: inequality_ex3
+
+{ref}`计算基尼系数的代码已在上述讲义中列出 <code:gini-coefficient>`。
+
+此代码使用循环计算基于收入或财富数据的基尼系数。
+
+该函数可以通过向量化改写，从而大大提高在 `python` 中的计算效率。
+
+使用 `numpy` 和向量化代码来重写 `gini_coefficient` 函数。
+
+你可以比较新函数与上面函数的输出，并注意速度差异。
+```
+
+```{solution-start} inequality_ex3
+:class: dropdown
+```
+
+我们先来看看存储在 `df_income_wealth` 中的美国原始数据
+
+```{code-cell} ipython3
+df_income_wealth.describe()
+```
+
+```{code-cell} ipython3
+df_income_wealth.head(n=4)
+```
+
+我们将重点关注财富变量 `n_wealth` 来计算2016年的基尼系数。
+
+```{code-cell} ipython3
+data = df_income_wealth[df_income_wealth.year == 2016].sample(3000, random_state=1)
+```
+
+```{code-cell} ipython3
+data.head(n=2)
+```
+
+我们可以首先使用上述讲义中定义的函数计算基尼系数。
+
+```{code-cell} ipython3
+gini_coefficient(data.n_wealth.values)
+```
+
+现在我们可以使用 `numpy` 编写一个向量化版本。
+
+```{code-cell} ipython3
+def gini(y):
+    n = len(y)
+    y_1 = np.reshape(y, (n, 1))
+    y_2 = np.reshape(y, (1, n))
+    g_sum = np.sum(np.abs(y_1 - y_2))
+    return g_sum / (2 * n * np.sum(y))
+```
+
+```{code-cell} ipython3
+gini(data.n_wealth.values)
+```
+
+让我们像之前一样通过从对数正态分布中抽取样本来模拟五个总体。
+
+```{code-cell} ipython3
+k = 5
+σ_vals = np.linspace(0.2, 4, k)
+n = 2_000
+σ_vals = σ_vals.reshape((k,1))
+μ_vals = -σ_vals**2/2
+y_vals = np.exp(μ_vals + σ_vals*np.random.randn(n))
+```
+
+我们可以使用向量化函数计算这五个总体的基尼系数，计算时间如下所示：
+
+```{code-cell} ipython3
+%%time
+gini_coefficients =[]
+for i in range(k):
+     gini_coefficients.append(gini(y_vals[i]))
+```
+
+这表明向量化函数更快。
+
+下面给出了这五个家庭的基尼系数。
+
+```{code-cell} ipython3
+gini_coefficients
+```
+
+```{solution-end}
+```