Metar - Python METAR report parser

2.0.1 · active · verified Fri Apr 17

Metar is a Python package designed to parse METAR-coded weather reports, providing easy access to various meteorological data points such as wind, temperature, visibility, and cloud conditions. The project recently settled on the package name `metar` (previously `python-metar`). It is currently at version 2.0.1, with an active release cadence, and requires Python >=3.10.

Common errors

```
ModuleNotFoundError: No module named 'python_metar'
```
cause Attempting to import using the old package name after installing the new `metar` package, or not having the `metar` package installed.

fix Ensure you have installed the correct package with `pip install metar` and update your import statements to `from metar.Metar import Metar`.
```
TypeError: Metar() got an unexpected keyword argument 'utcdelta'
```
cause You are passing the `utcdelta` argument to the `Metar` constructor, which was removed in version 2.0.0.

fix Remove the `utcdelta` argument from the `Metar` constructor call. The library no longer uses this parameter.
```
AttributeError: 'Position' object has no attribute 'getdistance'
```
cause You are attempting to call the `getdistance` method on a `Position` object, which was removed in version 1.9.0.

fix This method is no longer available. You will need to implement a custom distance calculation if this functionality is required.

Warnings

breaking The `utcdelta` argument was removed from the `Metar` constructor in version 2.0.0. This was a breaking change.
Fix: Remove the `utcdelta` argument when instantiating `Metar`. The library now handles UTC offsets internally or expects UTC input.
breaking The `position.getdistance` API was removed in version 1.9.0 as it was unused and broken.
Fix: If you were using `position.getdistance`, you will need to implement custom distance calculation or find an alternative method. The library no longer provides this functionality.
gotcha The package name has officially settled on `metar`. While older versions might have been installed as `python-metar`, ensure your `pip install` command and `import` statements use `metar`.
Fix: Use `pip install metar` for installation and `from metar.Metar import Metar` for imports.
gotcha The library now officially requires Python 3.10 or newer. Installing on older Python versions will likely result in compatibility errors.
Fix: Ensure your environment uses Python 3.10 or a newer version.

Install

pip install metar Install latest version

Imports

Metar
wrong:
```
from python_metar.Metar import Metar
```
correct:
```
from metar.Metar import Metar
```
The package was historically known as `python-metar`. Ensure you use `metar` for imports with recent versions.

Quickstart

Parse a sample METAR string and access its attributes, then print a human-readable summary.

from metar.Metar import Metar

# Example METAR string
metar_string = "METAR KSLK 200853Z AUTO 09006KT 10SM CLR 02/M01 A2999 RMK AO2"

# Parse the METAR report
m = Metar(metar_string)

# Access parsed data
print(f"Station: {m.station_id}")
print(f"Time: {m.time}")
print(f"Wind: {m.wind_dir}{m.wind_speed}KT")
print(f"Temperature: {m.temp}°C")
print(f"Dew Point: {m.dewpt}°C")
print(f"Visibility: {m.vis.value}{m.vis.units}")

# Print a formatted report
print("\n--- Formatted Report ---")
print(m.string())

view raw JSON →