pykeres 1.0.0__tar.gz

pykeres-1.0.0/PKG-INFO

@@ -0,0 +1,128 @@
+Metadata-Version: 2.4
+Name: pykeres
+Version: 1.0.0
+Summary: pykeres: Deep Learning Practicals Code Guide Library with Cell-by-Cell Notebook Implementations and Viva Cheat Sheets
+Author-email: Shreyas Daptare <shreyas@example.com>
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# keres
+
+A weirdly named, ultra-handy Python code guide library containing cell-by-cell implementations of Deep Learning Lab Practicals (Roll No. 23 - Shreyas Daptare).
+
+Inspired by the `MLExamples` cheat-sheet pattern in `seaborne`, `keres` stores Jupyter notebooks converted into structured, cell-by-cell plaintext that can be browsed interactively, printed, extracted, or exported back into standalone Python scripts or Jupyter Notebooks.
+
+---
+
+## Installation
+
+Install in development/editable mode:
+
+```bash
+cd keres
+pip install -e .
+```
+
+Or direct pip install:
+
+```bash
+pip install ./keres
+```
+
+---
+
+## Python API Usage
+
+### Built-in Interactive Guide & Cheat Sheet
+```python
+import keres
+
+# Open built-in interactive guide
+keres.guide()   # or keres.help()
+
+# View quick tweak recipes for exams/viva:
+keres.tweaks(2)  # Swapping FashionMNIST with Pandas local CSV, Adam to SGD, Dropout
+keres.tweaks(7)  # MobileNetV2 -> ResNet/EfficientNet, 10x smaller fine-tuning lr rule
+```
+
+### Direct Module Access (Quickest)
+```python
+import keres
+
+# List all available practicals
+keres.list_practicals()
+
+# Print practicals cell-by-cell
+keres.practical_1()
+keres.practical_2(tweaks=True) # Full code + viva tweak recipes appended
+keres.mock_practical()
+
+# Inspect a single cell (1-based index)
+keres.practical_1(cell=1)  # View Cell 1 only (AND Gate Perceptron)
+keres.practical_1(cell=2)  # View Cell 2 only (OR Gate Perceptron)
+```
+
+### Class-based Access (`Keres`)
+```python
+from keres import Keres
+
+guide = Keres()
+
+# Programmatic retrieval
+code_str = guide.get_practical(num=3)
+cells = guide.get_cells(num=3)
+for c in cells:
+    print(f"Cell {c['cell_number']}: {c['title']}")
+
+# Exporting utilities
+guide.export_all_texts("./my_txt_notes")
+guide.export_script(num=1, output_path="run_practical_1.py")
+guide.export_notebook(num=1, output_path="practical_1.ipynb")
+```
+
+---
+
+## CLI Usage
+
+`keres` provides an intuitive command-line interface:
+
+```bash
+# Display built-in guide & cheat sheet
+keres guide     # or simply run: keres
+
+# List all practicals
+keres list
+
+# Display a practical cell-by-cell
+keres show 1
+keres show 2 --tweaks
+
+# Display a specific cell only
+keres show 1 --cell 2
+
+# View only the quick tweak recipe (Pandas CSV, Optimizers, Viva notes)
+keres tweaks 2
+
+# Export all practicals as text files
+keres export --out-dir ./my_txt_notes
+```
+
+---
+
+## Practical Index
+
+| Practical | Title / Topic | Framework | Cells |
+| :--- | :--- | :--- | :---: |
+| **Mock Practical** | Neural Network Training with Different Loss Functions | PyTorch | 5 |
+| **Practical 01** | Single-Layer Perceptron (AND & OR Gate Decision Boundaries) | NumPy / Matplotlib | 2 |
+| **Practical 02** | Multi-Layer Perceptron (MLP) Comparison on Fashion-MNIST | PyTorch / Torchvision | 8 |
+| **Practical 03** | Regularization Techniques (L2 Weight Decay vs Dropout) | TensorFlow / Keras | 6 |
+| **Practical 04** | Activation Functions Analysis (Sigmoid, Tanh, ReLU, LeakyReLU) | PyTorch | 5 |
+| **Practical 05** | Convolutional Neural Networks (CNN) vs MLP for Image Classification | PyTorch / Torchvision | 10 |
+| **Practical 06** | Recurrent Neural Networks (LSTM) for IMDB Sentiment Classification | TensorFlow / Keras | 6 |
+| **Practical 07** | Transfer Learning & Fine-Tuning with MobileNetV2 | TensorFlow / Keras | 6 |
+| **Practical 08** | Hyperparameter Optimization & TensorBoard Visualization | PyTorch / TensorBoard | 5 |

