lucid-dl 2.7.7__tar.gz → 2.7.9__tar.gz

{lucid_dl-2.7.7/lucid_dl.egg-info → lucid_dl-2.7.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lucid-dl
-Version: 2.7.7
+Version: 2.7.9
 Summary: Lumerico's Comprehensive Interface for Deep Learning
 Home-page: https://github.com/ChanLumerico/lucid
 Author: ChanLumerico
@@ -30,10 +30,10 @@ Dynamic: summary
 
 ![PyPI - Version](https://img.shields.io/pypi/v/lucid-dl?color=red)
 ![PyPI - Downloads](https://img.shields.io/pypi/dm/lucid-dl.svg)
-![PyPI - Total Downloads](https://img.shields.io/badge/total%20downloads-32.0k-yellow.svg)
+![PyPI - Total Downloads](https://img.shields.io/badge/total%20downloads-33.2k-yellow.svg)
 ![GitHub code size in bytes](https://img.shields.io/github/languages/code-size/ChanLumerico/lucid.svg)
 ![Code Style](https://img.shields.io/badge/code%20style-black-000000.svg)
-![Lines of Code](https://img.shields.io/badge/lines%20of%20code-26.1k-purple.svg)
+![Lines of Code](https://img.shields.io/badge/lines%20of%20code-26.4k-purple.svg)
 
 **Lucid** is a minimalist deep learning framework built entirely from scratch in Python. It offers a pedagogically rich environment to explore the foundations of modern deep learning systems, including autodiff, neural network modules, and GPU acceleration — all while staying lightweight, readable, and free of complex dependencies.
 
@@ -46,6 +46,12 @@ Whether you're a student, educator, or an advanced researcher seeking to demysti
 
 - Now supports [**`Safetensors`**](https://github.com/huggingface/safetensors) for Lucid neural module porting along with the legacy `.lcd` format
 
+- Added multiple `nn` utilities:
+
+  - `nn.util.grad_norm` - Returns the global norm of the gradients
+  - `nn.util.clip_grad_norm` - Rescales the gradients based on the global norm
+  - `nn.util.clip_grad_value` - Rescales the gradients based on their values.
+
 - Implemented **EfficientDet**: `lucid.models.EfficientDet` with variants from `D0` to `D7`
 
 ## 🔧 How to Install

{lucid_dl-2.7.7 → lucid_dl-2.7.9}/README.md

@@ -2,10 +2,10 @@
 
 ![PyPI - Version](https://img.shields.io/pypi/v/lucid-dl?color=red)
 ![PyPI - Downloads](https://img.shields.io/pypi/dm/lucid-dl.svg)
-![PyPI - Total Downloads](https://img.shields.io/badge/total%20downloads-32.0k-yellow.svg)
+![PyPI - Total Downloads](https://img.shields.io/badge/total%20downloads-33.2k-yellow.svg)
 ![GitHub code size in bytes](https://img.shields.io/github/languages/code-size/ChanLumerico/lucid.svg)
 ![Code Style](https://img.shields.io/badge/code%20style-black-000000.svg)
-![Lines of Code](https://img.shields.io/badge/lines%20of%20code-26.1k-purple.svg)
+![Lines of Code](https://img.shields.io/badge/lines%20of%20code-26.4k-purple.svg)
 
 **Lucid** is a minimalist deep learning framework built entirely from scratch in Python. It offers a pedagogically rich environment to explore the foundations of modern deep learning systems, including autodiff, neural network modules, and GPU acceleration — all while staying lightweight, readable, and free of complex dependencies.
 
@@ -18,6 +18,12 @@ Whether you're a student, educator, or an advanced researcher seeking to demysti
 
 - Now supports [**`Safetensors`**](https://github.com/huggingface/safetensors) for Lucid neural module porting along with the legacy `.lcd` format
 
+- Added multiple `nn` utilities:
+
+  - `nn.util.grad_norm` - Returns the global norm of the gradients
+  - `nn.util.clip_grad_norm` - Rescales the gradients based on the global norm
+  - `nn.util.clip_grad_value` - Rescales the gradients based on their values.
+
 - Implemented **EfficientDet**: `lucid.models.EfficientDet` with variants from `D0` to `D7`
 
 ## 🔧 How to Install

{lucid_dl-2.7.7 → lucid_dl-2.7.9}/lucid/_tensor/tensor.py

@@ -397,28 +397,33 @@ class Tensor(_TensorBase):
         return hash(id(self))
 
     def __deepcopy__(self, *args: Any) -> Self:
+        cls = self.__class__
         copied_data = Tensor.copy_data(self.data)
 
-        new_tensor = Tensor(
-            copied_data,
-            requires_grad=self.requires_grad,
-            keep_grad=self.keep_grad,
-            dtype=self.dtype,
-            device=self.device,
-        )
+        if cls is Tensor:
+            new = Tensor(
+                copied_data, self.requires_grad, self.keep_grad, self.dtype, self.device
+            )
+        else:
+            base = Tensor(copied_data, dtype=self.dtype, device=self.device)
+            new = cls(base)
 
-        if self.grad is not None:
-            new_tensor.grad = Tensor.copy_grad(self.grad)
+        if self.grad is not None and (
+            self.keep_grad or getattr(new, "keep_grad", False)
+        ):
+            new.grad = Tensor.copy_grad(self.grad)
+        else:
+            new.grad = None
 
-        new_tensor._op = self._op
-        new_tensor._backward_op = self._backward_op
-        new_tensor._prev = self._prev.copy()
-        new_tensor._backward_hooks = self._backward_hooks.copy()
+        new._op = None
+        new._backward_op = _noop
+        new._prev = []
+        new._backward_hooks = []
 
-        new_tensor._is_free = self._is_free
-        new_tensor._is_bool_tensor = self._is_bool_tensor
+        new._is_free = self._is_free
+        new._is_bool_tensor = self._is_bool_tensor
 
-        return new_tensor
+        return new
 
     def __bool__(self) -> bool:
         if self.data.size != 1:

{lucid_dl-2.7.7 → lucid_dl-2.7.9}/lucid/optim/lr_scheduler/_schedulers.py

@@ -13,6 +13,7 @@ __all__ = [
     "CosineAnnealingLR",
     "ReduceLROnPlateau",
     "CyclicLR",
+    "NoamScheduler",
 ]
 
 
@@ -265,3 +266,36 @@ class CyclicLR(LRScheduler):
             for _ in self.base_lrs
         ]
         return new_lrs
+
+
+class NoamScheduler(LRScheduler):
+    def __init__(
+        self,
+        optimizer: Optimizer,
+        model_size: int,
+        warmup_steps: int,
+        factor: float = 1.0,
+        last_epoch: int = -1,
+        verbose: bool = False,
+    ) -> None:
+        if model_size <= 0:
+            raise ValueError("model_size must be a positive integer.")
+        if warmup_steps <= 0:
+            raise ValueError("warmup_steps must be a positive integer.")
+        if factor <= 0:
+            raise ValueError("factor must be a positive float.")
+
+        self.model_size = model_size
+        self.warmup_steps = warmup_steps
+        self.factor = factor
+        super().__init__(optimizer, last_epoch, verbose)
+
+    def get_lr(self) -> list[float]:
+        step_num = max(self.last_epoch, 1)
+        scale = self.factor * (self.model_size**-0.5)
+
+        warmup_term = step_num * (self.warmup_steps**-1.5)
+        decay_term = step_num**-0.5
+        lr_factor = scale * min(decay_term, warmup_term)
+
+        return [base_lr * lr_factor for base_lr in self.base_lrs]

{lucid_dl-2.7.7 → lucid_dl-2.7.9/lucid_dl.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lucid-dl
-Version: 2.7.7
+Version: 2.7.9
 Summary: Lumerico's Comprehensive Interface for Deep Learning
 Home-page: https://github.com/ChanLumerico/lucid
 Author: ChanLumerico
@@ -30,10 +30,10 @@ Dynamic: summary
 
 ![PyPI - Version](https://img.shields.io/pypi/v/lucid-dl?color=red)
 ![PyPI - Downloads](https://img.shields.io/pypi/dm/lucid-dl.svg)
-![PyPI - Total Downloads](https://img.shields.io/badge/total%20downloads-32.0k-yellow.svg)
+![PyPI - Total Downloads](https://img.shields.io/badge/total%20downloads-33.2k-yellow.svg)
 ![GitHub code size in bytes](https://img.shields.io/github/languages/code-size/ChanLumerico/lucid.svg)
 ![Code Style](https://img.shields.io/badge/code%20style-black-000000.svg)
-![Lines of Code](https://img.shields.io/badge/lines%20of%20code-26.1k-purple.svg)
+![Lines of Code](https://img.shields.io/badge/lines%20of%20code-26.4k-purple.svg)
 
 **Lucid** is a minimalist deep learning framework built entirely from scratch in Python. It offers a pedagogically rich environment to explore the foundations of modern deep learning systems, including autodiff, neural network modules, and GPU acceleration — all while staying lightweight, readable, and free of complex dependencies.
 
@@ -46,6 +46,12 @@ Whether you're a student, educator, or an advanced researcher seeking to demysti
 
 - Now supports [**`Safetensors`**](https://github.com/huggingface/safetensors) for Lucid neural module porting along with the legacy `.lcd` format
 
+- Added multiple `nn` utilities:
+
+  - `nn.util.grad_norm` - Returns the global norm of the gradients
+  - `nn.util.clip_grad_norm` - Rescales the gradients based on the global norm
+  - `nn.util.clip_grad_value` - Rescales the gradients based on their values.
+
 - Implemented **EfficientDet**: `lucid.models.EfficientDet` with variants from `D0` to `D7`
 
 ## 🔧 How to Install

{lucid_dl-2.7.7 → lucid_dl-2.7.9}/setup.py

@@ -5,7 +5,7 @@ with open("README.md", "r") as fh:
 
 setuptools.setup(
     name="lucid-dl",
-    version="2.7.7",
+    version="2.7.9",
     author="ChanLumerico",
     author_email="greensox284@gmail.com",
     description="Lumerico's Comprehensive Interface for Deep Learning",