World-wide CartoCSS port of Stamen's classic terrain style
CartoCSS Makefile PLpgSQL HTML JavaScript
Failed to load latest commit information.
bin imposm3-0.2.0dev-20160615-d495ca4-linux Jun 25, 2016
data/aries demote North Shore. See aries issue 3 Sep 30, 2015
fonts #27 add PT Sans ttf Sep 3, 2015
icons #44 add mountain peaks from osm Nov 3, 2015
landcover Create and use a 1:1 landcover image in 3857 (w/ overviews) Jun 30, 2016
lib imposm3-0.2.0dev-20160615-d495ca4-linux Jun 25, 2016
shields #37 add files for varying size default hwy shields Oct 24, 2015
shp-local add it, buoy! Jun 26, 2015
shp shapefiles from toner-carto May 16, 2015
side-by-side @ 2ec10f6 better names for layers Oct 24, 2015
sql/functions attempt at #47, not working yet Nov 4, 2015
tmp #23 adjust color for landcover Aug 31, 2015
.gitignore Create and use a 1:1 landcover image in 3857 (w/ overviews) Jun 30, 2016
.gitmodules add side-by-side viewer Oct 24, 2015
.nvmrc Pin to Node-4.x Jun 30, 2016
LICENSE Initial commit Apr 29, 2015
Makefile Correct path within zip Jul 14, 2016 update readme Aug 4, 2016
imposm3_mapping.json attempt at #47, not working yet Nov 4, 2015
labels.mss bump up halos on labels, adjust font sizes for admin1 labels Jul 5, 2016
map.mss fade out raster landcover sooner, blur more, cut it off after 15. For #… Jul 7, 2016
package.json Upgrade deps + set maxzoom on positron hillshades Jul 11, 2016
terrain-classic-background.mss remove mss directory for #28 Sep 19, 2015
terrain-classic-background.yml fade out raster landcover sooner, blur more, cut it off after 15. For #… Jul 7, 2016
terrain-classic-features.mss transparent background for features layer Jul 1, 2016
terrain-classic-features.yml Resurrect Great Lakes (and other lakes) at z9 Jul 8, 2016
terrain-classic-labels.mss Metatile labels + increase buffer size Jul 8, 2016
terrain-classic-labels.yml Metatile labels + increase buffer size Jul 8, 2016
terrain-classic-lines.mss remove mss directory for #28 Sep 19, 2015
terrain-classic-lines.yml Match OG terrain zoom ranges Jul 5, 2016
terrain-classic-water.mss terrain-background equivalent Jul 7, 2016
terrain-classic-water.yml terrain-background equivalent Jul 7, 2016
terrain-classic.mss remove mss directory for #28 Sep 19, 2015
terrain-classic.yml fix for #64 Jul 7, 2016
terrain_classic.png update screenshot Feb 18, 2016
tessera.json adjust comp-op & opacity settings in tessera.json for combined slopes… Sep 1, 2016

Terrain Classic

World-wide CartoCSS port of Stamen's classic terrain style.

Stamen's original Terrain style was developed in 2011 as part of Stamen's Citytracking initiative, funded by the Knight Foundation. The old repository can be found here, for historical interest.

The original Terrain style only covered the United States. As part of a new Knight Foundation grant, we expanded Terrain to cover the entire world. The Knight grant also funded prototyping for some totally-different new terrain styles, so to avoid confusion we are calling the this reboot of the old style "Terrain Classic."

Terrain screenshot

Most of the current development process for Terrain Classic is based on the toner-carto repo.



  • PostgreSQL
  • PostGIS @2.2.0
  • Node.js --version 0.10*
  • GDAL
  • TileMill 1@master (this includes the latest Mapnik):
  • Imposm 3, which includes dependencies of its own: go, leveldb, and protobuf.

*NOTE: The Node Version Manager script is helpful if you are using a more recent version of Node than 0.10 (which is fairly likely). This is important as TileMill 1@master will only run on Node --version 0.10.

On OS X, installation with Homebrew looks like this:

brew install postgis gdal node go leveldb protobuf pv

# follow instructions to start postgresql

mkdir -p /tmp/imposm
cd /tmp/imposm
export GOPATH=`pwd`
git clone src/imposm3
go get imposm3
go install imposm3

# bin/imposm3 is your new binary; either add $GOPATH/bin to your PATH or copy
# it to /usr/local/bin (or similar)

Terrain Classic Itself

  • Clone this repo
  • Run make link to sym-link the project into your TileMill project directory
  • Run make db/shared to fetch and transform Natural Earth and OSM coastline data
  • Run make db/CA (or similar; seePLACES in the Makefile for a list of registered extracts and expand it as desired).
  • Run make to generate the project.mml file. (Alternatively, maketerrain-classic-background, terrain-classic-lines, orterrain-classic-labels to work on the variant styles)
  • Start TileMill by running npm start from the TileMill repo
  • Open http://localhost:20009/#/project/terrain-classic

make db/<place> will write to the database specified in .env (with a format that resembles postgres:///terrain, where terrain is the database name). If you experience trouble connecting, try adding credentials, e.g. postgres://user:password@localhost/terrain (it will use $USER with no password otherwise). Barring that, check yourpg_hba.conf to ensure that access is configured correctly.

(We primarily develop on OS X where PostgreSQL from Homebrew works out of the box.)

NOTE: Changes to project settings (i.e. .mml files not .mss stylesheets) in TileMill will not persist the changes. To make changes, edit the relevant .yml file and re-run make [variant] to re-generate the project.mml that TileMill reads.

To test the terrain style with a hillshade overlay, a tessera.json config is provided. Install tessera with npm install tessera and then run npm start in the terrain-classic directory. Open http://localhost:8080/ to view the terrain-classic style composited with Open Terrain hillshades.

Testing with the side-by-side viewer (experimental)

In the root folder run npm install && npm start which will start tessera running at http://localhost:8080

Then, in the side-by-side folder, run a simple webserver such as python -m SimpleHTTPServer. Then go to http://localhost:8000 (or whatever port the webserver is running at) to view the side-by-side viewer.


What's the deal with the Makefile? Why is it so complicated?

Magic, mostly. It probably can (and should) be simplified! Consider this another, in-progress "make for data" approach (which actually uses make).

The goal here is to provide an idempotent process for bootstrapping the project that uses as few additional dependencies as possible. make is the age-old solution to this problem, although it takes a more file-focused approach. Put another way, it attempts to efficiently encapsulate otherwise complicated and error-prone operations.

The Makefile here attempts to replicate make's behavior relative to rebuilding files with database tables. In other words, if a Postgres relation already exists, it will be left as-is. If it doesn't exist (has been dropped or hasn't been created), it will be created on-demand.

Why do I have to install pgexplode?

libpq (which underlies PostgreSQL's command-line tools) supports a number of environment variables which can be used to avoid repetition (and avoid errors). However, each component of the connection information is separate, and is more easily and concisely encoded in a URI (i.e. DATABASE_URL). pgexplode is aware of libpq's environment variables and will expand DATABASE_URLs components (which is simpler than managing multiple values and constructing a URL for imposm3 and other tools).