Diagnostics reference

James prints its messages on standard error, one per line, in the form file:line:column: severity: text, or james: severity: text when a message has no place in a script, and ends a run with a summary line that counts its errors and warnings. A message the front end raises carries a code, E and four digits, after its severity, and this chapter has one entry per code: its severity, the message as James prints it, what causes it, and the commands it concerns. The lines the engine raises while meshing, merging and writing carry no code, except E0903, E0417, E1106 and E1305, which the engine prints with their codes; the last section describes them. A script with an error exits with code 1 and writes no mesh; a run the engine refuses exits with code 2, except for a part with a coordinate that is not finite (E0417), a mesh beyond the DYNA3D deck’s fields (E1106) and a tme region with a hole (E1305), which are the script’s errors and exit with code 1, as the front end’s errors do; a refused run exits with code 2 after any file an earlier write of the same run produced; a wrong command line exits with code 3.

Commands and regions

The codes E0100 to E0107.

E0100

Error. James prints error [E0100]: command '<name>' is not supported in this version of James (<phase>; <manual reference>).

You wrote a command that James knows of but has not built. The message gives the phase James was in and the page of the original manual that documents the command. Remove the command, or wait for the milestone that brings it; the compatibility chapter’s table lists the milestone of each one. James then skips to the next command it recognizes.

Concerns every refused command, listed in the compatibility chapter.

E0101

Warning. James prints warning [E0101]: a lone positive number in a progression list selects nothing.

A lone positive number in a progression’s list selects nothing. Write it negative to pin that one reduced index, or add a second number to make an interval.

Concerns every command that takes an index progression: dei, ilini, lini, sfi, tfi and the other i-suffix commands.

E0102

Error. James prints error [E0102]: reduced index <n> is outside the part's <i|j|k> range 1-<max>.

A reduced index in a region or progression is larger than the part has partitions in that direction. A reduced index counts entries of the block or cylinder lists, not node numbers, so check it against the length of that list.

Concerns every command that takes a region or an index progression.

E0103

Error. James prints error [E0103]: progression interval '<first> <last>' is written high to low.

An interval in a progression runs from a larger number to a smaller one, for example 3 1. Write the smaller number first.

Concerns every command that takes an index progression.

E0104

Error. James prints error [E0104]: '<command>' expects <what>, got <what was found>.

A command or control statement has the wrong shape: a word, value or punctuation mark is missing or of the wrong kind. The message names what James wanted and what it found. Supply the missing piece the message names.

Concerns any command or control statement; sd, include, def and array are the usual sources.

E0105

Error. James prints error [E0105]: '<word>' is not a command James recognizes.

The first word of a command is in no list James has: it is not a supported command, a refused one, or one James ignores. Check the spelling. A command James refuses by name raises E0100 instead.

Concerns any command position.

E0106

Error. James prints error [E0106]: region <i|j|k> range '<lo> <hi>' is written high to low.

A region’s lower index in one direction is larger than its upper index, after the zero rule is applied. James refuses it and does not swap the two ends. Write the lower index first.

Concerns every command that takes a region.

E0107

Warning. James prints warning [E0107]: 'sfi' selects no region and is ignored.

A progression expands to no region, so the command has nothing to act on. James accepts the command, stores nothing for it and names it in the warning. This happens when a direction’s list holds only a lone positive number, or when its unions pin nothing, so that no region results. Check the three lists against the part’s partitions.

Concerns every command that takes an index progression, such as sfi.

Scripts, parameters and expressions

The codes E0200 to E0221.

In a coordinate equation, every message of these codes that James raises while it reads the equation’s expression carries the equation’s name after its code: error [E0221]: in 'x=': expression syntax error: unexpected end of expression, error [E0203]: in 'z=': parameter '%g' is referenced before it is defined. The rule has no exception: a message about the expression itself, about the script’s parameters, arrays and functions (a name, a subscript, a def function’s argument count), and a message from inside the body of a def function the equation calls all carry the prefix. A message raised inside a def function’s body, prefixed all the same, is located at the def’s line, where the fault is, not at the equation that called the function. E1500, of the equations’ own family, names the equation in its text instead.

E0200

Error. James prints error [E0200]: include file 'filename' not found or not readable.

The file an include names is missing or cannot be read. James looks in the working directory unless the path is absolute.

Concerns: include.

E0201

Error. James prints error [E0201]: include nesting exceeds the maximum depth of 32.

include files nest more than 32 deep. Flatten the chain.

Concerns: include.

E0202

Error. James prints error [E0202]: include cycle detected: 'filename' is already being included.

A file includes itself, directly or through other files. The message names the file that is already open. Break the cycle.

Concerns: include.

E0203

Error. James prints error [E0203]: parameter '%name' is referenced before it is defined.

A %name has no value when the script uses it. Assign it with para or array first. A typo in a name is the usual cause.

Concerns: para, array.

E0204

Error. James prints error [E0204]: '%name' is not a defined parameter or a recognized automatic parameter.

A %name is neither a parameter you defined nor an automatic parameter James supplies. James has no picking or graphics window, so it never supplies %node or the six bounding-box values %xboxmin, %xboxmax, %yboxmin, %yboxmax, %zboxmin and %zboxmax.

Concerns: para.

E0205

Error. James prints error [E0205]: '%name' is an automatic parameter and cannot be assigned.

A script assigns to a parameter that James sets itself, such as %pi, or to one of the automatic arrays. Choose another name.

Concerns: para, array.

E0206

Error. James prints error [E0206]: subscript out of range for array '%name': dimension <k> is <i_k>, must be between 1 and <d_k>.

A subscript is below 1 or above the dimension the array declared. Subscripts count from 1. The subscript may itself be a computed value, so check that too.

Concerns: array.

E0207

Error. James prints error [E0207]: array '%name' has rank <r>, but <n> subscripts were given.

A reference gives a different number of subscripts than the array declared dimensions. Give exactly as many as the declaration has. A name that is no array has rank 0, so a subscript on a scalar parameter, or in an equation on %maxrudi, %maxrudj or %maxrudk, is this error too: array '%maxrudi' has rank 0, but 1 subscripts were given.

Concerns: array, and the six equations x= to t3=.

E0208

Error. James prints error [E0208]: function 'name' <takes-clause>, but <n> were given.

A function is called with the wrong number of arguments. The message says how many it takes. Match the call to the def or to the built-in’s form.

Concerns: def.

E0209

Error. James prints error [E0209]: unterminated bracketed expression, opened here.

A [ has no closing ] before the file ends. Add the ].

Concerns: para, def.

E0210

Error. James prints error [E0210]: unterminated comment block, opened here (nesting depth <n>).

