A single meteorological variable value is set as a threshold from which precipitation type is discriminated. If the meteorological variable value is above the threshold, precipitation is classified as rain, otherwise as snow.
If air temperature (Ta) is chosen as meteorological variable:
$\begin{equation*} T_{a} <= T_{a_{threshold}} \longrightarrow Snow \\ T_{a} > T_{a_{threshold}} \longrightarrow Rain \end{equation*}$
In the following example we’ll show how PyPROS classifies precipitation considering the single threshold methodology.
First of all, we’ll import the required libraries.
from pypros.pros import PyPros
As an example, we’ll get the precipitation type classification from different methodologies for Catalonia on 2017-03-25 00.30 UTC. For this purpose we’ll use an air temperature, dew point temperature, digital elevation model (DEM) and reflectivity fields.
Those fields can be found in notebooks/data directory and we’ll keep the path for all of them:
tair_file = '../sample-data/INT_TAIR_20170325_0030.tif'
tdew_file = '../sample-data/INT_TDEW_20170325_0030.tif'
dem_file = '../sample-data/DEM_CAT.tif'
Now, we’ll define those parameters that PyPros class uses and are the same whether the methodology changes or not. These parameters are: variables_files
and data_format
. For more information on this class, see PyPros Class notebook.
variables_files = [tair_file,
tdew_file,
dem_file]
data_format = {'vars_files':['tair', 'tdew', 'dem']}
Since we want to apply a single air temperature threshold, first we’ll define method
PyPros parameter as 'single_ta'
and then we’ll set the threshold
parameter to 1.0∘C.
method = 'single_ta'
threshold = 1.0
Now, we’re ready to call PyPros class!
single_ta = PyPros(variables_files, method, threshold, data_format)
We can get a quicklook of the obtained field using plot_pros
function:
import matplotlib.pyplot as plt
plt.imshow(single_ta.result)
plt.show()
In addition, we can save the precipitation type field in a raster file using save_file
function:
single_ta.save_file(single_ta.result, '../sample-data/output/single_ta.tif')
If we have a reflectivity field, we can also apply it as a mask by using refl_mask
function and save it as a raster file. However, we’ll have to read first the reflectivity field. For this purpose we need to import gdal.
from osgeo import gdal
refl_file = '../sample-data/CAPPI_XRAD_20170325_0030.tif'
refl_array = gdal.Open(refl_file).ReadAsArray()
Once we’ve read the refl_field
we can call the refl_mask
function.
single_ta_masked = single_ta.refl_mask()
single_ta.save_file(single_ta_masked, '../sample-data/output/single_ta_masked.tif')
We want to apply a single wet bulb temperature threshold, so first we’ll define method
PyPros parameter as 'single_tw'
and then we’ll set the threshold
parameter to 1.5∘C.
method = 'single_tw'
threshold = 1.5
Now, we’re ready to call PyPros class!
single_tw = PyPros(variables_files, method, threshold, data_format)
We can get a quicklook of the obtained field using plot_pros
function:
import matplotlib.pyplot as plt
plt.imshow(single_tw.result)
plt.show()
In addition, we can save the precipitation type field in a raster file using save_file
function:
single_tw.save_file(single_tw.result, '../sample-data/output/single_tw.tif')
If we have a reflectivity field, we can also apply it as a mask by using refl_mask
function and save it as a raster file. However, we’ll have to read first the reflectivity field. For this purpose we need to import gdal.
from osgeo import gdal
refl_file = '../sample-data/CAPPI_XRAD_20170325_0030.tif'
refl_array = gdal.Open(refl_file).ReadAsArray()
Once we’ve read the refl_file
we can call the refl_mask
function.
single_tw_masked = single_tw.refl_mask(refl_array)
single_tw.save_file(single_tw_masked, '../sample-data/output/single_tw_masked.tif')