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
@@ -0,0 +1,334 @@
1
+ hr,name
2
+ 15,Alpheratz
3
+ 21,Caph
4
+ 39,Algenib
5
+ 99,Ankaa
6
+ 153,Fulu
7
+ 168,Schedar
8
+ 188,Diphda
9
+ 219,Achird
10
+ 265,Castula
11
+ 337,Mirach
12
+ 338,Wurren
13
+ 361,Revati
14
+ 390,Adhil
15
+ 403,Ruchbah
16
+ 424,Polaris
17
+ 437,Alpherg
18
+ 458,Titawin
19
+ 464,Nembus
20
+ 472,Achernar
21
+ 510,Torcular
22
+ 539,Baten Kaitos
23
+ 542,Segin
24
+ 544,Mothallah
25
+ 546,Mesarthim
26
+ 553,Sheratan
27
+ 596,Alrescha
28
+ 603,Almach
29
+ 617,Hamal
30
+ 681,Mira
31
+ 804,Kaffaljidhma
32
+ 824,Lilii Borea
33
+ 834,Miram
34
+ 838,Bharani
35
+ 850,Angetenar
36
+ 874,Azha
37
+ 897,Acamar
38
+ 911,Menkar
39
+ 936,Algol
40
+ 941,Misam
41
+ 951,Botein
42
+ 963,Dalim
43
+ 984,Zibal
44
+ 1017,Mirfak
45
+ 1084,Ran
46
+ 1131,Atik
47
+ 1136,Rana
48
+ 1140,Celaeno
49
+ 1142,Electra
50
+ 1145,Taygeta
51
+ 1149,Maia
52
+ 1151,Asterope
53
+ 1156,Merope
54
+ 1165,Alcyone
55
+ 1178,Atlas
56
+ 1180,Pleione
57
+ 1228,Menkib
58
+ 1231,Zaurak
59
+ 1298,Beid
60
+ 1325,Keid
61
+ 1346,Prima Hyadum
62
+ 1373,Secunda Hyadum
63
+ 1393,Beemim
64
+ 1409,Ain
65
+ 1412,Chamukuy
66
+ 1457,Aldebaran
67
+ 1464,Theemin
68
+ 1481,Sceptrum
69
+ 1543,Tabit
70
+ 1577,Hassaleh
71
+ 1605,Almaaz
72
+ 1612,Saclateni
73
+ 1641,Haedus
74
+ 1666,Cursa
75
+ 1708,Capella
76
+ 1713,Rigel
77
+ 1790,Bellatrix
78
+ 1791,Elnath
79
+ 1829,Nihal
80
+ 1852,Mintaka
81
+ 1865,Arneb
82
+ 1879,Meissa
83
+ 1899,Hatysa
84
+ 1903,Alnilam
85
+ 1910,Tianguan
86
+ 1948,Alnitak
87
+ 1956,Phact
88
+ 2004,Saiph
89
+ 2040,Wazn
90
+ 2061,Betelgeuse
91
+ 2088,Menkalinan
92
+ 2095,Mahasim
93
+ 2177,Elkurud
94
+ 2216,Propus
95
+ 2282,Furud
96
+ 2286,Tejat
97
+ 2294,Mirzam
98
+ 2326,Canopus
99
+ 2421,Alhena
100
+ 2473,Mebsuta
101
+ 2484,Alzirr
102
+ 2491,Sirius
103
+ 2618,Adhara
104
+ 2646,Nganurganity
105
+ 2650,Mekbuda
106
+ 2657,Muliphein
107
+ 2693,Wezen
108
+ 2777,Wasat
109
+ 2827,Aludra
110
+ 2845,Gomeisa
111
+ 2891,Castor
112
+ 2930,Jishui
113
+ 2943,Procyon
114
+ 2990,Pollux
115
+ 3045,Azmidi
116
+ 3165,Naos
117
+ 3185,Tureis
118
+ 3208,Tegmine
119
+ 3249,Tarf
120
+ 3268,Piautos
121
+ 3275,Alsciaukat
122
+ 3307,Avior
123
+ 3323,Muscida
124
+ 3418,Minchir
125
+ 3429,Meleph
126
+ 3449,Asellus Borealis
127
+ 3461,Asellus Australis
128
+ 3482,Ashlesha
129
+ 3485,Alsephina
130
+ 3522,Copernicus
131
+ 3569,Talitha
132
+ 3572,Acubens
133
+ 3594,Alkaphrah
134
+ 3627,Nahn
135
+ 3634,Suhail
136
+ 3685,Miaplacidus
137
+ 3699,Aspidiske
138
+ 3734,Markeb
139
+ 3743,Intercrus
140
+ 3748,Alphard
141
+ 3773,Alterf
142
+ 3845,Ukdah
143
+ 3852,Subra
144
+ 3903,Zhang
145
+ 3905,Rasalas
146
+ 3923,Felis
147
+ 3982,Regulus
148
+ 4031,Adhafera
149
+ 4033,Tania Borealis
150
+ 4057,Algieba
151
+ 4069,Tania Australis
152
+ 4247,Praecipua
153
+ 4277,Chalawan
154
+ 4287,Alkes
155
+ 4295,Merak
156
+ 4301,Dubhe
157
+ 4357,Zosma
158
+ 4359,Chertan
159
+ 4375,Alula Australis
160
+ 4377,Alula Borealis
161
+ 4434,Giausar
162
+ 4518,Taiyangshou
163
+ 4534,Denebola
164
+ 4540,Zavijava
165
+ 4554,Phecda
166
+ 4609,Tonatiuh
167
+ 4623,Alchiba
168
+ 4656,Imai
169
+ 4660,Megrez
170
+ 4662,Gienah
171
+ 4689,Zaniah
172
+ 4700,Ginan
173
+ 4730,Acrux
174
+ 4757,Algorab
175
+ 4763,Gacrux
176
+ 4785,Chara
177
+ 4786,Kraz
178
+ 4825,Porrima
179
+ 4846,La Superba
180
+ 4853,Mimosa
181
+ 4863,Tianyi
182
+ 4905,Alioth
183
+ 4910,Minelauva
184
+ 4915,Cor Caroli
185
+ 4916,Taiyi
186
+ 4932,Vindemiatrix
187
+ 4968,Diadem
188
+ 5054,Mizar
189
+ 5056,Spica
190
+ 5062,Alcor
191
+ 5107,Heze
192
+ 5191,Alkaid
193
+ 5235,Muphrid
194
+ 5267,Hadar
195
+ 5288,Menkent
196
+ 5291,Thuban
197
+ 5315,Kang
198
+ 5338,Syrma
199
+ 5340,Arcturus
200
+ 5351,Xuange
201
+ 5359,Khambalia
202
+ 5409,Elgafar
203
+ 5435,Seginus
204
+ 5459,Rigil Kentaurus
205
+ 5460,Toliman
206
+ 5506,Izar
207
+ 5531,Zubenelgenubi
208
+ 5533,Merga
209
+ 5563,Kochab
210
+ 5602,Nekkar
211
+ 5603,Brachium
212
+ 5685,Zubeneschamali
213
+ 5733,Alkalurops
214
+ 5735,Pherkad
215
+ 5744,Edasich
216
+ 5747,Nusakan
217
+ 5787,Zubenelhakrabi
218
+ 5793,Alphecca
219
+ 5854,Unukalhai
220
+ 5879,Gudja
221
+ 5928,Iklil
222
+ 5944,Fang
223
+ 5953,Dschubba
224
+ 5984,Acrab
225
+ 6008,Marsic
226
+ 6027,Jabbah
227
+ 6056,Yed Prior
228
+ 6075,Yed Posterior
229
+ 6084,Alniyat
230
+ 6117,Cujam
231
+ 6132,Athebyne
232
+ 6134,Antares
233
+ 6148,Kornephoros
234
+ 6149,Marfik
235
+ 6165,Paikauhale
236
+ 6217,Atria
237
+ 6241,Larawag
238
+ 6247,Xamidimura
239
+ 6252,Pipirima
240
+ 6370,Alrakis
241
+ 6378,Sabik
242
+ 6396,Aldhibah
243
+ 6402,Guniibuu
244
+ 6406,Rasalgethi
245
+ 6410,Sarin
246
+ 6508,Lesath
247
+ 6526,Maasym
248
+ 6527,Shaula
249
+ 6536,Rastaban
250
+ 6553,Sargas
251
+ 6556,Rasalhague
252
+ 6585,Cervantes
253
+ 6603,Cebalrai
254
+ 6618,Alruba
255
+ 6630,Fuyue
256
+ 6636,Dziban
257
+ 6688,Grumium
258
+ 6705,Eltanin
259
+ 6746,Alnasl
260
+ 6789,Yildun
261
+ 6812,Polis
262
+ 6859,Kaus Media
263
+ 6879,Kaus Australis
264
+ 6913,Kaus Borealis
265
+ 6945,Fafnir
266
+ 7001,Vega
267
+ 7106,Sheliak
268
+ 7116,Ainalrami
269
+ 7121,Nunki
270
+ 7141,Alya
271
+ 7178,Sulafat
272
+ 7194,Ascella
273
+ 7228,Polaris Australis
274
+ 7235,Okab
275
+ 7254,Meridiana
276
+ 7264,Albaldah
277
+ 7298,Aladfar
278
+ 7310,Altais
279
+ 7337,Arkab Prior
280
+ 7343,Arkab Posterior
281
+ 7348,Rukbat
282
+ 7405,Anser
283
+ 7417,Albireo
284
+ 7462,Alsafi
285
+ 7479,Sham
286
+ 7525,Tarazed
287
+ 7528,Fawaris
288
+ 7557,Altair
289
+ 7595,Libertas
290
+ 7597,Terebellum
291
+ 7602,Alshain
292
+ 7754,Algedi
293
+ 7773,Alshat
294
+ 7776,Dabih
295
+ 7790,Peacock
296
+ 7796,Sadr
297
+ 7852,Aldulfin
298
+ 7882,Rotanev
299
+ 7906,Sualocin
300
+ 7924,Deneb
301
+ 7949,Aljanah
302
+ 7950,Albali
303
+ 8030,Musica
304
+ 8131,Kitalpha
305
+ 8162,Alderamin
306
+ 8232,Sadalsuud
307
+ 8238,Alfirk
308
+ 8264,Bunda
309
+ 8278,Nashira
310
+ 8301,Azelfafage
311
+ 8308,Enif
312
+ 8322,Deneb Algedi
313
+ 8353,Aldhanab
314
+ 8414,Sadalmelik
315
+ 8417,Kurhah
316
+ 8425,Alnair
317
+ 8450,Biham
318
+ 8499,Ancha
319
+ 8518,Sadachbia
320
+ 8610,Situla
321
+ 8634,Homam
322
+ 8636,Tiaki
323
+ 8650,Matar
324
+ 8684,Sadalbari
325
+ 8709,Skat
326
+ 8728,Fomalhaut
327
+ 8729,Helvetios
328
+ 8773,Fumalsamakah
329
+ 8775,Scheat
330
+ 8781,Markab
331
+ 8880,Salm
332
+ 8905,Alkarab
333
+ 8930,Veritate
334
+ 8974,Errai
data/data/stars.bin ADDED
Binary file
data/lib/skymap/canvas.rb CHANGED
@@ -1,13 +1,22 @@
1
1
  # frozen_string_literal: true
