Units

Contents

Units#

Overview#

Wetterdienst offers conversion of units based on the parameter type and a number of predefined units.

The default units per each unit type are shown below:

1from wetterdienst.model.unit import UnitConverter
2
3unit_converter = UnitConverter()
4unit_converter.targets
{'angle': Unit(name='degree', symbol='°'),
 'concentration': Unit(name='milligram_per_liter', symbol='mg/l'),
 'mass_per_volume': Unit(name='gram_per_cubic_meter', symbol='g/m³'),
 'conductivity': Unit(name='microsiemens_per_centimeter', symbol='µS/cm'),
 'dimensionless': Unit(name='dimensionless', symbol='-'),
 'energy_per_area': Unit(name='joule_per_square_centimeter', symbol='J/cm²'),
 'power_per_area': Unit(name='watt_per_square_meter', symbol='W/m²'),
 'length_short': Unit(name='centimeter', symbol='cm'),
 'length_medium': Unit(name='meter', symbol='m'),
 'length_long': Unit(name='kilometer', symbol='km'),
 'fraction': Unit(name='decimal', symbol='-'),
 'precipitation': Unit(name='millimeter', symbol='mm'),
 'precipitation_intensity': Unit(name='millimeter_per_hour', symbol='mm/h'),
 'pressure': Unit(name='hectopascal', symbol='hPa'),
 'significant_weather': Unit(name='significant_weather', symbol='sign [0..95]'),
 'speed': Unit(name='meter_per_second', symbol='m/s'),
 'temperature': Unit(name='degree_celsius', symbol='°C'),
 'time': Unit(name='second', symbol='s'),
 'turbidity': Unit(name='nephelometric_turbidity', symbol='NTU'),
 'volume_per_time': Unit(name='cubic_meter_per_second', symbol='m³/s'),
 'wind_scale': Unit(name='beaufort', symbol='bft'),
 'degree_day': Unit(name='degree_celsius_day', symbol='°Cd'),
 'degree_hour': Unit(name='degree_celsius_hour', symbol='°Ch')}

All available units per each unit type:

1from wetterdienst.model.unit import UnitConverter
2
3unit_converter = UnitConverter()
4unit_converter.units
{'angle': [Unit(name='degree', symbol='°'),
  Unit(name='radian', symbol='rad'),
  Unit(name='gradian', symbol='grad')],
 'concentration': [Unit(name='milligram_per_liter', symbol='mg/l'),
  Unit(name='gram_per_liter', symbol='g/l'),
  Unit(name='gram_per_cubic_meter', symbol='g/m³'),
  Unit(name='kilogram_per_cubic_meter', symbol='kg/m³')],
 'mass_per_volume': [Unit(name='milligram_per_liter', symbol='mg/l'),
  Unit(name='gram_per_liter', symbol='g/l'),
  Unit(name='gram_per_cubic_meter', symbol='g/m³'),
  Unit(name='kilogram_per_cubic_meter', symbol='kg/m³')],
 'conductivity': [Unit(name='microsiemens_per_centimeter', symbol='µS/cm'),
  Unit(name='microsiemens_per_meter', symbol='µS/m'),
  Unit(name='siemens_per_centimeter', symbol='S/cm'),
  Unit(name='siemens_per_meter', symbol='S/m')],
 'dimensionless': [Unit(name='dimensionless', symbol='-')],
 'energy_per_area': [Unit(name='joule_per_square_centimeter', symbol='J/cm²'),
  Unit(name='joule_per_square_meter', symbol='J/m²'),
  Unit(name='kilojoule_per_square_meter', symbol='kJ/m²')],
 'fraction': [Unit(name='decimal', symbol='-'),
  Unit(name='percent', symbol='%'),
  Unit(name='one_eighth', symbol='1/8')],
 'power_per_area': [Unit(name='watt_per_square_centimeter', symbol='W/cm²'),
  Unit(name='watt_per_square_meter', symbol='W/m²'),
  Unit(name='kilowatt_per_square_meter', symbol='kW/m²')],
 'length_short': [Unit(name='millimeter', symbol='mm'),
  Unit(name='centimeter', symbol='cm'),
  Unit(name='meter', symbol='m'),
  Unit(name='kilometer', symbol='km'),
  Unit(name='mile', symbol='mi'),
  Unit(name='nautical_mile', symbol='nmi')],
 'length_medium': [Unit(name='millimeter', symbol='mm'),
  Unit(name='centimeter', symbol='cm'),
  Unit(name='meter', symbol='m'),
  Unit(name='kilometer', symbol='km'),
  Unit(name='mile', symbol='mi'),
  Unit(name='nautical_mile', symbol='nmi')],
 'length_long': [Unit(name='millimeter', symbol='mm'),
  Unit(name='centimeter', symbol='cm'),
  Unit(name='meter', symbol='m'),
  Unit(name='kilometer', symbol='km'),
  Unit(name='mile', symbol='mi'),
  Unit(name='nautical_mile', symbol='nmi')],
 'precipitation': [Unit(name='millimeter', symbol='mm'),
  Unit(name='liter_per_square_meter', symbol='l/m²')],
 'precipitation_intensity': [Unit(name='millimeter_per_hour', symbol='mm/h'),
  Unit(name='liter_per_square_meter_per_hour', symbol='l/m²/h'),
  Unit(name='millimeter_per_second', symbol='mm/s')],
 'pressure': [Unit(name='pascal', symbol='Pa'),
  Unit(name='hectopascal', symbol='hPa'),
  Unit(name='kilopascal', symbol='kPa')],
 'significant_weather': [Unit(name='significant_weather', symbol='sign [0..95]')],
 'speed': [Unit(name='meter_per_second', symbol='m/s'),
  Unit(name='kilometer_per_hour', symbol='km/h'),
  Unit(name='knots', symbol='kn'),
  Unit(name='beaufort', symbol='bft')],
 'temperature': [Unit(name='degree_celsius', symbol='°C'),
  Unit(name='degree_kelvin', symbol='K'),
  Unit(name='degree_fahrenheit', symbol='°F')],
 'time': [Unit(name='second', symbol='s'),
  Unit(name='minute', symbol='min'),
  Unit(name='hour', symbol='h')],
 'turbidity': [Unit(name='nephelometric_turbidity', symbol='NTU')],
 'volume_per_time': [Unit(name='liter_per_second', symbol='l/s'),
  Unit(name='cubic_meter_per_second', symbol='m³/s')],
 'wind_scale': [Unit(name='beaufort', symbol='bft')],
 'degree_day': [Unit(name='degree_celsius_day', symbol='°Cd'),
  Unit(name='degree_kelvin_day', symbol='Kd'),
  Unit(name='degree_fahrenheit_day', symbol='°Fd')],
 'degree_hour': [Unit(name='degree_celsius_hour', symbol='°Ch'),
  Unit(name='degree_kelvin_hour', symbol='Kh'),
  Unit(name='degree_fahrenheit_hour', symbol='°Fh')]}

