| 1 | # Sun.pm,v 1.6 2005/01/07 12:18:59 lestrrat Exp | ||
| 2 | # | ||
| 3 | # Copyright (c) 2004-2007 Daisuke Maki <daisuke@endeworks.jp> | ||
| 4 | |||
| 5 | package DateTime::Util::Astro::Sun; | ||
| 6 | use strict; | ||
| 7 | use warnings; | ||
| 8 | use vars qw($VERSION @EXPORT_OK); | ||
| 9 | use Exporter; | ||
| 10 | use DateTime::Util::Astro; | ||
| 11 | BEGIN | ||
| 12 | { | ||
| 13 | *import = \&Exporter::import; | ||
| 14 | $VERSION = $DateTime::Util::Astro::VERSION; | ||
| 15 | @EXPORT_OK = qw( | ||
| 16 | solar_longitude | ||
| 17 | solar_longitude_after | ||
| 18 | solar_longitude_before | ||
| 19 | estimate_prior_solar_longitude | ||
| 20 | ); | ||
| 21 | } | ||
| 22 | |||
| 23 | use DateTime; | ||
| 24 | use DateTime::Util::Calc | ||
| 25 | qw(polynomial mod min max bf_downgrade angle bigfloat binary_search | ||
| 26 | moment dt_from_moment sin_deg cos_deg tan_deg asin_deg acos_deg); | ||
| 27 | use DateTime::Util::Astro::Common | ||
| 28 | qw(julian_centuries aberration nutation MEAN_TROPICAL_YEAR); | ||
| 29 | use POSIX(); | ||
| 30 | |||
| 31 | |||
| 32 | # [1] Table 12.1 p.183 (zero-padded to align veritcally) | ||
| 33 | use constant SOLAR_LONGITUDE_ARGS => [ | ||
| 34 | # X Y Z | ||
| 35 | # left side of table 12.1 | ||
| 36 | [ '403406', '270.54861', '0.9287892' ], | ||
| 37 | [ '119433', '63.91854', '35999.4089666' ], | ||
| 38 | [ '3891', '317.84300', '71998.2026100' ], | ||
| 39 | [ '1721', '240.05200', '36000.3572600' ], | ||
| 40 | [ '350', '247.23000', '32964.4678000' ], | ||
| 41 | [ '314', '297.82000', '445267.1117000' ], | ||
| 42 | [ '242', '166.79000', '3.1008000' ], | ||
| 43 | [ '158', '3.50000', '-19.9739000' ], | ||
| 44 | [ '129', '182.95000', '9038.0293000' ], | ||
| 45 | [ '99', '29.80000', '33718.1480000' ], | ||
| 46 | [ '86', '249.20000', '-2280.7730000' ], | ||
| 47 | [ '72', '257.80000', '31556.4930000' ], | ||
| 48 | [ '64', '69.90000', '9037.7500000' ], | ||
| 49 | [ '38', '197.10000', '-4444.1760000' ], | ||
| 50 | [ '32', '65.30000', '67555.3160000' ], | ||
| 51 | [ '28', '341.50000', '-4561.5400000' ], | ||
| 52 | [ '27', '98.50000', '1221.6550000' ], | ||
| 53 | [ '24', '110.00000', '31437.3690000' ], | ||
| 54 | [ '21', '342.60000', '-31931.7570000' ], | ||
| 55 | [ '18', '256.10000', '1221.9990000' ], | ||
| 56 | [ '14', '242.90000', '-4442.0390000' ], | ||
| 57 | [ '13', '151.80000', '119.0660000' ], | ||
| 58 | [ '12', '53.30000', '-4.5780000' ], | ||
| 59 | [ '10', '205.70000', '-39.1270000' ], | ||
| 60 | [ '10', '146.10000', '90073.7780000' ], | ||
| 61 | |||
| 62 | # right side of table 12.1 | ||
| 63 | [ '195207', '340.19128', '35999.1376958' ], | ||
| 64 | [ '112392', '331.26220', '35998.7287385' ], | ||
| 65 | [ '2819', '86.63100', '71998.4403000' ], | ||
| 66 | [ '660', '310.26000', '71997.4812000' ], | ||
| 67 | [ '334', '260.87000', '-19.4410000' ], | ||
| 68 | [ '268', '343.14000', '45036.8840000' ], | ||
| 69 | [ '234', '81.53000', '22518.4434000' ], | ||
| 70 | [ '132', '132.75000', '65928.9345000' ], | ||
| 71 | [ '114', '162.03000', '3034.7684000' ], | ||
| 72 | [ '93', '266.40000', '3034.4480000' ], | ||
| 73 | [ '78', '157.60000', '29929.9920000' ], | ||
| 74 | [ '68', '185.10000', '149.5880000' ], | ||
| 75 | [ '46', '8.00000', '107997.4050000' ], | ||
| 76 | [ '37', '250.40000', '151.7710000' ], | ||
| 77 | [ '29', '162.70000', '31556.0800000' ], | ||
| 78 | [ '27', '291.60000', '107996.7060000' ], | ||
| 79 | [ '25', '146.70000', '62894.1670000' ], | ||
| 80 | [ '21', '5.20000', '14578.2980000' ], | ||
| 81 | [ '20', '230.90000', '34777.2430000' ], | ||
| 82 | [ '17', '45.30000', '62894.5110000' ], | ||
| 83 | [ '13', '115.20000', '107997.9090000' ], | ||
| 84 | [ '13', '285.30000', '16859.0710000' ], | ||
| 85 | [ '10', '126.60000', '26895.2920000' ], | ||
| 86 | [ '10', '85.90000', '12297.5360000' ] | ||
| 87 | ]; | ||
| 88 | |||
| 89 | BEGIN | ||
| 90 | { | ||
| 91 | # prep args as BigFloats during compilation | ||
| 92 | foreach my $numbers (@{ SOLAR_LONGITUDE_ARGS() }) { | ||
| 93 | map { $_ = Math::BigFloat->new($_) } @$numbers; | ||
| 94 | } | ||
| 95 | } | ||
| 96 | use constant SOLAR_YEAR_RATE => Math::BigFloat->new(MEAN_TROPICAL_YEAR) / 360; | ||
| 97 | use constant SOLAR_LONGITUDE_ALLOWED_DELTA => 10 ** -5; | ||
| 98 | |||
| 99 | # [1] p.182 | ||
| 100 | sub solar_longitude | ||
| 101 | { | ||
| 102 | my $dt = shift; | ||
| 103 | my $c = julian_centuries($dt); | ||
| 104 | my $big_ugly_number = Math::BigFloat->new(0); | ||
| 105 | |||
| 106 | foreach my $numbers (@{ SOLAR_LONGITUDE_ARGS() }) { | ||
| 107 | $big_ugly_number += $numbers->[0] * | ||
| 108 | sin_deg($numbers->[1] + $numbers->[2] * $c) | ||
| 109 | } | ||
| 110 | |||
| 111 | my $longitude = | ||
| 112 | Math::BigFloat->new("282.7771834") + | ||
| 113 | Math::BigFloat->new("36000.76953744") * $c + | ||
| 114 | Math::BigFloat->new("0.000005729577951308232") * $big_ugly_number; | ||
| 115 | |||
| 116 | my $aberration = aberration($dt); | ||
| 117 | my $nutation = nutation($dt); | ||
| 118 | my $sum = $longitude + $aberration + $nutation; | ||
| 119 | |||
| 120 | return mod($sum, 360); | ||
| 121 | } | ||
| 122 | |||
| 123 | # [1] p.184 | ||
| 124 | sub solar_longitude_after | ||
| 125 | { | ||
| 126 | my($dt, $phi) = @_; | ||
| 127 | |||
| 128 | my $m = moment($dt); | ||
| 129 | my $n = SOLAR_YEAR_RATE * | ||
| 130 | mod( bigfloat($phi) - solar_longitude($dt), 360); | ||
| 131 | |||
| 132 | my $tau = $m + $n; | ||
| 133 | my $l = max(moment($dt), $tau - 5); | ||
| 134 | my $u = $tau + 5; | ||
| 135 | my $rv = binary_search($l, $u, | ||
| 136 | sub { abs($_[0] - $_[1]) <= SOLAR_LONGITUDE_ALLOWED_DELTA }, | ||
| 137 | sub { mod(solar_longitude(dt_from_moment($_[0])) - $phi, 360) < 180 } ); | ||
| 138 | return dt_from_moment($rv); | ||
| 139 | } | ||
| 140 | |||
| 141 | sub solar_longitude_before | ||
| 142 | { | ||
| 143 | my($dt, $phi) = @_; | ||
| 144 | |||
| 145 | my $tau = moment(estimate_prior_solar_longitude($dt, $phi)); | ||
| 146 | my $l = $tau - 5; | ||
| 147 | my $u = min(moment($dt), $tau + 5); | ||
| 148 | |||
| 149 | my $rv = binary_search($l, $u, | ||
| 150 | sub { abs($_[0] - $_[1]) <= SOLAR_LONGITUDE_ALLOWED_DELTA }, | ||
| 151 | sub { mod(solar_longitude(dt_from_moment($_[0])) - $phi, 360) < 180 } ); | ||
| 152 | return dt_from_moment($rv); | ||
| 153 | } | ||
| 154 | |||
| 155 | # [1] p.203 | ||
| 156 | sub estimate_prior_solar_longitude | ||
| 157 | { | ||
| 158 | my($dt, $phi) = @_; | ||
| 159 | |||
| 160 | my $moment = moment($dt); | ||
| 161 | my $tau = $moment - SOLAR_YEAR_RATE * | ||
| 162 | mod(solar_longitude($dt) - $phi, 360); | ||
| 163 | my $delta = mod(solar_longitude( | ||
| 164 | dt_from_moment($tau)) - $phi + 180, 360) - 180; | ||
| 165 | |||
| 166 | my $rv = min($moment, $tau - SOLAR_YEAR_RATE * $delta); | ||
| 167 | return dt_from_moment($rv); | ||
| 168 | |||
| 169 | } | ||
| 170 | |||
| 171 | # [1] p.198, errata 179 | ||
| 172 | sub sine_offset | ||
| 173 | { | ||
| 174 | my($dt, $location, $alpha) = @_; | ||
| 175 | my $phi = $location->latitude; | ||
| 176 | my $delta = asin_deg( | ||
| 177 | sin_deg(obliquity($dt)) * | ||
| 178 | sin_deg(solar_longitude($dt)) | ||
| 179 | ); | ||
| 180 | return tan_deg($phi) * tan_deg($delta) + | ||
| 181 | (sin_deg($alpha) / (cos_deg($delta) * cos_deg($phi))); | ||
| 182 | } | ||
| 183 | |||
| 184 | # [1] p.198, errata 179 | ||
| 185 | sub approx_moment_of_depression | ||
| 186 | { | ||
| 187 | my($dt, $location, $alpha, $morning) = @_; | ||
| 188 | |||
| 189 | my $try = sine_offset($dt, $location, $alpha); | ||
| 190 | my $date = POSIX::floor(moment($dt)); | ||
| 191 | my $alt = $alpha >= 0 ? | ||
| 192 | ($morning ? $date : $date + 1) : | ||
| 193 | $date + 0.5; | ||
| 194 | my $value = abs($try) > 1 ? | ||
| 195 | sine_offset(dt_from_moment($alt), $location, $alpha) : | ||
| 196 | $try; | ||
| 197 | |||
| 198 | if (abs($value) <= 1) { | ||
| 199 | return moment( local_from_apparent( | ||
| 200 | dt_from_moment( | ||
| 201 | $date + 0.5 + | ||
| 202 | ($morning ? -1 : 1) * | ||
| 203 | (mod(0.5 + asin_deg($value) / 360, 1) - 0.25) | ||
| 204 | ) | ||
| 205 | )); | ||
| 206 | } else { | ||
| 207 | return undef; | ||
| 208 | } | ||
| 209 | } | ||
| 210 | |||
| 211 | 1; | ||
| 212 | |||
| 213 | __END__ |