ppathFromRtePos2

Workspace.ppathFromRtePos2(self: pyarts.arts._Workspace, ppath: pyarts.arts.WorkspaceVariable | pyarts.arts.Ppath | None = self.ppath, rte_los: pyarts.arts.WorkspaceVariable | pyarts.arts.Vector | None = self.rte_los, ppath_lraytrace: pyarts.arts.WorkspaceVariable | pyarts.arts.Numeric | None = self.ppath_lraytrace, ppath_step_agenda: pyarts.arts.WorkspaceVariable | pyarts.arts.Agenda | None = self.ppath_step_agenda, atmosphere_dim: pyarts.arts.WorkspaceVariable | pyarts.arts.Index | None = self.atmosphere_dim, p_grid: pyarts.arts.WorkspaceVariable | pyarts.arts.Vector | None = self.p_grid, lat_grid: pyarts.arts.WorkspaceVariable | pyarts.arts.Vector | None = self.lat_grid, lon_grid: pyarts.arts.WorkspaceVariable | pyarts.arts.Vector | None = self.lon_grid, z_field: pyarts.arts.WorkspaceVariable | pyarts.arts.Tensor3 | None = self.z_field, f_grid: pyarts.arts.WorkspaceVariable | pyarts.arts.Vector | None = self.f_grid, refellipsoid: pyarts.arts.WorkspaceVariable | pyarts.arts.Vector | None = self.refellipsoid, z_surface: pyarts.arts.WorkspaceVariable | pyarts.arts.Matrix | None = self.z_surface, rte_pos: pyarts.arts.WorkspaceVariable | pyarts.arts.Vector | None = self.rte_pos, rte_pos2: pyarts.arts.WorkspaceVariable | pyarts.arts.Vector | None = self.rte_pos2, ppath_lmax: pyarts.arts.WorkspaceVariable | pyarts.arts.Numeric | None = self.ppath_lmax, za_accuracy: pyarts.arts.WorkspaceVariable | pyarts.arts.Numeric | None = 2e-5, pplrt_factor: pyarts.arts.WorkspaceVariable | pyarts.arts.Numeric | None = 5, pplrt_lowest: pyarts.arts.WorkspaceVariable | pyarts.arts.Numeric | None = 0.5, verbosity: pyarts.arts.WorkspaceVariable | pyarts.arts.Verbosity | None = self.verbosity) → None

Determines the propagation path from rte_pos2 to rte_pos.

The propagation path linking rte_pos and rte_pos2 is calculated and returned. The method determines the path in a pure numerical manner, where a simple algorithm is applied. The task is to find the value of rte_los (at rte_pos) linking the two positions.

See the user guide for a description of the search algorithm, including a more detailed definition of za_accuracy, pplrt_factor and pplrt_lowest.

The standard application of this method should be to radio link calculations, where rte_pos2 corresponds to a transmitter, and rte_pos to the receiver/sensor.

The details of the ray tracing is controlled by ppath_step_agenda as usual.

Author(s): Patrick Eriksson

Parameters:

  • ppath (Ppath, optional) – The propagation path for one line-of-sight. See ppath, defaults to self.ppath [OUT]

  • rte_los (Vector, optional) – A line-of-sight for (complete) radiative transfer calculations. See rte_los, defaults to self.rte_los [INOUT]

  • ppath_lraytrace (Numeric, optional) – Maximum length of ray tracing steps when determining propagation. See ppath_lraytrace, defaults to self.ppath_lraytrace [INOUT]

  • ppath_step_agenda (Agenda, optional) – Calculation of a propagation path step. See ppath_step_agenda, defaults to self.ppath_step_agenda [IN]

  • atmosphere_dim (Index, optional) – The atmospheric dimensionality (1-3). See atmosphere_dim, defaults to self.atmosphere_dim [IN]

  • p_grid (Vector, optional) – The pressure grid. See p_grid, defaults to self.p_grid [IN]

  • lat_grid (Vector, optional) – The latitude grid. See lat_grid, defaults to self.lat_grid [IN]

  • lon_grid (Vector, optional) – The longitude grid. See lon_grid, defaults to self.lon_grid [IN]

  • z_field (Tensor3, optional) – The field of geometrical altitudes. See z_field, defaults to self.z_field [IN]

  • f_grid (Vector, optional) – The frequency grid for monochromatic pencil beam calculations. See f_grid, defaults to self.f_grid [IN]

  • refellipsoid (Vector, optional) – Reference ellipsoid. See refellipsoid, defaults to self.refellipsoid [IN]

  • z_surface (Matrix, optional) – The surface altitude. See z_surface, defaults to self.z_surface [IN]

  • rte_pos (Vector, optional) – A geographical position for starting radiative transfer calculations. See rte_pos, defaults to self.rte_pos [IN]

  • rte_pos2 (Vector, optional) – A second geographical position to define the geometry for. See rte_pos2, defaults to self.rte_pos2 [IN]

  • ppath_lmax (Numeric, optional) – Maximum length between points describing propagation paths. See ppath_lmax, defaults to self.ppath_lmax [IN]

  • za_accuracy (Numeric, optional) – Required accuracy, in form of the maximum allowed angular off-set [deg]. Defaults to 2e-5 [IN]

  • pplrt_factor (Numeric, optional) – The factor with which ppath_lraytrace is decreased if no solution is found. Defaults to 5 [IN]

  • pplrt_lowest (Numeric, optional) – Lowest value ppath_lraytrace to consider. The calculations are halted if this length is passed. Defaults to 0.5 [IN]

  • verbosity (Verbosity) – ARTS verbosity. See verbosity, defaults to self.verbosity [IN]