Units.md•2.43 kB
---
title: Units Converter Tool
kind: reference
header_svg:
src: "/assets/svg/tool-units-hero.svg"
static: "/assets/svg/tool-units-hero-static.svg"
title: "Units Converter Tool"
animate: true
theme_variant: "auto"
reduced_motion: "auto"
---
{% assign header_svg = page.header_svg %}
{% include header-svg.html %}
# Units Converter Tool
The Units Converter tool provides seamless conversion between different unit systems using the Pint unit registry. It supports SI, imperial, and specialized physics units.
## Capabilities
- Convert between SI base units and derived units
- Imperial unit conversions (feet, pounds, Fahrenheit, etc.)
- Physics-specific units (electron volts, astronomical units, etc.)
- Automatic unit validation and error handling
- Support for complex unit expressions
## Usage Examples
### Basic Unit Conversion
```json
{
"tool": "units_convert",
"params": {
"quantity": {"value": 100, "unit": "mile"},
"to": "kilometer"
}
}
```
### Physics Unit Conversions
```json
{
"tool": "units_convert",
"params": {
"quantity": {"value": 1.6, "unit": "eV"},
"to": "J"
}
}
```
### Complex Unit Expressions
```json
{
"tool": "units_convert",
"params": {
"quantity": {"value": 25, "unit": "m/s"},
"to": "mph"
}
}
```
## Supported Unit Categories
- **Length**: meter, foot, inch, mile, light-year, parsec, astronomical unit
- **Mass**: kilogram, pound, gram, atomic mass unit
- **Time**: second, minute, hour, day, year
- **Energy**: joule, electron volt, calorie, BTU, watt-hour
- **Temperature**: kelvin, celsius, fahrenheit
- **Electric**: ampere, volt, ohm, farad, henry
- **Magnetic**: tesla, gauss, weber
- **Radiation**: becquerel, gray, sievert
## Common Physics Conversions
| From | To | Example |
|------|----|---------|
| eV | J | 1.6 eV = 2.56×10⁻¹⁹ J |
| AU | m | 1 AU = 1.496×10¹¹ m |
| pc | m | 1 pc = 3.086×10¹⁶ m |
| G | T | 1 G = 1×10⁻⁴ T |
| atm | Pa | 1 atm = 101325 Pa |
## Error Handling
The tool provides clear error messages for:
- Invalid unit names
- Incompatible unit types
- Overflow/underflow in conversions
- Unsupported unit combinations
## Integration with Other Tools
Units conversion is automatically integrated with:
- CAS tool for symbolic calculations with units
- Plot tool for axis labeling
- Constants tool for physical constants with units
- Data processing tools for unit-aware data analysis