diff --git a/Docs/python_api.md b/Docs/python_api.md
index 87f3d94f2..ec9cc2784 100644
--- a/Docs/python_api.md
+++ b/Docs/python_api.md
@@ -2352,21 +2352,21 @@ Rain intensity values range from 0 to 100, being 0 none at all and 100 a heavy r
Determines the creation of puddles. Values range from 0 to 100, being 0 none at all and 100 a road completely capped with water. Puddles are created with static noise, meaning that they will always appear at the same locations.
- **wind_intensity** (_float_)
Controls the strenght of the wind with values from 0, no wind at all, to 100, a strong wind. The wind does affect rain direction and leaves from trees, so this value is restricted to avoid animation issues.
-- **falloff** (_float_)
-Density of the fog (as in specific mass). The bigger the value, the more dense and heavy it will be, and the fog will reach smaller heights. Corresponds to Fog Height Falloff in the UE docs.
If the value is 0, the fog will be lighter than air, and will cover the whole scene.
A value of 1 is approximately as dense as the air, and reaches normal-sized buildings.
For values greater than 5, the air will be so dense that it will be compressed on ground level.
+- **sun_azimuth_angle** (_float_)
+The azimuth angle of the sun in degrees. Values range from 0 to 360. Zero is an origin point in a sphere determined by Unreal Engine.
+- **sun_altitude_angle** (_float_)
+Altitude angle of the sun in degrees. Values range from -90 to 90 corresponding to midnight and midday each.
- **fog_density** (_float_)
Fog concentration or thickness. It only affects the RGB camera sensor. Values range from 0 to 100.
- **fog_distance** (_float_)
Fog start distance (in meters). Values range from 0 to infinite.
- **wetness** (_float_)
Wetness intensity. It only affects the RGB camera sensor. Values range from 0 to 100.
-- **sun_azimuth_angle** (_float_)
-The azimuth angle of the sun in degrees. Values range from 0 to 360. Zero is an origin point in a sphere determined by Unreal Engine.
-- **sun_altitude_angle** (_float_)
-Altitude angle of the sun in degrees. Values range from -90 to 90 corresponding to midnight and midday each.
+- **falloff** (_float_)
+Density of the fog (as in specific mass) from 0 to infinity. The bigger the value, the more dense and heavy it will be, and the fog will reach smaller heights. Corresponds to Fog Height Falloff in the UE docs.
If the value is 0, the fog will be lighter than air, and will cover the whole scene.
A value of 1 is approximately as dense as the air, and reaches normal-sized buildings.
For values greater than 5, the air will be so dense that it will be compressed on ground level.
Methods
-- **\__init__**(**self**, **cloudiness**=0.0, **precipitation**=0.0, **precipitation_deposits**=0.0, **wind_intensity**=0.0, **sun_azimuth_angle**=0.0, **sun_altitude_angle**=0.0, **fog_density**=0.0, **fog_distance**=0.0, **wetness**=0.0)
+- **\__init__**(**self**, **cloudiness**=0.0, **precipitation**=0.0, **precipitation_deposits**=0.0, **wind_intensity**=0.0, **sun_azimuth_angle**=0.0, **sun_altitude_angle**=0.0, **fog_density**=0.0, **fog_distance**=0.0, **wetness**=0.0, **falloff**=0.2)
Method to initialize an object defining weather conditions. This class has some presets for different noon and sunset conditions listed in a note below.
- **Parameters:**
- `cloudiness` (_float_) – 0 is a clear sky, 100 complete overcast.
@@ -2375,9 +2375,10 @@ Method to initialize an object defining weather conditions. This class has some
- `wind_intensity` (_float_) – 0 is calm, 100 a strong wind.
- `sun_azimuth_angle` (_float_) – 0 is an arbitrary North, 180 its corresponding South.
- `sun_altitude_angle` (_float_) – 90 is midday, -90 is midnight.
- - `fog_density` (_float_) – Density of the fog, from 0 to 100.
+ - `fog_density` (_float_) – Concentration or thickness of the fog, from 0 to 100.
- `fog_distance` (_float_) – Distance where the fog starts in meters.
- `wetness` (_float_) – Humidity percentages of the road, from 0 to 100.
+ - `falloff` (_float_) – Density (specific mass) of the fog, from 0 to infinity.
- **Note:** _ClearNoon, CloudyNoon, WetNoon, WetCloudyNoon, SoftRainNoon, MidRainyNoon, HardRainNoon, ClearSunset, CloudySunset, WetSunset, WetCloudySunset, SoftRainSunset, MidRainSunset, HardRainSunset.
_
diff --git a/PythonAPI/docs/weather.yml b/PythonAPI/docs/weather.yml
index 3c7e892ad..544e90c28 100644
--- a/PythonAPI/docs/weather.yml
+++ b/PythonAPI/docs/weather.yml
@@ -30,10 +30,15 @@
doc: >
Controls the strenght of the wind with values from 0, no wind at all, to 100, a strong wind. The wind does affect rain direction and leaves from trees, so this value is restricted to avoid animation issues.
# --------------------------------------
- - var_name: falloff
+ - var_name: sun_azimuth_angle
type: float
doc: >
- Density of the fog (as in specific mass). The bigger the value, the more dense and heavy it will be, and the fog will reach smaller heights. Corresponds to Fog Height Falloff in the UE docs.
If the value is 0, the fog will be lighter than air, and will cover the whole scene.
A value of 1 is approximately as dense as the air, and reaches normal-sized buildings.
For values greater than 5, the air will be so dense that it will be compressed on ground level.
+ The azimuth angle of the sun in degrees. Values range from 0 to 360. Zero is an origin point in a sphere determined by Unreal Engine.
+ # --------------------------------------
+ - var_name: sun_altitude_angle
+ type: float
+ doc: >
+ Altitude angle of the sun in degrees. Values range from -90 to 90 corresponding to midnight and midday each.
# --------------------------------------
- var_name: fog_density
type: float
@@ -50,15 +55,10 @@
doc: >
Wetness intensity. It only affects the RGB camera sensor. Values range from 0 to 100.
# --------------------------------------
- - var_name: sun_azimuth_angle
+ - var_name: falloff
type: float
doc: >
- The azimuth angle of the sun in degrees. Values range from 0 to 360. Zero is an origin point in a sphere determined by Unreal Engine.
- # --------------------------------------
- - var_name: sun_altitude_angle
- type: float
- doc: >
- Altitude angle of the sun in degrees. Values range from -90 to 90 corresponding to midnight and midday each.
+ Density of the fog (as in specific mass) from 0 to infinity. The bigger the value, the more dense and heavy it will be, and the fog will reach smaller heights. Corresponds to Fog Height Falloff in the UE docs.
If the value is 0, the fog will be lighter than air, and will cover the whole scene.
A value of 1 is approximately as dense as the air, and reaches normal-sized buildings.
For values greater than 5, the air will be so dense that it will be compressed on ground level.
# - METHODS ----------------------------
methods:
@@ -98,7 +98,7 @@
type: float
default: 0.0
doc: >
- Density of the fog, from 0 to 100.
+ Concentration or thickness of the fog, from 0 to 100.
- param_name: fog_distance
type: float
default: 0.0
@@ -109,6 +109,11 @@
default: 0.0
doc: >
Humidity percentages of the road, from 0 to 100.
+ - param_name: falloff
+ type: float
+ default: 0.2
+ doc: >
+ Density (specific mass) of the fog, from 0 to infinity.
note: >
ClearNoon, CloudyNoon, WetNoon, WetCloudyNoon, SoftRainNoon, MidRainyNoon, HardRainNoon, ClearSunset, CloudySunset, WetSunset, WetCloudySunset, SoftRainSunset, MidRainSunset, HardRainSunset.
doc: >