Node Generator — create nodes
create_nodesUse to create many nodes from coordinates, with the plugin's checks. For nodes plus elements use civil_write_tables; for a whole deck use skew_grillage. Creates nodes in the open CIVIL NX model from X, Y, Z coordinates with the Node Generator plugin's own engine: every check the plugin window makes (blank or non-numeric coordinates, bad or duplicate ids, ids above 999999, ids that already exist, coincident nodes within a tolerance), its numbering modes and its write rules. Give the points as nodes [{id?, x, y, z}] or as table (text pasted from Excel or a CSV; a header like ID,X,Y,Z is recognised, decimal commas and semicolon CSVs too). Coordinates are in inputUnit (m or mm) plus an optional origin offset, and are converted to the model's length unit. numbering: 'auto' continues after the highest existing node id; 'start' uses start + increment; 'column' keeps the ids given (default when every row has one). An id that already exists blocks the write unless overwrite: true, which MOVES those nodes (and the elements on them). Coincident nodes are reported first; choose coincident: 'skip' or 'create'. Previews unless apply: true with confirmPlanHash; new nodes go by POST (create-only, so a node made since the preview is never overwritten), overwrites by PUT, then db/NODE is read back. create_nodes_undo reverses it.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "create_nodes"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| apply | No | Write to CIVIL NX. Only after the user approved the preview. | |
| nodes | No | Points: {x, y, z} or {id, x, y, z}; [x, y, z] and [id, x, y, z] arrays also work. | |
| start | No | numbering 'start': first id. | |
| table | No | Instead of nodes: tab-, comma- or semicolon-separated text, one node per line (ID, X, Y, Z or X, Y, Z), optional header row. | |
| origin | No | Added to every coordinate (input unit). | |
| decimal | No | Decimal mark in table text; AUTO detects it. | |
| increment | No | numbering 'start': step between ids. | |
| inputUnit | No | Unit of the coordinates, the origin offset and the tolerance. | M |
| numbering | No | ||
| overwrite | No | Move existing nodes whose id is in the input to the new coordinates. Only with the user's agreement. | |
| tolerance | No | Coincidence tolerance, input unit. | |
| coincident | No | report = preview only; skip = leave coincident rows out; create = create them anyway. | report |
| confirmPlanHash | No | planHash from the approved preview; the write is refused if the plan differs. |