d3-geo-проекция
Расширенные географические проекции для d3-geo. См. Командная линия картографии для введения.
Установка
Если вы используете NPM, npm install d3-geo-projection. В противном случае, загрузите последнюю версию. Вы также можете загрузить напрямую с d3js.org как отдельную библиотеку. Поддерживаются среды AMD, CommonJS и vanilla. В среде vanilla экспортируется глобальная переменная d3:
<script src="https://d3js.org/d3-array.v2.min.js"></script> <script src="https://d3js.org/d3-geo.v2.min.js"></script> <script src="https://d3js.org/d3-geo-projection.v3.min.js"></script> <script> var aitoff = 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
Проекция Аиттoффа.
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]) · Исходный код
Если 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.
END_OF_DOCUMENT_MARKER 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() · Source, Примеры
d3.geoHealpixRaw(lobes)
Проекция HEALPix: иерархическая равноплощадная изоширотная пикселизация сферы. В этой реализации параметр K фиксирован в значении 3. Примечание: требуется обрезка до сферы.
healpix.lobes([lobes])
Если lobes указан, устанавливает количество лопастей (параметр H в литературе) и возвращает эту проекцию. Если lobes не указан, возвращает текущее количество лопастей, по умолчанию равное 4.
d3.geoHill() · Source, Примеры
d3.geoHillRaw(K)
Проекция Хилла — псевдоконическая равноплощадная.
hill.ratio([ratio])
По умолчанию равно 1. При коэффициенте 0 эта проекция становится проекцией Мауэра № 73. По мере приближения к ∞ проекция сходится к проекции Эккерт IV.
d3.geoHomolosine() · Source, Примеры
d3.geoHomolosineRaw
Псевдоцилиндрическая равноплощадная проекция Гуда является обычно представлена в разрывной форме.
d3.geoHufnagel() · Source, Примеры
d3.geoHufnagelRaw
Настраиваемая серия псевдоцилиндрических равноплощадных проекций Герберта Хуфнагеля.
hufnagel.a([a])
hufnagel.b([b])
hufnagel.psiMax([psiMax])
hufnagel.ratio([ratio])
d3.geoHyperelliptical() · Source, Примеры
d3.geoHyperellipticalRaw
Гиперэллиптическая проекция Уолдо Р. Тоблера — это семейство равноплощадных псевдоцилиндрических проекций. Параметры включают k, показатель степени суперэллипса (или кривой Ламе), определяющей форму меридианов (по умолчанию k = 2,5); alpha, который управляет весом цилиндрической проекции, усреднённой с суперэллипсом (по умолчанию alpha = 0); и gamma, который формирует соотношение сторон (по умолчанию: gamma = 1,183136).
d3.geoKavrayskiy7() · Source, Примеры
d3.geoKavrayskiy7Raw
Псевдоцилиндрическая проекция Каврайского VII.
d3.geoLagrange() · Source, Примеры
d3.geoLagrangeRaw(n)
Конформная проекция Лагранжа.
lagrange.spacing([spacing])
По умолчанию 0,5.
d3.geoLarrivee() · Source, Примеры
d3.geoLarriveeRaw
Проекция Ларриве.
d3.geoLaskowski() · Source, Примеры
d3.geoLaskowskiRaw
Проекция Ласковского, три-оптимальная, одновременно минимизирующая искажения расстояния, угла и площади.
d3.geoLittrow() · Source, Примеры
d3.geoLittrowRaw
Проекция Литтрова — единственная конформная ретроазимутальная проекция карты. Обычно обрезается до географического охвата [[-90°, -60°], [90°, 60°]].
d3.geoLoximuthal() · Source, Примеры
d3.geoLoximuthalRaw(phi0)
Проекция локсомутальная «отличается тем, что локсодромы (румбовые линии) от одной выбранной центральной точки (пересечения центрального меридиана и центральной широты) отображаются как прямые линии, корректные по азимуту от центра, и имеют «истинную масштабную передачу»... Она не является равноплощадной проекцией и не является конформной.
loximuthal.parallel([parallel])
По умолчанию 40°.
d3.geoMercator() · Source [d3-geo], Примеры
d3.geoMercatorRaw
Сферическая проекция Меркатора.
d3.geoMiller() · Source, Примеры
d3.geoMillerRaw
Цилиндрическая проекция Миллера — модифицированная проекция Меркатора.
d3.geoModifiedStereographic(coefficients, rotate) · Source
d3.geoModifiedStereographicRaw(coefficients)
Семейство модифицированных стереографических проекций. Угол обрезки (clip angle) по умолчанию для этих проекций составляет 90°. Эти проекции не поддерживают projection.rotate: применяется фиксированное вращение, специфичное для заданных coefficients.
d3.geoModifiedStereographicAlaska() · Source
Модифицированная стереографическая проекция для Аляски.
d3.geoModifiedStereographicGs48() · Source
Модифицированная стереографическая проекция для прилегающих штатов США.
d3.geoModifiedStereographicGs50() · Source
Модифицированная стереографическая проекция для США, включая Аляску и Гавайи. Обычно обрезается до географического охвата [[-180°, 15°], [-50°, 75°]].
d3.geoModifiedStereographicMiller() · Source, Примеры
Модифицированная стереографическая проекция для Европы и Африки. Обычно обрезается до географического охвата [[-40°, -40°], [80°, 80°]].
d3.geoModifiedStereographicLee() · Source, Примеры
Модифицированная стереографическая проекция для Тихого океана.
d3.geoMollweide() · Source, Примеры
d3.geoMollweideRaw
Равноплощадная псевдоцилиндрическая проекция Моллвейде. Наклонный аспект известен как проекция Атлантиса. Также широко известна разрывная проекция Моллвейде Гуда.
d3.geoMtFlatPolarParabolic() · Source, Примеры
d3.geoMtFlatPolarParabolicRaw
Псевдоцилиндрическая равноплощадная проекция МакБрайда-Томаса плоского полярного параболического.
d3.geoMtFlatPolarQuartic() · Source, Примеры
d3.geoMtFlatPolarQuarticRaw
Псевдоцилиндрическая равноплощадная проекция МакБрайда-Томаса плоского полярного четвертого порядка.
d3.geoMtFlatPolarSinusoidal() · Source, Примеры
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)
Прямоугольная (военная) поликоническая проекция.
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 / расстояние) в градусах. Если также используется tilt, может потребоваться более консервативное ограничение. Для точной обрезки необходима разрабатываемая система географических проекций; см. справочник по спутниковой наглядности.
d3.geoSinusoidal() · Источник, Примеры
d3.geoSinusoidalRaw
Синусоидальная проекция.
d3.geoSinuMollweide() · Источник, Примеры
d3.geoSinuMollweideRaw
Проекция Сину-Мольвейде Алана К. Фильбрика. См. также разрывную форму.
d3.geoStereographic() · Источник [d3-geo], Примеры
d3.geoStereographicRaw
Стереографическая проекция.
d3.geoTimes() · Источник, Примеры
d3.geoTimesRaw
Проекция Таймс Джона Мира.
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() · Source, Примеры
d3.geoWagner6Raw
Проекция Вагнера VI.
d3.geoWagner7() · Source, Примеры
Проекция Вагнера VII.
d3.geoWiechel() · Source, Примеры
d3.geoWiechelRaw
Проекция Вичеля.
d3.geoWinkel3() · Source, Примеры
d3.geoWinkel3Raw
Проекция Винкеля Трипеля.
Прерванные проекции
d3.geoInterrupt(project, lobes) · Source, Примеры
Определяет новую прерванную проекцию для указанной функции исходной проекции 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]) · Source
Если lobes указано, устанавливает новый массив полулобов и возвращает эту проекцию; см. d3.geoInterrupt для получения подробной информации о формате массива полулобов. Если lobes не указано, возвращает текущий массив полулобов.
d3.geoInterruptedHomolosine() · Source, Примеры
Прерванная проекция гомолосины Гуда. Ее аспект, сосредоточенный на океанах, также хорошо известен.
d3.geoInterruptedSinusoidal() · Source, Примеры
Прерванная проекция синусоиды с асимметричными границами долей, подчеркивающими сушу над океанами, после шведского Nordisk Världs Atlas, воспроизведённого C.A. Furuti.
d3.geoInterruptedBoggs() · Source, Примеры
Прерванная проекция эйморфики Боггеса.
d3.geoInterruptedSinuMollweide() · Source, Примеры
Прерванная проекция сину-Мольвейде Алана К. Фильбрика.
d3.geoInterruptedMollweide() · Source, Примеры
Прерванная проекция Мольвейде Гуда.
d3.geoInterruptedMollweideHemispheres() · Source, Примеры
Проекция Мольвейде, прерванная на две (равновеликие) полусферы.
d3.geoInterruptedQuarticAuthalic() · Source, Примеры
Прерванная квадратичная автолическая проекция на две полусферы.
Многогранные проекции
d3.geoPolyhedral(root, face) · Source
Определяет новую многогранную проекцию. 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
Проекция Пёрса — квинтунциальное представление проекции Гуйу.
Преобразования
d3.geoProject(object, projection) · Source
Проецирует указанный объект GeoJSON с использованием указанной projection, возвращая поверхностную копию указанного объекта GeoJSON с проецированными координатами. Обычно входные координаты являются сферическими, а выходные — плоскими, но projection также может быть произвольным геометрическим преобразованием.
См. также geoproject.
d3.geoStitch(object) · Source
Возвращает поверхностную копию указанного объекта GeoJSON, удаляя разрезы антимеридиана и полюсов, а также заменяя прямые картезианские отрезки на геодезические. Входной object должен содержать координаты долготы и широты в десятичных градусах в соответствии с RFC 7946. Разрез по антимеридиану, если необходимо, затем можно повторно применить после поворота к желаемому аспекту проекции.
См. также geostitch.
d3.geoQuantize(object, digits) · Source
Возвращает поверхностную копию указанного объекта GeoJSON, округляя координаты x и y в соответствии с number.toFixed. Обычно это делается после проектирования.
См. также geoproject --precision и geo2svg --precision.
Справочник по командной строке
geo2svg
geo2svg [options…] [file] · Source
Преобразует указанный файл GeoJSON в SVG. С --newline-delimited, каждое входное свойство отображается как отдельный элемент элемент пути; в противном случае генерируется один элемент пути.
END_OF_DOCUMENT_MARKERПо умолчанию, у SVG задано заполнение 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 со соответствующим значением. Пример использования атрибутов для каждой геометрии см. на этой карте плотности населения Калифорнии.
Примечание: атрибуты для каждой геометрии наиболее полезны при использовании строкового ввода, так как в противном случае сгенерированный SVG содержит только один элемент path. Для динамической установки этих свойств используйте ndjson-map.
geo2svg -h
geo2svg --help
Выводит информацию об использовании.
geo2svg -V
geo2svg --version
Выводит номер версии.
geo2svg -o файл
geo2svg --out файл
Указывает имя выходного файла. По умолчанию – “-” для стандартного вывода.
geo2svg -w значение
geo2svg --width значение
Указывает ширину выходного изображения. По умолчанию 960.
geo2svg -h значение
geo2svg --height значение
Указывает высоту выходного изображения. По умолчанию 500.
geo2svg -p значение
geo2svg --precision значение
Уменьшает точность для создания меньших выходных файлов. По умолчанию шесть знаков после запятой. См. также d3.geoQuantize.
geo2svg --fill значение
Указывает цвет заливки по умолчанию. По умолчанию none.
geo2svg --stroke значение
Указывает цвет контура по умолчанию. По умолчанию черный.
geo2svg --r значение
geo2svg --radius значение
Указывает радиус точки по умолчанию. По умолчанию 4,5.
geo2svg -n
geo2svg --newline-delimited
Принимает newline-delimited JSON в качестве входных данных, по одной геометрии на строке.
географическая сетка
geograticule [параметры…] · Исходный код
Генерирует географическую сетку в формате GeoJSON. См. также d3.geoGraticule.
geograticule -h
geograticule --help
Выводит информацию об использовании.
geograticule -V
geograticule --version
Выводит номер версии.
geograticule -o файл
geograticule --out файл
Указывает имя выходного файла. По умолчанию – “-” для стандартного вывода.
geograticule --extent значение
Устанавливает объём сетки.
geograticule --extent-minor значение
Устанавливает меньший объём сетки.
geograticule --extent-major значение
Устанавливает больший объём сетки.
geograticule --step значение
Устанавливает шаг сетки.
geograticule --step-minor значение
Устанавливает меньший шаг сетки.
geograticule --step-major значение
Устанавливает больший шаг сетки.
geograticule --precision значение
Устанавливает точность сетки.
geoproject
geoproject [параметры…] проекция [файл] · Исходный код
Проектирует геообъект GeoJSON из указанного входного файла используя указанную проекцию, выводит новый объект GeoJSON с проецированными координатами. Например, для проектирования стандартных WGS 84 данных с помощью d3.geoAlbersUsa:
geoproject 'd3.geoAlbersUsa()' us.json \ > us-albers.json
Для геометрии, пересекающей антимеридиан или окружающую полюс, необходимо сначала передать входные данные через geostitch:
geostitch world.json \ | geoproject 'd3.geoMercator()' \ > world-mercator.json
Обычно входные координаты являются сферическими, а выходные – плоскими, но проекция также может быть любым геометрическим преобразованием. Например, для инвертирования оси y стандартной системы координат, такой как California Albers (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
Принимает newline-delimited JSON в качестве входных данных, по одной геометрии на строке, и генерирует newline-delimited 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
Принимает newline-delimited JSON в качестве входных данных, по одной геометрии на строке, и генерирует newline-delimited JSON в качестве выходных данных.
© 2010–2020 Michael Bostock
Licensed under the BSD License.
https://github.com/d3/d3-geo-projection