Skip to main content

QuantizePerTensorBackwardPlan

Struct QuantizePerTensorBackwardPlan 

Source
pub struct QuantizePerTensorBackwardPlan<TIn: Element, TOut: IntElement> { /* private fields */ }
Expand description

quantize_per_tensor backward plan.

Straight-Through Estimator (STE): dx = (dy / scale) * 1[qmin ≤ round(x/scale)+zp ≤ qmax]. The in-range mask is recomputed in-kernel from the saved input x (no separate mask is saved on FW).

When to use: backward for QuantizePerTensorPlan. Caller must retain the original input x from the FW pass.

Dtypes: gradient dy and dx in input FP {f32, f64, f16, bf16}. TOut is the FW output int dtype, carried for SKU consistency only — BW kernel does not consume an int operand.

Shape limits: flat [numel].

Workspace: none.

Precision guarantee: deterministic, bit-stable. The 1/scale factor is mandatory (omitting it is the most common STE-grad bug).

Implementations§

Source§

impl<TIn: Element, TOut: IntElement> QuantizePerTensorBackwardPlan<TIn, TOut>

Source

pub fn select( _stream: &Stream, desc: &QuantizePerTensorBackwardDescriptor, _pref: PlanPreference, ) -> Result<Self>

Pick a kernel.

Source

pub fn can_implement( &self, args: &QuantizePerTensorBackwardArgs<'_, TIn, TOut>, ) -> Result<()>

Validate args.

Source

pub fn workspace_size(&self) -> usize

Workspace bytes.

Source

pub fn sku(&self) -> KernelSku

Identity.

Source

pub fn precision_guarantee(&self) -> PrecisionGuarantee

Numerical guarantees.

Source

pub fn run( &self, stream: &Stream, _workspace: Workspace<'_>, args: QuantizePerTensorBackwardArgs<'_, TIn, TOut>, ) -> Result<()>

Launch.

Auto Trait Implementations§

§

impl<TIn, TOut> Freeze for QuantizePerTensorBackwardPlan<TIn, TOut>

§

impl<TIn, TOut> RefUnwindSafe for QuantizePerTensorBackwardPlan<TIn, TOut>
where TIn: RefUnwindSafe, TOut: RefUnwindSafe,

§

impl<TIn, TOut> Send for QuantizePerTensorBackwardPlan<TIn, TOut>
where TIn: Send, TOut: Send,

§

impl<TIn, TOut> Sync for QuantizePerTensorBackwardPlan<TIn, TOut>
where TIn: Sync, TOut: Sync,

§

impl<TIn, TOut> Unpin for QuantizePerTensorBackwardPlan<TIn, TOut>
where TIn: Unpin, TOut: Unpin,

§

impl<TIn, TOut> UnsafeUnpin for QuantizePerTensorBackwardPlan<TIn, TOut>

§

impl<TIn, TOut> UnwindSafe for QuantizePerTensorBackwardPlan<TIn, TOut>
where TIn: UnwindSafe, TOut: UnwindSafe,

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
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, 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.