<NME> 0203-05-01-tips-for-color.md
<BEF> ADDFILE
<MSG> Merge branch 'master' of github.com:mapbox/tilemill

<DFF> @@ -0,0 +1,75 @@
+---
+layout: book
+section: documentation
+category: TileMill
+tag: Guides
+title: "Tips for Using Color in Maps"
+permalink: /docs/guides/tips-for-color
+prereq:
+- "[Installed](/tilemill/docs/install) TileMill on your computer."
+- "Reviewed [Crash Course](/tilemill/docs/crashcourse/overview/)"
+nextup:
+- "[Using conditional styles](/tilemill/docs/crashcourse/conditional-styles/) to control the appearance of points based on data."
+- "[Adding tooltips](/tilemill/docs/crashcourse/tooltips/) to your map."
+- "[Exporting](/tilemill/docs/crashcourse/exporting/) your map."
+---
+{% include prereq.html %}
+
+## Color Theory and Mapping  
+
+It's important to realize how much your choice of color on a map can affect the story you are trying to tell with your data. As a brief introduction to some theories behind how to use colors on maps, here are three primary scheming designs for mapping data.  
+
+### Sequential Schemes  
+Sequential schemes order data from high to low, accenting the highest as a dark shade and the lowest as a light shade (or vice versa). Sequential schemes are best if you are mapping quantitative data and do not want to focus on one particular range within your data.  
+![sequential](/tilemill/assets/pages/sequential.png)
+
+### Diverging Schemes  
+Divergent schemes are best at highlighting a particular middle range of quantitative data. Pick two saturated contrasting colors for the extremes of the data, and the middle ranges blend into a lighter mix of the two. This is particularly great for accenting the mean of your data and exposing locations that significantly 'diverge' from the norm.  
+![diverging](/tilemill/assets/pages/diverging.png)
+
+### Qualitative Schemes  
+If you are working with qualitative data, such as ethnicity or religion, you want to pick a series of 'unrelated' colors. The trick is to pick a really nice color theme so your map looks great. You can also accent particular aspects of your data by your choice of color. For example, one strong dark color among a group of lighter colors will 'pop' out of the map, highlighting that particular facet of your data against all others.  
+![qualitative](/tilemill/assets/pages/qualitative.png)
+
+## Sources for Color-Picking  
+Fortunately a number of sites are available to explore color themes. Below are links to some of these with a brief synopsis of their main features that will help you more easily navigate the seas of storytelling via aesthetics. The section ends with two reviews of purchasable tools that you can use from your desktop.  
+
+### 0_255  
+0_255 is a great site for picking between different shades of one color, so it's ideal for sequential schemes. It gives you thirty options for any given color, allowing you to instantly copy the color's hex code. There is a large grid of colors to select from for an initial color, and then 0_255 visualizes a range of shades based on that color. If the grid does not have the color you want, you can pick your own color by pasting in the hex code of your chosen color.  
+![0_255](/tilemill/assets/pages/0_255_0.jpg)
+
+### Color Scheme Designer  
+Color Scheme Designer allows you to select a color from a color wheel and presents several options for automatically generating colors complementary to your initial choice. Specifically, you can choose between: 
+
+- Complements  
+- Triads  
+- Tetrads  
+- Analogic  
+- Accented Analogic  
+
+Once you've chosen your color and scheme, you'll have a color table that gives you several variations of your colors and their corresponding hex codes.  
+
+![colorscheme](/tilemill/assets/pages/colorschemedesigner_1.jpg)
+
+### Colour Lovers  
+Colour Lovers is great if you are looking for a design theme for mapping qualitative data. Active users contribute palettes to the site, and these palettes are searchable, browsable, and ready to be used on your project.  Colour Lovers users also post patterns if you need some spatial inspiration as well.  
+![colourlovers](/tilemill/assets/pages/colourlovers_0.jpg)
+
+### Kuler  
+Kuler is a service similar to Colour Lovers offered by Adobe. A community of designers submit their own themes, which are available for RGB values and hex codes. The design of the site is a little less intuitive than Colour Lovers, but still worth checking out.  
+![kuler](/tilemill/assets/pages/kuler_1.jpg)
+
+There are a lot of great ideas being posted by an active community of contributing users. Kuler also provides extensive links to things like forums, help pages, as well as several articles on the importance of color and color theory.
+
+### Colorbrewer  
+Colorbrewer is great for contrasting the three kinds of color models mentioned in the first section of this article. It allows you to test out different color themes based on whether you want sequential, diverging, or qualitative schemes and to vary the number of color classes you want in your pallet (up to 12). It also provides some useful 'further reading' articles on these theories and other cartographic design ideas.  
+![colorbrewer](/tilemill/assets/pages/colorbrewer.jpg)
+
+### Pochade  
+Pochade is a color picking program that allows you to determine the RGB value and hex code of any color you see on your screen. It also provides a few different ways of manipulating your color, such as changing its HSB, RGB, or CMYK values. This program is available for download for $9.99.  
+![pochade](/tilemill/assets/pages/pochade_0.jpg)
+
+### ColorSchemer Studio  
+ColorSchemer Studio provides three main features: (1) a color class generator (up to 254 - many more than Color Brewer) based on two colors of your choice, (2) a 'PhotoSchemer', which allows you to upload a photo and determine up to ten different colors on your chosen photo and (3) integration with colourlovers, including a color browser and the ability to load colors into the first tool to manipulate on your own. ColorSchemer is a powerful tool for your desktop, available for the slightly higher price of $49.99.  
+
+{% include nextup.html %}
\ No newline at end of file

