.. DO NOT EDIT. .. THIS FILE WAS AUTOMATICALLY GENERATED BY SPHINX-GALLERY. .. TO MAKE CHANGES, EDIT THE SOURCE PYTHON FILE: .. "examples/formats/NEXRAD_Level_2_File.py" .. LINE NUMBERS ARE GIVEN BELOW. .. only:: html .. note:: :class: sphx-glr-download-link-note :ref:`Go to the end ` to download the full example code. .. rst-class:: sphx-glr-example-title .. _sphx_glr_examples_formats_NEXRAD_Level_2_File.py: =================== NEXRAD Level 2 File =================== Use MetPy to read information from a NEXRAD Level 2 (volume) file and plot .. GENERATED FROM PYTHON SOURCE LINES 11-22 .. code-block:: Python import cartopy.crs as ccrs import matplotlib.gridspec as gridspec import matplotlib.pyplot as plt import numpy as np from metpy.calc import azimuth_range_to_lat_lon from metpy.cbook import get_test_data from metpy.io import Level2File from metpy.plots import add_metpy_logo, add_timestamp, USCOUNTIES from metpy.units import units .. GENERATED FROM PYTHON SOURCE LINES 23-24 Open the file .. GENERATED FROM PYTHON SOURCE LINES 24-28 .. code-block:: Python name = get_test_data('KTLX20130520_201643_V06.gz', as_file_obj=False) f = Level2File(name) print(f.sweeps[0][0]) .. rst-class:: sphx-glr-script-out .. code-block:: none Radial(header=Msg31DataHdr(stid=b'KTLX', time_ms=73003850, date=15846, az_num=1, az_angle=123.20343017578125, compression=0, rad_length=6856, az_spacing=0.5, rad_status=5, el_num=1, sector_num=1, el_angle=0.5987548828125, spot_blanking=None, az_index_mode=0.25, num_data_blks=7), vol_consts=VolConsts(type=b'R', name=b'VOL', size=44, major=1, minor=0, lat=35.33305740356445, lon=-97.27748107910156, site_amsl=369, feedhorn_agl=19, calib_dbz=-43.72919845581055, txpower_h=185.05685424804688, txpower_v=181.45559692382812, sys_zdr=-0.08510557562112808, phidp0=25.0, vcp=12, processing_status=None), elev_consts=ElConsts(type=b'R', name=b'ELV', size=12, atmos_atten=-0.012, calib_dbz0=-42.4375), radial_consts=RadConstsV1(type=b'R', name=b'RAD', size=20, unamb_range=466.0, noise_h=-79.71426391601562, noise_v=-79.39848327636719, nyq_vel=8.3), moments={b'REF': (DataBlockHdr(type=b'D', name=b'REF', reserved=0, num_gates=1832, first_gate=2.125, gate_width=0.25, tover=5.0, snr_thresh=1.6, recombined=None, data_size=8, scale=2.0, offset=66.0), array([ 6.5, 2.5, 11. , ..., nan, nan, nan])), b'ZDR': (DataBlockHdr(type=b'D', name=b'ZDR', reserved=0, num_gates=1192, first_gate=2.125, gate_width=0.25, tover=5.0, snr_thresh=1.6, recombined=None, data_size=8, scale=16.0, offset=128.0), array([2.375 , 6.1875, 3.75 , ..., nan, nan, nan])), b'PHI': (DataBlockHdr(type=b'D', name=b'PHI', reserved=0, num_gates=1192, first_gate=2.125, gate_width=0.25, tover=5.0, snr_thresh=1.6, recombined=None, data_size=16, scale=2.8361001014709473, offset=2.0), array([32.79150829, 41.60642988, 30.32333025, ..., nan, nan, nan])), b'RHO': (DataBlockHdr(type=b'D', name=b'RHO', reserved=0, num_gates=1192, first_gate=2.125, gate_width=0.25, tover=5.0, snr_thresh=1.6, recombined=None, data_size=8, scale=300.0, offset=-60.5), array([0.995 , 0.95833333, 0.99833333, ..., nan, nan, nan]))}) .. GENERATED FROM PYTHON SOURCE LINES 29-36 .. code-block:: Python # Pull data out of the file sweep = 0 # First item in ray is header, which has azimuth angle az = np.array([ray[0].az_angle for ray in f.sweeps[sweep]]) .. GENERATED FROM PYTHON SOURCE LINES 37-40 We need to take the single azimuth (nominally a mid-point) we get in the data and convert it to be the azimuth of the boundary between rays of data, taking care to handle where the azimuth crosses from 0 to 360. .. GENERATED FROM PYTHON SOURCE LINES 40-53 .. code-block:: Python diff = np.diff(az) crossed = diff < -180 diff[crossed] += 360. avg_spacing = diff.mean() # Convert mid-point to edge az = (az[:-1] + az[1:]) / 2 az[crossed] += 180. # Concatenate with overall start and end of data we calculate using the average spacing az = np.concatenate(([az[0] - avg_spacing], az, [az[-1] + avg_spacing])) az = units.Quantity(az, 'degrees') .. GENERATED FROM PYTHON SOURCE LINES 54-55 Calculate ranges for the gates from the metadata .. GENERATED FROM PYTHON SOURCE LINES 55-71 .. code-block:: Python # 5th item is a dict mapping a var name (byte string) to a tuple # of (header, data array) ref_hdr = f.sweeps[sweep][0][4][b'REF'][0] ref_range = (np.arange(ref_hdr.num_gates + 1) - 0.5) * ref_hdr.gate_width + ref_hdr.first_gate ref_range = units.Quantity(ref_range, 'kilometers') ref = np.array([ray[4][b'REF'][1] for ray in f.sweeps[sweep]]) rho_hdr = f.sweeps[sweep][0][4][b'RHO'][0] rho_range = (np.arange(rho_hdr.num_gates + 1) - 0.5) * rho_hdr.gate_width + rho_hdr.first_gate rho_range = units.Quantity(rho_range, 'kilometers') rho = np.array([ray[4][b'RHO'][1] for ray in f.sweeps[sweep]]) # Extract central longitude and latitude from file cent_lon = f.sweeps[0][0][1].lon cent_lat = f.sweeps[0][0][1].lat .. GENERATED FROM PYTHON SOURCE LINES 72-94 .. code-block:: Python spec = gridspec.GridSpec(1, 2) fig = plt.figure(figsize=(15, 8)) add_metpy_logo(fig, 190, 85, size='large') for var_data, var_range, ax_rect in zip((ref, rho), (ref_range, rho_range), spec): # Turn into an array, then mask data = np.ma.array(var_data) data[np.isnan(data)] = np.ma.masked # Convert az,range to x,y xlocs, ylocs = azimuth_range_to_lat_lon(az, var_range, cent_lon, cent_lat) # Plot the data crs = ccrs.LambertConformal(central_longitude=cent_lon, central_latitude=cent_lat) ax = fig.add_subplot(ax_rect, projection=crs) ax.add_feature(USCOUNTIES, linewidth=0.5) ax.pcolormesh(xlocs, ylocs, data, cmap='viridis', transform=ccrs.PlateCarree()) ax.set_extent([cent_lon - 0.5, cent_lon + 0.5, cent_lat - 0.5, cent_lat + 0.5]) ax.set_aspect('equal', 'datalim') add_timestamp(ax, f.dt, y=0.02, high_contrast=True) plt.show() .. image-sg:: /examples/formats/images/sphx_glr_NEXRAD_Level_2_File_001.png :alt: NEXRAD Level 2 File :srcset: /examples/formats/images/sphx_glr_NEXRAD_Level_2_File_001.png :class: sphx-glr-single-img .. rst-class:: sphx-glr-timing **Total running time of the script:** (0 minutes 5.442 seconds) .. _sphx_glr_download_examples_formats_NEXRAD_Level_2_File.py: .. only:: html .. container:: sphx-glr-footer sphx-glr-footer-example .. container:: sphx-glr-download sphx-glr-download-jupyter :download:`Download Jupyter notebook: NEXRAD_Level_2_File.ipynb ` .. container:: sphx-glr-download sphx-glr-download-python :download:`Download Python source code: NEXRAD_Level_2_File.py ` .. container:: sphx-glr-download sphx-glr-download-zip :download:`Download zipped: NEXRAD_Level_2_File.zip ` .. only:: html .. rst-class:: sphx-glr-signature `Gallery generated by Sphinx-Gallery `_