pxt-calliope/docs/reference/input/temperature.md
Sam El-Husseini e3975e65e5 pxt-microbit Accessibility PR (#529)
* Accessibility changes
2017-09-07 13:42:08 -07:00

59 lines
1.7 KiB
Markdown

# Temperature
Find the temperature where you are. The temperature is measured in Celsius (metric).
The @boardname@ can find the temperature nearby by checking how hot its computer chips are.
```sig
input.temperature();
```
## Returns
* a [Number](/types/number) that means the Celsius temperature.
## How does it work?
The @boardname@ checks how hot its CPU (main computer chip) is.
Because the @boardname@ does not usually get very hot, the temperature of the CPU
is usually close to the temperature of wherever you are.
The @boardname@ might warm up a little if you make it work hard, though!
## Example: @boardname@ thermometer
The following example uses `temperature` and `show number` to show the temperature of the room.
```blocks
basic.forever(() => {
let temp = input.temperature()
basic.showNumber(temp)
})
```
## Example: Fahrenheit thermometer
This program measures the temperature using Fahrenheit degrees.
Fahrenheit is a way of measuring temperature that is commonly used in the United States.
To make a Celsius temperature into a Fahrenheit one, multiply the Celsius temperature by
``18``, divide by ``10`` and add ``32``.
```blocks
basic.forever(() => {
let c = input.temperature()
let f = (c * 18) / 10 + 32
basic.showNumber(f)
})
```
## ~hint
Try comparing the temperature your @boardname@ shows to a real thermometer in the same place.
You might be able to figure out how much to subtract from the number the @boardname@
shows to get the real temperature. Then you can change your program so the @boardname@ is a
better thermometer.
## ~
## See also
[compass-heading](/reference/input/compass-heading), [acceleration](/reference/input/acceleration)