d3-geo-проекция

Расширенные географические проекции для d3-geo. См. Командная литография для введения.

Установка

Если вы используете npm, npm install d3-geo-projection. Вы также можете загрузить последнюю версию на GitHub. Для обычного HTML в современных браузерах импортируйте d3-geo-projection из Skypack:

<script type="module">

import {geoAitoff} from "https://cdn.skypack.dev/d3-geo-projection@4";

const projection = geoAitoff();

</script>

Для устаревших сред вы можете загрузить пакет UMD d3-geo-projection с CDN на основе npm, например, jsDelivr; экспортируется глобальная переменная d3:

<script src="https://cdn.jsdelivr.net/npm/d3-array@3"></script>
<script src="https://cdn.jsdelivr.net/npm/d3-geo@3"></script>
<script src="https://cdn.jsdelivr.net/npm/d3-geo-projection@4"></script>
<script>

const projection = d3.geoAitoff();

</script>

Справочник по API

• Проекции
• Прерванные проекции
• Многогранные проекции
• Проекции Квинсинциал
• Преобразования

Проекции

Примечание: проекции с меткой [d3-geo] экспортируются d3-geo, а не d3-geo-projection. Эти часто используемые проекции также включены в пакет по умолчанию d3.

d3.geoAiry() · Исходный код, Примеры
d3.geoAiryRaw(beta)

Минимально-ошибочная азимутальная проекция Эйри.

airy.radius([radius])

По умолчанию 90°.

d3.geoAitoff() · Исходный код, Примеры
d3.geoAitoffRaw

Проекция Эйтхоффа.

d3.geoAlbers() · Исходный код [d3-geo]

Равноплощадная коническая проекция Альберса.

d3.geoArmadillo() · Исходный код, Примеры
d3.geoArmadilloRaw(phi0)

Проекция муравьеда. По умолчанию центр предполагает стандартную параллель 20° и должен быть изменён, если используется другая параллель. Примечание: требуется обрезка до сферы.

armadillo.parallel([parallel])

По умолчанию 20°.

d3.geoAugust() · Исходный код, Примеры
d3.geoAugustRaw

Конформная эпициклоидальная проекция Августа.

d3.geoAzimuthalEqualArea() · Исходный код [d3-geo], Примеры
d3.geoAzimuthalEqualAreaRaw

Равноплощадная азимутальная проекция Ламберта.

d3.geoAzimuthalEquidistant() · Исходный код [d3-geo], Примеры
d3.geoAzimuthalEquidistantRaw

Азимутальная равноудаленная проекция.

d3.geoBaker() · Исходный код, Примеры
d3.geoBakerRaw

Проекция Бейкера Диномик.

d3.geoBerghaus() · Исходный код, Примеры
d3.geoBerghausRaw(lobes)

Звёздная проекция Бергхауса. По умолчанию центр предполагает число долей 5 и должен быть изменён, если используется другое число долей. Примечание: требуется обрезка до сферы.

berghaus.lobes([lobes]) · Исходный код

Если лобы указаны, устанавливает число долей в результирующей звезде и возвращает эту проекцию. Если лобы не указаны, возвращает текущее число долей, которое по умолчанию равно 5.

d3.geoBertin1953() · Исходный код
d3.geoBertin1953Raw

Проекция Жака Бертена 1953 года.

d3.geoBoggs() · Исходный код, Примеры
d3.geoBoggsRaw

Проекция Боггса эйморфическая. Чаще используется в прерванной форме.

d3.geoBonne() · Исходный код, Примеры
d3.geoBonneRaw(phi0)

Равноплощадная псевдоконическая проекция Бонна. Проекция Вернера является предельной формой проекции Бонна со стандартной параллелью ±90°. По умолчанию центр предполагает стандартную параллель 45° и должен быть изменён, если используется другая параллель.

bonne.parallel([parallel])

По умолчанию 45°.

d3.geoBottomley() · Исходный код, Примеры
d3.geoBottomleyRaw(sinPsi)

Проекция Боттэмли «изображает линии широты как концентрические дуги окружностей, длины дуг которых равны длинам на глобусе, и расположенные симметрично и равномерно через центральный меридиан».

bottomley.fraction([fraction])

По умолчанию 0,5, что соответствует sin(ψ), где ψ = π/6.

