qspec.gaussian_beam_3d  (  r ,  k ,  w0 ,  r0 = None ,  p0 = None ,  axis = -1  )[source]

Parameters:

rarray_like

The position 3-vector where to calculate the beam intensity (m).

karray_like

The k-wave-3-vector of light (rad / m).

w0array_like

The beam waist (m).

r0array_like

The position 3-vector of the beam waist. Is (0m, 0m, 0m) if r0 is not specified (m).

p0array_like

The total power propagated by the gaussian beam. Is 1W if p0 is not specified (W).

axisint

The axis along which the vector components are aligned.

Returns:

outarray_like

The intensity of a gaussian beam with k-wave-vector k at the position r - r0 (W/m**2 == uW/mm**2).

Raises:

ValueError

r, k and r0 must have 3 components along the specified axis. The shapes of r, k, w0, r0 and p0 must be compatible.