Struct ParticleSearchQuery 

pub struct ParticleSearchQuery { /* private fields */ }

Builder for particle searches run by crate::Pdg::search_particles.

Filters are combined with logical AND.

Examples

use pdg_rs::{Charge, ParticleClass, ParticleSearchQuery, Pdg};

let query = ParticleSearchQuery::new()
    .class(ParticleClass::Meson)
    .charge(Charge::Neutral)
    .mass_range_mev(100.0, 1000.0);

let pdg = Pdg::open()?;
let particles = pdg.search_particles(query)?;
assert!(particles.iter().all(|particle| particle.charge == Charge::Neutral));

Implementations

impl ParticleSearchQuery

pub fn new() -> Self

Creates an empty particle search query.

pub fn name_contains(self, value: impl Into<String>) -> Self

Filters particles whose name contains value.

pub const fn class(self, particle_class: ParticleClass) -> Self

Filters particles by ParticleClass.

pub const fn particle_type(self, particle_type: ParticleType) -> Self

Filters particles by particle/antiparticle relation.

pub const fn charge(self, charge: Charge) -> Self

Filters particles by electric charge.

pub fn isospin(self, isospin: impl Into<Option<Isospin>>) -> Self

Filters particles by isospin.

Passing None requires the isospin value to be missing.

pub fn g_parity(self, g_parity: impl Into<Option<Parity>>) -> Self

Filters particles by G-parity.

Passing None requires the G-parity value to be missing.

pub fn angular_momentum( self, angular_momentum: impl Into<Option<AngularMomentum>>, ) -> Self

Filters particles by angular momentum.

Passing None requires the angular-momentum value to be missing.

pub fn parity(self, parity: impl Into<Option<Parity>>) -> Self

Filters particles by parity.

Passing None requires the parity value to be missing.

pub fn charge_conjugation( self, charge_conjugation: impl Into<Option<Parity>>, ) -> Self

Filters particles by charge-conjugation parity.

Passing None requires the charge-conjugation value to be missing.

pub const fn mass_range_mev(self, min: f64, max: f64) -> Self

Filters particles whose mass interval overlaps the given range in MeV.

pub const fn width_range_mev(self, min: f64, max: f64) -> Self

Filters particles whose width interval overlaps the given range in MeV.

pub const fn lifetime_range_seconds(self, min: f64, max: f64) -> Self

Filters particles whose lifetime interval overlaps the given range in seconds.

pub fn decays_to<I, S>(self, states: I) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

Filters particles by an exact outgoing decay state.

Use ParticleSearchQuery::decay_contains to allow additional outgoing products.

pub fn decay_contains<I, S>(self, states: I) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

Filters particles by outgoing decay products contained in a decay state.

pub fn decays_from<I, S>(self, states: I) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

Filters particles by incoming decay products.

pub const fn decay_state_expansion(self, expansion: DecayStateExpansion) -> Self

Sets decay-state expansion behavior.

Trait Implementations

impl Clone for ParticleSearchQuery

fn clone(&self) -> ParticleSearchQuery

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ParticleSearchQuery

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

Formats the value using the given formatter.

impl Default for ParticleSearchQuery

fn default() -> ParticleSearchQuery

Returns the “default value” for a type.