## What is ulab

ulab (pronounced "micro lab") lets you perform number crunching tasks in CircuitPython more quickly, often around 10x as fast. This can be very handy when dealing with sensor data, as we'll see below.

Make sure you have CircuitPython 5.1.0 or newer, and any Adafruit CircuitPython board with an M4 or higher processor, including most SAMD51 and nRF boards.

It's a "built-in module", meaning that it is installed when you install CircuitPython, it's not a file or a set of files in a project bundle or installable via circup. Check the "Built-in modules available" list for a particular board on circuitpython.org to find out if it's available, or just run `import ulab`

at the repl to find out for yourself immediately. If the result is an **ImportError**, then ulab is not available on that board.

ulab is modeled after `numpy`

, but is not entirely compatible; so after the examples there are guidelines to help you move between numpy and ulab.

ulab is not available in Blinka, Adafruit's Single Board Computer layer for CircuitPython - for those boards we recommend using plain numpy since it's available! If your code needs to run on both CircuitPython and Blinka, you'll probably either need to use conditional code or forego the use of ulab altogether.

## The ulab API

ulab makes things faster by operating on entire arrays of values in one operation. For example, when you have two *numbers* `a`

and `b`

, `a+b`

adds them together, returning a new *number*. When you have two ulab *arrays* `a`

and `b`

, `a+b`

adds the corresponding numbers in `a`

to the corresponding numbers in `b`

, returning a new *array*. Want to double every number in an array? That's `a*2`

. Compute its sine? `ulab.numpy.sin(a)`

. It also has special versions of functions like `sum`

that act on a whole array and return a single number. Documentation for all functions in ulab are on readthedocs.

These examples only cover a portion of the functions available in ulab. The items below are beyond the scope of this gude:

- Matrix functions in
`ulab.numpy.linalg`

, such as determinant, inverse, and eigenvectors of a matrix - Creating vectors with
`ulab.numpy.linspace`

, which is sort of like`range()`

but for arrays - Statistical functions such as standard deviation,
`ulab.numpy.std`

and others - Functions for working with polynomials in
`ulab.numpy.polyfit`

and`ulab.numpy.polyval`

- Slicing arrays with
`arr[lo:hi:step]`

Text editor powered by tinymce.