skymap 0.3.0 → 0.5.0

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 (57) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +153 -1
  3. data/README.md +702 -31
  4. data/data/LICENSE-deep_sky_objects.txt +30 -0
  5. data/data/LICENSE-stars.txt +35 -0
  6. data/data/deep_sky_objects.csv +1742 -0
  7. data/data/star_names.csv +334 -0
  8. data/data/stars.bin +0 -0
  9. data/lib/skymap/canvas.rb +12 -3
  10. data/lib/skymap/catalog/deep_sky_objects.rb +60 -0
  11. data/lib/skymap/catalog/star_names.rb +23 -0
  12. data/lib/skymap/catalog/star_records.rb +322 -0
  13. data/lib/skymap/catalog/stars.rb +75 -12
  14. data/lib/skymap/chart.rb +19 -4
  15. data/lib/skymap/cone.rb +21 -0
  16. data/lib/skymap/context.rb +326 -8
  17. data/lib/skymap/deep_sky_object.rb +140 -0
  18. data/lib/skymap/eyepiece.rb +22 -0
  19. data/lib/skymap/field.rb +20 -0
  20. data/lib/skymap/geometry.rb +47 -0
  21. data/lib/skymap/horizon.rb +33 -3
  22. data/lib/skymap/label_placement.rb +263 -0
  23. data/lib/skymap/layers/cardinal_directions.rb +2 -0
  24. data/lib/skymap/layers/constellation_lines.rb +6 -1
  25. data/lib/skymap/layers/constellation_names.rb +5 -2
  26. data/lib/skymap/layers/deep_sky_objects.rb +128 -0
  27. data/lib/skymap/layers/ecliptic.rb +1 -7
  28. data/lib/skymap/layers/field_circles.rb +169 -0
  29. data/lib/skymap/layers/grid.rb +153 -0
  30. data/lib/skymap/layers/moon.rb +22 -12
  31. data/lib/skymap/layers/planets.rb +8 -9
  32. data/lib/skymap/layers/scale.rb +75 -0
  33. data/lib/skymap/layers/star_names.rb +62 -0
  34. data/lib/skymap/layers/stars.rb +31 -8
  35. data/lib/skymap/layers/sun.rb +13 -9
  36. data/lib/skymap/magnitude_limit.rb +15 -0
  37. data/lib/skymap/print_size.rb +50 -0
  38. data/lib/skymap/projection/oblique_stereographic.rb +87 -0
  39. data/lib/skymap/projection/stereographic.rb +11 -0
  40. data/lib/skymap/renderer/caption.rb +60 -1
  41. data/lib/skymap/renderer/deep_sky_symbol.rb +67 -0
  42. data/lib/skymap/renderer/field_circle.rb +7 -0
  43. data/lib/skymap/renderer/grid.rb +7 -0
  44. data/lib/skymap/renderer/horizon_line.rb +7 -0
  45. data/lib/skymap/renderer/label.rb +3 -1
  46. data/lib/skymap/renderer/scale_bar.rb +7 -0
  47. data/lib/skymap/renderer/svg.rb +242 -42
  48. data/lib/skymap/setup.rb +48 -0
  49. data/lib/skymap/star.rb +127 -2
  50. data/lib/skymap/star_list.rb +25 -0
  51. data/lib/skymap/telescope.rb +17 -0
  52. data/lib/skymap/theme.rb +148 -0
  53. data/lib/skymap/version.rb +1 -1
  54. data/lib/skymap/view.rb +49 -0
  55. data/lib/skymap.rb +27 -0
  56. metadata +35 -2
  57. data/data/stars.csv +0 -9097
data/lib/skymap/star.rb CHANGED
@@ -1,9 +1,134 @@
1
1
  # frozen_string_literal: true
2
2
 
3
3
  module Skymap
4
- Star = Data.define(:hr, :equatorial_coordinates, :magnitude) do
4
+ Star = Data.define(
5
+ :hr,
6
+ :equatorial_coordinates,
7
+ :magnitude,
8
+ :proper_motion_ra,
9
+ :proper_motion_dec,
10
+ :parallax,
11
+ :radial_velocity
12
+ ) do
5
13
  def self.by_hr(stars)
