nalgebra/nalgebra-glm/src/gtx/norm.rs

113 lines
3.1 KiB
Rust
Raw Normal View History

2019-03-23 21:29:07 +08:00
use crate::aliases::TVec;
2021-08-08 18:59:40 +08:00
use crate::RealNumber;
2018-09-21 01:54:12 +08:00
/// The squared distance between two points.
///
/// # See also:
///
/// * [`distance`](fn.distance.html)
2021-08-08 18:59:40 +08:00
pub fn distance2<T: RealNumber, const D: usize>(p0: &TVec<T, D>, p1: &TVec<T, D>) -> T {
2018-09-21 01:54:12 +08:00
(p1 - p0).norm_squared()
}
/// The l1-norm of `x - y`.
2018-10-08 22:56:58 +08:00
///
/// # See also:
///
/// * [`l1_norm`](fn.l1_norm.html)
/// * [`l2_distance`](fn.l2_distance.html)
/// * [`l2_norm`](fn.l2_norm.html)
2021-08-08 18:59:40 +08:00
pub fn l1_distance<T: RealNumber, const D: usize>(x: &TVec<T, D>, y: &TVec<T, D>) -> T {
2018-09-23 21:59:24 +08:00
l1_norm(&(y - x))
2018-09-21 01:54:12 +08:00
}
/// The l1-norm of `v`.
2018-10-08 22:56:58 +08:00
///
/// This is also known as the "Manhattan distance" or "taxicab distance" and
/// corresponds to the sum of the absolute values of the components of `v`.
///
/// # See also:
///
/// * [`l1_distance`](fn.l1_distance.html)
/// * [`l2_distance`](fn.l2_distance.html)
/// * [`l2_norm`](fn.l2_norm.html)
2021-08-08 18:59:40 +08:00
pub fn l1_norm<T: RealNumber, const D: usize>(v: &TVec<T, D>) -> T {
2019-03-23 21:29:07 +08:00
crate::comp_add(&v.abs())
2018-09-21 01:54:12 +08:00
}
/// The l2-norm of `x - y`.
2018-10-08 22:56:58 +08:00
///
/// This is the same value as returned by [`length2`](fn.length2.html) and
/// [`magnitude2`](fn.magnitude2.html).
///
/// # See also:
///
/// * [`l1_distance`](fn.l1_distance.html)
/// * [`l1_norm`](fn.l1_norm.html)
/// * [`l2_norm`](fn.l2_norm.html)
/// * [`length`](fn.length.html)
/// * [`length2`](fn.length2.html)
/// * [`magnitude`](fn.magnitude.html)
/// * [`magnitude2`](fn.magnitude2.html)
2021-08-08 18:59:40 +08:00
pub fn l2_distance<T: RealNumber, const D: usize>(x: &TVec<T, D>, y: &TVec<T, D>) -> T {
2018-09-21 01:54:12 +08:00
l2_norm(&(y - x))
}
/// The l2-norm of `v`.
2018-10-08 22:56:58 +08:00
///
/// This is also known as the Euclidean norm.
///
/// This is the same value as returned by [`length`](fn.length.html) and
/// [`magnitude`](fn.magnitude.html).
///
/// # See also:
///
/// * [`l1_distance`](fn.l1_distance.html)
/// * [`l1_norm`](fn.l1_norm.html)
/// * [`l2_distance`](fn.l2_distance.html)
/// * [`length`](fn.length.html)
/// * [`length2`](fn.length2.html)
/// * [`magnitude`](fn.magnitude.html)
/// * [`magnitude2`](fn.magnitude2.html)
2021-08-08 18:59:40 +08:00
pub fn l2_norm<T: RealNumber, const D: usize>(x: &TVec<T, D>) -> T {
2018-09-21 01:54:12 +08:00
x.norm()
}
/// The squared magnitude of `x`.
///
/// A synonym for [`magnitude2`](fn.magnitude2.html).
///
/// # See also:
///
/// * [`distance`](fn.distance.html)
/// * [`distance2`](fn.distance2.html)
/// * [`length`](fn.length.html)
/// * [`magnitude`](fn.magnitude.html)
/// * [`magnitude2`](fn.magnitude2.html)
2021-08-08 18:59:40 +08:00
pub fn length2<T: RealNumber, const D: usize>(x: &TVec<T, D>) -> T {
2018-09-21 01:54:12 +08:00
x.norm_squared()
}
/// The squared magnitude of `x`.
///
/// A wrapper around [`nalgebra::norm_squared`](../nalgebra/fn.norm_squared.html).
///
/// # See also:
///
/// * [`distance`](fn.distance.html)
/// * [`distance2`](fn.distance2.html)
/// * [`length2`](fn.length2.html)
/// * [`magnitude`](fn.magnitude.html)
/// * [`nalgebra::norm_squared`](../nalgebra/fn.norm_squared.html)
2021-08-08 18:59:40 +08:00
pub fn magnitude2<T: RealNumber, const D: usize>(x: &TVec<T, D>) -> T {
x.norm_squared()
}
2021-08-08 18:59:40 +08:00
//pub fn lxNorm<T: RealNumber, const D: usize>(x: &TVec<T, D>, y: &TVec<T, D>, unsigned int Depth) -> T {
2018-09-21 01:54:12 +08:00
// unimplemented!()
//}
//
2021-08-08 18:59:40 +08:00
//pub fn lxNorm<T: RealNumber, const D: usize>(x: &TVec<T, D>, unsigned int Depth) -> T {
2018-09-21 01:54:12 +08:00
// unimplemented!()
//}