@math.gl/earth 0.0.0-stage → 5.0.0-alpha.19

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (269) hide show
  1. package/README.md +14 -2
  2. package/dist/geoid/create-geoid-from-grid.d.ts +15 -0
  3. package/dist/geoid/create-geoid-from-grid.d.ts.map +1 -0
  4. package/dist/geoid/create-geoid-from-grid.js +38 -0
  5. package/dist/geoid/create-geoid-from-grid.js.map +1 -0
  6. package/dist/geoid/geoid.d.ts +60 -0
  7. package/dist/geoid/geoid.d.ts.map +1 -0
  8. package/dist/geoid/geoid.js +261 -0
  9. package/dist/geoid/geoid.js.map +1 -0
  10. package/dist/geoid/index.cjs +727 -0
  11. package/dist/geoid/index.cjs.map +6 -0
  12. package/dist/geoid/index.d.ts +5 -0
  13. package/dist/geoid/index.d.ts.map +1 -0
  14. package/dist/geoid/index.js +7 -0
  15. package/dist/geoid/index.js.map +1 -0
  16. package/dist/geoid/parse-pgm.d.ts +12 -0
  17. package/dist/geoid/parse-pgm.d.ts.map +1 -0
  18. package/dist/geoid/parse-pgm.js +183 -0
  19. package/dist/geoid/parse-pgm.js.map +1 -0
  20. package/dist/index.cjs +2646 -0
  21. package/dist/index.cjs.map +6 -0
  22. package/dist/index.d.ts +4 -0
  23. package/dist/index.d.ts.map +1 -0
  24. package/dist/index.js +7 -0
  25. package/dist/index.js.map +1 -0
  26. package/dist/sun/astronomy.cjs +1729 -0
  27. package/dist/sun/astronomy.cjs.map +6 -0
  28. package/dist/sun/astronomy.d.ts +359 -0
  29. package/dist/sun/astronomy.d.ts.map +1 -0
  30. package/dist/sun/astronomy.js +181 -0
  31. package/dist/sun/astronomy.js.map +1 -0
  32. package/dist/sun/celestial.d.ts +4 -0
  33. package/dist/sun/celestial.d.ts.map +1 -0
  34. package/dist/sun/celestial.js +18 -0
  35. package/dist/sun/celestial.js.map +1 -0
  36. package/dist/sun/cloud-lighting.d.ts +49 -0
  37. package/dist/sun/cloud-lighting.d.ts.map +1 -0
  38. package/dist/sun/cloud-lighting.js +121 -0
  39. package/dist/sun/cloud-lighting.js.map +1 -0
  40. package/dist/sun/cloud-spectral.d.ts +3 -0
  41. package/dist/sun/cloud-spectral.d.ts.map +1 -0
  42. package/dist/sun/cloud-spectral.js +45 -0
  43. package/dist/sun/cloud-spectral.js.map +1 -0
  44. package/dist/sun/data/bright-stars.d.ts +3 -0
  45. package/dist/sun/data/bright-stars.d.ts.map +1 -0
  46. package/dist/sun/data/bright-stars.js +7015 -0
  47. package/dist/sun/data/bright-stars.js.map +1 -0
  48. package/dist/sun/data/sunlight.d.ts +2 -0
  49. package/dist/sun/data/sunlight.d.ts.map +1 -0
  50. package/dist/sun/data/sunlight.js +970 -0
  51. package/dist/sun/data/sunlight.js.map +1 -0
  52. package/dist/sun/index.cjs +1744 -0
  53. package/dist/sun/index.cjs.map +6 -0
  54. package/dist/sun/index.d.ts +23 -0
  55. package/dist/sun/index.d.ts.map +1 -0
  56. package/dist/sun/index.js +17 -0
  57. package/dist/sun/index.js.map +1 -0
  58. package/dist/sun/moon-appearance.d.ts +25 -0
  59. package/dist/sun/moon-appearance.d.ts.map +1 -0
  60. package/dist/sun/moon-appearance.js +50 -0
  61. package/dist/sun/moon-appearance.js.map +1 -0
  62. package/dist/sun/moon-sky-brightness.d.ts +7 -0
  63. package/dist/sun/moon-sky-brightness.d.ts.map +1 -0
  64. package/dist/sun/moon-sky-brightness.js +50 -0
  65. package/dist/sun/moon-sky-brightness.js.map +1 -0
  66. package/dist/sun/moon.d.ts +26 -0
  67. package/dist/sun/moon.d.ts.map +1 -0
  68. package/dist/sun/moon.js +74 -0
  69. package/dist/sun/moon.js.map +1 -0
  70. package/dist/sun/moonlight.d.ts +23 -0
  71. package/dist/sun/moonlight.d.ts.map +1 -0
  72. package/dist/sun/moonlight.js +48 -0
  73. package/dist/sun/moonlight.js.map +1 -0
  74. package/dist/sun/planet-position.d.ts +63 -0
  75. package/dist/sun/planet-position.d.ts.map +1 -0
  76. package/dist/sun/planet-position.js +189 -0
  77. package/dist/sun/planet-position.js.map +1 -0
  78. package/dist/sun/planet-times.d.ts +41 -0
  79. package/dist/sun/planet-times.d.ts.map +1 -0
  80. package/dist/sun/planet-times.js +86 -0
  81. package/dist/sun/planet-times.js.map +1 -0
  82. package/dist/sun/planet-visibility.d.ts +39 -0
  83. package/dist/sun/planet-visibility.d.ts.map +1 -0
  84. package/dist/sun/planet-visibility.js +82 -0
  85. package/dist/sun/planet-visibility.js.map +1 -0
  86. package/dist/sun/planets.cjs +411 -0
  87. package/dist/sun/planets.cjs.map +6 -0
  88. package/dist/sun/planets.d.ts +7 -0
  89. package/dist/sun/planets.d.ts.map +1 -0
  90. package/dist/sun/planets.js +7 -0
  91. package/dist/sun/planets.js.map +1 -0
  92. package/dist/sun/sky-brightness.d.ts +32 -0
  93. package/dist/sun/sky-brightness.d.ts.map +1 -0
  94. package/dist/sun/sky-brightness.js +108 -0
  95. package/dist/sun/sky-brightness.js.map +1 -0
  96. package/dist/sun/sky-events.d.ts +16 -0
  97. package/dist/sun/sky-events.d.ts.map +1 -0
  98. package/dist/sun/sky-events.js +60 -0
  99. package/dist/sun/sky-events.js.map +1 -0
  100. package/dist/sun/sky-globe.d.ts +15 -0
  101. package/dist/sun/sky-globe.d.ts.map +1 -0
  102. package/dist/sun/sky-globe.js +51 -0
  103. package/dist/sun/sky-globe.js.map +1 -0
  104. package/dist/sun/sky-lighting.d.ts +27 -0
  105. package/dist/sun/sky-lighting.d.ts.map +1 -0
  106. package/dist/sun/sky-lighting.js +88 -0
  107. package/dist/sun/sky-lighting.js.map +1 -0
  108. package/dist/sun/sky-observer.d.ts +22 -0
  109. package/dist/sun/sky-observer.d.ts.map +1 -0
  110. package/dist/sun/sky-observer.js +57 -0
  111. package/dist/sun/sky-observer.js.map +1 -0
  112. package/dist/sun/sky-time.d.ts +9 -0
  113. package/dist/sun/sky-time.d.ts.map +1 -0
  114. package/dist/sun/sky-time.js +38 -0
  115. package/dist/sun/sky-time.js.map +1 -0
  116. package/dist/sun/star-galactic.d.ts +15 -0
  117. package/dist/sun/star-galactic.d.ts.map +1 -0
  118. package/dist/sun/star-galactic.js +98 -0
  119. package/dist/sun/star-galactic.js.map +1 -0
  120. package/dist/sun/star-milky-way.d.ts +14 -0
  121. package/dist/sun/star-milky-way.d.ts.map +1 -0
  122. package/dist/sun/star-milky-way.js +32 -0
  123. package/dist/sun/star-milky-way.js.map +1 -0
  124. package/dist/sun/star-render.d.ts +38 -0
  125. package/dist/sun/star-render.d.ts.map +1 -0
  126. package/dist/sun/star-render.js +98 -0
  127. package/dist/sun/star-render.js.map +1 -0
  128. package/dist/sun/star-types.d.ts +60 -0
  129. package/dist/sun/star-types.d.ts.map +1 -0
  130. package/dist/sun/star-types.js +5 -0
  131. package/dist/sun/star-types.js.map +1 -0
  132. package/dist/sun/starfield.d.ts +13 -0
  133. package/dist/sun/starfield.d.ts.map +1 -0
  134. package/dist/sun/starfield.js +86 -0
  135. package/dist/sun/starfield.js.map +1 -0
  136. package/dist/sun/stars.cjs +7519 -0
  137. package/dist/sun/stars.cjs.map +6 -0
  138. package/dist/sun/stars.d.ts +26 -0
  139. package/dist/sun/stars.d.ts.map +1 -0
  140. package/dist/sun/stars.js +188 -0
  141. package/dist/sun/stars.js.map +1 -0
  142. package/dist/sun/suncalc.d.ts +26 -0
  143. package/dist/sun/suncalc.d.ts.map +1 -0
  144. package/dist/sun/suncalc.js +94 -0
  145. package/dist/sun/suncalc.js.map +1 -0
  146. package/dist/sun/sunlight.d.ts +25 -0
  147. package/dist/sun/sunlight.d.ts.map +1 -0
  148. package/dist/sun/sunlight.js +76 -0
  149. package/dist/sun/sunlight.js.map +1 -0
  150. package/dist/timezone/index.cjs +205 -0
  151. package/dist/timezone/index.cjs.map +6 -0
  152. package/dist/timezone/index.d.ts +6 -0
  153. package/dist/timezone/index.d.ts.map +1 -0
  154. package/dist/timezone/index.js +8 -0
  155. package/dist/timezone/index.js.map +1 -0
  156. package/dist/timezone/instant.d.ts +4 -0
  157. package/dist/timezone/instant.d.ts.map +1 -0
  158. package/dist/timezone/instant.js +20 -0
  159. package/dist/timezone/instant.js.map +1 -0
  160. package/dist/timezone/local-date-time.d.ts +4 -0
  161. package/dist/timezone/local-date-time.d.ts.map +1 -0
  162. package/dist/timezone/local-date-time.js +34 -0
  163. package/dist/timezone/local-date-time.js.map +1 -0
  164. package/dist/timezone/lookup-async.d.ts +3 -0
  165. package/dist/timezone/lookup-async.d.ts.map +1 -0
  166. package/dist/timezone/lookup-async.js +14 -0
  167. package/dist/timezone/lookup-async.js.map +1 -0
  168. package/dist/timezone/lookup.cjs +83 -0
  169. package/dist/timezone/lookup.cjs.map +6 -0
  170. package/dist/timezone/lookup.d.ts +3 -0
  171. package/dist/timezone/lookup.d.ts.map +1 -0
  172. package/dist/timezone/lookup.js +18 -0
  173. package/dist/timezone/lookup.js.map +1 -0
  174. package/dist/timezone/temporal.cjs +5696 -0
  175. package/dist/timezone/temporal.cjs.map +6 -0
  176. package/dist/timezone/temporal.d.ts +9 -0
  177. package/dist/timezone/temporal.d.ts.map +1 -0
  178. package/dist/timezone/temporal.js +60 -0
  179. package/dist/timezone/temporal.js.map +1 -0
  180. package/dist/timezone/timezone-label.d.ts +5 -0
  181. package/dist/timezone/timezone-label.d.ts.map +1 -0
  182. package/dist/timezone/timezone-label.js +27 -0
  183. package/dist/timezone/timezone-label.js.map +1 -0
  184. package/dist/timezone/timezone-offset.d.ts +3 -0
  185. package/dist/timezone/timezone-offset.d.ts.map +1 -0
  186. package/dist/timezone/timezone-offset.js +22 -0
  187. package/dist/timezone/timezone-offset.js.map +1 -0
  188. package/dist/timezone/types.d.ts +23 -0
  189. package/dist/timezone/types.d.ts.map +1 -0
  190. package/dist/timezone/types.js +5 -0
  191. package/dist/timezone/types.js.map +1 -0
  192. package/dist/timezone/vendor/temporal/runtime.d.ts +3 -0
  193. package/dist/timezone/vendor/temporal/runtime.d.ts.map +1 -0
  194. package/dist/timezone/vendor/temporal/runtime.js +5649 -0
  195. package/dist/timezone/vendor/temporal/runtime.js.map +1 -0
  196. package/dist/timezone/vendor/temporal/types.d.ts +939 -0
  197. package/dist/timezone/vendor/temporal/types.d.ts.map +1 -0
  198. package/dist/timezone/vendor/temporal/types.js +4 -0
  199. package/dist/timezone/vendor/temporal/types.js.map +1 -0
  200. package/dist/timezone/vendor/tz-lookup/runtime.d.ts +3 -0
  201. package/dist/timezone/vendor/tz-lookup/runtime.d.ts.map +1 -0
  202. package/dist/timezone/vendor/tz-lookup/runtime.js +53 -0
  203. package/dist/timezone/vendor/tz-lookup/runtime.js.map +1 -0
  204. package/geoid/data/README.md +28 -0
  205. package/geoid/data/geoid-egm96-hi.pgm +0 -0
  206. package/geoid/data/geoid-egm96-low.pgm +0 -0
  207. package/geoid/data/geoid-manifest.json +22 -0
  208. package/package.json +91 -4
  209. package/src/geoid/create-geoid-from-grid.ts +51 -0
  210. package/src/geoid/geoid.ts +297 -0
  211. package/src/geoid/index.ts +8 -0
  212. package/src/geoid/parse-pgm.ts +189 -0
  213. package/src/index.ts +7 -0
  214. package/src/sun/astronomy.ts +272 -0
  215. package/src/sun/celestial.ts +22 -0
  216. package/src/sun/cloud-lighting.ts +198 -0
  217. package/src/sun/cloud-spectral.ts +54 -0
  218. package/src/sun/data/bright-stars.ts +7024 -0
  219. package/src/sun/data/sunlight.ts +969 -0
  220. package/src/sun/index.ts +43 -0
  221. package/src/sun/moon-appearance.ts +81 -0
  222. package/src/sun/moon-sky-brightness.ts +64 -0
  223. package/src/sun/moon.ts +122 -0
  224. package/src/sun/moonlight.ts +88 -0
  225. package/src/sun/planet-position.ts +305 -0
  226. package/src/sun/planet-times.ts +142 -0
  227. package/src/sun/planet-visibility.ts +143 -0
  228. package/src/sun/planets.ts +18 -0
  229. package/src/sun/sky-brightness.ts +148 -0
  230. package/src/sun/sky-events.ts +66 -0
  231. package/src/sun/sky-globe.ts +72 -0
  232. package/src/sun/sky-lighting.ts +118 -0
  233. package/src/sun/sky-observer.ts +66 -0
  234. package/src/sun/sky-time.ts +42 -0
  235. package/src/sun/star-galactic.ts +111 -0
  236. package/src/sun/star-milky-way.ts +61 -0
  237. package/src/sun/star-render.ts +149 -0
  238. package/src/sun/star-types.ts +66 -0
  239. package/src/sun/starfield.ts +100 -0
  240. package/src/sun/stars.ts +260 -0
  241. package/src/sun/suncalc.ts +141 -0
  242. package/src/sun/sunlight.ts +112 -0
  243. package/src/timezone/index.ts +9 -0
  244. package/src/timezone/instant.ts +21 -0
  245. package/src/timezone/local-date-time.ts +40 -0
  246. package/src/timezone/lookup-async.ts +15 -0
  247. package/src/timezone/lookup.ts +21 -0
  248. package/src/timezone/temporal.ts +81 -0
  249. package/src/timezone/timezone-label.ts +30 -0
  250. package/src/timezone/timezone-offset.ts +21 -0
  251. package/src/timezone/types.ts +30 -0
  252. package/src/timezone/vendor/temporal/JSBI-LICENSE.txt +179 -0
  253. package/src/timezone/vendor/temporal/LICENSE.txt +16 -0
  254. package/src/timezone/vendor/temporal/README.md +23 -0
  255. package/src/timezone/vendor/temporal/runtime.ts +5070 -0
  256. package/src/timezone/vendor/temporal/types.ts +1146 -0
  257. package/src/timezone/vendor/tz-lookup/LICENSE.txt +119 -0
  258. package/src/timezone/vendor/tz-lookup/README.md +22 -0
  259. package/src/timezone/vendor/tz-lookup/runtime.ts +53 -0
  260. package/sun/LICENSE-BRIGHT-STARS +21 -0
  261. package/sun/LICENSE-HOSEK-WILKIE +30 -0
  262. package/sun/LICENSE-SUNCALC +24 -0
  263. package/timezone/data/LICENSE-ODbL.txt +538 -0
  264. package/timezone/data/README.md +50 -0
  265. package/timezone/data/manifest.json +37 -0
  266. package/timezone/data/timezone-geometry-hi.json +1 -0
  267. package/timezone/data/timezone-geometry-hi.parquet +0 -0
  268. package/timezone/data/timezone-geometry-low.json +1 -0
  269. package/timezone/data/timezone-geometry-low.parquet +0 -0
