Struct PyPDF 

pub struct PyPDF { /* private fields */ }

Python wrapper for the neopdf::pdf::PDF struct.

This class provides a Python-friendly interface to the core PDF interpolation functionalities of the neopdf Rust library.

Implementations

impl PyPDF

pub fn new(pdf_name: &str, member: usize) -> Self

Creates a new PDF instance for a given PDF set and member.

This is the primary constructor for the PDF class.

Parameters

pdf_name : str The name of the PDF set. member : int The ID of the PDF member to load. Defaults to 0.

Returns

PDF A new PDF instance.

pub fn mkpdf(pdf_name: &str, member: usize) -> Self

Loads a given member of the PDF set.

This is an alternative constructor for convenience, equivalent to PDF(pdf_name, member).

Parameters

pdf_name : str The name of the PDF set. member : int The ID of the PDF member. Defaults to 0.

Returns

PDF A new PDF instance.

pub fn mkpdf_lhaid(lhaid: u32) -> Self

Loads a PDF member by its LHAPDF ID (LHAID).

The set name and member index are resolved by fetching the LHAPDF set index from https://lhapdfsets.web.cern.ch/current/pdfsets.index.

Parameters

lhaid : int The LHAPDF ID uniquely identifying both the PDF set and the member.

Returns

PDF A new PDF instance for the set and member encoded in lhaid.

pub fn mkpdf_lhapdf_file(path: &str) -> Self

Loads a PDF member from a specific LHAPDF .dat file path.

Parameters

path : str The path to the LHAPDF .dat file.

Returns

PDF A new PDF instance for the specified file.

pub fn mkpdfs(pdf_name: &str, method: &PyLoaderMethod) -> Vec<Self>

Loads all members of the PDF set.

This function loads all available members for a given PDF set, returning a list of PDF instances.

Parameters

pdf_name : str The name of the PDF set.

Returns

listPDF A list of PDF instances, one for each member.

pub fn mkpdfs_lazy(pdf_name: &str) -> PyLazyPDFs

Creates an iterator that loads PDF members lazily.

This function is suitable for .neopdf.lz4 files, which support lazy loading. It returns an iterator that yields PDF instances on demand, which is useful for reducing memory consumption when working with large PDF sets.

Arguments

• pdf_name - The name of the PDF set (must end with .neopdf.lz4).

Returns

An iterator over Result<PDF, Box<dyn std::error::Error>>.

pub fn pids(&self) -> Vec<i32>

Returns the list of PID values.

Returns

list[int] The PID values.

pub fn subgrids(&self) -> Vec<PySubGrid>

Returns the list of Subgrid objects.

Returns

list[PySubgrid] The subgrids.

pub fn subgrid_knots( &self, param: &PyGridParams, subgrid_index: usize, ) -> Vec<f64>

Returns the subgrid knots of a parameter for a given subgrid index.

The parameter could be the nucleon numbers A, the strong coupling alphas, the momentum fraction x, or the momentum scale Q2.

Panics

This panics if the parameter is not valid.

Returns

list[float] The subgrid knots for a given parameter.

pub fn set_force_positive(&mut self, option: PyForcePositive)

Clip the negative or small values for the PDF object.

Parameters

id : PyFrocePositive The clipping method use to handle negative or small values.

pub fn set_force_positive_members( pdfs: Vec<PyRefMut<'_, Self>>, option: PyForcePositive, )

Clip the negative or small values for all the PDF objects.

Parameters

pdfs : listPDF A list of PDF instances. option : PyForcePositive The clipping method use to handle negative or small values.

pub fn is_force_positive(&self) -> PyForcePositive

Returns the clipping method used for a single PDF object.

Returns

PyForcePositive The clipping method used for the PDF object.

pub fn x_min(&self) -> f64

Retrieves the minimum x-value for this PDF set.

Returns

float The minimum x-value.

pub fn x_max(&self) -> f64

Retrieves the maximum x-value for this PDF set.

Returns

float The maximum x-value.

pub fn q2_min(&self) -> f64

Retrieves the minimum Q2-value for this PDF set.

Returns

float The minimum Q2-value.

pub fn q2_max(&self) -> f64

Retrieves the maximum Q2-value for this PDF set.

Returns

float The maximum Q2-value.

pub fn flavour_pids(&self) -> Vec<i32>

Retrieves the flavour PIDs for the PDF set.

Returns

list(int) The flavour PID values.

pub fn xfxq2(&self, id: i32, x: f64, q2: f64) -> f64

Interpolates the PDF value (xf) for a given flavor, x, and Q2.

Parameters

id : int The flavor ID (e.g., 21 for gluon, 1 for d-quark). x : float The momentum fraction. q2 : float The energy scale squared.

Returns

float The interpolated PDF value. Returns 0.0 if extrapolation is attempted and not allowed.

pub fn xfxq2_nd(&self, id: i32, params: Vec<f64>) -> f64

Interpolates the PDF value (xf) for a given set of parameters.

Parameters

id : int The flavor ID (e.g., 21 for gluon, 1 for d-quark). params: list[float] A list of parameters that the grids depends on. If the PDF grid only contains x and Q2 dependence then its value is [x, q2]; if it contains either the A and alpha_s dependence, then its value is [A, x, q2] or [alpha_s, x, q2] respectively; if it contains both, then [A, alpha_s, x, q2].

Returns

float The interpolated PDF value. Returns 0.0 if extrapolation is attempted and not allowed.

pub fn xfxq2_allpids<'py>( &self, pids: Vec<i32>, x: f64, q2: f64, py: Python<'py>, ) -> Bound<'py, PyArray1<f64>>

Evaluates all requested flavors at a single kinematic point.

