Compatibility with TrueGrid

James reads TrueGrid-style input and is not affiliated with TrueGrid or its publisher. A script that uses only the commands in the command reference runs in James without change, with the differences this chapter lists. Every other command of TrueGrid’s that James knows is either refused with a message naming it and the page of TrueGrid’s manual that documents it, or accepted and ignored because it only draws a picture or belongs to an interactive session; both sets are listed here in full. A word James does not know at all is reported as not a command it recognizes.

The posture

James reads a documented subset of TrueGrid’s language and runs it unchanged. Where TrueGrid imposes a limit for no reason James can find, James relaxes it. Where scripts rely on a quirk, James keeps the quirk. James does not copy TrueGrid bug for bug, and it does not promise that a mesh it writes matches TrueGrid’s node for node.

What runs unchanged

The commands in the command reference run as they do in TrueGrid, with the differences in the next section. A script that uses only those commands needs no change.

Known differences

Each item is a rule James applies. The command pages say more about the ones they concern.

  • Picture commands are accepted and ignored. James draws nothing. Each command in the table “Commands accepted and ignored” discards the rest of its line and leaves no trace. rx, ry and rz are in that table and are also operators inside tr and tri; James reads them as operators there.
  • interrupt, resume and caption do nothing. caption checks that its option is cap, on or off, and James raises E0217 otherwise.
  • neutral selects James’s own format. TrueGrid’s neutral command writes TrueGrid’s neutral file. In James it selects James’s plain-text neutral file, which the neutral page describes. James accepts the command silently.
  • comment and verbatim are read and discarded. The text they carry has nowhere to go in the formats James writes. A verbatim block must still end with endverbatim (E1102).
  • Five output formats. James writes neutral, Exodus II, and the LS-DYNA keyword, Abaqus and DYNA3D decks, each deck with a placeholder material per material number that you replace before use. lsdyna fixed is refused (E1105), and so is every other format selector; the table “Refused commands” lists them.
  • Smoothing: a weight above 1 is refused, and a list of faces holds faces only. relax, relaxi, tme and tmei take a weight above 0 and at most 1 (E1304); TrueGrid’s pages hint that it takes a larger one, and James refuses it. A relax list of two or more regions that holds a block is refused (E1301). relax of the cube on a sphere in TrueGrid’s manual gives a corner element edge of 0.018319095 where that manual prints 0.018319121: a smoothed mesh is close to TrueGrid’s, not equal to it.
  • Shells on the part’s own partitions. A negative entry in a block, cylinder or insprt list marks a shell partition, which carries four-node shell elements, and a 0 entry marks a gap; the parts chapter gives their rules. A cell holds a solid only when both partitions bounding it in every direction are positive. esh and eshi, which put shells on the faces of a solid part, stay refused: a shell partition is the way James builds a shell. A thickness is four corner values per shell, and an Abaqus deck carries a *NODAL THICKNESS table only for shells whose corners differ.
  • The coordinate equations. mseq and lmseq after an equation are accepted, where Vol. 1, p. 194 says mseq will not work: an equation is compiled over the node’s own values and full indices, so the element counts that follow change nothing it holds. A program is capped at 2048 instructions and 256 stack slots (E1500), where TrueGrid’s limit is 240 items (Vol. 1, p. 279). A def function cannot take an argument that varies from node to node (also E1500); write its body into the equation. A line that ends in an operator does not continue onto the next, so the spring of the TrueGrid Examples manual as printed fails with E0221: join the line or end it with &. A mseq, lmseq or insprt that follows an equation reading an index draws a note (E0420), since the equation reads the indices of the final lattice. The parts chapter gives the rest.
  • A %name ends at the first character that is not a letter, a digit or an underscore. The TrueGrid manual lets a name hold any printing character but + % * / ^ ( ) [ ] = & $ (Vol. 2, p. 475), but TrueGrid’s own scripts read %ra-1.0 as ra minus 1.0 and %ef-.2 as ef minus .2 (the speaker script of the TrueGrid Examples manual, p. 56), and James reads them so. A parameter whose name holds another character can be defined, but no % reference reads it: rename it.
  • Deeper nesting. include files nest to 32 levels where TrueGrid allows 19. when, for and while nest to 64 together, and if to 64, where TrueGrid documents 19 or 20.
  • Wider numbers. An integer may reach 2147483647 in magnitude, where TrueGrid documents about 1e9. A real number may take any double-precision value, where TrueGrid documents a range of about 1e-18 to 1e18.
  • An if closes in the file that opened it. An if opened in an include file and closed in the file that includes it raises E0319 in the first and E0300 in the second.
  • The merge’s tie-break and zero rule. James visits nodes in the order of their numbers before the merge. Each node merges into the closest node that has already survived within the tolerance, and of two equally close survivors it takes the lower-numbered. A pair merges when its distance is less than the tolerance, so a tolerance of zero merges nothing. A chain of nodes each within tolerance of the next does not collapse to one node. The last tolerance command before a write governs alone.
  • The merge report is printed after the file. A write that cannot open its file prints no report.
  • The Exodus II layout. The file holds the coordinates, one HEX8 block per part and material and one SHELL4 block per part and material with four thickness attributes, with the part and the material as block properties, and a QA record. It holds no node or element maps, no sets and no date.
  • --format is a fallback. A format command in the script overrides the command-line flag.
  • A second format command warns. A second neutral or exodusii that names a different format, before any write has used the first, raises E1104, and the later one governs. Repeating the same format is silent, and so is switching format after a write.
  • A second title replaces the first, with no message.
  • A part’s bad lists open it poisoned. A block or cylinder whose lists raise E0400, E0401, E0402, E0403 or E0413 still opens its part. James reads the commands that follow against corrected lists and the part adds nothing to the mesh. You see the one real error and not a row of phase errors after it.
  • A repeated inline surface is a second surface. Two identical inline definitions in sf, sfi or ms make two surfaces. To reuse a surface, define it once with sd and refer to its number.
  • sds takes a plain list. The list of surface numbers has no colon shorthand such as 1:4; James raises E0104.
  • An angle past 360 degrees is kept, and converts periodically when the part ends. An mb or mbi offset may carry the angle of a cylinder part outside 0 to 360 degrees. James neither rejects nor reduces it. The part converts to Cartesian coordinates at endpart, so 390 degrees lands where 30 does.
  • A part whose every element is deleted warns. James meshes it, writes none of its nodes unless you pass --write-unref-nodes, and prints a warning that names the flag.
  • A part with no element is meshed, not refused. A list with one entry gives one node and no element in that direction. James meshes it, warns, and writes none of its nodes unless you pass --write-unref-nodes.
  • The engine’s lines are capped at 4096. --engine-lines n raises the cap. A line before the summary says how many lines were not recorded and names the flag.
  • Node caps. A part holds at most 100000000 nodes and one write at most 250000000. James stops with exit code 2 beyond either.
  • 36 surface kinds, four 3D curve types and three 2D segment kinds. sd builds the 36 kinds of the geometry chapter: the planes, cylinders, cones, the ellipsoid, paraboloid and torus, and the surfaces built from 2D or 3D curves. The fourteen TrueGrid kinds it does not build raise E1004, and E0801 when written inline in sf, sfi or ms: the IGES kinds nurbs, igess and igesp, the spline surfaces csps, bsps, nrbs and hermite, function, and the polygon kinds mesh, poly, stl, bstl, face and faceset. curd builds lp3, csp3, arc3 and sdedge, one group per curve; every other type raises E0603. A 2D curve takes lp2, lar and lcc segments; every other raises E1009. Milestone M15 adds the spline surfaces, function, the polygon kinds mesh, poly, stl and bstl, the other curve types, curves of several segments and the other 2D segments; face and faceset wait for the sets, and the IGES kinds stay long-term.
  • edge and patch run on surfaces with sides; spp and nds are refused for want of what they need. edge attaches an edge to a side of a surface, and patch the four edges of a face to the four sides of a surface and projects it. An infinite or closed surface has no sides, and edge on one stops the run with exit code 2; patch stops the same way on a surface that has not four sides. nds needs a density function, which only the refused ndd makes (E0904), and ndd and dndd are not planned. spp needs a template, which only the refused tmplt makes (E0804); milestone M14 builds the two together.
  • The numbering of a surface’s sides is James’s own for every kind but the spline surfaces. TrueGrid’s manual states how it numbers the edges of a spline surface: the two ends of the first parameter are edges 1 and 2 and the two ends of the second are 3 and 4. James applies that rule to every kind it builds but blend3, whose three sides are numbered round its loop, and numbers the rims of a revolved curve 1 and 2; the geometry chapter lists each kind. The manual does not say how it numbers the sides of the other kinds, and its display draws labels of its own, so a script that names a side by the label TrueGrid draws, in edge or sdedge, may name another side in James. A sphere, a cylinder and a torus have no sides in James, where TrueGrid gives them edges that meet.
  • torus is James’s own word. The torus is ts in TrueGrid’s dictionary and toru in one of its chapters, and James accepts both and adds torus, which TrueGrid does not know, so a script that uses it runs in James alone. James also accepts the spellings that TrueGrid’s manuals write beside the names of their dictionary: cyli for cy, sphe for sp, plane for plan, xzplan for zxplan and iplane for iplan. An alias reads as the same kind, and the IR holds only the short word.
  • A surface’s or an arc3’s transformation list must be a similarity, and a point has three systems. A list that is not a similarity, such as a scale of one axis alone (xsca, ysca or zsca), stops the run when James builds the surface or the curve, because the result would be a shape James has no kind for. A point of pl2, pl3, pl3o and arc3 is rt, cy or sp; the labeled point pt that only TrueGrid’s display makes is refused (E1012).
  • Five transformation operators are refused. tr and tri take thirteen operators; tf, ftf, rxy, ryz and rzx raise E0503. Milestone M14 reconsiders them.
  • A wholly inverted part is reordered; a partly inverted one is not. A part whose every element is left-handed is written with the corners of every element reordered, with a note. A part with some left-handed elements gets a warning and its elements are written as they are. The shaping chapter explains both lines.
  • nerl is refused. James numbers nodes and elements by one rule, which the merge and output chapter states. A later version may add James’s own numbering options, numbered 10 to 13 so that they are not mistaken for TrueGrid’s 0 to 3, with a message for the TrueGrid values that says the James options come close; none is scheduled.

