> 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-area.md).

# Convert area

## Description

This operation converts values from one unit of measurement to another, such as square feet, acres, square meters, and even smaller or less common units used in physics (like barns or nanobarns).

***

## Data types

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

### Input data

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

### Output data

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

***

## 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 measurement of your input data. You must indicate one of the following:

**Metric**

* `Square metre (sq m)`
* `Square kilometre (sq km)`
* `Centiare (ca)`
* `Deciare (da)`
* `Are (a)`
* `Decare (daa)`
* `Hectare (ha)`

**Imperial**

* `Square inch (sq in)`
* `Square foot (sq ft)`
* `Square yard (sq yd)`
* `Square mile (sq mi)`
* `Perch (sq per)`
* `Rood (ro)`
* `International acre (ac)`

**US customary units**

* `US survey acre (ac)`
* `US survey square mile (sq mi)`
* `US survey township`

**Nuclear physics**

* `Yoctobarn (yb)`
* `Zeptobarn (zb)`
* `Attobarn (ab)`
* `Femtobarn (fb)`
* `Picobarn (pb)`
* `Nanobarn (nb)`
* `Microbarn (μb)`
* `Millibarn (mb)`
* `Barn (b)`
* `Kilobarn (kb)`
* `Megabarn (Mb)`
* `Outhouse`
* `Shed`
* `Planck area`

**Comparisons**

* `Washington D.C.`
* `Isle of Wight`
* `Wales`
* `Texas`

</details>

<details>

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

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

**Metric**

* `Square metre (sq m)`
* `Square kilometre (sq km)`
* `Centiare (ca)`
* `Deciare (da)`
* `Are (a)`
* `Decare (daa)`
* `Hectare (ha)`

**Imperial**

* `Square inch (sq in)`
* `Square foot (sq ft)`
* `Square yard (sq yd)`
* `Square mile (sq mi)`
* `Perch (sq per)`
* `Rood (ro)`
* `International acre (ac)`

**US customary units**

* `US survey acre (ac)`
* `US survey square mile (sq mi)`
* `US survey township`

**Nuclear physics**

* `Yoctobarn (yb)`
* `Zeptobarn (zb)`
* `Attobarn (ab)`
* `Femtobarn (fb)`
* `Picobarn (pb)`
* `Nanobarn (nb)`
* `Microbarn (μb)`
* `Millibarn (mb)`
* `Barn (b)`
* `Kilobarn (kb)`
* `Megabarn (Mb)`
* `Outhouse`
* `Shed`
* `Planck area`

**Comparisons**

* `Washington D.C.`
* `Isle of Wight`
* `Wales`
* `Texas`

</details>

***

## Example

Suppose you want to convert a series of events from **square feet** into **square meters**:

1. In your Pipeline, open the required [Action](/pipelines/actions.md) configuration and select the input **Field**.
2. In the **Operation** field, choose **Convert area**.
3. Set **Input units** to `Square foot (sq ft)`.
4. Set **Output units** to `Square metre (sq m)`.
5. Give your **Output field** a name and click **Save**. The values in your input field will be transformed. For example:

```
Input data - "5000"

Input units - "Square foot (sq ft)"

Output units - "Square metre (sq m)"

Output data - "464.515215"
```

{% 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 %}