{'commit': 'diff --git a/_posts/docs/guides/0203-04-01-adding-postgis-data.md b/_posts/docs/guides/0203-04-01-adding-postgis-data.md\nindex fc5d51c9..c46ba1b6 100644\n--- a/_posts/docs/guides/0203-04-01-adding-postgis-data.md\n+++ b/_posts/docs/guides/0203-04-01-adding-postgis-data.md\n@@ -51,7 +51,7 @@ For this example, we\'ll cover the basics of making a connection to a PostGIS dat\n \n <small class=\'note\' markdown=\'1\'>\n <h3>Note: Indexing and Optimizing PostGIS data</h3>\n-To achieve fast and optimized results in TileMill. \n+To achieve fast and optimized results in TileMill, use good database management and index your data tables with both a unique index on your row ID and a gist index on your geometry column.  \n </small>\n \n {% include nextup.html %}\n\\ No newline at end of file\ndiff --git a/_posts/docs/guides/0203-04-01-addingsqlite.md b/_posts/docs/guides/0203-04-01-addingsqlite.md\nindex 58b87eb1..cc9bac51 100644\n--- a/_posts/docs/guides/0203-04-01-addingsqlite.md\n+++ b/_posts/docs/guides/0203-04-01-addingsqlite.md\n@@ -3,7 +3,7 @@ layout: book\n section: documentation\n category: TileMill\n tag: Guides\n-title: "Adding data from SQLite"\n+title: "Creating and Adding SQLite Layers"\n permalink: /docs/guides/add-sqlite\n prereq:\n - "[Installed](/tilemill/docs/install) TileMill on your computer."\n@@ -45,7 +45,6 @@ Let\'s start by adding polygon features of the District of Columbia Census tract\n 1. To begin, we\'ll work with an existing TileMill project. We\'ve called ours `dc-census`.\n 2. Click to add a new layer.\n 3. Change the add layer type to `SQLite`. You will see the fields change. \n-![step3b](/tilemill/assets/pages/addsqlite-3b.png)  \n 4. Enter `dc` in the **ID** field.\n ![step4b](/tilemill/assets/pages/addsqlite-4b.png)\n 5. For the **Datasource** field, click **Browse** to find the SQLite files located on your computer. Browse to the `/Mapbox/Data/` folder.\ndiff --git a/_posts/docs/guides/0203-05-01-recommended-datasources.md b/_posts/docs/guides/0203-05-01-recommended-datasources.md\nnew file mode 100644\nindex 00000000..b84ac3a0\n--- /dev/null\n+++ b/_posts/docs/guides/0203-05-01-recommended-datasources.md\n@@ -0,0 +1,47 @@\n+---\n+layout: book\n+section: documentation\n+category: TileMill\n+tag: Guides\n+title: "Recommended Data Sources"\n+permalink: /docs/guides/recommended-sources\n+prereq:\n+- "[Installed](/tilemill/docs/install) TileMill on your computer."\n+- "Reviewed [Crash Course](/tilemill/docs/crashcourse/overview/)"\n+nextup:\n+- "[Using conditional styles](/tilemill/docs/crashcourse/conditional-styles/) to control the appearance of points based on data."\n+- "[Adding tooltips](/tilemill/docs/crashcourse/tooltips/) to your map."\n+- "[Exporting](/tilemill/docs/crashcourse/exporting/) your map."\n+\n+---\n+{% include prereq.html %}\n+\n+Looking for a place to start finding additional data? A variety of data sources and open data sites are below. \n+\n+## Worldwide data sets\n+\n+- [CGIAR World Digital Elevation Model](http://www.cgiar-csi.org/data/elevation/item/45-srtm-90m-digital-elevation-database-v41) (available as an [EBS Snapshot](http://support.mapbox.com/kb/tilemill/cgiar-world-digital-elevation-model-ebs-snapshot))\n+- [Natural Earth](http://www.naturalearthdata.com/)\n+- [NOAA Global Shorelines](http://www.ngdc.noaa.gov/mgg/shorelines/gshhs.html)\n+- [OpenStreetMap extracts from CloudMade](http://downloads.cloudmade.com/)\n+- [GADM Global Administrative Areas](http://gadm.org/)\n+\n+## National Governments & Agencies\n+\n+- [US 2010 Census - TIGER Shapefiles](http://www.census.gov/geo/www/tiger/tgrshp2010/tgrshp2010.html)\n+- [US National Weather Service GeoData](http://www.nws.noaa.gov/geodata/)\n+- [Natural Resources Canada GeoGratis](http://www.geogratis.cgdi.gc.ca/)\n+- [Government of Canada Open Data Portal](http://www.data.gc.ca/default.asp?lang=En)\n+\n+## Local & City Open Data Sites\n+\n+- [Baltimore](http://data.baltimorecity.gov/browse?limitTo=blob&tags=shape)\n+- [Chicago](http://data.cityofchicago.org/)\n+- [District of Columbia](http://dcgis.dc.gov/)\n+- [Ottawa](http://www.ottawa.ca/online_services/opendata/index_en.html)\n+- [Paris](http://opendata.paris.fr/)\n+- [Toronto](http://toronto.ca/open)\n+- [Vancouver](http://data.vancouver.ca/)\n+- [Portland](http://civicapps.org/)\n+\n+{% include nextup.html %}\ndiff --git a/_posts/docs/guides/0203-05-01-reprojecting-geotiff.md b/_posts/docs/guides/0203-05-01-reprojecting-geotiff.md\nnew file mode 100644\nindex 00000000..c0657ee6\n--- /dev/null\n+++ b/_posts/docs/guides/0203-05-01-reprojecting-geotiff.md\n@@ -0,0 +1,55 @@\n+---\n+layout: book\n+section: documentation\n+category: TileMill\n+tag: Guides\n+title: "Working with GeoTIFFs"\n+permalink: /docs/guides/reprojecting-geotiff\n+prereq:\n+- "[Installed](/tilemill/docs/install) TileMill on your computer."\n+- "Reviewed [Crash Course](/tilemill/docs/crashcourse/overview/)"\n+nextup:\n+- "[Using conditional styles](/tilemill/docs/crashcourse/conditional-styles/) to control the appearance of points based on data."\n+- "[Adding tooltips](/tilemill/docs/crashcourse/tooltips/) to your map."\n+- "[Exporting](/tilemill/docs/crashcourse/exporting/) your map."\n+code1: | gdalwarp -s_srs EPSG:4326 -t_srs EPSG:3785 -r bilinear -te -20037508.34 -20037508.34 20037508.34 20037508.34 NE2_LR_LC_SR_W.tif natural-earth-2-mercator.tif\n+\n+---\n+{% include prereq.html %}\n+\n+## Reprojecting and Adding GeoTIFFs  \n+\n+TileMill\'s renderer does not support reprojecting raster data sources on-the-fly, so you will need to ensure the file is warped to the proper projection before importing it into your TileMill project. This can be done with the `gdalwarp` command that comes with the [GDAL](http://www.gdal.org/) library (which is installed with TileMill).\n+\n+The projection we need to warp is Google Web Mercator, which can be referenced by the code \'EPSG:3785\'. You will also need to know the original projection of the geotiff you are converting. As an example, we\'ll work with the medium-sized \'Natural Earth II with Shaded Relief and Water\' geotiff [available from Natural Earth](http://www.naturalearthdata.com/downloads/10m-natural-earth-2/10m-natural-earth-ii-with-shaded-relief-and-water/), which is projected to WGS 84 (aka \'EPSG:4326\').\n+\n+1. In your terminal, navigate to the directory where the geotiff is stored.  \n+2. Run the following command. (*Note that the backslashes are not necessary if you type this all on one line*.)  \n+><pre>{{page.code1}}</pre>\n+>You will see this output:\n+>\n+>![output](/tilemill/assets/pages/geotiff-process-2.png)\n+>Let\'s go through what each piece of that command means. A full description of the `gdalwarp` command options can be found [here](http://www.gdal.org/gdalwarp.html).  \n+> \n+>`-s_srs` means "source spatial reference system" - this is the projection that the flle you are starting with is stored in, which in the case of Natural Earth is `EPSG:4326`.  \n+>\n+>`-t_srs` means "target spatial reference system" - this is the projection that you want to convert the datasource to. For any raster file you want to use with TileMill this should be `EPSG:3785`.  \n+>\n+>`-r bilinear` is telling the program what resampling interpolation method to use. If you want the command to run faster and don\'t mind a rougher-looking output, choose `near` instead of `bilinear`. If you don\'t mind waiting longer for very high-quality output, choose `lanczos`.  \n+>\n+>`-te -20037508.34 -20037508.34 20037508.34 20037508.34` is telling the program the desired "target extent" of our output file. This is necessary because the Natural Earth geotiff contains data outside the bounds that the web mercator projection is intended to display. The WGS 84 projection can safely contain data all the way to 90&deg; North & South, while web mercator is really only intended to display data up to about 85.05&deg; North & South. The four big numbers after `-te` represent the western, southern, eastern and northern limits (respectively) of a web mercator map.  \n+>\n+>If you are working with raster data of a smaller area you will need to make sure that these numbers are adjusted to reflect the area it represents. If that area that does not go too far north or south, you can safely omit this entire option.  \n+>\n+>`LR_LC_SR_W.tif` is our original file, and `natural-earth-2-mercator.tif` is the name of the new file the program will create.  \n+>\n+>Depending on the size of your file and the resampling method you choose, `gdalwarp` can take a few seconds to a few hours to do its job. With the cubic resampling method on the medium Natural Earth will should a few minutes.  \n+3. Once it is complete, you can load it into your TileMill project. Click **Add Layer** and browse to find the location where you stored `natural-earth-2-mercator.tif`. \n+4. Select the file and click **Save and Style**. \n+5. To further adjust the resampling interpolation of the image, add the following Carto to your geotiff layer: \n+`raster-scaling: bilinear;`  \n+See the Carto reference manual for additional raster-scaling values. \n+![geotiff](/tilemill/assets/pages/geotiff-process-5.png)\n+6. Select **Save** and preview your map in the map preview pane. \n+\n+{% include nextup.html %}\ndiff --git a/_posts/docs/guides/0203-05-01-tips-for-color.md b/_posts/docs/guides/0203-05-01-tips-for-color.md\nnew file mode 100644\nindex 00000000..1b0335a1\n--- /dev/null\n+++ b/_posts/docs/guides/0203-05-01-tips-for-color.md\n@@ -0,0 +1,75 @@\n+---\n+layout: book\n+section: documentation\n+category: TileMill\n+tag: Guides\n+title: "Tips for Using Color in Maps"\n+permalink: /docs/guides/tips-for-color\n+prereq:\n+- "[Installed](/tilemill/docs/install) TileMill on your computer."\n+- "Reviewed [Crash Course](/tilemill/docs/crashcourse/overview/)"\n+nextup:\n+- "[Using conditional styles](/tilemill/docs/crashcourse/conditional-styles/) to control the appearance of points based on data."\n+- "[Adding tooltips](/tilemill/docs/crashcourse/tooltips/) to your map."\n+- "[Exporting](/tilemill/docs/crashcourse/exporting/) your map."\n+---\n+{% include prereq.html %}\n+\n+## Color Theory and Mapping  \n+\n+It\'s important to realize how much your choice of color on a map can affect the story you are trying to tell with your data. As a brief introduction to some theories behind how to use colors on maps, here are three primary scheming designs for mapping data.  \n+\n+### Sequential Schemes  \n+Sequential schemes order data from high to low, accenting the highest as a dark shade and the lowest as a light shade (or vice versa). Sequential schemes are best if you are mapping quantitative data and do not want to focus on one particular range within your data.  \n+![sequential](/tilemill/assets/pages/sequential.png)\n+\n+### Diverging Schemes  \n+Divergent schemes are best at highlighting a particular middle range of quantitative data. Pick two saturated contrasting colors for the extremes of the data, and the middle ranges blend into a lighter mix of the two. This is particularly great for accenting the mean of your data and exposing locations that significantly \'diverge\' from the norm.  \n+![diverging](/tilemill/assets/pages/diverging.png)\n+\n+### Qualitative Schemes  \n+If you are working with qualitative data, such as ethnicity or religion, you want to pick a series of \'unrelated\' colors. The trick is to pick a really nice color theme so your map looks great. You can also accent particular aspects of your data by your choice of color. For example, one strong dark color among a group of lighter colors will \'pop\' out of the map, highlighting that particular facet of your data against all others.  \n+![qualitative](/tilemill/assets/pages/qualitative.png)\n+\n+## Sources for Color-Picking  \n+Fortunately a number of sites are available to explore color themes. Below are links to some of these with a brief synopsis of their main features that will help you more easily navigate the seas of storytelling via aesthetics. The section ends with two reviews of purchasable tools that you can use from your desktop.  \n+\n+### 0_255  \n+0_255 is a great site for picking between different shades of one color, so it\'s ideal for sequential schemes. It gives you thirty options for any given color, allowing you to instantly copy the color\'s hex code. There is a large grid of colors to select from for an initial color, and then 0_255 visualizes a range of shades based on that color. If the grid does not have the color you want, you can pick your own color by pasting in the hex code of your chosen color.  \n+![0_255](/tilemill/assets/pages/0_255_0.jpg)\n+\n+### Color Scheme Designer  \n+Color Scheme Designer allows you to select a color from a color wheel and presents several options for automatically generating colors complementary to your initial choice. Specifically, you can choose between: \n+\n+- Complements  \n+- Triads  \n+- Tetrads  \n+- Analogic  \n+- Accented Analogic  \n+\n+Once you\'ve chosen your color and scheme, you\'ll have a color table that gives you several variations of your colors and their corresponding hex codes.  \n+\n+![colorscheme](/tilemill/assets/pages/colorschemedesigner_1.jpg)\n+\n+### Colour Lovers  \n+Colour Lovers is great if you are looking for a design theme for mapping qualitative data. Active users contribute palettes to the site, and these palettes are searchable, browsable, and ready to be used on your project.  Colour Lovers users also post patterns if you need some spatial inspiration as well.  \n+![colourlovers](/tilemill/assets/pages/colourlovers_0.jpg)\n+\n+### Kuler  \n+Kuler is a service similar to Colour Lovers offered by Adobe. A community of designers submit their own themes, which are available for RGB values and hex codes. The design of the site is a little less intuitive than Colour Lovers, but still worth checking out.  \n+![kuler](/tilemill/assets/pages/kuler_1.jpg)\n+\n+There are a lot of great ideas being posted by an active community of contributing users. Kuler also provides extensive links to things like forums, help pages, as well as several articles on the importance of color and color theory.\n+\n+### Colorbrewer  \n+Colorbrewer is great for contrasting the three kinds of color models mentioned in the first section of this article. It allows you to test out different color themes based on whether you want sequential, diverging, or qualitative schemes and to vary the number of color classes you want in your pallet (up to 12). It also provides some useful \'further reading\' articles on these theories and other cartographic design ideas.  \n+![colorbrewer](/tilemill/assets/pages/colorbrewer.jpg)\n+\n+### Pochade  \n+Pochade is a color picking program that allows you to determine the RGB value and hex code of any color you see on your screen. It also provides a few different ways of manipulating your color, such as changing its HSB, RGB, or CMYK values. This program is available for download for $9.99.  \n+![pochade](/tilemill/assets/pages/pochade_0.jpg)\n+\n+### ColorSchemer Studio  \n+ColorSchemer Studio provides three main features: (1) a color class generator (up to 254 - many more than Color Brewer) based on two colors of your choice, (2) a \'PhotoSchemer\', which allows you to upload a photo and determine up to ten different colors on your chosen photo and (3) integration with colourlovers, including a color browser and the ability to load colors into the first tool to manipulate on your own. ColorSchemer is a powerful tool for your desktop, available for the slightly higher price of $49.99.  \n+\n+{% include nextup.html %}\n\\ No newline at end of file\ndiff --git a/assets/pages/0_255_0.jpg b/assets/pages/0_255_0.jpg\nnew file mode 100644\nindex 00000000..a1641521\nBinary files /dev/null and b/assets/pages/0_255_0.jpg differ\ndiff --git a/assets/pages/addpostgis-11.png b/assets/pages/addpostgis-11.png\nnew file mode 100644\nindex 00000000..0840d2db\nBinary files /dev/null and b/assets/pages/addpostgis-11.png differ\ndiff --git a/assets/pages/addsqlite-1c.png b/assets/pages/addsqlite-1c.png\nindex 60aa41a1..f377f22b 100644\nBinary files a/assets/pages/addsqlite-1c.png and b/assets/pages/addsqlite-1c.png differ\ndiff --git a/assets/pages/addsqlite-4b.png b/assets/pages/addsqlite-4b.png\nindex e15954ce..02055bc7 100644\nBinary files a/assets/pages/addsqlite-4b.png and b/assets/pages/addsqlite-4b.png differ\ndiff --git a/assets/pages/addsqlite-6c.png b/assets/pages/addsqlite-6c.png\nindex 9f993738..0910102e 100644\nBinary files a/assets/pages/addsqlite-6c.png and b/assets/pages/addsqlite-6c.png differ\ndiff --git a/assets/pages/colorbrewer.jpg b/assets/pages/colorbrewer.jpg\nnew file mode 100644\nindex 00000000..482ae8cd\nBinary files /dev/null and b/assets/pages/colorbrewer.jpg differ\ndiff --git a/assets/pages/colorschemedesigner_1.jpg b/assets/pages/colorschemedesigner_1.jpg\nnew file mode 100644\nindex 00000000..76fd80a8\nBinary files /dev/null and b/assets/pages/colorschemedesigner_1.jpg differ\ndiff --git a/assets/pages/colourlovers_0.jpg b/assets/pages/colourlovers_0.jpg\nnew file mode 100644\nindex 00000000..899100ab\nBinary files /dev/null and b/assets/pages/colourlovers_0.jpg differ\ndiff --git a/assets/pages/diverging.png b/assets/pages/diverging.png\nnew file mode 100644\nindex 00000000..ed90aeb5\nBinary files /dev/null and b/assets/pages/diverging.png differ\ndiff --git a/assets/pages/geotiff-process-2.png b/assets/pages/geotiff-process-2.png\nnew file mode 100644\nindex 00000000..88532990\nBinary files /dev/null and b/assets/pages/geotiff-process-2.png differ\ndiff --git a/assets/pages/geotiff-process-5.png b/assets/pages/geotiff-process-5.png\nnew file mode 100644\nindex 00000000..12d51a7e\nBinary files /dev/null and b/assets/pages/geotiff-process-5.png differ\ndiff --git a/assets/pages/kuler_1.jpg b/assets/pages/kuler_1.jpg\nnew file mode 100644\nindex 00000000..ba1cdaf3\nBinary files /dev/null and b/assets/pages/kuler_1.jpg differ\ndiff --git a/assets/pages/pochade_0.jpg b/assets/pages/pochade_0.jpg\nnew file mode 100644\nindex 00000000..a4c03770\nBinary files /dev/null and b/assets/pages/pochade_0.jpg differ\ndiff --git a/assets/pages/qualitative.png b/assets/pages/qualitative.png\nnew file mode 100644\nindex 00000000..09431207\nBinary files /dev/null and b/assets/pages/qualitative.png differ\ndiff --git a/assets/pages/sequential.png b/assets/pages/sequential.png\nnew file mode 100644\nindex 00000000..b249a1c3\nBinary files /dev/null and b/assets/pages/sequential.png differ\n', 'commit_subject': "Merge branch 'master' of github.com:mapbox/tilemill", 'repo_name': 'tilemill-project/tilemill', 'committer': {'name': 'Young Hahn', 'email': 'ee97d2f28ccffbc411abafd0a61751a89bf3a9bf@developmentseed.org', 'time_sec': '1327007953', 'tz_offset': '-300', 'date': {'seconds': '1327007953'}}, 'commit_tree': 'aef4783dd6ae1e8ab057b8039c5bf2e06181110f', 'commit_message': "Merge branch 'master' of github.com:mapbox/tilemill\n", 'language_name': 'Shell', 'license': 'bsd-3-clause', 'hunks': '@@ -0,0 +1,75 @@\n+---\n+layout: book\n+section: documentation\n+category: TileMill\n+tag: Guides\n+title: "Tips for Using Color in Maps"\n+permalink: /docs/guides/tips-for-color\n+prereq:\n+- "[Installed](/tilemill/docs/install) TileMill on your computer."\n+- "Reviewed [Crash Course](/tilemill/docs/crashcourse/overview/)"\n+nextup:\n+- "[Using conditional styles](/tilemill/docs/crashcourse/conditional-styles/) to control the appearance of points based on data."\n+- "[Adding tooltips](/tilemill/docs/crashcourse/tooltips/) to your map."\n+- "[Exporting](/tilemill/docs/crashcourse/exporting/) your map."\n+---\n+{% include prereq.html %}\n+\n+## Color Theory and Mapping  \n+\n+It\'s important to realize how much your choice of color on a map can affect the story you are trying to tell with your data. As a brief introduction to some theories behind how to use colors on maps, here are three primary scheming designs for mapping data.  \n+\n+### Sequential Schemes  \n+Sequential schemes order data from high to low, accenting the highest as a dark shade and the lowest as a light shade (or vice versa). Sequential schemes are best if you are mapping quantitative data and do not want to focus on one particular range within your data.  \n+![sequential](/tilemill/assets/pages/sequential.png)\n+\n+### Diverging Schemes  \n+Divergent schemes are best at highlighting a particular middle range of quantitative data. Pick two saturated contrasting colors for the extremes of the data, and the middle ranges blend into a lighter mix of the two. This is particularly great for accenting the mean of your data and exposing locations that significantly \'diverge\' from the norm.  \n+![diverging](/tilemill/assets/pages/diverging.png)\n+\n+### Qualitative Schemes  \n+If you are working with qualitative data, such as ethnicity or religion, you want to pick a series of \'unrelated\' colors. The trick is to pick a really nice color theme so your map looks great. You can also accent particular aspects of your data by your choice of color. For example, one strong dark color among a group of lighter colors will \'pop\' out of the map, highlighting that particular facet of your data against all others.  \n+![qualitative](/tilemill/assets/pages/qualitative.png)\n+\n+## Sources for Color-Picking  \n+Fortunately a number of sites are available to explore color themes. Below are links to some of these with a brief synopsis of their main features that will help you more easily navigate the seas of storytelling via aesthetics. The section ends with two reviews of purchasable tools that you can use from your desktop.  \n+\n+### 0_255  \n+0_255 is a great site for picking between different shades of one color, so it\'s ideal for sequential schemes. It gives you thirty options for any given color, allowing you to instantly copy the color\'s hex code. There is a large grid of colors to select from for an initial color, and then 0_255 visualizes a range of shades based on that color. If the grid does not have the color you want, you can pick your own color by pasting in the hex code of your chosen color.  \n+![0_255](/tilemill/assets/pages/0_255_0.jpg)\n+\n+### Color Scheme Designer  \n+Color Scheme Designer allows you to select a color from a color wheel and presents several options for automatically generating colors complementary to your initial choice. Specifically, you can choose between: \n+\n+- Complements  \n+- Triads  \n+- Tetrads  \n+- Analogic  \n+- Accented Analogic  \n+\n+Once you\'ve chosen your color and scheme, you\'ll have a color table that gives you several variations of your colors and their corresponding hex codes.  \n+\n+![colorscheme](/tilemill/assets/pages/colorschemedesigner_1.jpg)\n+\n+### Colour Lovers  \n+Colour Lovers is great if you are looking for a design theme for mapping qualitative data. Active users contribute palettes to the site, and these palettes are searchable, browsable, and ready to be used on your project.  Colour Lovers users also post patterns if you need some spatial inspiration as well.  \n+![colourlovers](/tilemill/assets/pages/colourlovers_0.jpg)\n+\n+### Kuler  \n+Kuler is a service similar to Colour Lovers offered by Adobe. A community of designers submit their own themes, which are available for RGB values and hex codes. The design of the site is a little less intuitive than Colour Lovers, but still worth checking out.  \n+![kuler](/tilemill/assets/pages/kuler_1.jpg)\n+\n+There are a lot of great ideas being posted by an active community of contributing users. Kuler also provides extensive links to things like forums, help pages, as well as several articles on the importance of color and color theory.\n+\n+### Colorbrewer  \n+Colorbrewer is great for contrasting the three kinds of color models mentioned in the first section of this article. It allows you to test out different color themes based on whether you want sequential, diverging, or qualitative schemes and to vary the number of color classes you want in your pallet (up to 12). It also provides some useful \'further reading\' articles on these theories and other cartographic design ideas.  \n+![colorbrewer](/tilemill/assets/pages/colorbrewer.jpg)\n+\n+### Pochade  \n+Pochade is a color picking program that allows you to determine the RGB value and hex code of any color you see on your screen. It also provides a few different ways of manipulating your color, such as changing its HSB, RGB, or CMYK values. This program is available for download for $9.99.  \n+![pochade](/tilemill/assets/pages/pochade_0.jpg)\n+\n+### ColorSchemer Studio  \n+ColorSchemer Studio provides three main features: (1) a color class generator (up to 254 - many more than Color Brewer) based on two colors of your choice, (2) a \'PhotoSchemer\', which allows you to upload a photo and determine up to ten different colors on your chosen photo and (3) integration with colourlovers, including a color browser and the ability to load colors into the first tool to manipulate on your own. ColorSchemer is a powerful tool for your desktop, available for the slightly higher price of $49.99.  \n+\n+{% include nextup.html %}\n\\ No newline at end of file\n', 'addition_count': 75, 'deletion_count': 0, 'src_file': '/dev/null', 'tgt_file': 'b/_posts/docs/guides/0203-05-01-tips-for-color.md', 'file_extension': '.md', 'before_file': 'ADDFILE', 'message': "Merge branch 'master' of github.com:mapbox/tilemill\n", 'author_name': 'Young Hahn', 'lang': 'md'}