A { comment is never closed. Braces nest, so add one } for every { left open. The message gives the depth still open at the end of the file.

Concerns any script.

E0211

Warning. James prints warning [E0211]: <what> is not defined for these arguments; result is NaN.

An expression asks for an operation with no defined result, such as SQRT of a negative number or a division by zero. James continues with NaN. Check the arguments, which may come from a parameter.

Concerns: para, def.

E0212

Error. James prints error [E0212]: integer value <value> exceeds the supported range (+/-2147483647).

An integer is larger than 2147483647 in magnitude. James stores integers in 32 bits. Use a smaller value.

Concerns any command that takes an integer.

E0213

Error. James prints error [E0213]: value is not finite.

A number overflows double precision or an operation produced infinity. Look for a mistyped exponent.

Concerns any command that takes a number.

E0214

Error. James prints error [E0214]: array dimension <k> of '%name' must be a positive integer, got <d_k>.

An array dimension is zero, negative or not an integer. Every dimension counts subscripts from 1, so each must be a whole number of at least 1.

Concerns: array.

E0215

Error. James prints error [E0215]: array '%name' has <n> elements but <m> data values were given.

An array has an initializer list that is neither one value nor one value per element. Give one value to fill the array, or one for every element in Fortran order.

Concerns: array.

E0216

Error. James prints error [E0216]: parameter name '<name>' contains the reserved character '<c>'.

A name uses one of the characters James reserves for expressions: + , % * / ^ ( ) [ ] = & $. Remove it. The characters -, ., < and > are allowed.

Concerns: para, array, def.

E0217

Error. James prints error [E0217]: 'caption' expects 'cap', 'on', or 'off', got '<token>'.

The word after caption is not cap, on or off.

Concerns: caption.

E0218

Error. James prints error [E0218]: 'errmod' mode must be 0, 1, 2, or 3, got <mode>.

The mode after errmod is not 0, 1, 2 or 3.

Concerns: errmod.

E0219

Error. James prints error [E0219]: 'mxp' pass count must be a positive integer (minimum 1), got <value>.

The pass count after mxp is not a positive integer. Use 1 or more.

Concerns: mxp.

E0220

Error. James prints error [E0220]: 'intyp' option must be 1 (linear) or 2 (transfinite), got <value>.

The option after intyp is not 1 (linear) or 2 (transfinite).

Concerns: intyp.

E0221

Error. James prints error [E0221]: expression syntax error: <detail>.

An expression does not parse. The detail names the failure: an operand or ) missing at the end, an unexpected character, a % that begins no name (unexpected '%': a name starts with a letter or '_', for %1a), a function or name James cannot resolve, more than 32 arguments, too many items in a list, or nesting past 200 grammar levels, which is about 65 nested parentheses. Only the first error of an expression is reported. In a coordinate equation the message is prefixed by the equation’s name: error [E0221]: in 'x=': expression syntax error: unexpected end of expression.

Concerns: para, def, if, when, while, and the six equations x= to t3=.

Control statements

The codes E0300 to E0321.

E0300

Error. James prints error [E0300]: endif with no matching if.

An endif has no open if. Add the if or remove the endif.

Concerns: endif, if.

E0301

Error. James prints error [E0301]: endfor with no matching for.

An endfor has no open for. Add the for or remove the endfor.

Concerns: endfor, for.

E0302

Error. James prints error [E0302]: endwhen with no matching when.

An endwhen has no open when. Add the when or remove the endwhen.

Concerns: endwhen, when.

E0303

Error. James prints error [E0303]: endwhile with no matching while.

An endwhile has no open while. Add the while or remove the endwhile.

Concerns: endwhile, while.

E0304

Error. James prints error [E0304]: elseif after else in the same if statement.

An elseif follows the else of its if. Put every elseif before the else.

Concerns: elseif, else.

E0305

Error. James prints error [E0305]: elsewhen after else in the same when statement.

An elsewhen follows the else of its when. Put every elsewhen before the else.

Concerns: elsewhen, else.

E0306

Error. James prints error [E0306]: an if scope must be disjoint from every when, for, and while scope.

An if sits inside a when, for or while, or holds one. The if family must stay apart from the other three. Use when inside loops, or move the if outside them. James also prints a note that names the opener still open.

Concerns: if, when, for, while.

E0307

Error. James prints error [E0307]: control statement scopes must nest fully or not at all.

Two constructs overlap without one holding the other, for example a when closed while a for inside it is still open. Close the innermost construct first. James also prints a note that names the construct still open.

Concerns: when, for, while.

E0308

Error. James prints error [E0308]: break outside a for or while loop.

A break is outside every for and while. Move it into a loop or remove it.

Concerns: break.

E0309

Error. James prints error [E0309]: '<keyword>' must be alone on its line.

A control statement shares its line with other text. Give each control statement a line of its own.

Concerns: if, for, while, when.

E0310

Error. James prints error [E0310]: when/for/while nesting exceeds the limit of 64.

when, for and while constructs nest deeper than 64. Move the inner body into an include file or combine conditions.

Concerns: when, for, while.

E0311

Error. James prints error [E0311]: for loop increment must not be zero.

A for has an increment of zero, which has no trip count. Use a nonzero increment, or a while.

Concerns: for.

E0312

Error. James prints error [E0312]: loop exceeded the maximum of 1000000 iterations.

A loop ran one million times. Check its stopping condition.

Concerns: for, while.

E0313

Error. James prints error [E0313]: elseif with no matching if.

An elseif has no open if. Add the if or remove the elseif.

Concerns: elseif, if.

E0314

Error. James prints error [E0314]: elsewhen with no matching when.

An elsewhen has no open when. Add the when or remove the elsewhen.

Concerns: elsewhen, when.

E0315

Error. James prints error [E0315]: else with no matching if or when.

An else has no open if or when. Add the opener or remove the else.

Concerns: else.

E0316

Error. James prints error [E0316]: '<closer>' does not match the open '<opener>'.

A closer names a different family than the construct that is open, for example endfor closing a when. Use the closer of the open construct.

Concerns: endif, endwhen, endfor, endwhile.

E0317

Error. James prints error [E0317]: '<keyword>' requires a trailing then.

An if, elseif, when or elsewhen has no then after its closing parenthesis. Add it.

Concerns: if, elseif, when, elsewhen.

E0318

Error. James prints error [E0318]: while must not be followed by then.

A while is followed by then. Remove it.

Concerns: while.

E0319

Error. James prints error [E0319]: '<opener>' is not closed with '<closer>'.

A construct is still open at the end of the file or of its enclosing body. Add the closer the message names. An inner construct left open can swallow the closer meant for an outer one.

Concerns: if, when, for, while.

E0320

Error. James prints error [E0320]: if nesting exceeds the limit of 64.

if constructs nest deeper than 64. Move the inner branch into an include file or combine conditions with .and. and .or..

Concerns: if.

E0321

Error. James prints error [E0321]: while cannot be embedded in another command.

A while sits inside another command’s arguments. A while must stand alone and repeat whole commands. Use for or when to repeat part of a command.

Concerns: while.

Parts and phases

The codes E0400 to E0420.

E0400

Error. James prints error [E0400]: i-index list entry -2 under partmode i must be a positive element count, naming the list and the entry.

Under partmode i an index list holds element counts, which are positive. A negative entry is a shell partition and a 0 a gap only in the standard mode’s node indices, so write the part under partmode s to have either. Until version 0.6.0 this code refused every shell partition; James now builds them.

Concerns: block, cylinder, partmode.

E0401

Error. James prints error [E0401]: <i|j|k>-index list must start with 1 or -1.

The first entry of an index list is not 1 or -1. Start every list with 1, or with -1 for a shell partition.

Concerns: block, cylinder.

E0402

Error. James prints error [E0402]: <i|j|k>-index list entry <n> does not exceed the magnitude of an earlier entry.

After the first entry, an index list entry is neither 0 nor larger in magnitude than every entry before it. Put the entries in increasing order.

Concerns: block, cylinder.

E0403

Error. James prints error [E0403]: <x|y|z>-coordinate list has <m> values, expected <n> to match the <i|j|k>-index list.

A coordinate list does not have one value for every entry of its index list, counting the zero entries. Add or remove values until the counts match.

Concerns: block, cylinder.

E0404

