d3-composite-projections

Set of d3 projections for showing countries' distant lands together

USAGE

This is the version compatible with d3v6, please go here for the version compatible with d3v3.

The projection itself works the same way as the other d3 projections. To be more precise, exactly as the albersUsa projection:

<script src="https://d3js.org/d3.v4.min.js"></script>
<script src="d3-composite-projections.js"></script>
<script>
	var projection = d3.geoConicConformalPortugal();
</script>

Change the scale using scale i.e. .scale(3000), as usual. The projections are prepared to fit a 960x500px SVG or Canvas.

Projections are available for:

• USA: geoAlbersUSA
• USA Territories: geoAlbersUsaTerritories as albersUsa, but adding the American Samoa, Puerto Rico, U.S. Virgin Islands, Guam and Northern Marianas Islands, so all the Congressional Districts are represented
• France: geoConicConformalFrance
• Portugal: geoConicConformalPortugal
• Spain: geoConicConformalSpain
• Netherlands geoConicConformalNetherlands
• Europe: geoConicConformalEurope (thought for Eurostat data)
• Japan: geoConicEquidistantJapan
• Ecuador: geoMercatorEcuador
• Chile: geoTransverseMercatorChile, including the Chilean Antarctic Territory
• Malaysia: geoMercatorMalaysia, created with the help of Saiful Azfar Ramlee
• Equatorial Guinea: geoMercatorEquatorialGuinea
• United Kingdom: geoAlbersUk To draw the borders between the projection zones, use getCompositionBorders() for SVG:

svg.append("path")
 .style("fill","none")
 .style("stroke","#000")
 .attr("d", path(projection.getCompositionBorders()));

or drawCompositionBorders if using Canvas:

projection.drawCompositionBorders(context);

Using with node

var d3_composite = require("d3-composite-projections");
var d3_geo = require("d3-geo");
var projection = d3_composite.geoAlbersUsaTerritories();

INSTALLATION

Getting the files

You can get the files just by cloning the repository:

git clone https://github.com/rveciana/d3-composite-projections.git

or downloading the d3-composite-projections.js or d3-composite-projections.min.js files.

Using cdnjs or unpkg

You can link the files from your web page to cdnjs:

<script src="https://cdnjs.cloudflare.com/ajax/libs/d3-composite-projections/1.0.2/d3-composite-projections.min.js"></script>

or

<script src="https://unpkg.com/[email protected]"></script>

As a module:

Install the library:

npm install --save d3-composite-projections

Import it:

import { geoAlbersUk } from "d3-composite-projections";

In node:

Install the library:

npm install --save d3-composite-projections

Import it:

const d3cp = require("d3-composite-projections")

const projection = d3cp.geoAlbersUk();

Running the tests

Download the library by cloning the git repo:

git clone https://github.com/rveciana/d3-composite-projections.git

The tests can be run using:

npm test