# Convert mass
## Description
This operation converts values between different units of mass.
***
## Data types
These are the input/output expected data types for this operation:
### Input data
 - Values whose unit of mass you want to transform. They must be strings representing numbers.
### Output data
 - Resulting values after transforming them to the selected unit of mass.
***
## Parameters
These are the parameters you need to configure to use this operation (mandatory parameters are marked with a **\***):
Input units*
Enter the unit of mass of your input data. You must indicate one of the following:
**Metric**
* `Yoctogram (yg)`
* `Zeptogram (zg)`
* `Attogram (ag)`
* `Femtogram (fg)`
* `Picogram (pg)`
* `Nanogram (ng)`
* `Microgram (μg)`
* `Milligram (mg)`
* `Centigram (cg)`
* `Decigram (dg)`
* `Gram (g)`
* `Decagram (dag)`
* `Hectogram (hg)`
* `Kilogram (kg)`
* `Megagram (Mg)`
* `Tonne (t)`
* `Gigagram (Gg)`
* `Teragram (Tg)`
* `Petagram (Pg)`
* `Exagram (Eg)`
* `Zettagram (Zg)`
* `Yottagram (Yg)`
**Imperial Avoirdupois**
* `Grain (gr)`
* `Dram (dr)`
* `Ounce (oz)`
* `Pound (lb)`
* `Nail`
* `Stone (st)`
* `Quarter (qr)`
* `Tod`
* `US hundredweight (cwt)`
* `Imperial hundredweight (cwt)`
* `US ton (t)`
* `Imperial ton (t)`
**Imperial Troy**
* `Grain (gr)`
* `Pennyweight (dwt)`
* `Troy dram (dr t)`
* `Troy ounce (oz t)`
* `Troy pound (lb t)`
* `Mark`
**Archaic**
* `Wey`
* `Wool wey`
* `Suffolk wey`
* `Wool sack`
* `Coal sack`
* `Load`
* `Last`
* `Flax or feather last`
* `Gunpowder last`
* `Picul`
* `Rice last`
**Comparisons**
* `Big Ben (14 tonnes)`
* `Blue whale (180 tonnes)`
* `International Space Station (417 tonnes)`
* `Space Shuttle (2,041 tonnes)`
* `RMS Titanic (52,000 tonnes)`
* `Great Pyramid of Giza (6,000,000 tonnes)`
* Earth's oceans (1.4 yottagrams)
**Astronomical**
* `A teaspoon of neutron star (5,500 million tonnes)`
* `Lunar mass (ML)`
* `Earth mass (M⊕)`
* `Jupiter mass (MJ)`
* `Solar mass (M☉)`
* `Sagittarius A* (7.5 x 10^36 kgs-ish)`
* `Milky Way galaxy (1.2 x 10^42 kgs)`
* `The observable universe (1.45 x 10^53 kgs)`
Output units*
Enter the required unit of mass of your output data. You must indicate one of the following:
**Metric**
* `Yoctogram (yg)`
* `Zeptogram (zg)`
* `Attogram (ag)`
* `Femtogram (fg)`
* `Picogram (pg)`
* `Nanogram (ng)`
* `Microgram (μg)`
* `Milligram (mg)`
* `Centigram (cg)`
* `Decigram (dg)`
* `Gram (g)`
* `Decagram (dag)`
* `Hectogram (hg)`
* `Kilogram (kg)`
* `Megagram (Mg)`
* `Tonne (t)`
* `Gigagram (Gg)`
* `Teragram (Tg)`
* `Petagram (Pg)`
* `Exagram (Eg)`
* `Zettagram (Zg)`
* `Yottagram (Yg)`
**Imperial Avoirdupois**
* `Grain (gr)`
* `Dram (dr)`
* `Ounce (oz)`
* `Pound (lb)`
* `Nail`
* `Stone (st)`
* `Quarter (qr)`
* `Tod`
* `US hundredweight (cwt)`
* `Imperial hundredweight (cwt)`
* `US ton (t)`
* `Imperial ton (t)`
**Imperial Troy**
* `Grain (gr)`
* `Pennyweight (dwt)`
* `Troy dram (dr t)`
* `Troy ounce (oz t)`
* `Troy pound (lb t)`
* `Mark`
**Archaic**
* `Wey`
* `Wool wey`
* `Suffolk wey`
* `Wool sack`
* `Coal sack`
* `Load`
* `Last`
* `Flax or feather last`
* `Gunpowder last`
* `Picul`
* `Rice last`
**Comparisons**
* `Big Ben (14 tonnes)`
* `Blue whale (180 tonnes)`
* `International Space Station (417 tonnes)`
* `Space Shuttle (2,041 tonnes)`
* `RMS Titanic (52,000 tonnes)`
* `Great Pyramid of Giza (6,000,000 tonnes)`
* Earth's oceans (1.4 yottagrams)
**Astronomical**
* `A teaspoon of neutron star (5,500 million tonnes)`
* `Lunar mass (ML)`
* `Earth mass (M⊕)`
* `Jupiter mass (MJ)`
* `Solar mass (M☉)`
* `Sagittarius A* (7.5 x 10^36 kgs-ish)`
* `Milky Way galaxy (1.2 x 10^42 kgs)`
* `The observable universe (1.45 x 10^53 kgs)`
***
## Example
Suppose you want to convert a series of events from **kilograms** into **pounds**:
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 mass**.
3. Set **Input units** to `Kilogram (kg)`.
4. Set **Output units** to `Pound (lb)`.
5. Give your **Output field** a name and click **Save**. The unit of mass of the values in your input field will be transformed. For example:
```
Input data - "100"
Input units - "Kilogram (kg)"
Output units - "Pound (lb)"
Output data - "220.4622622"
```
{% 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-mass.md?ask=
```
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.