You measure acceleration with the **milli-g**, which is 1/1000 of a **g**.
A **g** is as much acceleration as you get from Earth’s gravity.

# acceleration

Get the acceleration value (milli g-force) in one of three dimensions, or the combined force in all directions (x, y, and z).

Find the acceleration of the Adafruit Circuit Playground Express (how fast it is speeding up or slowing down).

`input.acceleration(Dimension.X);`

## Parameters

**dimension**: the direction you are checking for acceleration, or the total strength of force.`x`

: acceleration in the left and right direction.

`y`

: acceleration in the forward and backward direction.

`z`

: acceleration in the up and down direction.

`strength`

: the resulting strength of acceleration from all three dimensions (directions).

## Returns

- a number that means the amount of acceleration. When the Adafruit Circuit Playground Express is lying flat on a surface with the screen pointing up,
`x`

is`0`

,`y`

is`0`

,`z`

is`-1023`

, and`strength`

is`1023`

.

## Example: bar chart

Write the acceleration of the Adafruit Circuit Playground Express to the console.

```
forever(() => {
console.logValue("accel", input.acceleration(Dimension.X))
pause(500)
})
```

## See also

set accelerometer range, light level

`accelerometer`