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,ryandrzare in that table and are also operators insidetrandtri; James reads them as operators there. interrupt,resumeandcaptiondo nothing.captionchecks that its option iscap,onoroff, and James raises E0217 otherwise.neutralselects James’s own format. TrueGrid’sneutralcommand writes TrueGrid’s neutral file. In James it selects James’s plain-text neutral file, which theneutralpage describes. James accepts the command silently.commentandverbatimare read and discarded. The text they carry has nowhere to go in the formats James writes. Averbatimblock must still end withendverbatim(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 fixedis 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,tmeandtmeitake a weight above 0 and at most 1 (E1304); TrueGrid’s pages hint that it takes a larger one, and James refuses it. Arelaxlist of two or more regions that holds a block is refused (E1301).relaxof 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,cylinderorinsprtlist marks a shell partition, which carries four-node shell elements, and a0entry 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.eshandeshi, 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 THICKNESStable only for shells whose corners differ. - The coordinate equations.
mseqandlmseqafter an equation are accepted, where Vol. 1, p. 194 saysmseqwill 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). Adeffunction 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&. Amseq,lmseqorinsprtthat 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
%nameends 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.0asraminus1.0and%ef-.2asefminus.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.
includefiles nest to 32 levels where TrueGrid allows 19.when,forandwhilenest to 64 together, andifto 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
ifcloses in the file that opened it. Anifopened in anincludefile 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
HEX8block per part and material and oneSHELL4block 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. --formatis a fallback. A format command in the script overrides the command-line flag.- A second format command warns. A second
neutralorexodusiithat names a different format, before anywritehas used the first, raises E1104, and the later one governs. Repeating the same format is silent, and so is switching format after awrite. - A second
titlereplaces the first, with no message. - A part’s bad lists open it poisoned. A
blockorcylinderwhose 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,sfiormsmake two surfaces. To reuse a surface, define it once withsdand refer to its number. sdstakes a plain list. The list of surface numbers has no colon shorthand such as1:4; James raises E0104.- An angle past 360 degrees is kept, and converts periodically when the part ends. An
mbormbioffset may carry the angle of acylinderpart outside 0 to 360 degrees. James neither rejects nor reduces it. The part converts to Cartesian coordinates atendpart, 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 nraises 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.
sdbuilds 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 insf,sfiorms: the IGES kindsnurbs,igessandigesp, the spline surfacescsps,bsps,nrbsandhermite,function, and the polygon kindsmesh,poly,stl,bstl,faceandfaceset.curdbuildslp3,csp3,arc3andsdedge, one group per curve; every other type raises E0603. A 2D curve takeslp2,larandlccsegments; every other raises E1009. Milestone M15 adds the spline surfaces,function, the polygon kindsmesh,poly,stlandbstl, the other curve types, curves of several segments and the other 2D segments;faceandfacesetwait for the sets, and the IGES kinds stay long-term. edgeandpatchrun on surfaces with sides;sppandndsare refused for want of what they need.edgeattaches an edge to a side of a surface, andpatchthe four edges of a face to the four sides of a surface and projects it. An infinite or closed surface has no sides, andedgeon one stops the run with exit code 2;patchstops the same way on a surface that has not four sides.ndsneeds a density function, which only the refusednddmakes (E0904), andnddanddnddare not planned.sppneeds a template, which only the refusedtmpltmakes (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, inedgeorsdedge, 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. torusis James’s own word. The torus istsin TrueGrid’s dictionary andtoruin one of its chapters, and James accepts both and addstorus, 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:cyliforcy,spheforsp,planeforplan,xzplanforzxplanandiplaneforiplan. 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,yscaorzsca), 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 ofpl2,pl3,pl3oandarc3isrt,cyorsp; the labeled pointptthat only TrueGrid’s display makes is refused (E1012). - Five transformation operators are refused.
trandtritake thirteen operators;tf,ftf,rxy,ryzandrzxraise 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.
nerlis 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 andintpsurfaces), 36 surface kinds withedgeandpatchon their sides, the commands in the command reference (smoothing withrelaxandtmeand the coordinate equationsx=tot3=withdomamong 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,mtandmtiand the reordering of an inverted part, in version 0.4.0. M10 built the smoothing commandsrelax,relaxi,tmeandtmeiin version 0.5.0.unifm,unifmi,neuandneuiwait for the report their method comes from,esmandesmpfor a source that says what the two parameters ofesmdo, andhyris no option of a command James builds, so these seven stay refused. M11 built shell partitions and the four-node shell withorpt,n,thic,th,thi,ssf,ssfi,intp, gaps andcycorsyin version 0.6.0. M12 built the coordinate equationsx=,y=,z=,t1=,t2=andt3=withdom,maandpain version 0.7.0;updatestays refused, as its own page in the manual advises. M13 built 27 more surface kinds, the 3D curve typesarc3andsdedge,edgeandpatchin version 0.8.0. M14 builds block boundaries,bbandtrbb, withptolandbptol, and with themtmpltandspp;accuracyandnpllare accepted and do nothing. M15 adds the spline surfaces,function, the polygon kindsmesh,poly,stlandbstl, the other curve types, curves of several segments andrmseg;faceandfacesetwait for the sets, and the IGES kinds stay long-term.nddanddnddare not planned, sondsstays refused. - Long-term. Beams, IGES import, material properties, loads, boundary conditions and sets, and the commands that need them:
blude,bnstol,mnsandepb. Replication and transformation commands. Interactive mode, whichpbsand theptcoordinate type need. The write optionselvotest,ndigits,npbandsave. -
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