mirror of https://github.com/Kozea/pygal.git
Python to generate nice looking SVG graph
http://pygal.org/
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
821 lines
23 KiB
821 lines
23 KiB
=============== |
|
Documentation |
|
=============== |
|
|
|
|
|
Chart types |
|
=========== |
|
|
|
pygal provides 10 kinds of charts: |
|
|
|
.. contents:: |
|
|
|
Line charts |
|
----------- |
|
|
|
Basic |
|
~~~~~ |
|
|
|
Basic simple line graph: |
|
|
|
.. pygal-code:: |
|
|
|
line_chart = pygal.Line() |
|
line_chart.title = 'Browser usage evolution (in %)' |
|
line_chart.x_labels = map(str, range(2002, 2013)) |
|
line_chart.add('Firefox', [None, None, 0, 16.6, 25, 31, 36.4, 45.5, 46.3, 42.8, 37.1]) |
|
line_chart.add('Chrome', [None, None, None, None, None, None, 0, 3.9, 10.8, 23.8, 35.3]) |
|
line_chart.add('IE', [85.8, 84.6, 84.7, 74.5, 66, 58.6, 54.7, 44.8, 36.2, 26.6, 20.1]) |
|
line_chart.add('Others', [14.2, 15.4, 15.3, 8.9, 9, 10.4, 8.9, 5.8, 6.7, 6.8, 7.5]) |
|
|
|
Stacked |
|
~~~~~~~ |
|
|
|
Same graph but with stacked values and filled rendering: |
|
|
|
.. pygal-code:: |
|
|
|
line_chart = pygal.StackedLine(fill=True) |
|
line_chart.title = 'Browser usage evolution (in %)' |
|
line_chart.x_labels = map(str, range(2002, 2013)) |
|
line_chart.add('Firefox', [None, None, 0, 16.6, 25, 31, 36.4, 45.5, 46.3, 42.8, 37.1]) |
|
line_chart.add('Chrome', [None, None, None, None, None, None, 0, 3.9, 10.8, 23.8, 35.3]) |
|
line_chart.add('IE', [85.8, 84.6, 84.7, 74.5, 66, 58.6, 54.7, 44.8, 36.2, 26.6, 20.1]) |
|
line_chart.add('Others', [14.2, 15.4, 15.3, 8.9, 9, 10.4, 8.9, 5.8, 6.7, 6.8, 7.5]) |
|
|
|
|
|
Bar charts / Histograms |
|
----------------------- |
|
|
|
Basic |
|
~~~~~ |
|
|
|
Basic simple bar graph: |
|
|
|
.. pygal-code:: |
|
|
|
line_chart = pygal.Bar() |
|
line_chart.title = 'Browser usage evolution (in %)' |
|
line_chart.x_labels = map(str, range(2002, 2013)) |
|
line_chart.add('Firefox', [None, None, 0, 16.6, 25, 31, 36.4, 45.5, 46.3, 42.8, 37.1]) |
|
line_chart.add('Chrome', [None, None, None, None, None, None, 0, 3.9, 10.8, 23.8, 35.3]) |
|
line_chart.add('IE', [85.8, 84.6, 84.7, 74.5, 66, 58.6, 54.7, 44.8, 36.2, 26.6, 20.1]) |
|
line_chart.add('Others', [14.2, 15.4, 15.3, 8.9, 9, 10.4, 8.9, 5.8, 6.7, 6.8, 7.5]) |
|
|
|
|
|
Stacked |
|
~~~~~~~ |
|
|
|
Same graph but with stacked values: |
|
|
|
.. pygal-code:: |
|
|
|
line_chart = pygal.StackedBar() |
|
line_chart.title = 'Browser usage evolution (in %)' |
|
line_chart.x_labels = map(str, range(2002, 2013)) |
|
line_chart.add('Firefox', [None, None, 0, 16.6, 25, 31, 36.4, 45.5, 46.3, 42.8, 37.1]) |
|
line_chart.add('Chrome', [None, None, None, None, None, None, 0, 3.9, 10.8, 23.8, 35.3]) |
|
line_chart.add('IE', [85.8, 84.6, 84.7, 74.5, 66, 58.6, 54.7, 44.8, 36.2, 26.6, 20.1]) |
|
line_chart.add('Others', [14.2, 15.4, 15.3, 8.9, 9, 10.4, 8.9, 5.8, 6.7, 6.8, 7.5]) |
|
|
|
|
|
Horizontal |
|
~~~~~~~~~~ |
|
|
|
Horizontal bar diagram: |
|
|
|
.. pygal-code:: |
|
|
|
line_chart = pygal.HorizontalBar() |
|
line_chart.title = 'Browser usage in February 2012 (in %)' |
|
line_chart.add('IE', 19.5) |
|
line_chart.add('Firefox', 36.6) |
|
line_chart.add('Chrome', 36.3) |
|
line_chart.add('Safari', 4.5) |
|
line_chart.add('Opera', 2.3) |
|
|
|
|
|
XY charts |
|
--------- |
|
|
|
Basic |
|
~~~~~ |
|
|
|
Basic XY lines, drawing cosinus: |
|
|
|
.. pygal-code:: |
|
|
|
from math import cos |
|
xy_chart = pygal.XY() |
|
xy_chart.title = 'XY Cosinus' |
|
xy_chart.add('x = cos(y)', [(cos(x / 10.), x / 10.) for x in range(-50, 50, 5)]) |
|
xy_chart.add('y = cos(x)', [(x / 10., cos(x / 10.)) for x in range(-50, 50, 5)]) |
|
xy_chart.add('x = 1', [(1, -5), (1, 5)]) |
|
xy_chart.add('x = -1', [(-1, -5), (-1, 5)]) |
|
xy_chart.add('y = 1', [(-5, 1), (5, 1)]) |
|
xy_chart.add('y = -1', [(-5, -1), (5, -1)]) |
|
|
|
|
|
Scatter Plot |
|
~~~~~~~~~~~~ |
|
|
|
Disabling stroke make a good scatter plot |
|
|
|
.. pygal-code:: |
|
|
|
xy_chart = pygal.XY(stroke=False) |
|
xy_chart.title = 'Correlation' |
|
xy_chart.add('A', [(0, 0), (.1, .2), (.3, .1), (.5, 1), (.8, .6), (1, 1.08), (1.3, 1.1), (2, 3.23), (2.43, 2)]) |
|
xy_chart.add('B', [(.1, .15), (.12, .23), (.4, .3), (.6, .4), (.21, .21), (.5, .3), (.6, .8), (.7, .8)]) |
|
xy_chart.add('C', [(.05, .01), (.13, .02), (1.5, 1.7), (1.52, 1.6), (1.8, 1.63), (1.5, 1.82), (1.7, 1.23), (2.1, 2.23), (2.3, 1.98)]) |
|
|
|
|
|
DateY |
|
~~~~~ |
|
You can index values by dates (Thanks to `Snarkturne <https://github.com/snarkturne>`_) |
|
|
|
.. pygal-code:: |
|
|
|
from datetime import datetime, timedelta |
|
datey = pygal.DateY(x_label_rotation=20) |
|
datey.add("Visits", [ |
|
(datetime(2013, 1, 2), 300), |
|
(datetime(2013, 1, 12), 412), |
|
(datetime(2013, 2, 2), 823), |
|
(datetime(2013, 2, 22), 672) |
|
]) |
|
|
|
The x axis and tool tip x labels can be specified using `x_label_format`. This uses the formatting string for strftime from `here <http://docs.python.org/2/library/time.html#time.strftime>`_ |
|
|
|
The x labels can also be specified, using an array of datetime objects. |
|
|
|
.. pygal-code:: |
|
|
|
from datetime import datetime, timedelta |
|
datey = pygal.DateY(x_label_rotation=20) |
|
datey.add("Visits", [ |
|
(datetime(2013, 1, 2), 300), |
|
(datetime(2013, 1, 12), 412), |
|
(datetime(2013, 2, 2), 823), |
|
(datetime(2013, 2, 22), 672) |
|
]) |
|
datey.x_label_format = "%Y-%m-%d" |
|
datey.x_labels = [ |
|
datetime(2013, 1, 1), |
|
datetime(2013, 2, 1), |
|
datetime(2013, 3, 1) |
|
] |
|
|
|
Pies |
|
---- |
|
|
|
Basic |
|
~~~~~ |
|
|
|
Simple pie: |
|
|
|
|
|
.. pygal-code:: |
|
|
|
pie_chart = pygal.Pie() |
|
pie_chart.title = 'Browser usage in February 2012 (in %)' |
|
pie_chart.add('IE', 19.5) |
|
pie_chart.add('Firefox', 36.6) |
|
pie_chart.add('Chrome', 36.3) |
|
pie_chart.add('Safari', 4.5) |
|
pie_chart.add('Opera', 2.3) |
|
|
|
|
|
Multi-series pie |
|
~~~~~~~~~~~~~~~~ |
|
|
|
Same pie but divided in sub category: |
|
|
|
.. pygal-code:: |
|
|
|
pie_chart = pygal.Pie() |
|
pie_chart.title = 'Browser usage by version in February 2012 (in %)' |
|
pie_chart.add('IE', [5.7, 10.2, 2.6, 1]) |
|
pie_chart.add('Firefox', [.6, 16.8, 7.4, 2.2, 1.2, 1, 1, 1.1, 4.3, 1]) |
|
pie_chart.add('Chrome', [.3, .9, 17.1, 15.3, .6, .5, 1.6]) |
|
pie_chart.add('Safari', [4.4, .1]) |
|
pie_chart.add('Opera', [.1, 1.6, .1, .5]) |
|
|
|
|
|
Radar charts |
|
------------ |
|
|
|
Basic |
|
~~~~~ |
|
|
|
Simple Kiviat diagram: |
|
|
|
.. pygal-code:: |
|
|
|
radar_chart = pygal.Radar() |
|
radar_chart.title = 'V8 benchmark results' |
|
radar_chart.x_labels = ['Richards', 'DeltaBlue', 'Crypto', 'RayTrace', 'EarleyBoyer', 'RegExp', 'Splay', 'NavierStokes'] |
|
radar_chart.add('Chrome', [6395, 8212, 7520, 7218, 12464, 1660, 2123, 8607]) |
|
radar_chart.add('Firefox', [7473, 8099, 11700, 2651, 6361, 1044, 3797, 9450]) |
|
radar_chart.add('Opera', [3472, 2933, 4203, 5229, 5810, 1828, 9013, 4669]) |
|
radar_chart.add('IE', [43, 41, 59, 79, 144, 136, 34, 102]) |
|
|
|
|
|
Box plot |
|
-------- |
|
|
|
Basic |
|
~~~~~ |
|
|
|
Here's some whiskers: |
|
|
|
.. pygal-code:: |
|
|
|
box_plot = pygal.Box() |
|
box_plot.title = 'V8 benchmark results' |
|
box_plot.add('Chrome', [6395, 8212, 7520, 7218, 12464, 1660, 2123, 8607]) |
|
box_plot.add('Firefox', [7473, 8099, 11700, 2651, 6361, 1044, 3797, 9450]) |
|
box_plot.add('Opera', [3472, 2933, 4203, 5229, 5810, 1828, 9013, 4669]) |
|
box_plot.add('IE', [43, 41, 59, 79, 144, 136, 34, 102]) |
|
|
|
|
|
Dot charts |
|
---------- |
|
|
|
Basic |
|
~~~~~ |
|
|
|
Punch card like chart: |
|
|
|
.. pygal-code:: |
|
|
|
dot_chart = pygal.Dot(x_label_rotation=30) |
|
dot_chart.title = 'V8 benchmark results' |
|
dot_chart.x_labels = ['Richards', 'DeltaBlue', 'Crypto', 'RayTrace', 'EarleyBoyer', 'RegExp', 'Splay', 'NavierStokes'] |
|
dot_chart.add('Chrome', [6395, 8212, 7520, 7218, 12464, 1660, 2123, 8607]) |
|
dot_chart.add('Firefox', [7473, 8099, 11700, 2651, 6361, 1044, 3797, 9450]) |
|
dot_chart.add('Opera', [3472, 2933, 4203, 5229, 5810, 1828, 9013, 4669]) |
|
dot_chart.add('IE', [43, 41, 59, 79, 144, 136, 34, 102]) |
|
|
|
|
|
Funnel charts |
|
------------- |
|
|
|
Basic |
|
~~~~~ |
|
|
|
Funnel chart: |
|
|
|
.. pygal-code:: |
|
|
|
funnel_chart = pygal.Funnel() |
|
funnel_chart.title = 'V8 benchmark results' |
|
funnel_chart.x_labels = ['Richards', 'DeltaBlue', 'Crypto', 'RayTrace', 'EarleyBoyer', 'RegExp', 'Splay', 'NavierStokes'] |
|
funnel_chart.add('Opera', [3472, 2933, 4203, 5229, 5810, 1828, 9013, 4669]) |
|
funnel_chart.add('Firefox', [7473, 8099, 11700, 2651, 6361, 1044, 3797, 9450]) |
|
funnel_chart.add('Chrome', [6395, 8212, 7520, 7218, 12464, 1660, 2123, 8607]) |
|
|
|
|
|
Gauge charts |
|
------------ |
|
|
|
Basic |
|
~~~~~ |
|
|
|
Simple gauge chart: |
|
|
|
.. pygal-code:: |
|
|
|
gauge_chart = pygal.Gauge(human_readable=True) |
|
gauge_chart.title = 'DeltaBlue V8 benchmark results' |
|
gauge_chart.x_labels = ['Richards', 'DeltaBlue', 'Crypto', 'RayTrace', 'EarleyBoyer', 'RegExp', 'Splay', 'NavierStokes'] |
|
gauge_chart.range = [0, 10000] |
|
gauge_chart.add('Chrome', 8212) |
|
gauge_chart.add('Firefox', 8099) |
|
gauge_chart.add('Opera', 2933) |
|
gauge_chart.add('IE', 41) |
|
|
|
|
|
Pyramid charts |
|
-------------- |
|
|
|
Basic |
|
~~~~~ |
|
|
|
Population pyramid: |
|
|
|
.. pygal-code:: 600 600 |
|
|
|
ages = [(364381, 358443, 360172, 345848, 334895, 326914, 323053, 312576, 302015, 301277, 309874, 318295, 323396, 332736, 330759, 335267, 345096, 352685, 368067, 381521, 380145, 378724, 388045, 382303, 373469, 365184, 342869, 316928, 285137, 273553, 250861, 221358, 195884, 179321, 171010, 162594, 152221, 148843, 143013, 135887, 125824, 121493, 115913, 113738, 105612, 99596, 91609, 83917, 75688, 69538, 62999, 58864, 54593, 48818, 44739, 41096, 39169, 36321, 34284, 32330, 31437, 30661, 31332, 30334, 23600, 21999, 20187, 19075, 16574, 15091, 14977, 14171, 13687, 13155, 12558, 11600, 10827, 10436, 9851, 9794, 8787, 7993, 6901, 6422, 5506, 4839, 4144, 3433, 2936, 2615), |
|
(346205, 340570, 342668, 328475, 319010, 312898, 308153, 296752, 289639, 290466, 296190, 303871, 309886, 317436, 315487, 316696, 325772, 331694, 345815, 354696, 354899, 351727, 354579, 341702, 336421, 321116, 292261, 261874, 242407, 229488, 208939, 184147, 162662, 147361, 140424, 134336, 126929, 125404, 122764, 116004, 105590, 100813, 95021, 90950, 85036, 79391, 72952, 66022, 59326, 52716, 46582, 42772, 38509, 34048, 30887, 28053, 26152, 23931, 22039, 20677, 19869, 19026, 18757, 18308, 14458, 13685, 12942, 12323, 11033, 10183, 10628, 10803, 10655, 10482, 10202, 10166, 9939, 10138, 10007, 10174, 9997, 9465, 9028, 8806, 8450, 7941, 7253, 6698, 6267, 5773), |
|
(0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 23, 91, 412, 1319, 2984, 5816, 10053, 16045, 24240, 35066, 47828, 62384, 78916, 97822, 112738, 124414, 130658, 140789, 153951, 168560, 179996, 194471, 212006, 225209, 228886, 239690, 245974, 253459, 255455, 260715, 259980, 256481, 252222, 249467, 240268, 238465, 238167, 231361, 223832, 220459, 222512, 220099, 219301, 221322, 229783, 239336, 258360, 271151, 218063, 213461, 207617, 196227, 174615, 160855, 165410, 163070, 157379, 149698, 140570, 131785, 119936, 113751, 106989, 99294, 89097, 78413, 68174, 60592, 52189, 43375, 35469, 29648, 24575, 20863), |
|
(0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 74, 392, 1351, 3906, 7847, 12857, 19913, 29108, 42475, 58287, 74163, 90724, 108375, 125886, 141559, 148061, 152871, 159725, 171298, 183536, 196136, 210831, 228757, 238731, 239616, 250036, 251759, 259593, 261832, 264864, 264702, 264070, 258117, 253678, 245440, 241342, 239843, 232493, 226118, 221644, 223440, 219833, 219659, 221271, 227123, 232865, 250646, 261796, 210136, 201824, 193109, 181831, 159280, 145235, 145929, 140266, 133082, 124350, 114441, 104655, 93223, 85899, 78800, 72081, 62645, 53214, 44086, 38481, 32219, 26867, 21443, 16899, 13680, 11508), |
|
(0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 7, 5, 17, 15, 31, 34, 38, 35, 45, 299, 295, 218, 247, 252, 254, 222, 307, 316, 385, 416, 463, 557, 670, 830, 889, 1025, 1149, 1356, 1488, 1835, 1929, 2130, 2362, 2494, 2884, 3160, 3487, 3916, 4196, 4619, 5032, 5709, 6347, 7288, 8139, 9344, 11002, 12809, 11504, 11918, 12927, 13642, 13298, 14015, 15751, 17445, 18591, 19682, 20969, 21629, 22549, 23619, 25288, 26293, 27038, 27039, 27070, 27750, 27244, 25905, 24357, 22561, 21794, 20595), |
|
(0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 6, 8, 0, 8, 21, 34, 49, 84, 97, 368, 401, 414, 557, 654, 631, 689, 698, 858, 1031, 1120, 1263, 1614, 1882, 2137, 2516, 2923, 3132, 3741, 4259, 4930, 5320, 5948, 6548, 7463, 8309, 9142, 10321, 11167, 12062, 13317, 15238, 16706, 18236, 20336, 23407, 27024, 32502, 37334, 34454, 38080, 41811, 44490, 45247, 46830, 53616, 58798, 63224, 66841, 71086, 73654, 77334, 82062, 87314, 92207, 94603, 94113, 92753, 93174, 91812, 87757, 84255, 79723, 77536, 74173), |
|
(0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 5, 0, 11, 35, 137, 331, 803, 1580, 2361, 3632, 4866, 6849, 8754, 10422, 12316, 14152, 16911, 19788, 22822, 27329, 31547, 35711, 38932, 42956, 46466, 49983, 52885, 55178, 56549, 57632, 57770, 57427, 56348, 55593, 55554, 53266, 51084, 49342, 48555, 47067, 45789, 44988, 44624, 44238, 46267, 46203, 36964, 33866, 31701, 28770, 25174, 22702, 21934, 20638, 19051, 17073, 15381, 13736, 11690, 10368, 9350, 8375, 7063, 6006, 5044, 4030, 3420, 2612, 2006, 1709, 1264, 1018), |
|
(0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 4, 6, 11, 20, 68, 179, 480, 1077, 2094, 3581, 5151, 7047, 9590, 12434, 15039, 17257, 19098, 21324, 24453, 27813, 32316, 37281, 43597, 49647, 53559, 58888, 62375, 67219, 70956, 73547, 74904, 75994, 76224, 74979, 72064, 70330, 68944, 66527, 63073, 60899, 60968, 58756, 57647, 56301, 57246, 57068, 59027, 59187, 47549, 44425, 40976, 38077, 32904, 29431, 29491, 28020, 26086, 24069, 21742, 19498, 17400, 15738, 14451, 13107, 11568, 10171, 8530, 7273, 6488, 5372, 4499, 3691, 3259, 2657)] |
|
|
|
types = ['Males single', 'Females single', |
|
'Males married', 'Females married', |
|
'Males widowed', 'Females widowed', |
|
'Males divorced', 'Females divorced'] |
|
|
|
pyramid_chart = pygal.Pyramid(human_readable=True, legend_at_bottom=True) |
|
pyramid_chart.title = 'England population by age in 2010 (source: ons.gov.uk)' |
|
pyramid_chart.x_labels = map(lambda x: str(x) if not x % 5 else '', range(90)) |
|
for type, age in zip(types, ages): |
|
pyramid_chart.add(type, age) |
|
|
|
|
|
Worldmap charts |
|
--------------- |
|
|
|
Basic |
|
~~~~~ |
|
|
|
Highlight some countries: |
|
|
|
.. pygal-code:: |
|
|
|
worldmap_chart = pygal.Worldmap() |
|
worldmap_chart.title = 'Some countries' |
|
worldmap_chart.add('F countries', ['fr', 'fi']) |
|
worldmap_chart.add('M countries', ['ma', 'mc', 'md', 'me', 'mg', |
|
'mk', 'ml', 'mm', 'mn', 'mo', |
|
'mr', 'mt', 'mu', 'mv', 'mw', |
|
'mx', 'my', 'mz']) |
|
worldmap_chart.add('U countries', ['ua', 'ug', 'us', 'uy', 'uz']) |
|
|
|
|
|
You can also specify an number for a country: |
|
|
|
.. pygal-code:: |
|
|
|
worldmap_chart = pygal.Worldmap() |
|
worldmap_chart.title = 'Minimum deaths by capital punishement (source: Amnesty International)' |
|
worldmap_chart.add('In 2012', { |
|
'af': 14, |
|
'bd': 1, |
|
'by': 3, |
|
'cn': 1000, |
|
'gm': 9, |
|
'in': 1, |
|
'ir': 314, |
|
'iq': 129, |
|
'jp': 7, |
|
'kp': 6, |
|
'pk': 1, |
|
'ps': 6, |
|
'sa': 79, |
|
'so': 6, |
|
'sd': 5, |
|
'tw': 6, |
|
'ae': 1, |
|
'us': 43, |
|
'ye': 28 |
|
}) |
|
|
|
|
|
The following countries are supported: |
|
|
|
- `ad`: Andorra |
|
- `ae`: United Arab Emirates |
|
- `af`: Afghanistan |
|
- `al`: Albania |
|
- `am`: Armenia |
|
- `ao`: Angola |
|
- `aq`: Antarctica |
|
- `ar`: Argentina |
|
- `at`: Austria |
|
- `au`: Australia |
|
- `az`: Azerbaijan |
|
- `ba`: Bosnia and Herzegovina |
|
- `bd`: Bangladesh |
|
- `be`: Belgium |
|
- `bf`: Burkina Faso |
|
- `bg`: Bulgaria |
|
- `bh`: Bahrain |
|
- `bi`: Burundi |
|
- `bj`: Benin |
|
- `bn`: Brunei Darussalam |
|
- `bo`: Bolivia, Plurinational State of |
|
- `br`: Brazil |
|
- `bt`: Bhutan |
|
- `bw`: Botswana |
|
- `by`: Belarus |
|
- `bz`: Belize |
|
- `ca`: Canada |
|
- `cd`: Congo, the Democratic Republic of the |
|
- `cf`: Central African Republic |
|
- `cg`: Congo |
|
- `ch`: Switzerland |
|
- `ci`: Cote d'Ivoire |
|
- `cl`: Chile |
|
- `cm`: Cameroon |
|
- `cn`: China |
|
- `co`: Colombia |
|
- `cr`: Costa Rica |
|
- `cu`: Cuba |
|
- `cv`: Cape Verde |
|
- `cy`: Cyprus |
|
- `cz`: Czech Republic |
|
- `de`: Germany |
|
- `dj`: Djibouti |
|
- `dk`: Denmark |
|
- `do`: Dominican Republic |
|
- `dz`: Algeria |
|
- `ec`: Ecuador |
|
- `ee`: Estonia |
|
- `eg`: Egypt |
|
- `eh`: Western Sahara |
|
- `er`: Eritrea |
|
- `es`: Spain |
|
- `et`: Ethiopia |
|
- `fi`: Finland |
|
- `fr`: France |
|
- `ga`: Gabon |
|
- `gb`: United Kingdom |
|
- `ge`: Georgia |
|
- `gf`: French Guiana |
|
- `gh`: Ghana |
|
- `gl`: Greenland |
|
- `gm`: Gambia |
|
- `gn`: Guinea |
|
- `gq`: Equatorial Guinea |
|
- `gr`: Greece |
|
- `gt`: Guatemala |
|
- `gu`: Guam |
|
- `gw`: Guinea-Bissau |
|
- `gy`: Guyana |
|
- `hk`: Hong Kong |
|
- `hn`: Honduras |
|
- `hr`: Croatia |
|
- `ht`: Haiti |
|
- `hu`: Hungary |
|
- `id`: Indonesia |
|
- `ie`: Ireland |
|
- `il`: Israel |
|
- `in`: India |
|
- `iq`: Iraq |
|
- `ir`: Iran, Islamic Republic of |
|
- `is`: Iceland |
|
- `it`: Italy |
|
- `jm`: Jamaica |
|
- `jo`: Jordan |
|
- `jp`: Japan |
|
- `ke`: Kenya |
|
- `kg`: Kyrgyzstan |
|
- `kh`: Cambodia |
|
- `kp`: Korea, Democratic People's Republic of |
|
- `kr`: Korea, Republic of |
|
- `kw`: Kuwait |
|
- `kz`: Kazakhstan |
|
- `la`: Lao People's Democratic Republic |
|
- `lb`: Lebanon |
|
- `li`: Liechtenstein |
|
- `lk`: Sri Lanka |
|
- `lr`: Liberia |
|
- `ls`: Lesotho |
|
- `lt`: Lithuania |
|
- `lu`: Luxembourg |
|
- `lv`: Latvia |
|
- `ly`: Libyan Arab Jamahiriya |
|
- `ma`: Morocco |
|
- `mc`: Monaco |
|
- `md`: Moldova, Republic of |
|
- `me`: Montenegro |
|
- `mg`: Madagascar |
|
- `mk`: Macedonia, the former Yugoslav Republic of |
|
- `ml`: Mali |
|
- `mm`: Myanmar |
|
- `mn`: Mongolia |
|
- `mo`: Macao |
|
- `mr`: Mauritania |
|
- `mt`: Malta |
|
- `mu`: Mauritius |
|
- `mv`: Maldives |
|
- `mw`: Malawi |
|
- `mx`: Mexico |
|
- `my`: Malaysia |
|
- `mz`: Mozambique |
|
- `na`: Namibia |
|
- `ne`: Niger |
|
- `ng`: Nigeria |
|
- `ni`: Nicaragua |
|
- `nl`: Netherlands |
|
- `no`: Norway |
|
- `np`: Nepal |
|
- `nz`: New Zealand |
|
- `om`: Oman |
|
- `pa`: Panama |
|
- `pe`: Peru |
|
- `pg`: Papua New Guinea |
|
- `ph`: Philippines |
|
- `pk`: Pakistan |
|
- `pl`: Poland |
|
- `pr`: Puerto Rico |
|
- `ps`: Palestine, State of |
|
- `pt`: Portugal |
|
- `py`: Paraguay |
|
- `re`: Reunion |
|
- `ro`: Romania |
|
- `rs`: Serbia |
|
- `ru`: Russian Federation |
|
- `rw`: Rwanda |
|
- `sa`: Saudi Arabia |
|
- `sc`: Seychelles |
|
- `sd`: Sudan |
|
- `se`: Sweden |
|
- `sg`: Singapore |
|
- `sh`: Saint Helena, Ascension and Tristan da Cunha |
|
- `si`: Slovenia |
|
- `sk`: Slovakia |
|
- `sl`: Sierra Leone |
|
- `sm`: San Marino |
|
- `sn`: Senegal |
|
- `so`: Somalia |
|
- `sr`: Suriname |
|
- `st`: Sao Tome and Principe |
|
- `sv`: El Salvador |
|
- `sy`: Syrian Arab Republic |
|
- `sz`: Swaziland |
|
- `td`: Chad |
|
- `tg`: Togo |
|
- `th`: Thailand |
|
- `tj`: Tajikistan |
|
- `tl`: Timor-Leste |
|
- `tm`: Turkmenistan |
|
- `tn`: Tunisia |
|
- `tr`: Turkey |
|
- `tw`: Taiwan, Province of China |
|
- `tz`: Tanzania, United Republic of |
|
- `ua`: Ukraine |
|
- `ug`: Uganda |
|
- `us`: United States |
|
- `uy`: Uruguay |
|
- `uz`: Uzbekistan |
|
- `va`: Holy See (Vatican City State) |
|
- `ve`: Venezuela, Bolivarian Republic of |
|
- `vn`: Viet Nam |
|
- `ye`: Yemen |
|
- `yt`: Mayotte |
|
- `za`: South Africa |
|
- `zm`: Zambia |
|
- `zw`: Zimbabwe |
|
|
|
|
|
Country charts |
|
-------------- |
|
|
|
As of now, only France is available. As other country are implemented, this will be externalized in other packages. |
|
(Please submit pull requests :)) |
|
|
|
French map |
|
~~~~~~~~~~ |
|
|
|
Highlight some departments: |
|
|
|
|
|
.. pygal-code:: |
|
|
|
fr_chart = pygal.FrenchMap_Departments() |
|
fr_chart.title = 'Some departments' |
|
fr_chart.add('Métropole', ['69', '92', '13']) |
|
fr_chart.add('Corse', ['2A', '2B']) |
|
fr_chart.add('DOM COM', ['971', '972', '973', '974']) |
|
|
|
You can also specify an number for a department: |
|
|
|
.. pygal-code:: |
|
|
|
fr_chart = pygal.FrenchMap_Departments(human_readable=True) |
|
fr_chart.title = 'Population by department' |
|
fr_chart.add('In 2011', { |
|
'01': 603827, |
|
'02': 541302, |
|
'03': 342729, |
|
'04': 160959, |
|
'05': 138605, |
|
'06': 1081244, |
|
'07': 317277, |
|
'08': 283110, |
|
'09': 152286, |
|
'10': 303997, |
|
'11': 359967, |
|
'12': 275813, |
|
'13': 1975896, |
|
'14': 685262, |
|
'15': 147577, |
|
'16': 352705, |
|
'17': 625682, |
|
'18': 311694, |
|
'19': 242454, |
|
'2A': 145846, |
|
'2B': 168640, |
|
'21': 525931, |
|
'22': 594375, |
|
'23': 122560, |
|
'24': 415168, |
|
'25': 529103, |
|
'26': 487993, |
|
'27': 588111, |
|
'28': 430416, |
|
'29': 899870, |
|
'30': 718357, |
|
'31': 1260226, |
|
'32': 188893, |
|
'33': 1463662, |
|
'34': 1062036, |
|
'35': 996439, |
|
'36': 230175, |
|
'37': 593683, |
|
'38': 1215212, |
|
'39': 261294, |
|
'40': 387929, |
|
'41': 331280, |
|
'42': 749053, |
|
'43': 224907, |
|
'44': 1296364, |
|
'45': 659587, |
|
'46': 174754, |
|
'47': 330866, |
|
'48': 77156, |
|
'49': 790343, |
|
'50': 499531, |
|
'51': 566571, |
|
'52': 182375, |
|
'53': 307031, |
|
'54': 733124, |
|
'55': 193557, |
|
'56': 727083, |
|
'57': 1045146, |
|
'58': 218341, |
|
'59': 2579208, |
|
'60': 805642, |
|
'61': 290891, |
|
'62': 1462807, |
|
'63': 635469, |
|
'64': 656608, |
|
'65': 229228, |
|
'66': 452530, |
|
'67': 1099269, |
|
'68': 753056, |
|
'69': 1744236, |
|
'70': 239695, |
|
'71': 555999, |
|
'72': 565718, |
|
'73': 418949, |
|
'74': 746994, |
|
'75': 2249975, |
|
'76': 1251282, |
|
'77': 1338427, |
|
'78': 1413635, |
|
'79': 370939, |
|
'80': 571211, |
|
'81': 377675, |
|
'82': 244545, |
|
'83': 1012735, |
|
'84': 546630, |
|
'85': 641657, |
|
'86': 428447, |
|
'87': 376058, |
|
'88': 378830, |
|
'89': 342463, |
|
'90': 143348, |
|
'91': 1225191, |
|
'92': 1581628, |
|
'93': 1529928, |
|
'94': 1333702, |
|
'95': 1180365, |
|
'971': 404635, |
|
'972': 392291, |
|
'973': 237549, |
|
'974': 828581, |
|
'976': 212645 |
|
}) |
|
|
|
You can do the same with regions: |
|
|
|
|
|
.. pygal-code:: |
|
|
|
fr_chart = pygal.FrenchMap_Regions() |
|
fr_chart.title = 'Some regions' |
|
fr_chart.add('Métropole', ['82', '11', '93']) |
|
fr_chart.add('Corse', ['94']) |
|
fr_chart.add('DOM COM', ['01', '02', '03', '04']) |
|
|
|
|
|
You can also specify a number for a region and use a department to region aggregation: |
|
|
|
|
|
.. pygal-code:: |
|
|
|
from pygal.graph.frenchmap import aggregate_regions |
|
fr_chart = pygal.FrenchMap_Regions(human_readable=True) |
|
fr_chart.title = 'Population by region' |
|
fr_chart.add('In 2011', aggregate_regions({ |
|
'01': 603827, |
|
'02': 541302, |
|
'03': 342729, |
|
'04': 160959, |
|
'05': 138605, |
|
'06': 1081244, |
|
'07': 317277, |
|
'08': 283110, |
|
'09': 152286, |
|
'10': 303997, |
|
'11': 359967, |
|
'12': 275813, |
|
'13': 1975896, |
|
'14': 685262, |
|
'15': 147577, |
|
'16': 352705, |
|
'17': 625682, |
|
'18': 311694, |
|
'19': 242454, |
|
'2A': 145846, |
|
'2B': 168640, |
|
'21': 525931, |
|
'22': 594375, |
|
'23': 122560, |
|
'24': 415168, |
|
'25': 529103, |
|
'26': 487993, |
|
'27': 588111, |
|
'28': 430416, |
|
'29': 899870, |
|
'30': 718357, |
|
'31': 1260226, |
|
'32': 188893, |
|
'33': 1463662, |
|
'34': 1062036, |
|
'35': 996439, |
|
'36': 230175, |
|
'37': 593683, |
|
'38': 1215212, |
|
'39': 261294, |
|
'40': 387929, |
|
'41': 331280, |
|
'42': 749053, |
|
'43': 224907, |
|
'44': 1296364, |
|
'45': 659587, |
|
'46': 174754, |
|
'47': 330866, |
|
'48': 77156, |
|
'49': 790343, |
|
'50': 499531, |
|
'51': 566571, |
|
'52': 182375, |
|
'53': 307031, |
|
'54': 733124, |
|
'55': 193557, |
|
'56': 727083, |
|
'57': 1045146, |
|
'58': 218341, |
|
'59': 2579208, |
|
'60': 805642, |
|
'61': 290891, |
|
'62': 1462807, |
|
'63': 635469, |
|
'64': 656608, |
|
'65': 229228, |
|
'66': 452530, |
|
'67': 1099269, |
|
'68': 753056, |
|
'69': 1744236, |
|
'70': 239695, |
|
'71': 555999, |
|
'72': 565718, |
|
'73': 418949, |
|
'74': 746994, |
|
'75': 2249975, |
|
'76': 1251282, |
|
'77': 1338427, |
|
'78': 1413635, |
|
'79': 370939, |
|
'80': 571211, |
|
'81': 377675, |
|
'82': 244545, |
|
'83': 1012735, |
|
'84': 546630, |
|
'85': 641657, |
|
'86': 428447, |
|
'87': 376058, |
|
'88': 378830, |
|
'89': 342463, |
|
'90': 143348, |
|
'91': 1225191, |
|
'92': 1581628, |
|
'93': 1529928, |
|
'94': 1333702, |
|
'95': 1180365, |
|
'971': 404635, |
|
'972': 392291, |
|
'973': 237549, |
|
'974': 828581, |
|
'976': 212645 |
|
})) |
|
|
|
Next: `Styles <styles.html>`_
|
|
|