home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / maths / wimppoly_1 / !WimpPoly / DataFormat < prev    next >
Text File  |  1991-12-11  |  4KB  |  83 lines
  1.  
  2.               DOCUMENTATION for WimpPoly - Data Format        12 Dec 1991 
  3.  
  4.  This is file !WimpPoly.DataFormat
  5.  
  6.                                 DATA FORMAT
  7.  The original data files were downloaded from the PD library on JANET
  8.  address uk.ac.ukc::netlib, together with the manual and the index to the
  9.  netlib files. 
  10.  
  11. The data format has been modified from that used in netlib, it now
  12. consists of a number of fields, each with a descriptor header line
  13. beginning with a : followed by the field name. Subsequent lines have the
  14. data for that field, terminated either by the next field or the end of the
  15. file, the field :EOF. Fields can be in any order. The format allows 2
  16. views of a polyhedron, a planar net, and a 3D solid. Most datafiles have
  17. both, either may be missing.
  18.  
  19. The fields include, but are not limited to:  
  20.  
  21.         name    the polyhedron name all lower case < 128 characters
  22.  
  23.         number  the polyhedron netlib index number (0-141)
  24.  
  25.         symbol  the eqn(1) input for two symbols separated by a tab;
  26.                 the Johnson symbol, and the Schlafli symbol
  27.  
  28.         dual    the name of the dual polyhedron optionally followed by
  29.                 a horizontal tab and the netlib index number of the dual.
  30.  
  31.         sfaces  ?? none in this data
  32.  
  33.         svertices       ?? none in this data
  34.  
  35.         vertices the first line contains the total number of vertices,
  36.                 and the vertex number where the 3D vertices start.
  37.                 The vertices are floating point numbers, stored one
  38.                 per line as (x,y,z) coordinates separated by spaces.
  39.                 Implicit vertex numbering starts at zero. 
  40.  
  41.         net     the first line contains the number of faces and
  42.                 the maximum number of vertices in a face. The remaining
  43.                 lines are the faces in the planar net. Each face has a
  44.                 vertex count followed by the vertex numbers. Vertices are
  45.                 listed in counter-clockwise order as viewed from outside
  46.                 the polyhedron.
  47.  
  48.         hinges  the first line contains the number of hinges in the planar
  49.                 net. The remaining lines are hinge connections.
  50.                 The format is face1 side1 side2 value. 
  51.                 Sides are numbered from zero. If the dihedral angle is
  52.                 greater than pi it is a reflex or re-entrant hinge.
  53.  
  54.         solid   the first line contains the number of faces and the maximum
  55.                 number of vertices in a face. The remaining lines are the
  56.                 faces in the 3D polyhedron. Each face has a vertex count
  57.                 followed by the vertex numbers. The vertices are listed in
  58.                 counter-clockwise order as viewed from outside the
  59.                 polyhedron.
  60.  
  61.      dihedral the first line contains the number of distinct dihedrals.
  62.                 Each dihedral starts on a new line and has a count and a
  63.                 value. If the count is non-zero, then that many face edge
  64.                 pairs (one per line) follow the dihedral value.
  65.  
  66.         EOF     the end of the polyhedron's description.
  67.  
  68.  These added by KMC
  69.  
  70.         comment ASCII characters describing the data, usually ones edited
  71.                 from !polyhedra by KMC
  72.  
  73.    netformulae the exact expressions from inside the [] stored with the
  74.                 net vertices, written in bc(1) code  with the following
  75.                 function meanings: 
  76.  
  77.                 a(x) = tan-1(x), b(x) = (x)1/3, c(x) = cos(x),
  78.                 d(x) = tan(x),      p = pi,     q(x) = x2,
  79.                 r(x) = cos-1(x), s(x) = sin(x),    t = tau. 
  80.                 The code may include assignments but does not include white
  81.                 space.
  82.  
  83.