从csv、python字典和pandas数据帧创建google maps us polygon maps
us-polygon-mapper的Python项目详细描述
us_polygon_mapper允许用户从csv、python字典和pandas数据帧创建美国的多边形地图。该脚本使用google maps api(gmplot wrapper)。您可以创建HTML文件和PNG(创建PNG时,也会创建HTML)。必须安装phantomjs才能创建png(见下文)。
基本知识
要安装:
pip install us_polygon_mapper
使用:
#!/usr/bin/env python import us_polygon_mapper.us_polygon_mapper as uspm
您可以使用下列任一项作为数据输入:
- 一个csv,其中一列包含状态(完整或缩写),另一列包含值
- 形式为{state1:value1,state2:value2}的字典
- 一个pandas数据框,其中一列包含状态(完整或缩写),另一列包含值
地图的工作原理是将数据分成两组。“low”组将包含所有数据点<;=中间点(默认为平均值)。“高”组将包含所有数据点>;“中间”。
为“低”组和“高”组指定颜色(默认情况下分别为绿色和红色)。
颜色:“红色”、“橙色”、“黄色”、“绿色”、“蓝色”、“紫色”、“棕色”
中间值:'平均值','中间值',浮动,'百分位数=x'(x:0-100)
默认情况下,对于csv和pandas数据帧,states列假定为0列,values列假定为1列。
可以通过传递参数columns=[state_column_num,value_column_num](例如[2,3])或columns=[state_column_name,value_column_name](例如[state',debt])来更改此值。
用例:
例如,可以使用此包创建选举结果的映射。你可以将每个州的值设为gop%-dem%。然后将“中间”设置为0,“低颜色”设置为蓝色,“高颜色”设置为红色。参见example.py。
主要功能
主要功能有:
- uspm.dict_to_html(值_dict,low_color=“green”,high_color=“red”,middle=“mean”,html_fn=“mymap.html”)
- uspm.csv_to_html(csv_path,low_color=“green”,high_color=“red”,middle=“mean”,columns=none,html_fn=“mymap.html”)
- uspm.df_to_html(df,low_color=“green”,high_color=“red”,middle=“mean”,columns=none,html_fn=“mymap.html”)
- uspm.dict_to_png(值_dict,low_color=“green”,high_color=“red”,middle=“mean”,png_fn=“mymap.png”,html_fn=“mymap.html”)
- uspm.csv_to_png(csv_path,low_color=“green”,high_color=“red”,middle=“mean”,columns=none,png_fn=“mymap.png”,html_fn=“mymap.html”)
- uspm.df_到png(df,low_color=“green”,high_color=“red”,middle=“mean”,columns=none,png_fn=“mymap.png”,html_fn=“mymap.html”)
颜色:“红色”、“橙色”、“黄色”、“绿色”、“蓝色”、“紫色”、“棕色”
中间值:'平均值','中间值',浮动,'百分位数=x'(x:0-100)
列:无(默认为[0,1]),[状态列数,值列数](例如[2,3]),或[状态列名,值列名](例如[状态],[债务])
PNG的注释
要创建PNG,必须安装phantomjs<;http://phantomjs.org/download.html>;。
mac:
(使用自制)在终端中输入“brew install phantomjs”
windows:
下载phantomjs<;http://phantomjs.org/download.html>;并将phantomjs.exe放在您的路径中(下面是Windows 10的完整步骤)。
- 下载phantomjs<;http://phantomjs.org/download.html>;
- 转到“控制面板”>;“系统和安全”>;“系统”
- 单击左侧面板中的“高级系统设置”
- 单击环境变量…
- 将phantomjs.exe移动到路径中的文件夹,或将phantomjs.exe添加到路径中。
注释
- 状态坐标:<;https://github.com/kjhsoftware/us-state-polygons/blob/master/states.xml>;
- 州缩写:<;https://gist.github.com/rogerallen/1583593>;
- 2016年选举结果:<;http://cookpolitical.com/story/10174>;