skymap 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4c452f10b960f7fd529a6c7b686d4a002ee424966aaf725d02d6136cafbb3f39
-  data.tar.gz: 1f62d95726d712568a243ff936c16b3eb1154f31c8c16909575026dccef04070
+  metadata.gz: cba0dd14eac8a3901897eab60754b42d72578a76e3002cf72d4d4dfb60521154
+  data.tar.gz: 047d0c215243bb41187168771903b25715110258d9ec30972b989ed31165b3d4
 SHA512:
-  metadata.gz: 815b9cca8e47e204b3ded57575169dfbc6b534246e2bc62b3fdb1c60770e3894b6c1e1215a04a7af3d239f9403a91861c11118926170df577b3923ed8c2f9e0b
-  data.tar.gz: 8eaa436a22575fcf838b8d6898d1cff408acacfae56f17e15675dd513e092207f78db778c1e3d0da0ecd99603747b8715752029e04941b2edbb709d894e94a5a
+  metadata.gz: 15a0044d63c48a7c5d4dd38dab1ad8813c07c22604ba4f4bdfe1fdc94d3e3ba3b41a7ab1f91717a44259df6383ad395cefcd2dded2dddb0fc3974d836c0df18e
+  data.tar.gz: 43593b4038218584d309510ea9be9fc4f62de27be968381f7791c20f49be60cabc876aa7e28fab6b252ad8fa9ebadd1b71f78203e71a49efae65db335ef2e18f

data/CHANGELOG.md

