Struct MultiRelaxationMedium
pub struct MultiRelaxationMedium {
pub c_0_m_s: f64,
pub classical_viscous_coeff: f64,
pub processes: Vec<RelaxationProcess>,
}Expand description
Multi-relaxation + classical thermoviscous causal acoustic medium.
Fields§
§c_0_m_s: f64Equilibrium low-frequency phase speed $c_0 > 0$ in $\text{m}\cdot\text{s}^{-1}$.
classical_viscous_coeff: f64Classical Stokes-Kirchhoff thermoviscous coefficient $\beta_{\text{visc}} \ge 0$ in $\text{Np}\cdot\text{m}^{-1}\cdot\text{s}^2\cdot\text{rad}^{-2}$.
processes: Vec<RelaxationProcess>Discrete molecular relaxation mechanisms.
Implementations§
§impl MultiRelaxationMedium
impl MultiRelaxationMedium
pub fn validate(&self) -> Result<(), NumericalError>
pub fn validate(&self) -> Result<(), NumericalError>
Validate medium and relaxation process parameters.
pub fn standard_atmosphere_20c_50rh() -> MultiRelaxationMedium
pub fn standard_atmosphere_20c_50rh() -> MultiRelaxationMedium
Standard atmospheric air ($\text{O}_2$ and $\text{N}_2$ vibrational relaxation at $20^\circ\text{C}$, $1\text{ atm}$, $50%$ RH).
pub fn standard_seawater_10c_35ppt() -> MultiRelaxationMedium
pub fn standard_seawater_10c_35ppt() -> MultiRelaxationMedium
Standard ocean seawater ($\text{B(OH)}_3$ boric acid $\sim 1\text{ kHz}$ and $\text{MgSO}_4$ magnesium sulfate $\sim 75\text{ kHz}$ at $10^\circ\text{C}, 35\text{ ppt}, \text{pH}=8.0$).
pub fn attenuation_np_m(&self, omega_rad_s: f64) -> Result<f64, NumericalError>
pub fn attenuation_np_m(&self, omega_rad_s: f64) -> Result<f64, NumericalError>
Total attenuation $\alpha(\omega)$ in $\text{Np}\cdot\text{m}^{-1}$: $$\alpha(\omega) = \frac{1}{2 c_0}\sum_r \Delta_r \frac{\omega^2 / \omega_r}{1 + (\omega/\omega_r)^2} + \beta_{\text{visc}}\omega^2$$
pub fn slowness_shift_s_m(
&self,
omega_rad_s: f64,
omega_0_rad_s: f64,
) -> Result<f64, NumericalError>
pub fn slowness_shift_s_m( &self, omega_rad_s: f64, omega_0_rad_s: f64, ) -> Result<f64, NumericalError>
Analytical Kramers-Kronig slowness shift $\frac{1}{c(\omega)} - \frac{1}{c(\omega_0)}$ in $\text{s}\cdot\text{m}^{-1}$: $$\frac{1}{c(\omega)} - \frac{1}{c(\omega_0)} = -\frac{1}{2 c_0}\sum_r \Delta_r \left(\frac{(\omega/\omega_r)^2}{1 + (\omega/\omega_r)^2} - \frac{(\omega_0/\omega_r)^2}{1 + (\omega_0/\omega_r)^2}\right)$$
pub fn phase_speed_m_s(&self, omega_rad_s: f64) -> Result<f64, NumericalError>
pub fn phase_speed_m_s(&self, omega_rad_s: f64) -> Result<f64, NumericalError>
Causal phase speed $c(\omega)$ in $\text{m}\cdot\text{s}^{-1}$ (relative to $c_0 = c(0)$).
pub fn numerical_kk_slowness_shift_quadrature(
&self,
omega_rad_s: f64,
omega_0_rad_s: f64,
steps: usize,
) -> Result<f64, NumericalError>
pub fn numerical_kk_slowness_shift_quadrature( &self, omega_rad_s: f64, omega_0_rad_s: f64, steps: usize, ) -> Result<f64, NumericalError>
Independent numerical Kramers-Kronig Hilbert quadrature of the relaxation attenuation using the singularity-subtracted Cauchy principal value identity: $$\frac{1}{c(\omega)} - \frac{1}{c(\omega_0)} = \frac{2(\omega^2 - \omega_0^2)}{\pi}\int_0^\infty \frac{g(\Omega) - g(\omega)\frac{\Omega^2 - \omega_0^2}{\omega^2 - \omega_0^2} - g(\omega_0)\frac{\omega^2 - \Omega^2}{\omega^2 - \omega_0^2}}{(\Omega^2 - \omega^2)(\Omega^2 - \omega_0^2)},d\Omega$$ where $g(\Omega) = \frac{\alpha_{\text{rel}}(\Omega)}{\Omega}$ and the Cauchy principal value of $\int_0^\infty \frac{d\Omega}{\Omega^2 - \omega^2} = 0$ identically for $\omega > 0$.
Trait Implementations§
§impl Clone for MultiRelaxationMedium
impl Clone for MultiRelaxationMedium
§fn clone(&self) -> MultiRelaxationMedium
fn clone(&self) -> MultiRelaxationMedium
1.0.0 (const: unstable) · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source. Read more§impl Debug for MultiRelaxationMedium
impl Debug for MultiRelaxationMedium
§impl PartialEq for MultiRelaxationMedium
impl PartialEq for MultiRelaxationMedium
impl StructuralPartialEq for MultiRelaxationMedium
Auto Trait Implementations§
impl Freeze for MultiRelaxationMedium
impl RefUnwindSafe for MultiRelaxationMedium
impl Send for MultiRelaxationMedium
impl Sync for MultiRelaxationMedium
impl Unpin for MultiRelaxationMedium
impl UnsafeUnpin for MultiRelaxationMedium
impl UnwindSafe for MultiRelaxationMedium
Blanket Implementations§
§impl<S, A> Aggregate<Result<S, Error>> for Awhere
A: Aggregate<S>,
impl<S, A> Aggregate<Result<S, Error>> for Awhere
A: Aggregate<S>,
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
§impl<T> Instrument for T
impl<T> Instrument for T
§fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read more