.. _sphx_glr_auto_examples_transform:

.. _transform_examples:

Transform Examples
--------------------------

Examples showing how to resample data onto a new coordinate while propagating quality control.


.. raw:: html

  <div id='sg-tag-list' class='sphx-glr-tag-list'></div>


.. raw:: html

    <div class="sphx-glr-thumbnails">

.. thumbnail-parent-div-open

.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example bin-averages 1-minute ARM surface meteorology data onto a 30-minute time base using act.transform.bin_average, and shows how the file&#x27;s CF time_bounds variable is used to weight each input sample by how much of its measurement interval overlaps each output bin.">

.. only:: html

  .. image:: /auto_examples/transform/images/thumb/sphx_glr_plot_bin_average_resample_thumb.png
    :alt:

  :doc:`/auto_examples/transform/plot_bin_average_resample`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Resample a datastream onto a coarser time base</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example compares the three transforms on temperature and a present-weather code. The target is offset by 30 seconds from the input timestamps, so no target point matches an input sample exactly.">

.. only:: html

  .. image:: /auto_examples/transform/images/thumb/sphx_glr_plot_compare_transforms_thumb.png
    :alt:

  :doc:`/auto_examples/transform/plot_compare_transforms`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Comparing bin_average, interpolate, and subsample</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Shortwave irradiance should not be negative. This example uses a real ARM surface-radiation file in which the downwelling shortwave sensor reports small negative nighttime offsets. The datastream&#x27;s fail_min QC test flags those samples as bad.">

.. only:: html

  .. image:: /auto_examples/transform/images/thumb/sphx_glr_plot_transform_qc_propagation_thumb.png
    :alt:

  :doc:`/auto_examples/transform/plot_transform_qc_propagation`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Propagating quality control through a resample</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="act.transform.transform_dataset applies a transform to every variable in a Dataset that has the target dimension, pairing each variable with its qc_ companion automatically and picking up the CF bounds variable for bin_average. Per-variable overrides are useful when variables in one Dataset require different transforms.">

.. only:: html

  .. image:: /auto_examples/transform/images/thumb/sphx_glr_plot_transform_dataset_thumb.png
    :alt:

  :doc:`/auto_examples/transform/plot_transform_dataset`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Transforming a whole Dataset at once</div>
    </div>


.. thumbnail-parent-div-close

.. raw:: html

    </div>


.. toctree::
   :hidden:

   /auto_examples/transform/plot_bin_average_resample
   /auto_examples/transform/plot_compare_transforms
   /auto_examples/transform/plot_transform_qc_propagation
   /auto_examples/transform/plot_transform_dataset