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 in sf, sfi and ms. The geometry chapter describes every kind. By family: the planes xyplan, yzplan, zxplan, pl2, pl3, pl3o and iplan; the cylinders xcy, ycy, zcy, cy3, cyr2 and cyr3; the cone cn2p, the ellipsoid er, the paraboloid pr and the torus ts; the surfaces built from 2D curves, cr, cp, rule2d and swept; and the surfaces built from 3D curves, rule3d, crule3d, pipe, blend3, blend4 and r3dc. 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. plane reads as plan, xzplan as zxplan, iplane as iplan and toru as ts, as TrueGrid’s manuals write them. torus is James’s own word for ts: 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, rule3d and the others of the geometry chapter), always with its ;. The list must be a similarity, and so must the list of an arc3; a scale of one axis alone stops the run when James builds the surface or the curve. A point of pl2, pl3, pl3o and arc3 is written rt x y z, cy rho theta z or sp rho theta phi, the angles in degrees.
  • Two more 3D curve types. arc3 is an arc through three points (seqnc), the rest of its circle (cmplt) or the whole circle (whole). sdedge, also written se, is a side of a surface. Both take a transformation list. A curve of several segments is still one group per curd (E0608), and rmseg is refused as a command.
  • edge and patch run. edge puts the nodes of an edge on a side of a surface, as cur puts them on a curve; patch attaches 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 but blend3, 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 four edge commands on a block whose corners lie off the surface land as if the corners had been placed on it. spp and nds stay refused, and tmplt, accuracy, npll and project are now listed for M14, rmseg for M15.
  • A %name reference 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-1 read the parameter a-1; it is now a minus 1, and %ef-.2 is ef minus .2, as the speaker script of the TrueGrid Examples manual relies on. A script that defines a parameter such as a-1 with para still 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.
  • %nextsrf now changes as soon as sd has read the surface number, so an sd that is then refused moves it too.
  • mseq, lmseq or insprt that follows a coordinate equation reading i, j or k now 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 ts surface; cases 057 to 069 are James’s own, for the families of kinds, with edge, patch, sdedge and 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-ir prints james-ir 5), and a surface or 3D curve row of the new kinds carries its transformation, curve lists, option or side. 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 arc3 that 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 not rt, cy or sp), E1013 (a fraction outside 0 to 1, or a direction that is not r or l) and E1014 (a 3D curve that is not defined). E1001 now serves every kind built from a 2D curve, E1005 every radius, E0604 sdedge, 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= and t3= set a coordinate or a per-node temporary at every node of a region from an expression over the node’s coordinates, its full indices i, j, k, the part’s %idxlist, %jdxlist, %kdxlist, %maxrudi, %maxrudj and %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; a cylinder part’s equations read and write its radius, angle in degrees and height. rand and norm draw 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-part dom, a fiber optic cable and a spring are golden cases 042 to 047.
  • ma and pa move one vertex, as mb and pb over it. A reduced index of 0, which in a region stands for the whole direction, is refused there (E0500).
  • mseq and lmseq after an equation are accepted, as the TrueGrid examples issue them.
  • update stays 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 a def function the equation calls alike, as the diagnostics chapter says.
  • In every expression, [...], para, if, when and while included, rand and norm now 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.
  • tanh joins the functions of every expression, [...], def, if, when and while as 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-ir prints james-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 large the manual requires; every deck from 0.4.0 to 0.6.0 wrote LARGE, 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 flip is 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 block or cylinder index list, or an insprt with 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 under partmode 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 0 in 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), and mseq and lmseq are 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 ssf chord 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, ssf and ssfi warn (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 cylinder part 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, hex8 or shell4, after the material number; a shell line ends in its four corner thicknesses. The output chapter gives the lines.
  • Exodus II files gain a SHELL4 block per part and material after the part’s HEX8 block, with four attributes, thickness1 to thickness4. The three decks carry shells: LS-DYNA under *ELEMENT_SHELL_THICKNESS with a part and a *SECTION_SHELL per shell block, numbered above the highest material; Abaqus as S4 elements in PART_P_SHELL with a set and *SHELL SECTION per 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 THICKNESS table 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 reads part #<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 element now 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 identical de now 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-nodes writes.
  • 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.
  • esh and eshi stay 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 -v prints 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. relax makes the elements even. tme carries 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. A relax list 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 of mxp. The shaping chapter has the cube on a sphere, before and after, and a folded face that relax clears. 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 0 between 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 1 selects 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.

  • curf keeps 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 whose curf edge 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, neu and neui, because the report their method comes from has not been found; esm and esmp, because no page and no cited work says what the two parameters of esm do; and hyr, because it is no option of a command James builds.
  • The version is 0.5.0. james -v prints 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 keyword writes an LS-DYNA keyword deck in the long format, abaqus an Abaqus input file, and dyna3d a DYNA3D input deck; --format lsdyna, --format abaqus and --format dyna3d choose them from the command line. Each deck holds a placeholder elastic material per material number, marked to be replaced before use. lsdyna fixed is 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; the PART and MATERIAL properties 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 E always (1.000000000000000E+000), where 0.3.1 printed 23 columns and dropped the E past 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 if guard and a number too large to hold were each reported twice (E0203, E0213); a splint region with no extent along its direction is the script’s error (E0900) where it was an internal message; a bad value in an lp2 list names lp2 in 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 n raises 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 write has used the first format. Repeating the same format is silent.
  • A second title replaces the first, with no message.
  • sds takes a plain list of surface numbers. The colon shorthand is refused (E0104).
  • An mb or mbi offset may carry the angle of a cylinder part 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 ms whose 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, neui and unifmi, 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.


James 0.8.0.

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