6
- stars.to_h { |star| [star.hr, star] }
14
+ stars.filter_map { |star| [star.hr, star] if star.hr }.to_h
15
+ end
16
+
17
+ def initialize(
18
+ hr:,
19
+ equatorial_coordinates:,
20
+ magnitude:,
21
+ proper_motion_ra: nil,
22
+ proper_motion_dec: nil,
23
+ parallax: nil,
24
+ radial_velocity: nil
25
+ )
26
+ unless hr?(hr)
27
+ raise ArgumentError, "hr must be a positive Integer or nil"
28
+ end
29
+
30
+ unless equatorial_coordinates.is_a?(Astronoby::Coordinates::Equatorial)
31
+ raise ArgumentError,
32
+ "equatorial_coordinates must be Astronoby::Coordinates::Equatorial"
33
+ end
34
+
35
+ unless magnitude?(magnitude)
36
+ raise ArgumentError, "magnitude must be a finite Numeric"
37
+ end
38
+
39
+ unless proper_motion?(proper_motion_ra)
40
+ raise ArgumentError,
41
+ "proper_motion_ra must be an Astronoby::AngularVelocity or nil"
42
+ end
43
+
44
+ unless proper_motion?(proper_motion_dec)
45
+ raise ArgumentError,
46
+ "proper_motion_dec must be an Astronoby::AngularVelocity or nil"
47
+ end
48
+
49
+ if proper_motion_ra.nil? != proper_motion_dec.nil?
50
+ raise ArgumentError,
51
+ "proper_motion_ra and proper_motion_dec must be given together"
52
+ end
53
+
54
+ if proper_motion_ra &&
55
+ equatorial_coordinates.epoch != Astronoby::JulianDate::J2000
56
+ raise ArgumentError,
57
+ "equatorial_coordinates must be at J2000 when a proper motion " \
58
+ "is given, as it is applied from J2000"
59
+ end
60
+
61
+ unless parallax?(parallax)
62
+ raise ArgumentError,
63
+ "parallax must be an Astronoby::Angle above 0 or nil"
64
+ end
65
+
66
+ unless radial_velocity?(radial_velocity)
67
+ raise ArgumentError,
68
+ "radial_velocity must be an Astronoby::Velocity or nil"
69
+ end
70
+
71
+ super
72
+ end
73
+
74
+ def coordinates_at(instant)
75
+ unless instant.is_a?(Astronoby::Instant)
76
+ raise ArgumentError, "instant must be an Astronoby::Instant"
77
+ end
78
+
79
+ return equatorial_coordinates if proper_motion_ra.nil?
80
+
81
+ propagated = Astronoby::StellarPropagation.equatorial_coordinates_for(
82
+ instant: instant,
83
+ equatorial_coordinates: equatorial_coordinates,
84
+ proper_motion_ra: proper_motion_ra,
85
+ proper_motion_dec: proper_motion_dec,
86
+ parallax: parallax || placeholder_parallax,
87
+ radial_velocity: radial_velocity || placeholder_radial_velocity
88
+ )
89
+
90
+ Astronoby::Coordinates::Equatorial.new(
91
+ right_ascension: propagated.right_ascension,
92
+ declination: propagated.declination,
93
+ epoch: Astronoby::JulianDate::J2000
94
+ )
95
+ end
96
+
97
+ placeholder_parallax = Astronoby::Angle.from_degree_arcseconds(0.001)
98
+ placeholder_radial_velocity =
99
+ Astronoby::Velocity.from_kilometers_per_second(0)
100
+
101
+ private define_method(:placeholder_parallax) { placeholder_parallax }
102
+ private define_method(:placeholder_radial_velocity) {
103
+ placeholder_radial_velocity
104
+ }
105
+
106
+ private
107
+
108
+ def hr?(value)
109
+ value.nil? || (value.is_a?(Integer) && value.positive?)
110
+ end
111
+
112
+ def magnitude?(value)
113
+ value.is_a?(Numeric) && value.real? && value.finite?
114
+ end
115
+
116
+ def proper_motion?(value)
117
+ value.nil? ||
118
+ (value.is_a?(Astronoby::AngularVelocity) &&
119
+ value.radians_per_second.finite?)
120
+ end
121
+
122
+ def parallax?(value)
123
+ value.nil? ||
124
+ (value.is_a?(Astronoby::Angle) &&
125
+ value.radians.finite? && value.positive?)
126
+ end
127
+
128
+ def radial_velocity?(value)
129
+ value.nil? ||
130
+ (value.is_a?(Astronoby::Velocity) &&
131
+ value.meters_per_second.finite?)
7
132
  end
8
133
  end
9
134
  end
@@ -0,0 +1,25 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Skymap
4
+ class StarList
5
+ def self.wrap(stars)
6
+ return stars if stars.respond_to?(:search)
7
+
8
+ new(stars)
9
+ end
10
+
11
+ def initialize(stars)
12
+ @stars = stars
13
+ end
14
+
15
+ def search(magnitude_limit: nil, cone: nil)
16
+ return @stars.to_a unless magnitude_limit
17
+
18
+ @stars.select { |star| star.magnitude <= magnitude_limit }
19
+ end
20
+
21
+ def by_hr
22
+ Star.by_hr(@stars)
23
+ end
24
+ end
25
+ end
@@ -0,0 +1,17 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Skymap
4
+ Telescope = Data.define(:focal_length_mm, :aperture_mm) do
5
+ def initialize(focal_length_mm:, aperture_mm:)
6
+ {focal_length_mm: focal_length_mm, aperture_mm: aperture_mm}
7
+ .each do |name, value|
8
+ unless value.is_a?(Numeric) && value.real? && value.finite? &&
9
+ value > 0
10
+ raise ArgumentError, "#{name} must be a number above 0"
11
+ end
12
+ end
13
+
14
+ super
15
+ end
16
+ end
17
+ end
@@ -0,0 +1,148 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Skymap
4
+ required_colors = %i[
5
+ background
6
+ sky
7
+ horizon
8
+ star
9
+ constellation_line
10
+ boundary
11
+ ecliptic
12
+ planet
13
+ sun
14
+ moon
15
+ moon_shadow
16
+ moon_shadow_opacity
17
+ constellation_name
18
+ star_name
19
+ planet_name
20
+ label
21
+ font
22
+ ].freeze
23
+ optional_colors = {
24
+ grid: :boundary,
25
+ scale: :star_name,
26
+ field_circle: :planet,
27
+ deep_sky: :constellation_name
28
+ }.freeze
29
+
30
+ Theme = Data.define(*required_colors, *optional_colors.keys) do
31
+ const_set(:OPTIONAL_COLORS, optional_colors)
32
+
33
+ def self.check_fallbacks(optional, required)
34
+ optional.each do |slot, fallback|
35
+ next if required.include?(fallback)
36
+
37
+ raise ArgumentError,
38
+ "#{slot} must fall back to a required slot, not #{fallback.inspect}"
39
+ end
40
+ end
41
+
42
+ check_fallbacks(optional_colors, required_colors)
43
+
44
+ prepend(Module.new {
45
+ optional_colors.each do |slot, fallback|
46
+ define_method(slot) { super() || public_send(fallback) }
47
+ end
48
+ })
49
+
50
+ def self.dark
51
+ new(
52
+ background: "none",
53
+ sky: "#000000",
54
+ horizon: "#3262a8",
55
+ star: "#ffffff",
56
+ constellation_line: "#46689c",
57
+ boundary: "#2b3f5e",
58
+ ecliptic: "#8c7a3a",
59
+ grid: "#22324a",
60
+ planet: "#ffe6b3",
61
+ sun: "#ffd34d",
62
+ moon: "#f1ecd6",
63
+ moon_shadow: "#232a35",
64
+ moon_shadow_opacity: 0.6,
65
+ constellation_name: "#6f8fc2",
66
+ star_name: "#a8b8d0",
67
+ planet_name: "#ffe6b3",
68
+ label: "#3262a8",
69
+ font: "sans-serif"
70
+ )
71
+ end
72
+
73
+ def self.light
74
+ new(
75
+ background: "#ffffff",
76
+ sky: "#ffffff",
77
+ horizon: "#1f3f73",
78
+ star: "#111111",
79
+ constellation_line: "#5b7bb0",
80
+ boundary: "#b8c4d9",
81
+ ecliptic: "#b08d1f",
82
+ grid: "#d5ddea",
83
+ planet: "#c2570c",
84
+ sun: "#f0a500",
85
+ moon: "#e8d27a",
86
+ moon_shadow: "#3b4252",
87
+ moon_shadow_opacity: 0.35,
88
+ constellation_name: "#4a679a",
89
+ star_name: "#3d4a60",
90
+ planet_name: "#c2570c",
91
+ label: "#1f3f73",
92
+ font: "sans-serif"
93
+ )
94
+ end
95
+
96
+ def self.night
97
+ new(
98
+ background: "#000000",
99
+ sky: "#000000",
100
+ horizon: "#7a1010",
101
+ star: "#ff6b6b",
102
+ constellation_line: "#8a2020",
103
+ boundary: "#4a1212",
104
+ ecliptic: "#a33a1a",
105
+ grid: "#3a0e0e",
106
+ planet: "#ff9a7a",
107
+ sun: "#ff8a3d",
108
+ moon: "#ffb3a0",
109
+ moon_shadow: "#2a0a0a",
110
+ moon_shadow_opacity: 0.6,
111
+ constellation_name: "#c24a4a",
112
+ star_name: "#e08a8a",
113
+ planet_name: "#ff9a7a",
114
+ label: "#7a1010",
115
+ font: "sans-serif"
116
+ )
117
+ end
118
+
119
+ def initialize(**slots)
120
+ optional = self.class::OPTIONAL_COLORS
121
+
122
+ slots.except(:moon_shadow_opacity).each do |slot, value|
123
+ next if value.nil? && optional.key?(slot)
124
+
125
+ check_text(slot, value)
126
+ end
127
+ if slots.key?(:moon_shadow_opacity)
128
+ check_opacity(slots[:moon_shadow_opacity])
129
+ end
130
+
131
+ super(**optional.transform_values { nil }, **slots)
132
+ end
133
+
134
+ private
135
+
136
+ def check_text(slot, value)
137
+ raise ArgumentError, "#{slot} must be a string" unless value.is_a?(String)
138
+ raise ArgumentError, "#{slot} must not be blank" if value.strip.empty?
139
+ end
140
+
141
+ def check_opacity(opacity)
142
+ return if opacity.is_a?(Numeric) && opacity.real? &&
143
+ opacity.between?(0, 1)
144
+
145
+ raise ArgumentError, "moon_shadow_opacity must be between 0 and 1"
146
+ end
147
+ end
148
+ end
@@ -1,5 +1,5 @@
1
1
  # frozen_string_literal: true
