measurement_sensorAddCamera

Workspace.measurement_sensorAddCamera(self, measurement_sensor: ArrayOfSensorObsel = self.measurement_sensor, measurement_sensor_meta: ArrayOfSensorMetaInfo = self.measurement_sensor_meta, freq_grid: AscendingGrid = self.freq_grid, pos: Vector3, los: Vector2, pol: Stokvec = [1, 0, 0, 0], n_h: Index, n_w: Index, ccd_h: Numeric, ccd_w: Numeric, focal_length: Numeric, aperture_diameter: Numeric, focus_distance: Numeric) → None

Adds a simple thin-lens camera model to the measurement sensor.

The camera is described by a CCD array of n_h x n_w pixels with physical dimensions ccd_h x ccd_w (in meters), a lens with the given focal_length and aperture_diameter, and a focus_distance that determines the in-focus plane distance from the lens.

Each pixel maps to a unique line-of-sight direction computed via the thin-lens equation. The image distance (lens-to-CCD) is derived from the thin-lens formula:

\[d_i = \frac{f \cdot d_o}{d_o - f}\]

where f is the focal length and d_o is the focus distance.

The angular offset of pixel (ih, iw) from the CCD center is:

\[\Delta\theta_{zen} = -\arctan\!\left(\frac{\Delta y}{d_i}\right),\quad \Delta\theta_{azi} = -\arctan\!\left(\frac{\Delta x}{d_i}\right)\]

(negated because the CCD image is inverted by the lens).

A Dirac weight is assigned per pixel per frequency channel, yielding n_h x n_w x nfreq observation elements. All observation elements share the same frequency grid and the same PosLos grid (one entry per pixel).

Author: Richard Larsson

Parameters:

  • measurement_sensor (~pyarts3.arts.ArrayOfSensorObsel, optional) – A list of sensor elements that fully describe one or more observing sensor(s). Defaults to self.measurement_sensor. [INOUT]

  • measurement_sensor_meta (~pyarts3.arts.ArrayOfSensorMetaInfo, optional) – Metadata describing each sensor’s block in measurement_vec. Defaults to self.measurement_sensor_meta. [INOUT]

  • freq_grid (~pyarts3.arts.AscendingGrid, optional) – A frequency grid. Unit: Hz. Defaults to self.freq_grid. [IN]

  • pos (Vector3) – Observer position [alt, lat, lon]. [IN]

  • los (Vector2) – Central pixel line of sight [zenith, azimuth]. [IN]

  • pol (~pyarts3.arts.Stokvec, optional) – Polarization Stokes weight per pixel. Defaults to 1 0 0 0 [IN]

  • n_h (Index) – Number of pixels along the CCD height (rows). [IN]

  • n_w (Index) – Number of pixels along the CCD width (columns). [IN]

  • ccd_h (Numeric) – Physical height of the CCD in meters. [IN]

  • ccd_w (Numeric) – Physical width of the CCD in meters. [IN]

  • focal_length (Numeric) – Focal length of the lens in meters. [IN]

  • aperture_diameter (Numeric) – Diameter of the lens aperture in meters. [IN]

  • focus_distance (Numeric) – Distance to the in-focus plane in meters (must be > focal_length). [IN]