propagation_matrixAddFaraday

Workspace.propagation_matrixAddFaraday(self, propagation_matrix: pyarts.arts.PropmatVector | None = None, propagation_matrix_jacobian: pyarts.arts.PropmatMatrix | None = None, frequency_grid: pyarts.arts.AscendingGrid | None = None, absorption_species: pyarts.arts.ArrayOfArrayOfSpeciesTag | None = None, propagation_matrix_select_species: pyarts.arts.SpeciesEnum | None = None, jacobian_targets: pyarts.arts.JacobianTargets | None = None, atmospheric_point: pyarts.arts.AtmPoint | None = None, ray_path_point: pyarts.arts.PropagationPathPoint | None = None) → None

Calculates absorption matrix describing Faraday rotation.

Faraday rotation is a change of polarization state of an electromagnetic wave propagating through charged matter by interaction with a magnetic field. Hence, this method requires absorption_species to contain ‘free_electrons’ and electron content field (as part of vmr_field) as well as magnetic field (mag_u_field, mag_v_field, mag_w_field) to be specified.

Faraday rotation affects Stokes parameters 2 and 3 (but not intensity!). Therefore, this method requires stokes_dim>2.

Like all ‘propagation_matrixAdd*’ methods, the method is additive, i.e., does not overwrite the propagation matrix propagation_matrix, but adds further contributions.

Author(s): Patrick Eriksson

Parameters:

• propagation_matrix (PropmatVector, optional) – This contains the propagation matrix for the current path point. See propagation_matrix, defaults to self.propagation_matrix [INOUT]

• propagation_matrix_jacobian (PropmatMatrix, optional) – . See propagation_matrix_jacobian, defaults to self.propagation_matrix_jacobian [INOUT]

• frequency_grid (AscendingGrid, optional) – The discrete frequency grid. See frequency_grid, defaults to self.frequency_grid [IN]

• absorption_species (ArrayOfArrayOfSpeciesTag, optional) – Tag groups for gas absorption. See absorption_species, defaults to self.absorption_species [IN]

• propagation_matrix_select_species (SpeciesEnum, optional) – A select species tag group from absorption_species. See propagation_matrix_select_species, defaults to self.propagation_matrix_select_species [IN]

• jacobian_targets (JacobianTargets, optional) – A list of targets for the Jacobian Matrix calculations. See jacobian_targets, defaults to self.jacobian_targets [IN]

• atmospheric_point (AtmPoint, optional) – An atmospheric point in ARTS. See atmospheric_point, defaults to self.atmospheric_point [IN]

• ray_path_point (PropagationPathPoint, optional) – A single path point. See ray_path_point, defaults to self.ray_path_point [IN]