2
2
 
3
3
  module Skymap
4
- VERSION = "0.3.0"
4
+ VERSION = "0.5.0"
5
5
  end
@@ -0,0 +1,49 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Skymap
4
+ View = Data.define(
5
+ :center,
6
+ :field_of_view,
7
+ :orientation,
8
+ :rotation,
9
+ :mirrored
10
+ ) do
11
+ def initialize(
12
+ center:,
13
+ field_of_view:,
14
+ orientation: :zenith_up,
15
+ rotation: Astronoby::Angle.zero,
16
+ mirrored: false
17
+ )
18
+ unless center.is_a?(Astronoby::Coordinates::Equatorial) ||
19
+ center.is_a?(Astronoby::Coordinates::Horizontal)
20
+ raise ArgumentError,
21
+ "center must be equatorial or horizontal coordinates"
22
+ end
23
+
24
+ unless field_of_view.is_a?(Astronoby::Angle) &&
25
+ field_of_view.positive? && field_of_view.radians <= Math::PI
26
+ raise ArgumentError,
27
+ "field_of_view must be an Astronoby::Angle " \
28
+ "above 0 and up to 180 degrees"
29
+ end
30
+
31
+ unless View::ORIENTATIONS.include?(orientation)
32
+ raise ArgumentError,
33
+ "orientation must be one of #{View::ORIENTATIONS.join(", ")}"
34
+ end
35
+
36
+ unless rotation.is_a?(Astronoby::Angle) && rotation.radians.finite?
37
+ raise ArgumentError, "rotation must be an Astronoby::Angle"
38
+ end
39
+
40
+ unless [true, false].include?(mirrored)
41
+ raise ArgumentError, "mirrored must be true or false"
42
+ end
43
+
44
+ super
45
+ end
46
+ end
47
+
48
+ View::ORIENTATIONS = %i[zenith_up equatorial].freeze
49
+ end
data/lib/skymap.rb CHANGED
@@ -6,36 +6,63 @@ require_relative "skymap/canvas"
6
6
  require_relative "skymap/catalog/constellation_boundaries"