d3.geoBromley() · Исходный код, Примеры
d3.geoBromleyRaw

Проекция Бромли — это масштабированная проекция Мольвейде.

d3.geoChamberlin(point0, point1, point2) · Исходный код
d3.geoChamberlinRaw(p0, p1, p2)

Трехмерная проекция Чемберлина. Этот метод не поддерживает projection.rotate: три опорные точки неявно определяют фиксированное вращение.

d3.geoChamberlinAfrica() · Исходный код

Проекция Чемберлина для Африки, использующая точки [0°, 22°], [45°, 22°], [22,5°, -22°].

d3.geoCollignon() · Исходный код, Примеры
d3.geoCollignonRaw

Псевдоцилиндрическая проекция Коллиньона с равными площадями. Эта проекция используется в полярных областях проекции HEALPix.

d3.geoConicConformal() · Исходный код [d3-geo], Примеры
d3.geoConicConformalRaw

Конформная коническая проекция Ламберта.

d3.geoConicEqualArea() · Исходный код [d3-geo], Примеры
d3.geoConicEqualAreaRaw

Равноплощадная коническая проекция Альберса.

d3.geoConicEquidistant() · Исходный код [d3-geo], Примеры
d3.geoConicEquidistantRaw

Коническая равноудаленная проекция.

d3.geoCraig() · Исходный код, Примеры
d3.geoCraigRaw(phi)

Проекция Крейга в обратном азимутальном направлении. Примечание: эта проекция имеет тенденцию складываться сама на себя, если стандартный параллель отличен от нуля; мы пока не реализовали необходимые расширенные алгоритмы обрезки для предотвращения перекрытия.

craig.parallel([parallel])

По умолчанию 0°.

d3.geoCraster() · Исходный код, Примеры
d3.geoCrasterRaw

Параболическая проекция Крастера; также известная как Putniņš P4.

d3.geoCylindricalEqualArea() · Исходный код, Примеры
d3.geoCylindricalEqualAreaRaw(phi0)

Цилиндрическая проекция с равными площадями. В зависимости от выбранного параллели, эта проекция также известна как равноплощадная цилиндрическая проекция Ламберта (0°), проекция Бехрана (30°), проекция Хобо-Дира (37,5°), проекция Галла-Петерса (45°), проекция Бальтазара (50°) и мировая проекция Тоблера в квадрате (~55,654°).

cylindricalEqualArea.parallel([parallel])

По умолчанию примерно 38,58°, соответствуя миру в прямоугольнике 960×500.

d3.geoCylindricalStereographic() · Исходный код, Примеры
d3.geoCylindricalStereographicRaw(phi0)

Цилиндрическая стереографическая проекция. В зависимости от выбранного параллели, эта проекция также известна как стереографическая проекция Брауна (0°) и стереографическая проекция Галла (45°).

cylindricalStereographic.parallel([parallel])

По умолчанию 0°.

d3.geoEckert1() · Исходный код, Примеры
d3.geoEckert1Raw

Проекция Эккерта I.

d3.geoEckert2() · Исходный код, Примеры
d3.geoEckert2Raw

Проекция Эккерта II.

d3.geoEckert3() · Исходный код, Примеры
d3.geoEckert3Raw

Проекция Эккерта III.

d3.geoEckert4() · Исходный код, Примеры
d3.geoEckert4Raw

Проекция Эккерта IV.

d3.geoEckert5() · Исходный код, Примеры
d3.geoEckert5Raw

Проекция Эккерта V.

d3.geoEckert6() · Исходный код, Примеры
d3.geoEckert6Raw

Проекция Эккерта VI.

d3.geoEisenlohr() · Исходный код, Примеры
d3.geoEisenlohrRaw(lambda, phi)

Конформная проекция Айзенлора.

d3.geoEquirectangular() · Исходный код [d3-geo], Примеры
d3.geoEquirectangularRaw

Проекция равнопрямоугольная (плакарре). Проекция Кассини — поперечный вид равнопрямоугольной проекции.

d3.geoFahey() · Исходный код, Примеры
d3.geoFaheyRaw

Псевдоцилиндрическая проекция Фахея.

d3.geoFoucaut() · Исходный код, Примеры
d3.geoFoucautRaw

Стереографическая эквивалентная проекция Фуко.

d3.geoFoucautSinusoidal() · Исходный код, Примеры
d3.geoFoucautSinusoidalRaw