Error. James prints error [E0404]: <de|dei> region reduced index <n> is outside the part (1 to <max>).

A de or dei region names a reduced index outside the part. Correct the index, or add the partition with insprt.

Concerns: de, dei.

E0405

Error. James prints error [E0405]: insprt <argument> is invalid: <detail>.

An argument of insprt is out of range: the sign must be 1 or -1, the type 1 to 6, the index inside the list and the element count positive. The message names the argument.

Concerns: insprt.

E0406

Error. James prints error [E0406]: mseq <detail>.

The mseq command is malformed. The direction must be i, j or k, there must be one count for each existing region in that direction, and every resulting count must be positive. The message gives the detail.

Concerns: mseq.

E0407

Error. James prints error [E0407]: lmseq <detail>.

The lmseq command is malformed. The direction must be i, j or k, the partition must have a region to its right, and the resulting count must be positive. The message gives the detail.

Concerns: lmseq.

E0408

Error. James prints error [E0408]: '<mseq|lmseq>' not allowed after update or an equation for this part, the command’s name in quotes.

An mseq or lmseq follows an update in its part. James accepts mseq and lmseq after a coordinate equation: the equation runs at step 20 over the part’s lists as they stand at the end, and TrueGrid’s own examples issue mseq after a z=. Today James refuses update with E0100, so this message cannot yet appear.

Concerns: mseq, lmseq.

E0409

Error. James prints error [E0409]: meshscal must precede every part.

A meshscal comes after a part has begun. Move it to the top of the script.

Concerns: meshscal.

E0410

Error. James prints error [E0410]: merge has no effect in the Merge phase.

A merge is read while James is already in the Merge phase. Remove it.

Concerns: merge.

E0411

Error. James prints error [E0411]: <endpart|control|abort> is only legal in the Part phase.

An endpart, control or abort is read with no part open. Remove it, or move it after the block or cylinder it closes.

Concerns: endpart, control, abort.

E0412

Error. James prints error [E0412]: command '<name>' is not legal in the <Control|Part|Merge> phase.

A command is read in a phase where it is not allowed. Move it to the phase that allows it, or open or close a part first.

Concerns every command; each page’s “When James applies it” names its phase.

E0413

Error. James prints error [E0413]: i-index list has a gap that does not lie between two partitions, naming the list.

A 0 in an index list is a gap, the slab between the partitions on either side of it, which holds no element. A 0 that ends a list, or follows another 0, has no two partitions to stand between. Until version 0.6.0 this code refused every gap; James now builds them.

Concerns: block, cylinder.

E0414

Error. James prints error [E0414]: meshscal scale must be a positive integer.

The scale after meshscal is not a positive integer.

Concerns: meshscal.

E0415

Error. James prints error [E0415]: partmode mode must be s or i.

The mode after partmode is not s or i.

Concerns: partmode.

E0416

Warning. James prints warning [E0416]: part <n> was still open at end; closed as if by endpart, or warning [E0416]: part <n> was still open at end of input; closed as if by endpart.

A part is still open when end or the end of the input is read. James closes it as if by endpart and goes on. Add the endpart, control, merge or abort you meant. The message says whether the part was open at end or at the end of input.

Concerns: end, endpart.

E0417

Error. James prints error [E0417]: part #<n> has <k> nodes with a coordinate that is not finite, or has 1 node for one.

A node of the part ended its hierarchy with a coordinate that is an infinity or not a number, which a transformation that overflowed the range of a double produces, for example two csca 1e200. James finds it while it meshes, before any merge, so the line carries its code and the part’s position, the run exits with code 1 and no file is written. The number after # is the part’s position in the script, counted from zero. Reduce the scale or the transformation.

Concerns: tr, tri, block, cylinder.

E0418

Error. James prints error [E0418]: 'de' names reduced index 3 in i, which is a gap, naming the command, the index and the direction, or error [E0418]: 'insprt' would insert a partition inside a gap.

A 0 in an index list takes a reduced index but makes no partition: no nodes lie at it, so a region, a vertex, a progression or insprt that names it names nothing. Name the partition on either side; a region whose bounds lie on both sides of a gap is legal, and the slab inside it holds nothing.

Concerns: every command that takes a region, a vertex or a progression; insprt.

E0419

Error. James prints error [E0419]: 'mseq' is not supported in this version of James on a part with a gap in i, naming the command and the direction.

mseq and lmseq change the element count of a direction’s regions, and no page of the manual says whether a gap’s slab is one of them. On a part with a gap in that direction James refuses them; write the counts in the block list itself. On a list with shell partitions and no gap both commands work and keep the signs.

Concerns: mseq, lmseq.

E0420

Note. James prints note [E0420]: '<cmd>' follows an equation of this part that reads an index; the equation reads the indices of the final lattice, naming mseq, lmseq or insprt.

A coordinate equation of the part reads i, j or k, and then mseq, lmseq or insprt changes the lattice. The equation runs at step 20, after the lattice is final, so it reads the indices of the lattice as the fold or the insertion left it, wherever the equation stands in the script. TrueGrid’s own examples issue mseq only after an equation that reads no index, and TrueGrid’s manual warns against the order. The note tells you so, and the run goes on: it is neither counted in the summary line nor a change to the exit code. Write the equation’s index expressions for the lattice the command leaves; writing the command before the equation gives the same mesh without the note.

Concerns: mseq, lmseq, insprt, x=.

Vertices

The codes E0500 to E0506.

E0500

Error. James prints error [E0500]: reduced index <n> is outside the part's <i|j|k> range 1-<max>.

A reduced index in a vertex region or in q is larger than the part has partitions in that direction. A reduced index counts list entries, not node numbers. In ma and pa a reduced index of 0 is refused too: a 0 in a region stands for the whole direction, but a vertex is one node.

Concerns: pb, mb, mbi, tr, q, ilin, ma, pa.

E0501

Error. James prints error [E0501]: '<token>' is not a coordinate component (expected x, y, z, xy, xz, yz, or xyz).

The coordinate keyword is not one of x, y, z, xy, xz, yz or xyz. The letters keep that order.

Concerns: pb, mb, mbi.

E0502

Error. James prints error [E0502]: '<keyword>' takes <n> value(s), got <m>.

A coordinate keyword is followed by the wrong number of values: one per letter in the keyword.

Concerns: pb, mb, mbi.

E0503

Error. James prints error [E0503]: malformed transformation operator '<token>', or error [E0503]: coordinate type 'pt' is not supported in this version of James, or error [E0503]: transformation operator '<op>' is not supported in this version of James.

A transformation list holds an operator James does not read. The message says which of three cases it is: a malformed operator, the coordinate type pt, or one of the five operators tf, ftf, rxy, ryz and rzx, which James refuses.

Concerns: tr, tri.

E0504

Error. James prints error [E0504]: raxis direction vector has zero length.

A raxis operator has a direction vector of length zero. Give a nonzero direction.

Concerns: tr, tri.

E0505

Error. James prints error [E0505]: q requires two vertices (i j k i j k), not a region.

The q command was given six numbers that read as a region. Give two vertices, three reduced indices each, target first.

Concerns: q.

E0506

Error. James prints error [E0506]: pbs label '<point_id>' does not name a defined point.

A pbs label names no point James holds. James refuses pbs, so this message belongs to a later milestone.

Concerns no command James runs, because pbs is refused with E0100.

Edges and curves

The codes E0600 to E0609.

E0600

Error. James prints error [E0600]: <command> region must be an edge, got <kind>.

