Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/djben/starrynight
Star and constellation query in Swift 4. 15000+ stars within 7th magnitude (can be extended). Star Catalogs including HR, HD, HIP, Gould and Bayer-Flamsteed designations.
https://github.com/djben/starrynight
astronomy carthage constellation swift-4
Last synced: about 20 hours ago
JSON representation
Star and constellation query in Swift 4. 15000+ stars within 7th magnitude (can be extended). Star Catalogs including HR, HD, HIP, Gould and Bayer-Flamsteed designations.
- Host: GitHub
- URL: https://github.com/djben/starrynight
- Owner: DJBen
- Created: 2017-09-29T07:04:25.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2017-12-30T03:12:40.000Z (over 6 years ago)
- Last Synced: 2024-09-24T20:38:12.913Z (1 day ago)
- Topics: astronomy, carthage, constellation, swift-4
- Language: Swift
- Homepage:
- Size: 5.89 MB
- Stars: 14
- Watchers: 3
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# StarryNight
[](https://swift.org)
[](http://www.gnu.org/licenses/gpl-3.0)
[](https://github.com/Carthage/Carthage)
[](https://travis-ci.org/DJBen/StarryNight)
## Overview
_StarryNight is all you need for curiosity towards stars and constellations._
- Database of 15000+ stars within 7th magnitude.
- [Star Catalogs](https://en.wikipedia.org/wiki/Star_catalogue) including HR, HD, HIP, [Gould](https://en.wikipedia.org/wiki/Gould_designation) and [Bayer](https://en.wikipedia.org/wiki/Bayer_designation)-[Flamsteed](https://en.wikipedia.org/wiki/Flamsteed_designation) designations.
- Celestial coordinate and proper motion.
- Visual and absolute magnitude, luminance, spectral type, binary star info, and other physical properties.
- Extended Constellation support.
- Position query and inverse position query.
- Constellation line and constellation border.
- Abbreviation, genitive and etymology.
## Installation
### Carthage
github "DJBen/StarryNight" ~> 0.3.0
## Usage
### Stars
1. All stars brighter than...
```swift
Star.magitudeLessThan(7)
```
2. Star with specific designation.
```swift
Star.hr(9077)
Star.hd(224750)
Star.hip(25)
```
3. Star closest to specific celestial coordinate.
This is very useful to locate the closest star to user input.
```swift
let coord = Vector3.init(equatorialCoordinate: EquatorialCoordinate.init(rightAscension: radians(hours: 5, minutes: 20), declination: radians(degrees: 10), distance: 1)).normalized()
Star.closest(to: coord, maximumMagnitude: 2.5)
// Bellatrix
```
### Constellations
1. Constellation with name or [IAU symbol](https://www.iau.org/public/themes/constellations/).
```swift
Constellation.iau("Tau")
Constellation.named("Orion")
```
2. Constellation that contains specific celestial coordinate.
This is very useful to locate the constellation that contains the region of user input.
It is implemented as a category on `EquatorialCoordinate`. See [SpaceTime](https://github.com/DJBen/SpaceTime) repo for implementation and usage of coordinate classes.
```swift
let coord = EquatorialCoordinate.init(rightAscension: 1.547, declination: 0.129, distance: 1)
coord.constellation
// Orion
```
3. Neighboring constellations and centers.
```swift
// Get a set of neighboring constellations
Constellation.iau("Ori").neighbors
// Get the coordinate of center(s) of current constellation
Constellation.iau("Ori").displayCenters
```
*Note*: `displayCenters` returns an array of one element for all constellations except Serpens, which will include two elements - one center for Serpens Caput and the other for Serpens Cauda.
## Remarks
Data extracted from [HYG database](https://github.com/astronexus/HYG-Database) and processed into SQLite. The star catalog has been trimmed to 7th magnitude to reduce file size. Feel free to download the full catalog and import into SQLite whenever you see fit.