pykeres-1.0.0/README.md

@@ -0,0 +1,116 @@
+# keres
+
+A weirdly named, ultra-handy Python code guide library containing cell-by-cell implementations of Deep Learning Lab Practicals (Roll No. 23 - Shreyas Daptare).
+
+Inspired by the `MLExamples` cheat-sheet pattern in `seaborne`, `keres` stores Jupyter notebooks converted into structured, cell-by-cell plaintext that can be browsed interactively, printed, extracted, or exported back into standalone Python scripts or Jupyter Notebooks.
+
+---
+
+## Installation
+
+Install in development/editable mode:
+
+```bash
+cd keres
+pip install -e .
+```
+
+Or direct pip install:
+
+```bash
+pip install ./keres
+```
+
+---
+
+## Python API Usage
+
+### Built-in Interactive Guide & Cheat Sheet
+```python
+import keres
+
+# Open built-in interactive guide
+keres.guide()   # or keres.help()
+
+# View quick tweak recipes for exams/viva:
+keres.tweaks(2)  # Swapping FashionMNIST with Pandas local CSV, Adam to SGD, Dropout
+keres.tweaks(7)  # MobileNetV2 -> ResNet/EfficientNet, 10x smaller fine-tuning lr rule
+```
+
+### Direct Module Access (Quickest)
+```python
+import keres
+
+# List all available practicals
+keres.list_practicals()
+
+# Print practicals cell-by-cell
+keres.practical_1()
+keres.practical_2(tweaks=True) # Full code + viva tweak recipes appended
+keres.mock_practical()
+
+# Inspect a single cell (1-based index)
+keres.practical_1(cell=1)  # View Cell 1 only (AND Gate Perceptron)
+keres.practical_1(cell=2)  # View Cell 2 only (OR Gate Perceptron)
+```
+
+### Class-based Access (`Keres`)
+```python
+from keres import Keres
+
+guide = Keres()
+
+# Programmatic retrieval
+code_str = guide.get_practical(num=3)
+cells = guide.get_cells(num=3)
+for c in cells:
+    print(f"Cell {c['cell_number']}: {c['title']}")
+
+# Exporting utilities
+guide.export_all_texts("./my_txt_notes")
+guide.export_script(num=1, output_path="run_practical_1.py")
+guide.export_notebook(num=1, output_path="practical_1.ipynb")
+```
+
+---
+
+## CLI Usage
+
+`keres` provides an intuitive command-line interface:
+
+```bash
+# Display built-in guide & cheat sheet
+keres guide     # or simply run: keres
+
+# List all practicals
+keres list
+
+# Display a practical cell-by-cell
+keres show 1
+keres show 2 --tweaks
+
+# Display a specific cell only
+keres show 1 --cell 2
+
+# View only the quick tweak recipe (Pandas CSV, Optimizers, Viva notes)
+keres tweaks 2
+
+# Export all practicals as text files
+keres export --out-dir ./my_txt_notes
+```
+
+---
+
+## Practical Index
+
+| Practical | Title / Topic | Framework | Cells |
+| :--- | :--- | :--- | :---: |
+| **Mock Practical** | Neural Network Training with Different Loss Functions | PyTorch | 5 |
+| **Practical 01** | Single-Layer Perceptron (AND & OR Gate Decision Boundaries) | NumPy / Matplotlib | 2 |
+| **Practical 02** | Multi-Layer Perceptron (MLP) Comparison on Fashion-MNIST | PyTorch / Torchvision | 8 |
+| **Practical 03** | Regularization Techniques (L2 Weight Decay vs Dropout) | TensorFlow / Keras | 6 |
+| **Practical 04** | Activation Functions Analysis (Sigmoid, Tanh, ReLU, LeakyReLU) | PyTorch | 5 |
+| **Practical 05** | Convolutional Neural Networks (CNN) vs MLP for Image Classification | PyTorch / Torchvision | 10 |
+| **Practical 06** | Recurrent Neural Networks (LSTM) for IMDB Sentiment Classification | TensorFlow / Keras | 6 |
+| **Practical 07** | Transfer Learning & Fine-Tuning with MobileNetV2 | TensorFlow / Keras | 6 |
+| **Practical 08** | Hyperparameter Optimization & TensorBoard Visualization | PyTorch / TensorBoard | 5 |

pykeres-1.0.0/pyproject.toml

@@ -0,0 +1,29 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pykeres"
+version = "1.0.0"
+authors = [
+  { name="Shreyas Daptare", email="shreyas@example.com" },
+]
+description = "pykeres: Deep Learning Practicals Code Guide Library with Cell-by-Cell Notebook Implementations and Viva Cheat Sheets"
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+
+[project.scripts]
+keres = "keres.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["keres*"]
+
+[tool.setuptools.package-data]
+keres = ["data/*"]

pykeres-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

pykeres-1.0.0/setup.py

@@ -0,0 +1,15 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="pykeres",
+    version="1.0.0",
+    package_dir={"": "src"},
+    packages=find_packages(where="src"),
+    package_data={"keres": ["data/*"]},
+    include_package_data=True,
+    entry_points={
+        "console_scripts": [
+            "keres=keres.cli:main",
+        ],
+    },
+)

pykeres-1.0.0/src/keres/__init__.py

@@ -0,0 +1,100 @@
+"""
+keres: A cell-by-cell Deep Learning Practicals Code Guide Library.
+"""
+
+from .guide import Keres, DLPracticals
+
+# Default instance for convenient top-level access
+_default_instance = Keres()
+
+def list_practicals():
+    """List all available practicals."""
+    _default_instance.list_practicals()
+
+def mock_practical(cell=None, tweaks=False):
+    """View Mock Practical cell-by-cell or with tweak recipes."""
+    _default_instance.mock_practical(cell=cell, tweaks=tweaks)
+
+def practical_1(cell=None, tweaks=False):
+    """View Practical 01 (Perceptron AND/OR) cell-by-cell or with tweak recipes."""
+    _default_instance.practical_1(cell=cell, tweaks=tweaks)
+
+def practical_2(cell=None, tweaks=False):
+    """View Practical 02 (MLP on Fashion-MNIST) cell-by-cell or with tweak recipes."""
+    _default_instance.practical_2(cell=cell, tweaks=tweaks)
+
+def practical_3(cell=None, tweaks=False):
+    """View Practical 03 (L2 vs Dropout Regularization) cell-by-cell or with tweak recipes."""
+    _default_instance.practical_3(cell=cell, tweaks=tweaks)
+
+def practical_4(cell=None, tweaks=False):
+    """View Practical 04 (Activation Functions Analysis) cell-by-cell or with tweak recipes."""
+    _default_instance.practical_4(cell=cell, tweaks=tweaks)
+
+def practical_5(cell=None, tweaks=False):
+    """View Practical 05 (CNN vs MLP on Images) cell-by-cell or with tweak recipes."""
+    _default_instance.practical_5(cell=cell, tweaks=tweaks)
+
+def practical_6(cell=None, tweaks=False):
+    """View Practical 06 (LSTM for IMDB Sentiment) cell-by-cell or with tweak recipes."""
+    _default_instance.practical_6(cell=cell, tweaks=tweaks)
+
+def practical_7(cell=None, tweaks=False):
+    """View Practical 07 (Transfer Learning with MobileNetV2) cell-by-cell or with tweak recipes."""
+    _default_instance.practical_7(cell=cell, tweaks=tweaks)
+
+def practical_8(cell=None, tweaks=False):
+    """View Practical 08 (Hyperparameter Tuning & TensorBoard) cell-by-cell or with tweak recipes."""
+    _default_instance.practical_8(cell=cell, tweaks=tweaks)
+
+def get_practical(num, cell=None, tweaks=False):
+    """Retrieve practical text, specific cell code, or code with tweak recipes."""
+    return _default_instance.get_practical(num, cell=cell, tweaks=tweaks)
+
+def tweaks(num):
+    """View quick tweak recipes (dataset switching, optimizers, viva notes) for a practical."""
+    _default_instance.tweaks(num)
+
+def get_tweaks(num):
+    """Retrieve quick tweak recipe string for a practical."""
+    return _default_instance.get_tweaks(num)
+
+def guide():
+    """Display the built-in quickstart guide and cheat sheet."""
+    _default_instance.guide()
+
+help = guide
+quickstart = guide
+
+def export_all_texts(output_dir):
+    """Export all practicals as plaintext files (.txt) to output_dir."""
+    _default_instance.export_all_texts(output_dir)
+
+def get_cells(num):
+    """Retrieve list of cell dicts for a practical."""
+    return _default_instance.get_cells(num)
+
+__all__ = [
+    "Keres",
+    "DLPracticals",
+    "list_practicals",
+    "guide",
+    "help",
+    "quickstart",
+    "mock_practical",
+    "practical_1",
+    "practical_2",
+    "practical_3",
+    "practical_4",
+    "practical_5",
+    "practical_6",
+    "practical_7",
+    "practical_8",
+    "get_practical",
+    "get_cells",
+    "tweaks",
+    "get_tweaks",
+    "export_all_texts",
+]
+
+__version__ = "1.0.0"