The region of a curve or edge command is not a single mesh edge. Give a region in which exactly two of the three index pairs coincide. The message names what the region is: a vertex, a face or a block.

Concerns: cur, curf, cure, curs, edge.

E0601

Error. James prints error [E0601]: 3D curve <n> is not defined.

A command refers to a 3D curve number that no curd defined. Define the curve first, or correct the number.

Concerns: cur, curf, cure, curs, curd.

E0602

Error. James prints error [E0602]: <type> needs at least 2 points, got <n>.

An lp3 or csp3 curve has fewer than two points. Give at least two (x, y, z) triplets.

Concerns: curd.

E0603

Error. James prints error [E0603]: curd type '<type>' is not supported in this version of James.

A curd names a 3D curve type James does not build. James builds lp3, csp3, arc3 and sdedge.

Concerns: curd.

E0604

Error. James prints error [E0604]: <command> <s>.<e> is not a valid surface edge, <command> being edge or sdedge.

An edge command, or the sdedge type of curd, names a surface that is not defined, or an edge number outside 1 to 4. Define the surface with sd first. A number inside 1 to 4 that the surface’s kind lacks (side 3 of a surface of revolution, any side of a plane) passes this check and is refused later, when the engine builds the geometry or meshes, with a line that carries no code and names the surface, its kind and its number of sides.

Concerns: edge, curd, sd.

E0605

Error. James prints error [E0605]: <type> coordinate count <n> is not a multiple of 3.

The numbers of an lp3 or csp3 list are not a multiple of 3. Give whole (x, y, z) triplets.

Concerns: curd.

E0606

Error. James prints error [E0606]: csp3 option '<option>' is not recognized, or error [E0606]: csp3 option '<option>' expects <expected> argument(s), got <n>.

A csp3 option is neither loop nor one of the sixteen two-digit derivative codes, or it has the wrong number of arguments for its code. The message says which of the two.

Concerns: curd.

E0607

Error. James prints error [E0607]: splint derivative_flag '<flag>' is not recognized, or error [E0607]: splint derivative_flag '<flag>' expects <expected> derivative vector(s), got <n>.

A splint flag is not one of 00, 10, 01 and 11, or the number of derivative vectors does not match the flag. The message says which of the two.

Concerns: splint.

E0608

Error. James prints error [E0608]: curd carries more than one type group; this version of James accepts one.

A curd holds a second type group. James reads one group per curd. Use a second curd for the second curve.

Concerns: curd.

E0609

Error. James prints error [E0609]: arc3 option '<word>' is not seqnc, cmplt or whole, or error [E0609]: arc3 points are collinear or coincide.

An arc3 curve cannot be built. Either the option is none of the three, seqnc for the arc through the second point from the first to the third, cmplt for the rest of that circle and whole for the full circle, or the three points lie on a line or coincide, so no circle passes through them. The message says which. The option message points at the option, the other at arc3.

Concerns: curd.

Interpolation

The codes E0700 and E0701.

E0700

Error. James prints error [E0700]: region names a single vertex, which has no meaning for lin/lini.

A lin or lini region is a single vertex, which linear interpolation cannot act on. Use a region with an extent, or set the vertex with pb.

Concerns: lin, lini.

E0701

Error. James prints error [E0701]: region is an edge or a vertex, but tf/tfi requires a face or a solid block.

A tf or tfi region is an edge or a vertex. Transfinite interpolation needs a face or a block. Use lin for an edge.

Concerns: tf, tfi.

Projection

The codes E0800 to E0808.

E0800

Error. James prints error [E0800]: surface <ref> is not defined.

A command refers to a surface number or name no sd defined. Define the surface first.

Concerns: sf, sfi, ms.

E0801

Error. James prints error [E0801]: <command> surface type '<type>' is not supported in this version of James.

An inline surface in sf, sfi or ms has a type James does not build: nurbs, igess, igesp, function, csps, bsps, nrbs, hermite, mesh, face, faceset, poly, stl or bstl. Every other surface type, the bounded kinds among them, may be written inline. Use a type James builds, or define the surface with sd.

Concerns: sf, sfi, ms.

E0802

Error. James prints error [E0802]: patch region must be a face, got <kind>.

The region of patch is not a single face. Give a region in which exactly one of the three index pairs coincides. A face on a surface that has not four sides is refused later, by the engine, with a line that carries no code; the engine’s messages give it.

Concerns: patch.

E0803

Error. James prints error [E0803]: node at <i,j,k> has <n> surface constraints, more than the 3 James supports.

A node is constrained by more than three surfaces. Combine the extra surfaces in one sds surface, or remove the redundant constraint. The message gives the node’s three full indices.

Concerns: sf, sfi, sds.

E0804

Error. James prints error [E0804]: spp template <id> is not defined.

An spp names a template no tmplt made. James refuses tmplt, so every spp ends here.

Concerns: spp.

E0805

Error. James prints error [E0805]: spp template <id> has <m> nodes where the target region has <n>.

The template of an spp has a different node count than the target region. Rebuild one of them. James cannot reach this message today, because spp always stops at E0804.

Concerns: spp.

E0806

Error. James prints error [E0806]: ms lists <m> surfaces for <n> faces in the i|j|k direction.

The number of surfaces an ms lists does not equal the number of faces its region holds along the index direction. Add or remove surfaces, or change the region.

Concerns: ms.

E0807

Error. James prints error [E0807]: sf/sfi region is a block; projection applies to a vertex, an edge or a face.

An sf or sfi region is a block. Projection acts on a vertex, an edge or a face. Narrow the region, or issue one command per face.

Concerns: sf, sfi.

E0808

Error. James prints error [E0808]: 'ms' region has no extent in the j direction, so it holds no face across i.

An ms region has no extent in one of the two directions across its index direction, so it holds no face. The message names the direction without extent and the index direction. Give the region an extent in both.

Concerns: ms.

Spacing

The codes E0900 to E0905.

E0900

Error. James prints error [E0900]: region has no length in the <i|j|k> direction.

A spacing region, or a splint region, has no length in the direction named: its two reduced indices there are equal. Choose the direction that varies across the edge.

Concerns: res, drs, as, das, nds, splint.

E0901

Error. James prints error [E0901]: spacing ratio must be a positive number.

A res or drs ratio is zero or negative. Use a ratio above zero; 1.0 spaces the nodes equally.

Concerns: res, drs.

E0902

Error. James prints error [E0902]: spacing element size must be a positive number.

An as size or a das gap is zero or negative. Use a value above zero.

Concerns: as, das.

E0903

Error. James prints error [E0903]: das gap1 + gap2 exceeds the edge's total arc length.

The two gaps of a das add up to more than the edge is long. James raises this error while it meshes, so it carries its code and a file position, and the run exits with code 1 and writes no mesh. Shorten the gaps or use a longer edge.

Concerns: das.

E0904

Error. James prints error [E0904]: nds density function <density> is not defined.

An nds names a density function no ndd defined. Every nds that names an undefined density raises this message. James refuses ndd in this version, so no density is ever defined, and every well-formed nds ends here.

Concerns: nds.

E0905

Error. James prints error [E0905]: nds density function data does not match the edge.

The data of an nds density function does not fit the edge. James cannot reach this message today, because it refuses ndd.

Concerns: nds.

Surfaces and 2D curves

The codes E1000 to E1014.

E1000

Error. James prints error [E1000]: sds argument <si> is not a defined surface, or error [E1000]: intp argument <si> is not a defined surface for the two surfaces of an intp.

