Validation results ITU-R P.836-6

This page contains the validation examples for Recommendation ITU-R P.836-6: Water vapour: surface density and total columnar content.

All test cases were extracted from the ITU Validation examples file (rev 5.1).

Function surface_water_vapour_density

The table below contains the results of testing function surface_water_vapour_density. The test cases were extracted from spreadsheet ITURP836-6_surface_water_vapour_density_annual.csv from the ITU Validation examples file (rev 5.1). In addition to the input-arguments, expected result (ITU Validation), and ITU-Rpy computed result (ITUR-py Result), the absolute and relative errors are shown. Each test case is color-coded depending on the magnitude of the errors (green = pass, errors are negligible, red = fail, relative error is above 0.01%).

In addition, the code snippet below shows an example of how to generate the first row of the results in the table:

import itur

# Define input attributes
lat = 3.133  #  (°N)
lon = 101.7  # (°E)
alt = 0.05125146  # (km)
p = 0.1  # (%)

# Make call to test-function surface_water_vapour_density
itur_val = itur.models.itu836.surface_water_vapour_density(lat=lat, lon=lon, alt=alt, p=p)

# Compute error with respect to value in ITU example file
ITU_example_val = 24.32302408  # (g/m3)
error = ITU_example_val - itur_val.value
error_rel = error / ITU_example_val * 100  # (%)
Validation results models.itu836.surface_water_vapour_density
ITU-Rpy Function lat (°N) lon (°E) alt (km) p (%) ITU Validation (g/m3) ITU-Rpy Result (g/m3) Absolute Error Relative Error
models.itu836.surface_water_vapour_density 3.133 101.70 0.051251 0.10 24.323024 24.323024 3.06e-08 0.000
models.itu836.surface_water_vapour_density 3.133 101.70 0.051251 0.15 24.195729 24.195729 3.52e-08 0.000
models.itu836.surface_water_vapour_density 3.133 101.70 0.051251 0.30 23.952441 23.952441 3.28e-08 0.000
models.itu836.surface_water_vapour_density 3.133 101.70 0.051251 0.35 23.893346 23.893346 2.71e-08 0.000
models.itu836.surface_water_vapour_density 22.900 -43.23 0.000000 0.10 21.591649 21.591649 -2.67e-09 -0.000
models.itu836.surface_water_vapour_density 22.900 -43.23 0.000000 0.15 21.461644 21.461644 6.24e-10 0.000
models.itu836.surface_water_vapour_density 22.900 -43.23 0.000000 0.30 21.247533 21.247533 4.81e-09 0.000
models.itu836.surface_water_vapour_density 22.900 -43.23 0.000000 0.35 21.186760 21.186760 -1.08e-09 -0.000
models.itu836.surface_water_vapour_density 23.000 30.00 0.187594 0.10 11.983147 11.983148 -2.61e-09 -0.000
models.itu836.surface_water_vapour_density 23.000 30.00 0.187594 0.15 11.721333 11.721333 2.28e-09 0.000
models.itu836.surface_water_vapour_density 23.000 30.00 0.187594 0.30 11.229887 11.229887 -6.12e-10 -0.000
models.itu836.surface_water_vapour_density 23.000 30.00 0.187594 0.35 11.117501 11.117501 -4.93e-09 -0.000
models.itu836.surface_water_vapour_density 25.780 -80.22 0.008617 0.10 23.448289 23.448289 -4.73e-09 -0.000
models.itu836.surface_water_vapour_density 25.780 -80.22 0.008617 0.15 23.281960 23.281960 -4.93e-09 -0.000
models.itu836.surface_water_vapour_density 25.780 -80.22 0.008617 0.30 23.000809 23.000809 -1.48e-09 -0.000
models.itu836.surface_water_vapour_density 25.780 -80.22 0.008617 0.35 22.937809 22.937809 -3.99e-09 -0.000
models.itu836.surface_water_vapour_density 28.717 77.30 0.209384 0.10 26.009841 26.009841 1.07e-08 0.000
models.itu836.surface_water_vapour_density 28.717 77.30 0.209384 0.15 25.769706 25.769706 3.15e-09 0.000
models.itu836.surface_water_vapour_density 28.717 77.30 0.209384 0.30 25.398943 25.398943 8.78e-09 0.000
models.itu836.surface_water_vapour_density 28.717 77.30 0.209384 0.35 25.314770 25.314770 9.35e-09 0.000
models.itu836.surface_water_vapour_density 33.940 18.43 0.000000 0.10 24.001565 24.001565 -3.08e-09 -0.000
models.itu836.surface_water_vapour_density 33.940 18.43 0.000000 0.15 23.859876 23.859876 -4.09e-09 -0.000
models.itu836.surface_water_vapour_density 33.940 18.43 0.000000 0.30 23.514645 23.514645 3.03e-09 0.000
models.itu836.surface_water_vapour_density 33.940 18.43 0.000000 0.35 23.419545 23.419545 -3.93e-09 -0.000
models.itu836.surface_water_vapour_density 41.900 12.49 0.046123 0.10 19.851665 19.851665 1.54e-08 0.000
models.itu836.surface_water_vapour_density 41.900 12.49 0.046123 0.15 19.556349 19.556349 1.09e-08 0.000
models.itu836.surface_water_vapour_density 41.900 12.49 0.046123 0.30 19.092542 19.092542 1.56e-08 0.000
models.itu836.surface_water_vapour_density 41.900 12.49 0.046123 0.35 18.988935 18.988935 1.70e-08 0.000
models.itu836.surface_water_vapour_density 51.500 -0.14 0.031383 0.10 15.370307 15.370307 -1.86e-08 -0.000
models.itu836.surface_water_vapour_density 51.500 -0.14 0.031383 0.15 15.177703 15.177703 -1.26e-08 -0.000
models.itu836.surface_water_vapour_density 51.500 -0.14 0.031383 0.30 14.783593 14.783593 -1.66e-08 -0.000
models.itu836.surface_water_vapour_density 51.500 -0.14 0.031383 0.35 14.671618 14.671618 -1.81e-08 -0.000