Синусоидальная проекция Фуко, равноплощадная средневзвешенная проекция синусоидальной и цилиндрической проекции Ламберта.

foucautSinusoidal.alpha([alpha])

Относительный вес цилиндрической проекции. По умолчанию 0,5.

d3.geoGilbert([type]) · Исходный код, Примеры

Перспективная проекция с двумя мирами Гильберта. Оборачивает экземпляр указанного типа проекции; если не указано, по умолчанию d3.geoOrthographic.

d3.geoGingery() · Исходный код, Примеры
d3.geoGingeryRaw(rho, lobes)

Проекция мира, ориентированная на США, по аналогии с эпохой самолетов Крама. Примечание: требуется обрезка до сферы.

gingery.radius([radius]) · Исходный код

По умолчанию 30°.

gingery.lobes([lobes]) · Исходный код

По умолчанию 6.

d3.geoGinzburg4() · Исходный код, Примеры
d3.geoGinzburg4Raw

Проекция Гинзбурга IV.

d3.geoGinzburg5() · Исходный код, Примеры
d3.geoGinzburg5Raw

Проекция Гинзбурга V.

d3.geoGinzburg6() · Исходный код, Примеры
d3.geoGinzburg6Raw

Проекция Гинзбурга VI.

d3.geoGinzburg8() · Исходный код, Примеры
d3.geoGinzburg8Raw

Проекция Гинзбурга VIII.

d3.geoGinzburg9() · Исходный код, Примеры
d3.geoGinzburg9Raw

Проекция Гинзбурга IX.

d3.geoGnomonic() · Исходный код [d3-geo], Примеры
d3.geoGnomonicRaw

Гномоническая проекция.

d3.geoGringorten() · Исходный код, Примеры
d3.geoGringortenRaw

Проекция Грингортена с равными площадями, перестроенная так, чтобы каждый полушар занимал весь квадрат.

d3.geoGuyou() · Источник, Примеры
d3.geoGuyouRaw

Проекция полушарий Гую в квадрате. Проекция приписывается Пёрсу.

d3.geoHammer() · Источник, Примеры
d3.geoHammerRaw(A, B)

Проекция Гаммера. В зависимости от выбранного коэффициента и аспекта, также известна как Эккерт–Грейфендорф, четвертичная ауталическая и Бриземайстер.

hammer.coefficient([coefficient]) · Источник

По умолчанию 2.

d3.geoHammerRetroazimuthal() · Источник, Примеры
d3.geoHammerRetroazimuthalRaw(phi0)

Проекция Гаммера обратного азимута. Примечание: требует обрезки до сферы.

hammerRetroazimuthal.parallel([parallel])

По умолчанию 45°.

d3.geoHealpix() · Источник, Примеры
d3.geoHealpixRaw(lobes)

Проекция HEALPix: иерархическая проекция с равными площадями изоширотной пикселизации 2-сферы. В этой реализации параметр K фиксирован на 3. Примечание: требует обрезки до сферы.

healpix.lobes([lobes])

Если lobes указано, устанавливает число долей (параметр H в литературе) и возвращает эту проекцию. Если lobes не указано, возвращает текущее число долей, которое по умолчанию равно 4.

d3.geoHill() · Источник, Примеры
d3.geoHillRaw(K)

Проекция Хилла эвклическая псевдоконическая и с равными площадями.

hill.ratio([ratio])

По умолчанию 1. При коэффициенте 0 эта проекция становится Мауэр № 73. По мере приближения к ∞ проекция сходится к Эккерт IV.

d3.geoHomolosine() · Источник, Примеры
d3.geoHomolosineRaw

Псевдоцилиндрическая проекция Гуда Гомолосина с равными площадями обычно представляется в прерванном виде.

d3.geoHufnagel() · Источник, Примеры
d3.geoHufnagelRaw

Настраиваемая группа псевдоцилиндрических проекций с равными площадями Герберта Хуфнагеля.

hufnagel.a([a])

hufnagel.b([b])

hufnagel.psiMax([psiMax])

hufnagel.ratio([ratio])

d3.geoHyperelliptical() · Источник, Примеры
d3.geoHyperellipticalRaw

