Skip to content

fix: update README to reflect SVD decomposition in all sections#88

Merged
niuqohn2510 merged 6 commits into
devfrom
docs/readme
Apr 30, 2026
Merged

fix: update README to reflect SVD decomposition in all sections#88
niuqohn2510 merged 6 commits into
devfrom
docs/readme

Conversation

@aFlyingSeal

@aFlyingSeal aFlyingSeal commented Apr 20, 2026

Copy link
Copy Markdown
Collaborator

Linked issue

Closes #85

What this PR does

  • Updated README to reflect SVD decomposition instead of QR decomposition.

Summary by CodeRabbit

  • Documentation
    • Replaced QR decomposition content with SVD across overview, table of contents, and Part 2 descriptions.
    • Updated tutorial and video narrative to focus on SVD concepts and applications (compression, image processing, PCA/LSA); narration now uses Google Text-to-Speech.
    • Reorganized Part 2 media/scene layout and adjusted rendering instructions; reshaped report structure from sections to chapters.
    • Updated team responsibility notes to reflect SVD deliverables.

@coderabbitai

coderabbitai Bot commented Apr 20, 2026

Copy link
Copy Markdown
Contributor

Warning

Rate limit exceeded

@aFlyingSeal has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 45 minutes and 21 seconds before requesting another review.

To keep reviews running without waiting, you can enable usage-based add-on for your organization. This allows additional reviews beyond the hourly cap. Account admins can enable it under billing.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: a5c4000e-df0d-4e57-b0c4-628cd6407192

📥 Commits

Reviewing files that changed from the base of the PR and between 7312221 and c8a9154.

📒 Files selected for processing (1)
  • README.md
📝 Walkthrough

Walkthrough

Replaced QR decomposition references with Singular Value Decomposition (SVD) across README; renamed Part 2 API to svd_decompose(A) (A = UΣVᵀ); retargeted Manim scenes and narration to SVD-focused topics (compression/PCA/LSA); reorganized part2/ and report/ layout and LaTeX assets; updated Vietnamese text and team deliverables.

Changes

Cohort / File(s) Summary
README (English & Vietnamese)
README.md
Replaced "QR decomposition" with "Singular Value Decomposition (SVD)"; renamed Part 2 API qr_decompose(A)svd_decompose(A) and updated A = UΣVᵀ description; updated Manim scene table, application narratives, narration asset paths, and team responsibility text.
Part 2 — Manim scenes & assets
part2/manim/..., part2/manim-prod-assets/..., part2/manim/demo_video.mp4
Introduced part2/manim/ and part2/manim-prod-assets/ layout; changed referenced demo video path and scene entrypoints; updated rendering commands and scene/module names to SVD-focused setup.
Report layout & LaTeX
report/..., report/chapters/..., report/latex/...
Reworked report tree from sections/chapters/; added/updated LaTeX class/build configuration and styling files to reflect new folder structure.
Docs metadata / TOC / status tables
README.md (TOC, Part 2 status table)
Updated Table of Contents and Part 2 status/topic tables to reference SVD, new scene list, and updated progress/status entries.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

🐰 I hopped through lines and made a swap,
U, Σ, Vᵀ now lead the map,
Scenes hum SVD, images compress,
Narration tuned and docs redress,
🥕✨

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly and concisely summarizes the main change: updating README to reflect SVD decomposition across all sections.
Linked Issues check ✅ Passed The PR addresses all four acceptance criteria: replacing QR with SVD references, updating project structure, mirroring Vietnamese section changes, and updating Manim scene table.
Out of Scope Changes check ✅ Passed All changes are directly related to updating README documentation for SVD decomposition; no unrelated modifications detected.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share
Review rate limit: 0/1 reviews remaining, refill in 45 minutes and 21 seconds.

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (2)
README.md (2)

145-145: ⚠️ Potential issue | 🟡 Minor

Replace remaining QR references in Part 3 with SVD for consistency.

Line 145 and Line 245 still describe a QR solver, but the benchmark code uses svd_decompose (part3/benchmark.py). These lines are now stale and conflict with the README’s SVD migration.

Suggested patch
-Present only if activated during Sprint 3 planning. Compares Gaussian elimination, QR solver, and Gauss-Seidel across matrix sizes n ∈ {50, 100, 200, 500, 1000}. Includes log-log plots and stability analysis on Hilbert matrices vs random SPD matrices. See `part3/analysis.ipynb`.
+Present only if activated during Sprint 3 planning. Compares Gaussian elimination, SVD-based solver, and Gauss-Seidel across matrix sizes n ∈ {50, 100, 200, 500, 1000}. Includes log-log plots and stability analysis on Hilbert matrices vs random SPD matrices. See `part3/analysis.ipynb`.
-So sánh các phương pháp giải Ax = b: Gauss, QR, Gauss-Seidel. Thực nghiệm với n ∈ {50, 100, 200, 500, 1000}. Đồ thị log-log, phân tích ma trận Hilbert. Chỉ thực hiện nếu có đủ thời gian sau Phần 1 và 2.
+So sánh các phương pháp giải Ax = b: Gauss, SVD, Gauss-Seidel. Thực nghiệm với n ∈ {50, 100, 200, 500, 1000}. Đồ thị log-log, phân tích ma trận Hilbert. Chỉ thực hiện nếu có đủ thời gian sau Phần 1 và 2.

