Skip to content

Commit fadf90b

Browse files
committed
clarify default temperature to ambient and describe how to set ambient temp/gradient
Signed-off-by: Ashton Larkin <ashton@openrobotics.org>
1 parent 2c53bff commit fadf90b

File tree

1 file changed

+23
-1
lines changed

1 file changed

+23
-1
lines changed

tutorials/03_thermal_camera.md

Lines changed: 23 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -125,11 +125,33 @@ Here's a description of the elements in this plugin (if the plugin isn't used, t
125125
## Assigning a temperature to a model
126126

127127
Now that we have set up our thermal camera, we'll need to assign temperatures to models in the environment.
128-
If a model doesn't have a temperature associated with it, then the thermal camera cannot detect it.
128+
If a model doesn't have a temperature associated with it, then the model's temperature is set to the ambient temperature.
129+
There will be some variation in the model's temperature based on the model's color and the world's temperature gradient.
129130

130131
The thermal camera can support objects that either have a uniform or varying surface temperature.
131132
We will go over each approach in the following subsections.
132133

134+
### Setting atmospheric temperature properties
135+
136+
It is recommended to specify the ambient temperature and world's temperature gradient, since this dictates how objects with no specified temperature appear.
137+
Here's an example that sets the ambient temperature to 300 kelvin, and the temperature gradient to 0.1 Kelvin/meter:
138+
139+
```xml
140+
<atmosphere type="adiabatic">
141+
<temperature>300</temperature>
142+
<!--
143+
This is a more exaggerated temperature gradient, which produces a
144+
temperature range of ~11.5 kelvin for objects in the thermal camera
145+
view that don't have a user-specified temperature.
146+
Typical temperature gradient is -0.0065 K/m which produces a
147+
temperature range of 0.75 kelvin.
148+
-->
149+
<temperature_gradient>0.1</temperature_gradient>
150+
</atmosphere>
151+
```
152+
153+
The default values for ambient temperature and temperature gradient can be found in the [SDFormat Specification](http://sdformat.org/spec?ver=1.7&elem=world#world_atmosphere).
154+
133155
### Objects with a uniform temperature
134156

135157
Here's an example of a box model that has a uniform temperature assigned to it:

0 commit comments

Comments
 (0)