Refused commands

James knows these 69 commands and refuses every one with E0100; the message names the page of the original manual that documents the command. The tier says which part of the project’s plan the command belongs to, and the last column says when it arrives or, for a command that waits, why. Milestones are plans, not promises; the changelog records what each version holds.

Command Where it is documented Tier Milestone, or why it waits
tpara Vol. 2, p. 478 long-term long-term
bb Vol. 1, pp. 379-384 near-term M14
trbb Vol. 1, pp. 394-395 near-term M14
neui Vol. 1, pp. 256-257 near-term waits for a source: the report its method comes from has not been found
unifmi Vol. 1, p. 261 near-term waits for a source: the report its method comes from has not been found
blude Vol. 2, p. 355 long-term long-term
update Vol. 1, p. 197 long-term deferred at M12 and placed long-term by DrBob at its close-out (15OCT2026), to be built for a user who needs two projections on one region: the manual’s own page says the command “is almost never needed and interferes with the Command Hierarchy”, that its “usage is strongly discouraged” and that it exists “to permit successive projections”; the parts chapter quotes it whole
pbs Vol. 1, pp. 202-203 long-term long-term
esm Vol. 1, pp. 226-228 near-term waits for a source: no page and no cited work says what its two parameters do
esmp Vol. 1, p. 229 near-term waits for a source: no page and no cited work says what the two parameters of esm do, whose equations esmp adds to
unifm Vol. 1, pp. 257-260 near-term waits for a source: the report its method comes from has not been found
neu Vol. 1, pp. 252-256 near-term waits for a source: the report its method comes from has not been found
hyr Vol. 1, p. 230 near-term not built: it is no option of a command James builds, and its own page calls it of little use
esh Vol. 1, pp. 411-412 not scheduled no tier holds it: shells on the faces of a solid part; a shell partition of the part’s own lists is the way James builds a shell
eshi Vol. 1, p. 412 not scheduled as esh
tmplt Vol. 1, p. 268 near-term M14, with spp
accuracy Vol. 2, p. 99 near-term M14, as a command that is accepted and does nothing, since James projects to machine precision
npll Vol. 2, p. 103 near-term M14, as accuracy
project Vol. 2, pp. 104-105 near-term stays refused at M14: it needs the engine’s geometry while the script is still being read, so it waits for an interactive mode
ndd Vol. 1, p. 275 not planned no page of the manual defines it; James may revisit it if a need appears
dndd Vol. 1, p. 275 not planned as ndd
rmseg Vol. 2, p. 96 near-term M15, with the 3D curves of several segments it removes the last of
apld Vol. 2, p. 20 not classified none scheduled
rlns Vol. 2, p. 37 not classified none scheduled
nerl Vol. 2, pp. 433-434 near-term none scheduled
ptol Vol. 2, pp. 452-457 near-term M14
bptol Vol. 2, pp. 452-457 near-term M14
bnstol Vol. 2, pp. 452-457 long-term long-term
mns Vol. 2, pp. 452-457 long-term long-term
elvotest Vol. 2, p. 486 long-term long-term
epb Vol. 2, pp. 486-487 long-term long-term
ndigits Vol. 2, pp. 486-487 long-term long-term
npb Vol. 2, pp. 486-487 long-term long-term
save Vol. 2, pp. 486-487 long-term long-term
ale3d Vol. 2, pp. 489-494 additional writers none scheduled
ansys Vol. 2, pp. 489-494 additional writers none scheduled
autodyn Vol. 2, pp. 489-494 additional writers none scheduled
cf3d Vol. 2, pp. 489-494 additional writers none scheduled
cfd-ace Vol. 2, pp. 489-494 additional writers none scheduled
cfx Vol. 2, pp. 489-494 additional writers none scheduled
es3d Vol. 2, pp. 489-494 additional writers none scheduled
fidap Vol. 2, pp. 489-494 additional writers none scheduled
fluent Vol. 2, pp. 489-494 additional writers none scheduled
gemini Vol. 2, pp. 489-494 additional writers none scheduled
gridgen3d Vol. 2, pp. 489-494 additional writers none scheduled
iri Vol. 2, pp. 489-494 additional writers none scheduled
lsnike3d Vol. 2, pp. 489-494 additional writers none scheduled
icfep Vol. 2, pp. 489-494 additional writers none scheduled
kiva3v Vol. 2, pp. 489-494 additional writers none scheduled
kiva Vol. 2, pp. 489-494 additional writers none scheduled
marc Vol. 2, pp. 489-494 additional writers none scheduled
mpact Vol. 2, pp. 489-494 additional writers none scheduled
nastran Vol. 2, pp. 489-494 additional writers none scheduled
nike3d Vol. 2, pp. 489-494 additional writers none scheduled
enike3d Vol. 2, pp. 489-494 additional writers none scheduled
nnike3d Vol. 2, pp. 489-494 additional writers none scheduled
fnike3d Vol. 2, pp. 489-494 additional writers none scheduled
nekton2d Vol. 2, pp. 489-494 additional writers none scheduled
nekton3d Vol. 2, pp. 489-494 additional writers none scheduled
ne/nastran Vol. 2, pp. 489-494 additional writers none scheduled
refleqs Vol. 2, pp. 489-494 additional writers none scheduled
sap2000 Vol. 2, pp. 489-494 additional writers none scheduled
starcd Vol. 2, pp. 489-494 additional writers none scheduled
plot3d Vol. 2, pp. 489-494 additional writers none scheduled
poly3d Vol. 2, pp. 489-494 additional writers none scheduled
tascflow Vol. 2, pp. 489-494 additional writers none scheduled
topaz3d Vol. 2, pp. 489-494 additional writers none scheduled
topaz3d2 Vol. 2, pp. 489-494 additional writers none scheduled
viewpoint Vol. 2, pp. 489-494 additional writers none scheduled

