.. DO NOT EDIT.
.. THIS FILE WAS AUTOMATICALLY GENERATED BY SPHINX-GALLERY.
.. TO MAKE CHANGES, EDIT THE SOURCE PYTHON FILE:
.. "auto_examples/retrievals/plot_tucker_dl.py"
.. LINE NUMBERS ARE GIVEN BELOW.

.. only:: html

    .. note::
        :class: sphx-glr-download-link-note

        :ref:`Go to the end <sphx_glr_download_auto_examples_retrievals_plot_tucker_dl.py>`
        to download the full example code.

.. rst-class:: sphx-glr-example-title

.. _sphx_glr_auto_examples_retrievals_plot_tucker_dl.py:


Example for using the Tucker method to retrieve the planetary boundary layer height from Doppler lidar data.
============================================================================================================
The Tucker method uses the lag-1 autocorrelation of the radial velocity to estimate the atmospheric (turbulent) velocity variance and the instrument noise velocity variance.
The planetary boundary layer height is then estimated as the height of the first range gate whose atmospheric variance exceeds a specified threshold.
The example below uses a Doppler lidar dataset from the ARM SGP site, but the method can be applied to any Doppler lidar dataset with radial velocity data.

References:
Tucker, S. C., Hardesty, R. M., & Brewer, W. A. (2009). Estimating the planetary boundary layer height from Doppler lidar radial velocity measurements.
Journal of Atmospheric and Oceanic Technology, 26(9), 1745-175

.. GENERATED FROM PYTHON SOURCE LINES 12-52



.. image-sg:: /auto_examples/retrievals/images/sphx_glr_plot_tucker_dl_001.png
   :alt: Tucker Method PBL Height Retrieval, sgpdlfptE13.b1 pbl_tucker on 20260722, sgpdlfptE13.b1 tucker_atmospheric_variance on 20260722, sgpdlfptE13.b1 tucker_noise_variance on 20260722
   :srcset: /auto_examples/retrievals/images/sphx_glr_plot_tucker_dl_001.png
   :class: sphx-glr-single-img





.. code-block:: Python


    import matplotlib.pyplot as plt

    import act

    dl_ds = act.io.read_arm_netcdf(act.tests.sample_files.EXAMPLE_DLFPT)
    dl_ds = act.retrievals.calculate_tucker_method_pbl(dl_ds, interval="10min")

    display = act.plotting.TimeSeriesDisplay(dl_ds, subplot_shape=(3,), figsize=(12, 10))
    display.plot('intensity', cmap='Spectral_r', vmin=1, vmax=1.5, subplot_index=(0,))
    display.plot(
        'pbl_tucker',
        subplot_index=(0,),
        label='PBL Height (m)',
        color='black',
        linestyle='-',
        linewidth=2,
    )
    display.plot(
        'tucker_atmospheric_variance',
        subplot_index=(1,),
        vmin=0,
        vmax=0.5,
        label='Atmospheric Variance',
        cmap='Spectral_r',
    )
    display.plot(
        'tucker_noise_variance',
        subplot_index=(2,),
        vmin=0,
        vmax=0.5,
        label='Noise Variance',
        cmap='Spectral_r',
    )
    display.set_yrng([0, 3000], subplot_index=(0,))
    display.set_yrng([0, 3000], subplot_index=(1,))
    display.set_yrng([0, 3000], subplot_index=(2,))

    plt.suptitle('Tucker Method PBL Height Retrieval', fontsize=16)
    plt.show()


.. rst-class:: sphx-glr-timing

   **Total running time of the script:** (0 minutes 34.380 seconds)


.. _sphx_glr_download_auto_examples_retrievals_plot_tucker_dl.py:

.. only:: html

  .. container:: sphx-glr-footer sphx-glr-footer-example

    .. container:: sphx-glr-download sphx-glr-download-jupyter

      :download:`Download Jupyter notebook: plot_tucker_dl.ipynb <plot_tucker_dl.ipynb>`

    .. container:: sphx-glr-download sphx-glr-download-python

      :download:`Download Python source code: plot_tucker_dl.py <plot_tucker_dl.py>`

    .. container:: sphx-glr-download sphx-glr-download-zip

      :download:`Download zipped: plot_tucker_dl.zip <plot_tucker_dl.zip>`


.. only:: html

 .. rst-class:: sphx-glr-signature

    `Gallery generated by Sphinx-Gallery <https://sphinx-gallery.github.io>`_