covidmx

用于获取墨西哥COVID-19信息的Python API。

需求

more-itertools>=6.0.0
pandas>=0.25.2
Unidecode>=1.1.1
requests==2.21.0
xlrd==1.2.0
mapsmx==0.0.3
matplotlib==3.0.3
mapclassify==2.2.0
descartes==1.1.0

如何安装

pip install covidmx

如何使用

流行病学总司

墨西哥的流行病学总司发布了关于COVID-19的开放数据。该数据源包含个人级别的信息，如性别、市镇和健康状况（吸烟者、肥胖等）。现在，包covidmx可以默认处理此数据源。一些变量编码为整数，并且源还包括一个包含所有相关信息的数据字典。当您传递clean=True（默认选项）时，返回解码后的数据。您还可以通过使用return_catalogo=True访问目录，以及使用return_descripcion=True访问每个变量的描述。当您使用这些参数之一时，API返回一个元组。

from covidmx import CovidMX

covid_dge_data = CovidMX().get_data()
raw_dge_data = CovidMX(clean=False).get_data()
covid_dge_data, catalogo_data = CovidMX(return_catalogo=True).get_data()
covid_dge_data, descripcion_data = CovidMX(return_descripcion=True).get_data()
covid_dge_data, catalogo_data, descripcion_data = CovidMX(return_catalogo=True, return_descripcion=True).get_data()

要获取历史数据，请使用

covid_dge_data = CovidMX(date='12-04-2020').get_data()

默认日期格式为%d-%m-%Y，但您也可以使用特定格式

covid_dge_data = CovidMX(date='2020-04-12', date_format='%Y-%m-%d').get_data()

绘图模块

从版本0.3.0开始，covidmx包括一个模块，可以创建全国和省级不同COVID-19状态的地图，并有可能包括市镇（使用流行病学总司的信息）。

from covidmx import CovidMX

dge_plot = CovidMX().get_plot()

您可以使用以下方法检查可用状态和可用州

dge_plot.available_states

array(['MÉXICO', 'CIUDAD DE MÉXICO', 'TAMAULIPAS', 'BAJA CALIFORNIA',
       'YUCATÁN', 'GUERRERO', 'BAJA CALIFORNIA SUR', 'JALISCO',
       'NUEVO LEÓN', 'SONORA', 'VERACRUZ DE IGNACIO DE LA LLAVE',
       'PUEBLA', 'CAMPECHE', 'GUANAJUATO', 'SAN LUIS POTOSÍ',
       'MICHOACÁN DE OCAMPO', 'COAHUILA DE ZARAGOZA', 'QUERÉTARO',
       'AGUASCALIENTES', 'TABASCO', 'HIDALGO', 'ZACATECAS', 'DURANGO',
       'CHIHUAHUA', 'CHIAPAS', 'SINALOA', 'QUINTANA ROO', 'MORELOS',
       'TLAXCALA', 'NAYARIT', 'OAXACA', 'COLIMA'], dtype=object)

dge_plot.available_status

['confirmados', 'negativos', 'sospechosos', 'muertos']

要绘制全国地图，只需使用

dge_plot.plot_map(status='confirmados')

如果您想包括市镇，请使用

dge_plot.plot_map(status='confirmados', add_municipalities=True)

您可以通过将包含在available_states属性中的有效名称填充到state参数中传递特定州

dge_plot.plot_map(status='confirmados', state='CIUDAD DE MÉXICO', add_municipalities=True)

state='CIUDAD DE MÉXICO'	state='JALISCO'	state='MORELOS'	state='MÉXICO'

最后，您可以绘制另一个感兴趣变量（根据available_status属性）

dge_plot.plot_map(status='sospechosos', add_municipalities=True)

您可以使用save_file_name保存您的地图

dge_plot.plot_map(status='sospechosos', add_municipalities=True, save_file_name='sospechosos-nacional.png')

意外发现

Serendipia 每日发布墨西哥卫生部门关于新冠肺炎的公开数据（.csv格式），该API可以轻松下载这些数据，使其对任务自动化非常有用。

from covidmx import CovidMX

latest_published_data = CovidMX(source='Serendipia').get_data()

然后，CovidMX 实例化一个 Serendipia 类，搜索已确认和疑似个体的最新发布数据，并最终清理数据。不过，可以进行更具体的搜索（请参阅文档以获取详细信息）。

raw_data = CovidMX(source='Serendipia', clean=False).get_data()
confirmed = CovidMX(source='Serendipia', kind="confirmed").get_data()
suspects = CovidMX(source='Serendipia',kind="suspects").get_data()
particular_published_date = CovidMX(source='Serendipia', date='2020-04-10', date_format='%Y-%m-%d').get_data()

引用格式：

• Garza Ramírez, Federico (2020). covidmx：获取墨西哥新冠肺炎信息的Python API. Python包版本0.3.1. https://github.com/FedericoGarza/covidmx.

致谢

• Max Mergenthaler
• Mario Jimenez

发布信息

0.3.1（当前版本）

• 2020-06-01
• 从serendipia源更新新URL。（感谢Mario Jimenez。）

0.3.0

• 2020-04-26.
• 包含州和市级别的绘图模块。
• 包含更好的编码处理。（感谢Mario Jimenez。）

0.2.5

• 2020-04-20。来自疾病预防控制总署
  • 添加了一个ID列。
  • 发布了历史信息。
  • 现在API可以处理这些变化。

0.2.4

• 2020-04-16。来自疾病预防控制总署的源重命名了两列
  • HABLA_LENGUA_INDI -> HABLA_LENGUA_INDIG（列名和描述现在是同义的）
  • OTRA_CON -> OTRA_COM
  • 现在API可以处理这些变化。

0.2.3

• 现在与python3.5+兼容。
• 使用clean=True返回编码数据而不是解码数据（如0.2.0和0.2.1中所做的那样，不清理列）。

0.2.1

• 对README进行了少量更改。

0.2.0

• 添加了新的来源：疾病预防控制总署。默认来源。
• 仅与python3.7+兼容。

0.1.1

• 对README进行了少量更改。

0.1.0

第一个版本。

• 只有一个来源，Serendipia。默认来源。