No commit activity in last 3 years
No release in over 3 years
Obtain the circumstances of recent and upcoming solar eclipses for any location
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.3
>= 0

Runtime

 Project Readme

USNO::Eclipse::Solar Code ClimateCoverage StatusBuild Status

Obtain the circumstances of recent and upcoming solar eclipses for any location

Installation

Add this line to your application's Gemfile:

gem 'usno-eclipse-solar'

And then execute:

$ bundle

Or install it yourself as:

$ gem install usno-eclipse-solar

Usage

First, require usno/eclipse/solar

By default, it'll check for the visibility data of the solar eclipse occurring on August 21, 2017. A location is always required.

August 21, 2017

USNO::Eclipse::Solar::Data.new(lat: 30, long: -87).call.data
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>Solar Eclipse Computer</title>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
</head>
<body>

<pre>
                          Solar Eclipse of 2017 Aug. 21                         
                     Sun in Partial Eclipse at this Location                    
                                 Delta T:  69.4s                                
     
                          None given                                            
                Location:  W 87°00'00.0", N30°00'00.0",     0m                
                   (Longitude referred to Greenwich meridian)                   
     
                                             Sun's           Position     Vertex
                          UT1         Altitude   Azimuth      Angle       Angle
                      d  h  m   s         °          °           °           °
   Eclipse Begins    21 17:04:27.5      68.9      146.7       304.2       333.4
   Maximum Eclipse   21 18:36:42.3      69.0      212.7
   Eclipse Ends      21 20:03:14.2      54.4      246.5       105.7        51.6
     
               Duration:   2h 58m 46.7s
              Magnitude:   0.840
            Obscuration:  80.5%
</pre>

<p><a href="javascript:history.go(-1)">Back to form</a></p>
</body>
</html>
USNO::Eclipse::Solar::Data.new(request_class: USNO::Eclipse::Solar::USRequest, city: "Gulf Shores", state: "Alabama", date: Time.new(2017,8,21)).call.data
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>Solar Eclipse Computer</title>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
</head>
<body>

<pre>
                          Solar Eclipse of 2017 Aug. 21                         
                     Sun in Partial Eclipse at this Location                    
                                 Delta T:  69.4s                                
     
                              GULF SHORES, ALABAMA                              
                Location:  W 87°41'24.0", N30°15'36.0",     0m                
                   (Longitude referred to Greenwich meridian)                   
     
                                             Sun's           Position     Vertex
                          UT1         Altitude   Azimuth      Angle       Angle
                      d  h  m   s         °          °           °           °
   Eclipse Begins    21 17:02:33.5      68.1      144.4       304.1       335.2
   Maximum Eclipse   21 18:34:44.6      69.3      209.5
   Eclipse Ends      21 20:01:35.1      55.1      245.0       105.6        52.5
     
               Duration:   2h 59m 01.7s
              Magnitude:   0.838
            Obscuration:  80.2%
</pre>

<p><a href="javascript:history.go(-1)">Back to form</a></p>
</body>
</html>

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request