GiD_LocalAxes <mode> <name> ?<type>? <Cx Cy Cz> <PAxex PAxey PAxez> <PPlanex PPlaney PPlanez>?

To create, delete or modify local axes:

  • <mode>: must be one of "create|delete|edit|exists", which correspond to the operations: create, delete, edit or exists;
  • <name>: is the name of local axes to be created or deleted;
  • <type>: must be one of "rectangular|cylindrical|spherical C_XZ_Z|C_XY_X". Currently, GiD only supports rectangular axes. C_XZ_Z is an optional word to specify one point over the XZ plane and another over the Z axis (default). C_XY_X is an optional word to specify one point over the XY plane and another over the X axis;
  • <Cx Cy Cz> is a Tcl list with the real coordinates of the local axes origin;
  • <PAxex PAxey PAxez> is a Tcl list with the coordinates of a point located over the Z' local axis (where Z' is positive). The coordinates must be separated by a space. If the z coordinate is missing, it is set to z=0.0;
  • <PPlanex PPlaney PPlanez> is a Tcl list with the coordinates of a point located over the Z'X'half-plane (where X' is positive).

For the 'exists' operation, if only the <name> field is specified, 1 is returned if this name exists, and 0 if it does not. If the other values are also apecified, <name> is ignored.

The value returned is:

-1 if the global axes match;

-2 if the automatic local axes match;

-3 if the automatic alternative local axes match;

0 if it does not match with any axes;

<n> if the user-defined number <n> (n>0) local axes match.

Example:

GiD_LocalAxes create "axes_1" rectangular C_XY_X {0 0 0} {0 1 0} {1 0 0}

GiD_LocalAxes delete axes_1

GiD_LocalAxes exists axes_1

GiD_LocalAxes exists "" rectangular C_XY_X {0 0 0} {0 1 0} {1 0 0}

this last sample returns -1 (equivalent to global axis)