2015-08-19 19:01:36 +00:00
|
|
|
# SIM\_sun
|
2015-08-13 19:41:21 +00:00
|
|
|
|
2016-05-26 23:37:23 +00:00
|
|
|
|
2015-08-13 19:41:21 +00:00
|
|
|
|
|
|
|
|
### The Simulation
|
2015-08-19 19:01:36 +00:00
|
|
|
SIM\_sun is a simulation of the Sun's movement across the sky.
|
2015-08-13 19:41:21 +00:00
|
|
|
Given the location (latitude, longitude) of an observer on the
|
2015-08-19 17:59:44 +00:00
|
|
|
Earth, the timezone (offset from UTC), and a starting local time,
|
|
|
|
|
this simulation calculates the position of the Sun in the sky over time.
|
2015-08-13 19:41:21 +00:00
|
|
|
|
|
|
|
|
### Inputs
|
2015-08-19 19:01:36 +00:00
|
|
|
Variable | Type | Units
|
|
|
|
|
-----------------------------------------------|----------------|-------
|
|
|
|
|
sun\_predictor.sun.observer\_latitude | double | d
|
|
|
|
|
sun\_predictor.sun.observer\_longitude | double | d
|
|
|
|
|
sun\_predictor.sun.observer\_offset\_from\_UTC | int | hr
|
|
|
|
|
sun\_predictor.sun.local\_time | CALENDAR\_DATE | --
|
|
|
|
|
|
|
|
|
|
### CALENDAR\_DATE
|
2015-08-13 19:41:21 +00:00
|
|
|
Member | Type | Units
|
|
|
|
|
---------------------------|--------------------|---------
|
|
|
|
|
year | int | --
|
|
|
|
|
month | int | --
|
|
|
|
|
day | int | day
|
|
|
|
|
hour | int | hour
|
|
|
|
|
min | int | min
|
|
|
|
|
sec | double | s
|
|
|
|
|
|
|
|
|
|
### Outputs
|
2015-08-19 19:01:36 +00:00
|
|
|
Variable | Type | Units
|
|
|
|
|
-------------------------------------------------|----------------|--------
|
|
|
|
|
sun\_predictor.sun.JD | double | day
|
|
|
|
|
sun\_predictor.sun.right\_ascension | double | d
|
|
|
|
|
sun\_predictor.sun.declination | double | d
|
|
|
|
|
sun\_predictor.sun.hour\_angle | double | d
|
|
|
|
|
sun\_predictor.sun.local\_sidereal\_time | double | s
|
|
|
|
|
sun\_predictor.sun.sidereal\_time\_at\_Greenwich | double | s
|
|
|
|
|
sun\_predictor.sun.solar\_azimuth | double | d
|
|
|
|
|
sun\_predictor.sun.solar\_elevation | double | d
|
|
|
|
|
sun\_predictor.sun.local\_time | CALENDAR\_DATE | --
|
|
|
|
|
sun\_predictor.sun.utc | CALENDAR\_DATE | --
|
2015-08-13 19:41:21 +00:00
|
|
|
|
2015-08-19 17:59:44 +00:00
|
|
|
**NOTE:** 0 <= Solar Azimuth < 360 degrees. North = 0, East = 90, South = 180, West = 270.
|
|
|
|
|
|
2017-05-11 22:44:43 +00:00
|
|
|
### Scenarios
|
2015-08-13 19:41:21 +00:00
|
|
|
|
2017-05-11 22:44:43 +00:00
|
|
|
#### [RUN_Winter](RUN_Winter/RESULTS.md)
|
2015-08-13 19:41:21 +00:00
|
|
|
|
2017-05-11 22:44:43 +00:00
|
|
|
#### [RUN_Summer](RUN_Summer/RESULTS.md)
|
2015-08-13 19:41:21 +00:00
|
|
|
|
|
|
|
|
### References
|
2015-08-19 17:59:44 +00:00
|
|
|
Meeus, Jean, (1998) "Astronomical Algorithms", Willmann-Bell, Inc. ISBN 0-943396-61-1.
|
