GiD_Result create ?-array? {Result header} ?{Unit <unit_name>}? ?{componentNames name1 ...}? {entity_id scalar|vector|matrix_values} {...} {...} : these creation parameters are the same as for the postprocess results format (see Result of Results format: ModelName.post.res) where each line is passed as Tcl list argument of this command;

Optionally the names of the result's components could be specified, with the componentNames item, and the unit label of the result with the Unit item

if the -array flag is used (recommended for efficiency), then the syntax of the data changes. Instead to multiple items {id1 vx1 vy1 ...} ... {idn vxn vyn} a single item with sublists is required, {{id1 ... idn} {{vx1...vxn} {vy1...vyn}}}, where idi are the integers of the node or element where the result are defined, and vi are the real values. The amount of values depends on the type of result: 1 for Scalar, 2 for ComplexScalar, 3 for Vector (4 if signed modulus is provided), 6 for Matrix.

In fact with -array it is returned an 'objarray': a Tcl_Obj object specialized for arrays, implemented as a Tcl package named 'objarray'. (for more information see scripts\objarray\objarray.pdf)

-array flag: the values are returned more efficiently grouping the information in arrays, else values are grouped as a list with one item by entity

-sets <set_names_list>: only the results of nodes/elements (depending on the result) of the sets belonging to <set_names_list> are returned

-selection <sorted_ids>: only the results of nodes/elements (depending on the result) with id belonging to <sorted_ids> are returned

<sorted_ids> must be an intarray (list of integer ids) of increasing ids of nodes/elements to be returned.

if one of the -max, -min, -compmax, -compmin, or -info flags was specified instead of the full results value only the minimum/maximum value of the result, every minimum/maximum of the components of the result, or the header information of the result is retrieved, respectively;

Eamples: (case of a scalar result defined on triangles with 3 gauss points)

Define a new kind of gauss point where element results could be related.

<name> is the gauss point name. Internal Gauss points are implicitly defined, and its key names (GP_LINE_1,GP_TRIANGLE_1,...) are reserved words and can't be used to create new gauss points or be deleted. (seeGauss Points)

-nodes_included :optional word, only for line elements, to specify that start and end points are considered (by default are not included)

<coordinates> : vector with the local coordinates to place the gauss points: 2 coordinates by node for surface elements, 3 coordinates for volume elements. For line elements now is not possible to specify its coordinates, the n points will be equispaced.

If coordinates are "" then internal coordinates are assumed.

<mesh_name>: optional mesh name where this definition is applied, by default it is applied to all meshes