# Sense HAT

Python module to control the [Raspberry Pi Sense HAT](https://www.raspberrypi.org/products/sense-hat/)

## Features

The Sense HAT features an 8x8 RGB LED matrix, a mini joystick and the following sensors:

- Gyroscope
- Accelerometer
- Magnetometer
- Temperature
- Humidity
- Barometric pressure

## Install

Install the Sense HAT software by opening a Terminal window and entering the following commands (while connected to the Internet).

**Raspbian**: the Sense HAT library is available from the repositories:

```bash
sudo apt-get update
sudo apt-get install sense-hat
sudo pip-3.2 install pillow
sudo reboot
```

**ArchlinuxARM**: the Sense HAT library is available in the Arch User Repository:

```bash
pacaur -Syu
pacaur -S python-sense-hat
sudo reboot
```

**From source**: the following dependencies are required:

- python
- python-pillow
- python-setuptools
- python-numpy
- [python-rtimulib](https://github.com/RPi-Distro/RTIMULib/tree/master/Linux/python)

## Usage

Hello world example:

```python
from sense_hat import SenseHat

sense = SenseHat()

sense.show_message("Hello world!")
```

See the [API reference](api.md) for full documentation of the library's functions. See [examples](https://github.com/RPi-Distro/python-sense-hat/blob/master/examples/README.md).

## Development

This library is maintained by the Raspberry Pi Foundation on GitHub at [github.com/RPi-Distro/python-sense-hat](https://github.com/RPi-Distro/python-sense-hat)

See the [changelog](changelog.md).

Move docs index to match github standards
Move docs index to match github standards
