# 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