  
  [1X12. Orbit polytopes and fundamental domains[0X
  
      | [10X FundamentalDomainAffineCrystGroupOnRight(v,G)[0X Inputs a crystallographic group G (represented using AffineCrystGroupOnRight as in the GAP package Cryst). It also inputs a choice of vector v in the euclidean space R^n on which G acts. It returns the Dirichlet-Voronoi fundamental cell for the action of G on euclidean space corresponding to the vector v. The fundamental cell is a fundamental domain if G is Bieberbach. The fundamental cell/domain is returned as a "Polymake object". Currently the function only applies to certain crystallographic groups. See the manuals to HAPcryst and HAPpolymake for full details. This is a HAPcryst function and is thus only available if HAPcryst is loaded. The function requires the use of Polymake software.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | 
      | [10X OrbitPolytope(G,v,L) [0X Inputs a permutation group or matrix group G of degree n and a rational vector v of length n. In both cases there is a natural action of G on v. Let P(G,v) be the convex polytope arising as the convex hull of the Euclidean points in the orbit of v under the action of G. The function also inputs a sublist L of the following list of strings: ["dimension","vertex_degree", "visual_graph", "schlegel","visual"] Depending on the sublist, the function: -- prints the dimension of the orbit polytope P(G,v); -- prints the degree of a vertex in the graph of P(G,v); -- visualizes the graph of P(G,v); -- visualizes the Schlegel diagram of P(G,v); -- visualizes P(G,v) if the polytope is of dimension 2 or 3. The function uses Polymake software.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | 
      | [10X PolytopalComplex(G,v) [0X [10X PolytopalComplex(G,v,n) [0X Inputs a permutation group or matrix group G of degree n and a rational vector v of length n. In both cases there is a natural action of G on v. Let P(G,v) be the convex polytope arising as the convex hull of the Euclidean points in the orbit of v under the action of G. The cellular chain complex C_*=C_*(P(G,v)) is an exact sequence of (not necessarily free) ZG-modules. The function returns a component object R with components: -- R!.dimension(k) is a function which returns the number of G-orbits of the k-dimensional faces in P(G,v). If each k-face has trivial stabilizer subgroup in G then C_k is a free ZG-module of rank R.dimension(k). -- R!.stabilizer(k,n) is a function which returns the stabilizer subgroup for a face in the n-th orbit of k-faces. -- If all faces of dimension <k+1 have trivial stabilizer group then the first k terms of C_* constitute part of a free ZG-resolution. The boundary map is described by the function boundary(k,n) . (If some faces have non-trivial stabilizer group then C_* is not free and no attempt is made to determine signs for the boundary map.) -- R!.elements, R!.group, R!.properties are as in a ZG-resolution. If an optional third input variable n is used, then only the first n terms of the resolution C_* will be computed. The function uses Polymake software. | 
      | [10X PolytopalGenerators(G,v) [0X Inputs a permutation group or matrix group G of degree n and a rational vector v of length n. In both cases there is a natural action of G on v, and the vector v must be chosen so that it has trivial stabilizer subgroup in G. Let P(G,v) be the convex polytope arising as the convex hull of the Euclidean points in the orbit of v under the action of G. The function returns a record P with components: -- P.generators is a list of all those elements g in G such that g* v has an edge in common with v. The list is a generating set for G. -- P.vector is the vector v. -- P.hasseDiagram is the Hasse diagram of the cone at v. The function uses Polymake software. The function is joint work with Seamus Kelly.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | 
      | [10X VectorStabilizer(G,v) [0X Inputs a permutation group or matrix group G of degree n and a rational vector of degree n. In both cases there is a natural action of G on v and the function returns the group of elements in G that fix v.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | 
  
