Call: GET_WIRE_DATA

wire

Should contain, on input, the Number of the wire about which information is desired. Wire numbers can be obtained from the listing produced in response to the CELL-PRINT option in the cell section and also by the PRINT-CELL command in the optimisation section.

This argument is mandatory and is not modified.

[No default.]

x

Contains, on return, the x- or \ρ-location of the wire in cm for x, and log(cm) for \ρ.

If the cell has been entered in polar coordinates, then the wire location is returned in internal coordinates. These can be converted to Cartesian or polar coordinates with the INTERNAL_TO_CARTESIAN and INTERNAL_TO_POLAR procedures.

This argument is optional. The argument should be a global variable, not a constant nor an expression. The global may have been declared prior to the call, but doesn't have to. The value an existing variable had before the call will be lost. The argument will be of type Number on return.

y

Contains, on return, the y- or \φ-location of the wire in cm for y, and in radians for \φ.

If the cell has been entered in polar coordinates, then the wire location is returned in internal coordinates. These can be converted to Cartesian or polar coordinates with the INTERNAL_TO_CARTESIAN and INTERNAL_TO_POLAR procedures.

This argument is optional. The argument should be a global variable, not a constant nor an expression. The global may have been declared prior to the call, but doesn't have to. The value an existing variable had before the call will be lost. The argument will be of type Number on return.

d

Contains, on return, the diameter of the wire in cm.

This argument is optional. The argument should be a global variable, not a constant nor an expression. The global may have been declared prior to the call, but doesn't have to. The value an existing variable had before the call will be lost. The argument will be of type Number on return.

V

Contains, on return, the potential at the wire surface as entered with the ROWS statement in the &CELL section. The potential is returned in Volts.

The CHECK instruction can display the potential that is computed for the neighbourhood of the wire.

This argument is optional. The argument should be a global variable, not a constant nor an expression. The global may have been declared prior to the call, but doesn't have to. The value an existing variable had before the call will be lost. The argument will be of type Number on return.

q

Contains, on return, the charge in V that has been computed for the wire. Internally, Garfield expresses charges in units of V to avoid scaling factors.

Also the INTEGRATE_CHARGE procedure returns charges in V. It is, however, more usual to express wire charges in pC/cm, as is for instance done by the CELL-PRINT option. To convert from V to C/cm, multiply by 2\π\ε\<SUB\>0\</SUB\>, approximately 5.56\ 10\<SUP\>-13\</SUP\>\ C/V.cm.

This argument is optional. The argument should be a global variable, not a constant nor an expression. The global may have been declared prior to the call, but doesn't have to. The value an existing variable had before the call will be lost. The argument will be of type Number on return.

label

Contains, on return, a character String with the label of the wire.

This argument is optional. The argument should be a global variable, not a constant nor an expression. The global may have been declared prior to the call, but doesn't have to. The value an existing variable had before the call will be lost.

length

Contains, on return, the length of the wire, in cm.

This argument is optional. The argument should be a global variable, not a constant nor an expression. The global may have been declared prior to the call, but doesn't have to. The value an existing variable had before the call will be lost. The argument will be of type Number on return.

weight

Contains, on return, the weight with which the wire has been pulled during assembly, in grams.

This argument is optional. The argument should be a global variable, not a constant nor an expression. The global may have been declared prior to the call, but doesn't have to. The value an existing variable had before the call will be lost. The argument will be of type Number on return.

density

Contains, on return, the density of the material of which the wire is made, in g/cm\³.

This argument is optional. The argument should be a global variable, not a constant nor an expression. The global may have been declared prior to the call, but doesn't have to. The value an existing variable had before the call will be lost. The argument will be of type Number on return.

Go to the top level, to Call, to GET_WIRE_DATA, to the topic index, to the table of contents, or to the full text.

Formatted on 21/01/18 at 16:55.