7
7
  require_relative "skymap/catalog/constellation_lines"
8
8
  require_relative "skymap/catalog/constellation_names"
9
+ require_relative "skymap/catalog/deep_sky_objects"
10
+ require_relative "skymap/catalog/star_names"
11
+ require_relative "skymap/catalog/star_records"
9
12
  require_relative "skymap/catalog/stars"
10
13
  require_relative "skymap/chart"
14
+ require_relative "skymap/cone"
11
15
  require_relative "skymap/constellation_boundary"
12
16
  require_relative "skymap/constellation_line"
13
17
  require_relative "skymap/context"
18
+ require_relative "skymap/deep_sky_object"
19
+ require_relative "skymap/eyepiece"
20
+ require_relative "skymap/field"
21
+ require_relative "skymap/geometry"
14
22
  require_relative "skymap/horizon"
23
+ require_relative "skymap/label_placement"
24
+ require_relative "skymap/magnitude_limit"
15
25
  require_relative "skymap/layers/cardinal_directions"
16
26
  require_relative "skymap/layers/constellation_boundaries"
17
27
  require_relative "skymap/layers/constellation_lines"
18
28
  require_relative "skymap/layers/constellation_names"
29
+ require_relative "skymap/layers/deep_sky_objects"
19
30
  require_relative "skymap/layers/ecliptic"
31
+ require_relative "skymap/layers/field_circles"
32
+ require_relative "skymap/layers/grid"
20
33
  require_relative "skymap/layers/moon"
21
34
  require_relative "skymap/layers/planets"
35
+ require_relative "skymap/layers/scale"
36
+ require_relative "skymap/layers/star_names"
22
37
  require_relative "skymap/layers/stars"
23
38
  require_relative "skymap/layers/sun"
24
39
  require_relative "skymap/point"
40
+ require_relative "skymap/print_size"
41
+ require_relative "skymap/projection/oblique_stereographic"
25
42
  require_relative "skymap/projection/stereographic"
26
43
  require_relative "skymap/renderer/boundary"
27
44
  require_relative "skymap/renderer/caption"
45
+ require_relative "skymap/renderer/deep_sky_symbol"
28
46
  require_relative "skymap/renderer/dot"
29
47
  require_relative "skymap/renderer/ecliptic"
48
+ require_relative "skymap/renderer/field_circle"
49
+ require_relative "skymap/renderer/grid"
50
+ require_relative "skymap/renderer/horizon_line"
30
51
  require_relative "skymap/renderer/label"
31
52
  require_relative "skymap/renderer/line"
32
53
  require_relative "skymap/renderer/moon"
33
54
  require_relative "skymap/renderer/planet"
55
+ require_relative "skymap/renderer/scale_bar"
34
56
  require_relative "skymap/renderer/sun"
35
57
  require_relative "skymap/renderer/svg"
58
+ require_relative "skymap/setup"
36
59
  require_relative "skymap/star"
60
+ require_relative "skymap/star_list"
37
61
  require_relative "skymap/star_size"
62
+ require_relative "skymap/telescope"
63
+ require_relative "skymap/theme"
38
64
  require_relative "skymap/version"
65
+ require_relative "skymap/view"
39
66
 
40
67
  module Skymap
41
68
  class Error < StandardError; end
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: skymap
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.3.0
4
+ version: 0.5.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Rémy Hannequin
@@ -145,48 +145,81 @@ files:
145
145
  - CHANGELOG.md
146
146
  - LICENSE.txt
147
147
  - README.md
148
+ - data/LICENSE-deep_sky_objects.txt
149
+ - data/LICENSE-stars.txt
148
150
  - data/constellations/iau/boundaries.csv
