pysiral.ers.l1_adapter
======================

.. py:module:: pysiral.ers.l1_adapter


Attributes
----------

.. autoapisummary::

   pysiral.ers.l1_adapter.__author__


Classes
-------

.. autoapisummary::

   pysiral.ers.l1_adapter.ERSReaperSGDR


Module Contents
---------------

.. py:data:: __author__
   :value: 'Stefan Hendricks'


.. py:class:: ERSReaperSGDR(cfg, raise_on_error=False)

   Bases: :py:obj:`pysiral.l1preproc.Level1PInputHandlerBase`


   Converts a Envisat SGDR object into a L1bData object 


   .. py:attribute:: timer
      :value: None



   .. py:attribute:: l1
      :value: None



   .. py:attribute:: filepath
      :value: None



   .. py:method:: get_l1(filepath, *args, **kwargs)

      Read the Envisat SGDR file and transfers its content to a Level1Data instance
      :param filepath: The full file path to the netCDF file
      :return: The parsed (or empty) Level-1 data container



   .. py:method:: _read_sgdr()

      Read the L1b file and create a ERS native L1b object 



   .. py:method:: _set_input_file_metadata()

      Extract essential metadata information from SGDR file 



   .. py:method:: _set_l1_data_groups()


   .. py:method:: _transfer_timeorbit() -> None

      Extracts the time/orbit data group from the SGDR data and set
      the l1 timeorbit data group

      :raises None:

      :return: None



   .. py:method:: _transfer_waveform_collection()

      Transfers the waveform data (power & range for each range bin) 



   .. py:method:: _transfer_range_corrections()

      Transfer range correction data from the SGDR netCDF to the
      l1bdata object. The parameter are defined in
      config/mission_def.yaml for ers1/ers2
      -> ersX.settings.sgdr_range_correction_targets

      For a description of the parameter see section 3.10 in the
      REAPER handbook



   .. py:method:: _transfer_classifiers()

      Transfer classifier parameter from the SGDR netCDF to the
      l1bdata object. Most parameter are defined in
      config/mission_def.yaml for ers1/ers2
      -> ersX.settings.sgdr_range_correction_targets



   .. py:method:: _transfer_surface_type_data()


   .. py:property:: empty

      Default return object, if nodata should be returned
      :return: Representation of an empty object (None)