vibe-sketcherDocumentation

Coated and disordered CNT fibre composites

The composite builder places a bounded bundle of carbon nanotubes in a periodic cell and grows polymer chains around it, as a coating shell or as a matrix. The result is an unrelaxed representative model: a representative volume element (RVE) of a fibre, not the macroscopic fibre. Experimental dimensions such as fibre diameters, coating thicknesses and tube lengths are recorded as labelled metadata beside the model and are never built. No electrical, mechanical or biological property is inferred from the model.

A composite is reproducible. The same request and seed give the same model. It is previewed as a derived periodic model with its tubes, chains, composition, checks and refusals before anything is stored. An applied composite can be undone while it is unchanged.

The request

Field

Meaning

identifier

ID of the derived periodic model.

tube

One nanotube that every bundle member copies (see below).

bundle

How many tubes and how they are placed.

cell

The cell policy: a periodic matrix or a coated_fibre section.

polymer

Repeat units and one chain specification, as in the polymer packer.

composition

Exactly one of chains, target_density_g_cm3 or polymer_weight_fraction.

seed

The seed for the tube placement and the polymer growth.

macroscopic

Labelled experimental dimensions: quantity, value, unit (nm, um, mm, cm, m), optional spread, source and note.

references

Source DOIs.

label

A description of the model.

Tubes

tube takes the chiral indices n and m (with m <= n) of the innermost wall and optional concentric outer_walls. Concentric walls must be 0.30 to 0.40 nm apart. A periodic tube (the default) is the periodic nanotube cell of the solid-state builder and runs through the cell along c, the fibre axis; c is then periods translation periods of the innermost wall, and the walls must be commensurate (all armchair or all zigzag). A segment tube is the finite, hydrogen-terminated tube of the nanostructure builder, periods periods long. Segments need the cell length cell.length_angstrom.

Bundles

bundle.count is between 1 and 61. gap_angstrom (default 3.4 angstrom, of the order of the graphite interlayer spacing) is the intertube atom-centre separation.

hexagonal

The tube axes sit on a triangular lattice of pitch 2 R + gap, where R is the outer-wall radius. The count lattice points closest to the centre are taken, so incomplete shells are allowed. All tubes are identical and parallel.

random

Each axis is drawn uniformly in a disc of radius_angstrom about the bundle axis, with a uniform rotation about its own axis and, for periodic tubes, a uniform axial shift. Segments may also tilt from c by up to max_tilt_deg (at most 30). A draw closer than the gap to an earlier tube, or with an atom inside another tube, is rejected; past max_attempts the request is refused with composite.disorder_exhausted. A periodic tube runs along c and cannot tilt, so tilt with periodic tubes is refused (composite.tilt_periodic).

Cells

matrix

A fully periodic orthorhombic box with edges lateral_angstrom [a, b] and the bundle at its centre. The polymer fills the space between the tubes and their periodic images. The bundle with the gap must fit inside a and b (composite.cell_too_small).

coated_fibre

Periodic along c only. A cylindrical coating shell of coating_thickness_angstrom surrounds the bundle envelope (the largest radial atom distance from the bundle axis), with vacuum_angstrom outside. With infiltrate false (the default) the chains stay outside the envelope; with infiltrate true they may enter the spaces between tubes.

Composition

chains gives the chain count directly. target_density_g_cm3 sets it from the composite density, tubes plus polymer over the cell volume (the coated cylinder for a fibre), rounded down. polymer_weight_fraction sets it from the tube mass, rounded to the nearest chain. The preview reports the achieved chain count, CNT and polymer weight fractions and unrelaxed density. A target density that the tubes alone reach is refused (composite.density_below_inclusion).

How the polymer is placed

The chains are grown by the polymer packer’s self-avoiding chain growth, with the tube atoms entered as fixed atoms before the first chain. A chain atom may not overlap a tube atom (closer than the collision scale times the sum of the radii, periodic images included) and may not lie inside any tube’s outer-wall cylinder. Exclusion is by distance to the tube atoms and by the tube interiors, not by boxes. The packer’s growth options (collision_scale, radii, max_attempts, on_exhausted and the others) can be given in polymer. Crosslinked networks are not built; a cured resin is represented by a stated linear surrogate.

