# world-atlas

**Repository Path**: mirrors_sporkmonger/world-atlas

## Basic Information

- **Project Name**: world-atlas
- **Description**: Roll your own TopoJSON from Natural Earth data.
- **Primary Language**: Unknown
- **License**: BSD-3-Clause
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-09-26
- **Last Updated**: 2026-04-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# World Atlas TopoJSON

This repository provides a convenient mechanism for generating TopoJSON files from [Natural Earth](http://naturalearthdata.com/).

## Installing via Homebrew

Before you can run `make`, you’ll need to install Node.js and `ogr2ogr`. Here’s how to do that using [Homebrew](http://mxcl.github.com/homebrew/) on Mac OS X:

```bash
brew install node gdal
```

And then, from this repository’s root directory, install the dependencies:

```bash
npm install
```

If the installation of [node-canvas](https://github.com/learnboost/node-canvas) fails for you, try

```bash
PKG_CONFIG_PATH=/opt/X11/lib/pkgconfig npm install canvas
```

Or, add this to your ~/.bash_profile:

```bash
export PKG_CONFIG_PATH="/opt/X11/lib/pkgconfig"
```

If you want to install this software using an alternate method see the website for [TopoJSON](https://github.com/mbostock/topojson). I also recommend reading my tutorial, [Let’s Make a Map](http://bost.ocks.org/mike/map/).

## Generating TopoJSON

Once you have everything installed, simply run:

```
make
```

This will generate various TopoJSON files in the `topo` directory. As a by-product of producing these files, you’ll also download the shapefiles directly from Natural Earth and convert them into GeoJSON and filter.

If you want to generate a custom map, I recommend modifying the Makefile. Or, just use the Makefile as a set of examples, and run the appropriate `ogr2ogr` and `topojson` commands from the terminal.