@@ -7,6 +7,137 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.5.0] - 2026-11-07
+
+### Added
+
+- `Skymap::Layers::DeepSkyObjects` draws deep-sky objects, such as the ones of
+  `Skymap::Catalog::DeepSkyObjects`, with a symbol for each type, at their real
+  size and with their position angle when they are larger than the symbol, and
+  with their designation as a label with `labels: true`. Objects of magnitude 11
+  or brighter are drawn by default
+- `deep_sky`, an optional color of `Skymap::Theme` for the symbols and the
+  labels of the deep-sky objects, that falls back to `constellation_name`
+- `Skymap::Context#rotation_at` turns a position angle at equatorial
+  coordinates into the rotation of the map, as an `Astronoby::Angle`
+- `data/deep_sky_objects.csv`, `Skymap::Catalog::DeepSkyObjects` and
+  `Skymap::DeepSkyObject` give the 109 Messier objects and the 1,496 NGC and 136
+  IC objects of magnitude 12 or brighter (galaxies, clusters, nebulae and more)
+  with their coordinates, type, magnitude, size and position angle, from
+  OpenNGC. The `magnitude_band` (`:visual`, or `:blue` for the 65 objects that
+  have no visual magnitude) says what the magnitude is, and `messier?` tells
+  the Messier objects from the others. An object with a `major_axis` and no
+  `minor_axis` is round: its `minor_axis` is its `major_axis`. The data file is
+  released under CC BY-SA 4.0, with its license in
+  `data/LICENSE-deep_sky_objects.txt`; the code stays under the MIT license
+- `Skymap::Catalog::Stars` gives the proper motion, the parallax and the radial
+  velocity of the stars, and `Skymap::Star` takes the optional
+  `proper_motion_ra:`, `proper_motion_dec:` (`Astronoby::AngularVelocity`),
+  `parallax:` (`Astronoby::Angle`) and `radial_velocity:`
+  (`Astronoby::Velocity`)
+- `Skymap::Star#coordinates_at` gives the equatorial coordinates of a star at an
+  `Astronoby::Instant`, with its proper motion applied, as
+  `Astronoby::Coordinates::Equatorial` at J2000. A star with a proper motion
+  must have coordinates at J2000, or `Skymap::Star` raises an `ArgumentError`
+- `Skymap::Context#possibly_visible?` tells whether a star can be drawn on the
+  chart, above the horizon and in the view, without applying its proper motion,
+  so that the layers of stars skip the stars far from a zoomed view
+- `Skymap::View` zooms the map on an area of the sky, given by the equatorial
+  or horizontal coordinates of its center and a field of view as an
+  `Astronoby::Angle`, with `view:` on `Skymap::Chart`, with the horizon drawn as
+  a line when it is in the view, and the Sun and the Moon at their size in the
+  sky when it is larger than their usual size on the map
+- `Skymap::View` takes `orientation:` (`:zenith_up` by default, or `:equatorial`
+  to put the north celestial pole at the top), `rotation:` as an
+  `Astronoby::Angle` and `mirrored:` to give the map the orientation of a
+  telescope
+- `Skymap::Layers::Grid` draws the celestial coordinate grid, the lines of
+  right ascension and the circles of declination, every `step:` angle (30
+  degrees by default), stopping at the horizon
+- `epoch: :of_date` on `Skymap::Layers::Grid` draws the grid in the true
+  equator and equinox of the date of the chart, centered on the true celestial
+  pole, instead of J2000 (the default)
+- `Skymap::Layers::Scale` draws a scale bar with a round angular length, such
+  as `30′`, in the lower left of a map with a view
+- `print_size:` on `Skymap::Canvas`, with `Skymap::PrintSize`, writes the SVG at
+  a physical size in millimeters, centimeters or inches, for example the
+  width of an A4 sheet with `Skymap::PrintSize.paper(:a4)`
+- `Skymap::Layers::FieldCircles` draws circles of given true fields around the
+  center of the view or a point of your choice, with their labels, to show what
+  a finder scope or an eyepiece covers
+- `Skymap::Telescope`, `Skymap::Eyepiece` and `Skymap::Setup` describe the
+  equipment and compute the magnification, the true field as an
+  `Astronoby::Angle` and a label such as `25 mm, 48×, 1.1°`, and
+  `Skymap::Field` is a named field, such as a finder scope or a Telrad ring
+- `Skymap::Theme` has optional colors, which fall back to the color of another
+  one when they are not given, so that a theme built with `Skymap::Theme.new`
+  for an earlier version keeps working: `grid` falls back to `boundary`,
+  `scale` to `star_name` and `field_circle` to `planet`
+- `data/stars.bin` gives 130,556 stars down to magnitude 9, the 9,096 stars of
+  the Yale Bright Star Catalogue and 121,460 more from Tycho-2, with a proper
+  motion for all but 6 of them, and a parallax and a radial velocity from Gaia
+  DR3 and Hipparcos for most (97% and 79% of the new stars). It is generated by
+  `bin/build_stars` and released under CC BY-NC 3.0 IGO, as the ESA data it
+  merges are, with its license in `data/LICENSE-stars.txt`; a use that
+  generates a financial gain needs the authorization of ESA, and the code stays
+  under the MIT license
+- `Skymap::Catalog::Stars#search` gives the stars brighter than a
+  `magnitude_limit:` and inside a `cone:`, and `#by_hr` the stars of the Bright
+  Star Catalogue by Harvard Revised number, without building the other ones
+- `Skymap::Cone` is an area of the sky, given by the equatorial coordinates of
+  its center at J2000 and a radius as an `Astronoby::Angle`, and
+  `Skymap::Context#cone` gives the one that covers a view, with room for
+  precession, nutation, aberration and proper motion
+- `Skymap::StarList` gives a list of `Skymap::Star` the same `search` and
+  `by_hr` as the catalog, so that the layers take both
+
+### Changed
+
+- Labels of stars, planets, deep-sky objects and fields no longer overlap other
+  labels, the symbols of deep-sky objects, planets, the Sun and the Moon, or
+  bright stars. A label that does not fit beside its object moves to another
+  side of it, and one with no room at all is left out.
+  `Skymap::Layers::DeepSkyObjects` gives the brighter objects the room first
+- The lit side of `Skymap::Layers::Moon` faces the Sun on the map, wherever
+  the Moon is and in every orientation of the view, instead of being drawn as
+  the observer sees it from the ground
+- Equatorial coordinates given to `Skymap::Context#horizontal_coordinates`, and
+  as the center of a `Skymap::View`, can be at J2000 or at the date of the
+  chart, and any other epoch now raises an `ArgumentError` (it was an
+  `Astronoby::IncompatibleArgumentsError`)
+- Stars are drawn at their position at the date of the chart, with their proper
+  motion applied from J2000, instead of at their catalog position: the positions
+  of stars in existing charts change, visibly only in charts with a field of
+  view under a degree. A star without a proper motion does not move
+- `Skymap::Catalog::Stars` gives the stars down to magnitude 9 instead of the
+  9,096 of the Bright Star Catalogue, so give the layers the catalog itself
+  instead of `to_a`: the layers of stars, star names and constellations read
+  only what they draw, which takes about 2 ms for a 1 degree view and 24 ms for
+  a 10 degree view at magnitude 9. A star has no
+  `hr` outside the Bright Star Catalogue, and `Skymap::Star.by_hr` leaves it out
+- `Skymap::Layers::Stars` draws the faintest stars first, so that the brighter
+  ones are never covered by a fainter one, whatever the order of the stars
+- `data/stars.csv` is no longer in the gem: it is the extract of the Bright Star
+  Catalogue that `bin/build_stars` reads
+- The gemspec lists the licenses of the data files shipped with the gem, CC
+  BY-SA 4.0 and CC BY-NC 3.0 IGO, next to the MIT license of the code
+- `Skymap::Canvas` raises an `ArgumentError` for a `size` that is not a number
+  above 0, and `Skymap::Star` for an `hr` that is not a positive integer, for
+  coordinates that are not equatorial and for a magnitude that is not a finite
+  number. They used to be accepted, or to fail later with a `NoMethodError`
+- `Skymap::Layers::Stars`, `Skymap::Layers::StarNames`,
+  `Skymap::Layers::Planets` and `Skymap::Layers::DeepSkyObjects` raise an
+  `ArgumentError` when they are created with a `magnitude_limit:` that is not a
+  finite number, instead of a `NoMethodError` when they draw. `magnitude_limit:`
+  of `Skymap::Layers::StarNames` can still be `nil` to name every star
+
+### Fixed
+
+- `Skymap::Catalog::StarRecords.encode`, which `bin/build_stars` uses, raises an
+  `ArgumentError` for a value that does not fit in `data/stars.bin`, such as a
+  proper motion above 32,767 mas/yr, instead of writing a wrong one, and keeps a
+  star at the celestial pole instead of moving it to the opposite pole
+
 ## [0.4.0] - 2026-11-05
 
 ### Added
@@ -98,7 +229,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Initial release to reserve the gem name on RubyGems.org
 
-[Unreleased]: https://github.com/rhannequin/skymap/compare/v0.4.0...HEAD
+[Unreleased]: https://github.com/rhannequin/skymap/compare/v0.5.0...HEAD
+[0.5.0]: https://github.com/rhannequin/skymap/compare/v0.4.0...v0.5.0
 [0.4.0]: https://github.com/rhannequin/skymap/compare/v0.3.0...v0.4.0
 [0.3.0]: https://github.com/rhannequin/skymap/compare/v0.2.0...v0.3.0
 [0.2.0]: https://github.com/rhannequin/skymap/compare/v0.1.0...v0.2.0