Also applies to: 245-245

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` at line 145, Update the README to replace the stale "QR solver"
references in Part 3 with "SVD" to match the implementation; specifically change
the description mentioning "QR solver" at the sentence that compares solvers
(currently referencing Gaussian elimination, QR solver, and Gauss-Seidel) so it
reads "SVD solver" (or "SVD-based solver") and similarly replace the other
occurrence at line ~245; ensure the text aligns with the actual benchmark
function name svd_decompose in part3/benchmark.py and any mentions of QR in the
stability/plot descriptions are updated to SVD.

165-168: ⚠️ Potential issue | 🟠 Major

Update Manim scene commands to actual scene class names in part2.

The README commands at lines 165-168 reference QRDecompositionScene, DiagonalizationScene, and LeastSquaresScene, which don't exist in part2/manim_scene.py. These should be replaced with the actual SVD scene classes: SVDIntro, SVDComparisionScene, and SVDApplicationScene. Users following the README will encounter runtime errors.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` around lines 165 - 168, The README's manim command examples
reference non-existent scene classes (QRDecompositionScene,
DiagonalizationScene, LeastSquaresScene); update those commands to the actual
scene class names defined in part2 (SVDIntro, SVDComparisionScene,
SVDApplicationScene) so users run manim with the correct classes (replace each
old class token with its corresponding SVD* class in the command examples).
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@README.md`:
- Line 14: The TOC entry uses the wrong fragment
"#part-2--qr-decomposition--manim-video" which doesn't match the actual heading
"Part 2 — SVD Decomposition + Manim Video"; update the TOC link to the correct
anchor that matches the heading slug (e.g.
"#part-2--svd-decomposition--manim-video") so the link navigates to the "Part 2
— SVD Decomposition + Manim Video" section.

---

Outside diff comments:
In `@README.md`:
- Line 145: Update the README to replace the stale "QR solver" references in
Part 3 with "SVD" to match the implementation; specifically change the
description mentioning "QR solver" at the sentence that compares solvers
(currently referencing Gaussian elimination, QR solver, and Gauss-Seidel) so it
reads "SVD solver" (or "SVD-based solver") and similarly replace the other
occurrence at line ~245; ensure the text aligns with the actual benchmark
function name svd_decompose in part3/benchmark.py and any mentions of QR in the
stability/plot descriptions are updated to SVD.
- Around line 165-168: The README's manim command examples reference
non-existent scene classes (QRDecompositionScene, DiagonalizationScene,
LeastSquaresScene); update those commands to the actual scene class names
defined in part2 (SVDIntro, SVDComparisionScene, SVDApplicationScene) so users
run manim with the correct classes (replace each old class token with its
corresponding SVD* class in the command examples).
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: d5813a2f-68fe-4f6c-8174-ba5e4fa3465c

📥 Commits

Reviewing files that changed from the base of the PR and between 6436e76 and f619089.

📒 Files selected for processing (1)
  • README.md

Comment thread README.md Outdated
@aFlyingSeal aFlyingSeal requested a review from TanKhoiTV April 20, 2026 02:17

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@README.md`:
- Line 258: The README has inconsistent method names for Part 3 between English
and Vietnamese (one lists SVD while the other lists QR); pick the canonical set
of solvers you want to present (e.g., Gauss, QR, Gauss-Seidel or Gauss, SVD,
Gauss-Seidel) and make both language sections match: update the English phrasing
that references "QR" and the Vietnamese phrasing that references "SVD" so they
list the same three methods (refer to the Part 3 header and the phrases "SVD",
"QR", "Gauss", "Gauss-Seidel" to locate the text) and ensure the experiment
description (n values and Hilbert matrix note) remains identical in both
languages.
- Around line 52-61: The README's project tree lists separate scene files under
part2/manim/scene_*.py (e.g., scene_intro.py, scene_svd.py, scene_compare.py,
scene_app.py) but the repository actually contains a single
part2/manim_scene.py; update the README.md to reflect the real layout (either
replace the part2/manim/scene_*.py entries with part2/manim_scene.py and its
actual assets, or rename/split the code into the listed scene_*.py files) so the
documented filenames (scene_intro.py, scene_svd.py, scene_compare.py,
scene_app.py, theme.py, manim.cfg, demo_video.mp4) match the repository.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 82ea2090-6b0e-4238-993a-6f7b3b727cef

📥 Commits

Reviewing files that changed from the base of the PR and between 99adf41 and 7312221.

📒 Files selected for processing (1)
  • README.md

Comment thread README.md
Comment thread README.md
@aFlyingSeal aFlyingSeal requested a review from niuqohn2510 April 30, 2026 15:52

@niuqohn2510 niuqohn2510 left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review done

@niuqohn2510 niuqohn2510 merged commit 04ea5a2 into dev Apr 30, 2026
2 checks passed
@niuqohn2510 niuqohn2510 deleted the docs/readme branch April 30, 2026 15:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: update README.md

2 participants