Function total_water_vapour_content

The table below contains the results of testing function total_water_vapour_content. The test cases were extracted from spreadsheet ITURP836-6_total_water_vapour_content_annual.csv from the ITU Validation examples file (rev 5.1). In addition to the input-arguments, expected result (ITU Validation), and ITU-Rpy computed result (ITUR-py Result), the absolute and relative errors are shown. Each test case is color-coded depending on the magnitude of the errors (green = pass, errors are negligible, red = fail, relative error is above 0.01%).

In addition, the code snippet below shows an example of how to generate the first row of the results in the table:

import itur

# Define input attributes
lat = 3.133  #  (°N)
lon = 101.7  # (°E)
alt = 0.05125146  # (km)
p = 0.1  # (%)

# Make call to test-function total_water_vapour_content
itur_val = itur.models.itu836.total_water_vapour_content(lat=lat, lon=lon, alt=alt, p=p)

# Compute error with respect to value in ITU example file
ITU_example_val = 65.92042976  # (kg/m2)
error = ITU_example_val - itur_val.value
error_rel = error / ITU_example_val * 100  # (%)
Validation results models.itu836.total_water_vapour_content
ITU-Rpy Function lat (°N) lon (°E) alt (km) p (%) ITU Validation (kg/m2) ITU-Rpy Result (kg/m2) Absolute Error Relative Error
models.itu836.total_water_vapour_content 3.133 101.70 0.051251 0.10 65.920430 65.920430 8.01e-08 0.000
models.itu836.total_water_vapour_content 3.133 101.70 0.051251 0.15 65.350645 65.350645 8.86e-08 0.000
models.itu836.total_water_vapour_content 3.133 101.70 0.051251 0.30 64.336356 64.336356 8.42e-08 0.000
models.itu836.total_water_vapour_content 3.133 101.70 0.051251 0.35 64.112166 64.112166 8.34e-08 0.000
models.itu836.total_water_vapour_content 22.900 -43.23 0.000000 0.10 56.387886 56.387886 2.81e-09 0.000
models.itu836.total_water_vapour_content 22.900 -43.23 0.000000 0.15 55.360647 55.360647 3.97e-09 0.000
models.itu836.total_water_vapour_content 22.900 -43.23 0.000000 0.30 53.485111 53.485111 -7.41e-10 -0.000
models.itu836.total_water_vapour_content 22.900 -43.23 0.000000 0.35 53.039183 53.039183 -1.65e-09 -0.000
models.itu836.total_water_vapour_content 23.000 30.00 0.187594 0.10 38.801076 38.801076 3.39e-09 0.000
models.itu836.total_water_vapour_content 23.000 30.00 0.187594 0.15 37.545803 37.545803 1.80e-09 0.000
models.itu836.total_water_vapour_content 23.000 30.00 0.187594 0.30 34.965412 34.965412 2.92e-09 0.000
models.itu836.total_water_vapour_content 23.000 30.00 0.187594 0.35 34.401687 34.401687 -4.85e-09 -0.000
models.itu836.total_water_vapour_content 25.780 -80.22 0.008617 0.10 62.684831 62.684831 -3.05e-09 -0.000
models.itu836.total_water_vapour_content 25.780 -80.22 0.008617 0.15 61.793775 61.793775 4.01e-09 0.000
models.itu836.total_water_vapour_content 25.780 -80.22 0.008617 0.30 60.314611 60.314611 -7.41e-10 -0.000
models.itu836.total_water_vapour_content 25.780 -80.22 0.008617 0.35 59.984996 59.984996 3.17e-09 0.000
models.itu836.total_water_vapour_content 28.717 77.30 0.209384 0.10 75.614529 75.614529 2.00e-08 0.000
models.itu836.total_water_vapour_content 28.717 77.30 0.209384 0.15 74.963746 74.963746 2.42e-08 0.000
models.itu836.total_water_vapour_content 28.717 77.30 0.209384 0.30 73.574292 73.574292 2.03e-08 0.000
models.itu836.total_water_vapour_content 28.717 77.30 0.209384 0.35 73.243239 73.243239 2.15e-08 0.000
models.itu836.total_water_vapour_content 33.940 18.43 0.000000 0.10 45.198952 45.198952 -4.96e-09 -0.000
models.itu836.total_water_vapour_content 33.940 18.43 0.000000 0.15 44.152752 44.152752 2.59e-10 0.000
models.itu836.total_water_vapour_content 33.940 18.43 0.000000 0.30 42.210224 42.210224 -1.94e-09 -0.000
models.itu836.total_water_vapour_content 33.940 18.43 0.000000 0.35 41.697726 41.697726 -3.38e-09 -0.000
models.itu836.total_water_vapour_content 41.900 12.49 0.046123 0.10 40.071283 40.071283 2.20e-08 0.000
models.itu836.total_water_vapour_content 41.900 12.49 0.046123 0.15 39.474620 39.474620 2.39e-08 0.000
models.itu836.total_water_vapour_content 41.900 12.49 0.046123 0.30 38.329647 38.329647 2.46e-08 0.000
models.itu836.total_water_vapour_content 41.900 12.49 0.046123 0.35 38.083213 38.083213 2.15e-08 0.000
models.itu836.total_water_vapour_content 51.500 -0.14 0.031383 0.10 39.642498 39.642498 -4.76e-08 -0.000
models.itu836.total_water_vapour_content 51.500 -0.14 0.031383 0.15 38.824475 38.824475 -4.33e-08 -0.000
models.itu836.total_water_vapour_content 51.500 -0.14 0.031383 0.30 37.295953 37.295953 -4.50e-08 -0.000
models.itu836.total_water_vapour_content 51.500 -0.14 0.031383 0.35 36.822058 36.822058 -4.19e-08 -0.000