Skip to content

update: restructure according to MCODE#280

Merged
VsevolodX merged 10 commits intomainfrom
feature/SOF-7869
Mar 20, 2026
Merged

update: restructure according to MCODE#280
VsevolodX merged 10 commits intomainfrom
feature/SOF-7869

Conversation

@VsevolodX
Copy link
Member

@VsevolodX VsevolodX commented Mar 19, 2026

Summary by CodeRabbit

  • Documentation
    • Replaced hierarchical examples overview with a single flat table (M‑CODE, Category, Structure, Simulation, Reference) for clearer navigation.
    • Renamed and reorganized top-level sections and subsections (e.g., Pristine/Compound Pristine, Defective Structures) and standardized dimensionality/category labels with M‑CODE prefixes.
    • Removed the "Optimize" subsection from the contents and reformatted references as an anchored linear list.

@review-notebook-app
Copy link

Check out this pull request on  ReviewNB

See visual diffs & provide feedback on Jupyter Notebooks.


Powered by ReviewNB

@coderabbitai
Copy link

coderabbitai bot commented Mar 19, 2026

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

  • @coderabbitai resume to resume automatic reviews.
  • @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

  • ▶️ Resume reviews
  • 🔍 Trigger review
📝 Walkthrough

Walkthrough

Reworked two Jupyter notebook TOCs: converted a nested outline into a flat standardized table in specific_examples/Introduction.ipynb, and relabeled/reorganized the main Introduction.ipynb contents to use M-CODE prefixes and a Domain→Dimensionality→Category numbering. All changes are markdown-only.

Changes

Cohort / File(s) Summary
Specific Examples TOC -> Table
other/materials_designer/specific_examples/Introduction.ipynb
Replaced multi-level outline and “(to be added)” placeholders with a single flat markdown table. Added standardized columns (M‑CODE, Category, Structure, Simulation, Reference) and moved notebook links and references into table cells; removed old section headings and separators.
Main Introduction TOC edits & relabeling
other/materials_designer/Introduction.ipynb
Adjusted top-level section names and organization (e.g., Single-Material → Pristine Structures; Defects → Defective Structures), changed numbering to Domain→Dimensionality→Category, and standardized link titles with M‑CODE prefixes (P-, C-, D-, X-); removed the “Optimize” contents entry and reorganized subsections by dimensionality/category.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

  • update: pass material to BS #279 — Modifies the same notebook (other/materials_designer/specific_examples/Introduction.ipynb) and updates link/display text; strong overlap.

Suggested reviewers

  • timurbazhirov
  • pranabdas

Poem

🐰 I hopped through headings, nibbling clutter thin,
Tables now tidy where wild lists had been.
M‑CODE badges march in neat, labeled rows,
Links curled into cells where tidy order grows.
A joyful hop — the notebook softly glows.

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'update: restructure according to MCODE' directly reflects the main change: restructuring notebook documentation to use a new MCODE taxonomy classification system.
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.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feature/SOF-7869
📝 Coding Plan
  • Generate coding plan for human review comments

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

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

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🧹 Nitpick comments (1)
other/materials_designer/specific_examples/Introduction.ipynb (1)

17-17: Normalize placeholder capitalization (Line 17).

Use the same placeholder style as the rest of the table (*To be added*) for consistency.

Proposed consistency tweak
-| Pristine Structures | 2D | Slab | `P-2D-SLB-R` | — | Reconstructed slab; *to be added* |
+| Pristine Structures | 2D | Slab | `P-2D-SLB-R` | — | Reconstructed slab; *To be added* |
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@other/materials_designer/specific_examples/Introduction.ipynb` at line 17,
The table row string containing "| Pristine Structures | 2D | Slab |
`P-2D-SLB-R` | — | Reconstructed slab; *to be added* |" uses inconsistent
placeholder capitalization; update the placeholder to "*To be added*" to match
the rest of the table (modify the string in the notebook cell that contains the
quoted row).
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@other/materials_designer/specific_examples/Introduction.ipynb`:
- Line 41: Update the table row that contains the identifier `D-0D-INT` and the
link `defect_point_interstitial_tin_oxide.ipynb`: change the description text
from "O interstitial in SnO" to "O interstitial in SnO₂" so the chemical formula
matches the linked tin oxide example; ensure any displayed plain-text "SnO"
instances in that row are replaced with "SnO₂".

---

Nitpick comments:
In `@other/materials_designer/specific_examples/Introduction.ipynb`:
- Line 17: The table row string containing "| Pristine Structures | 2D | Slab |
`P-2D-SLB-R` | — | Reconstructed slab; *to be added* |" uses inconsistent
placeholder capitalization; update the placeholder to "*To be added*" to match
the rest of the table (modify the string in the notebook cell that contains the
quoted row).

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 892ce248-07cf-4a53-ae0f-b3503975f5dd

📥 Commits

Reviewing files that changed from the base of the PR and between 0f07bc2 and 0db506f.

📒 Files selected for processing (1)
  • other/materials_designer/specific_examples/Introduction.ipynb

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 3

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