pykeres-1.0.0/src/keres/cli.py

@@ -0,0 +1,64 @@
+"""
+Command-line interface for keres.
+"""
+
+import argparse
+import sys
+from keres.guide import Keres
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog="keres",
+        description="keres: Deep Learning Practicals Code Guide CLI (Roll No. 23 - Shreyas Daptare)"
+    )
+    subparsers = parser.add_subparsers(dest="command", help="Command to run")
+
+    # guide / help
+    subparsers.add_parser("guide", help="Show built-in quickstart guide and cheat sheet")
+    subparsers.add_parser("help", help="Show built-in quickstart guide and cheat sheet")
+
+    # list
+    subparsers.add_parser("list", help="List all available practicals")
+
+    # show
+    show_parser = subparsers.add_parser("show", help="Display practical code cell-by-cell")
+    show_parser.add_argument("number", help="Practical number (0 for Mock, 1..8 for Practicals 1..8)")
+    show_parser.add_argument("--cell", type=int, default=None, help="Specific cell number (1-based)")
+    show_parser.add_argument("--tweaks", "-t", action="store_true", help="Include quick tweak recipes at the end")
+
+    # tweaks
+    tweaks_parser = subparsers.add_parser("tweaks", help="Display quick tweak recipes (dataset, optimizer, viva)")
+    tweaks_parser.add_argument("number", help="Practical number (0 for Mock, 1..8 for Practicals 1..8)")
+
+    # export
+    export_parser = subparsers.add_parser("export", help="Export practicals to a directory")
+    export_parser.add_argument("--out", "--out-dir", "-o", dest="out", default="./keres_practicals_txt", help="Output directory")
+
+    args = parser.parse_args()
+    guide = Keres()
+
+    if args.command in ("guide", "help") or args.command is None:
+        guide.guide()
+    elif args.command == "list":
+        guide.list_practicals()
+    elif args.command == "show":
+        try:
+            guide._display_or_return(args.number, cell=args.cell, tweaks=args.tweaks)
+        except Exception as e:
+            print(f"Error: {e}", file=sys.stderr)
+            sys.exit(1)
+    elif args.command == "tweaks":
+        try:
+            guide.tweaks(args.number)
+        except Exception as e:
+            print(f"Error: {e}", file=sys.stderr)
+            sys.exit(1)
+    elif args.command == "export":
+        guide.export_all_texts(args.out)
+    else:
+        parser.print_help()
+
+
+if __name__ == "__main__":
+    main()

pykeres-1.0.0/src/keres/data/__init__.py

@@ -0,0 +1 @@
+# keres data package

