> For the complete documentation index, see [llms.txt](https://docs.onum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.onum.com/pipelines/actions/transformation/field-transformation/field-transformation-operations/conversion/convert-speed.md).

# Convert speed

## Description

This operation converts values between different units of speed.

***

## Data types

These are the input/output expected data types for this operation:

### Input data

`String` - Values whose unit of speed you want to transform. They must be strings representing numbers.

### Output data <a href="#output-data" id="output-data"></a>

`String` - Resulting values after transforming them to the selected unit of speed.

***

## Parameters

These are the parameters you need to configure to use this operation (mandatory parameters are marked with a <mark style="color:red;">**\***</mark>):

<details>

<summary>Input units<mark style="color:red;"><strong>*</strong></mark></summary>

Enter the unit of speed of your input data. You must indicate one of the following:

**Metric**

* `Metres per second (m/s)`
* `Kilometres per hour (km/h)`

**Imperial**

* `Miles per hour (mph)`
* `Knots (kn)`

**Comparisons**

* `Human hair growth rate`
* `Bamboo growth rate`
* `World's fastest snail`
* `Usain Bolt's top speed`
* `Jet airliner cruising speed`
* `Concorde`
* `SR-71 Blackbird`
* `Space Shuttle`
* `International Space Station`

**Scientific**

* `Sound in standard atmosphere`
* `Sound in water`
* `Lunar escape velocity`
* `Earth escape velocity`
* `Earth's solar orbit`
* `Solar system's Milky Way orbit`
* `Milky Way relative to the cosmic microwave background`
* `Solar escape velocity`
* `Neutron star escape velocity (0.3c)`
* `Light in a diamond (0.4136c)`
* `Signal in an optical fibre (0.667c)`
* `Light (c)`

</details>

<details>

<summary>Output units<mark style="color:red;"><strong>*</strong></mark></summary>

Enter the required unit of speed of your output data. You must indicate one of the following:

**Metric**

* `Metres per second (m/s)`
* `Kilometres per hour (km/h)`

**Imperial**

* `Miles per hour (mph)`
* `Knots (kn)`

**Comparisons**

* `Human hair growth rate`
* `Bamboo growth rate`
* `World's fastest snail`
* `Usain Bolt's top speed`
* `Jet airliner cruising speed`
* `Concorde`
* `SR-71 Blackbird`
* `Space Shuttle`
* `International Space Station`

**Scientific**

* `Sound in standard atmosphere`
* `Sound in water`
* `Lunar escape velocity`
* `Earth escape velocity`
* `Earth's solar orbit`
* `Solar system's Milky Way orbit`
* `Milky Way relative to the cosmic microwave background`
* `Solar escape velocity`
* `Neutron star escape velocity (0.3c)`
* `Light in a diamond (0.4136c)`
* `Signal in an optical fibre (0.667c)`
* `Light (c)`

</details>

***

## Example

Suppose you want to convert a series of events from **kilometers per hour** into **miles per hour**:

1. In your Pipeline, open the required [Action](/pipelines/actions.md) configuration and select the input **Field**.
2. In the **Operation** field, choose **Convert speed**.
3. Set **Input units** to `Kilometres per hour (km/h)`.
4. Set **Output units** to `Miles per hour (mph)`.
5. Give your **Output field** a name and click **Save**. The unit of speed of the values in your input field will be transformed. For example:

```
Input data - "200"

Input units - "Kilometres per hour (km/h)"

Output units - "Miles per hour (mph)"

Output data - "124.2841804"
```

{% hint style="info" %}
You can try out operations with specific values using the **Input** field above the operation. You can enter the value in the example above and check the result in the **Output** field.
{% endhint %}