# 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

![](https://965373739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkxZeV4nlXcIAjMGZxzLI%2Fuploads%2FZmr35bwgundYfOW63E3q%2Fimage.png?alt=media\&token=2ba8baff-b40b-4dd4-ae2c-2a2ad5696788) - 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>

![](https://965373739-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkxZeV4nlXcIAjMGZxzLI%2Fuploads%2FRDngsaxu99O216cFqn81%2Fimage.png?alt=media\&token=53e171be-7591-4c56-acdb-4e8e8646241d) - 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](https://docs.onum.com/the-workspace/pipelines/actions) 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.onum.com/the-workspace/pipelines/actions/transformation/field-transformation/field-transformation-operations/conversion/convert-speed.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