Гиперэллиптическая проекция Уолдо Р. Тоблера — это семейство псевдоцилиндрических проекций с равными площадями. Параметры включают k, показатель степени суперэллипса (или кривой Ламе), определяющий форму меридианов (по умолчанию k = 2,5); alpha, который управляет весом цилиндрической проекции, которая усредняется с суперэллипсом (по умолчанию alpha = 0); и gamma, формирующий соотношение сторон (по умолчанию: gamma = 1,183136).

d3.geoKavrayskiy7() · Источник, Примеры
d3.geoKavrayskiy7Raw

Псевдоцилиндрическая проекция Каврайского VII.

d3.geoLagrange() · Источник, Примеры
d3.geoLagrangeRaw(n)

Конформная проекция Лагранжа.

lagrange.spacing([spacing])

По умолчанию 0,5.

d3.geoLarrivee() · Источник, Примеры
d3.geoLarriveeRaw

Проекция Лариве.

d3.geoLaskowski() · Источник, Примеры
d3.geoLaskowskiRaw

Проекция Ласковского трехоптимальная — одновременно минимизирует искажения расстояния, угла и площади.

d3.geoLittrow() · Источник, Примеры
d3.geoLittrowRaw

Проекция Литтрова — единственная конформная проекция обратного азимута. Обычно обрезается до географического охвата [[-90°, -60°], [90°, 60°]].

d3.geoLoximuthal() · Источник, Примеры
d3.geoLoximuthalRaw(phi0)

Проекция локсимутальная, «отличается тем, что локсодромы (румбовые линии) от одной выбранной центральной точки (пересечения центрального меридиана и центральной широты) отображаются как прямые линии, верные по азимуту от центра и «истинно масштабируемые»… Она не является проекцией с равными площадями или конформной».

loximuthal.parallel([parallel])

По умолчанию 40°.

d3.geoMercator() · Источник [d3-geo], Примеры
d3.geoMercatorRaw

Сферическая проекция Меркатора.

d3.geoMiller() · Источник, Примеры
d3.geoMillerRaw

Цилиндрическая проекция Миллера — модифицированная проекция Меркатора.

d3.geoModifiedStereographic(coefficients, rotate) · Источник
d3.geoModifiedStereographicRaw(coefficients)

Семейство модифицированных стереографических проекций. По умолчанию угол обрезки для этих проекций равен 90°. Эти проекции не поддерживают projection.rotate: применяется фиксированное вращение, специфичное для заданных coefficients.

d3.geoModifiedStereographicAlaska() · Источник

Модифицированная стереографическая проекция для Аляски.

d3.geoModifiedStereographicGs48() · Источник

Модифицированная стереографическая проекция для прилегающих к США штатов.

d3.geoModifiedStereographicGs50() · Источник

Проекция модифицированного стереографического типа для Соединенных Штатов, включая Аляску и Гавайи. Обычно обрезается до географического охватывающего диапазона [[-180°, 15°], [-50°, 75°]].

d3.geoModifiedStereographicMiller() · Источник, Примеры

Проекция модифицированного стереографического типа для Европы и Африки. Обычно обрезается до географического охватывающего диапазона [[-40°, -40°], [80°, 80°]].

d3.geoModifiedStereographicLee() · Источник, Примеры

Проекция модифицированного стереографического типа для Тихого океана.

d3.geoMollweide() · Источник, Примеры
d3.geoMollweideRaw

Равноплощадная псевдоцилиндрическая проекция Моллвейде. Косое изображение известно как проекция Атлантис. Также широко известна прерванная проекция Моллвейде.

d3.geoMtFlatPolarParabolic() · Источник, Примеры
d3.geoMtFlatPolarParabolicRaw

Псевдоцилиндрическая проекция МакБрайда–Томаса плоского полюса параболического типа с сохранением площади.

d3.geoMtFlatPolarQuartic() · Источник, Примеры
d3.geoMtFlatPolarQuarticRaw

Псевдоцилиндрическая проекция МакБрайда–Томаса плоского полюса четвертой степени с сохранением площади.

d3.geoMtFlatPolarSinusoidal() · Источник, Примеры
d3.geoMtFlatPolarSinusoidalRaw

Псевдоцилиндрическая проекция МакБрайда–Томаса плоского полюса синусоидального типа с сохранением площади.

d3.geoNaturalEarth1() · Источник [d3-geo], Примеры
d3.geoNaturalEarth1Raw

