Skip to content

Commit 6f57eee

Browse files
jchaudhary21mkhansenbot
authored andcommitted
Updated README file (space-ros#46)
1 parent 3890c75 commit 6f57eee

5 files changed

+26
-13
lines changed
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,39 @@
1-
# Day Light Managers Plugin
1+
# Daylight Manager Plugin
22

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.
44

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
66

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+
![Sun Trajectory Simulation](../assets/day_light_manager_transition.gif)
88

9-
![Sun Trajectory Simulation](path_to_gif.gif)
9+
# Features:
10+
1. Sun Trajectory Variation:
1011

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 )
1414

15+
![Sun Trajectory Simulation Latitude](../assets/day_light_manager_transition_latitude_merge.gif)
1516

1617

17-
## Visual Demonstration
18+
2. **Live Time Update**: Real-time updates are displayed in the GUI.
1819

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.
2021

21-
![Background Color Changes](path_to_image.png)
22+
4. **Dynamic Lighting**: As the Sun's altitude changes, the simulation's background color dynamically adjusts to reflect different lighting conditions.
2223

24+
5. **Multi-Planet Support**: The plugin supports Sun trajectories for both Earth and Mars, allowing users to switch between them.
2325

24-
## Usage
26+
6. **Adjustable Rotation Radius**: The radius of the Sun's rotation can be modified using a radius spin box.
2527

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
Loading
Loading
Loading
Loading

0 commit comments

Comments
 (0)