(This has a lot of overlap with TOPCOM which will be quicker than existing methods. This repo will progressive port more of the computations over to TOPCOM (via triangulumancer)
Software for studying vector configurations defined over the lattice vectors. This includes
- constructing regular triangulations (i.e., polyhedral fans) of such vector configurations via lifting,
- constructing all (regular) triangulations via computation of flip graphs,
- verification of various properties of the vector configuration/fan, and
- efficient linear flipping.
See Triangulations: Structures for Algorithms and Applications by De Loera, Rambau, and Santos for a definitive resource on such topics.
This package, regfans, was originally developed for constructing toric varieties in the work Calabi-Yau Threefolds from Vex Triangulations. Said work was supported in part by NSF grant PHY-2309456. All toric-geometric computations are isolated to CYTools, which has an extension vector_config building off of regfans.
regfans can be installed using either conda or pip. To install regfans using conda, please see/use the provided environment.yml file:
conda env create -f environment.yml
conda activate regfans
To install regfans using pip, either run (to install the most recent release; also see PyPI listing)
pip install regfans
or (to install a local version)
pip install .
N.B.: many methods in regfans require computation of dual cones (i.e., the generators of a cone defined via hyperplanes or vice-versa). Currently, this requires pplpy which cannot be automatically installed via pip.
See api.md for full API reference.
(To update documentation, just run pydoc-markdown; py documentation/clean_api.py)
See the tutorials directory for some commented example scripts showing how to construct a vector configuration, check properties of it, construct fans from it, and check the properties of said fans.