Examples for Salt
Please be sure to check out the release tag matching the version of Salt you intend to use
-
png-example - illustrates using Salt to build .png image datasets compatible with any TMS visualization library.
-
bin-example - illustrates using Salt to build byte file datasets which utilize client-side heatmap rendering using Leaflet's TileLayer.Canvas library.
-
torque-example - illustrates using Salt to build TileJSON datasets compatible with CartoDB's Torque library.
-
path-example - similar to bin-example, but illustrates rendering lines instead of points
-
hierarchical-pie-example - illustrates using Salt and D3.js to build a non-2D-spatial visualization of inherently hierarchical data
To run the example projects your development environment will need to have the following installed:
- Docker
- Java compiler
- Gradle
- Node + npm
Examples generally have two phases: 1) tile data generation, 2) web-based viewer of the result. Tile generation relies on a Docker container running Apache Spark to simplify running examples on your local machine. To build this container for use in all examples, run:
$ docker build -t uncharted/salt-examples .
Please see README.md files in each example directory for further instructions.
Windows and Docker don't always play nicely together when it comes to volume mounting. Some tips:
- Make sure you have *NIX line endings on all the files in your working copy. Set
$ git config core.autocrlf falseand check out a fresh copy of thesalt-examplescodebase. - If all else fails, try virtualizing a Linux environment