Skip to content

Docs: formation energy beside the band structure in the graphene defect tutorial - #407

Merged
VsevolodX merged 2 commits into
mainfrom
feature/SOF-8063
Oct 8, 2026
Merged

VsevolodX merged 2 commits into
mainfrom
feature/SOF-8063

Conversation

@VsevolodX

@VsevolodX VsevolodX commented Sep 19, 2026 •

Copy link
Copy Markdown
Member

Rewrites the graphene substitutional-defect simulation tutorial so it covers the formation
energy
alongside the band structure it already documented, and corrects two things that were
wrong on the page.

SOF-8063. Notebook side: mat3ra/api-examples#372.

The page keeps its ten sections, their order and its URL — it is the page every other Specific
Example page is diffed against, so only the content changes. It is the same length it was.

  • §4.1 "Run profiles" is gone. The notebook no longer has a RUN_PROFILE debug/production
    toggle; the section now documents the RELAX switch and quotes the real parameter cell verbatim.
  • §4.2 said "Pseudopotentials: Norm-conserving (ONCV)". That was never true on the platform —
    there is no norm-conserving LDA set published for C or N, only GBRV ultrasoft. The page now says
    so and names it as the one deviation from the manuscript's method.
  • §6 "Expected results" compared no number. It promised qualitative features. It now carries
    E_f against Fujimoto & Saito Table I's 2.51 eV at 15 % tolerance, with both offsets named — solid
    N₂ standing in for the free molecule, GBRV ultrasoft for Troullier–Martins — and the total
    magnetic moment against 0.89 μB as a manual read of the job's pw_scf.out, which the notebook
    deliberately does not parse. The band-structure comparison figure stays.
  • §8 Troubleshooting gains the renamed materials: an uploads folder still holding
    N-doped Graphene now fails the load, because the structure notebook saves
    graphene 4x4 and graphene 4x4 N3V pyridinic (C28N3).
  • The structure page's save section covers both materials, and the nav label in mkdocs.yml and
    mkdocs-guide.yml becomes "(Formation Energy and Band Structure)". The filename does not move.

mkdocs build is clean on both sites, with no warning naming either page.

🤖 Generated with Claude Code

VsevolodX and others added 2 commits September 18, 2026 20:32
…SE pages

Rewrites the simulation tutorial in place, keeping its ten-section list, file
name and URL. The run-profile subsection goes, replaced by the RELAX switch;
the pseudopotential line is corrected from norm-conserving ONCV to GBRV
ultrasoft, which is the only LDA set the platform publishes for C and N and the
one deviation from the manuscript's method. Expected results now compares the
formation energy with Table I's 2.51 eV at 15 %, names the 0.89 uB moment as a
manual pw_scf.out check, and keeps the band-structure comparison figure. The
measured values wait on the live run and are marked TODO(live run).

The structure page's save section covers both materials the notebook now saves,
and the nav label in mkdocs.yml and mkdocs-guide.yml names both properties.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@netlify

netlify Bot commented Sep 19, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for mat3ra-documentation ready!

Name Link
🔨 Latest commit 626ccd3
🔍 Latest deploy log https://app.netlify.com/projects/mat3ra-documentation/deploys/6aae2afc68754f0008447187
😎 Deploy Preview https://deploy-preview-407--mat3ra-documentation.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

@VsevolodX
VsevolodX merged commit 0080b3a into main Oct 8, 2026
6 checks passed
@VsevolodX
VsevolodX deleted the feature/SOF-8063 branch October 8, 2026 03:04
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