laguerre_gaussian

laguerre_gaussian_phase generates a Laguerre-Gaussian (LG) beam .

Besides laguerre_gaussian_phase, which writes only the phase, there is laguerre_gaussian_intensity, which writes only the amplitude.

API

Rust

let option = LaguerreGaussianOption {
    p: 1,
    l: 1,
    waist: 10.0 * mm,
};
laguerre_gaussian_phase(&geometry, target, axis, option, wavelength, &mut phases);
laguerre_gaussian_intensity(&geometry, target, axis, option, wavelength, &mut intensities);

Python

option = LaguerreGaussianOption(p=1, l=1, waist=10.0)
laguerre_gaussian_phase(geometry, target, axis, option, wavelength, phases)
laguerre_gaussian_intensity(geometry, target, axis, option, wavelength, intensities)

C#

var option = new LaguerreGaussianOption(p: 1, l: 1, waist: 10.0f * mm);
Pattern.LaguerreGaussianPhase(geometry, target, axis, option, wavelength, phases);
Pattern.LaguerreGaussianIntensity(geometry, target, axis, option, wavelength, intensities);

Parameter	Type	Description
geometry	&Geometry	Device layout
target	Point3<f32>	Center of the beam waist [mm]
axis	UnitVector3<f32>	Propagation direction (unit vector)
option	LaguerreGaussianOption	Mode and waist
wavelength	Length	Wavelength
dst	&mut [Vec<Phase>] / &mut [Vec<Intensity>]	Output buffer (phases for *_phase, intensities for *_intensity)

Field	Type	Description
p	u32	Radial mode index
l	i32	Azimuthal mode index
waist	Length	Beam waist radius (positive)

Example

Rust

use autd3_rs::geometry::{Autd3, Geometry, Vector3, offset};
use autd3_rs::units::{m, mm, s};
use autd3_rs_pattern::{
    LaguerreGaussianOption, laguerre_gaussian_phase, laguerre_gaussian_intensity, wavelength,
};

let geometry = Geometry::new(vec![Autd3::default()]);

let mut phases = geometry.phase_buffer();
let mut intensities = geometry.intensity_buffer();

let target = geometry.center() + offset(0.0 * mm, 0.0 * mm, 150.0 * mm);
let option = LaguerreGaussianOption {
    p: 0,
    l: 1,
    waist: 10.0 * mm,
};
let wavelength = wavelength(340.0 * m / s);
laguerre_gaussian_phase(
    &geometry,
    target,
    Vector3::z_axis(),
    option,
    wavelength,
    &mut phases,
);
laguerre_gaussian_intensity(
    &geometry,
    target,
    Vector3::z_axis(),
    option,
    wavelength,
    &mut intensities,
);

Python

import numpy as np
from autd3.geometry import Autd3, Geometry
from autd3.units import m, s
from autd3_pattern import (
    LaguerreGaussianOption,
    laguerre_gaussian_phase,
    laguerre_gaussian_intensity,
)
from autd3_pattern import wavelength as calc_wavelength

geometry = Geometry([Autd3([0.0, 0.0, 0.0], [1.0, 0.0, 0.0, 0.0])])

phases = geometry.phase_buffer()
intensities = geometry.intensity_buffer()

target = geometry.center() + np.array([0.0, 0.0, 150.0])
option = LaguerreGaussianOption(p=0, l=1, waist=10.0)
wavelength = calc_wavelength(340 * m / s)
laguerre_gaussian_phase(geometry, target, np.array([0.0, 0.0, 1.0]), option, wavelength, phases)
laguerre_gaussian_intensity(geometry, target, np.array([0.0, 0.0, 1.0]), option, wavelength, intensities)

C#

using System.Numerics;
using AUTD3;
using static AUTD3.Units;

var geometry = new Geometry(new[] { new Autd3(Vector3.Zero) });

var phases = geometry.PhaseBuffer();
var intensities = geometry.IntensityBuffer();

var target = geometry.Center + new Vector3(0.0f, 0.0f, 150.0f);
var option = new LaguerreGaussianOption(p: 0, l: 1, waist: 10.0f * mm);
var wavelength = Pattern.Wavelength(340.0f * m / s);
Pattern.LaguerreGaussianPhase(geometry, target, Vector3.UnitZ, option, wavelength, phases);
Pattern.LaguerreGaussianIntensity(geometry, target, Vector3.UnitZ, option, wavelength, intensities);