Checks, refusals and provenance

After growth the joined model is checked by brute force: the smallest polymer-tube distance relative to the radius sum, the number of chain atoms inside a tube (or outside a coating), bonds between a tube and a chain, and the element count against the tubes and chains. Each refusal has a stable code: composite.tube_refused, composite.tilt_periodic, composite.cell_too_small, composite.segment_too_long, composite.length_unstated, composite.disorder_exhausted, composite.tube_contact, composite.density_below_inclusion, composite.no_polymer, composite.too_many_sites, composite.polymer_refused (with the packer’s own codes) and composite.check_failed.

The model’s provenance.composite records the request, the status unrelaxed representative model, both seeds, each tube’s walls, centre, axis, tilt, rotation, axial shift, site IDs and parent map, each chain’s sequence and residues with their site IDs and parent atoms, the composition, the checks, the macroscopic metadata with the statement that the cell is a representative volume element, and an empty properties_inferred list. The model survives save, reopen and QVF export.

Representative examples

Three examples are tied to the source papers. Their macroscopic dimensions are quoted from the experimental sections; every atomistic parameter (tube indices, bundle size, cell, chain length and polymer amount) is illustrative and labelled so, and is not taken from the papers or their SI.

Example

Source

Model

hnbr-coated-microcable

Alvarez et al. 2014, doi:10.3390/nano4040879

Three double-walled tubes in an HNBR coating shell (hydrogenated butadiene and acrylonitrile units, about half each from the stated 49 % acrylonitrile mass content). Metadata: coated fibre 26.54 um, as-spun 27.81 um, coating about 4 um, array height about 300 um.

resin-embedded-cross-section

Gupta et al. 2019, doi:10.1021/acsaem.9b01723

A densified hexagonal bundle in a periodic resin matrix; the cured EMBed-812 network is represented by a linear phenoxy surrogate. Metadata: fibre diameters 28.22, 49.14 and 69.45 um, 40 um film, forest height up to 450 um.

epoxy-thread-disordered

Yu et al. 2016, doi:10.3390/ma9020068

Randomly placed, tilted tube segments in a matrix of a linear phenoxy surrogate for the EDA/MBDGA network. Metadata: MWCNT outer diameters 6 to 20 nm, length about 450 um, the 10 um thread-diameter threshold of the strength study (recorded only).

vibe-sketcher solid cnt-composite fibre.vsk --list-examples
vibe-sketcher solid cnt-composite fibre.vsk --show-example hnbr-coated-microcable > coated.json
vibe-sketcher solid cnt-composite fibre.vsk --request coated.json
vibe-sketcher solid cnt-composite fibre.vsk --example epoxy-thread-disordered --seed 4 --apply
vibe-sketcher solid cnt-composite-undo fibre.vsk --structure epoxy-thread-cnt

solid cnt-composite without --apply prints the preview as JSON and exits with status 3 when it is refused. --id and --seed override the request.

From Python:

from vibesketcher.document import cnt_composites, new_document

request = cnt_composites.parse_composite(cnt_composites.example("hnbr-coated-microcable"))
result = cnt_composites.preview(request)
document = cnt_composites.apply(new_document(), request)

REST and MCP

  • GET /api/documents/{id}/periodic/cnt-composite/examples lists the example requests.

  • POST /api/documents/{id}/periodic/cnt-composite/preview takes composite and changes nothing.

  • POST /api/documents/{id}/periodic/cnt-composite takes revision and composite.

  • POST /api/documents/{id}/periodic/cnt-composite/undo takes revision and structure.

A stale revision is answered with 409. The MCP tools are preview_cnt_composite (with example and list_examples) and apply_cnt_composite (with example and undo).

Not yet covered

The browser has no composite form yet; use the SDK, CLI, REST or MCP. The model is not relaxed or equilibrated here. Twisted yarns, densification, crosslinked networks, CNT-polymer covalent grafting, mixed tube chiralities in one bundle, and finite clusters without any periodic axis are not built.