home *** CD-ROM | disk | FTP | other *** search
/ Explore the World of Soft…e: Engineering & Science / Explore_the_World_of_Software_Engineering_and_Science_HRS_Software_1998.iso / programs / civil_en / dome350.exe / DOME.TXT < prev    next >
Text File  |  1995-04-08  |  6KB  |  177 lines
  1.                     Geodesic Dome Design
  2.                             DOME
  3.                          Version 3.50
  4.                         April 8, 1995
  5.  
  6. =============
  7. What is DOME?
  8. =============
  9. DOME is a program which calculates the properties of a
  10. geodesic dome symmetry triangle. DOME calculates spherical
  11. vertex coordinates, symmetry triangle topological abundance,
  12. and chord factors. DOME supports class I (alternate)
  13. and class II (triacon) breakdowns for Icosahedron, 
  14. Octahedron and Tetrahedron polyhedron types.
  15.  
  16.  
  17. =============
  18. Why DOME?
  19. =============
  20. DOME began as a set of geodesic math test algorithims for
  21. use in investigating properties of generalized geodesic
  22. structures. This continues to be the main purpose of my
  23. development of the DOME code. DOME should serve as a basic
  24. tool for those interested in geodesic dome design and
  25. modeling. All source code is also included in this package
  26. and is freely modifiable under the conditions of the GNU
  27. General Public License.
  28.  
  29. ================
  30. System Requirements
  31. ================
  32. DOME has been complied using Borland C++ 3.1 to run on any
  33. PC class system. Dome frequency is limited by the amount of
  34. memory available. Full spheres use more memory so that the
  35. frequency should be reduced accordingly.
  36.  
  37. ================
  38. Changes From Previous Release Version 2.18
  39. ================
  40. -Added headers & spherical coordinates to PRN output file
  41. -Added a test routine for the bottom face rotation of the
  42.  tetrahedron. 
  43. -Added checks to rotate_phi & rotate_theta functions
  44. -Class constructor now passed a structure with input
  45.  parameters
  46. -Removed interactive interface
  47. -Streamlined verbose output to only the basic topology
  48. -Moved help to a seperate function
  49. -Added class I rotations for full sphere formation
  50. -Updated exit codes to non-zero where required
  51. -Added portability ifdef's and defs to aid in porting
  52.  to non-Borland C compilers...specifically UNIX/Linux
  53.  Thanks to Chris Fearnley & John Kirk for the patches.
  54. -Added automatic revision tracking on logo display
  55. -Enabled Class II support. Program now calculates
  56.  class II symmetry triangle data. 
  57.  
  58. ================
  59. Usage
  60. ================
  61. DOME is run from the DOS command line. The program will terminate
  62. with an error message if there is not enough memory to allocate array
  63. space for the coordinate matrix. If this occurs, re-run DOME and request
  64. a smaller subdivision frequency. Only even frequencies are allowed when
  65. using class II. Rotations of class II triangles are not currently supported.
  66.  
  67. Usage: dome -fnnn -cn -px [-s] [-v] [-h] [filename.xxx]
  68. Where: -fnnn is geodesic frequency (default nnn=2)
  69.        -cn is class type (n=1 or 2; default n=1)
  70.        -px sets the polyhedron type
  71.         where x is: i for icosahedron (default)
  72.                     o for octahedron
  73.                     t for tetrahedron
  74.        -s generate full sphere data (default: symmetry triangle)
  75.        -v verbose data display at run-time
  76.        -h displays a help screen
  77.         filename.xxx is a standard DOS filename
  78.         where xxx is: DXF, DAT, POV or PRN
  79.  
  80. ================
  81. File Formats
  82. ================
  83. DOME currently supports four file formats:
  84.     1.) DXF - DXF chord data which can be input into most
  85.               computer aided design packages. Each polyhedron face is
  86.               saved on a seperate level if spherical data generation is
  87.               requested.
  88.     2.) DAT - An ASCII report format. Shows only symmetry triangle parameters.
  89.     3.)    PRN - An ASCII comma delimited format. Contains vertex
  90.               coordinate and chord coordinate data. Suitable for
  91.               parsing into custom routines and spreadsheets
  92.     4.)    POV - POV-ray script file. Generates spheres for vertexia
  93.               and cylinders for chords.
  94.  
  95. ================
  96. Other Goodies
  97. ================
  98. A DXF to POV converter DXFTOPOV is now included. This utility facilitates
  99. POV rendering generation of modified DXF data. This is handy if you use
  100. a CAD program to rotate the symmetry triangle into a complete sphere.
  101.  
  102. Several sample GIF files rendered with POV-ray are included for fun.
  103.  
  104. ================
  105. UNIX Portability
  106. ================
  107. Several defines have now been added to the DOME & DXFtoPOV source code to allow
  108. porting to UNIX machines. 
  109.  
  110. ================
  111. DOME Updates
  112. ================
  113. The next release of DOME should include:
  114. Full sphere constructions for Class II triangles
  115. Class II Method 3 Coordinates
  116. A graphics viewer
  117. If all goes well It will be ready for release in the
  118. Summer of 1995
  119.  
  120.  
  121. Following releases will add:
  122. Axial, dihedral, & face angle calculations
  123. Truncation options
  124. Space frame support
  125. Non-spherical geodesic structure design
  126.  
  127. ================
  128. Copyright Information
  129. ================
  130. DOME 3.50, Copyright (C) 1995  Richard J. Bono
  131.  
  132. This program is free software; you can redistribute it
  133. and/or modify it under the terms of the GNU General Public
  134. License as published by the Free Software Foundation; either
  135. version 2 of the License, or any later version.
  136.  
  137. This program is distributed in the hope that it will be
  138. useful,  but WITHOUT ANY WARRANTY; without even the implied
  139. warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
  140. PURPOSE.  See the GNU General Public License for more
  141. details.
  142.  
  143. You should have received a copy of the GNU General Public
  144. License along with this program; if not, write to the Free
  145. Software Foundation, Inc., 675 Mass Ave, Cambridge, MA
  146. 02139, USA.
  147.  
  148. Please direct inquiries, comments and modifications to:
  149.       Richard J. Bono
  150.       44 Augusta Rd.
  151.       Brownsville, TX 78521
  152.  
  153.       email:70324.1712@compuserve.com
  154.                     -or-
  155.                 rjbono@AOL.com
  156.  
  157.  
  158. ================
  159. Acknowledgements & References
  160. ================
  161. The main reference used in the creation of this code was:
  162. "Geodesic Math & How to Use It" by Hugh Kenner, 1976,
  163. University of California Press.
  164. ISBN 0-520-02924-0; Library of Congress Catalog Card Number:
  165. 74-27292.
  166. Many thanks to Hugh for putting this data in an accessible
  167. format.
  168.  
  169. Also, many thanks to J. F. Nystrom for turning me on to
  170. Bucky back in the summer of 1984, my wife Sonia and my
  171. daughter Kathy for their de-finite patience, Chris
  172. Fearnley for pushing me to release this code, providing
  173. uploading tips, general comments & his GNU POV scripts, Kirby
  174. Urner for introducing me to POV-ray and R. Buckminster Fuller
  175. for changing the way I view Universe.
  176. =================
  177.