# d3-geo-projection
**Repository Path**: d3js/d3-geo-projection
## Basic Information
- **Project Name**: d3-geo-projection
- **Description**: No description available
- **Primary Language**: JavaScript
- **License**: BSD-3-Clause
- **Default Branch**: 4-broken
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-05
- **Last Updated**: 2025-06-05
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# d3-geo-projection
Extended geographic projections for D3.
## Installing
If you use NPM, `npm install d3-geo-projection`. Otherwise, download the [latest release](https://github.com/d3/d3-geo-projection/releases/latest). You can also load directly from [d3js.org](https://d3js.org) as a [standalone library](https://d3js.org/d3-geo-projection.v1.min.js). AMD, CommonJS, and vanilla environments are supported. In vanilla, a `d3` global is exported:
```html
```
[Try d3-geo-projection in your browser.](https://tonicdev.com/npm/d3-geo-projection)
## API Reference
### Projections
# d3.geoAitoff()
[
](http://bl.ocks.org/mbostock/3682698)
The Aitoff projection.
# d3.geoAiry()
[
](http://bl.ocks.org/mbostock/5620807)
Airy’s minimum-error azimuthal projection.
# airy.radius([radius])
Defaults to 90°.
# d3.geoAlbers()
[
](http://bl.ocks.org/mbostock/3734308)
Alber’s [equal-area conic projection](#geoConicEqualArea); see [d3-geo](https://github.com/d3/d3-geo#geoAlbers).
# d3.geoArmadillo()
[
](http://bl.ocks.org/mbostock/4463127)
The armadillo projection. Note: requires clipping to the sphere.
# d3.geoAugust()
[
](http://bl.ocks.org/mbostock/3797581)
August’s epicycloidal conformal projection.
# d3.geoAzimuthalEqualArea()
[
](http://bl.ocks.org/mbostock/3757101)
The Lambert azimuthal equal-area projection; see [d3-geo](https://github.com/d3/d3-geo#geoAzimuthalEqualArea).
# d3.geoAzimuthalEquidistant()
[
](http://bl.ocks.org/mbostock/3757110)
The azimuthal equidistant projection; see [d3-geo](https://github.com/d3/d3-geo#geoAzimuthalEquidistant).
# d3.geoBaker()
[
](http://bl.ocks.org/mbostock/4476279)
The Baker Dinomic projection.
# d3.geoBerghaus()
[
](http://bl.ocks.org/mbostock/4463049)
Berghaus’ star projection. Note: requires clipping to the sphere.
# berghaus.lobes([lobes])
If *lobes* is specified, sets the number of lobes in the resulting star, and returns this projection. If *lobes* is not specified, returns the current lobe number, which defaults to 5.
# d3.geoBoggs()
[
](http://bl.ocks.org/mbostock/4481220)
The Boggs eumorphic projection. More commonly used in [interrupted form](http://bl.ocks.org/mbostock/4481265).
# d3.geoBonne()
[
](http://bl.ocks.org/mbostock/3734313)
The Bonne pseudoconical equal-area projection. The [Werner projection](http://bl.ocks.org/mbostock/a7ae83252305ed4d54d4) is a limiting form of the Bonne projection with a standard parallel at ±90°.
# bonne.parallel([parallel])
Defaults to 45°.
# d3.geoBottomley()
[
](http://bl.ocks.org/mbostock/ad2d520dd26dcc5af13b)
The [Bottomley projection](http://cybergeo.revues.org/3977) “draws lines of latitude as concentric circular arcs, with arc lengths equal to their lengths on the globe, and placed symmetrically and equally spaced across the vertical central meridian.”
# bottomley.fraction([fraction])
Defaults to 0.5, corresponding to a sin(ψ) where ψ = π/6.
# d3.geoBromley()
[
](http://bl.ocks.org/mbostock/4487695)
The Bromley projection is a rescaled [Mollweide projection](#geoMollweide).
# d3.geoChamberlin()
[
](http://bl.ocks.org/mbostock/5625053)
The Chamberlin trimetric projection. This method does not support *projection*.rotate: the [three reference points](#chamberlin_points) implicitly determine a fixed rotation.
# chamberlin.points([points])
Defaults to [[0, 22], [45, 22], [22.5, -22]].
# d3.geoCollignon()
[
](http://bl.ocks.org/mbostock/3734316)
The Collignon equal-area pseudocylindrical projection. This projection is used in the polar areas of the [HEALPix projection](#geoHealpix).
# d3.geoConicConformal()
[
](http://bl.ocks.org/mbostock/3734321)
The Lambert conformal conic projection; see [d3-geo](https://github.com/d3/d3-geo#geoConicConformal).
# d3.geoConicEqualArea()
[
](http://bl.ocks.org/mbostock/3734308)
Alber’s conic equal-area projection; see [d3-geo](https://github.com/d3/d3-geo#geoConicEqualArea).
# d3.geoConicEquidistant()
[
](http://bl.ocks.org/mbostock/3734317)
The conic equidistant projection; see [d3-geo](https://github.com/d3/d3-geo#geoConicEquidistant).
# d3.geoCraig()
[
](http://bl.ocks.org/mbostock/4459466)
The Craig retroazimuthal projection. Note: this projection tends to [fold over itself](http://bl.ocks.org/mbostock/4459716) if the [standard parallel](#craig_parallel) is non-zero; we have not yet implemented the necessary advanced clipping to avoid overlap.
# craig.parallel([parallel])
Defaults to 0°.
# d3.geoCraster()
[
](http://bl.ocks.org/mbostock/4465118)
The Craster parabolic projection; also known as Putniņš P4.
# d3.geoCylindricalEqualArea()
[
](http://bl.ocks.org/mbostock/3712408)
The cylindrical equal-area projection. Depending on the chosen [parallel](#cylindricalEqualArea_parallel), this projection is also known as the Lambert cylindrical equal-area (0°), [Gall–Peters](http://bl.ocks.org/mbostock/3946824) (45°), [Hobo–Dyer](http://bl.ocks.org/mbostock/4476487) (37.5°), and [Tobler world-in-a-square](http://bl.ocks.org/mbostock/4476496) (~55.654°).
# cylindricalEqualArea.parallel([parallel])
Defaults to approximately 38.58°, fitting the world in a 960×500 rectangle.
# d3.geoCylindricalStereographic()
[
](http://bl.ocks.org/mbostock/5234763)
The cylindrical stereographic projection. With a [parallel](#cylindricalStereographic_parallel) of 45°, also known as Gall’s stereographic.
# cylindricalStereographic.parallel([parallel])
Defaults to 0°.
# d3.geoEckert1()
[Eckert I](http://bl.ocks.org/mbostock/3734322)
# d3.geoEckert2()
[Eckert II](http://bl.ocks.org/mbostock/3734324)
# d3.geoEckert3()
[Eckert III](http://bl.ocks.org/mbostock/3734325)
# d3.geoEckert4()
[Eckert IV](http://bl.ocks.org/mbostock/3734327)
# d3.geoEckert5()
[Eckert V](http://bl.ocks.org/mbostock/3734328)
# d3.geoEckert6()
[Eckert VI](http://bl.ocks.org/mbostock/3734329)
# d3.geoEisenlohr()
[Eisenlohr conformal](http://bl.ocks.org/mbostock/3797585)
# d3.geoEquirectangular()
[
](http://bl.ocks.org/mbostock/3757119).
The equirectangular (plate carrée) projection; see [d3-geo](https://github.com/d3/d3-geo#geoEquirectangular). The [Cassini projection](http://bl.ocks.org/mbostock/5695142) is the transverse aspect of the equirectangular projection.
# d3.geoFahey()
[Fahey](http://bl.ocks.org/mbostock/4731228)
# d3.geoFoucaut()
Foucaut
# d3.geoGilbert(projection)
[Gilbert’s two-world perspective](http://www.jasondavies.com/maps/gilbert/) Wraps the specified *projection*, such as d3.geoOrthographic.
# d3.geoGingery()
[Gingery](http://www.jasondavies.com/maps/gingery/)
# d3.geoGinzburg4()
[Ginzburg IV](http://bl.ocks.org/mbostock/5288565)
# d3.geoGinzburg5()
[Ginzburg V](http://bl.ocks.org/mbostock/5288571)
# d3.geoGinzburg6()
[Ginzburg VI](http://bl.ocks.org/mbostock/5288577)
# d3.geoGinzburg8()
[Ginzburg VIII](http://bl.ocks.org/mbostock/5288583)
# d3.geoGinzburg9()
[Ginzburg IX](http://bl.ocks.org/mbostock/5288590)
# d3.geoGnomonic()
[
](http://bl.ocks.org/mbostock/3757349)
The gnomonic projection; see [d3-geo](https://github.com/d3/d3-geo#geoGnomonic).
# d3.geoGringorten()
[Gringorten](http://bl.ocks.org/mbostock/4362031)
# d3.geoGuyou()
[Guyou hemisphere-in-a-square](http://bl.ocks.org/mbostock/3763867)
# d3.geoHammer()
[Hammer](http://bl.ocks.org/mbostock/3712397), [Eckert–Greifendorff](http://bl.ocks.org/mbostock/4496212), [quartic authalic](http://bl.ocks.org/mbostock/4463175), [Briesemeister](http://bl.ocks.org/mbostock/4519926)
# d3.geoHammerRetroazimuthal()
[Hammer retroazimuthal](http://bl.ocks.org/mbostock/4459130)
# d3.geoHealpix()
[HEALPix](http://bl.ocks.org/mbostock/4463237)
# d3.geoHill()
[Hill eucyclic](http://bl.ocks.org/mbostock/4479513), [Maurer No. 73](http://bl.ocks.org/mbostock/4479547)
# d3.geoHomolosine()
[Goode homolosine](http://bl.ocks.org/mbostock/3734330)
# d3.geoKavrayskiy7()
[Kavrayskiy VII](http://bl.ocks.org/mbostock/3710082)
# d3.geoLagrange()
[Lagrange conformal](http://bl.ocks.org/mbostock/3797591)
# d3.geoLarrivee()
[Larrivée](http://bl.ocks.org/mbostock/3719042)
# d3.geoLaskowski()
[Laskowski tri-optimal](http://bl.ocks.org/mbostock/4489342)
# d3.geoLittrow()
[Littrow](http://bl.ocks.org/mbostock/4459071)
# d3.geoLoximuthal()
[loximuthal](http://bl.ocks.org/mbostock/3867220)
# d3.geoMercator()
[
](http://bl.ocks.org/mbostock/3757132)
The spherical Mercator projection; see [d3-geo](https://github.com/d3/d3-geo#geoMercator).
# d3.geoMiller()
[Miller](http://bl.ocks.org/mbostock/3734333)
# d3.geoModifiedStereographic()
[modified stereographic](http://www.jasondavies.com/maps/modified-stereographic/)
# d3.geoMollweide()
[
](http://bl.ocks.org/mbostock/3734336)
The equal-area, pseudocylindrical Mollweide projection. The oblique aspect is known as the [Atlantis projection](http://bl.ocks.org/mbostock/4519975). [Goode’s interrupted Mollweide](http://bl.ocks.org/mbostock/4498187) is also widely known.
# d3.geoMtFlatPolarParabolic()
[McBryde–Thomas flat-polar parabolic](http://bl.ocks.org/mbostock/4465130)
# d3.geoMtFlatPolarQuartic()
[McBryde–Thomas flat-polar quartic](http://bl.ocks.org/mbostock/4465137)
# d3.geoMtFlatPolarSinusoidal()
[McBryde–Thomas flat-polar sinusoidal](http://bl.ocks.org/mbostock/4465140)
# d3.geoNaturalEarth()
[Natural Earth](http://bl.ocks.org/mbostock/4479477)
# d3.geoNellHammer()
[Nell–Hammer](http://bl.ocks.org/mbostock/3734342)
# d3.geoOrthographic()
[
](http://bl.ocks.org/mbostock/3757125)
The orthographic projection; see [d3-geo](https://github.com/d3/d3-geo#geoOrthographic).
# d3.geoPatterson()
[patterson](http://bl.ocks.org/mbostock/d4021aa4dccfd65edffd)
# d3.geoPeirceQuincuncial()
[Pierce quincuncial](http://bl.ocks.org/mbostock/4310087)
# d3.geoPolyconic()
[polyconic](http://bl.ocks.org/mbostock/3734343)
# d3.geoRectangularPolyconic()
[rectangular polyconic](http://bl.ocks.org/mbostock/5230202)
# d3.geoRobinson()
[Robinson](http://bl.ocks.org/mbostock/3710566)
# d3.geoSatellite()
[satellite (tilted perpsective)](http://bl.ocks.org/mbostock/3790444)
# d3.geoSinusoidal()
[
](http://bl.ocks.org/mbostock/3712399)
The sinusoidal projection.
# d3.geoSinuMollweide()
[Sinu-Mollweide](http://bl.ocks.org/mbostock/4319903)
# d3.geoStereographic()
[
](http://bl.ocks.org/mbostock/3757137)
The stereographic projection; see [d3-geo](https://github.com/d3/d3-geo#geoStereographic).
# d3.geoTimes()
[Times](http://bl.ocks.org/mbostock/5230564)
# d3.geoTransverseMercator()
[
](http://bl.ocks.org/mbostock/5126418)
The transverse spherical Mercator projection; see [d3-geo](https://github.com/d3/d3-geo#geoTransverseMercator).
# d3.geoTwoPointAzimuthal()
[two-point azimuthal](https://www.jasondavies.com/maps/two-point-azimuthal/)
# d3.geoTwoPointEquidistant()
[two-point equidistant](https://www.jasondavies.com/maps/two-point-equidistant/)
# d3.geoVanDerGrinten()
[Van der Grinten](http://bl.ocks.org/mbostock/3796831)
# d3.geoVanDerGrinten2()
[Van der Grinten II](http://bl.ocks.org/mbostock/5230571)
# d3.geoVanDerGrinten3()
[Van der Grinten III](http://bl.ocks.org/mbostock/5230580)
# d3.geoVanDerGrinten4()
[Van der Grinten IV](http://bl.ocks.org/mbostock/4489365)
# d3.geoWagner4()
[Wagner IV, Putniṇš P2´](http://bl.ocks.org/mbostock/4487674)
# d3.geoWagner6()
[Wagner VI](http://bl.ocks.org/mbostock/3710148)
# d3.geoWagner7()
[Wagner VII](http://bl.ocks.org/mbostock/4465109)
# d3.geoWiechel()
[Wiechel](http://bl.ocks.org/mbostock/4463155)
# d3.geoWinkel3()
[
](http://bl.ocks.org/mbostock/3682676)
The Winkel tripel projection.
### Raw Projections
Raw projections are typically passed to the [d3.geoProjection](#geoProjection) constructor. They are exposed here to facilitate the derivation of related projections.
# project(lambda, phi)
…
# project.invert(x, y)
…
# d3.geoAitoffRaw
…
# d3.geoAiryRaw(beta)
…
# d3.geoArmadilloRaw(phi0)
…
# d3.geoAugustRaw
…
# d3.geoBakerRaw
…
# d3.geoBerghausRaw(lobes)
…
# d3.geoBoggsRaw
…
# d3.geoBonneRaw
…
# d3.geoBottomleyRaw(psi)
…
# d3.geoBromleyRaw
…
# d3.geoChamberlinRaw
…
# d3.geoCollignonRaw
…
# d3.geoCraigRaw(phi)
…
# d3.geoCrasterRaw
…
# d3.geoCylindricalEqualAreaRaw
…
# d3.geoCylindricalStereographicRaw
…
# d3.geoMollweideRaw
…
# d3.geoSinusoidalRaw
…
# d3.geoWinkel3Raw
…