An sds composite or an intp surface lists a surface number no sd defined. Define the surface first, or correct the number.

Concerns: sd.

E1001

Error. James prints error [E1001]: <type> argument <n> is not a defined 2D curve.

A surface of a kind that is built from a 2D curve (crx, cry, crz, cr, cp, rule2d or swept) names a 2D curve that no ld or lcc defined. <type> is the kind, and <n> the curve’s number as written (without its sign for rule2d, whose negative number reverses a curve). Define the curve first.

Concerns: sd, ld, lcc.

E1002

Error. James prints error [E1002]: lp2 needs at least 2 points, got <n>, or error [E1002]: lp2 argument count <m> is not a multiple of 2.

An lp2 curve has fewer than two points, or an odd count of numbers. Give at least two (x, z) pairs. The message says which of the two.

Concerns: ld.

E1003

Error. James prints error [E1003]: lar has no point to start from, or error [E1003]: lar radius <radius> is too small for chord length <d>.

An lar arc cannot be built. Either the curve has no point yet to start from, so begin with lp2, or the radius is smaller than half the distance to the end point, so enlarge it. The message says which.

Concerns: ld.

E1004

Error. James prints error [E1004]: sd type '<type>' is not supported in this version of James.

An sd names a surface type James does not build: nurbs, igess, igesp, function, csps, bsps, nrbs, hermite, mesh, face, faceset, poly, stl or bstl. James builds the other 36 types of the manual’s list, with the spellings cyli, sphe, plane, xzplan, toru and iplane, and James’s own torus; the page of sd lists them.

Concerns: sd.

E1005

Error. James prints error [E1005]: sd type '<type>' radius <radius> must be positive.

A radius of a cylinder, a sphere, an ellipsoid (er), a torus (ts) or a pipe is zero or negative. A kind with two radii (er, ts) or a list of them (pipe) names the one that fails. Use a positive radius.

Concerns: sd.

E1006

Error. James prints error [E1006]: cone angle <θ> must be strictly between -90 and 90 and not 0.

A cone angle is 0 or outside -90 to 90 degrees. Use an angle strictly between -90 and 90 that is not 0.

Concerns: sd.

E1007

Error. James prints error [E1007]: cone radius <r> must not be negative.

A cone radius is negative. Zero is allowed and puts the apex at the axis point.

Concerns: sd.

E1008

Error. James prints error [E1008]: sd name '<name>' must contain an alphabetic character and no spaces.

An sd name must hold at least one letter and no space, so 3 and my surface are refused. Rename the surface, or leave the name out.

Concerns: sd.

E1009

Error. James prints error [E1009]: ld segment type '<type>' is not supported in this version of James.

An ld names a 2D curve segment type James does not build. James builds lp2 (and lp) and lar.

Concerns: ld.

E1010

Error. James prints error [E1010]: sd type '<type>' points are coincident for pl2 and cyr2, or error [E1010]: sd type '<type>' points are collinear for pl3, pl3o, cy3 and cyr3.

The points of a surface cannot fix it: two that coincide give no normal and no axis, and three on one line give no plane and no circle. A repeated point counts as collinear. The message points at the type. Give distinct points, and three that do not lie on a line.

Concerns: sd.

E1011

Error. James prints error [E1011]: cn2p needs r1 different from r2 and t1 different from t2, error [E1011]: pr needs three different t values or error [E1011]: r3dc needs an end angle different from its begin angle.

The parameters of a cn2p cone, a pr paraboloid or an r3dc surface of revolution do not fix the surface. Change the points so that the values the message names differ; for cn2p with equal radii, write the cylinder with cy.

Concerns: sd.

E1012

Error. James prints error [E1012]: a point system must be rt, cy or sp, got '<word>'.

A point of pl2, pl3, pl3o or arc3 begins with a word that is not one of the three coordinate systems: rt x y z for Cartesian, cy rho theta z for cylindrical and sp rho theta phi for spherical coordinates, the angles in degrees. A labeled point (pt) is refused here too, since James has no display to label points on. Write the coordinates.

Concerns: sd, curd.

E1013

Error. James prints error [E1013]: <type> fraction <v> must lie between 0 and 1, naming swept or pipe, or error [E1013]: swept direction must be r or l, got '<word>'.

A swept cross section or a pipe radius is placed at a fraction of the curve’s length, which runs from 0 at its start to 1 at its end, ends included; a swept surface takes its sections on the base curve’s right (r) or left (l) side. Give a fraction from 0 to 1, and r or l.

Concerns: sd.

E1014

Error. James prints error [E1014]: <type> argument <n> is not a defined 3D curve.

A surface built from 3D curves (rule3d, crule3d, pipe, blend3, blend4 or r3dc) names a curve that no curd defined. <n> is the number as written, without its sign for rule3d and crule3d, whose negative number reverses a curve. Define the curve first.

Concerns: sd, curd.

Merge and output

The codes E1100 to E1106.

E1100

Error. James prints error [E1100]: 'write' is only legal in the Merge phase.

A write is read before the first merge. Move it after the merge.

Concerns: write.

E1101

Error. James prints error [E1101]: 'write' has no output format chosen.

A write is read and no output format was chosen by a script command or by --format. Add a format command before it, neutral, exodusii, lsdyna keyword, abaqus or dyna3d, or pass --format with neutral, exodus, lsdyna, abaqus or dyna3d.

Concerns: write, neutral, exodusii, lsdyna, abaqus, dyna3d.

E1102

Error. James prints error [E1102]: 'verbatim' block is not closed with 'endverbatim'.

A verbatim block has no endverbatim before the input ends. Add the closing line.

Concerns: verbatim.

E1103

Error. James prints error [E1103]: '<cmd>' requires a numeric tolerance argument.

The tolerance after st, stp, t or tp is missing or is not a number. Give a number, a %name that holds one, or a [expression].

Concerns: st, stp, t, tp.

E1104

Warning. James prints warning [E1104]: 'exodusii' replaces the output format 'neutral' chosen earlier; the later command governs.

A script names one output format and then a different one, with neutral, exodusii, lsdyna keyword, abaqus or dyna3d, before any write has used the first choice. The later command governs and the earlier choice is dropped. Naming the same format twice is silent, and so is switching format after a write. Delete the command that names the format you do not want.

Concerns: abaqus, dyna3d, exodusii, lsdyna, neutral.

E1105

Error. James prints error [E1105]: 'lsdyna fixed' is not supported in this version of James; use 'lsdyna keyword'.

lsdyna was given the type fixed, the structured input of older LS-DYNA releases, which James does not write. The format in force stays what it was. Write lsdyna keyword.

Concerns: lsdyna.

E1106

Error. James prints error [E1106]: the dyna3d format holds at most <limit> <what>; this write has <count>, where <what> is materials, nodes or elements and <limit> is 99999 for materials and 99999999 for the other two.

A DYNA3D deck has fixed columns: five for a material number, eight for a node or element number. The mesh of this write has more than fits. James finds it at the write, before it opens the file, so the line carries its code and the position of the write, the run exits with code 1 and nothing is written. Choose another format, or lower the material numbers or the mesh size.

Concerns: dyna3d, write.

Materials

The codes E1200 to E1202.

E1200

Error. James prints error [E1200]: '<cmd>' material number must be a positive integer, got <value>, where <cmd> is mate, mt or mti.

