-gccylinder: A circular cylinder in general direction

A gccylinder is a circular cylinder, with its axis in an arbitrary direction.

 ##############################################################################
 # Flags: nomenu, noprompt, nomessage,                                        #
 ##############################################################################
 # section -gccylinder                                                        #
 ##############################################################################
 # material  =  1                                                             #
 # whichcells= all, taboo= none                                               #
 #     show= off    -- [off|now|later|all]                                    #
 #     name= gccyl-000000000                                                  #
 # radius    = undefined                                                      #
 # length    = undefined                                                      #
 # origin    = ( undefined, undefined, undefined )                            #
 # direction = ( undefined, undefined, undefined )                            #
 ##############################################################################
 # doit, return, help                                                         #
 ##############################################################################

• material
  The material index that shall be assigned to the volume that makes up the gccylinder.
• whichcells
  Possible values are all, or a material-index. If whichcells=all, all volume inside the cylinder is assigned the material-index, provided the former material is not taboo. If whichcells is a material-index, only the parts of the cylinder that are currently filled with the given index are assigned the new material-index.
• taboo
  Possible values are none, or a material-index. If taboo=none, all volume inside the cylinder is assigned the material-index. If taboo is a material-index, only the parts of the cylinder that are currently filled with another index than the given index are assigned the new material-index.
• show
  Flag, specifying whether an outline of the specified gccylinder should be displayed.
  If show=off, no outline will be displayed.
  If show=later, the outline will be shown later together with outlines of other specified items. If show=all is present, the outlines of all other specified items bricks gccylinders, ggcylinders and gbors so far where show was not off will be displayed.
• radius
  The radius of the circular cylinder.
• length
  The length of the cylinder.
• origin
  The coordinates of the center of the foot-circle of the circular cylinder.
• direction
  The direction of the cylinder axis.
• doit
  Puts the current data as the data of a circular cylinder into the meshing database.

Note: You can revert the direction of the cylinder by negating the direction, or (easier) by negating the length.
Note: If you want eg. a quarter of a circular cylinder, you have to use -gbor, see pages ff.
Example

 # /usr/local/gd1/examples-from-the-manual/gccylinder-example.gdf

 -general
     outfile= /tmp/UserName/example
     scratch= /tmp/UserName/scratch-

 -mesh
     pxlow= 0, pxhigh= 1e-2
     pylow= 0, pyhigh= 2e-2
     pzlow= 0, pzhigh= 1.5e-2
     
     cxlow= ele, cxhigh= mag
     cylow= ele, cyhigh= mag
     czlow= ele, czhigh= mag

     spacing= 0.2e-3

 -gccylinder
     material= 5, radius= 3e-3, length= 7e-3
     origin= ( 0.5e-2, 0.3e-2, 0.6e-2 )
     direction= ( -0.4, 1.5, 0.4 )
     doit
        
 -volumeplot
     scale= 3
     doit

Figure 1.2: A simple gccylinder, with its axis directing towards (-0.4, 1.5, 0.4).

Example

 # /usr/local/gd1/examples-from-the-manual/gccylinder-example2.gdf

 define(VeryLarge, 10000)

 -general
    outfile= /tmp/UserName/example
    scratch= /tmp/UserName/scratch

    text()= A chain of circular cylinders
    text()= The cylinders are partly outside of the bounding box.

 -mesh
    pxlow= -0.8, pxhigh= 10
    pylow= -2, pyhigh= 2
    pzlow= -0, pzhigh= 1.8

    spacing= 8e-2

 -brick
    material= 0
    volume= ( -VeryLarge, VeryLarge, \
              -VeryLarge, VeryLarge, \
              -VeryLarge, VeryLarge )
    doit

 define(RADIUS, 0.6)
 -gccylinder
    length= 1.7
    radius= RADIUS
    do jj= 0, 9, 1
       material= jj+3
       origin= ( jj*1.5*RADIUS, 0, 0 )
 define(PHI, jj*22.5*@pi/180 )
       direction= ( 0, cos(PHI), sin(PHI) )
       doit
    enddo

 -volumeplot
    eyeposition= ( 1.0, 2.30, 2 )
    scale= 5
    doit

Figure 1.3: A chain of simple circular cylinders. Each cylinder has its axis pointing in a different direction.