The 35 format selectors the table marks “additional writers” have no milestone. lsdyna, abaqus and dyna3d left this table with version 0.4.0, which writes them. A format selector that is not in the table raises E0105, as does any other word James does not know.

Commands accepted and ignored

These 74 commands only draw a picture or steer an interactive session. James reads each one, discards the rest of its line, and prints nothing.

Command What it draws
ad the view and picture controls of the session
aad the view and picture controls of the session
daad the view and picture controls of the session
dad the view and picture controls of the session
dads the view and picture controls of the session
display the view and picture controls of the session
disp the view and picture controls of the session
draw the view and picture controls of the session
grid the view and picture controls of the session
pad the view and picture controls of the session
poor the view and picture controls of the session
postscript the view and picture controls of the session
raad the view and picture controls of the session
rad the view and picture controls of the session
rindex the view and picture controls of the session
sdint the view and picture controls of the session
set the view and picture controls of the session
slice the view and picture controls of the session
triad the view and picture controls of the session
tvv the view and picture controls of the session
zclip the view and picture controls of the session
l the view and picture controls of the session
r the view and picture controls of the session
u the view and picture controls of the session
d the view and picture controls of the session
rx the view and picture controls of the session
ry the view and picture controls of the session
rz the view and picture controls of the session
trans the view and picture controls of the session
fix the view and picture controls of the session
unfix the view and picture controls of the session
scale the view and picture controls of the session
xscl the view and picture controls of the session
yscl the view and picture controls of the session
zscl the view and picture controls of the session
zb the view and picture controls of the session
zf the view and picture controls of the session
angle the view and picture controls of the session
reso the view and picture controls of the session
restore the view and picture controls of the session
center the view and picture controls of the session
ibzone picture controls (ibzone, noplot, plot)
noplot picture controls (ibzone, noplot, plot)
plot picture controls (ibzone, noplot, plot)
lcv 2D curve display
lv 2D curve display
lvi 2D curve display
lvs 2D curve display
dcd 3D curve display
dcds 3D curve display
dacd 3D curve display
acd 3D curve display
acds 3D curve display
rcd 3D curve display
rcds 3D curve display
racd 3D curve display
lacd 3D curve display
asd surface display
asds surface display
ansd surface display
dasd surface display
dsd surface display
dsds surface display
lasd surface display
rasd surface display
rsd surface display
alv CAD geometry display
dlv CAD geometry display
dlvs CAD geometry display
rlv CAD geometry display
agrp CAD geometry display
dgrp CAD geometry display
dgrps CAD geometry display
rgrp CAD geometry display

