COO

Reads/sets the specified cube's data (index, name, 3 dimensional, coordinates (X, Y, Z).

Mnemonic:

Cube cOOrdinates.

Syntax:

COO
COO $<$n$\vert$name$>$
COO $<$n$\vert$name, x, y, z$>$
COO $<$n, name, x, y, z$>$

n: Cube number.

name: Cube name.

X: x coordinate of cube

Y: y coordinate of cube

Z: z coordinate of cube

Return values:

Success:

COO 1, n, name, x, y, z

Failure:

COO 0, err_msg

n: Cube number

name: New or current cube name

x: New or current X coordinate of cube

y: New or current Y coordinate of cube

z: New or current Z coordinate of cube

err_msg: Should the command fail, this value will be an error message string, explaining the cause of failure. COO may fail if:

• The wrong number of parameters is used
• A specified cube does not exist in the ZY's cube collection

Remarks:

Like CIL, COO has several distinct functions, and behaves according to how many parameters it receives:

With no parameters:

COO will list every cube in its collection, by repeatedly sending back COO acknowledgements, one for each cube in the collection.

With 1 parameter:

COO assumes that the parameter is either the name or index number of an existing cube, and returns the current information (n, name, x, y, z) for that cube.

With 4 parameters:

COO assumes that the first parameter is the name or index number of an existing cube and that the following parameters are new X, Y, Z values for that cube.

With 5 parameters:

COO assumes that the first parameter is the index number for a new cube. It deletes any cube that may already be at that index number, and creates a new cube in its place, using the remaining parameters to supply the name and X, Y, Z for the new cube.

NOTE: Az and El encoder values are no longer supplied as part of cube data using COO. The only cube that needs to have Az/El encoder coordinates set for it is the reference cube (cube 0, `ZRG'). The commands AZM and ELV or CIL can be used for this purpose. All other cubes have their Az and El encoder coordinates calculated by the coordinate module.

Example:

  To create a new cube ZG11:

    send: COO 4, ZG11, -207339.04, -78346.73, 2358.98
 receive: COO 1, 4, ZG11, -207339.040, -78346.730, 2358.980

  To get the values for that cube:

    send: COO ZG11
 receive: COO 1, 4, ZG11, -207339.040, -78346.730, 2358.980

  To change values for that cube:

    send: COO ZG11, -103945.90, -45898.7, 106.34
 receive: COO 1, 4, ZG11, -103945.900, -45898.700, 106.340

  To get a list of all cubes (assume 189 cubes):

    send: COO
 receive: COO 1, 0, ZRG, 0, 0, 0
          COO 1, 1, T007, 693940.1, 466587.2, 822219
          COO 1, 2, BANK, 1327424.6, -844203.3, 823180
          .
          .
          .
          COO 1, 188, ZEG31020, 35981.1, 51115.8, 865024.1

See also:

AZM, CIL, ELV, INI