Проекция Natural Earth.

d3.geoNaturalEarth2() · Источник, Примеры
d3.geoNaturalEarth2Raw

Проекция Natural Earth II. По сравнению с Natural Earth, она немного выше и округлая.

d3.geoNellHammer() · Источник, Примеры
d3.geoNellHammerRaw

Проекция Нелла–Хаммера.

d3.geoNicolosi() · Источник, Примеры
d3.geoNicolosiRaw

Сферическая проекция Николози.

d3.geoOrthographic() · Источник [d3-geo], Примеры
d3.geoOrthographicRaw

Проекция ортографического типа.

d3.geoPatterson() · Источник, Примеры
d3.geoPattersonRaw

Проекция цилиндрического типа Паттерсона.

d3.geoPolyconic() · Источник, Примеры
d3.geoPolyconicRaw

Американская поликоническая проекция.

d3.geoRectangularPolyconic() · Источник, Примеры
d3.geoRectangularPolyconicRaw(phi0)

Прямоугольная (War Office) поликоническая проекция.

rectangularPolyconic.parallel([parallel])

По умолчанию 0°.

d3.geoRobinson() · Источник, Примеры
d3.geoRobinsonRaw

Проекция Робинсона.

d3.geoSatellite() · Источник, Примеры
d3.geoSatelliteRaw(P, omega)

Проекция спутникового типа (наклонной перспективы).

satellite.tilt([tilt])

По умолчанию 0°.

satellite.distance([distance])

Расстояние от центра сферы до точки обзора, как доля радиуса сферы; по умолчанию 2,0. Рекомендуемый максимальный угол обрезки для заданного расстояния – это acos(1 / расстояние), преобразованное в градусы. Если также применяется наклон, может потребоваться более консервативная обрезка. Для точной обрезки необходима развивающаяся система географических проекций; см. обзор спутников.

d3.geoSinusoidal() · Источник, Примеры
d3.geoSinusoidalRaw

Проекция синусоидального типа.

d3.geoSinuMollweide() · Источник, Примеры
d3.geoSinuMollweideRaw

Проекция Аллена К. Фильбрика Сину-Моллвейде. См. также прерванный вариант.

d3.geoStereographic() · Источник [d3-geo], Примеры
d3.geoStereographicRaw

Проекция стереографического типа.

d3.geoTimes() · Источник, Примеры
d3.geoTimesRaw

Проекция Джона Мира Times.

d3.geoTransverseMercator() · Источник [d3-geo], Примеры
d3.geoTransverseMercatorRaw

Сферическая поперечная проекция Меркатора.

d3.geoTwoPointAzimuthal(point0, point1) · Источник
d3.geoTwoPointAzimuthalRaw(d)

Проекция с двумя точками азимута «показывает правильные азимуты (но не расстояния) от любой из двух точек до любой другой точки. [Она может] использоваться для определения местоположения корабля в море, если известны точные координаты двух радиопередатчиков и направление корабля на передатчики». Данная проекция не поддерживает projection.rotate, так как поворот фиксируется двумя указанными точками.

d3.geoTwoPointAzimuthalUsa() · Источник

Проекция двуточечной азимутальной равнорасстояной с точками [-158°, 21.5°] и [-77°, 39°], приблизительно представляющими Гонолулу, Гавайи, и Вашингтон, ОК.

d3.geoTwoPointEquidistant(point0, point1) · Источник
d3.geoTwoPointEquidistantRaw(z0)

Проекция двуточечной равнорасстоянной. Эта проекция не поддерживает projection.rotate, так как поворот фиксируется двумя заданными точками. Примечание: для отображения всей Земли эта проекция требует обрезки до сферических полигонов (пример).

d3.geoTwoPointEquidistantUsa() · Источник

Проекция двуточечной азимутальной равнорасстояной с точками [-158°, 21.5°] и [-77°, 39°], приблизительно представляющими Гонолулу, Гавайи, и Вашингтон, ОК.

d3.geoVanDerGrinten() · Источник, Примеры
d3.geoVanDerGrintenRaw

Проекция Ван дер Грётена.

d3.geoVanDerGrinten2() · Источник, Примеры
d3.geoVanDerGrinten2Raw

Проекция Ван дер Грётена II.

d3.geoVanDerGrinten3() · Источник, Примеры
d3.geoVanDerGrinten3Raw

