d3-composite-projections


Set of d3 projections for showing countries' distant lands together

!conicConformalFrance

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:

``html



`

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
- Denmark: geoTransverseMercatorDenmark

To draw the borders between the projection zones, use getCompositionBorders() for SVG:

`javascript
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

---

`javascript
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:

`bash
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:

`html

`

or

`html

`

As a module:

Install the library:

`bash
npm install --save d3-composite-projections
`

Import it:

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

In node:

Install the library:

`bash
npm install --save d3-composite-projections
`

Import it:

`javascript
const d3cp = require("d3-composite-projections");

const projection = d3cp.geoAlbersUk();
`

Running the tests

Download the library by cloning the git repo:

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

The tests can be run using:

`bash
npm test
``