Skip to main content

ScatteringTable

Struct ScatteringTable 

Source
pub struct ScatteringTable { /* private fields */ }
Expand description

Precomputed centre-of-mass scattering angle theta(eps, beta).

The table stores y = ln tan(theta/2) on a grid uniform in ln eps and ln beta, and interpolates bilinearly in those coordinates. y is close to linear in ln beta at both ends (tan(theta/2) ~ 1/beta as beta -> 0, and theta ~ beta^-k for large beta), which is what makes bilinear interpolation accurate. Since d theta = sin(theta) dy, an error dy in the table value is at most dy radians in theta.

The angle depends on (eps, beta) and on the screening function only; Z1, Z2 and the screening length enter through the reduced variables. The table keeps its Potential so one table serves one (Z1, Z2, potential) pair and converts to and from SI. It is built once and shared read-only (&ScatteringTable is Sync).

§Error bound

At build time the interpolation error against direct quadrature is measured at cell centres (where bilinear interpolation error peaks) on a deterministic subset of cells. ScatteringTable::max_abs_error is the largest absolute error in theta seen (radians) and ScatteringTable::max_rel_error the largest relative error where theta > 1e-6. These are empirical bounds from sampling, not proofs.

Outside the grid: beta >= beta_max returns 0.0; beta < beta_min is clamped to beta_min; eps outside [eps_min, eps_max] returns None.

Implementations§

Source§

impl ScatteringTable

Source

pub fn build(potential: &Potential, spec: &TableSpec) -> Self

Build a table by direct quadrature. Serial and deterministic.

Source

pub fn potential(&self) -> &Potential

The potential this table was built for.

Source

pub fn spec(&self) -> &TableSpec

The grid specification.

Source

pub fn max_abs_error(&self) -> f64

Largest absolute theta error (radians) found against quadrature at sampled cell centres.

Source

pub fn max_rel_error(&self) -> f64

Largest relative theta error found at sampled cell centres where theta > 1e-6.

Source

pub fn theta(&self, eps: f64, beta: f64) -> Option<f64>

Interpolated centre-of-mass angle (radians), or None if eps is out of the tabulated range.

Source

pub fn half_angle_tan(&self, eps: f64, beta: f64) -> Option<f64>

Interpolated tan(theta / 2) (the stored quantity is its logarithm), or None if eps is out of the tabulated range; 0.0 for beta >= beta_max. ScatteringTable::theta is 2 atan of this.

The collision code needs sin and cos of theta / 2 (energy transfer, lab angles), which follow from the tangent by algebra, so it avoids the atan here and the trigonometric calls that would undo it.

Source

pub fn shape(&self) -> (usize, usize)

Number of grid points in (eps, beta).

Trait Implementations§

Source§

impl Clone for ScatteringTable

Source§

fn clone(&self) -> ScatteringTable

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
Source§

impl Debug for ScatteringTable

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ

Converts 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 more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
where F: FnOnce(&Self) -> bool,

Converts 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
§

impl<T> Pointable for T

§

const ALIGN: usize

The alignment of pointer.
§

type Init = T

The type for initializers.
§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

§

fn vzip(self) -> V