Проекция Ван дер Грётена III.

d3.geoVanDerGrinten4() · Источник, Примеры
d3.geoVanDerGrinten4Raw

Проекция Ван дер Грётена IV.

d3.geoWagner() · Источник, Примеры
d3.geoWagnerRaw

Проекция Вагнера настраиваема: значения по умолчанию дают проекцию Вагнера VIII.

wagner.poleline([poleline])

По умолчанию 65°.

wagner.parallels([parallels])

По умолчанию 60°.

wagner.inflation([inflation])

По умолчанию 20.

wagner.ratio([ratio])

По умолчанию 200.

d3.geoWagner4() · Источник, Примеры
d3.geoWagner4Raw

Проекция Вагнера IV, также известная как Putniṇš P2´.

d3.geoWagner6() · Источник, Примеры
d3.geoWagner6Raw

Проекция Вагнера VI.

d3.geoWagner7() · Источник, Примеры

Проекция Вагнера VII.

d3.geoWiechel() · Источник, Примеры
d3.geoWiechelRaw

Проекция Вичеля.

d3.geoWinkel3() · Источник, Примеры
d3.geoWinkel3Raw

Проекция Винкеля трипель.

Перерывистые проекции

d3.geoInterrupt(project, lobes) · Источник, Примеры

Определяет новую прерывистую проекцию для заданной функции сырой проекции project и заданного массива lobes. Массив lobes содержит два элемента, представляющие полудоли для северного и южного полушарий соответственно. Каждая полудоля является массивом треугольников, где каждый треугольник представлен тремя точками (в градусах): начальной, средней и конечной. Например, доли в проекции Гуда прерывистая равновеликая определены как:

[
  [
    [[-180,   0], [-100,  90], [ -40,   0]],
    [[ -40,   0], [  30,  90], [ 180,   0]]
  ],
  [
    [[-180,   0], [-160, -90], [-100,   0]],
    [[-100,   0], [ -60, -90], [ -20,   0]],
    [[ -20,   0], [  20, -90], [  80,   0]],
    [[  80,   0], [ 140, -90], [ 180,   0]]
  ]
]

Примечание: для прерывистых проекций обычно требуется обрезка до сферы.

interrupted.lobes([lobes]) · Источник

Если lobes указан, устанавливает новый массив полудолей и возвращает эту проекцию; см. d3.geoInterrupt для получения подробностей о формате массива полудолей. Если lobes не указан, возвращает текущий массив полудолей.

d3.geoInterruptedHomolosine() · Источник, Примеры

Прерывистая равновеликая проекция Гуда. Её океанцентричный аспект также хорошо известен.

d3.geoInterruptedSinusoidal() · Источник, Примеры

Прерывистая проекция синусоидальная с асимметричными границами долей, которые подчеркивают сушу над океанами, по шведскому Nordisk Världs Atlas, воспроизведенному C.A. Furuti.

d3.geoInterruptedBoggs() · Источник, Примеры

Прерывистая эуморфная проекция Боггса.

d3.geoInterruptedSinuMollweide() · Источник, Примеры

Прерывистая проекция сину-Моллвейде Алана К. Фильбрика.

d3.geoInterruptedMollweide() · Источник, Примеры

Прерывистая проекция Моллвейде Гуда.

d3.geoInterruptedMollweideHemispheres() · Источник, Примеры

Проекция Моллвейде, прерывистая на две (равновеликие) полусферы.

d3.geoInterruptedQuarticAuthalic() · Источник, Примеры

Прерывистая проекция четвертичной равновеликой на две полусферы.

Полиэдрические проекции

d3.geoPolyhedral(root, face) · Источник

Определяет новую полиэдрическую проекцию. root — это остовная структура узлов полигональных граней; каждому узлу назначена матрица преобразования node.transform. Функция face возвращает соответствующий узел для заданных lambda и phi в радианах. Используйте projection.angle, чтобы задать ориентацию карты (значение по умолчанию angle, -30°, может измениться в следующей основной версии).

d3.geoPolyhedralButterfly() · Source, Примеры

Проекция бабочки гномонической.

d3.geoPolyhedralCollignon() · Source, Примеры

Проекция бабочки Коллингона.

d3.geoPolyhedralWaterman() · Source, Примеры

Проекция бабочки Стивена Уотермена.

