Garfield 
 Help 
 Call 
 ELECTRIC_FIELD 
 Search 
 Index 
 Full text 
 Contents 

Call: ELECTRIC_FIELD

x

This procedure accepts input arguments of types Number and Matrix. This argument is not modified.

If at least one of the input arguments x and y is of type Matrix, then all output arguments are of type Matrix, with the dimensions of the first input argument of type Matrix. If one input argument is of type Number and the other of type Matrix, then the Number type argument is "expanded" to become a Matrix filled uniformly with the value of the Number.

The coordinates system expected by ELECTRIC_FIELD is the internal frame. If you describe your cell in Cartesian coordinates, then the internal frame is simply the Cartesian coordinate system. If polar coordinates are used however, then you should supply the following parameters: 

for x: log(r)
for y: \φ, in radians

These mappings can be performed with the POLAR_TO_INTERNAL procedure.

y

See x.

ex

The field is returned in internal coordinates. The internal coordinates system is Cartesian when the cell is described in Cartesian coordinates, but when you describe the cell in polar coordinates, you've to apply the following mapping: 
Er = Ex/r
Ephi = Ey/r
Ez is invariant

This argument must be modifiable and its value prior to the call will be overwritten.

On return, the argument will be of type Matrix if either of the coordinates is of that type, otherwise it will be of type Number.

ey

See ex.

ez

See ex.

e

See ex.

v

Contains on successful completion, the potential in Volt.

See also ex.

status

Indicates where the point is located. If only scalar arguments are used as coordinates, then the status is returned in the form of a string. If at least one coordinate is a Matrix, then a matrix filled with numeric location codes is returned.

Status Location string Numeric
In a material Inside the mesh, but not in a drift medium -5
In X-wire N Inside wire number N of type X 1-MXWIRE
In X-solid N Inside solid number N of type X > 2*MXWIRE
Normal In the active part of the cell 0
Outside mesh Not in any mesh triangle or tetrahedron -6
Outside plane On the side of a plane where no wires are -4 to -1
Unknown potential Unknown potential type (shouldn't occur) -10
Unknown Other cases (shouldn't occur) other
Go to the top level, to Call, to ELECTRIC_FIELD, to the topic index, to the table of contents, or to the full text.

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