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 |
|---|---|
|
ID of the derived periodic model. |
|
One nanotube that every bundle member copies (see below). |
|
How many tubes and how they are placed. |
|
The cell policy: a periodic |
|
Repeat units and one chain specification, as in the polymer packer. |
|
Exactly one of |
|
The seed for the tube placement and the polymer growth. |
|
Labelled experimental dimensions: |
|
Source DOIs. |
|
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.
hexagonalThe tube axes sit on a triangular lattice of pitch
2 R + gap, where R is the outer-wall radius. Thecountlattice points closest to the centre are taken, so incomplete shells are allowed. All tubes are identical and parallel.randomEach axis is drawn uniformly in a disc of
radius_angstromabout 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 tomax_tilt_deg(at most 30). A draw closer than the gap to an earlier tube, or with an atom inside another tube, is rejected; pastmax_attemptsthe request is refused withcomposite.disorder_exhausted. A periodic tube runs along c and cannot tilt, so tilt with periodic tubes is refused (composite.tilt_periodic).
Cells¶
matrixA 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 insideaandb(composite.cell_too_small).coated_fibrePeriodic along c only. A cylindrical coating shell of
coating_thickness_angstromsurrounds the bundle envelope (the largest radial atom distance from the bundle axis), withvacuum_angstromoutside. Withinfiltratefalse (the default) the chains stay outside the envelope; withinfiltratetrue 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 |
|---|---|---|
|
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. |
|
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. |
|
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/exampleslists the example requests.POST /api/documents/{id}/periodic/cnt-composite/previewtakescompositeand changes nothing.POST /api/documents/{id}/periodic/cnt-compositetakesrevisionandcomposite.POST /api/documents/{id}/periodic/cnt-composite/undotakesrevisionandstructure.
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.