The material number is missing, is not a number, is not an integer, is below 1 or is above 2147483647. James prints got the end of the line when the number is missing at the end of a line, and got end of input when it is missing at the end of the file. A material number is a positive integer at most 2147483647. Give one.

Concerns: mate, mt, mti.

E1201

Error. James prints error [E1201]: <cmd> region reduced index <n> is outside the part (1 to <max>), where <cmd> is mt or mti.

A reduced index of the region, or of a region the progression expands to, lies outside the part’s list in that direction. The region is dropped. Use indices from 1 to the number of entries of the list, or 0 for an extreme.

Concerns: mt, mti.

E1202

Warning. James prints warning [E1202]: '<cmd>' region <imin> <jmin> <kmin> <imax> <jmax> <kmax> holds no element.

mt and mti set the material of the solid elements in a block region and of the shell elements in a face on a shell partition. This region is neither: it is an edge, a vertex or a face on a positive partition, so it holds no solid and no shell element. James keeps the row and assigns nothing. Name a block region for solids or a face on a shell partition (a negative entry of the part’s list) for shells.

Concerns: mt, mti.

Smoothing

The codes E1300 to E1305.

E1300

Error. James prints error [E1300]: '<cmd>' region must be a face or a solid block, got an edge or got a vertex, where <cmd> is relax, relaxi, tme or tmei.

A smoother moves the interior nodes of a face or of a solid block, and an edge or a vertex has no interior of that kind. For a progression, James names the first region of the expansion that is an edge or a vertex, and the command stores nothing. Widen the region to a face or a block; to lay out an edge, use lin or a spacing command.

Concerns: relax, relaxi, tme, tmei.

E1301

Error. James prints error [E1301]: 'relax' smooths a list of regions together only when every one is a face; region <n> is a solid block, where <n> counts the list from 1.

A relax list joined by & is smoothed as one system, the edges and corners its faces share included, and such a list holds faces only. One block on its own is accepted. List the faces alone, and give the block a relax of its own.

Concerns: relax.

E1302

Error. James prints error [E1302]: '<cmd>' iteration count must be a positive integer, got <value>, where <cmd> is relax, relaxi, tme or tmei.

The iteration count is missing, is not a number, is not an integer, is below 1 or is above 2147483647. James prints the count as you wrote it, even on a line of its own; it prints got the end of the line when a word that is not a number begins the next line, and got end of input when the file ends. A fraction such as 1.5 is refused rather than cut to an integer. A & after the region of tme, or after the progression of relaxi or tmei, where the count should begin, is E0104 instead, since it begins a list the command does not take. Give the largest number of iterations to run.

Concerns: relax, relaxi, tme, tmei.

E1303

Error. James prints error [E1303]: '<cmd>' min_change must be zero or greater, got <value>, where <cmd> is relax, relaxi, tme or tmei.

The tolerance that ends the run early is negative. It is a distance in the part’s own coordinates: the run stops after the first iteration in which no coordinate moved by more than it. Zero is accepted; it ends the run early only if an iteration moves no node at all. A missing tolerance, or a word in its place, is E0104.

Concerns: relax, relaxi, tme, tmei.

E1304

Error. James prints error [E1304]: '<cmd>' weight must be greater than 0 and at most 1, got <value>, where <cmd> is relax, relaxi, tme or tmei.

The weight blends a node’s old position with the new one in each iteration: 1 takes the new position, a smaller weight moves the node part of the way. A weight of 0 or below would never move a node, and one above 1 would overshoot and make the iterations diverge. Give a weight above 0 and at most 1; 1 suits most meshes. A missing weight, or a word in its place, is E0104.

Concerns: relax, relaxi, tme, tmei.

E1305

Error. James prints error [E1305]: '<cmd>' region holds a deleted element; tme smooths a region with no hole, where <cmd> is tme or tmei.

The region has a hole: an element inside the block was deleted, or a quadrilateral of the face has no element left on either side of it. Thomas-Middlecoff smoothing takes the region’s outer boundary as its only boundary and cannot work around a hole. James finds it while it meshes, so the line carries its code and the position of the tme or tmei, the run exits with code 1 and writes no mesh. Smooth the region with relax, which treats the edge of a hole as boundary, or split the region around the hole.

Concerns: tme, tmei.

Shells

The codes E1400 to E1405.

E1400

Error. James prints error [E1400]: 'thic' thickness must be a positive number, got 0, naming the command and the value, or got the end of the line when it is missing.

A shell thickness is a length a solver divides by. Give thic, th or thi a number above zero.

Concerns: thic, th, thi.

E1401

Error. James prints error [E1401]: 'orpt' mode must be +, -, off or flip, got up or error [E1401]: 'orpt' expects three coordinates after +, got the end of the line.

orpt has four forms: + x y z, - x y z, off and flip. The sign is a word of its own, with a space before the first coordinate: -5 is one number.

Concerns: orpt.

E1402

Warning. James prints warning [E1402]: 'th' region 1 1 1 2 2 2 holds no shell element, naming the command and the region.

n, th, thi, ssf and ssfi act on the shell elements of a region, the shells whose four corners lie in it, and this region has none. A region holds a shell when a shell partition (a negative entry of the part’s lists) lies inside it and its span in each of the other two directions holds a cell with an element over it, so the shell plane has area inside it: a face on a shell partition does, and so does a block across one. A block short of every shell partition, a face on a positive partition, an edge, a vertex and a face on a shell partition whose span in the plane lies wholly inside a gap’s slab do not. The command is kept, and the engine sets nothing with it. Name a face on a shell partition, or widen the block to take one in. For ssf and ssfi a block region is E0807 first, so this warning reaches them for an edge, a vertex or a face on a positive partition. A region whose only shells were deleted with de passes without the warning and sets nothing.

Concerns: n, th, thi, ssf, ssfi.

E1403

Error. James prints error [E1403]: 'sd' intp fraction must lie between 0 and 1, got 1.5, naming the command that reads the surface: sd, or sf, sfi or ms for an intp written inline, as in error [E1403]: 'sfi' intp fraction must lie between 0 and 1, got 1.5.

An intp surface lies a fraction of the way from its first surface to its second. Give a fraction between 0 and 1; both ends are allowed.

Concerns: sd, sf, sfi, ms.

E1404

Error. James prints error [E1404]: 'cycorsy' applies to a cylinder part; part 1 is a block part.

cycorsy sets the frame of reference of a cylinder part. A block part is placed with tr and tri.

Concerns: cycorsy.

E1405

Error. James prints error [E1405]: 'ssfi' surface 1 must be of type intp, naming the command and the surface.

ssf and ssfi place shell nodes on an intp surface and take the thickness from the two surfaces it lies between, so only an intp surface will do. Define one with sd n intp sd1 sd2 fraction, or project with sf and sfi, which take any surface.

Concerns: ssf, ssfi.

Equations

The codes E1500 to E1503.

E1500

Error. James prints error [E1500]: 'x=' cannot be compiled: function 'f' cannot take an argument that depends on the node, or ... cannot be compiled: the program has more than 2048 instructions, or ... cannot be compiled: the program needs more than 256 stack slots, naming the equation (x=, y=, z=, t1=, t2= or t3=).

The text of the equation parses, but James cannot turn it into a program it runs at every node. A function made with def can be called with constants but not with a value that changes from node to node (a coordinate, an index, a temporary or an array subscripted by the node): write the function’s body into the equation instead. A program of more than 2048 instructions, or one that needs more than 256 places on its stack at once, is past James’s limits (TrueGrid’s own limit is 240 items, so a script that fits there fits here): split the expression across the temporaries t1=, t2= and t3=. A text that does not parse at all is E0221, with the equation’s name before the detail. The equation is dropped and the run exits with code 1.

E1501

Warning. James prints warning [E1501]: 't1=' met 4 illegal operations; the first at node (1, 1, 1) of part #0, or met 1 illegal operation for one, naming the equation, the count, the node’s full indices and the part’s position counted from zero.

An equation runs at every node of its region, and at some of them it divided by zero, took the square root or the logarithm of a number outside the function’s domain, or the like. James substitutes NaN for the result of each illegal operation, as E0211 does, counts them, and prints one warning for the equation after it has run, not one line per node. An operation on an infinity that has no value, such as the difference of two infinities, infinity times zero, or the sine of an infinity, counts too, though outside an equation it gives NaN without a warning. Guard the operation, restrict the equation with dom, or check the geometry at the first node named. When the equation was x=, y= or z= and the NaN reached a coordinate, E1502 follows.

E1502

Error. James prints error [E1502]: 'x=' gives a value that is not finite at 4 nodes of part #0; the first is (1, 1, 1), or at 1 node for one.

After x=, y= or z= has run over its region, some node holds a coordinate that is NaN or infinite. A mesh with such a coordinate is no mesh, so James stops there, names the equation, the count, the first node and the part, exits with code 1 and writes no mesh. A temporary (t1=, t2=, t3=) may hold NaN; the equation that reads it into a coordinate is the one that fails. A coordinate that is not finite for another reason is E0417.

E1503

Error. James prints error [E1503]: 'x=' reads '%height(3, 1)' outside the array at node (3, 1, 1) of part #0, naming the equation, the array with its subscripts at that node, the node’s full indices and the part.

An equation read an element of an array whose subscripts depend on the node, such as x=x+%height(i,j), and at this node a subscript is below 1 or above the size the array was declared with. The subscripts are truncated to integers and printed as integers, or as the real value when a subscript is not finite or lies outside the integer range: '%h(NaN, 1)'. Declare the array large enough for the part’s full indices, or restrict the equation with dom to the nodes the array covers. A subscript written as constants is checked when the equation is read, as E0206.

Messages from the engine

The engine meshes the parts, merges their nodes and writes the files. Its lines carry no code, with seven exceptions: E0903, E0417, E1106, E1305, E1501, E1502 and E1503. James prints these with their codes, file:line:column: error [E0903]: ..., and exits with code 1, except E1501, which is a warning. E0903 is a das whose gaps exceed the edge, found while the engine meshes. E0417 is a part with a coordinate that is not finite. E1106 is a mesh beyond the DYNA3D deck’s fields. E1305 is a tme region with a hole, found when the engine reaches the command. E1501, E1502 and E1503 come from the coordinate equations at step 20: illegal operations counted, a coordinate left not finite, an array read outside its bounds. The entries for E0903, E0417, E1106, E1305, E1501, E1502 and E1503 are in their families above.

Every other engine line has the form file:line:column: warning: text or file:line:column: note: text. The position is the command that caused the line: the part’s opening command, the de that selects nothing, or the write or tolerance command that governs a merge. A line about the run as a whole, such as the count of lines not recorded or the summary, has no position and reads james: severity: text.

Warnings.

James prints these and goes on. Each counts in the summary line.

  • part #<n> has <k> elements with a negative Jacobian, or has 1 element for one. The number after # is the part’s position in the script, counted from zero. A coordinate list that decreases, or an interpolation that folds, inverts elements. James reports the count once per part and writes the elements as they are. A part inverted as a whole is not warned about: James writes it right-handed, with its corners reordered, and prints a note (below).
  • part #<n> has <k> elements with zero volume after merging, or has 1 element. A merge collapsed these elements onto shared nodes so that all eight corner triple products vanish. James writes them as they are.
  • part #<n> has <k> shells folded or collapsed after merging, or has 1 shell; when no tolerance command ran a merge, part #<n> has <k> shells folded or collapsed, without the words after merging, as a shell can be degenerate from the part’s own construction (an insprt skin over a plane that crosses the collapsed slab, say). After every merge, and after a write that ran none, James tests each shell’s four corner normals against their sum: one that opposes the rest is a fold, and a shell with no corner normal at all is collapsed to a line or a point. A shell with two corners on one node is a triangle, which is legal and not counted. James writes the counted shells as they are, before the part’s zero-volume line.
  • <k> shells have a corner of zero thickness; thic, th, thi, ssf or ssfi gives one, or 1 shell has. A shell counts when any one of its four corners has thickness zero: no command gave it a thickness, or an ssf chord came out zero at a corner where its two surfaces meet. The file carries the zero, which a solver refuses. The line is printed once per merge, at the write.
  • <k> nodes of the nodal thickness table take the mean of thicknesses their shells disagree on in <file>, or 1 node ... takes. In an Abaqus deck the shells whose corners differ carry their thickness in a *NODAL THICKNESS table, one value per node; where two shells give a node values more than 64 units of the last place apart the table holds their mean, and closer values count as one and the table holds the first.
  • part #<n> has <k> shell element(s) whose normal is at right angles to the line to the orientation point; each keeps its default side. n under orpt + or orpt - could not tell which side of such an element faces the point. The element keeps the side its corner order gives.
  • part #<n> has no active element, so its <k> nodes are not written; --write-unref-nodes writes them. Every element of the part was deleted, or the part never had one. James writes no node of the part unless you pass --write-unref-nodes.
  • de region <imin> <jmin> <kmin> <imax> <jmax> <kmax> selects no element. The region holds a face, an edge or a vertex but no element, so the deletion changes nothing. A dei whose progression produces such a region raises the same warning. A block region whose every element is already deleted raises it too, so a second identical de warns.
  • the title is longer than <w> characters and was cut in <file>. <w> is the width the title was held to: 80, 79 for a title that begins with a keyword character, and 72 in a DYNA3D deck. Every file but the neutral one cuts the title and drops the rest.

Notes: the merge report.

A tp or stp governing a write makes James report the merge. The first line gives the total and the lines after it give one count per pair of parts that merged nodes:

input.tg:9:1: note: 9 nodes were deleted by tolerancing
input.tg:9:1: note: 9 nodes merged between parts 1 and 2

The part numbers in these lines are the part numbers of the script, counted from one, with the survivor’s part first. A pair of equal numbers is a merge inside one part. A count of one reads 1 node was deleted and 1 node merged. A merge that finds nothing to merge prints 0 nodes were deleted by tolerancing. The commands t and st print no report. James prints the report after the file is written and closed, so a write that fails prints no report.

Notes: an inverted part.

file:line:column: note: part #<n> is inverted; its <k> elements are written with their corners reordered, or its 1 element is written with its corners reordered for one. Every active element of the part is inverted, so James reorders the corners of the whole part and writes it right-handed. A part with only some inverted elements keeps the warning above.

Errors.

An error from the engine reads file:line:column: error: text, or james: error: text when it has no place in the script, and stops the run with exit code 2. A file an earlier write of the same run produced stays on disk.

