Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kelvins/sunrisesunset
:sunrise: Go package that provides the sunrise and sunset equation
https://github.com/kelvins/sunrisesunset
go golang sunrise sunrise-equation sunset
Last synced: 3 days ago
JSON representation
:sunrise: Go package that provides the sunrise and sunset equation
- Host: GitHub
- URL: https://github.com/kelvins/sunrisesunset
- Owner: kelvins
- License: mit
- Archived: true
- Created: 2017-03-24T01:04:23.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2023-04-19T16:57:32.000Z (over 1 year ago)
- Last Synced: 2024-10-30T23:43:22.607Z (11 days ago)
- Topics: go, golang, sunrise, sunrise-equation, sunset
- Language: Go
- Homepage:
- Size: 26.4 KB
- Stars: 76
- Watchers: 5
- Forks: 16
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
> :warning: This project is no longer being maintained :warning:
>
> Consider using a forked version of this repository or another project like [go-sunrise](https://github.com/nathan-osman/go-sunrise).
Sunrise Sunset Package
==========================
[](LICENSE)
[](https://travis-ci.org/kelvins/sunrisesunset)
[](https://coveralls.io/github/kelvins/sunrisesunset?branch=master)
[](https://goreportcard.com/report/github.com/kelvins/sunrisesunset)
Go package used to calculate the apparent sunrise and sunset times based on latitude, longitude, date and UTC offset.
You can use go get command:
go get github.com/kelvins/sunrisesunset
General
----
This package was created based on the [Corrected Sunrise, Sunset, Noon Times in Seconds - and Solar Angles][1] Matlab function developed by Richard Droste, that was created based on the [spreadsheets][2] available in the [Earth System Research Laboratory][3] website from the [National Oceanic & Atmospheric Administration (NOAA)][4].
Based on the [Solar Calculation Details][5]:
> The calculations in the NOAA Sunrise/Sunset and Solar Position Calculators are based on equations from Astronomical Algorithms, by Jean Meeus. The sunrise and sunset results are theoretically accurate to within a minute for locations between +/- 72° latitude, and within 10 minutes outside of those latitudes. However, due to variations in atmospheric composition, temperature, pressure and conditions, observed values may vary from calculations.
[Apparent Sunrise/Sunset][6]:
> Due to atmospheric refraction, sunrise occurs shortly before the sun crosses above the horizon. Light from the sun is bent, or refracted, as it enters earth's atmosphere. See [Apparent Sunrise Figure][7]. This effect causes the apparent sunrise to be earlier than the actual sunrise. Similarly, apparent sunset occurs slightly later than actual sunset. The sunrise and sunset times reported in our calculator have been corrected for the approximate effects of atmospheric refraction. However, it should be noted that due to changes in air pressure, relative humidity, and other quantities, we cannot predict the exact effects of atmospheric refraction on sunrise and sunset time. Also note that this possible error increases with higher (closer to the poles) latitudes.
Usage
----
``` go
package main
import (
"fmt"
"time"
"github.com/kelvins/sunrisesunset"
)
func main() {
// You can use the Parameters structure to set the parameters
p := sunrisesunset.Parameters{
Latitude: -23.545570,
Longitude: -46.704082,
UtcOffset: -3.0,
Date: time.Date(2017, 3, 23, 0, 0, 0, 0, time.UTC),
}
// Calculate the sunrise and sunset times
sunrise, sunset, err := p.GetSunriseSunset()
// If no error has occurred, print the results
if err == nil {
fmt.Println("Sunrise:", sunrise.Format("15:04:05")) // Sunrise: 06:11:44
fmt.Println("Sunset:", sunset.Format("15:04:05")) // Sunset: 18:14:27
} else {
fmt.Println(err)
}
}
```
License
----
This project was created under the [MIT license][8]
[1]: https://www.mathworks.com/matlabcentral/fileexchange/62180-corrected-sunrise--sunset--noon-times-in-seconds-and-solar-angles?requestedDomain=www.mathworks.com
[2]: https://www.esrl.noaa.gov/gmd/grad/solcalc/calcdetails.html
[3]: https://www.esrl.noaa.gov/
[4]: http://www.noaa.gov/
[5]: https://www.esrl.noaa.gov/gmd/grad/solcalc/calcdetails.html
[6]: https://www.esrl.noaa.gov/gmd/grad/solcalc/glossary.html#A
[7]: https://www.esrl.noaa.gov/gmd/grad/solcalc/apparent_sunrise.gif
[8]: LICENSE