From fadf90b08ccb974c40e841bda92a5601ce2666b5 Mon Sep 17 00:00:00 2001 From: Ashton Larkin Date: Thu, 25 Feb 2021 12:54:45 -0500 Subject: [PATCH] clarify default temperature to ambient and describe how to set ambient temp/gradient Signed-off-by: Ashton Larkin --- tutorials/03_thermal_camera.md | 24 +++++++++++++++++++++++- 1 file changed, 23 insertions(+), 1 deletion(-) diff --git a/tutorials/03_thermal_camera.md b/tutorials/03_thermal_camera.md index 2afd32bb..14c9f775 100644 --- a/tutorials/03_thermal_camera.md +++ b/tutorials/03_thermal_camera.md @@ -125,11 +125,33 @@ Here's a description of the elements in this plugin (if the plugin isn't used, t ## Assigning a temperature to a model Now that we have set up our thermal camera, we'll need to assign temperatures to models in the environment. -If a model doesn't have a temperature associated with it, then the thermal camera cannot detect it. +If a model doesn't have a temperature associated with it, then the model's temperature is set to the ambient temperature. +There will be some variation in the model's temperature based on the model's color and the world's temperature gradient. The thermal camera can support objects that either have a uniform or varying surface temperature. We will go over each approach in the following subsections. +### Setting atmospheric temperature properties + +It is recommended to specify the ambient temperature and world's temperature gradient, since this dictates how objects with no specified temperature appear. +Here's an example that sets the ambient temperature to 300 kelvin, and the temperature gradient to 0.1 Kelvin/meter: + +```xml + + 300 + + 0.1 + +``` + +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). + ### Objects with a uniform temperature Here's an example of a box model that has a uniform temperature assigned to it: