Wikipedia:WikiProject Maps/Conventions/Gradient maps

This page provide conventions for the creation of gradient maps.

Gradient maps (scientific name: Choropleth) are a light and basic visualisation of spacial areas and their associated values for a single thematic issue, by example the population density by country. Gradient maps need 3 key things: 1. a solidly sourced list of regions⇔values for one issue, 2. a map displaying these regions, 3. a sequential color ramp for legend. This style is conveniently derived from [location maps] style. This style purpose is to illustrate articles including a table of values by regions, thus giving an helpful visualization to understand the data within it's spacial and relational context.

Usage: These maps are final products, usually not reused to generate more complex maps.

Where: gradient maps can currently be found in the Category:Gradient maps. When you create a such map, please tag your upload with Category:Gradient maps.

Motivations
Gradient maps are both at the center and at the basic level of map making on Wikipedia. A simple blank map and fill with color tool are needed. To continue to build a coherent Wikipedia display, this page suggests the most suitable SVG source files together with a blue-based color ramps from academic, screen friendly, print friendly, and color-blind friendly ColorBrewer2 by cartography theorist Cynthia Brewer. The matching the sourced data to a legend is then up to you.
 * Stake

Gradient maps are both easy and difficult to read. Easy because it's usually clear to associate darkness with higher values and lightness with lower values. However, several pitfalls remain: First, the scale matters a lot. Most data has rather irregular data distributions. By example, for population, China and India are about 4.5 and 4 fold more populous than the 3rd country (weight: 1), so 2 countries occupy the space 1>x>4.5, while near 180 countries occupy the 0 to 1 part. This is problematic when trying to use a simple scale, and thus needs a logarithmic scales as that allows the use of the whole color ramp but also sets the USA as almost the same color than India. The reader need to carefully consider the legend and its linear or logarithmic nature. Secondly, the space-unit relationship matter more for a gradient map of population, and population density will generate very different feelings and interpretations, one city may make a large sparsely populated area appear densely populated. Third, the color matters. Some colors have positive or negative meaning depending of your culture (red is aggressive for Westerners, happiness for East Asia). It has been argued that rainbow gradients should be avoided, based on cultural and eyes different interpretations, in favor of light to dark gradients. Last, all the unit, the source, and the years are core informations to gather. An household is different from a person, income in nominal US$ is very different from parity purchase power US$, 1930's nominal US$ are very different from today nominal US$, etc.
 * Risks

History and current work
Gradient map are, from the beginning, and the center of Wikipedia's maps creation. There have been in used "for ever", since they are logical solution to display data (table of values?) where each spacial area is associated with a given values. Most frequently on Wikipedia, a gradient map is a one-theme worldmap displaying the countries of the word, where each country is assigned a given color according to the data available for this theme. By example GDP per capita by country, Population density per country. It can also go on lower levels, such as Population density per province in PRC.
 * History

World gradient maps are better derived from File:BlankMap-World6.svg. For other areas of lower levels, the location maps are a first tool. For better svg's codes or automatization, QGIS and SVGSimple are great helps. Indeed, Gadm.org can provide the needed GIS data, please see Gadm.org on this page. While most current usage are in .png format, .svg is encouraged for it's comparative advantage of scalability.
 * Interesting technical issues


 * Innovations

Currently [2012/09], Arthur Gunn assisted by Yug and concepts from cartography Professor Cynthia Brewer's ColorBrewer2.org are pushing and developping an online app to receive data, generate an elegant SVG gradient map, and save its data and settings. The project is done in accessible technologies (HTML, CSS, JS / D3.js) in order to let Wikipedia contributors lead the project after Arthur's initial and major push. The project have a huge potential since the decisive GIS data available online may be convert to JSON format and feed this D3.js app with all kinds of backgrounds, areas and items. While most gradient maps on commons aren't categorized as 'gradient map' or any map style, the largest collection them can be found in Category:Gradient maps.
 * Leading place

Examples

 * Examples (toolkits)


 * Basic usages

Using GunnMap
GunnMap is an online app coded using accessible technologies, namely HTML, CSS, JS, and D3.js, and under CC-by-sa license. This accessible technologies allow programmers to easily suggest code improvements or new functions.
 * Technologies

Currently for world maps, where countries are associated with polygons and have for id their iso names. The code is actually compatible with any well and strictly coded administrative map where administrative/given areas are represented by a given polygons with a conventional and understandable id name. To generate such well coded map, QGIS and SimpleSVG are very helpful.
 * Usage

GunnMap suggests you a code to copy-paste. {GunnMap}
 * Upload to Commons