set_intensity / set_phase / add_phase

パターンバッファ全体の振幅・位相を一括で書き換える. focus などのパターン関数は位相だけを書くので, 振幅はこれらの関数で設定する.

pattern_buffer で確保したバッファの初期値は位相 0・最大振幅である. C# では new Emission[n] の要素は振幅 0 で初期化されることに注意

set_intensity

全振動子の振幅を設定する. 位相は変えない. Intensity::MIN を渡すと無出力になる.

Rust

set_intensity(intensity, &mut dst);

Python

set_intensity(intensity, dst)

C#

Pattern.SetIntensity(intensity, dst);

set_phase

全振動子の位相を設定する. 振幅は変えない.

Rust

set_phase(phase, &mut dst);

Python

set_phase(phase, dst)

C#

Pattern.SetPhase(phase, dst);

set_phase_and_intensity

全振動子の位相と振幅を設定する.

Rust

set_phase_and_intensity(phase, intensity, &mut dst);

Python

set_phase_and_intensity(phase, intensity, dst)

C#

Pattern.SetPhaseAndIntensity(phase, intensity, dst);

add_phase

全振動子の位相へ一律に加算する (8 bit で折り返す). 振幅は変えない.

Rust

add_phase(phase, &mut dst);

Python

add_phase(phase, dst)

C#

Pattern.AddPhase(phase, dst);

引数	型	説明
intensity	Intensity	振幅
phase	Phase	位相
dst	&mut [[Emission; _]]	対象バッファ

Example

Rust

use autd3_rs::geometry::{Autd3, Geometry, offset};
use autd3_rs::units::{m, mm, s};
use autd3_rs::value::{Intensity, Phase};
use autd3_rs_pattern::{add_phase, focus, set_intensity, wavelength};

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

let mut dst = geometry.pattern_buffer();

set_intensity(Intensity(0x80), &mut dst);
focus(
    &geometry,
    geometry.center() + offset(0.0 * mm, 0.0 * mm, 150.0 * mm),
    wavelength(340.0 * m / s),
    &mut dst,
);
add_phase(Phase::PI, &mut dst);

set_intensity(Intensity::MIN, &mut dst);

Python

import numpy as np
from autd3.geometry import Autd3, Geometry
from autd3.units import m, s
from autd3.value import Intensity, Phase
from autd3_pattern import add_phase, focus, set_intensity, wavelength

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

dst = geometry.pattern_buffer()

set_intensity(Intensity(0x80), dst)
focus(
    geometry,
    geometry.center() + np.array([0.0, 0.0, 150.0]),
    wavelength(340 * m / s),
    dst,
)
add_phase(Phase.PI, dst)

set_intensity(Intensity.MIN, dst)

C#

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

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

var dst = geometry.PatternBuffer();

Pattern.SetIntensity(new Intensity(0x80), dst);
Pattern.Focus(
    geometry,
    geometry.Center + new Vector3(0.0f, 0.0f, 150.0f),
    Pattern.Wavelength(340.0f * m / s),
    dst
);
Pattern.AddPhase(Phase.Pi, dst);

Pattern.SetIntensity(Intensity.Min, dst);