Nanotube Generation

SkillDev tools

Nanotubes are formed by rolling a 2D sheet into a cylinder defined by chiral indices (n, m). The chirality determines electronic and mechanical properties.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Nanotube Generation skill

About this capability

Use when the user asks to build a nanotube, roll up a 2D sheet into a tube, create a carbon nanotube (CNT), boron nitride nanotube (BNNT), or specify chiral indices (n, m).

What this skill tells your AI

The instructions your AI receives, as published by hello-qm/catgo-lrg in server/catgo/workflow/skills/structure/nanotube/SKILL.md and read by ahel’s review.

Overview

Nanotubes are formed by rolling a 2D sheet into a cylinder defined by chiral indices (n, m). The chirality determines electronic and mechanical properties.

Common applications:

  • Carbon nanotubes (CNTs): electronics, composites, catalysis
  • Boron nitride nanotubes (BNNTs): high-temperature insulation, radiation shielding
  • MoS2 / WS2 nanotubes: lubricants, batteries, photocatalysis
  • Custom 2D roll-ups: any 2D material loaded in the viewer

Chirality Quick Reference

TypeConditionElectronic Character (CNT)
Armchairn = mMetallic
Zigzagm = 0Metallic if n mod 3 = 0, else semiconducting
Chiraln != m, m != 0Metallic if (n - m) mod 3 = 0, else semiconducting

MCP Tools

catgo_nanotube_info -- Query geometry before building

{"tool": "catgo_nanotube_info", "arguments": {
  "n": 10, "m": 0,
  "bond_length": 1.42
}}

Returns diameter, circumference, chiral angle, translational vector length, and estimated atom count without building the structure. Use this to check size before committing to a build.

catgo_nanotube_build -- Build the nanotube

{"tool": "catgo_nanotube_build", "arguments": {
  "n": 10, "m": 0,
  "length": 20.0,
  "bond_length": 1.42
}}
ParameterDescriptionDefault
n, mChiral indices(required)
lengthTube length in Angstromsone translational period
bond_lengthC-C bond length in Angstroms1.42

The tool accepts either a loaded 2D structure from the viewer or explicit lattice vectors / basis coordinates. For carbon nanotubes, the default graphene sheet is used automatically.

Router: /nanotube/info (POST), /nanotube/build (POST)

Complete Workflow: (10,0) Zigzag CNT Relaxation

Step 1: Check nanotube geometry

{"tool": "catgo_nanotube_info", "arguments": {
  "n": 10, "m": 0
}}

Verify the diameter (~7.8 A) and atom count are reasonable for DFT.

Step 2: Build the nanotube

{"tool": "catgo_nanotube_build", "arguments": {
  "n": 10, "m": 0,
  "length": 12.5
}}

Step 3: Verify in viewer

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

Check: cylindrical geometry, no overlapping atoms, correct atom count.

Step 4: Relax with DFT

{"tool": "catgo_workflow_engine", "arguments": {
  "action": "create", "params": {"name": "(10,0) CNT relaxation"}
}}
{"tool": "catgo_workflow_engine", "arguments": {
  "action": "add_task", "params": {
    "workflow_id": "<wf_id>",
    "task_type": "geo_opt",
    "params": {"software": "vasp", "ENCUT": 520, "ISPIN": 1,
               "system_name": "CNT-10-0 relax"}
  }
}}

Multi-walled Nanotubes (MWNT)

The backend supports multi-walled nanotubes via additional walls. Each wall is defined by its own chiral indices. The inter-wall spacing defaults to ~3.4 A (van der Waals distance for graphitic layers).

Non-Carbon Nanotubes

To build a BN nanotube or MoS2 nanotube:

  1. Fetch or load the 2D monolayer structure (e.g., hexagonal BN)
  2. The nanotube builder rolls up whatever 2D structure is loaded
{"tool": "catgo_fetch", "arguments": {
  "action": "crystal", "formula": "BN", "source": "mc3d"
}}

Then build the nanotube from the loaded structure.

Common Pitfalls

  1. Large chiral indices (n > 30) produce structures with thousands of atoms. Check atom count with catgo_nanotube_info before building.
  2. The tube length should be at least one translational period for meaningful periodic calculations.
  3. For DFT on nanotubes, ensure sufficient vacuum in the non-periodic directions (at least 12-15 A between periodic images).
  4. Bond length 1.42 A is for graphene/CNT. Use 1.45 A for BN, 2.42 A for MoS2.
  5. Semiconducting CNTs require careful k-point sampling along the tube axis. Use at least 1x1x8 k-points for a single unit cell.

Signals

GitHub stars
196
Forks
23
Last commit
Sep 2026

Others that do the same job

Advanced
Catalog kind
skill
Gateway key
nanotube-generation
Source
github.com/hello-qm/catgo-lrg