Different Packet Types
|Prev||Working with Packets||Next|
There are many different types of packet that you can create in Regina. Here we give a brief overview of each.
A container packet helps keep your packet tree organised: it can contain other “child” packets, but otherwise it does nothing.
Containers are marked by the following icon:
To see how containers can be used to organise a tree, take a look at one of the census files: try ->->. Part of the packet tree for this census is shown below (the container labelled 6 tetrahedra has been opened for viewing).
Any packet (not just a container) can contain other child packets.
A text packet contains an arbitrary amount of plain text, with no formatting. It can be used to add descriptions, observations or other miscellaneous comments into your data file.
Text packets are marked by the following icon:
Like text packets, a PDF packet allows you to document your work. PDF packets support richer content, including diagrams and formulae. The PDF document must be created outside Regina (using LaTeX or your favourite word processor), and then imported into your Regina data file by selecting ->.
PDF packets are marked by the following icon:
When you open a PDF packet for viewing, it will open in your computer's default PDF viewer (as illustrated below). If you like, you can specify a different PDF viewer in Regina's settings.
A triangulation packet represents a 3-manifold triangulation, described by gluing faces of tetrahedra together in pairs. Triangulations are central to Regina, and you can learn more about using them by reading the chapter on triangulations in this handbook.
Triangulations are marked by the following icon:
A normal surface list represents a set of normal surfaces within a 3-manifold triangulation. Typically this will be the set of all vertex normal surfaces in some normal (or almost normal) coordinate system. Like triangulations, normal surfaces are central to Regina, and you can learn more about using them in the chapter on normal surfaces.
Normal surface lists are marked by the following icon:
Normal surface lists can be created using different sets of matching equations, and can then be viewed in a variety of coordinate systems. In the packet tree, a normal surface list must always appear as a child of the corresponding 3-manifold triangulation.
A surface filter can be applied to a long list of normal surfaces to extract only some smaller set of surfaces that you might be interested in. You can learn more about surface filters in the chapter on normal surfaces. Regina offers two types of surface filter:
A property filter selects only those normal surfaces with a given orientability, compactness, boundary and/or Euler characteristic.
Property filters are marked by the following icon:
A combination filter uses boolean
to combine several other surface filters.
This allows you to combine property filters together in
complex boolean expressions.
Combination filters are marked by the following icon:
A combination filter will combine its immediate children in the packet tree. For example, the combination filter illustrated below will select any surface that passes either the Tori and Annuli filter or the Discs filter.
An angle structure list represents a set of angle structures on a 3-manifold triangulation. Typically this will be the set of all vertex angle structures under the standard equations. You can learn more about working with angle structure lists in the chapter on angle structures in this handbook.
Angle structure lists are marked by the following icon:
Like normal surface lists, an angle structure list must always appear as a child of the corresponding 3-manifold triangulation.
A script packet contains a Python script that offers direct access to Regina's calculation engine. You can edit the script from within Regina, and your script can set variables that represent other packets in your data file. See the chapter on Python for more information on scripting within Regina.
Script packets are marked by the following icon:
|Viewing and Editing Packets||Up||Other Operations on Packets|