suntrack 0.0.2 → 0.0.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- data/doc/Suntrack.html +581 -0
- data/doc/_index.html +131 -0
- data/doc/class_list.html +53 -0
- data/doc/file_list.html +52 -0
- data/doc/frames.html +28 -0
- data/doc/index.html +131 -0
- data/doc/method_list.html +228 -0
- data/doc/top-level-namespace.html +117 -0
- data/lib/suntrack.rb +16 -8
- data/lib/suntrack/Point3D.rb +10 -0
- data/lib/suntrack/RAstro.rb +4 -0
- metadata +11 -2
data/doc/Suntrack.html
ADDED
|
@@ -0,0 +1,581 @@
|
|
|
1
|
+
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
|
|
2
|
+
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
3
|
+
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
|
|
4
|
+
<head>
|
|
5
|
+
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
6
|
+
<title>
|
|
7
|
+
Class: Suntrack
|
|
8
|
+
|
|
9
|
+
— Documentation by YARD 0.8.2.1
|
|
10
|
+
|
|
11
|
+
</title>
|
|
12
|
+
|
|
13
|
+
<link rel="stylesheet" href="css/style.css" type="text/css" media="screen" charset="utf-8" />
|
|
14
|
+
|
|
15
|
+
<link rel="stylesheet" href="css/common.css" type="text/css" media="screen" charset="utf-8" />
|
|
16
|
+
|
|
17
|
+
<script type="text/javascript" charset="utf-8">
|
|
18
|
+
hasFrames = window.top.frames.main ? true : false;
|
|
19
|
+
relpath = '';
|
|
20
|
+
framesUrl = "frames.html#!" + escape(window.location.href);
|
|
21
|
+
</script>
|
|
22
|
+
|
|
23
|
+
|
|
24
|
+
<script type="text/javascript" charset="utf-8" src="js/jquery.js"></script>
|
|
25
|
+
|
|
26
|
+
<script type="text/javascript" charset="utf-8" src="js/app.js"></script>
|
|
27
|
+
|
|
28
|
+
|
|
29
|
+
</head>
|
|
30
|
+
<body>
|
|
31
|
+
<div id="header">
|
|
32
|
+
<div id="menu">
|
|
33
|
+
|
|
34
|
+
<a href="_index.html">Index (S)</a> »
|
|
35
|
+
|
|
36
|
+
|
|
37
|
+
<span class="title">Suntrack</span>
|
|
38
|
+
|
|
39
|
+
|
|
40
|
+
<div class="noframes"><span class="title">(</span><a href="." target="_top">no frames</a><span class="title">)</span></div>
|
|
41
|
+
</div>
|
|
42
|
+
|
|
43
|
+
<div id="search">
|
|
44
|
+
|
|
45
|
+
<a class="full_list_link" id="class_list_link"
|
|
46
|
+
href="class_list.html">
|
|
47
|
+
Class List
|
|
48
|
+
</a>
|
|
49
|
+
|
|
50
|
+
<a class="full_list_link" id="method_list_link"
|
|
51
|
+
href="method_list.html">
|
|
52
|
+
Method List
|
|
53
|
+
</a>
|
|
54
|
+
|
|
55
|
+
<a class="full_list_link" id="file_list_link"
|
|
56
|
+
href="file_list.html">
|
|
57
|
+
File List
|
|
58
|
+
</a>
|
|
59
|
+
|
|
60
|
+
</div>
|
|
61
|
+
<div class="clear"></div>
|
|
62
|
+
</div>
|
|
63
|
+
|
|
64
|
+
<iframe id="search_frame"></iframe>
|
|
65
|
+
|
|
66
|
+
<div id="content"><h1>Class: Suntrack
|
|
67
|
+
|
|
68
|
+
|
|
69
|
+
|
|
70
|
+
</h1>
|
|
71
|
+
|
|
72
|
+
<dl class="box">
|
|
73
|
+
|
|
74
|
+
<dt class="r1">Inherits:</dt>
|
|
75
|
+
<dd class="r1">
|
|
76
|
+
<span class="inheritName">Object</span>
|
|
77
|
+
|
|
78
|
+
<ul class="fullTree">
|
|
79
|
+
<li>Object</li>
|
|
80
|
+
|
|
81
|
+
<li class="next">Suntrack</li>
|
|
82
|
+
|
|
83
|
+
</ul>
|
|
84
|
+
<a href="#" class="inheritanceTree">show all</a>
|
|
85
|
+
|
|
86
|
+
</dd>
|
|
87
|
+
|
|
88
|
+
|
|
89
|
+
|
|
90
|
+
|
|
91
|
+
|
|
92
|
+
|
|
93
|
+
|
|
94
|
+
|
|
95
|
+
|
|
96
|
+
<dt class="r2 last">Defined in:</dt>
|
|
97
|
+
<dd class="r2 last">lib/suntrack.rb</dd>
|
|
98
|
+
|
|
99
|
+
</dl>
|
|
100
|
+
<div class="clear"></div>
|
|
101
|
+
|
|
102
|
+
<h2>Overview</h2><div class="docstring">
|
|
103
|
+
<div class="discussion">
|
|
104
|
+
<p>
|
|
105
|
+
Main methods for Ruby version of calculations in “Astronomy on the
|
|
106
|
+
Personal Computer”, by Montenbruck and Pfleger (1991).
|
|
107
|
+
</p>
|
|
108
|
+
|
|
109
|
+
|
|
110
|
+
</div>
|
|
111
|
+
</div>
|
|
112
|
+
<div class="tags">
|
|
113
|
+
|
|
114
|
+
|
|
115
|
+
</div><h2>Defined Under Namespace</h2>
|
|
116
|
+
<p class="children">
|
|
117
|
+
|
|
118
|
+
|
|
119
|
+
|
|
120
|
+
|
|
121
|
+
<strong class="classes">Classes:</strong> <span class='object_link'><a href="Suntrack/Point3D.html" title="Suntrack::Point3D (class)">Point3D</a></span>, <span class='object_link'><a href="Suntrack/RAstro.html" title="Suntrack::RAstro (class)">RAstro</a></span>
|
|
122
|
+
|
|
123
|
+
|
|
124
|
+
</p>
|
|
125
|
+
|
|
126
|
+
<h2>Constant Summary</h2>
|
|
127
|
+
|
|
128
|
+
<dl class="constants">
|
|
129
|
+
|
|
130
|
+
<dt id="attributes-classvariable" class="">@@attributes =
|
|
131
|
+
|
|
132
|
+
</dt>
|
|
133
|
+
<dd><pre class="code"><span class='lbrace'>{</span><span class='rbrace'>}</span></pre></dd>
|
|
134
|
+
|
|
135
|
+
</dl>
|
|
136
|
+
|
|
137
|
+
|
|
138
|
+
|
|
139
|
+
|
|
140
|
+
|
|
141
|
+
|
|
142
|
+
|
|
143
|
+
|
|
144
|
+
|
|
145
|
+
<h2>
|
|
146
|
+
Class Method Summary
|
|
147
|
+
<small>(<a href="#" class="summary_toggle">collapse</a>)</small>
|
|
148
|
+
</h2>
|
|
149
|
+
|
|
150
|
+
<ul class="summary">
|
|
151
|
+
|
|
152
|
+
<li class="public ">
|
|
153
|
+
<span class="summary_signature">
|
|
154
|
+
|
|
155
|
+
<a href="#method_missing-class_method" title="method_missing (class method)">+ (Object) <strong>method_missing</strong>(name, *args) </a>
|
|
156
|
+
|
|
157
|
+
|
|
158
|
+
|
|
159
|
+
</span>
|
|
160
|
+
|
|
161
|
+
|
|
162
|
+
|
|
163
|
+
|
|
164
|
+
|
|
165
|
+
|
|
166
|
+
|
|
167
|
+
|
|
168
|
+
|
|
169
|
+
<span class="summary_desc"><div class='inline'><p>
|
|
170
|
+
allow user to create new star location functions User must define
|
|
171
|
+
declination and right ascension.
|
|
172
|
+
</p>
|
|
173
|
+
</div></span>
|
|
174
|
+
|
|
175
|
+
</li>
|
|
176
|
+
|
|
177
|
+
|
|
178
|
+
<li class="public ">
|
|
179
|
+
<span class="summary_signature">
|
|
180
|
+
|
|
181
|
+
<a href="#sirius_location-class_method" title="sirius_location (class method)">+ (Suntrack::Point3D) <strong>sirius_location</strong>(date_time, latitude, longitude) </a>
|
|
182
|
+
|
|
183
|
+
|
|
184
|
+
|
|
185
|
+
</span>
|
|
186
|
+
|
|
187
|
+
|
|
188
|
+
|
|
189
|
+
|
|
190
|
+
|
|
191
|
+
|
|
192
|
+
|
|
193
|
+
|
|
194
|
+
|
|
195
|
+
<span class="summary_desc"><div class='inline'><p>
|
|
196
|
+
Returns Sirius location, in altitude(sirius_position.y) and
|
|
197
|
+
azimuth(sirius_position.z), given DateTime, latitude and longitude.
|
|
198
|
+
</p>
|
|
199
|
+
</div></span>
|
|
200
|
+
|
|
201
|
+
</li>
|
|
202
|
+
|
|
203
|
+
|
|
204
|
+
<li class="public ">
|
|
205
|
+
<span class="summary_signature">
|
|
206
|
+
|
|
207
|
+
<a href="#sun_location-class_method" title="sun_location (class method)">+ (Suntrack::Point3D) <strong>sun_location</strong>(date_time, latitude, longitude) </a>
|
|
208
|
+
|
|
209
|
+
|
|
210
|
+
|
|
211
|
+
</span>
|
|
212
|
+
|
|
213
|
+
|
|
214
|
+
|
|
215
|
+
|
|
216
|
+
|
|
217
|
+
|
|
218
|
+
|
|
219
|
+
|
|
220
|
+
|
|
221
|
+
<span class="summary_desc"><div class='inline'><p>
|
|
222
|
+
Returns Sun location, in altitude(sun_position.y) and
|
|
223
|
+
azimuth(sun_position.z), given DateTime, latitude and longitude.
|
|
224
|
+
</p>
|
|
225
|
+
</div></span>
|
|
226
|
+
|
|
227
|
+
</li>
|
|
228
|
+
|
|
229
|
+
|
|
230
|
+
</ul>
|
|
231
|
+
|
|
232
|
+
|
|
233
|
+
|
|
234
|
+
|
|
235
|
+
<div id="class_method_details" class="method_details_list">
|
|
236
|
+
<h2>Class Method Details</h2>
|
|
237
|
+
|
|
238
|
+
|
|
239
|
+
<div class="method_details first">
|
|
240
|
+
<h3 class="signature first" id="method_missing-class_method">
|
|
241
|
+
|
|
242
|
+
+ (<tt>Object</tt>) <strong>method_missing</strong>(name, *args)
|
|
243
|
+
|
|
244
|
+
|
|
245
|
+
|
|
246
|
+
|
|
247
|
+
|
|
248
|
+
</h3><div class="docstring">
|
|
249
|
+
<div class="discussion">
|
|
250
|
+
<p>
|
|
251
|
+
allow user to create new star location functions User must define
|
|
252
|
+
declination and right ascension
|
|
253
|
+
</p>
|
|
254
|
+
|
|
255
|
+
|
|
256
|
+
</div>
|
|
257
|
+
</div>
|
|
258
|
+
<div class="tags">
|
|
259
|
+
|
|
260
|
+
|
|
261
|
+
</div><table class="source_code">
|
|
262
|
+
<tr>
|
|
263
|
+
<td>
|
|
264
|
+
<pre class="lines">
|
|
265
|
+
|
|
266
|
+
|
|
267
|
+
42
|
|
268
|
+
43
|
|
269
|
+
44
|
|
270
|
+
45
|
|
271
|
+
46
|
|
272
|
+
47
|
|
273
|
+
48
|
|
274
|
+
49
|
|
275
|
+
50
|
|
276
|
+
51
|
|
277
|
+
52
|
|
278
|
+
53
|
|
279
|
+
54
|
|
280
|
+
55
|
|
281
|
+
56
|
|
282
|
+
57
|
|
283
|
+
58
|
|
284
|
+
59</pre>
|
|
285
|
+
</td>
|
|
286
|
+
<td>
|
|
287
|
+
<pre class="code"><span class="info file"># File 'lib/suntrack.rb', line 42</span>
|
|
288
|
+
|
|
289
|
+
<span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_method_missing'>method_missing</span> <span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='op'>*</span><span class='id identifier rubyid_args'>args</span>
|
|
290
|
+
<span class='id identifier rubyid_attribute'>attribute</span> <span class='op'>=</span> <span class='id identifier rubyid_name'>name</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span>
|
|
291
|
+
<span class='kw'>if</span> <span class='id identifier rubyid_attribute'>attribute</span> <span class='op'>=~</span> <span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>=$</span><span class='regexp_end'>/</span></span>
|
|
292
|
+
<span class='cvar'>@@attributes</span><span class='lbracket'>[</span><span class='id identifier rubyid_attribute'>attribute</span><span class='period'>.</span><span class='id identifier rubyid_chop'>chop</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='id identifier rubyid_args'>args</span><span class='lbracket'>[</span><span class='int'>0</span><span class='rbracket'>]</span>
|
|
293
|
+
<span class='kw'>elsif</span> <span class='id identifier rubyid_attribute'>attribute</span> <span class='op'>=~</span> <span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>location</span><span class='regexp_end'>/</span></span>
|
|
294
|
+
<span class='cvar'>@@star</span> <span class='op'>=</span> <span class='id identifier rubyid_attribute'>attribute</span><span class='period'>.</span><span class='id identifier rubyid_match'>match</span><span class='lparen'>(</span><span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>(\w+)_location</span><span class='regexp_end'>/</span></span><span class='rparen'>)</span><span class='lbracket'>[</span><span class='int'>1</span><span class='rbracket'>]</span>
|
|
295
|
+
<span class='kw'>begin</span>
|
|
296
|
+
<span class='id identifier rubyid_dt'>dt</span> <span class='op'>=</span> <span class='const'>DateTime</span><span class='period'>.</span><span class='id identifier rubyid_now'>now</span>
|
|
297
|
+
<span class='id identifier rubyid_mjd'>mjd</span> <span class='op'>=</span> <span class='const'>Suntrack</span><span class='op'>::</span><span class='const'>RAstro</span><span class='period'>.</span><span class='id identifier rubyid_to_mjd'>to_mjd</span><span class='lparen'>(</span><span class='id identifier rubyid_args'>args</span><span class='lbracket'>[</span><span class='int'>0</span><span class='rbracket'>]</span><span class='rparen'>)</span>
|
|
298
|
+
<span class='id identifier rubyid_tau'>tau</span> <span class='op'>=</span> <span class='int'>15</span> <span class='op'>*</span> <span class='lparen'>(</span><span class='const'>Suntrack</span><span class='op'>::</span><span class='const'>RAstro</span><span class='period'>.</span><span class='id identifier rubyid_lmst'>lmst</span><span class='lparen'>(</span><span class='id identifier rubyid_mjd'>mjd</span><span class='comma'>,</span><span class='id identifier rubyid_args'>args</span><span class='lbracket'>[</span><span class='int'>2</span><span class='rbracket'>]</span><span class='rparen'>)</span> <span class='op'>-</span> <span class='cvar'>@@attributes</span><span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>"</span><span class='embexpr_beg'>#{</span><span class='cvar'>@@star</span><span class='rbrace'>}</span><span class='tstring_content'>_ra</span><span class='tstring_end'>"</span></span><span class='rbracket'>]</span><span class='rparen'>)</span>
|
|
299
|
+
<span class='id identifier rubyid_z_in'>z_in</span> <span class='op'>=</span> <span class='const'>Suntrack</span><span class='op'>::</span><span class='const'>Point3D</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='cvar'>@@attributes</span><span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>"</span><span class='embexpr_beg'>#{</span><span class='cvar'>@@star</span><span class='rbrace'>}</span><span class='tstring_content'>_declination</span><span class='tstring_end'>"</span></span><span class='rbracket'>]</span><span class='comma'>,</span><span class='id identifier rubyid_tau'>tau</span><span class='comma'>,</span><span class='id identifier rubyid_args'>args</span><span class='lbracket'>[</span><span class='int'>1</span><span class='rbracket'>]</span><span class='rparen'>)</span>
|
|
300
|
+
<span class='id identifier rubyid_z'>z</span> <span class='op'>=</span> <span class='id identifier rubyid_z_in'>z_in</span><span class='period'>.</span><span class='id identifier rubyid_equatorial_to_horizon'>equatorial_to_horizon</span>
|
|
301
|
+
<span class='id identifier rubyid_z'>z</span>
|
|
302
|
+
<span class='kw'>rescue</span> <span class='const'>Exception</span> <span class='op'>=></span> <span class='id identifier rubyid_ex'>ex</span>
|
|
303
|
+
<span class='id identifier rubyid_p'>p</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>Suntrack ERROR: Please define declination and right ascension for </span><span class='embexpr_beg'>#{</span><span class='cvar'>@@star</span><span class='rbrace'>}</span><span class='tstring_end'>"</span></span>
|
|
304
|
+
<span class='kw'>end</span>
|
|
305
|
+
<span class='kw'>end</span>
|
|
306
|
+
<span class='kw'>end</span></pre>
|
|
307
|
+
</td>
|
|
308
|
+
</tr>
|
|
309
|
+
</table>
|
|
310
|
+
</div>
|
|
311
|
+
|
|
312
|
+
<div class="method_details ">
|
|
313
|
+
<h3 class="signature " id="sirius_location-class_method">
|
|
314
|
+
|
|
315
|
+
+ (<tt><span class='object_link'><a href="Suntrack/Point3D.html" title="Suntrack::Point3D (class)">Suntrack::Point3D</a></span></tt>) <strong>sirius_location</strong>(date_time, latitude, longitude)
|
|
316
|
+
|
|
317
|
+
|
|
318
|
+
|
|
319
|
+
|
|
320
|
+
|
|
321
|
+
</h3><div class="docstring">
|
|
322
|
+
<div class="discussion">
|
|
323
|
+
<p>
|
|
324
|
+
Returns Sirius location, in altitude(sirius_position.y) and
|
|
325
|
+
azimuth(sirius_position.z), given DateTime, latitude and longitude
|
|
326
|
+
</p>
|
|
327
|
+
|
|
328
|
+
|
|
329
|
+
</div>
|
|
330
|
+
</div>
|
|
331
|
+
<div class="tags">
|
|
332
|
+
<p class="tag_title">Parameters:</p>
|
|
333
|
+
<ul class="param">
|
|
334
|
+
|
|
335
|
+
<li>
|
|
336
|
+
|
|
337
|
+
<span class='name'>date_time</span>
|
|
338
|
+
|
|
339
|
+
|
|
340
|
+
<span class='type'>(<tt>DateTime</tt>)</span>
|
|
341
|
+
|
|
342
|
+
|
|
343
|
+
|
|
344
|
+
—
|
|
345
|
+
<div class='inline'><p>
|
|
346
|
+
the date and time for Sirius
|
|
347
|
+
</p>
|
|
348
|
+
</div>
|
|
349
|
+
|
|
350
|
+
</li>
|
|
351
|
+
|
|
352
|
+
<li>
|
|
353
|
+
|
|
354
|
+
<span class='name'>latitude</span>
|
|
355
|
+
|
|
356
|
+
|
|
357
|
+
<span class='type'>(<tt>Float</tt>)</span>
|
|
358
|
+
|
|
359
|
+
|
|
360
|
+
|
|
361
|
+
—
|
|
362
|
+
<div class='inline'><p>
|
|
363
|
+
the user’s latitude, in degrees
|
|
364
|
+
</p>
|
|
365
|
+
</div>
|
|
366
|
+
|
|
367
|
+
</li>
|
|
368
|
+
|
|
369
|
+
<li>
|
|
370
|
+
|
|
371
|
+
<span class='name'>longitude</span>
|
|
372
|
+
|
|
373
|
+
|
|
374
|
+
<span class='type'>(<tt>Float</tt>)</span>
|
|
375
|
+
|
|
376
|
+
|
|
377
|
+
|
|
378
|
+
—
|
|
379
|
+
<div class='inline'><p>
|
|
380
|
+
the user’s longitude, in degrees
|
|
381
|
+
</p>
|
|
382
|
+
</div>
|
|
383
|
+
|
|
384
|
+
</li>
|
|
385
|
+
|
|
386
|
+
</ul>
|
|
387
|
+
|
|
388
|
+
<p class="tag_title">Returns:</p>
|
|
389
|
+
<ul class="return">
|
|
390
|
+
|
|
391
|
+
<li>
|
|
392
|
+
|
|
393
|
+
|
|
394
|
+
<span class='type'>(<tt><span class='object_link'><a href="Suntrack/Point3D.html" title="Suntrack::Point3D (class)">Suntrack::Point3D</a></span></tt>)</span>
|
|
395
|
+
|
|
396
|
+
|
|
397
|
+
|
|
398
|
+
—
|
|
399
|
+
<div class='inline'><p>
|
|
400
|
+
the altitude (y) and azimuth(z) of Sirius
|
|
401
|
+
</p>
|
|
402
|
+
</div>
|
|
403
|
+
|
|
404
|
+
</li>
|
|
405
|
+
|
|
406
|
+
</ul>
|
|
407
|
+
|
|
408
|
+
</div><table class="source_code">
|
|
409
|
+
<tr>
|
|
410
|
+
<td>
|
|
411
|
+
<pre class="lines">
|
|
412
|
+
|
|
413
|
+
|
|
414
|
+
32
|
|
415
|
+
33
|
|
416
|
+
34
|
|
417
|
+
35
|
|
418
|
+
36
|
|
419
|
+
37
|
|
420
|
+
38</pre>
|
|
421
|
+
</td>
|
|
422
|
+
<td>
|
|
423
|
+
<pre class="code"><span class="info file"># File 'lib/suntrack.rb', line 32</span>
|
|
424
|
+
|
|
425
|
+
<span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_sirius_location'>sirius_location</span><span class='lparen'>(</span><span class='id identifier rubyid_date_time'>date_time</span><span class='comma'>,</span><span class='id identifier rubyid_latitude'>latitude</span><span class='comma'>,</span><span class='id identifier rubyid_longitude'>longitude</span><span class='rparen'>)</span>
|
|
426
|
+
<span class='id identifier rubyid_mjd'>mjd</span> <span class='op'>=</span> <span class='const'>Suntrack</span><span class='op'>::</span><span class='const'>RAstro</span><span class='period'>.</span><span class='id identifier rubyid_to_mjd'>to_mjd</span><span class='lparen'>(</span><span class='id identifier rubyid_date_time'>date_time</span><span class='rparen'>)</span>
|
|
427
|
+
<span class='id identifier rubyid_tau'>tau</span> <span class='op'>=</span> <span class='int'>15</span> <span class='op'>*</span> <span class='lparen'>(</span><span class='const'>Suntrack</span><span class='op'>::</span><span class='const'>RAstro</span><span class='period'>.</span><span class='id identifier rubyid_lmst'>lmst</span><span class='lparen'>(</span><span class='id identifier rubyid_mjd'>mjd</span><span class='comma'>,</span><span class='id identifier rubyid_longitude'>longitude</span><span class='rparen'>)</span> <span class='op'>-</span> <span class='const'>Suntrack</span><span class='op'>::</span><span class='const'>RAstro</span><span class='op'>::</span><span class='const'>SIRIUS_RA</span><span class='rparen'>)</span>
|
|
428
|
+
<span class='id identifier rubyid_z_in'>z_in</span> <span class='op'>=</span> <span class='const'>Suntrack</span><span class='op'>::</span><span class='const'>Point3D</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='const'>Suntrack</span><span class='op'>::</span><span class='const'>RAstro</span><span class='op'>::</span><span class='const'>SIRIUS_DECLINATION</span><span class='comma'>,</span><span class='id identifier rubyid_tau'>tau</span><span class='comma'>,</span><span class='id identifier rubyid_latitude'>latitude</span><span class='rparen'>)</span>
|
|
429
|
+
<span class='id identifier rubyid_sirius_position'>sirius_position</span> <span class='op'>=</span> <span class='id identifier rubyid_z_in'>z_in</span><span class='period'>.</span><span class='id identifier rubyid_equatorial_to_horizon'>equatorial_to_horizon</span>
|
|
430
|
+
<span class='id identifier rubyid_sirius_position'>sirius_position</span>
|
|
431
|
+
<span class='kw'>end</span></pre>
|
|
432
|
+
</td>
|
|
433
|
+
</tr>
|
|
434
|
+
</table>
|
|
435
|
+
</div>
|
|
436
|
+
|
|
437
|
+
<div class="method_details ">
|
|
438
|
+
<h3 class="signature " id="sun_location-class_method">
|
|
439
|
+
|
|
440
|
+
+ (<tt><span class='object_link'><a href="Suntrack/Point3D.html" title="Suntrack::Point3D (class)">Suntrack::Point3D</a></span></tt>) <strong>sun_location</strong>(date_time, latitude, longitude)
|
|
441
|
+
|
|
442
|
+
|
|
443
|
+
|
|
444
|
+
|
|
445
|
+
|
|
446
|
+
</h3><div class="docstring">
|
|
447
|
+
<div class="discussion">
|
|
448
|
+
<p>
|
|
449
|
+
Returns Sun location, in altitude(sun_position.y) and
|
|
450
|
+
azimuth(sun_position.z), given DateTime, latitude and longitude
|
|
451
|
+
</p>
|
|
452
|
+
|
|
453
|
+
|
|
454
|
+
</div>
|
|
455
|
+
</div>
|
|
456
|
+
<div class="tags">
|
|
457
|
+
<p class="tag_title">Parameters:</p>
|
|
458
|
+
<ul class="param">
|
|
459
|
+
|
|
460
|
+
<li>
|
|
461
|
+
|
|
462
|
+
<span class='name'>date_time</span>
|
|
463
|
+
|
|
464
|
+
|
|
465
|
+
<span class='type'>(<tt>DateTime</tt>)</span>
|
|
466
|
+
|
|
467
|
+
|
|
468
|
+
|
|
469
|
+
—
|
|
470
|
+
<div class='inline'><p>
|
|
471
|
+
the date and time for Sun position
|
|
472
|
+
</p>
|
|
473
|
+
</div>
|
|
474
|
+
|
|
475
|
+
</li>
|
|
476
|
+
|
|
477
|
+
<li>
|
|
478
|
+
|
|
479
|
+
<span class='name'>latitude</span>
|
|
480
|
+
|
|
481
|
+
|
|
482
|
+
<span class='type'>(<tt>Float</tt>)</span>
|
|
483
|
+
|
|
484
|
+
|
|
485
|
+
|
|
486
|
+
—
|
|
487
|
+
<div class='inline'><p>
|
|
488
|
+
the user’s latitude, in degrees
|
|
489
|
+
</p>
|
|
490
|
+
</div>
|
|
491
|
+
|
|
492
|
+
</li>
|
|
493
|
+
|
|
494
|
+
<li>
|
|
495
|
+
|
|
496
|
+
<span class='name'>longitude</span>
|
|
497
|
+
|
|
498
|
+
|
|
499
|
+
<span class='type'>(<tt>Float</tt>)</span>
|
|
500
|
+
|
|
501
|
+
|
|
502
|
+
|
|
503
|
+
—
|
|
504
|
+
<div class='inline'><p>
|
|
505
|
+
the user’s longitude, in degrees
|
|
506
|
+
</p>
|
|
507
|
+
</div>
|
|
508
|
+
|
|
509
|
+
</li>
|
|
510
|
+
|
|
511
|
+
</ul>
|
|
512
|
+
|
|
513
|
+
<p class="tag_title">Returns:</p>
|
|
514
|
+
<ul class="return">
|
|
515
|
+
|
|
516
|
+
<li>
|
|
517
|
+
|
|
518
|
+
|
|
519
|
+
<span class='type'>(<tt><span class='object_link'><a href="Suntrack/Point3D.html" title="Suntrack::Point3D (class)">Suntrack::Point3D</a></span></tt>)</span>
|
|
520
|
+
|
|
521
|
+
|
|
522
|
+
|
|
523
|
+
—
|
|
524
|
+
<div class='inline'><p>
|
|
525
|
+
the altitude (y) and azimuth(z) of the Sun
|
|
526
|
+
</p>
|
|
527
|
+
</div>
|
|
528
|
+
|
|
529
|
+
</li>
|
|
530
|
+
|
|
531
|
+
</ul>
|
|
532
|
+
|
|
533
|
+
</div><table class="source_code">
|
|
534
|
+
<tr>
|
|
535
|
+
<td>
|
|
536
|
+
<pre class="lines">
|
|
537
|
+
|
|
538
|
+
|
|
539
|
+
14
|
|
540
|
+
15
|
|
541
|
+
16
|
|
542
|
+
17
|
|
543
|
+
18
|
|
544
|
+
19
|
|
545
|
+
20
|
|
546
|
+
21
|
|
547
|
+
22
|
|
548
|
+
23
|
|
549
|
+
24</pre>
|
|
550
|
+
</td>
|
|
551
|
+
<td>
|
|
552
|
+
<pre class="code"><span class="info file"># File 'lib/suntrack.rb', line 14</span>
|
|
553
|
+
|
|
554
|
+
<span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_sun_location'>sun_location</span><span class='lparen'>(</span><span class='id identifier rubyid_date_time'>date_time</span><span class='comma'>,</span><span class='id identifier rubyid_latitude'>latitude</span><span class='comma'>,</span><span class='id identifier rubyid_longitude'>longitude</span><span class='rparen'>)</span>
|
|
555
|
+
|
|
556
|
+
<span class='id identifier rubyid_mjd'>mjd</span> <span class='op'>=</span> <span class='const'>Suntrack</span><span class='op'>::</span><span class='const'>RAstro</span><span class='period'>.</span><span class='id identifier rubyid_to_mjd'>to_mjd</span><span class='lparen'>(</span><span class='id identifier rubyid_date_time'>date_time</span><span class='rparen'>)</span>
|
|
557
|
+
<span class='id identifier rubyid_jd'>jd</span> <span class='op'>=</span> <span class='const'>Suntrack</span><span class='op'>::</span><span class='const'>RAstro</span><span class='period'>.</span><span class='id identifier rubyid_jd'>jd</span><span class='lparen'>(</span><span class='id identifier rubyid_mjd'>mjd</span><span class='rparen'>)</span>
|
|
558
|
+
<span class='id identifier rubyid_tm'>tm</span> <span class='op'>=</span> <span class='const'>Suntrack</span><span class='op'>::</span><span class='const'>RAstro</span><span class='period'>.</span><span class='id identifier rubyid_get_time'>get_time</span><span class='lparen'>(</span><span class='id identifier rubyid_jd'>jd</span><span class='rparen'>)</span>
|
|
559
|
+
<span class='id identifier rubyid_dec'>dec</span> <span class='op'>=</span> <span class='const'>Suntrack</span><span class='op'>::</span><span class='const'>RAstro</span><span class='period'>.</span><span class='id identifier rubyid_sun_position'>sun_position</span><span class='lparen'>(</span><span class='id identifier rubyid_tm'>tm</span><span class='rparen'>)</span>
|
|
560
|
+
<span class='id identifier rubyid_tau'>tau</span> <span class='op'>=</span> <span class='int'>15</span> <span class='op'>*</span> <span class='lparen'>(</span><span class='const'>Suntrack</span><span class='op'>::</span><span class='const'>RAstro</span><span class='period'>.</span><span class='id identifier rubyid_lmst'>lmst</span><span class='lparen'>(</span><span class='id identifier rubyid_mjd'>mjd</span><span class='comma'>,</span><span class='id identifier rubyid_longitude'>longitude</span><span class='rparen'>)</span> <span class='op'>-</span> <span class='id identifier rubyid_dec'>dec</span><span class='period'>.</span><span class='id identifier rubyid_z'>z</span><span class='rparen'>)</span>
|
|
561
|
+
<span class='id identifier rubyid_z_in'>z_in</span> <span class='op'>=</span> <span class='const'>Suntrack</span><span class='op'>::</span><span class='const'>Point3D</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='id identifier rubyid_dec'>dec</span><span class='period'>.</span><span class='id identifier rubyid_y'>y</span><span class='comma'>,</span><span class='id identifier rubyid_tau'>tau</span><span class='comma'>,</span><span class='id identifier rubyid_latitude'>latitude</span><span class='rparen'>)</span>
|
|
562
|
+
<span class='id identifier rubyid_sun_position'>sun_position</span> <span class='op'>=</span> <span class='id identifier rubyid_z_in'>z_in</span><span class='period'>.</span><span class='id identifier rubyid_equatorial_to_horizon'>equatorial_to_horizon</span>
|
|
563
|
+
<span class='id identifier rubyid_sun_position'>sun_position</span>
|
|
564
|
+
<span class='kw'>end</span></pre>
|
|
565
|
+
</td>
|
|
566
|
+
</tr>
|
|
567
|
+
</table>
|
|
568
|
+
</div>
|
|
569
|
+
|
|
570
|
+
</div>
|
|
571
|
+
|
|
572
|
+
</div>
|
|
573
|
+
|
|
574
|
+
<div id="footer">
|
|
575
|
+
Generated on Thu Sep 13 11:06:18 2012 by
|
|
576
|
+
<a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
|
|
577
|
+
0.8.2.1 (ruby-1.9.2).
|
|
578
|
+
</div>
|
|
579
|
+
|
|
580
|
+
</body>
|
|
581
|
+
</html>
|