A geometry refusal names the curve or the surface by its zero-based number: its place in the order the script defines them, counted from zero, not the number you gave it. So surface #0 is the first surface the script defines and 3D curve #1 the second 3D curve. A part is numbered the same way, from zero. A node’s indices count from one.

  • part #<n> has a negative radius <r> in its r-list. A cylinder part cannot have a negative radius. Zero is allowed.
  • node (<i>, <j>, <k>) of part #<n> has a negative radius <r>. A node of a cylinder part reached a negative radius after the r-list, for example through an mb that moved it past the axis, or an equation x= that wrote one, since x is a cylinder part’s radius. The position is the part’s opening command, not the equation’s.
  • edge <s>.<e> names surface #<n>, <kind>, which has no sides, where <kind> is the kind’s phrase with its article, such as a plane or an ellipsoid. The surface is one of the kinds without sides: an infinite kind (a plane, a cylinder, a cone, a paraboloid, a surface from cp), a closed one (a sphere, an ellipsoid, a torus, a revolved closed curve), a closed tube (a pipe on a closed curve whose radius is the same at both ends, a revolved 3D curve of a closed generatrix turned a full circle), a composite or an intp. The geometry chapter lists them.
  • edge <s>.<e> names surface #<n>, <kind>, which has <c> sides. The surface has sides, but fewer than : two for a revolved open curve, a pipe on an open curve (or on a closed one whose radius differs at the two ends), or a full revolution of `r3dc` of an open generatrix, three for `blend3`. The number inside 1 to 4 passed [E0604](#e0604), which cannot know the kind.
  • edge <s>.<e>: surface #<n>, <kind>: side <e> is a single point, not a curve. The side has no length, as the rim of a revolution at an end that lies on the axis, or a ruling between two curve ends that meet. patch raises the same line with its own name in place of edge <s>.<e>, and curd with sdedge as 3D curve #<m>: surface #<n>, <kind>: side <e> is a single point, not a curve.
  • 3D curve #<m>: surface #<n>, <kind>, has no sides and 3D curve #<m>: surface #<n>, <kind>, has <c> sides; side <e> does not exist. The sdedge curve m names a side that its surface lacks, as the two lines above say of edge.
  • patch names surface #<n>, <kind>, which has no four sides in this version of James. The surface has fewer than four sides, so a face cannot be attached to it. Only rule2d, rule3d, crule3d, swept, blend4 and an r3dc of less than a full turn have four.
  • surface #<n> has a transformation that is not a similarity or surface #<n> has a transformation that is not a similarity; xsca scales one axis, with ysca or zsca in place of xsca. The list of a surface’s trans ; scales the axes unequally, or collapses the surface, and James has no kind for the result. The message names the first scale of one axis that the list holds. The line points at the sd that defined the surface, and James raises it when it builds the geometry, before any part is meshed, whether or not a command uses the surface.
  • 3D curve #<n> has a transformation that is not a similarity or 3D curve #<n> has a transformation that is not a similarity; xsca scales one axis, with ysca or zsca in place of xsca. The same rule for the list after the points of an arc3: a circle through the moved points is the moved circle only under a similarity. The line points at the curd, and James raises it when it builds the geometry. The list of an sdedge is not held to it.
  • surface #<n> has swept fractions that do not increase and surface #<n> has pipe fractions that decrease. The fractions of a swept surface’s sections must increase, and those of a pipe may not decrease. Each is in 0 to 1 by E1013, but their order is for the engine.
  • surface #<n> has a <what> of zero length, where <what> is plane normal, cylinder axis, cone axis, paraboloid axis, torus axis, ellipsoid axis or revolution axis. A direction 0 0 0, or all three coefficients a b c of an iplan zero, passes the front end, which does not test it, and the engine refuses it when it builds the surface.
  • projecting node (<i>, <j>, <k>) of part #<n>: projection onto <c> surfaces did not converge in 100 iterations; the surfaces are nearly tangent or do not meet. The node is held to two or three surfaces whose normals are too nearly parallel at their intersection, or that do not meet, so the Newton iteration cannot place it. The clause after the semicolon ends every such line: the iteration closes quickly on an intersection that the surfaces cross at an angle, so a node it cannot place is most often held to surfaces that are nearly tangent, or that do not meet, near it; a crease in one of them can starve the iteration too. The cure is in the surfaces.
  • projecting node (<i>, <j>, <k>) of part #<n>: the point is on the axis of cylinder #<m>, so its projection is not unique. A node to be projected sits where every nearest point of the surface is equally near. The line names the other surfaces in place of cylinder #<m>: cone #<m>, torus #<m>, ellipsoid #<m>, paraboloid #<m> and, for crx, cry, crz and cr, the surface of revolution #<m>. The node is on the axis of a cylinder, a cone, a surface of revolution or a torus, or on the axis of an ellipsoid longer along its axis than across, between the centres of curvature of its poles, or of a paraboloid away from its vertex. Three more lines have the same prefix and ending: the point is on the centre circle of the tube of torus #<m>, so its projection is not unique, the point is on the centre curve of pipe #<m>, so its projection is not unique, and for an r3dc surface #<m>, a revolved 3D curve: the point is on its axis, so its projection is not unique. The node at the centre of a sphere has its own line (below). <m> is the surface’s zero-based number. Move the node, or the surface, so that one point is nearest.
  • 3D curve #<n>: a csp3 loop needs at least three points. A csp3 curve with the option loop and fewer than three points.
  • 2D curve #<n>: the curve has zero length. An ld curve whose segments have no length.
  • 3D curve #<n>: the curve has zero length. A 3D curve of no length: an lp3 whose points all coincide, or an sdedge curve that a list such as csca 0 collapses to a point.
  • projecting node (<i>, <j>, <k>) of part #<n>: the point is at the center of sphere #<m>, so its projection is not unique. A node to be projected onto a sphere sits at its centre, where every point of the sphere is equally near.
  • part #<n> has <ni> x <nj> x <nk> nodes; this version of James supports at most 100000000. A part holds up to 100000000 nodes. A write holds up to 250000000, and a write that exceeds it raises the <n> parts of this write hold <count> nodes; this version of James supports at most 250000000 in one write.
  • file:line:column: error: cannot open <file> for writing, cannot write <file> and cannot close <file>, at the write that failed. The file could not be created, filled or closed.
  • part #<n> has a cycorsy frame that cannot be inverted. The cycorsy transform of a cylinder part has a determinant too near zero to invert (at most 1e-12 times the cube of its largest entry, the test tr’s inv uses), for example a scale of zero on one axis. James places the part through that frame from its first step and needs its inverse, so it stops. Give the frame a transform that scales no axis to zero.
  • edge (<i1>..<i2>, <j>, <k>) of part #<n> did not settle onto its surfaces in 100 rounds, or the same for the j or k direction. The edge’s interior nodes are projected onto their surfaces and spaced along the result again, round after round, and after 100 rounds a node still moved by more than a small fraction of the edge’s length. Surfaces that pull the edge in different directions cause it, and so does an intp surface whose nearest point jumps between sheets. Change the surfaces, or the edge’s spacing.
  • built without Exodus support. This build of James has no Exodus II writer, so a script that writes Exodus II fails at its write. Change the script’s exodusii to neutral, or build with the netCDF library. --format neutral helps only a script that names no format, because a format command in the script overrides the flag.
  • james: error: out of memory. The engine could not allocate an array. This line has no position.

The lines that were not recorded.

James keeps up to 4096 warning and note lines from the engine and prints them after the engine finishes. When a run raises more, James prints a separate line before the summary, <n> more warning(s) from the engine were not recorded (--engine-lines raises the limit of 4096), or the same line for notes with note(s). Pass --engine-lines <n> to keep more. If the buffer for the larger count cannot be allocated, the line says so and names the number you asked for.


James 0.8.0.

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