pykeres-1.0.0/src/keres/data/mock_practical.txt

@@ -0,0 +1,220 @@
+================================================================================
+# Mock Practical: Neural Network Training with Different Loss Functions
+# Library: keres | Framework: PyTorch | Total Cells: 5
+================================================================================
+
+
+# --------------------------------------------------------------------------------
+# [CELL 1 / 5] : Imports & Environment Setup
+# --------------------------------------------------------------------------------
+import random
+import numpy as np
+import matplotlib.pyplot as plt
+import torch
+import torch.nn as nn
+from torch.utils.data import TensorDataset, DataLoader
+from sklearn.datasets import load_digits
+from sklearn.model_selection import train_test_split
+from sklearn.preprocessing import StandardScaler
+
+
+# --------------------------------------------------------------------------------
+# [CELL 2 / 5] : Random Seed & Reproducibility Setup
+# --------------------------------------------------------------------------------
+SEED = 42
+torch.manual_seed(SEED)
+np.random.seed(SEED)
+random.seed(SEED)
+
+
+# --------------------------------------------------------------------------------
+# [CELL 3 / 5] : Synthetic Dataset Generation (Binary Classification)
+# --------------------------------------------------------------------------------
+# Dataset
+digits = load_digits()
+X = digits.data.astype(np.float32)
+y = digits.target
+
+X_train, X_val, y_train, y_val = train_test_split(
+    X, y, test_size=0.20, stratify=y, random_state=SEED
+)
+
+scaler = StandardScaler()
+X_train = scaler.fit_transform(X_train).astype(np.float32)
+X_val = scaler.transform(X_val).astype(np.float32)
+
+train_loader = DataLoader(
+    TensorDataset(torch.tensor(X_train), torch.tensor(y_train)),
+    batch_size=64, shuffle=True
+)
+val_loader = DataLoader(
+    TensorDataset(torch.tensor(X_val), torch.tensor(y_val)),
+    batch_size=256
+)
+
+
+# --------------------------------------------------------------------------------
+# [CELL 4 / 5] : MLP Architecture, Training Loop & Loss Function Experiments
+# --------------------------------------------------------------------------------
+# Same MLP architecture for all experiments
+class MLP(nn.Module):
+    def __init__(self, activation):
+        super().__init__()
+        self.net = nn.Sequential(
+            nn.Linear(64, 128), activation(),
+            nn.Linear(128, 128), activation(),
+            nn.Linear(128, 64), activation(),
+            nn.Linear(64, 10)
+        )
+
+    def forward(self, x):
+        return self.net(x)
+
+activations = {
+    "Sigmoid": nn.Sigmoid,
+    "Tanh": nn.Tanh,
+    "ReLU": nn.ReLU
+}
+
+criterion = nn.CrossEntropyLoss()
+results = {}
+
+for name, activation in activations.items():
+    torch.manual_seed(SEED)
+    model = MLP(activation)
+    optimizer = torch.optim.Adam(model.parameters(), lr=0.01)
+
+    losses, accuracies, gradients = [], [], []
+
+    print(f"\nTraining with {name}")
+
+    for epoch in range(5):
+        model.train()
+        total_loss = 0
+        batch_gradients = []
+
+        for xb, yb in train_loader:
+            optimizer.zero_grad()
+
+            output = model(xb)
+            loss = criterion(output, yb)
+            loss.backward()
+
+            # Global L2 gradient norm
+            sq_norm = sum(
+                p.grad.detach().pow(2).sum().item()
+                for p in model.parameters()
+                if p.grad is not None
+            )
+            batch_gradients.append(np.sqrt(sq_norm))
+
+            optimizer.step()
+            total_loss += loss.item() * len(yb)
+
+        epoch_loss = total_loss / len(X_train)
+
+        model.eval()
+        correct = total = 0
+        with torch.no_grad():
+            for xb, yb in val_loader:
+                pred = model(xb).argmax(dim=1)
+                correct += (pred == yb).sum().item()
+                total += len(yb)
+
+        accuracy = 100 * correct / total
+        gradient = np.mean(batch_gradients)
+
+        losses.append(epoch_loss)
+        accuracies.append(accuracy)
+        gradients.append(gradient)
+
+        print(
+            f"Epoch {epoch+1}: "
+            f"Loss={epoch_loss:.4f}, "
+            f"Val Acc={accuracy:.2f}%"
+        )
+
+    results[name] = {
+        "loss": losses,
+        "accuracy": accuracies,
+        "gradient": gradients
+    }
+
+
+# --------------------------------------------------------------------------------
+# [CELL 5 / 5] : Comparative Loss & Accuracy Curve Visualization
+# --------------------------------------------------------------------------------
+# Plot results
+epochs = np.arange(1, 6)
+fig, axes = plt.subplots(1, 3, figsize=(13, 4.5))
+
+for name in activations:
+    axes[0].plot(epochs, results[name]["loss"], marker="o", label=name)
+    axes[1].plot(epochs, results[name]["accuracy"], marker="o", label=name)
+    axes[2].plot(epochs, results[name]["gradient"], marker="o", label=name)
+
+axes[0].set_title("Training Loss")
+axes[0].set_xlabel("Epoch")
+axes[0].set_ylabel("Loss")
+
+axes[1].set_title("Validation Accuracy")
+axes[1].set_xlabel("Epoch")
+axes[1].set_ylabel("Accuracy (%)")
+
+axes[2].set_title("Gradient Norms (Flow)")
+axes[2].set_xlabel("Epoch")
+axes[2].set_ylabel("Average Gradient Norm")
+
+for ax in axes:
+    ax.set_xticks(epochs)
+    ax.grid(alpha=0.2)
+    ax.legend()
+
+plt.tight_layout()
+plt.savefig("activation_functions_output.png", dpi=180)
+plt.show()
+
+================================================================================
+💡 QUICK TWEAK RECIPES FOR MOCK PRACTICAL (Multi-Loss MLP in PyTorch):
+================================================================================
+1. SWITCH TO LOCAL CSV VIA PANDAS:
+   import pandas as pd
+   from sklearn.model_selection import train_test_split
+   from sklearn.preprocessing import StandardScaler
+   df = pd.read_csv('your_dataset.csv')
+   X_raw = df.drop('target', axis=1).values
+   y_raw = df['target'].values
+   X_tr, X_te, y_tr, y_te = train_test_split(X_raw, y_raw, test_size=0.2, random_state=42)
+   scaler = StandardScaler()
+   X_train = torch.tensor(scaler.fit_transform(X_tr), dtype=torch.float32)
+   X_test = torch.tensor(scaler.transform(X_te), dtype=torch.float32)
+   y_train = torch.tensor(y_tr, dtype=torch.long)
+   y_test = torch.tensor(y_te, dtype=torch.long)
+
+2. SWITCH OPTIMIZERS:
+   # Adam (Default):
+   optimizer = torch.optim.Adam(model.parameters(), lr=0.01)
+   # SGD with Momentum:
+   optimizer = torch.optim.SGD(model.parameters(), lr=0.01, momentum=0.9)
+   # RMSprop:
+   optimizer = torch.optim.RMSprop(model.parameters(), lr=0.005)
+   # AdamW (Adam + decoupled Weight Decay):
+   optimizer = torch.optim.AdamW(model.parameters(), lr=0.01, weight_decay=1e-4)
+
+3. SWITCH LOSS FUNCTIONS:
+   # Multi-class Classification:
+   criterion = nn.CrossEntropyLoss()
+   # Regression / Continuous:
+   criterion = nn.MSELoss()  # or nn.L1Loss()
+   # Robust Regression (less sensitive to outliers):
+   criterion = nn.SmoothL1Loss(beta=1.0)
+   # Binary Classification:
+   criterion = nn.BCEWithLogitsLoss()
+
+4. ADD DROPOUT & BATCH NORMALIZATION:
+   # Inside SimpleMLP __init__:
+   self.fc1 = nn.Linear(input_dim, 64)
+   self.bn1 = nn.BatchNorm1d(64)
+   self.dropout = nn.Dropout(0.3)
+   self.fc2 = nn.Linear(64, num_classes)
+================================================================================