The tiers

This is the plan, tier by tier, in the order James takes it up.

  • Now. Hex solids and four-node shells (shell partitions, gaps, orpt, n, the thickness commands and intp surfaces), 36 surface kinds with edge and patch on their sides, the commands in the command reference (smoothing with relax and tme and the coordinate equations x= to t3= with dom among them), merging under the four tolerance commands, and the neutral, Exodus II, LS-DYNA keyword, Abaqus and DYNA3D files.
  • Near-term, one milestone at a time. M9 built the LS-DYNA keyword, Abaqus and DYNA3D writers, with material numbers from mate, mt and mti and the reordering of an inverted part, in version 0.4.0. M10 built the smoothing commands relax, relaxi, tme and tmei in version 0.5.0. unifm, unifmi, neu and neui wait for the report their method comes from, esm and esmp for a source that says what the two parameters of esm do, and hyr is no option of a command James builds, so these seven stay refused. M11 built shell partitions and the four-node shell with orpt, n, thic, th, thi, ssf, ssfi, intp, gaps and cycorsy in version 0.6.0. M12 built the coordinate equations x=, y=, z=, t1=, t2= and t3= with dom, ma and pa in version 0.7.0; update stays refused, as its own page in the manual advises. M13 built 27 more surface kinds, the 3D curve types arc3 and sdedge, edge and patch in version 0.8.0. M14 builds block boundaries, bb and trbb, with ptol and bptol, and with them tmplt and spp; accuracy and npll are accepted and do nothing. M15 adds the spline surfaces, function, the polygon kinds mesh, poly, stl and bstl, the other curve types, curves of several segments and rmseg; face and faceset wait for the sets, and the IGES kinds stay long-term. ndd and dndd are not planned, so nds stays refused.
  • Long-term. Beams, IGES import, material properties, loads, boundary conditions and sets, and the commands that need them: blude, bnstol, mns and epb. Replication and transformation commands. Interactive mode, which pbs and the pt coordinate type need. The write options elvotest, ndigits, npb and save.
  • Never. A graphical user interface, and bug-for-bug emulation of TrueGrid’s limits.

  • Sources: TrueGrid User’s Manual v3.0.0, Vol. 1, pp. 194, 197, 202-203, 226-230, 252-261, 268, 275, 279, 379-384, 394-395, 411-412; Vol. 2, pp. 20, 37, 96, 99, 103-105, 355, 433-434, 452-457, 475, 478, 486-487, 489-494

James 0.8.0.

This site uses Just the Docs, a documentation theme for Jekyll.