Not all of those can be asked for. A few exist so that a provider can declare the unit its source publishes in and have the conversion happen – millimeter_per_second is what BUFR gives a precipitation rate as – and converting to one of them would round the value away, so they are refused as a target. They are named per unit type, a unit name not being unique to one:

1from wetterdienst.model.unit import UnitConverter
2
3unit_converter = UnitConverter()
4unit_converter.source_only_units
frozenset({('precipitation_intensity', 'millimeter_per_second')})

To set a different unit, you can use the unit_targets option of the request (Options). The following example shows how to convert the temperature to Fahrenheit:

 1from wetterdienst import Options
 2from wetterdienst.provider.dwd.observation import DwdObservationRequest
 3
 4options = Options(unit_targets={"temperature": "degree_fahrenheit"})
 5request = DwdObservationRequest(
 6    parameters=[("daily", "kl", "temperature_air_mean_2m")],
 7    options=options
 8)
 9stations = request.filter_by_station_id(station_id="1048")
10values = stations.values().all()
11df = values.df
12df
dwd/observation daily/climate_summary: the server has data files of 3 station(s) that its station description does not list, so they are not offered as stations and their data cannot be requested: 01018, 02996, 05047 (GH-3258)
shape: (28_209, 7)
station_idresolutiondatasetparametertimestampvaluequality_flags
strstrstrstrdatetime[μs, UTC]f64str
"01048""daily""climate_summary""temperature_air_mean_2m"1934-01-01 00:00:00 UTC32.9"1"
"01048""daily""climate_summary""temperature_air_mean_2m"1934-01-02 00:00:00 UTC31.82"1"
"01048""daily""climate_summary""temperature_air_mean_2m"1934-01-03 00:00:00 UTC30.74"1"
"01048""daily""climate_summary""temperature_air_mean_2m"1934-01-04 00:00:00 UTC29.12"1"
"01048""daily""climate_summary""temperature_air_mean_2m"1934-01-05 00:00:00 UTC33.62"1"
…………………
"01048""daily""climate_summary""temperature_air_mean_2m"2026-10-18 00:00:00 UTC49.28"1"
"01048""daily""climate_summary""temperature_air_mean_2m"2026-10-19 00:00:00 UTC45.14"1"
"01048""daily""climate_summary""temperature_air_mean_2m"2026-10-20 00:00:00 UTC44.06"1"
"01048""daily""climate_summary""temperature_air_mean_2m"2026-10-21 00:00:00 UTC53.6"1"
"01048""daily""climate_summary""temperature_air_mean_2m"2026-10-22 00:00:00 UTC50.36"1"