symmetro - polyhedra with regular polygons at symmetry axes

Usage | Examples | Notes

Usage



Usage: symmetro [options]

Symmetrohedra and Twisters are created by placing equilateral polygons centered
on the symmetry axes of Icosahedral, Octahedral, Tetrahedral, or Dihedral
symmetry. The sides of the polygons will be a multiple number of the axis
reflection number. Axes are numbered as 0, 1 and 2

It is possible to generate models such that the polygons intersect. If a
collision is detected, convex hull will be suppressed

options -k, -t, and -d cannot be used together, but one needs to be specified

Options
  -h,--help this help message (run 'off_util -H help' for general help)
  --version version information
  -k <s,l,m,n,a> Kaplan-Hart notation. Generate Symmetrohedra based on a study
            by Craig S. Kaplan and George W. Hart (http://www.georgehart.com).
            Url: http://www.cgl.uwaterloo.ca/~csk/projects/symmetrohedra
            s: symmetry type of Symmetrohedra. sets {p,q,2}
               I-icosahedral {5,3,2} O-octahedral {4,3,2} T-tetrahedral {3,3,2}
            l,m,n: multipliers for axis polygons. Separated by commas, one
               multiplier must be * or 0, the other two are positive integers
            a: face rotation type: vertex=1, edge=0  (default: 1)
            example: -k i,2,*,4,e
  -t <s[p,q]i,m1,m2> Twister notation. Generate twister models.
            s: symmetry. I-icosahedral, O-octahedral, T-tetrahedral, D-dihedral
            p,q: rotational order of each of the two axes. may be swapped
            i: (default: 1): integer to select between non-equivalent pairs of
               axes having the same symmetry group and rotational orders
            m1,m2: an integer multiplier for each axis. i.e. m1*p and m2*q
               also can be entered as m1/d, m2/d fractional values
               e.g. T[3,2],1,2  I[5,2]2,1/2,3  D7[7,3],1,2  D11[2,2]5,2,2
                  Axis pairs are from the following
                  T: [3,3], [3,2], [2,2]
                  O: [4,4], [4,3], [4,2]x2, [3,3], [3,2]x2, [2,2]x2
                  I: [5,5], [5,3]x2, [5,2]x3, [3,3]x2, [3,2]x4, [2,2]x4
                  Dn:[n,2], [2,2]x(n/2 rounded down)
  -s <n/d:D>,s S symmetry twisters. denominator d optional (default: 1)
               optional D substitutes a polygon of n/D in place of n/d
               optional s: symmetry override c - C symmetry
  -c <n1/d1:D1,n2/d2:D2,s,v> C symmetry twisters
               optional d denominator (default: 1)
               optional D substitutes a polygon of n/D in place of n/d
               optional n2 can differ from n1. if not specified n2=n1, d2=d1
               optional s: symmetry: c - C (default), h - Ch, v - Cv, d - D
               optional v: vertex index of radial polygon to bring to z plane
                  v of -1 is original position (default: index of largest z)
  -M <opt>  mirroring (may create compound). Can be x, y or z (default: none)
  -a <a,n>  a in degrees of rotation given to polygon applied to optional
               axis n (default: 0)  radians may be entered as 'rad(a)'
  -r <r,n>  set the edge length of the polygon on axis n (default: 0)
               to r. Must be non-negative. The default edge length is 1
  -A <a>    a in degrees is angle between axes (default: calculated)
  -C <mode> convex hull. polygons=1, suppress=2, force=3, normal=4 (default: 4)
  -q <args> include frame elements in output
               r - rhombic tiling edges, a - rotation axes (default: none)
  -O <dist> amount to offset the first polygon to avoid coplanarity with the
               second polygon, for example 0.0001 (default: 0.0)
  -x        remove any free faces that are produced
  -v        verbose output
  -l <lim>  minimum distance for unique vertex locations as negative exponent
               (default: 12 giving 1e-12)
  -o <file> write output to file (default: write to standard output)

Coloring Options (run 'off_util -H color' for help on color formats)
  -Q <col>  frame color  (default: skyblue3)
  -V <col>  vertex color (default: gold)
  -E <col>  edge color   (default: lightgray)
  -f <mthd> mthd is face coloring method using color in map (default: a)
               key word: none - sets no color
               a - color by axis number
               n - color by number of sides
  -T <tran> face transparency. valid range from 0 (invisible) to 255 (opaque)
  -m <maps> color maps for faces to be tried in turn (default: m1)
               keyword m1: red,blue,yellow,darkgreen
                  note: position 4 color is for faces added by convex hull
               keyword m2: approximating colors in the symmetrohedra pdf file

Examples

Make a truncated cuboctahedron

symmetro -s o -m 2,2,0 -r e | antiview

Like a rhombicuboctahedron, but scale the squares on the 4-fold axes by 2.

symmetro -s o -m 1,1,0 -S 2  | antiview

Make an approximate snub cube

symmetro -s o -m 1,0,1 -r 28.53245 | antiview

Make a 'twister' by suppressing the convex hull and varying the twist parameter

symmetro -s t -C s -m 1,1,0 -r 15 | antiview

Notes

symmetro was written by Roger Kaufman.

Up: Programs and Documentation
Next: waterman - Waterman polyhedra