LUAPLUGIN: Ephemerides 2.0
Posted: 27.03.2013, 02:25
**************************************************************************************************************
This topic has been moved here
**************************************************************************************************************
Ephemerides 2.0 for lua_plugins only.
INSTALLATION (lua_plugins only):
- Remove all previous version of ephemerides if any.
- Unzip the "ephemerides_2.0.zip" inside the main Celestia's root. While the "ephemPref.lua" file will be extract in there, a new folder named "ephemerides" will be created under the "..celestia/extras/" folder containing all the remains files. Such folder can be moved also as subfolder of "../extras/lua_plugins/" path whithout to affect its functionality. For the insertion within the lua_plugins see the "readme.txt".
INTERFACE:
The ephemerides bar, which caption moves on screen, shows four buttons. These buttons will be active as long as the observer is within a range of ten time the Earth's radius, otherwise all buttons will be deactivated. Ephemerides infos are thought to be shown only when the observer is near the Earth and not far away, being all infos now referred to Earth and no longer to the observer everywhere he is within the Solar System like was in the previous version. Each button, aside the button 4), performs a synchronous operation for the Earth and the observer. This synchronous Earth operation will not affect the reference frame for other objects whether the observer decides to fly elsewhere, being the plugin inactive beyond such Earth's radii distance, showing just the greyed-out buttons. However, one can always press the "f" key (follow) if he wish; but in such case the infos can varying as long as the Earth is rotating about its axis.
USAGE:
In the order, from left to right:
(button 1): a "goto home" button. Such button moves the observer perpendicular on an user-defined location at the default Celestia distance of 5 * earth's radius. The location's name and its coordinates are customizable through "ephemCfg.lua" file. The name of the location can be whatever, and will be displayed close to the pointer, even though the locaton is not set like .SSC location. This button is like an "utility" to aid the user in find its "return to home" operation after having played with ephemerides for other locations on Earth. The distance and the return delay are customizables too. Note that for distance > 10 the plugin will be inactive. Default distance = 5.0; default delay = 5.0, the default Celestia's distance and gotolonglat smooth moving. Click/unclick = move to home/hide the pointer.
button 2) Physical ephemerides button. It will show several physical ephemerides for all Celestia's objects. For deepsky objects and fictionals (diffuse), just their subEarth points will be displayed. Click/unclick = show/hide infos and pointer.
button 3) Visual ephemerides and rise/set times for all Celestia's object, deepsky, fictionals and spacecrafts objects too.
The rise/set times are referred to the ground perpendicular to the observer's orbit and to stay in orbit or at ground is the same for what concern the rise/set azimuths. The only difference is that at the ground will be displayed also the real time azimuths and altitudes measurements of the selected objects. Click/unclick = show/hide infos and pointer.
button 4) Color roulette button. It change the ephemerides color for text and pointer in pseudo-random manner. All colors will be randomized but the color-sequence will be same all the time. Useful for visual purposes. The random color can be printable on a txt file for helping to find a favorite main color settable through "ephemCfg.lua" file. The main color is now set like the default Celestia's HUD color. Random colors and main color are independent. Note that if the print option is active, while the click operation write on disc the random color, the unclick operation write on disc also the main color.
Click/unclick = random color/main color.
CREDITS:
To Marco Klunder, who have shared with me the knowledge of its ObjectsRiseSet plugin, and for having solved an "interpolation issue" for fast Sun-orbiting planets (mainly Mercury and comets). The visual ephemerides in the part of the rise/set times is basically due to him. My credits with Marco are shown like comments also in the code for the Moon rise/set, being its work with the fundamental arguments (Van Flandern & Pulkkinen, 1979) and their LUA port from SKY AND TELESCOPE BASIC Sun/Moon code, originally extended thereafter to all planets including Pluto, and in which the trigonometric series were compiled until the last(!) argument prior to be bypassed under the suggestion of using the Celestia's CELX/LUA scripting for get RA, Dec. I've left its work for the Moon like a legacy of its rigorous and time-consuming task.
To Jo?l (Jogad) for finding a manageable solution for the ephemerides' bar behaviour in windowed mode;
its code has been seamlessly nested within the "ephemerisBox.lua", bringing the plugin to a next step in enhancement.
REMOVED DUE TO TROLLS
Kindly, Jo?l has fixed the bugs inadvertently introduced during the enhancement of the bar's management.
This version fix all bugs of the previous 2.3. This is the most stable version so far.
- Fixed bug concerning wrong enter in "ephemPrefs.lua". This file is no longer required to be shipped with the installation; it will be created at first start. Previous version of this file (within Celestia's root) must be deleted before to install this new pack;
- Fixed a bug which prevented to display the ephemerides bar whether the window was resized before to load the plugin;
- Fixed bug with the pointer. Now it hold the center of the screen for whatelse windowed mode.
- Modified the equinox/solstice code. Now the timezone for these latters are independent from the main timezone setting. Workaround for western Europe daylight saving time; being the equinoxes/solstice's prediction ranging the whole year, the June solstice and the September equinox would have uncorrected hours whether set with the main timezone (hope be clear the discourse). Countries without such european delirium can set them like own timezone. Default: "UTC".
- Added Dutch language (thanks to Marco Klunder).
- Minor fixes
This topic has been moved here
**************************************************************************************************************
Ephemerides 2.0 for lua_plugins only.
INSTALLATION (lua_plugins only):
- Remove all previous version of ephemerides if any.
- Unzip the "ephemerides_2.0.zip" inside the main Celestia's root. While the "ephemPref.lua" file will be extract in there, a new folder named "ephemerides" will be created under the "..celestia/extras/" folder containing all the remains files. Such folder can be moved also as subfolder of "../extras/lua_plugins/" path whithout to affect its functionality. For the insertion within the lua_plugins see the "readme.txt".
INTERFACE:
The ephemerides bar, which caption moves on screen, shows four buttons. These buttons will be active as long as the observer is within a range of ten time the Earth's radius, otherwise all buttons will be deactivated. Ephemerides infos are thought to be shown only when the observer is near the Earth and not far away, being all infos now referred to Earth and no longer to the observer everywhere he is within the Solar System like was in the previous version. Each button, aside the button 4), performs a synchronous operation for the Earth and the observer. This synchronous Earth operation will not affect the reference frame for other objects whether the observer decides to fly elsewhere, being the plugin inactive beyond such Earth's radii distance, showing just the greyed-out buttons. However, one can always press the "f" key (follow) if he wish; but in such case the infos can varying as long as the Earth is rotating about its axis.
USAGE:
In the order, from left to right:
(button 1): a "goto home" button. Such button moves the observer perpendicular on an user-defined location at the default Celestia distance of 5 * earth's radius. The location's name and its coordinates are customizable through "ephemCfg.lua" file. The name of the location can be whatever, and will be displayed close to the pointer, even though the locaton is not set like .SSC location. This button is like an "utility" to aid the user in find its "return to home" operation after having played with ephemerides for other locations on Earth. The distance and the return delay are customizables too. Note that for distance > 10 the plugin will be inactive. Default distance = 5.0; default delay = 5.0, the default Celestia's distance and gotolonglat smooth moving. Click/unclick = move to home/hide the pointer.
button 2) Physical ephemerides button. It will show several physical ephemerides for all Celestia's objects. For deepsky objects and fictionals (diffuse), just their subEarth points will be displayed. Click/unclick = show/hide infos and pointer.
button 3) Visual ephemerides and rise/set times for all Celestia's object, deepsky, fictionals and spacecrafts objects too.
The rise/set times are referred to the ground perpendicular to the observer's orbit and to stay in orbit or at ground is the same for what concern the rise/set azimuths. The only difference is that at the ground will be displayed also the real time azimuths and altitudes measurements of the selected objects. Click/unclick = show/hide infos and pointer.
button 4) Color roulette button. It change the ephemerides color for text and pointer in pseudo-random manner. All colors will be randomized but the color-sequence will be same all the time. Useful for visual purposes. The random color can be printable on a txt file for helping to find a favorite main color settable through "ephemCfg.lua" file. The main color is now set like the default Celestia's HUD color. Random colors and main color are independent. Note that if the print option is active, while the click operation write on disc the random color, the unclick operation write on disc also the main color.
Click/unclick = random color/main color.
CREDITS:
To Marco Klunder, who have shared with me the knowledge of its ObjectsRiseSet plugin, and for having solved an "interpolation issue" for fast Sun-orbiting planets (mainly Mercury and comets). The visual ephemerides in the part of the rise/set times is basically due to him. My credits with Marco are shown like comments also in the code for the Moon rise/set, being its work with the fundamental arguments (Van Flandern & Pulkkinen, 1979) and their LUA port from SKY AND TELESCOPE BASIC Sun/Moon code, originally extended thereafter to all planets including Pluto, and in which the trigonometric series were compiled until the last(!) argument prior to be bypassed under the suggestion of using the Celestia's CELX/LUA scripting for get RA, Dec. I've left its work for the Moon like a legacy of its rigorous and time-consuming task.
To Jo?l (Jogad) for finding a manageable solution for the ephemerides' bar behaviour in windowed mode;
its code has been seamlessly nested within the "ephemerisBox.lua", bringing the plugin to a next step in enhancement.
REMOVED DUE TO TROLLS
Kindly, Jo?l has fixed the bugs inadvertently introduced during the enhancement of the bar's management.
This version fix all bugs of the previous 2.3. This is the most stable version so far.
- Fixed bug concerning wrong enter in "ephemPrefs.lua". This file is no longer required to be shipped with the installation; it will be created at first start. Previous version of this file (within Celestia's root) must be deleted before to install this new pack;
- Fixed a bug which prevented to display the ephemerides bar whether the window was resized before to load the plugin;
- Fixed bug with the pointer. Now it hold the center of the screen for whatelse windowed mode.
- Modified the equinox/solstice code. Now the timezone for these latters are independent from the main timezone setting. Workaround for western Europe daylight saving time; being the equinoxes/solstice's prediction ranging the whole year, the June solstice and the September equinox would have uncorrected hours whether set with the main timezone (hope be clear the discourse). Countries without such european delirium can set them like own timezone. Default: "UTC".
- Added Dutch language (thanks to Marco Klunder).
- Minor fixes
, I have two (
. In fact it keeps a constant distance between the tool and the upper left corner of the screen. It is appropriate if the tool bar is in the upper left quarter of the screen but not always if it elsewhere.
, 