Проекции Квинтунциал

d3.geoQuincuncial(project) · Source

Определяет новую проекцию квинтунциал для указанной функции исходной проекции project. По умолчанию угол поворота равен [-90°, -90°, 45°], а угол обрезки — 180° - ε.

d3.geoGringortenQuincuncial() · Source

Квадратная равноплощадная проекция Грингортена.

d3.geoPeirceQuincuncial() · Source

Проекция Peirce quincuncial — это форма квинтунциал проекции Гуйо.

Преобразования

d3.geoProject(object, projection) · Source

Проектирует указанный объект GeoJSON object с помощью указанной проекции, возвращая поверхностную копию указанного объекта GeoJSON object с проецированными координатами. Обычно входные координаты являются сферическими, а выходные — плоскими, но проекция также может быть произвольным геометрическим преобразованием.

См. также geoproject.

d3.geoStitch(object) · Source

Возвращает поверхностную копию указанного объекта GeoJSON object, удаляя антимеридианные и полярные срезы, и заменяя прямые отрезки Картезианских линий геодезическими отрезками. Входной объект object должен иметь координаты долготы и широты в десятичных градусах по RFC 7946. Вырезание антимеридиана, при необходимости, можно затем повторно применить после поворота к желаемому виду проекции.

См. также geostitch.

d3.geoQuantize(object, digits) · Source

Возвращает поверхностную копию указанного объекта GeoJSON object, округляя координаты x и y в соответствии с number.toFixed. Обычно это делается после проектирования.

См. также geoproject --precision и geo2svg --precision.

Справочник командной строки

geo2svg

geo2svg [options…] [file] · Source

Преобразует указанный файл GeoJSON file в SVG. С --newline-delimited, каждое входное свойство отображается как отдельный элемент path; в противном случае генерируется единственный элемент path.

По умолчанию, SVG's заливка установлена в none, а штрих — в черный цвет. По умолчанию радиус точки равен 4,5. Чтобы переопределить эти значения для каждого объекта, следующие свойства объекта GeoJSON будут перенесены в атрибуты:

• fill
• fill-rule (или fillRule)
• fill-opacity (или fillOpacity)
• stroke
• stroke-width (или strokeWidth)
• stroke-linecap (или strokeLinecap)
• stroke-linejoin (или strokeLinejoin)
• stroke-miterlimit (или strokeMiterlimit)
• stroke-dasharray (или strokeDasharray)
• stroke-dashoffset (или strokeDashoffset)
• stroke-opacity (или strokeOpacity)
• point-radius (или pointRadius)

Если у объекта есть id, элемент path будет иметь соответствующий атрибут id. Если у объекта есть свойство title, элемент path будет иметь элемент title со соответствующим значением. Пример атрибутов на объект смотрите на этой карте плотности населения Калифорнии.

Примечание: атрибуты на объект наиболее полезны в сочетании с newline-delimited вводом, так как в противном случае сгенерированный SVG содержит только один элемент path. Чтобы динамически задавать эти свойства, передайте ввод через ndjson-map.

geo2svg -h
geo2svg --help

Выводит информацию об использовании.

geo2svg -V
geo2svg --version

Выводит номер версии.

geo2svg -o file
geo2svg --out file

Указывает имя выходного файла. По умолчанию — «-» для стандартного вывода.

geo2svg -w value
geo2svg --width value

Указывает ширину вывода. По умолчанию 960.

geo2svg -h value
geo2svg --height value

Указывает высоту вывода. По умолчанию 500.

geo2svg -p value
geo2svg --precision value

Уменьшает точность для уменьшения размера выходных файлов. По умолчанию шесть знаков после запятой. Смотрите также d3.geoQuantize.

geo2svg --fill value

Указывает цвет заливки вывода по умолчанию. По умолчанию none.

geo2svg --stroke value

Указывает цвет штриха вывода по умолчанию. По умолчанию черный.

geo2svg --r value
geo2svg --radius value

Указывает радиус точки вывода по умолчанию. По умолчанию 4,5.

geo2svg -n
geo2svg --newline-delimited

Принимает newline-delimited JSON как входные данные, по одному элементу на строке.

geograticule

geograticule [options…] · Source

Генерирует GeoJSON-сетку. См. также d3.geoGraticule.

geograticule -h
geograticule --help

