AREA 

&FIELD: AREA


box

Sets a limiting rectangle or a limiting box. If only 4 numbers are given, then these are interpreted as the range in (x,y) or in (r,\φ) and the range in z is left unchanged.

Field plots are made only over the part of the viewing plane that is located inside the box.

Particles are allowed to drift inside the limits of the box.

[The initial default is taken from the cell dimensions.]


plane

The VIEW argument enables you to define the viewing plane. The coordinates in this plane can to some extent be influenced by specifying a rotation angle.

The viewing plane is defined by a formula in terms of the variables X, Y and Z that defines the points located in the plane. The formula should be linear in all 3\ variables. No particular format is required, the formula is not looked at token by token, but evaluated at 9 points to extract the parameters of the plane.

In 3-dimensional field plots, plane oriented commands such as PLOT-FIELD SURFACE, PLOT-FIELD VECTOR and PLOT-FIELD HISTOGRAM, compute the quantities that they plot in points of the viewing plane.

In 2-dimensional chambers, the plane would normally be chosen to coincide with the plane in which the chamber is described, i.e. the plane would be z=0 for a chamber in (x,y), but this is not mandatory. It is perfectly permissible, and it can also be meaningful, to define solids and view them in 3D perspective.

If you plan to issue field plotting commands after the AREA statement, then please ensure that the viewing plane crosses the limiting box of the area - points on the viewing plane, but outside the limiting box are not shown.

For drift plots, the viewing plane merely determines the plane onto which the drift-lines will be projected. Wires, tubes, planes and other materials are plotted as the cross section with the viewing plane.

Examples:

area view x+2*y+3*z=5
area view y=z
area view y=0 rotate 90

[The default setting is Z=0.]

Additional information on:

 

angle

If the default coordinates in the viewing plane do not suit you, then you can rotate these axes by an amount you specify with this keyword.

This angle must not be specified with the X-Y, Y-Z, X-Z and R-PHI projections.

The angle should be given in degrees.

[Default rotation angle: 0\ \°.]


X-Y

Requests an x-y view, at z=0.

In this kind of view, any solids that may have been entered will not be shown. If the field is derived from a 2D or 3D field map, then the elements or the cross sections of the elements will be shown if the PLOT-MAP option is active.

This type of plot consists of

[This is the initial default for Cartesian cells and cells that have a tube, provided no VIEW is specified.]


X-Z

Requests x-z views, at y=0.

In this kind of view, any solids that may have been entered will not be shown. If the field is derived from a 3D field map, then the cross sections of the elements of the field map will be shown if the PLOT-MAP option is active.

Beware that the coordinate system used for this view is left-handed. Trajectories of particles in a magnetic field will therefore appear to bend counter-naturally. To obtain a right-handed view of the same plane, use VIEW y=0 and request a CUT projection, optionally specifying a rotation angle.

This type of plot consists of

[X-Y is default]


Y-Z

Requests y-z views.

In this kind of view, any solids that may have been entered will not be shown. If the field is derived from a 3D field map, then the cross sections of the elements of the field map will be shown if the PLOT-MAP option is active.

This type of plot consists of

[X-Y is default]


R-PHI

Requests r-phi views, only meaningful with polar cells, for which this is the only available viewing method.

In this kind of view, any solids that may have been entered will not be shown, nor will cross sections of the elements of the field map appear.

This type of plot consists of

[This is the default in polar cells.]


CUT

Asks for a cut through the AREA in the location of the viewing plane. A viewing plane must therefore be defined when using this option - the viewing plane may of course be defined in the same AREA statement, but the formula for this plane need not be repeated if has been entered in a preceding AREA statement.

The display will show the solids through which the viewing plane cuts, but will not show solids that are located fully above or below the viewing plane.

If displaying the solids is not desired, then the faster X-Y, X-Z or Y-Z options should be used. If on the other hand solids should be shown, then the 3D option might be preferable.

If the PLOT-MAP option is on and if the field is derived from a field map, then the elements or the cross sections of the elements with the viewing plane will be shown.

This projection, other than 3D, will usually lead to a view that is not isometric.

This type of plot consists of

A cut through the same GEM foil that illustrates the 3D view. Outlining is absent in this example.

[CUT becomes the default if a viewing plane is defined in the same AREA statement, unless 3D was set previously.]


3D

Asks for a three dimensional impression of the chamber as seen along an axis normal to the viewing plane. An attempt is made to remove partially and fully hidden parts of the solids. Similarly, curves are clipped to show only the parts that are not hidden by a solid.

The various solids present in the cell are coloured in shades of their basic colour, depending on the exposure with respect to the light source and the viewing plane, on the REFLECTED-FRACTION and on the ABSORBED-FRACTION of the light. The various shades of each colour can be examined with the SHADING-MAP graphics command.

Elements of the field map are not shown with this projection, even if the PLOT-MAP option is on.

This is the only projection that guarantees an isometric projection.

This option is highly CPU intensive and makes use of a much large number of colours than usual.

The plots consist of the following elements:

A three dimensional view of a GEM foil with staggered holes.


NEBEM

Requests a 3-dimensional view similar to the one produced in response to the 3D projection, but using the surface panels that have been transmitted to the neBEM program.

In this view, the outside of the solids is shown in the same colour shades as in the 3D view, while the inside is shown with colour 8, usually red. The inside should only be visible if:

This option is valid only when neBEM is used to calculate the field.

[Intended for debugging purposes.]


light

When plotting 3-dimensional impressions, each panel of the solids is shaded in a more or less dark variant of its basic colour. Deliberately, a very simple model, described below, has been chosen for the visualisation of 3-dimensional objects as many excellent programs for this purpose are on the market.

A panel can become visible in two ways:

Garfield does not perform ray tracing - light reflected from one panel does not contribute to the illumination of another.

The shade used for a surface panel is therefore determined by the following factors:

Parts of panels that are hidden behind others are removed, see SPLIT-INTERSECTING-PLANES.


LIGHT-ORIGIN

Specifies where the light source is located relative to the viewing direction.

The light source is assumed to produce a broad beam of parallel light rays, similar to the sun - but unlike a light bulb in the immediate neighbourhood.

The location is expressed in polar angles \φ and \θ, both in degrees.

[Default is 30\° for \θ and \φ.]


REFLECTED-FRACTION

Specifies the part of the visible light that is reflected from the surface, the remainder is diffusely scattered.

Expressed as a percentage.

[Default: 10\ %]


ABSORBED-FRACTION

Specifies how much of the incoming light is lost by absorption at the surface.

Expressed as a percentage.

[Default: 3\ %]


COLOURS

Sets the number of shades of every colour that are used.

The shades can be examined with the SHADING-MAP graphics instructions.

[Default: 10]


FULL-BOX-TICKMARKS

Three dimensional impressions have the 3 backmost panels of the AREA as background, with a wire frame to indicate the 3 coordinate axes.

[By default, only the coordinate axes on the periphery of these 3 panels are shown so as to avoid ending up with an overcrowded plot, but you can obtain the 3 remaining axes by specifying the FULL-BOX-TICKMARKS option.]


FULL-PLANES

By default, the planes that are seen from the "inside" of the chamber are fully shown, while those seen from the "back" are merely outlined.

On request, by specifying FULL-PLANES, the planes seen from the back will be shown fully,

This option is meaningful only with 3D impressions.


FULL-TUBE

By default, the parts of the tube that are seen from the "inside" of the chamber are fully shown, while those seen from the "back" are merely outlined.

On request, by specifying FULL-TUBE, the parts seen from the back will be shown fully,

This option is meaningful only with 3D impressions.


SPLIT-INTERSECTING-PLANES

When plotting 3-dimensional impressions, an elaborate attempt is made to remove parts of solids that are hidden by others. Given the highly degenerate nature of some overlaps, this process can be very time consuming, in particular when many solids are present and when the solids intersect.

Unfortunately, plots made with this option switched off are rarely acceptable. In rare cases, an reasonable result can be obtained with the SORT-PLANES option.

The cutting procedure is complex and presumably still contains errors. Please contact the author in case of poor results and warnings from the PLASPL procedure.

[This option is meaningful only with 3D impressions, where the option is on by default.]


SORT-PLANES

As a slightly faster alternative to SPLIT-INTERSECTING-PLANES, one may request to attempt a sort of the panels.

A panel that is partially hidden by another panel will be plotted first. There is however no order relation for hiding: if A hides part of B, and B hides part of C, then C can very well hide part of A. Hence, only very simple cases can be treated with this option.

The main use of this option is to remedy cases where the SPLIT-INTERSECTING-PLANES procedure fails partially.

[The option is off by default.]


OUTLINE

Requests the outer edges of the solids to be emphasised with a line.

Meaningful with 3D plots. Can also be used with CUT plots although, in this kind of diagram, the outer lines of the solids and the borders of the cut through the solids do not as a rule match.

The lines are drawn according to the OUTLINE representation.

[Outlines are by default not drawn.]


PLOT-MAP

Requests the materials to be shown in plots of the chamber.

The option has effect only if material properties have been entered, either as a map of dielectric constants or as maps of both D and E.

The materials are distinguished by their dielectric constant, which must therefore have been entered with the FIELD-MAP command. This can be done with an explicit map of dielectric constants, but also by a comparison of maps of E and D.

The material with the smallest dielectric constant is shown with representation MATERIAL-1. The medium with the next highest dielectric constant with MATERIAL-2 etc. The drift medium is never shown.

Elements of a 2D field map are only shown in X-Y views and in CUT views at a constant z. The cross sections of the viewing plane with the elements of a 3D field map are shown in X-Y, X-Z, Y-Z and CUT views, but not in 3D views.

Field maps do not usually cover areas filled with conducting material since there is no field inside these. To visualise these, one has to enter them manually with the SOLIDS command. SOLIDS doesn't interfere with PLOT-MAP.

This option can also be switched on or off with the PLOT-MAP option of the FIELD-MAP command.

[This option is by default on if the dielectric constants are known.]


STEP

Waits for a user response after plotting each panel of which at least part is visible. When the panel has been displayed, one can either simply hit return to proceed with the next panel, or type SHOW to see the coordinates, memory references and colour of the panel.

Only active in 3D views.

This is a debugging option.

[This option is switched off initially.]


Go to the top level, to &FIELD, to AREA, to the topic index, to the table of contents, or to the full text.

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