Changelog
One entry per version, newest first, in a user’s words: what a script can do that it could not before, what changed in what James prints or writes, and what was fixed. The version number’s rule: before 1.0.0 the minor number rises with each release that changes what a user can do, and the patch number with a release that only fixes.
This manual was first published for version 0.3.1. From the next version on, every entry is written with the version it describes.
0.8.0 (22OCT2026)
This version builds the surface and curve kinds, edge and patch, and it changes what a %name reference means.
- 27 more surface kinds for
sd, 36 in all, each also written inline insf,sfiandms. The geometry chapter describes every kind. By family: the planesxyplan,yzplan,zxplan,pl2,pl3,pl3oandiplan; the cylindersxcy,ycy,zcy,cy3,cyr2andcyr3; the conecn2p, the ellipsoider, the paraboloidprand the torusts; the surfaces built from 2D curves,cr,cp,rule2dandswept; and the surfaces built from 3D curves,rule3d,crule3d,pipe,blend3,blend4andr3dc. The kinds that TrueGrid’s dictionary lists and James still does not build (the IGES, spline, formula and polygon kinds) stay E1004, and E0801 inline. - Spellings.
planereads asplan,xzplanaszxplan,iplaneasiplanandtoruasts, as TrueGrid’s manuals write them.torusis James’s own word forts: TrueGrid does not accept it, so a script that uses it runs in James alone. The compatibility chapter says so. - A transformation list ends 15 of the kinds (
xyplan,xcy,cp,rule3dand the others of the geometry chapter), always with its;. The list must be a similarity, and so must the list of anarc3; a scale of one axis alone stops the run when James builds the surface or the curve. A point ofpl2,pl3,pl3oandarc3is writtenrt x y z,cy rho theta zorsp rho theta phi, the angles in degrees. - Two more 3D curve types.
arc3is an arc through three points (seqnc), the rest of its circle (cmplt) or the whole circle (whole).sdedge, also writtense, is a side of a surface. Both take a transformation list. A curve of several segments is still one group percurd(E0608), andrmsegis refused as a command. edgeandpatchrun.edgeputs the nodes of an edge on a side of a surface, ascurputs them on a curve;patchattaches the four edges of a face to the four sides of a surface by the way of the eight that moves the face’s corners least, and projects the face. A kind has sides when it has a boundary: the ruled, swept, blended, piped and revolved kinds, and the revolutions of open curves, but not the closed tubes, a pipe on a closed curve whose radius is the same at both ends and a full turn of a closed 3D curve, whose two rims would be one circle. The sides are numbered by one rule for every kind butblend3, whose three run round its loop, which the geometry chapter lists, and James’s numbering may differ from the label that TrueGrid’s display draws for the same side. A surface without sides, or a side it lacks, stops the run with exit code 2. When all the edge commands of a part have run, James measures again each edge whose end vertex a later command moved, so fouredgecommands on a block whose corners lie off the surface land as if the corners had been placed on it.sppandndsstay refused, andtmplt,accuracy,npllandprojectare now listed for M14,rmsegfor M15.- A
%namereference ends at the first character that is not a letter, a digit or an underscore. This changes what an existing script means. 0.7.0 took every character that may be in a name into it, a-and a.among them, so%a-1read the parametera-1; it is nowaminus 1, and%ef-.2isefminus.2, as the speaker script of the TrueGrid Examples manual relies on. A script that defines a parameter such asa-1withparastill defines it, but no reference reads it: rename it. A%that begins no name, as in%1a, is E0221, and its detail says that a name starts with a letter or_. The writing chapter and the compatibility chapter give the rule. %nextsrfnow changes as soon assdhas read the surface number, so ansdthat is then refused moves it too.mseq,lmseqorinsprtthat follows a coordinate equation readingi,jorknow prints a note, E0420, since the equation reads the indices of the final lattice. The note is not counted in the summary line and changes no exit code.- The golden cases grow to 069. The TrueGrid examples of seven plates and a helix are cases 048 to 054 and 056, and the spring of case 047 is made again with its own
tssurface; cases 057 to 069 are James’s own, for the families of kinds, withedge,patch,sdedgeand the inline forms. The pyramid of the Examples manual (its page names four and five surfaces on one node, which James holds to three, E0803) and the Post example are parser cases; no case is numbered 055. - What James prints. The version is 0.8.0 in both halves; the first comment line of an LS-DYNA or Abaqus deck and the QA record of an Exodus II file name it. The IR schema is version 5 (
--dump-irprintsjames-ir 5), and a surface or 3D curve row of the new kinds carries its transformation, curve lists,optionorside. The engine prints new lines for a side that a surface lacks, a transformation that is not a similarity and a swept or piped surface whose fractions are out of order; the diagnostics reference lists them. - Fixed. A node projected onto two or three surfaces from a start far from them landed off the intersection: from 1.6 million units away the unit sphere and the plane z = 0 were met only to 5e-5. The tolerance now follows the size of the iterate and the node lands within 1e-9 of the circle. A projection that stops because two surfaces are nearly tangent now says so:
projection onto 2 surfaces did not converge in 100 iterations; the surfaces are nearly tangent or do not meet. A node that rounding alone puts a hair off the axis of a cylinder, a cone or a revolution, in geometry far from the origin, is now read as on the axis, however far from the origin the geometry sits, and the run stops with the message that its projection is not unique. - New diagnostics: E0609 (an
arc3that cannot be built), E1010 (points that fix no plane or cylinder: two of them coincide, or three lie in a line to within 1e-12 of the longest side), E1011 (parameters that do not fix a cone, paraboloid or revolution), E1012 (a point system that is notrt,cyorsp), E1013 (a fraction outside 0 to 1, or a direction that is notrorl) and E1014 (a 3D curve that is not defined). E1001 now serves every kind built from a 2D curve, E1005 every radius, E0604sdedge, and the lists of E0603, E0801 and E1004 name what James builds and refuses.
0.7.0 (15OCT2026)
This version builds the coordinate equations.
- The six equations
x=,y=,z=,t1=,t2=andt3=set a coordinate or a per-node temporary at every node of a region from an expression over the node’s coordinates, its full indicesi,j,k, the part’s%idxlist,%jdxlist,%kdxlist,%maxrudi,%maxrudjand%maxrudk, and the script’s parameters, arrays and functions; dom names the region. They run at step 20, once after the part’s passes, in the order written; acylinderpart’s equations read and write its radius, angle in degrees and height.randandnormdraw from generators each equation starts afresh, one stream for each seed, so a script gives the same mesh in every run and build and an equation with two seeds perturbs every node with two independent draws. The TrueGrid examples of a twisted cylinder, a squared-index lattice, a stretched sphere, a two-partdom, a fiber optic cable and a spring are golden cases 042 to 047. maandpamove one vertex, asmbandpbover it. A reduced index of 0, which in a region stands for the whole direction, is refused there (E0500).mseqandlmseqafter an equation are accepted, as the TrueGrid examples issue them.updatestays refused; the parts chapter quotes the manual’s own warning against it.- New diagnostics: E1500 (an expression that cannot become a program), E1501 (illegal operations at some nodes, counted), E1502 (a coordinate that is not finite after an equation) and E1503 (an array read outside its bounds at a node). Every message raised while an equation is read carries the equation’s name after its code,
in 'x=':: a syntax error (E0221), a parameter, array or function message such as E0203, and a message from inside adeffunction the equation calls alike, as the diagnostics chapter says. - In every expression,
[...],para,if,whenandwhileincluded,randandnormnow keep one sequence for each seed, as they do in the equations:[rand(1)],[rand(2)],[rand(1)]gives the second number of seed 1 at the third call, where 0.6.1 started seed 1 again. A script whose calls all use one seed draws the same numbers as before. tanhjoins the functions of every expression,[...],def,if,whenandwhileas well as the equations. In every expression an infinity now equals only the same infinity: 0.6.1’s roundoff rule held an infinite value equal to every number, so[1e300*1e300 .eq. 1]was 1, and it is now 0.- The version is 0.7.0 in both halves; the first comment line of an LS-DYNA or Abaqus deck and the QA record of an Exodus II file name it. The IR schema is version 4 (
--dump-irprintsjames-ir 4).
0.6.1 (12OCT2026)
This version fixes the DYNA3D deck and the side of a shell on a mirrored lattice.
- The DYNA3D deck, read against the 1993 DYNA3D user manual. The title card’s large option is the lower-case
largethe manual requires; every deck from 0.4.0 to 0.6.0 wroteLARGE, which DYNA3D reads as the small format. The seventh control card’s last field is at columns 76 to 80, where 0.6.0 put two zeros inside a real field. A shell block’s material carries the three cross-section cards the manual requires after its eight (the section’s title; the shear factor, the integration points, the output option and the rule; the block’s first shell’s thicknesses and the midsurface), which 0.6.0 left out, so DYNA3D would have read the first node card as a material card. This changes every DYNA3D deck. The output chapter gives the cards. - A shell on a mirrored lattice (one or three decreasing coordinate lists, or a reflecting cycorsy or tr) now faces the increasing index, as the TrueGrid manual says and as the mirror image of the unmirrored part would: James swaps its second and fourth corners, as it reorders a mirrored part’s solid elements. 0.6.0 left such a shell facing the other way.
orpt flipis still the inverse of the default, and+and-still face the point. The parts chapter gives the example. - The version is 0.6.1 in both halves; the first comment line of an LS-DYNA or Abaqus deck and the QA record of an Exodus II file name it.
0.6.0 (10OCT2026)
This version builds shell elements, and it changes the first line of every neutral file.
- Shell partitions. A negative entry in a
blockorcylinderindex list, or aninsprtwith the sign-1, carries a layer of four-node shell elements on its plane, where 0.5.0 refused it (E0400 now names the one list it still applies to, a signed entry underpartmode i). A cell of the grid holds a solid element only when both partitions bounding it in every direction are positive, so the spherical shell of the TrueGrid Examples,block -1 5 -9;..., is shells alone and the tutorial’s tank is shells alone. The parts chapter gives the rule and the corner order. - Gaps. A
0in an index list breaks the part: the slab between the partitions on either side of it holds no element, and a region or progression counts across it as TrueGrid does. A gap must lie between two partitions (E0413), andmseqandlmseqare refused in a direction that holds a gap (E0419). - The normal and the thickness. orpt and n turn a shell’s normal toward or away from a point or flip it; thic, th and thi give thicknesses, four corner values per element; ssf and ssfi place shell nodes on an intp surface, the nearest point of the surface a fraction of the way between two others, and take each corner’s thickness from the chord between the two. A shell with a corner of zero thickness, because no command gave it one or an
ssfchord came out zero there, is written with the zero, and the write warns once:N shells have a corner of zero thickness; thic, th, thi, ssf or ssfi gives one. n,th,thi,ssfandssfiwarn (E1402) when their region holds no shell element, that is, when no shell partition with area lies inside it: a block short of every shell partition, a face on a solid partition, an edge, a vertex, or a face on a shell partition whose span in the plane lies inside a gap’s slab. A face on a shell partition, or a block across one, sets the shells there without a warning.- cycorsy places a
cylinderpart in a frame of its own from the part’s first step, so its projections meet surfaces given in global coordinates. - The neutral file is format 3. This changes every neutral file. The first line is
james neutral 3, and every element line carries its kind,hex8orshell4, after the material number; a shell line ends in its four corner thicknesses. The output chapter gives the lines. - Exodus II files gain a
SHELL4block per part and material after the part’sHEX8block, with four attributes,thickness1tothickness4. The three decks carry shells: LS-DYNA under*ELEMENT_SHELL_THICKNESSwith a part and a*SECTION_SHELLper shell block, numbered above the highest material; Abaqus asS4elements inPART_P_SHELLwith a set and*SHELL SECTIONper material and thickness, thicknesses within 64 units of the last place of each other counting as one so that a thickness computed alike over a uniform shape is one section, and a*NODAL THICKNESStable where corners differ; DYNA3D with its shell cards and a material block per shell block. A deck of a mesh with no shell is unchanged but for its version line. - Two more warnings at a write, both listed in the diagnostics chapter:
part #<n> has <k> shells folded or collapsed after merging, when the merge’s tolerances fold a shell over or collapse it to a line or a point (the shell is still written; with no tolerance command before the write the line readspart #<n> has <k> shells folded or collapsed, for a shell that is degenerate as the part built it), and, for an Abaqus deck,<k> nodes of the nodal thickness table take the mean of thicknesses their shells disagree on in <file>. - de and dei delete the shells of a face on a shell partition, and the warning that a region
selects no elementnow comes when the region holds no active element of either kind: a face on a solid partition, an edge, a vertex, or a block whose every element is already deleted. A second identicaldenow warns, where 0.5.0 deleted nothing and said nothing. - relax, tme, relaxi and tmei move the nodes of a shell face as they move any face’s. A face node is still held beside a deleted element, but not beside the cells that a shell partition or a gap leaves without a solid, which the 0.5.0 rule, written before either existed, would have held; a face node touching a hole quadrilateral is still held.
- A node that no element references, such as a node of a deleted block, is no longer projected. 0.5.0 projected it with the rest, which failed on the mushroom of the Examples manual and moved the unreferenced nodes that
--write-unref-nodeswrites. - A graded edge hanging from a vertex of a graded edge across partitions, under a smoothed face, is laid out to that vertex’s final place; 0.5.0 could kink it there.
eshandeshistay refused: a shell partition of the part’s own lists is the way James builds a shell. The compatibility chapter says so.- The version is 0.6.0.
james -vprints it, the first comment line of an LS-DYNA or Abaqus deck names it, and so does the QA record of an Exodus II file.
0.5.0 (06OCT2026)
This version smooths meshes, and it changes what a progression of negative numbers selects.
- Four smoothing commands. relax and tme move the interior nodes of a face or a block, iteration by iteration, with the region’s boundary as fixed data.
relaxmakes the elements even.tmecarries the boundary’s spacing inward and turns the mesh lines toward a right angle at the boundary. relaxi and tmei take an index progression and smooth each member on its own. A face runs at step 11 (relax) or 12 (tme), a block at step 17 or 18, and step 13 then lays out and interpolates again what a smoothed face left behind. Arelaxlist of faces joined by&is one system. A face node stays on its surfaces in every iteration, and the smoothing steps give the same result in every pass ofmxp. The shaping chapter has the cube on a sphere, before and after, and a folded face thatrelaxclears. New messages: E1300 to E1305. - A progression whose lists are all negative reads differently. This changes what an existing script means. A run of exactly two negatives with no
0between them is now an interval with both ends pinned, as the TrueGrid manual’s own scripts mean it, where 0.4.0 read it as two separate points. Three cases:sfi -1 -2;-1 -2;-1 -2;sd 1selects the six faces of a block, where 0.4.0 selected its eight vertices. A script that wrote this to project a block’s faces onto a surface now projects them.- A shape such as
sfi ;-1 -2;-1 -2;selects faces, where 0.4.0 selected edges. The cylinder of the TrueGrid Examples manual,sfi -1 -4;-1 -4;1 8;, projects four faces where it projected four edges. sfi -1 -2;-1;-1;selects nothing and warns (E0107), where 0.4.0 selected two vertices.
To keep the old meaning, write the points with zeros between them:
-1 0 -2. A run of three or more negatives is still separate points. The concepts chapter gives the rule. curfkeeps every vertex of its edge on the curve. The two end vertices are frozen as soon as step 2 places them, and a vertex between them, on an edge that crosses several blocks, is held through step 3, so no projection moves any of them. 0.4.0 projected them at step 3, which could leave the vertices off the curve the edge’s other nodes were frozen to. A script whosecurfedge lies off a surface that one of its faces is projected onto now keeps the whole edge on the curve.- Seven smoothing commands stay refused, each with its reason in the compatibility chapter:
unifm,unifmi,neuandneui, because the report their method comes from has not been found;esmandesmp, because no page and no cited work says what the two parameters ofesmdo; andhyr, because it is no option of a command James builds. - The version is 0.5.0.
james -vprints it, the first comment line of an LS-DYNA or Abaqus deck names it, and so does the QA record of an Exodus II file.
0.4.0 (04OCT2026)
This version writes solver decks and carries material numbers.
- Three new formats. lsdyna
keywordwrites an LS-DYNA keyword deck in the long format, abaqus an Abaqus input file, and dyna3d a DYNA3D input deck;--format lsdyna,--format abaqusand--format dyna3dchoose them from the command line. Each deck holds a placeholder elastic material per material number, marked to be replaced before use.lsdyna fixedis refused (E1105), and a mesh beyond the DYNA3D deck’s fields is refused at the write (E1106). - Material numbers. mate sets a part’s default, and mt and mti give a number to the elements of a region. Every file carries the number: the neutral file is now format 2, with a material column on each element line, and the Exodus II file holds one element block per part and material, with the part and the material as block properties. A block’s ID (
eb_prop1) is now its running number in the file, where 0.3.1 used the part number. The ID changes for a script with a part that has no element or a part with two or more materials; thePARTandMATERIALproperties carry what the ID used to. - Elements are numbered by part, then by material, then k, j, i, so that every file lists them in one order. A part with one material is numbered as before.
- A part whose every element is inverted is written with its corners reordered, with a note. A part with some inverted elements is warned about as before.
- The neutral file prints coordinates in 24 columns with a three-digit exponent and its
Ealways (1.000000000000000E+000), where 0.3.1 printed 23 columns and dropped theEpast two digits. Every neutral file’s bytes change by that form; a reader that splits on blanks sees no difference. - A coordinate that is not finite is refused (E0417), where 0.3.1 wrote NaN or Infinity.
- Fixed: an undefined parameter in an
ifguard and a number too large to hold were each reported twice (E0203, E0213); asplintregion with no extent along its direction is the script’s error (E0900) where it was an internal message; a bad value in anlp2list nameslp2in its message where it printed?.
0.3.1 (01OCT2026)
This version reports more of what a run does and settles a few cases that 0.3.0 left open.
- James keeps every line the engine prints, up to 4096, where 0.3.0 kept 64.
--engine-lines nraises the limit. When a run raises more lines than it keeps, a line before the summary says how many were lost and names the flag. - James prints the merge report after it writes the file. A write that cannot open its file prints no report, where 0.3.0 printed a report for a mesh that was never written.
- A second format command that names a different format now warns (E1104), and the later command governs. The warning appears only when no
writehas used the first format. Repeating the same format is silent. - A second
titlereplaces the first, with no message. sdstakes a plain list of surface numbers. The colon shorthand is refused (E0104).- An
mbormbioffset may carry the angle of acylinderpart past 360 degrees. James neither wraps nor rejects the value. It converts periodically when the part ends, so 390 degrees lands where 30 does. - A part whose every element is deleted warns and writes none of its nodes, unless you pass
--write-unref-nodes. A repeated inline surface is a second surface, not a reuse. - An index progression that selects nothing now warns (E0107) and names the command it ignored.
- An
mswhose region has no extent in one of its two cross directions is the script’s error (E0808). The message names the direction that lacks an extent. - Six near-term commands,
bb,trbb,dom,cycorsy,neuiandunifmi, are refused by name with the page of TrueGrid’s manual that documents them (E0100), where 0.3.0 reported them as words James does not know (E0105).
0.3.0 (29SEP2026)
The first version you can run. James reads a script of the commands in the command reference, meshes hex solids, merges nodes under the four tolerance commands st, stp, t and tp, and writes James’s neutral file or an Exodus II file.