Antiprism Up Next
Home
Programs
Examples
Album
Download
Development
Forum
About

n_icons - sphericon like polyhedra

Usage    |    Examples    |    Notes

Usage



Usage: n_icons [options]

Creates Sphericon like Polyhedra. Also known as Streptohedra

Options
  -h,--help this help message (run 'off_util -H help' for general help)
  --version version information
  -n <n/d>  n-icon of order n. n must be 3 or greater (default: 4)
               use d to make star n-icon. d less than n
  -t <twst> number of twists. Can be negative, positive or 0 (default: 1)
  -s        side-cut of even order n-icon (default is point-cut)
  -H        hybrid of even order n-icon
  -a        angle (-z 3 only)
  -r        override inner radius (-z 2 only)
  -R        override outer radius (-z 2 only)
  -z <mthd> construction method
               1 - n/d must be co-prime. bow-ties can occur (default for d=1)
               2 - n/d compounds allowed. shell model (default for d>1)
               3 - n/d compounds allowed. No bow-ties (default if angle not 0)
  -M <m,m2> longitudes of model of m sides with optional m2 of m sides showing
               m may be odd, 3 or greater if twist is 0 (default: 36,36)
  -A        place a north and south pole in top and bottom if they exist
                only valid if m2<m. Not valid with -c h (-z 1 only)
  -c <clse> close open model if m2<m. Valid values h or v (-z 1,2)
               h = horizontal closure, v = vertical closure
  -x <elms> v, e and f to remove OFF faces with one vertex (vertices),
               two-vertices (edges) and three or more vertices (faces)
               E - if face is invisble, associated edge is made invisible
  -I        information on current n-icon
  -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)
  -f <mthd> mthd is face coloring method. The coloring is done before twist
               key word: none - sets no color
               S - color by symmetry polygon (default)
               s - color by circuits algorithm (n/d must be co-prime)
               f - color circuits with flood fill (-z 2,3 any n/d)
               c - color by compound
               a - color by compound, alternate method
               l - color latitudinally
               m - color longitudinally
               b - checkerboard with first two colors in face color list
               n - use each color in succession
               x - first two colors based on sign of x
               y - first two colors based on sign of y
               z - first two colors based on sign of z (z is the twist plane)
               o - use first eight colors per xyz octants
  -S        color circuits symmetrically for coloring method s,f,S (even n)
  -T <tran> face transparency. valid range from 0 (invisible) to 255 (opaque)
  -O <strg> face transparency pattern string. valid values
               0 -T value suppressed, 1 -T value applied  (default: '1')
  -e <mthd> mthd is edge coloring method. The coloring is done before twist
               key word: none - sets no color
               key word: Q - defer coloring all edges to option Q  (default)
                  or use the same letter options specified in -f, except c,a
               F - color edges with average adjoining face color
  -U <tran> edge transparency. valid range from 0 (invisible) to 255 (opaque)
  -P <strg> edge transparency pattern string. valid values
               0 -U value suppressed, 1 -U value applied  (default: '1')
  -Q <col>  color given to uncolored edges and vertices of final model
               key word: none - sets no color (default: invisible)
  -Y        for n/d shells, when showing edges, show indented edges
  -m <maps> color maps to be tried in turn. (default: map_red:darkorange1:
               yellow:darkgreen:cyan:blue:magenta:white:grey:black%) optionally
               followed by elements to map from v, e or f (default: vef)
  -D <c,e>  default color c for uncolored elements e (default: darkgrey,ef)
               key word: none - sets no color. elements e can include e or f
  -X <int>  flood fill stop. used with circuit or compound coloring (-f f,c)
               use 0 (default) to flood fill entire model. if -X is not 0 then
               return 1 from program if entire model has been colored
  -W        add symmetry polygon (for -f S or -e S)

Surface Count Reporting (options above igonored)
  -J <type> list n-icons with more than one surface. Valid values for type
               n = point cut even order n_icons
               s = side cut even order n-icons (surfaces > 2)
               o = odd order n_icons
               h = hybrids (all)
               i = hybrids (where N/2 is even)
               j = hybrids (where N/2 is odd)
               k = hybrids (where N/4 is even)
               l = hybrids (where N/4 is odd)
  -K <k,k2> range of n-icons to list for multiple surfaces
  -L        long form report
  -Z        filter out case 2 types


Examples

The Sphericon
n_icons | antiview


The Dual of the Spherican
n_icons -s | antiview


A Hybrid of the Sphericon and its Dual
n_icons -H | antiview


The N-icon of 20 twisted 5 increments. The five surfaces are colored with the default colors. No edges or vertices are shown.
n_icons -n 20 -t 5 -f s | antiview


Same as above but only using colors red, orange, and yellow.
n_icons -n 20 -t 5 -f s -m map_red:orange:yellow% | antiview


Same as above but 50 percent transparent.
n_icons -n 20 -t 5 -f s -m map_red:orange:yellow% -T 128 | antiview


The N-icon of 30 twisted 5 increments. The faces are colored white and the edges are the default colors.
n_icons -n 30 -t 5 -f n -m map_white%,f -e s | antiview -e 0.1 -v 0.1


The N-icon of 12/4 twisted 2 increments colored by compound.
n_icons -n 12/4 -t 2 -f c | antiview


The N-icon of 12/4 twisted 4 increments colored by compound. Shell model is created and 3/4 open to view interior.
n_icons -n 12/4 -t 2 -f c -z 2 -M 36,27 | antiview


The N-icon of 12/4 twisted 4 increments colored by compound. Star polygon model is created and 3/4 open to view interior.
n_icons -n 12/4 -t 2 -f c -z 3 -M 36,27 | antiview


The reporting subsystem is used. A list of even order N-icons with twists between 3 and 30 and more than one surface are listed.
n_icons -J n -K 3,30 -L


Notes

n_icons was written by Roger Kaufman. For more details on the construction see Roger's N-icon study.


     Next: kcycle - kaleidocycle rings of polyhedron
     Up: Programs and Documentation


Home   |   Programs   |   Examples   |   Album   |   Download   |   Development   |   Forum   |   About

Contact: adrian@antiprism.com      -      Modified 12.9.2016