Выводит информацию об использовании.

geograticule -V
geograticule --version

Выводит номер версии.

geograticule -o file
geograticule --out file

Указывает имя выходного файла. По умолчанию — «-» для стандартного вывода.

geograticule --extent value

Устанавливает диапазон сетки.

geograticule --extent-minor value

Устанавливает меньший диапазон сетки.

geograticule --extent-major value

Устанавливает больший диапазон сетки.

geograticule --step value

Устанавливает шаг сетки.

geograticule --step-minor value

Устанавливает меньший шаг сетки.

geograticule --step-major value

Устанавливает больший шаг сетки.

geograticule --precision value

Устанавливает точность сетки.

geoproject

geoproject [options…] projection [file] · Source

Проектирует объект GeoJSON в указанном входном файле с помощью указанной проекции, выводя новый объект GeoJSON object с проецированными координатами. Например, чтобы спроектировать стандартный вход WGS 84 с помощью d3.geoAlbersUsa:

geoproject 'd3.geoAlbersUsa()' us.json \
  > us-albers.json

Для геометрии, пересекающей антимеридиан или окружающей полюс, необходимо сначала передать входные данные через geostitch:

geostitch world.json \
  | geoproject 'd3.geoMercator()' \
  > world-mercator.json

Обычно входные координаты являются сферическими, а выходные — плоскими, но проекция также может быть произвольной геометрической трансформацией. Например, для инвертирования оси y стандартной системы пространственных координат, такой как Калифорнийская Альберс (EPSG:3310) и её подгонки к области просмотра 960×500:

shp2json planar.shp \
  | geoproject 'd3.geoIdentity().reflectY(true).fitSize([960, 500], d)' \
  > planar.json

См. также d3.geoProject и d3.geoIdentity.

geoproject -h
geoproject --help

Вывод информации об использовании.

geoproject -V
geoproject --version

Вывод номера версии.

geoproject -o файл
geoproject --out файл

Указывает имя выходного файла. По умолчанию — «-» для стандартного вывода.

geoproject -p значение
geoproject --precision значение

Уменьшает точность для получения меньших выходных файлов. См. также d3.geoQuantize.

geoproject -n
geoproject --newline-delimited

Принимает JSON с разделителями новой строки в качестве входных данных, с одним элементом на строке, и генерирует JSON с разделителями новой строки на выходе.

geoproject -r [имя=]значение
geoproject --require [имя=]значение

Требует указанный модуль, делая его доступным для использования в любых выражениях, используемых этой командой. Загруженный модуль доступен как символ имя. Если имя не указано, оно по умолчанию равно модулю. (Если модуль не является допустимым идентификатором, вы должны указать имя.) Например, для перепроектирования мира на проекцию Airocean:

geoproject --require d3=d3-geo-polygon 'd3.geoAirocean()' world.geojson

Требуемый модуль разрешается относительно текущего каталога. Если модуль не найден при обычном разрешении, также ищется глобальный корень npm, позволяя требовать глобально установленных модулей из командной строки.

Можно потребовать несколько модулей, повторив этот параметр.

geoquantize

geoquantize [параметры…] [файл] · Исходный код

Читает объект GeoJSON из указанного входного файла и выводит новый объект GeoJSON с координатами, уменьшенными до точности. Те же параметры, что и у geoproject.

geoquantize us.json --precision 3 \
  > us-quantized.json

geostitch

geostitch [параметры…] [файл] · Исходный код

Сшивает объект GeoJSON в указанном входном файле, удаляя антимеридианные и полярные разрезы и заменяя прямые картезианские отрезки прямых на геодезические отрезки. Входной объект должен иметь координаты долготы и широты в десятичных градусах согласно RFC 7946. Обрезка антимеридиана, при необходимости, может быть повторно применена после поворота к желаемому виду проекции.

См. geoproject для примера. См. также d3.geoStitch.

geostitch -h
geostitch --help

Вывод информации об использовании.

geostitch -V
geostitch --version

Вывод номера версии.

geostitch -o файл
geostitch --out файл

Указывает имя выходного файла. По умолчанию — «-» для стандартного вывода.

geostitch -n
geostitch --newline-delimited

Принимает JSON с разделителями новой строки в качестве входных данных, с одним элементом на строке, и генерирует JSON с разделителями новой строки на выходе.