2
2
 
3
3
  module Skymap
4
- Canvas = Data.define(:size, :padding) do
5
- def initialize(size:, padding:)
6
- unless padding >= 0 && padding < size / 2.0
4
+ Canvas = Data.define(:size, :padding, :print_size) do
5
+ def initialize(size:, padding:, print_size: nil)
6
+ unless size.is_a?(Numeric) && size.real? && size.finite? && size > 0
7
+ raise ArgumentError, "size must be a number above 0"
8
+ end
9
+
10
+ unless padding.is_a?(Numeric) && padding.real? && padding >= 0 &&
11
+ padding < size / 2.0
7
12
  raise ArgumentError,
8
13
  "padding must not be negative and must be less than half the size"
9
14
  end
10
15
 
16
+ unless print_size.nil? || print_size.is_a?(PrintSize)
17
+ raise ArgumentError, "print_size must be a Skymap::PrintSize"
18
+ end
19
+
11
20
  super
12
21
  end
13
22
 
@@ -0,0 +1,60 @@
1
+ # frozen_string_literal: true
2
+
3
+ require "csv"
4
+
5
+ module Skymap
6
+ module Catalog
7
+ class DeepSkyObjects
8
+ include Enumerable
9
+
10
+ PATH = File.expand_path("../../../data/deep_sky_objects.csv", __dir__)
11
+ MAGNITUDE_BANDS = {"V" => :visual, "B" => :blue}.freeze
12
+
13
+ def each
14
+ return enum_for(:each) unless block_given?
15
+
16
+ CSV.foreach(PATH, headers: true) do |row|
17
+ yield deep_sky_object_from(row)
18
+ end
19
+ end
20
+
21
+ private
22
+
23
+ def deep_sky_object_from(row)
24
+ DeepSkyObject.new(
25
+ designation: row["designation"],
26
+ name: row["name"],
27
+ type: row["type"].to_sym,
28
+ equatorial_coordinates: Astronoby::Coordinates::Equatorial.new(
29
+ right_ascension: Astronoby::Angle.from_hours(
30
+ row["right_ascension"].to_f
31
+ ),
32
+ declination: Astronoby::Angle.from_degrees(row["declination"].to_f),
33
+ epoch: Astronoby::JulianDate::J2000
34
+ ),
35
+ magnitude: row["magnitude"]&.to_f,
36
+ magnitude_band: magnitude_band(row["magnitude_band"]),
37
+ major_axis: arcminutes(row["major_axis"]),
38
+ minor_axis: arcminutes(row["minor_axis"]),
39
+ position_angle: position_angle(row["position_angle"])
40
+ )
41
+ end
42
+
43
+ def magnitude_band(value)
44
+ MAGNITUDE_BANDS.fetch(value) if value
45
+ end
46
+
47
+ def arcminutes(value)
48
+ return unless value
49
+
50
+ Astronoby::Angle.from_degrees(value.to_f / 60.0)
51
+ end
52
+
53
+ def position_angle(value)
54
+ return unless value
55
+
56
+ Astronoby::Angle.from_degrees(value.to_f)
57
+ end
58
+ end
59
+ end
60
+ end
@@ -0,0 +1,23 @@
1
+ # frozen_string_literal: true
2
+
3
+ require "csv"
4
+
5
+ module Skymap
6
+ module Catalog
7
+ class StarNames
8
+ PATH = File.expand_path("../../../data/star_names.csv", __dir__)
9
+
10
+ def [](hr)
11
+ names[hr]
12
+ end
13
+
14
+ private
15
+
16
+ def names
17
+ @names ||= CSV
18
+ .read(PATH, headers: true, encoding: "UTF-8")
19
+ .to_h { |row| [row["hr"].to_i, row["name"]] }
20
+ end
21
+ end
22
+ end
23
+ end