fresnel_conv

dnois.optics.df.fresnel_conv(pupil: Tensor, wl: Real | Sequence[Real] | Tensor = None, distance: Real | Sequence[Real] | Tensor = None, dx: float | Tensor = None, dy: float | Tensor = None, **kwargs) Tensor

Computes Fresnel diffraction integral using convolution method:

\[\begin{split}U'(x,y)&=\frac{\e^{\i kd}}{\i\lambda d}\iint U(u,v) \e^{\i\frac{k}{2d}\left((x-u)^2+(y-v)^2\right)}\d u\d v \\ &=U(x,y)\ast\frac{\e^{\i kd}}{\i\lambda d}\e^{\i\frac{k}{2d}(x^2+y^2)}\end{split}\]

where \(U\) and \(U'\) are the complex amplitude on source and target plane, respectively, \(d\) is the distance between two planes, \(\lambda\) is wavelength, \(\ast\) represents convolution and \(k=2\pi/\lambda\).

Note that some intermediate computational steps don’t depend on pupil and pre-computing their results can avoid repeated computation if this function is expected to be called multiple times, as long as the arguments other than pupil don’t change. This can be done by calling init_fresnel_conv() and passing its return value as intermediate argument. In this case, wl, distance, dx and dy cannot be passed. If all of them are given, intermediate will be ignored anyway.

Parameters:
  • pupil (Tensor) – Pupil function \(U\). A tensor of shape \((\cdots,N_d,N_\lambda,H,W)\).

  • wl (float, Sequence[float] or Tensor) – Wavelengths \(\lambda\). A scalar or a tensor of shape \((N_\lambda,)\).

  • distance (float, Sequence[float] or Tensor) – Propagation distance \(d\). A scalar or a tensor of shape \((N_d,)\).

  • dx (float or Tensor) – Grid spacing in horizontal direction to ensure correct scale for DFT. A scalar or a tensor of shape \((\cdots,N_d,N_\lambda)\). Default: ignored.

  • dy (float or Tensor) – Grid spacing in vertical direction, similar to dx. Default: same as dx. Note that dy will be also ignored if dx is None even though dy is given.

  • kwargs

    Optional keyword arguments:

    Parameter

    Type

    Description

    ksize

    int | tuple[int, int]

    Spatial dimension of the kernel function in vertical and horizontal directions. Default: identical to that of pupil.

    padding

    int | str

    See dconv(). Default: linear.

    dft_scale

    bool

    Whether to apply DFT-scale. See Fourier transform. Default: True.

    phase_factor

    bool

    Whether to multiply \(\e^{\i kd}/\i\) in kernel function. It can be omitted to reduce computation if only amplitude matters. Default: True.

    scale_factor

    bool

    Whether to multiply \(1/(\lambda d)\) in kernel function. It can be omitted to reduce computation if relative scales across different \(d\) and \(\lambda\) do not matter. Default: True.

    simpson

    bool

    Whether to apply Simpson’s rule. Default: True.

    intermediate

    dict

    Cached intermediate results returned by init_fresnel_conv(). This can be used to speed up computation. Default: omitted.

Returns:

Diffracted complex amplitude \(U'\). A tensor of shape \((\cdots,N_d,N_\lambda,H,W)\).

Return type:

Tensor