Inline comments:
In `@other/materials_designer/Introduction.ipynb`:
- Around line 42-44: The subsection headings in Introduction.ipynb are out of
order: the entry "#### [2.1.3. Interface without strain matching `C-2D-INT-Z`]"
appears before "#### [2.1.2. Interface with ASE EMT Relaxation `C-2D-INT-Z`]"
which breaks monotonic numbering; reorder these two headings (swap the positions
of the "2.1.3" and "2.1.2" lines) so that "2.1.2. Interface with ASE EMT
Relaxation `C-2D-INT-Z`" comes before "2.1.3. Interface without strain matching
`C-2D-INT-Z`" to restore correct sequential ordering in the notebook navigation.
- Around line 65-67: The section heading "### 3.3. Planar" should use the
dimensionality label per the X.Y convention; change that heading to the
appropriate dimensional label (e.g., "### 3.3. 2D") and move the word "Planar"
into the child item titles/categories (for example update "#### [3.3.2. Grain
Boundary in a 2D Material `D-2D-GBP`]" to include "(Planar)" in its title and
likewise adjust any other child titles like "3.3.1. Grain Boundary in a 3D
Crystal `D-1D-GBL`" as needed) so that the parent heading is purely dimensional
and "Planar" appears at the item level.
- Around line 24-26: The section heading "1.3. 1D & ribbons" contradicts the
dimensionality of the listed notebooks (nanoribbons use M-CODE P-0D-NRB,
nanowires use P-1D-NWR); update the heading to accurately reflect mixed
dimensionalities (e.g., "1.3. 0D & 1D — Ribbons and Wires") or split into two
subsections so that create_nanoribbon.ipynb is clearly under a "Nanoribbons
(P-0D-NRB)" subsection and create_nanowire.ipynb under "Nanowires (P-1D-NWR)".
Ensure the M-CODE tokens P-0D-NRB and P-1D-NWR remain adjacent to their notebook
links to avoid future confusion.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 6986ae36-f63a-44e6-a6ff-5a8cddc23590

📥 Commits

Reviewing files that changed from the base of the PR and between 0db506f and 9332d4b.

📒 Files selected for processing (2)
  • other/materials_designer/Introduction.ipynb
  • other/materials_designer/specific_examples/Introduction.ipynb
🚧 Files skipped from review as they are similar to previous changes (1)
  • other/materials_designer/specific_examples/Introduction.ipynb

Comment on lines +42 to +44
"#### [2.1.3. Interface without strain matching `C-2D-INT-Z`](create_interface_with_no_strain_matching.ipynb)\n",
"\n",
"#### [2.1.2. Interface with ASE EMT Relaxation](create_interface_with_relaxation_ase_emt.ipynb)\n",
"#### [2.1.2. Interface with ASE EMT Relaxation `C-2D-INT-Z`](create_interface_with_relaxation_ase_emt.ipynb)\n",
Copy link

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

Fix subsection ordering in 2.1 for stable navigation.

Line 42 lists 2.1.3 before Line 44 2.1.2. Please reorder these so numbering is monotonic in display order.

Suggested edit
-#### [2.1.3. Interface without strain matching `C-2D-INT-Z`](create_interface_with_no_strain_matching.ipynb)
-
-#### [2.1.2. Interface with ASE EMT Relaxation `C-2D-INT-Z`](create_interface_with_relaxation_ase_emt.ipynb)
+#### [2.1.2. Interface with ASE EMT Relaxation `C-2D-INT-Z`](create_interface_with_relaxation_ase_emt.ipynb)
+
+#### [2.1.3. Interface without strain matching `C-2D-INT-Z`](create_interface_with_no_strain_matching.ipynb)
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@other/materials_designer/Introduction.ipynb` around lines 42 - 44, The
subsection headings in Introduction.ipynb are out of order: the entry "####
[2.1.3. Interface without strain matching `C-2D-INT-Z`]" appears before "####
[2.1.2. Interface with ASE EMT Relaxation `C-2D-INT-Z`]" which breaks monotonic
numbering; reorder these two headings (swap the positions of the "2.1.3" and
"2.1.2" lines) so that "2.1.2. Interface with ASE EMT Relaxation `C-2D-INT-Z`"
comes before "2.1.3. Interface without strain matching `C-2D-INT-Z`" to restore
correct sequential ordering in the notebook navigation.

@@ -7,132 +7,49 @@
"source": [
Copy link
Member

@timurbazhirov timurbazhirov Mar 20, 2026

Choose a reason for hiding this comment

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

Remove "Worked". Remove the first two columns, M-CODE already does the job. Add a column to indicate whether the notebook is a structure or simulation.


Reply via ReviewNB

Copy link
Member Author

Choose a reason for hiding this comment

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

Ok. Although I'd add the spelling out of what P, C, D and X mean so that it's clear for the first time viewers.

@@ -7,123 +7,51 @@
"source": [
Copy link
Member

@timurbazhirov timurbazhirov Mar 20, 2026

Choose a reason for hiding this comment

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

Let's add References


Reply via ReviewNB

@VsevolodX VsevolodX merged commit 3f13a53 into main Mar 20, 2026
5 checks passed
@VsevolodX VsevolodX deleted the feature/SOF-7869 branch March 20, 2026 04:21
This was referenced Mar 20, 2026
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.

2 participants