Skip to content

Hello-QM/catgo-LRG / .claude/skills/structure-heterostructure

heterostructure

Verified

Use when the user asks to build a heterostructure, interface, van der Waals stack, substrate-film system, or lattice-matched bilayer from two different materials.

Heterostructure Assembly

Overview

A heterostructure is a layered stack of two different materials joined at an interface. The Zur-McGill (ZSL) algorithm finds superlattice matches that minimize lattice mismatch between substrate and film.

Common applications:

  • Catalysis: oxide support + metal film (TiO2/Pt, Al2O3/Pd)
  • Electronics: semiconductor junctions (GaAs/AlAs, Si/Ge)
  • 2D vdW stacks: graphene/hBN, MoS2/WSe2
  • Energy: electrode/electrolyte interfaces for batteries
  • Photocatalysis: type-II heterojunctions for charge separation

MCP Tools

catgo_hetero_search -- Find lattice-matched superlattices

{"tool": "catgo_hetero_search", "arguments": {
  "substrate": {"<pymatgen structure dict>": "..."},
  "film": {"<pymatgen structure dict>": "..."},
  "params": {
    "substrate_miller": [0, 0, 1],
    "film_miller": [0, 0, 1],
    "max_area": 400,
    "max_area_ratio_tol": 0.09,
    "max_length_tol": 0.09,
    "max_angle_tol": 0.09,
    "max_results": 20,
    "mode": "bulk"
  }
}}

Returns matches sorted by area, with available terminations for each match.

ParameterDescriptionDefault
substrateSubstrate structure dict(required)
filmFilm structure dict(required)
substrate_millerSubstrate surface orientation[0,0,1]
film_millerFilm surface orientation[0,0,1]
max_areaMaximum supercell area (A^2)400
max_area_ratio_tolArea ratio tolerance0.09
max_length_tolLength mismatch tolerance0.09
max_angle_tolAngle mismatch tolerance0.09
max_resultsMax number of matches to return20
mode"bulk" or "slab" input mode"bulk"

catgo_hetero_build -- Build the interface

{"tool": "catgo_hetero_build", "arguments": {
  "substrate": {"<pymatgen structure dict>": "..."},
  "film": {"<pymatgen structure dict>": "..."},
  "match": {"match_id": 0},
  "termination_index": 0,
  "params": {
    "gap": 2.0,
    "vacuum": 20.0,
    "substrate_thickness": 10.0,
    "film_thickness": 10.0,
    "twist_angle": 0.0
  }
}}
ParameterDescriptionDefault
matchMatch from search results (match_id)(required)
termination_indexWhich termination to use0
gapInterface gap in Angstroms2.0
vacuumVacuum above the slab in Angstroms20.0
substrate_thicknessSubstrate slab thickness10.0
film_thicknessFilm slab thickness10.0
twist_angleIn-plane rotation of the film0.0

catgo_hetero_build_intermat -- One-step build (JARVIS pipeline)

An alternative builder that does search + build in one step using the intermat/JARVIS method. Useful when you want a quick result without separately inspecting matches.

{"tool": "catgo_hetero_build_intermat", "arguments": {
  "substrate": {"<pymatgen structure dict>": "..."},
  "film": {"<pymatgen structure dict>": "..."},
  "params": {
    "substrate_miller": [0, 0, 1],
    "film_miller": [0, 0, 1],
    "separation": 3.0,
    "vacuum": 25.0
  }
}}

Router: /heterostructure/search (POST), /heterostructure/build (POST), /heterostructure/build-intermat (POST), and more

Additional endpoints: /batch-build, /build-manual, /search-lateral, /build-lateral, /grid-scan.

Complete Workflow: TiO2/Pt Interface

Step 1: Fetch both materials

{"tool": "catgo_fetch", "arguments": {
  "action": "crystal", "formula": "TiO2", "source": "mp"
}}

Save this structure, then fetch the second:

{"tool": "catgo_fetch", "arguments": {
  "action": "crystal", "formula": "Pt", "source": "mp"
}}

Step 2: Search for lattice matches

{"tool": "catgo_hetero_search", "arguments": {
  "substrate": "<TiO2 structure>",
  "film": "<Pt structure>",
  "params": {
    "substrate_miller": [1, 1, 0],
    "film_miller": [1, 1, 1],
    "max_area": 200
  }
}}

Review the returned matches. Each lists:

  • Superlattice area
  • Strain (length and angle mismatch)
  • Available terminations (e.g., O-terminated vs Ti-terminated)

Step 3: Build the interface

Select the best match (smallest area with acceptable strain):

{"tool": "catgo_hetero_build", "arguments": {
  "substrate": "<TiO2 structure>",
  "film": "<Pt structure>",
  "match": {"match_id": 0},
  "termination_index": 0,
  "params": {
    "gap": 2.5,
    "vacuum": 20.0,
    "substrate_thickness": 12.0,
    "film_thickness": 10.0
  }
}}

Step 4: Verify

{"tool": "catgo_view", "arguments": {"action": "get_state"}}

Check: correct interface geometry, appropriate vacuum, no overlapping atoms at the interface.

Step 5: Relax the interface

{"tool": "catgo_workflow_engine", "arguments": {
  "action": "create", "params": {"name": "TiO2-Pt interface relax"}
}}
{"tool": "catgo_workflow_engine", "arguments": {
  "action": "add_task", "params": {
    "workflow_id": "<wf_id>",
    "task_type": "geo_opt",
    "params": {"software": "vasp", "ENCUT": 520,
               "system_name": "TiO2-Pt interface"}
  }
}}

Tolerance Guidelines

Mismatch LevelTolerance ValuesUse Case
Tight0.03Epitaxial growth, accurate interfaces
Standard0.09General screening, most applications
Loose0.15Exploratory, when few matches found

Tighter tolerances produce fewer but higher-quality matches. Loosen tolerances if no matches are found, or increase max_area.

Common Pitfalls

  1. Both substrate and film must be bulk crystals (not slabs). The builder cuts slabs internally based on the Miller indices you specify.
  2. Large max_area values (> 500 A^2) can produce structures with thousands of atoms. Start small and increase if needed.
  3. The gap parameter controls the initial interface distance before relaxation. Too small (< 1.5 A) causes atomic overlap; too large (> 4 A) may not capture interface bonding.
  4. Always relax the interface with DFT. The as-built structure has ideal geometry that does not reflect real interface reconstruction.
  5. For oxide/metal interfaces, use DFT+U on the oxide side. The metal does not need U corrections.
  6. Van der Waals corrections (DFT-D3) are important for weakly bonded interfaces (2D/2D stacks, vdW heterostructures).
  7. Strain from lattice mismatch is applied to the film by default. For large mismatches (> 5%), the film may be significantly distorted. Consider if this is physically reasonable.
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 197kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall