GEOMETRY

----------------------------------- Photon Help ----

The GEOMETRY feature in PHOTON allows you to 'draw' geometric elements on the plot. Lines, arcs, circles and polygons can be drawn in 3D space for a variety of purposes - outlining blockages, adding realism by drawing objects in and around the domain (such as car outlines), and highlighting features within the domain. For ease of use, individual elements may be grouped together into segments, which can then be manipulated as a whole.

Geometry commands may be read in from a disk file, or entered from the terminal. Elements may be added, switched on and off, deleted, and the final geometry saved back to disk.

See the HELP entry for GEOMETRY_CMDS for a brief description of the geometry commands.

See also : GEOMETRY DELETE, GEOMETRY OFF, GEOMETRY ON,
GEOMETRY READ,GEOMETRY SAVE,GEOMETRY CLEAR,
GEOMETRY_CMDS

GEOMETRY

----------------------------------- Photon Help ----

[Geometry] activates the geometry sub-menu to set a new geometry element to be drawn.

GEOMETRY CLEAR

---------------------------- Photon Help ----

GE[ometry] CL[ear] .... deletes all geometry elements.

See also : GEOMETRY, GEOMETRY OFF, GEOMETRY ON,
GEOMETRY READ, GEOMETRY SAVE, GEOMETRY
DELETE, GEOMETRY_CMDS

GEOMETRY DELETE

---------------------------- Photon Help ----

GE[ometry] DE[lete] <n>.... deletes geometry element 'n', where 'n' may be an element number, or 'ALL' to delete all elements.

See also : GEOMETRY, GEOMETRY OFF, GEOMETRY ON,
GEOMETRY READ, GEOMETRY SAVE, GEOMETRY
CLEAR, GEOMETRY_CMDS

GEOMETRY OFF

------------------------------- Photon Help ----

GE[ometry] OFF <n>.... switches off geometry element 'n', where 'n' may be an element number, or 'ALL' to delete all elements.

See also : GEOMETRY, GEOMETRY DELETE, GEOMETRY ON,
GEOMETRY READ, GEOMETRY SAVE, GEOMETRY
CLEAR, GEOMETRY_CMDS

GEOMETRY ON

-------------------------------- Photon Help ----

GE[ometry] ON <n>.... switches on geometry element 'n', where 'n' may be an element number, or 'ALL' to delete all elements.

See also : GEOMETRY, GEOMETRY DELETE, GEOMETRY OFF,
GEOMETRY READ, GEOMETRY SAVE, GEOMETRY
CLEAR, GEOMETRY_CMDS

GEOMETRY READ

------------------------------ Photon Help ----

GE[ometry] RE[ad].... reads user geometry for display on the plot. Geometry may be read in from a file, or typed in from the keyboard. If entry from the keyboard is desired, press <Return> when the geometry file name is requested, otherwise enter the file name.

To exit interactive geometry entry, press <Return> until the 'Option?' prompt appears.

Geometry elements may be added to the currently stored elements using GEOM READ more than once.

See also : GEOMETRY, GEOMETRY DELETE, GEOMETRY OFF,
GEOMETRY ON, GEOMETRY SAVE, GEOMETRY CLEAR,
GEOMETRY_CMDS

GEOMETRY SAVE

------------------------------ Photon Help ----

GE[ometry] SA[ve] <filename>.... saves the currently stored geometry elements into a file. If no filename is given, it will be prompted for.

A saved geometry file may be subsequently read in using GEOM READ.

See also : GEOMETRY, GEOMETRY DELETE, GEOMETRY OFF,
GEOMETRY ON, GEOMETRY READ, GEOMETRY
CLEAR, GEOMETRY_CMDS

GEOMETRY_CMDS

------------------------------- Photon Help ----

This is a brief description of the available geometry commands. Further details appear in the PHOTON User Guide.

1. LINE x1 y1 z1 x2 y2 z2 [dash] [colour]
   • 
     x1 y1 z1 - Cartesian coordinates of start of line.
     x2 y2 z2 - Cartesian coordinates of end of line.
     dash - Line type, 0=solid line, 1-4=broken lines Default=solid line.
     colour - Line colour, default=default colour for device
2. PLINE x1 y1 z1 x2 y2 z2 [dash] [colour] + x3 y3 z3
   • 
     x1 y1 z1 - Cartesian coordinates of start of first line.
     x2 y2 z2 - Cartesian coordinates of end of first line.
     dash - Line type, 0=solid line, 1-4=broken lines Default=solid line.
     colour - Line colour, default=default colour for device

   Subsequent records continue the line to as many points as desired.

3. PGON x1 y1 z1 [dash] [fill] + x2 y2 z2
   • 
     x1 y1 z1 - Cartesian coordinates of first vertex.
     dash - Boundary line type, 0=solid line, 1-4=broken lines. Default=solid line.
     fill - fill colour or pattern. Default=no fill.

   Subsequent records define the remaining vertices of the polygon.

4. ARC dash colour circle
   + x1 y1 z1
   + x2 y2 z2
   + x3 y3 z3
   • 
     dash - Line type, 0=solid line, 1-4=broken lines Default=solid line.
     colour - Line colour, default=default colour for device
     circle - 0=draw arc, 1=draw circle.
     x1 y1 z1 - Cartesian coordinates of first point on arc.
     x2 y2 z2 - Cartesian coordinates of second point on arc.
     x3 y3 z3 - Cartesian coordinates of third point on arc.

   The 'circle' parameter indicates whether a circle is to be drawn through the three points, or whether an arc is to be drawn from point 1 to point 3 via point 2.

5. BEGIN segname

   Start definition of a segment. All subsequent LINE, PLINE, PGON and ARC commands will be stored in the segment until the next END command. Note segments may now be nested.

6. END

Terminate definition of the current segment.

See also : GEOMETRY DELETE, GEOMETRY OFF, GEOMETRY ON,
GEOMETRY READ, GEOMETRY SAVE, GEOMETRY CLEAR,
GEOMETRY

wbs