Parameters

pids : list[int] A list of flavor IDs. x : float The momentum fraction. q2 : float The energy scale squared.

Returns

numpy.ndarray A 1D NumPy array containing the interpolated PDF values for each PID.

pub fn xfxq2_allpids_nd<'py>( &self, pids: Vec<i32>, params: Vec<f64>, py: Python<'py>, ) -> Bound<'py, PyArray1<f64>>

Evaluates all requested flavors at a single kinematic point.

Parameters

pids : list[int] A list of flavor IDs. params : list[float] A list of parameters (e.g., [kT, x, q2]).

Returns

numpy.ndarray A 1D NumPy array containing the interpolated PDF values for each PID.

pub fn xfxq2_cheby_batch(&self, id: i32, params: Vec<Vec<f64>>) -> Vec<f64>

Interpolates the PDF value (xf) for a list containg a set of parameters.

Parameters

id : int The flavor ID (e.g., 21 for gluon, 1 for d-quark). params: list[list[float]] A list containing the list of points. Each element in the list is in turn a list containing the parameters that the grids depends on. If the PDF grid only contains x and Q2 dependence then its value is [x, q2]; if it contains either the A and alpha_s dependence, then its value is [A, x, q2] or [alpha_s, x, q2] respectively; if it contains both, then [A, alpha_s, x, q2].

Returns

float The interpolated PDF value. Returns 0.0 if extrapolation is attempted and not allowed.

pub fn xfxq2s<'py>( &self, pids: Vec<i32>, xs: Vec<f64>, q2s: Vec<f64>, py: Python<'py>, ) -> Bound<'py, PyArray2<f64>>

Interpolates the PDF value (xf) for lists of flavors, x-values, and Q2-values.

Parameters

id : list[int] A list of flavor IDs. xs : list[float] A list of momentum fractions. q2s : list[float] A list of energy scales squared.

Returns

numpy.ndarray A 2D NumPy array containing the interpolated PDF values.

pub fn alphas_q2(&self, q2: f64) -> f64

Computes the alpha_s value at a given Q2.

Parameters

q2 : float The energy scale squared.

Returns

float The interpolated alpha_s value.

pub fn metadata(&self) -> PyMetaData

Returns the metadata associated with this PDF set.

Provides access to the metadata describing the PDF set, including information such as the set description, number of members, parameter ranges, and other relevant details.

Returns

MetaData The metadata for this PDF set as a MetaData Python object.

Trait Implementations

impl<'py> IntoPyObject<'py> for PyPDF

type Target = PyPDF

The Python output type

type Output = Bound<'py, <PyPDF as IntoPyObject<'py>>::Target>

The smart pointer type to use.

type Error = PyErr

The type returned in the event of a conversion error.

fn into_pyobject( self, py: Python<'py>, ) -> Result<<Self as IntoPyObject<'_>>::Output, <Self as IntoPyObject<'_>>::Error>

Performs the conversion.

impl PyClass for PyPDF

type Frozen = False

Whether the pyclass is frozen.

impl PyClassImpl for PyPDF

const IS_BASETYPE: bool = false

#[pyclass(subclass)]

const IS_SUBCLASS: bool = false

#[pyclass(extends=…)]

const IS_MAPPING: bool = false

#[pyclass(mapping)]

const IS_SEQUENCE: bool = false

#[pyclass(sequence)]

const IS_IMMUTABLE_TYPE: bool = false

#[pyclass(immutable_type)]

const RAW_DOC: &'static CStr = /// Python wrapper for the `neopdf::pdf::PDF` struct. /// /// This class provides a Python-friendly interface to the core PDF /// interpolation functionalities of the `neopdf` Rust library.

Docstring for the class provided on the struct or enum.

const DOC: &'static CStr

Fully rendered class doc, including the text_signature if a constructor is defined.

type BaseType = PyAny

Base class

type ThreadChecker = SendablePyClass<PyPDF>

This handles following two situations:

type PyClassMutability = <<PyAny as PyClassBaseType>::PyClassMutability as PyClassMutability>::MutableChild

Immutable or mutable

type Dict = PyClassDummySlot

Specify this class has #[pyclass(dict)] or not.

type WeakRef = PyClassDummySlot

Specify this class has #[pyclass(weakref)] or not.

type BaseNativeType = PyAny

The closest native ancestor. This is PyAny by default, and when you declare #[pyclass(extends=PyDict)], it’s PyDict.

fn items_iter() -> PyClassItemsIter

fn lazy_type_object() -> &'static LazyTypeObject<Self>

fn dict_offset() -> Option<isize>

fn weaklist_offset() -> Option<isize>

impl PyClassNewTextSignature for PyPDF

const TEXT_SIGNATURE: &'static str = "(pdf_name, member=0)"

impl PyMethods<PyPDF> for PyClassImplCollector<PyPDF>

fn py_methods(self) -> &'static PyClassItems

impl PyTypeInfo for PyPDF

const NAME: &'static str = "PDF"

Class name.

const MODULE: Option<&'static str> = ::core::option::Option::None

Module name, if any.

fn type_object_raw(py: Python<'_>) -> *mut PyTypeObject

Returns the PyTypeObject instance for this type.

fn type_object(py: Python<'_>) -> Bound<'_, PyType>

Returns the safe abstraction over the type object.

fn is_type_of(object: &Bound<'_, PyAny>) -> bool

Checks if object is an instance of this type or a subclass of this type.

fn is_exact_type_of(object: &Bound<'_, PyAny>) -> bool

Checks if object is an instance of this type.

impl DerefToPyAny for PyPDF

impl ExtractPyClassWithClone for PyPDF