tranzito_utils 1.2.1 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 91051949d5689eb724426c9dc4c233f2b6f71eb0d411d63ca0037676b8338cea
-  data.tar.gz: 9380a70b1a4e798be1ee05d4b183d03f939abc194d0ea0e1d536fd7efe2bf851
+  metadata.gz: f9200b266283acc5bca16516873cfa19fd2df8f3da6ebdf3c00678224f797ff5
+  data.tar.gz: 3bb4b8c641003c58dbca7925b82fce1e9e9d536a8127bf545587de01a11611a8
 SHA512:
-  metadata.gz: a618433b4284b261862e73f4bde3ef116012f1dfb2cbc415837027f4c07abb4569b92de1d75dec6fc678d6f0244c0d467c1044bcdde524e674ee0ea2268e5d53
-  data.tar.gz: e2e8649aeadce46d8885a3d401021694a7eaae01ffe418ef0358b450f45c423789a59446e4cf16e5d06e764eb8cba8d4bea93d154f934137443bcf4d5881e70f
+  metadata.gz: a3bab2fe8fa1c67a8fe1aaee70d8ff6737ab22429cd9392012cf403ee7f519ac8ec18569e54ee335a4a7a16d1976fcebe7e1d733cbb0098e66b5085aa29b4bc9
+  data.tar.gz: 6586213cd8e7dabfcf5eb483c41ec57167eacca52e51d5d5de1d54d4b3b5730eb2908e64f54b5dee68e80c1ff3f593c2564fe56159f23afe2be5436c7559298e

data/lib/tranzito_utils/services/solar_position_calculator.rb

@@ -0,0 +1,85 @@
+class SolarPositionCalculator
+  LATITUDE_RANGE = (-90..90)
+  LONGITUDE_RANGE = (-180..180)
+
+  attr_reader :latitude, :longitude, :timezone
+
+  def initialize(latitude, longitude, timezone)
+    validate_latitude(latitude)
+    validate_longitude(longitude)
+    @latitude = latitude
+    @longitude = longitude
+    @timezone = timezone
+  end
+
+  def sunrise_time(date)
+    calculate_sun_time(date, :sunrise)
+  end
+
+  def sunset_time(date)
+    calculate_sun_time(date, :sunset)
+  end
+
+  private
+
+  def calculate_sun_time(date, type)
+    validate_date(date)
+    utc_time = calculate_utc_time(date, type)
+    utc_to_timezone(date, utc_time)
+  end
+
+  def calculate_utc_time(date, type)
+    time = Time.new(date.year, date.month, date.day, 12, 0, 0, timezone)
+    gamma = calculate_gamma(time)
+    eqtime = calculate_eqtime(gamma)
+
+    decl = calculate_decl(gamma)
+    ha = calculate_ha(decl)
+    calculate_sun_time_utc(ha, eqtime, type)
+  end
+
+  def calculate_sun_time_utc(ha, eqtime, type)
+    if type == :sunrise
+      720 - 4 * (longitude + ha * 180 / Math::PI) - eqtime
+    else
+      720 - 4 * (longitude - ha * 180 / Math::PI) - eqtime
+    end
+  end
+
+  def calculate_gamma(time)
+    2 * Math::PI / (leap_year?(time.year) ? 366 : 365) * (time.yday - 1 + (time.hour - 12) / 24.0)
+  end
+
+  def calculate_eqtime(gamma)
+    229.18 * (0.000075 + 0.001868 * Math.cos(gamma) - 0.032077 * Math.sin(gamma) - 0.014615 * Math.cos(2 * gamma) - 0.040849 * Math.sin(2 * gamma))
+  end
+
+  def calculate_decl(gamma)
+    0.006918 - 0.399912 * Math.cos(gamma) + 0.070257 * Math.sin(gamma) - 0.006758 * Math.cos(2 * gamma) + 0.000907 * Math.sin(2 * gamma) - 0.002697 * Math.cos(3 * gamma) + 0.00148 * Math.sin(3 * gamma)
+  end
+
+  def calculate_ha(decl)
+    Math.acos(Math.cos(Math::PI / 180 * 90.833) / (Math.cos(Math::PI / 180 * latitude) * Math.cos(decl)) - Math.tan(Math::PI / 180 * latitude) * Math.tan(decl))
+  end
+
+  def utc_to_timezone(date, utc_time)
+    response = Time.parse("#{date} #{Time.at(utc_time * 60).utc.strftime("%H:%M:%S")}") + timezone * 3600
+    response.strftime("%H:%M:%S")
+  end
+
+  def leap_year?(year)
+    year % 4 == 0 && (year % 100 != 0 || year % 400 == 0)
+  end
+
+  def validate_latitude(latitude)
+    raise ArgumentError, "Latitude should be between -90 and 90 degrees" unless LATITUDE_RANGE.include?(latitude)
+  end
+
+  def validate_longitude(longitude)
+    raise ArgumentError, "Longitude should be between -180 and 180 degrees" unless LONGITUDE_RANGE.include?(longitude)
+  end
+
+  def validate_date(date)
+    raise ArgumentError, "Invalid date" unless date.is_a?(Date)
+  end
+end

data/lib/tranzito_utils/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module TranzitoUtils
-  VERSION = "1.2.1"
+  VERSION = "1.3.0"
 end

data/lib/tranzito_utils.rb

@@ -21,4 +21,5 @@ require "tranzito_utils/helpers/sortable_helper"
 require "tranzito_utils/helpers/helpers"
 require "tranzito_utils/services/time_parser"
 require "tranzito_utils/services/normalize"
+require "tranzito_utils/services/solar_position_calculator"
 require "tranzito_utils/gem"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tranzito_utils
 version: !ruby/object:Gem::Version
-  version: 1.2.1
+  version: 1.3.0
 platform: ruby
 authors:
 - willbarrettdev
@@ -10,7 +10,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-03-07 00:00:00.000000000 Z
+date: 2023-06-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -112,6 +112,7 @@ files:
 - lib/tranzito_utils/helpers/helpers.rb
 - lib/tranzito_utils/helpers/sortable_helper.rb
 - lib/tranzito_utils/services/normalize.rb
+- lib/tranzito_utils/services/solar_position_calculator.rb
 - lib/tranzito_utils/services/time_parser.rb
 - lib/tranzito_utils/version.rb
 homepage: https://github.com/Tranzito/tranzito_utils