149
151
  - data/constellations/iau/lines.csv
150
152
  - data/constellations/iau/names.csv
151
- - data/stars.csv
153
+ - data/deep_sky_objects.csv
154
+ - data/star_names.csv
155
+ - data/stars.bin
152
156
  - lib/skymap.rb
153
157
  - lib/skymap/canvas.rb
154
158
  - lib/skymap/catalog/constellation_boundaries.rb
155
159
  - lib/skymap/catalog/constellation_lines.rb
156
160
  - lib/skymap/catalog/constellation_names.rb
161
+ - lib/skymap/catalog/deep_sky_objects.rb
162
+ - lib/skymap/catalog/star_names.rb
163
+ - lib/skymap/catalog/star_records.rb
157
164
  - lib/skymap/catalog/stars.rb
158
165
  - lib/skymap/chart.rb
166
+ - lib/skymap/cone.rb
159
167
  - lib/skymap/constellation_boundary.rb
160
168
  - lib/skymap/constellation_line.rb
161
169
  - lib/skymap/context.rb
170
+ - lib/skymap/deep_sky_object.rb
171
+ - lib/skymap/eyepiece.rb
172
+ - lib/skymap/field.rb
173
+ - lib/skymap/geometry.rb
162
174
  - lib/skymap/horizon.rb
175
+ - lib/skymap/label_placement.rb
163
176
  - lib/skymap/layers/cardinal_directions.rb
164
177
  - lib/skymap/layers/constellation_boundaries.rb
165
178
  - lib/skymap/layers/constellation_lines.rb
166
179
  - lib/skymap/layers/constellation_names.rb
180
+ - lib/skymap/layers/deep_sky_objects.rb
167
181
  - lib/skymap/layers/ecliptic.rb
182
+ - lib/skymap/layers/field_circles.rb
183
+ - lib/skymap/layers/grid.rb
168
184
  - lib/skymap/layers/moon.rb
169
185
  - lib/skymap/layers/planets.rb
186
+ - lib/skymap/layers/scale.rb
187
+ - lib/skymap/layers/star_names.rb
170
188
  - lib/skymap/layers/stars.rb
171
189
  - lib/skymap/layers/sun.rb
190
+ - lib/skymap/magnitude_limit.rb
172
191
  - lib/skymap/point.rb
192
+ - lib/skymap/print_size.rb
193
+ - lib/skymap/projection/oblique_stereographic.rb
173
194
  - lib/skymap/projection/stereographic.rb
174
195
  - lib/skymap/renderer/boundary.rb
175
196
  - lib/skymap/renderer/caption.rb
197
+ - lib/skymap/renderer/deep_sky_symbol.rb
176
198
  - lib/skymap/renderer/dot.rb
177
199
  - lib/skymap/renderer/ecliptic.rb
200
+ - lib/skymap/renderer/field_circle.rb
201
+ - lib/skymap/renderer/grid.rb
202
+ - lib/skymap/renderer/horizon_line.rb
178
203
  - lib/skymap/renderer/label.rb
179
204
  - lib/skymap/renderer/line.rb
180
205
  - lib/skymap/renderer/moon.rb
181
206
  - lib/skymap/renderer/planet.rb
207
+ - lib/skymap/renderer/scale_bar.rb
182
208
  - lib/skymap/renderer/sun.rb
183
209
  - lib/skymap/renderer/svg.rb
210
+ - lib/skymap/setup.rb
184
211
  - lib/skymap/star.rb
212
+ - lib/skymap/star_list.rb
185
213
  - lib/skymap/star_size.rb
214
+ - lib/skymap/telescope.rb
215
+ - lib/skymap/theme.rb
186
216
  - lib/skymap/version.rb
217
+ - lib/skymap/view.rb
187
218
  homepage: https://github.com/rhannequin/skymap
188
219
  licenses:
189
220
  - MIT
221
+ - CC-BY-SA-4.0
222
+ - LicenseRef-CC-BY-NC-3.0-IGO
190
223
  metadata:
191
224
  allowed_push_host: https://rubygems.org
192
225
  source_code_uri: https://github.com/rhannequin/skymap