1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
|
# Copyright (c) 1997-2024
# Ewgenij Gawrilow, Michael Joswig, and the polymake team
# Technische Universität Berlin, Germany
# https://polymake.org
#
# This program is free software; you can redistribute it and/or modify it
# under the terms of the GNU General Public License as published by the
# Free Software Foundation; either version 2, or (at your option) any
# later version: http://www.gnu.org/licenses/gpl.txt.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#-------------------------------------------------------------------------------
declare property_type SwitchTable : c++ (include => ["polymake/group/switch_table.h"]) {
# @category Constructors
method construct(Array<Array<Int>>) : c++;
method lex_maximize_vector(Vector) : c++;
method lex_minimize_vector(Vector) : c++;
operator == : c++;
}
object PermutationAction {
# @category Orbits
# A switch table is a tool for finding lex-maximal or -minimal in orbits
# under the action of a permutation group. Its main ingredient is an
# upper-left triangular matrix with group elements as entries.
#
# The output contains the support at every level, i.e. a number and a
# Set<Int>, the number is the size of the support and and the Set<Int> are
# the indices of those entries that can be permuted to the index of the
# current level while keeping previous level indices fixed. I.e. entry [i,j]
# will keep the first i entries of a vector fixed, while moving the j-th
# entry to position i. Note that we start counting at 0!
#
# This method has been developed for the purpose of enumerating triangulations up to symmetry.
# See Joswig, Jordan and Kastner, Electron. J. Combin. 25.3, Paper 3.6, 27.
# It is used in mptopcom, https://polymake.org/mptopcom .
#
# @example
# > $P = new PermutationAction(GENERATORS=>[[1,2,0,4,5,3],[2,1,0,5,4,3]]);
# > print $P->SWITCH_TABLE;
# | Supports: (size, content)
# | Level 0: 2 {1 2}
# | Level 1: 1 {2}
# | Entries:
# | [0,1]: 1 0 2 4 3 5
# | [0,2]: 1 2 0 4 5 3
# | [1,2]: 0 2 1 3 5 4
property SWITCH_TABLE : SwitchTable;
rule SWITCH_TABLE : ALL_GROUP_ELEMENTS {
$this->SWITCH_TABLE = new SwitchTable($this->ALL_GROUP_ELEMENTS);
}
# @category Orbits
# Assume the group acts on a vector by permuting its entries. Then this
# method gives the lex-maximal vector from the orbit of the input vector
# under the group action.
# For more details see [[SWITCH_TABLE]].
user_method lex_maximal(Vector) : SWITCH_TABLE {
my($this, $v) = @_;
return $this->SWITCH_TABLE->lex_maximize_vector($v);
}
# @category Orbits
# Similar to [[lex_maximal]]; for more details see [[SWITCH_TABLE]].
user_method lex_minimal(Vector) : SWITCH_TABLE {
my($this, $v) = @_;
return $this->SWITCH_TABLE->lex_minimize_vector($v);
}
}
# Local Variables:
# mode: perl
# c-basic-offset:3
# End:
|
