spectral_radiance_observer_agenda
=================================

.. currentmodule:: pyarts3.workspace

.. attribute:: Workspace.spectral_radiance_observer_agenda
   :type: ~pyarts3.arts.Agenda
   
   Spectral radiance as seen from the input position and environment
   
   The intent of this agenda is to provide the spectral radiance as seen from the observer
   position and line of sight.
   
   It also outputs the :attr:`~pyarts3.workspace.Workspace.ray_path` as seen from the observer position and line of sight.
   This is useful in-case a call to the destructive :func:`~pyarts3.workspace.Workspace.spectral_radianceApplyUnitFromSpectralRadiance`
   is warranted
   
   It is possible to execute :attr:`~pyarts3.workspace.Workspace.spectral_radiance_observer_agenda` directly from the workspace by calling :func:`~pyarts3.workspace.Workspace.spectral_radiance_observer_agendaExecute`.
   
   As all agendas in ARTS, :attr:`~pyarts3.workspace.Workspace.spectral_radiance_observer_agenda` is also customizable via its operator helper class: :class:`~pyarts3.arts.spectral_radiance_observer_agendaOperator`.
   See it, :func:`~pyarts3.workspace.Workspace.spectral_radiance_observer_agendaSetOperator`, and :func:`~pyarts3.workspace.Workspace.spectral_radiance_observer_agendaExecuteOperator` for more details.
   
   :attr:`~pyarts3.workspace.Workspace.spectral_radiance_observer_agenda` have these constraints ():
   
   #. On output, :attr:`~pyarts3.workspace.Workspace.spectral_radiance` has the size of :attr:`~pyarts3.workspace.Workspace.frequency_grid`.
   #. On output, :attr:`~pyarts3.workspace.Workspace.spectral_radiance_jacobian` has the shape of the expected :attr:`~pyarts3.workspace.Workspace.model_state_vector` (i.e., the x-size of :attr:`~pyarts3.workspace.Workspace.jacobian_targets`) times the size of :attr:`~pyarts3.workspace.Workspace.frequency_grid`.
   
   
   
   
   Parameters
   ----------
   spectral_radiance : ~pyarts3.arts.StokvecVector
       A spectral radiance vector. See :attr:`~pyarts3.workspace.Workspace.spectral_radiance` **[OUT]**
   spectral_radiance_jacobian : ~pyarts3.arts.StokvecMatrix
       Jacobian of :attr:`~pyarts3.workspace.Workspace.spectral_radiance` with respect to :attr:`~pyarts3.workspace.Workspace.jacobian_targets`. See :attr:`~pyarts3.workspace.Workspace.spectral_radiance_jacobian` **[OUT]**
   ray_path : ~pyarts3.arts.ArrayOfPropagationPathPoint
       A list path points making up a propagation path. See :attr:`~pyarts3.workspace.Workspace.ray_path` **[OUT]**
   frequency_grid : ~pyarts3.arts.AscendingGrid
       A single frequency grid. See :attr:`~pyarts3.workspace.Workspace.frequency_grid` **[IN]**
   jacobian_targets : ~pyarts3.arts.JacobianTargets
       A list of targets for the Jacobian Matrix calculations. See :attr:`~pyarts3.workspace.Workspace.jacobian_targets` **[IN]**
   spectral_radiance_observer_position : ~pyarts3.arts.Vector3
       The position of an observer of spectral radiance. See :attr:`~pyarts3.workspace.Workspace.spectral_radiance_observer_position` **[IN]**
   spectral_radiance_observer_line_of_sight : ~pyarts3.arts.Vector2
       The line-of-sight of the observer of spectral radiance. See :attr:`~pyarts3.workspace.Workspace.spectral_radiance_observer_line_of_sight` **[IN]**
   atmospheric_field : ~pyarts3.arts.AtmField
       An atmospheric field in ARTS. See :attr:`~pyarts3.workspace.Workspace.atmospheric_field` **[IN]**
   surface_field : ~pyarts3.arts.SurfaceField
       The surface field describes the surface properties. See :attr:`~pyarts3.workspace.Workspace.surface_field` **[IN]**
   subsurface_field : ~pyarts3.arts.SubsurfaceField
       The sub0surface field describes the sub-surface properties. See :attr:`~pyarts3.workspace.Workspace.subsurface_field` **[IN]**
   
   
   
   .. rubric:: Default value
   
   #. :func:`~pyarts3.workspace.Workspace.ray_path_observer_agendaExecute`
   #. hse_derivative = 0
   #. :func:`~pyarts3.workspace.Workspace.spectral_radianceClearskyEmission`
   #. :func:`~pyarts3.workspace.Workspace.spectral_radiance_jacobianAddSensorJacobianPerturbations`
   
   
   
   
   .. rubric:: Input to workspace methods
   
   .. hlist::
       :columns: 1
   
       * :func:`~pyarts3.workspace.Workspace.measurement_vectorFromSensor` 
       * :func:`~pyarts3.workspace.Workspace.spectral_radianceFlatScalarReflectance` 
       * :func:`~pyarts3.workspace.Workspace.spectral_radiance_jacobianAddSensorJacobianPerturbations` 
       * :func:`~pyarts3.workspace.Workspace.spectral_radiance_observer_agendaExecute`
   
   
   .. rubric:: Output from workspace methods
   
   .. hlist::
       :columns: 1
   
       * :func:`~pyarts3.workspace.Workspace.spectral_radiance_observer_agendaSet` 
       * :func:`~pyarts3.workspace.Workspace.spectral_radiance_observer_agendaSetOperator`
   
   
   .. rubric:: Related workspace variables
   
   .. hlist::
       :columns: 2
   
       * :attr:`~pyarts3.workspace.Workspace.disort_spectral_radiance_field` 
       * :attr:`~pyarts3.workspace.Workspace.ray_path_spectral_radiance_jacobian` 
       * :attr:`~pyarts3.workspace.Workspace.ray_path_spectral_radiance_scattering` 
       * :attr:`~pyarts3.workspace.Workspace.ray_path_spectral_radiance_source` 
       * :attr:`~pyarts3.workspace.Workspace.ray_path_spectral_radiance_source_jacobian` 
       * :attr:`~pyarts3.workspace.Workspace.spectral_radiance` 
       * :attr:`~pyarts3.workspace.Workspace.spectral_radiance_background` 
       * :attr:`~pyarts3.workspace.Workspace.spectral_radiance_background_jacobian` 
       * :attr:`~pyarts3.workspace.Workspace.spectral_radiance_field` 
       * :attr:`~pyarts3.workspace.Workspace.spectral_radiance_jacobian` 
       * :attr:`~pyarts3.workspace.Workspace.spectral_radiance_observer_line_of_sight` 
       * :attr:`~pyarts3.workspace.Workspace.spectral_radiance_observer_position` 
       * :attr:`~pyarts3.workspace.Workspace.spectral_radiance_operator` 
       * :attr:`~pyarts3.workspace.Workspace.spectral_radiance_space_agenda` 
       * :attr:`~pyarts3.workspace.Workspace.spectral_radiance_surface_agenda` 
       * :attr:`~pyarts3.workspace.Workspace.spectral_radiance_transform_operator`
   
   .. :class:`~pyarts3.arts.Agenda`