mlx_rs::optimizers

Struct AdamW

Source
pub struct AdamW {
    pub lr: Array,
    pub betas: (Array, Array),
    pub eps: Array,
    pub weight_decay: Array,
    pub state: State<(Array, Array)>,
}
Expand description

The AdamW optimizer [1].

Following the above convention, in contrast with [1], we do not use bias correction in the first and second moments for AdamW. We update the weights with a weightDecay lambda value:

[1]: Loshchilov, I. and Hutter, F., 2019. Decoupled weight decay regularization. ICLR 2019.

Fields§

§lr: Array

The learning rate.

§betas: (Array, Array)

The coefficients used for computing running averages of the gradient and its square.

Default to AdamW::DEFAULT_BETAS.

§eps: Array

The epsilon added to the denominator to improve numerical stability.

Default to AdamW::DEFAULT_EPS.

§weight_decay: Array

The weight decay

Default to AdamW::DEFAULT_WEIGHT_DECAY.

§state: State<(Array, Array)>

Inner state.

Implementations§

Source§

impl AdamW

Source

pub fn new(lr: impl Into<f32>) -> Self

Creates a new instance of AdamW.

Source§

impl AdamW

Source

pub const DEFAULT_BETAS: (f32, f32) = super::Adam::DEFAULT_BETAS

Default value for betas.

Source

pub const DEFAULT_EPS: f32 = 9.99999993E-9f32

Default value for eps.

Source

pub const DEFAULT_WEIGHT_DECAY: f32 = 0.00999999977f32

Default value for weight_decay.

Trait Implementations§

Source§

impl Buildable for AdamW

Source§

type Builder = AdamWBuilder

The builder type for this buildable type
Source§

impl Builder<AdamW> for AdamWBuilder

Source§

type Error = Infallible

Error with building
Source§

fn build(self) -> Result<AdamW, Self::Error>

Build the type
Source§

impl Clone for AdamW

Source§

fn clone(&self) -> AdamW

Returns a copy of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for AdamW

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Optimizer for AdamW

Source§

type State = HashMap<Rc<str>, (Array, Array)>

State of the optimizer.
Source§

fn state(&self) -> &Self::State

Get the state of the optimizer.
Source§

fn state_mut(&mut self) -> &mut Self::State

Get the mutable state of the optimizer.
Source§

fn update_single( &mut self, key: &Rc<str>, gradient: &Array, parameter: &mut Array, ) -> Result<(), Exception>

Update a single parameter with the given gradient. Read more
Source§

fn update<M>( &mut self, model: &mut M, gradients: impl Borrow<FlattenedModuleParam>, ) -> Result<()>

Apply the gradients to the parameters of the model and update the model with the new parameters.
Source§

impl Updatable for &mut AdamW

Source§

fn updatable_states(&self) -> impl IntoIterator<Item = &Array>

Returns a list of references to the updatable states. Read more
Source§

fn updatable_states_mut(&mut self) -> impl IntoIterator<Item = &mut Array>

Returns a list of mutable references to the updatable states. Read more
Source§

impl Updatable for AdamW

Source§

fn updatable_states(&self) -> impl IntoIterator<Item = &Array>

Returns a list of references to the updatable states. Read more
Source§

fn updatable_states_mut(&mut self) -> impl IntoIterator<Item = &mut Array>

Returns a list of mutable references to the updatable states. Read more

Auto Trait Implementations§

§

impl Freeze for AdamW

§

impl RefUnwindSafe for AdamW

§

impl !Send for AdamW

§

impl !Sync for AdamW

§

impl Unpin for AdamW

§

impl UnwindSafe for AdamW

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> CloneToUninit for T
where T: Clone,

Source§

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

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

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

Source§

fn __clone_box(&self, _: Private) -> *mut ()

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

impl<T> IntoOption<T> for T

Source§

fn into_option(self) -> Option<T>

Convert into an Option.
Source§

impl<T> IntoStrideBy for T

Source§

fn stride_by(self, stride: i32) -> StrideBy<T>

Create a stride indexing operation.
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.