@@ -0,0 +1,26 @@
1
+ import type { StarRecord, StarPosition, StarPositionOptions } from "./star-types.js";
2
+ export type { StarRecord, StarPosition, StarPositionOptions } from "./star-types.js";
3
+ export { getGalacticAcceleration, getGalacticPotential, integrateGalacticOrbit } from "./star-galactic.js";
4
+ export { createMilkyWayBackground } from "./star-milky-way.js";
5
+ export type { MilkyWayBackground, MilkyWaySample } from "./star-milky-way.js";
6
+ /** Brightest 7,000 BSC5 sources, sorted by visual magnitude then HR number. */
7
+ export declare const STAR_CATALOG: readonly StarRecord[];
8
+ /** Metadata describes the fixed input selection, not a completeness guarantee at future epochs. */
9
+ export declare const STAR_CATALOG_INFO: Readonly<{
10
+ count: 7000;
11
+ epochYear: 2000;
12
+ faintestMagnitude: 6.3;
13
+ positiveParallaxes: 2797;
14
+ fullSpaceMotions: 2796;
15
+ sourceRevision: "abffb3b7223ae37e879b0a3ff5b49ad06aed5576";
16
+ source: "Yale Bright Star Catalog, fifth revised edition (1991), MIT-licensed Bretton Wade export";
17
+ }>;
18
+ /** Propagate a source to a numeric Julian epoch, without extrapolating Earth precession. */
19
+ export declare function getStarPosition(star: StarRecord, epochYear: number, options?: StarPositionOptions): StarPosition;
20
+ /** Batch propagation shares the observer's Galactic integration between all sources. */
21
+ export declare function getStarPositions(epochYear: number, options?: StarPositionOptions, catalog?: readonly StarRecord[]): StarPosition[];
22
+ /** Observed B-V to qualitative linear RGB. Missing B-V uses white. */
23
+ export declare function getStarColor(colorIndex: number | null): readonly number[];
24
+ export { getStarLayerData } from "./star-render.js";
25
+ export type { StarLayerOptions, StarLayerDatum } from "./star-render.js";
26
+ //# sourceMappingURL=stars.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"stars.d.ts","sourceRoot":"","sources":["../../src/sun/stars.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAC,UAAU,EAAE,YAAY,EAAE,mBAAmB,EAAC,wBAAqB;AAEhF,YAAY,EAAC,UAAU,EAAE,YAAY,EAAE,mBAAmB,EAAC,wBAAqB;AAChF,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,EACvB,2BAAwB;AACzB,OAAO,EAAC,wBAAwB,EAAC,4BAAyB;AAC1D,YAAY,EAAC,kBAAkB,EAAE,cAAc,EAAC,4BAAyB;AAEzE,+EAA+E;AAC/E,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAkB7C,CAAC;AAEF,mGAAmG;AACnG,eAAO,MAAM,iBAAiB;;;;;;;;EAQ5B,CAAC;AAIH,4FAA4F;AAC5F,wBAAgB,eAAe,CAC7B,IAAI,EAAE,UAAU,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,mBAAwB,GAChC,YAAY,CAYd;AAED,wFAAwF;AACxF,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,mBAAwB,EACjC,OAAO,GAAE,SAAS,UAAU,EAAiB,GAC5C,YAAY,EAAE,CAYhB;AAED,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,MAAM,EAAE,CAoBzE;AA2ID,OAAO,EAAC,gBAAgB,EAAC,yBAAsB;AAC/C,YAAY,EAAC,gBAAgB,EAAE,cAAc,EAAC,yBAAsB"}
@@ -0,0 +1,188 @@
1
+ // math.gl
2
+ // SPDX-License-Identifier: MIT
3
+ // SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
4
+ // SPDX-FileComment: Original implementation of tangent-basis space motion and Planck radiation.
5
+ // Catalog data and license: https://github.com/brettonw/YaleBrightStarCatalog
6
+ // B-V temperature approximation: https://arxiv.org/abs/1201.1809 (Ballesteros 2012).
7
+ import { STAR_CATALOG_DATA } from "./data/bright-stars.js";
8
+ import { equatorialToGalactic, galacticToEquatorial, integrateGalacticOrbit, KMS_TO_PC_PER_YEAR, SOLAR_POSITION, SOLAR_VELOCITY } from "./star-galactic.js";
9
+ export { getGalacticAcceleration, getGalacticPotential, integrateGalacticOrbit } from "./star-galactic.js";
10
+ export { createMilkyWayBackground } from "./star-milky-way.js";
11
+ /** Brightest 7,000 BSC5 sources, sorted by visual magnitude then HR number. */
12
+ export const STAR_CATALOG = Object.freeze(STAR_CATALOG_DATA.map(row => Object.freeze({
13
+ id: row[0],
14
+ designation: row[10],
15
+ epochYear: 2000,
16
+ rightAscension: row[1],
17
+ declination: row[2],
18
+ magnitude: row[3],
19
+ colorIndex: row[4],
20
+ properMotionRA: row[5],
21
+ properMotionDec: row[6],
22
+ parallax: row[7],
23
+ radialVelocity: row[8],
24
+ dynamicalParallax: row[9].startsWith('D'),
25
+ radialVelocityFlags: row[9].split('|')[1]
26
+ })));
27
+ /** Metadata describes the fixed input selection, not a completeness guarantee at future epochs. */
28
+ export const STAR_CATALOG_INFO = Object.freeze({
29
+ count: 7000,
30
+ epochYear: 2000,
31
+ faintestMagnitude: 6.3,
32
+ positiveParallaxes: 2797,
33
+ fullSpaceMotions: 2796,
34
+ sourceRevision: 'abffb3b7223ae37e879b0a3ff5b49ad06aed5576',
35
+ source: 'Yale Bright Star Catalog, fifth revised edition (1991), MIT-licensed Bretton Wade export'
36
+ });
37
+ const MAS_TO_RADIANS = Math.PI / (180 * 3600 * 1000);
38
+ const colorCache = new Map();
39
+ /** Propagate a source to a numeric Julian epoch, without extrapolating Earth precession. */
40
+ export function getStarPosition(star, epochYear, options = {}) {
41
+ validateOptions(epochYear, options);
42
+ const solar = options.model === 'galactic'
43
+ ? integrateGalacticOrbit(SOLAR_POSITION, SOLAR_VELOCITY, epochYear - 2000, options.maximumStepYears).position
44
+ : undefined;
45
+ return propagate(star, epochYear, options, solar);
46
+ }
47
+ /** Batch propagation shares the observer's Galactic integration between all sources. */
48
+ export function getStarPositions(epochYear, options = {}, catalog = STAR_CATALOG) {
49
+ validateOptions(epochYear, options);
50
+ const solar = options.model === 'galactic'
51
+ ? integrateGalacticOrbit(SOLAR_POSITION, SOLAR_VELOCITY, epochYear - 2000, options.maximumStepYears).position
52
+ : undefined;
53
+ return catalog.map(star => propagate(star, epochYear, options, solar));
54
+ }
55
+ /** Observed B-V to qualitative linear RGB. Missing B-V uses white. */
56
+ export function getStarColor(colorIndex) {
57
+ if (colorIndex !== null && !Number.isFinite(colorIndex))
58
+ throw new RangeError('B-V must be finite or null');
59
+ const cached = colorCache.get(colorIndex);
60
+ if (cached)
61
+ return cached;
62
+ if (colorCache.size >= 1024)
63
+ colorCache.clear();
64
+ let color = [1, 1, 1];
65
+ if (colorIndex !== null) {
66
+ const bv = Math.max(-0.4, Math.min(2, colorIndex));
67
+ const temperature = 4600 * (1 / (0.92 * bv + 1.7) + 1 / (0.92 * bv + 0.62));
68
+ // Three broad spectral samples; this is a rendering tint, not calibrated sRGB photometry.
69
+ const planck = (wavelength) => 1 / (wavelength ** 5 * Math.expm1(0.01438776877 / (wavelength * temperature)));
70
+ color = [680e-9, 550e-9, 440e-9].map(planck);
71
+ const peak = Math.max(...color);
72
+ color = color.map(value => value / peak);
73
+ }
74
+ const result = Object.freeze(color);
75
+ colorCache.set(colorIndex, result);
76
+ return result;
77
+ }
78
+ function propagate(star, epochYear, options, solar) {
79
+ validateStar(star);
80
+ if (solar && star.epochYear !== 2000)
81
+ throw new RangeError('Galactic motion requires J2000 input records');
82
+ const years = epochYear - star.epochYear;
83
+ if (Math.abs(years) > 1e7)
84
+ throw new RangeError('Star propagation is limited to 10 million Julian years');
85
+ const { rightAscension: ra, declination: dec } = star;
86
+ const cosDec = Math.cos(dec), sinDec = Math.sin(dec), cosRA = Math.cos(ra), sinRA = Math.sin(ra);
87
+ const direction = [cosDec * cosRA, cosDec * sinRA, sinDec];
88
+ const raRate = star.properMotionRA * MAS_TO_RADIANS;
89
+ const decRate = star.properMotionDec * MAS_TO_RADIANS;
90
+ const tangent = [
91
+ -sinRA * raRate - sinDec * cosRA * decRate,
92
+ cosRA * raRate - sinDec * sinRA * decRate,
93
+ cosDec * decRate
94
+ ];
95
+ const distance = star.parallax !== null && star.parallax > 0 ? 1000 / star.parallax : null;
96
+ let relative, distanceParsecs = null;
97
+ let motionModel = 'angular';
98
+ if (distance !== null) {
99
+ const position = direction.map(value => value * distance);
100
+ const velocity = tangent.map((value, i) => value * distance + direction[i] * (star.radialVelocity ?? 0) * KMS_TO_PC_PER_YEAR);
101
+ if (solar) {
102
+ const galPosition = equatorialToGalactic(position).map((value, i) => value + SOLAR_POSITION[i]);
103
+ const galVelocity = equatorialToGalactic(velocity).map((value, i) => value * 1e6 + SOLAR_VELOCITY[i]);
104
+ const moved = integrateGalacticOrbit(galPosition, galVelocity, years, options.maximumStepYears).position;
105
+ relative = galacticToEquatorial(moved.map((value, i) => value - solar[i]));
106
+ motionModel = 'galactic';
107
+ }
108
+ else {
109
+ relative = position.map((value, i) => value + velocity[i] * years);
110
+ motionModel = 'rectilinear';
111
+ }
112
+ distanceParsecs = Math.hypot(...relative);
113
+ }
114
+ else
115
+ relative = direction.map((value, i) => value + tangent[i] * years);
116
+ const length = Math.hypot(...relative);
117
+ if (!(length > 0) || !Number.isFinite(length))
118
+ throw new RangeError('Star coincides with observer or motion overflowed');
119
+ const equatorialDirection = relative.map(value => value / length);
120
+ const rotated = options.rotation
121
+ ? rotate(options.rotation, equatorialDirection)
122
+ : [...equatorialDirection];
123
+ const magnitude = distanceParsecs !== null && distance !== null
124
+ ? star.magnitude + 5 * Math.log10(distanceParsecs / distance)
125
+ : star.magnitude;
126
+ return {
127
+ star,
128
+ equatorialDirection,
129
+ direction: rotated,
130
+ rightAscension: (Math.atan2(equatorialDirection[1], equatorialDirection[0]) + 2 * Math.PI) % (2 * Math.PI),
131
+ declination: Math.asin(Math.max(-1, Math.min(1, equatorialDirection[2]))),
132
+ distanceParsecs,
133
+ magnitude,
134
+ relativeFlux: 10 ** (-0.4 * magnitude),
135
+ color: getStarColor(star.colorIndex),
136
+ motionModel,
137
+ radialVelocityAssumed: star.radialVelocity === null
138
+ };
139
+ }
140
+ function validateStar(star) {
141
+ if (![
142
+ star.epochYear,
143
+ star.rightAscension,
144
+ star.declination,
145
+ star.magnitude,
146
+ star.properMotionRA,
147
+ star.properMotionDec
148
+ ].every(Number.isFinite) ||
149
+ Math.abs(star.declination) > Math.PI / 2 ||
150
+ (star.parallax !== null && !Number.isFinite(star.parallax)) ||
151
+ (star.radialVelocity !== null && !Number.isFinite(star.radialVelocity))) {
152
+ throw new RangeError('Invalid star coordinates or motion');
153
+ }
154
+ }
155
+ function validateOptions(epochYear, options) {
156
+ if (!Number.isFinite(epochYear) || Math.abs(epochYear - 2000) > 1e7)
157
+ throw new RangeError('Epoch must be within 10 million years of J2000');
158
+ if (options.model !== undefined &&
159
+ options.model !== 'rectilinear' &&
160
+ options.model !== 'galactic')
161
+ throw new RangeError('Unknown stellar motion model');
162
+ if (options.maximumStepYears !== undefined &&
163
+ (!Number.isFinite(options.maximumStepYears) ||
164
+ options.maximumStepYears <= 0 ||
165
+ options.maximumStepYears > 10000))
166
+ throw new RangeError('Invalid Galactic step');
167
+ const m = options.rotation;
168
+ if (m) {
169
+ if (m.length !== 9 || !m.every(Number.isFinite))
170
+ throw new RangeError('Rotation must be a finite 3x3 matrix');
171
+ for (let a = 0; a < 3; a++)
172
+ for (let b = 0; b < 3; b++) {
173
+ const dot = [0, 1, 2].reduce((sum, i) => sum + m[a * 3 + i] * m[b * 3 + i], 0);
174
+ if (Math.abs(dot - (a === b ? 1 : 0)) > 1e-6)
175
+ throw new RangeError('Rotation must be orthonormal');
176
+ }
177
+ const determinant = m[0] * (m[4] * m[8] - m[7] * m[5]) -
178
+ m[3] * (m[1] * m[8] - m[7] * m[2]) +
179
+ m[6] * (m[1] * m[5] - m[4] * m[2]);
180
+ if (Math.abs(determinant - 1) > 1e-6)
181
+ throw new RangeError('Rotation must preserve handedness');
182
+ }
183
+ }
184
+ function rotate(m, v) {
185
+ return [0, 1, 2].map(i => m[i] * v[0] + m[i + 3] * v[1] + m[i + 6] * v[2]);
186
+ }
187
+ export { getStarLayerData } from "./star-render.js";
188
+ //# sourceMappingURL=stars.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"stars.js","sourceRoot":"","sources":["../../src/sun/stars.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,26 @@
1
+ /**
2
+ * A position in the sky defined by two angles
3
+ * The altitude is 0° at the horizon, +90° in the zenith (straight over your head), and −90° in the nadir (straight down).
4
+ * The azimuth is the direction along the horizon, which we measure from south to west.
5
+ * South has azimuth 0°, west +90°, north +180°, and east +270° (or −90°, that's the same thing).
6
+ */
7
+ export type CelestialPosition = {
8
+ azimuth: number;
9
+ altitude: number;
10
+ };
11
+ /**
12
+ * Calculate sun position
13
+ * based on https://www.aa.quae.nl/en/reken/zonpositie.html
14
+ * inspired by https://github.com/mourner/suncalc/blob/master/suncalc.js
15
+ */
16
+ export declare function getSunPosition(timestamp: number | Date, latitude: number, longitude: number): CelestialPosition;
17
+ export declare function getSunDirection(timestamp: number | Date, latitude: number, longitude: number): number[];
18
+ export declare function toDays(timestamp: number | Date): number;
19
+ export declare function getRightAscension(eclipticLongitude: number, b: number): number;
20
+ export declare function getDeclination(eclipticLongitude: number, b: number): number;
21
+ export declare function getAzimuth(hourAngle: number, latitudeInRadians: number, declination: number): number;
22
+ export declare function getSunCoords(dates: number): {
23
+ declination: number;
24
+ rightAscension: number;
25
+ };
26
+ //# sourceMappingURL=suncalc.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"suncalc.d.ts","sourceRoot":"","sources":["../../src/sun/suncalc.ts"],"names":[],"mappings":"AAqBA;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,iBAAiB,CAanB;AAED,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,MAAM,EAAE,CASV;AAOD,wBAAgB,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAEvD;AAED,wBAAgB,iBAAiB,CAAC,iBAAiB,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAG9E;AAED,wBAAgB,cAAc,CAAC,iBAAiB,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAG3E;AAED,wBAAgB,UAAU,CACxB,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,MAAM,EACzB,WAAW,EAAE,MAAM,GAClB,MAAM,CAKR;AA8BD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB,CAQA"}
@@ -0,0 +1,94 @@
1
+ // math.gl
2
+ // SPDX-License-Identifier: MIT
3
+ // SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
4
+ // SPDX-FileComment: Inspired by SunCalc; equations follow https://www.aa.quae.nl/en/reken/zonpositie.html.
5
+ const DEGREES_TO_RADIANS = Math.PI / 180;
6
+ const DAY_IN_MS = 1000 * 60 * 60 * 24;
7
+ const JD1970 = 2440588; // Julian Day year 1970
8
+ const JD2000 = 2451545; // Julian Day year 2000
9
+ // This angle ε [epsilon] is called the obliquity of the ecliptic and its value at the beginning of 2000 was 23.4397°
10
+ const e = DEGREES_TO_RADIANS * 23.4397; // obliquity of the Earth
11
+ // Refer https://www.aa.quae.nl/en/reken/zonpositie.html
12
+ // "The Mean Anomaly" section for explanation
13
+ const M0 = 357.5291; // Earth mean anomaly on start day
14
+ const M1 = 0.98560028; // Earth angle traverses on average per day seen from the sun
15
+ const THETA0 = 280.147; // The sidereal time (in degrees) at longitude 0° at the instant defined by JD2000
16
+ const THETA1 = 360.9856235; // The rate of change of the sidereal time, in degrees per day.
17
+ /**
18
+ * Calculate sun position
19
+ * based on https://www.aa.quae.nl/en/reken/zonpositie.html
20
+ * inspired by https://github.com/mourner/suncalc/blob/master/suncalc.js
21
+ */
22
+ export function getSunPosition(timestamp, latitude, longitude) {
23
+ const longitudeWestInRadians = DEGREES_TO_RADIANS * -longitude;
24
+ const phi = DEGREES_TO_RADIANS * latitude;
25
+ const d = toDays(timestamp);
26
+ const c = getSunCoords(d);
27
+ // hour angle
28
+ const H = getSiderealTime(d, longitudeWestInRadians) - c.rightAscension;
29
+ return {
30
+ azimuth: getAzimuth(H, phi, c.declination),
31
+ altitude: getAltitude(H, phi, c.declination)
32
+ };
33
+ }
34
+ export function getSunDirection(timestamp, latitude, longitude) {
35
+ const { azimuth, altitude } = getSunPosition(timestamp, latitude, longitude);
36
+ // solar position to light direction
37
+ return [
38
+ Math.sin(azimuth) * Math.cos(altitude),
39
+ Math.cos(azimuth) * Math.cos(altitude),
40
+ -Math.sin(altitude)
41
+ ];
42
+ }
43
+ function toJulianDay(timestamp) {
44
+ const ts = typeof timestamp === 'number' ? timestamp : timestamp.getTime();
45
+ return ts / DAY_IN_MS - 0.5 + JD1970;
46
+ }
47
+ export function toDays(timestamp) {
48
+ return toJulianDay(timestamp) - JD2000;
49
+ }
50
+ export function getRightAscension(eclipticLongitude, b) {
51
+ const lambda = eclipticLongitude;
52
+ return Math.atan2(Math.sin(lambda) * Math.cos(e) - Math.tan(b) * Math.sin(e), Math.cos(lambda));
53
+ }
54
+ export function getDeclination(eclipticLongitude, b) {
55
+ const lambda = eclipticLongitude;
56
+ return Math.asin(Math.sin(b) * Math.cos(e) + Math.cos(b) * Math.sin(e) * Math.sin(lambda));
57
+ }
58
+ export function getAzimuth(hourAngle, latitudeInRadians, declination) {
59
+ const H = hourAngle;
60
+ const phi = latitudeInRadians;
61
+ const delta = declination;
62
+ return Math.atan2(Math.sin(H), Math.cos(H) * Math.sin(phi) - Math.tan(delta) * Math.cos(phi));
63
+ }
64
+ function getAltitude(hourAngle, latitudeInRadians, declination) {
65
+ const H = hourAngle;
66
+ const phi = latitudeInRadians;
67
+ const delta = declination;
68
+ return Math.asin(Math.sin(phi) * Math.sin(delta) + Math.cos(phi) * Math.cos(delta) * Math.cos(H));
69
+ }
70
+ // https://www.aa.quae.nl/en/reken/zonpositie.html
71
+ // "The Observer section"
72
+ function getSiderealTime(dates, longitudeWestInRadians) {
73
+ return DEGREES_TO_RADIANS * (THETA0 + THETA1 * dates) - longitudeWestInRadians;
74
+ }
75
+ function getSolarMeanAnomaly(days) {
76
+ return DEGREES_TO_RADIANS * (M0 + M1 * days);
77
+ }
78
+ function getEclipticLongitude(meanAnomaly) {
79
+ const M = meanAnomaly;
80
+ // equation of center
81
+ const C = DEGREES_TO_RADIANS * (1.9148 * Math.sin(M) + 0.02 * Math.sin(2 * M) + 0.0003 * Math.sin(3 * M));
82
+ // perihelion of the Earth
83
+ const P = DEGREES_TO_RADIANS * 102.9372;
84
+ return M + C + P + Math.PI;
85
+ }
86
+ export function getSunCoords(dates) {
87
+ const M = getSolarMeanAnomaly(dates);
88
+ const L = getEclipticLongitude(M);
89
+ return {
90
+ declination: getDeclination(L, 0),
91
+ rightAscension: getRightAscension(L, 0)
92
+ };
93
+ }
94
+ //# sourceMappingURL=suncalc.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"suncalc.js","sourceRoot":"","sources":["../../src/sun/suncalc.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,4DAA4D;AAC5D,2GAA2G;AAC3G,MAAM,kBAAkB,GAAG,IAAI,CAAC,EAAE,GAAG,GAAG,CAAC;AAEzC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AACtC,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,uBAAuB;AAC/C,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,uBAAuB;AAE/C,qHAAqH;AACrH,MAAM,CAAC,GAAG,kBAAkB,GAAG,OAAO,CAAC,CAAC,yBAAyB;AAEjE,wDAAwD;AACxD,6CAA6C;AAC7C,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,kCAAkC;AACvD,MAAM,EAAE,GAAG,UAAU,CAAC,CAAC,6DAA6D;AAEpF,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,kFAAkF;AAC1G,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,+DAA+D;AAa3F;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,SAAwB,EACxB,QAAgB,EAChB,SAAiB;IAEjB,MAAM,sBAAsB,GAAG,kBAAkB,GAAG,CAAC,SAAS,CAAC;IAC/D,MAAM,GAAG,GAAG,kBAAkB,GAAG,QAAQ,CAAC;IAC1C,MAAM,CAAC,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IAE5B,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IAC1B,aAAa;IACb,MAAM,CAAC,GAAG,eAAe,CAAC,CAAC,EAAE,sBAAsB,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC;IAExE,OAAO;QACL,OAAO,EAAE,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,WAAW,CAAC;QAC1C,QAAQ,EAAE,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,WAAW,CAAC;KAC7C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,SAAwB,EACxB,QAAgB,EAChB,SAAiB;IAEjB,MAAM,EAAC,OAAO,EAAE,QAAQ,EAAC,GAAG,cAAc,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IAE3E,oCAAoC;IACpC,OAAO;QACL,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC;QACtC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC;QACtC,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC;KACpB,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,SAAwB;IAC3C,MAAM,EAAE,GAAG,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;IAC3E,OAAO,EAAE,GAAG,SAAS,GAAG,GAAG,GAAG,MAAM,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,SAAwB;IAC7C,OAAO,WAAW,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,iBAAyB,EAAE,CAAS;IACpE,MAAM,MAAM,GAAG,iBAAiB,CAAC;IACjC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AAClG,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,iBAAyB,EAAE,CAAS;IACjE,MAAM,MAAM,GAAG,iBAAiB,CAAC;IACjC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AAC7F,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,SAAiB,EACjB,iBAAyB,EACzB,WAAmB;IAEnB,MAAM,CAAC,GAAG,SAAS,CAAC;IACpB,MAAM,GAAG,GAAG,iBAAiB,CAAC;IAC9B,MAAM,KAAK,GAAG,WAAW,CAAC;IAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AAChG,CAAC;AAED,SAAS,WAAW,CAAC,SAAiB,EAAE,iBAAyB,EAAE,WAAmB;IACpF,MAAM,CAAC,GAAG,SAAS,CAAC;IACpB,MAAM,GAAG,GAAG,iBAAiB,CAAC;IAC9B,MAAM,KAAK,GAAG,WAAW,CAAC;IAC1B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACpG,CAAC;AAED,kDAAkD;AAClD,yBAAyB;AACzB,SAAS,eAAe,CAAC,KAAa,EAAE,sBAA8B;IACpE,OAAO,kBAAkB,GAAG,CAAC,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC,GAAG,sBAAsB,CAAC;AACjF,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAY;IACvC,OAAO,kBAAkB,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,oBAAoB,CAAC,WAAmB;IAC/C,MAAM,CAAC,GAAG,WAAW,CAAC;IACtB,qBAAqB;IACrB,MAAM,CAAC,GACL,kBAAkB,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAClG,0BAA0B;IAC1B,MAAM,CAAC,GAAG,kBAAkB,GAAG,QAAQ,CAAC;IAExC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAa;IAIxC,MAAM,CAAC,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IACrC,MAAM,CAAC,GAAG,oBAAoB,CAAC,CAAC,CAAC,CAAC;IAElC,OAAO;QACL,WAAW,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC;QACjC,cAAc,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC;KACxC,CAAC;AACJ,CAAC"}
@@ -0,0 +1,25 @@
1
+ export type SunLightOptions = {
2
+ /** Atmospheric turbidity, from 1 (clear) to 10 (hazy). Default 3. */
3
+ turbidity?: number;
4
+ /** Fractional cloud coverage in [0, 1]. Default 0. Represents averaged conditions. */
5
+ cloudCover?: number;
6
+ /** Vertical cloud optical depth, nonnegative. Default 10. */
7
+ cloudOpticalDepth?: number;
8
+ };
9
+ export type LightColor = {
10
+ /** Normalized linear sRGB, with maximum component 1 when illuminated. */
11
+ color: [number, number, number];
12
+ /** Relative peak-channel irradiance. Multiply by color to recover RGB irradiance. */
13
+ intensity: number;
14
+ };
15
+ export type SunLight = LightColor & {
16
+ /** Hemispherical diffuse irradiance on a horizontal surface, on the same relative scale. */
17
+ diffuse: LightColor;
18
+ };
19
+ /**
20
+ * Estimate direct sunlight and hemispherical diffuse skylight from altitude in radians.
21
+ * Uses spectrally integrated Hošek-Wilkie 1.4a lookup data at sea level with black ground.
22
+ * Clouds use a separate neutral, energy-bounded approximation, not the Hošek-Wilkie model.
23
+ */
24
+ export declare function getSunLight(altitude: number, options?: SunLightOptions): SunLight;
25
+ //# sourceMappingURL=sunlight.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sunlight.d.ts","sourceRoot":"","sources":["../../src/sun/sunlight.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,eAAe,GAAG;IAC5B,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sFAAsF;IACtF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,yEAAyE;IACzE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,qFAAqF;IACrF,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG;IAClC,4FAA4F;IAC5F,OAAO,EAAE,UAAU,CAAC;CACrB,CAAC;AAMF;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,QAAQ,CAwDrF"}
@@ -0,0 +1,76 @@
1
+ // math.gl
2
+ // SPDX-License-Identifier: MIT
3
+ // SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
4
+ // SPDX-FileComment: Original wrapper of derived Hošek-Wilkie data; reference: https://cgg.mff.cuni.cz/projects/SkylightModelling/
5
+ // Derived BSD-3-Clause data and notices: ./data/sunlight.ts and ../LICENSE-HOSEK-WILKIE.
6
+ import { SUNLIGHT_DATA } from "./data/sunlight.js";
7
+ const SUN_RADIUS = (0.255 * Math.PI) / 180;
8
+ // Fixed reference: brightest channel of clear (turbidity 1), zenith direct sunlight.
9
+ const REFERENCE_IRRADIANCE = Math.max(...SUNLIGHT_DATA[0][90].slice(0, 3));
10
+ /**
11
+ * Estimate direct sunlight and hemispherical diffuse skylight from altitude in radians.
12
+ * Uses spectrally integrated Hošek-Wilkie 1.4a lookup data at sea level with black ground.
13
+ * Clouds use a separate neutral, energy-bounded approximation, not the Hošek-Wilkie model.
14
+ */
15
+ export function getSunLight(altitude, options = {}) {
16
+ const { turbidity = 3, cloudCover = 0, cloudOpticalDepth = 10 } = options;
17
+ validateRange('Sun altitude', altitude, -Math.PI / 2, Math.PI / 2);
18
+ validateRange('Turbidity', turbidity, 1, 10);
19
+ validateRange('Cloud cover', cloudCover, 0, 1);
20
+ validateRange('Cloud optical depth', cloudOpticalDepth, 0, Number.MAX_VALUE);
21
+ if (altitude <= -SUN_RADIUS) {
22
+ return { color: [0, 0, 0], intensity: 0, diffuse: { color: [0, 0, 0], intensity: 0 } };
23
+ }
24
+ const elevation = Math.max(0, altitude);
25
+ const degrees = (elevation * 180) / Math.PI;
26
+ const altitudeIndex = Math.min(89, Math.floor(degrees));
27
+ const altitudeFraction = degrees - altitudeIndex;
28
+ const turbidityIndex = Math.min(8, Math.floor(turbidity) - 1);
29
+ const turbidityFraction = turbidity - turbidityIndex - 1;
30
+ const sample = (channel) => {
31
+ const lower = SUNLIGHT_DATA[turbidityIndex];
32
+ const upper = SUNLIGHT_DATA[turbidityIndex + 1];
33
+ const low = interpolate(lower[altitudeIndex][channel], lower[altitudeIndex + 1][channel], altitudeFraction);
34
+ const high = interpolate(upper[altitudeIndex][channel], upper[altitudeIndex + 1][channel], altitudeFraction);
35
+ return interpolate(low, high, turbidityFraction) / REFERENCE_IRRADIANCE;
36
+ };
37
+ // Uniform-disk horizon clipping. Limb darkening is included in the full-disk lookup,
38
+ // but this partial-disk fade omits its spatial variation and atmospheric refraction.
39
+ const diskHeight = Math.min(1, altitude / SUN_RADIUS);
40
+ const visibility = (Math.acos(-diskHeight) + diskHeight * Math.sqrt(1 - diskHeight * diskHeight)) / Math.PI;
41
+ const mu = Math.sin(elevation);
42
+ // Beer-Lambert transmission of the covered fraction. The path is bounded near the
43
+ // horizon because this simple plane-parallel cloud layer cannot model curved geometry.
44
+ const cloudTransmission = Math.exp(-cloudOpticalDepth / Math.max(0.05, mu));
45
+ const directTransmission = 1 - cloudCover + cloudCover * cloudTransmission;
46
+ // Heuristic transmission of redistributed light through the cloud layer, including
47
+ // loss upward. This is not a fitted weather model. It never creates incident energy.
48
+ const diffuseTransmission = 1 / (1 + 0.12 * cloudOpticalDepth);
49
+ const direct = [0, 0, 0];
50
+ const diffuse = [0, 0, 0];
51
+ for (let channel = 0; channel < 3; channel++) {
52
+ const beam = sample(channel) * visibility;
53
+ const sky = sample(channel + 3) * visibility;
54
+ direct[channel] = beam * directTransmission;
55
+ diffuse[channel] =
56
+ (1 - cloudCover) * sky +
57
+ cloudCover * diffuseTransmission * (sky + beam * mu * (1 - cloudTransmission));
58
+ }
59
+ return { ...normalize(direct), diffuse: normalize(diffuse) };
60
+ }
61
+ function interpolate(a, b, fraction) {
62
+ return a + (b - a) * fraction;
63
+ }
64
+ function normalize(rgb) {
65
+ const intensity = Math.max(...rgb);
66
+ return {
67
+ color: intensity > 0 ? [rgb[0] / intensity, rgb[1] / intensity, rgb[2] / intensity] : [0, 0, 0],
68
+ intensity
69
+ };
70
+ }
71
+ function validateRange(name, value, minimum, maximum) {
72
+ if (!Number.isFinite(value) || value < minimum || value > maximum) {
73
+ throw new RangeError(`${name} must be finite and between ${minimum} and ${maximum}`);
74
+ }
75
+ }
76
+ //# sourceMappingURL=sunlight.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sunlight.js","sourceRoot":"","sources":["../../src/sun/sunlight.ts"],"names":[],"mappings":"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"}