Skip to content

Commit

Permalink
Friendliness pass 2
Browse files Browse the repository at this point in the history
This is attempting to better expose the POV-Ray functionality.
  • Loading branch information
roice3 committed Feb 4, 2017
1 parent 74d152b commit 712c9cf
Show file tree
Hide file tree
Showing 10 changed files with 615 additions and 485 deletions.
15 changes: 12 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,13 +7,22 @@ Code for visualizing spherical, euclidean, and hyperbolic honeycombs in various
This code is a companion to the paper "Visualizing Hyperbolic Honeycombs" by Roice Nelson and Henry Segerman (http://arxiv.org/abs/1511.02851). The code itself was authored by Roice. Images generated by this software are available for bulk download at www.hyperbolichoneycombs.org.

## How to generate UHS boundary images
You can run the latest released Windows binary, and by default it will generate a 1200x1200 boundary image of the {3,3,7} honeycomb. There is an easily editable "settings.xml" file in the same directory which can be used to change the honeycomb and some other settings (image size and bounds). I attempted to make the format self-explanatory. I can add more support in the settings (say coloring, transformations, etc.) if there is interest.
Run the latest released Windows binary, and by default it will generate a 1200x1200 boundary image of the {3,3,7} honeycomb.

There is an editable "settings_UHS.xml" file in the same directory which can be used to change the honeycomb and some other settings (image size and bounds). I attempted to make the format self-explanatory. I can add support for more settings (say coloring, transformations, etc.) if there is interest.

## How to generate POV-Ray images
Coming soon...
Run the latest released Windows binary, and by default it will generate a large (~250MB) POV-Ray definition file for the 4333-0001 uniform honeycomb, composed of octahedra and tetrahedra, see: https://en.wikipedia.org/wiki/Hyperbolic_tetrahedral-octahedral_honeycomb. You will then be able to render the resulting geometry by running the H3_sample.pov file in POV-Ray.

There is an editable "settings_PovRay.xml" file in the same directory which can be used to change the honeycomb and some other settings. Again, I attempted to make the format self-explanatory and can add support for more settings if there is interest.

I used this example because it was requested specifically, but it also demonstrates how to configure all 6 angles of the fundamental simplex for honeycombs with loop and branched Coxeter graphs. However, this "Goursat tetrahedron" feature only works for honeycombs with finite vertices. For linear Coxeter graphs, you can also specify just 3 numbers for the dihedral angles as in the UHS sample above. Linear graphs will work for paracompact honeycombs as well. They even work for some hyperideal honeycombs, but not all yet, so venture into that world at your own risk. Note that the 4333-0100, 4333-0010, and 4333-0001 are all the same honeycomb, just from different viewing perspectives.

A final note:
Resolution of the edges is something I always seem to have to tweak (POV-Ray's sphere_sweep primitive is finicky), and I'm still trying to decide the best way to expose this.

## How to generate STL models for Shapeways
I'm not planning to make this friendly, so for now folks will be stuck digging into the code.
_Abandon all hope, ye who enter here._ I'm not planning to make this friendly, so for now folks will be stuck digging into the code.

## A quick pointer to some of the important functions for working with H^3
I wrote up the following doc for someone who had questions on the code base. Hope it can be helpful for others.
Expand Down
Loading

0 comments on commit 712c9cf

Please sign in to comment.