matplotlib之pyplot模块——绘制一组有限长度的垂直/水平线（vlines/hlines）

概述

vlines函数作用是根据x轴的位置绘制一组可设置y轴方向起始值和终止值的垂直线。
hines函数作用与vlines函数类似，根据y轴的位置绘制一组可设置x轴方向起始值和终止值的水平线。

vlines函数的签名为：
matplotlib.pyplot.vlines(x, ymin, ymax, colors=None, linestyles='solid', label='', *, data=None, **kwargs)
其中：

• x：垂直线x轴上的位置。浮点数或类数组结果。必备参数。
• ymin，ymax：垂直线在y轴方向上的起始值和终止值。浮点数或类数组结果。必备参数。
  注意！
  如果ymin，ymax为浮点数，那么都有垂直线的起始值和终止值都是相同的。
  如果想让垂直线具有各自不同的起始值和终止值，需要使用类数组结果。此时，x，ymin，ymax三者的维度必须相同。
• colors：垂直线的颜色。颜色或者颜色列表，默认值为rcParams["lines.color"] (default: 'C0')。可选参数。
• linestyles：线型。取值范围为{'solid', 'dashed', 'dashdot', 'dotted'}，默认为'solid'。
• label：标签。字符串，默认值为''。
• **kwargs：LineCollection属性。

vlines函数的返回值为LineCollection对象。

hlines函数的签名与vlines函数类似：
matplotlib.pyplot.hlines(y, xmin, xmax, colors=None, linestyles='solid', label='', *, data=None, **kwargs)

案例：演示vlines函数

第一个子图演示了ymin，ymax都是浮点值的情况，所有垂直线具有相同的起始位置和终止位置。
第二个子图演示了ymin，ymax都是都是与x维度相同的类数组结构，垂直线具有各自的起始位置和终止位置。
第三个子图演示了vlines的其他参数。

import matplotlib.pyplot as plt

x = range(3)

plt.figure(figsize=(12, 3))
plt.subplot(131)
plt.vlines(x, 0, 3)
plt.subplot(132)
plt.vlines(x, [1, 2, 3], [4, 5, 2])
plt.subplot(133)
plt.plot(x, range(1, 4), marker='o')
plt.vlines(x, [0, 0, 0], range(1, 4), colors=['r', 'g', 'b'],
           linestyles='dashed')
plt.show()