|
1 |
| -# Day Light Managers Plugin |
| 1 | +# Daylight Manager Plugin |
2 | 2 |
|
3 |
| -The Sun is the driving force behind most planetary phenomena, influencing nearly every aspect of the environment, either directly or indirectly. Accurately simulating the Sun's path is crucial for realistic environmental modeling, especially in intricate scenarios. |
| 3 | +The Sun plays a pivotal role in driving most planetary phenomena, influencing nearly every environmental aspect, directly or indirectly. Accurately modeling the Sun's path is essential for realistic environmental simulations, especially in complex scenarios. |
4 | 4 |
|
5 |
| -## Key Features |
| 5 | +The Daylight Manager plugin for Gazebo simulates the Sun's trajectory based on the time of day and the observer's latitude, providing a realistic and dynamic representation of sunlight. The shadow of object changes depending on the Sun's position, as depicted below |
6 | 6 |
|
7 |
| -The Day Light Managers plugin for Gazebo simulates the Sun's trajectory based on the time of day and the observer's latitude. |
| 7 | + |
8 | 8 |
|
9 |
| - |
| 9 | +# Features: |
| 10 | +1. Sun Trajectory Variation: |
10 | 11 |
|
11 |
| -The key factors determining the Sun's path include: |
12 |
| -- **Time of Day**: The Sun's altitude varies throughout the day. |
13 |
| -- **Latitude**: The observer's latitude affects the solar altitude. |
| 12 | + - **Time of Day**: The Sun’s altitude changes throughout the day, and users can set a custom time to observe these variations. |
| 13 | + - **Latitude**: The observer's latitude influences solar altitude, and users can customize the latitude to adjust the Sun’s path accordingly. Below is an gif of the Sun's trajectory at -80° latitude on Earth. ( Right gif reference : https://andrewmarsh.com/apps/staging/sunpath3d.html ) |
14 | 14 |
|
| 15 | + |
15 | 16 |
|
16 | 17 |
|
17 |
| -## Visual Demonstration |
| 18 | +2. **Live Time Update**: Real-time updates are displayed in the GUI. |
18 | 19 |
|
19 |
| -As the Sun's altitude changes, the simulation's background color dynamically adjusts to reflect the lighting conditions. |
| 20 | +3. **Adjustable Sun Position**: Users can modify the Sun's position with x and y offsets. |
20 | 21 |
|
21 |
| - |
| 22 | +4. **Dynamic Lighting**: As the Sun's altitude changes, the simulation's background color dynamically adjusts to reflect different lighting conditions. |
22 | 23 |
|
| 24 | +5. **Multi-Planet Support**: The plugin supports Sun trajectories for both Earth and Mars, allowing users to switch between them. |
23 | 25 |
|
24 |
| -## Usage |
| 26 | +6. **Adjustable Rotation Radius**: The radius of the Sun's rotation can be modified using a radius spin box. |
25 | 27 |
|
26 |
| -Users can accelerate the Sun's trajectory simulation by up to 100x and adjust the Sun's position using x and y offsets. |
| 28 | +7. **Simulation Speed Control**: The Sun trajectory simulation speed can be accelerated up to 100x. |
| 29 | + |
| 30 | + |
| 31 | +# GUI |
| 32 | +<img src="../assets/GUI.png" alt="Sun Trajectory GUI" width="50%"> |
| 33 | + |
| 34 | + |
| 35 | +### Refs : |
| 36 | +1. https://andrewmarsh.com/apps/staging/sunpath3d.html |
| 37 | +2. https://ntrs.nasa.gov/api/citations/20200003207/downloads/20200003207.pdf |
| 38 | +3. https://stackoverflow.com/questions/8708048/position-of-the-sun-given-time-of-day-latitude-and-longitude |
| 39 | +4. https://ntrs.nasa.gov/api/citations/19940010257/downloads/19940010257.pdf |
0 commit comments