12
12
<!-- File Concatenator -->
14
<refentry id="man-censuslookup">
16
<refentrytitle>censuslookup</refentrytitle>
17
<manvolnum>1</manvolnum>
21
<refname>censuslookup</refname>
22
<refpurpose>Search for triangulations in ®ina;'s census databases</refpurpose>
27
<command>censuslookup</command>
28
<arg rep="repeat" choice="req"><replaceable>isosig</replaceable></arg>
33
<title>Description</title>
35
This utility searches for the given 3-manifold triangulations in the various
36
census databases that are shipped with®ina;.
39
You should present the trianguations using their <firstterm>isomorphism
40
signatures</firstterm>. These are short text strings that identify
41
the triangulation uniquely up to combinatorial isomorphism
42
(i.e., up to relabellings of the tetrahedra and/or their vertices).
45
From the graphical user interface, you can view the isomorphism signature
46
of a triangulation by switching to the <guilabel>Composition</guilabel>
47
tab in the triangulation viewer. From &python; you can fetch the
48
isomorphism signature of the triangulation <userinput>x</userinput>
49
by calling <userinput>x.isoSig()</userinput>.
50
For a full and precise specification of isomorphism signatures, see
51
<emphasis>Simplification paths in the Pachner graphs of closed
52
orientable 3-manifold triangulations</emphasis>, Burton, 2011,
56
All database matches (if any) will be written to standard output.
61
<title>Example</title>
64
<prompt>example$</prompt> <userinput>censuslookup fvPQcdecedekrsnrs dLQbcccajqs cPcbbbiht</userinput>
65
fvPQcdecedekrsnrs: 1 hit
66
SFS [S2: (2,1) (3,1) (5,-4)] : #1 -- Closed census (orientable)
71
m004 : #1 -- Cusped hyperbolic census (orientable)
72
L104001 -- Hyperbolic knot and link complements
74
<prompt>example$</prompt>
79
<title>&macosx; Users</title>
81
If you downloaded a drag-and-drop app bundle, this utility is
82
shipped inside it. If you dragged ®ina; to the main
83
<guilabel>Applications</guilabel> folder, you can run it as
84
<literal>/Applications/Regina.app/Contents/MacOS/censuslookup</literal>.
89
<title>&windows; Users</title>
91
The command-line utilities are installed beneath the
92
<filename>Program Files</filename> directory; on some
93
machines this directory is called
94
<filename>Program Files (x86)</filename>.
95
You can start this utility by running
96
<literal>c:\Program Files\Regina\Regina ®version;\bin\censuslookup.exe</literal>.
101
<title>See Also</title>
103
<link linkend="man-regina-gui">regina-gui</link>.
104
<link linkend="man-trisetcmp">trisetcmp</link>,
109
<title>Author</title>
111
This utility was written by Benjamin Burton <email>bab@debian.org</email>.
14
117
<refentry id="man-regconcat">
16
119
<refentrytitle>regconcat</refentrytitle>
890
<term><option>-h, --minhyp</option></term>
893
Do not include triangulations that are obviously not
894
minimal ideal triangulations of cusped finite-volume hyperbolic
898
This can significantly speed up the census and vastly
899
reduce the final number of triangulations produced.
902
As above, this option uses a series of fast tests that are not
904
If ®ina; cannot quickly tell whether a triangulation is a
905
minimal ideal triangulation of a cusped finite-volume hyperbolic
907
it will place the triangulation in the census regardless.
910
This option is designed for use with ideal triangulations only
911
(so, for instance, combining it with
912
<option>--finite</option> or <option>--boundary</option>
913
will produce an error message).
914
This option also cannot be used with <option>--dim2</option>.
785
919
<term><option>-s, --sigs</option></term>
1064
1199
<arg><option>-m, --minimal</option></arg>
1065
1200
<arg><option>-M, --minprime</option></arg>
1066
1201
<arg><option>-N, --minprimep2</option></arg>
1202
<arg><option>-h, --minhyp</option></arg>
1068
1204
<arg><option>-s, --sigs</option></arg>
1069
1205
<arg choice="req"><replaceable>pairs-file</replaceable></arg>