params

5reg

params

Replaced by attributes of &xml-surfaces; and &xml-hypersurfaces;

Content Model
    params ::=
Attributes
Name | Type | Version
`algorithm` | `CDATA` (required) | &attraddedver;4.94
`embedded` | `CDATA` (deprecated) | &attrdepver;4.94
`flavour` | `CDATA` |
`flavourid` | `NUMBER` (required) |
`type` | `NUMBER` (required) | &attraddedver;4.94

&eltdepver;7.0

## Description

This element was used in the past to store the parameters for an enumeration of vertex normal surfaces or hypersurfaces. These are typically the parameters supplied by the user when creating a new normal surface/hypersurface list. Since ®ina; 7.0, these enumeration parameters are now stored in the attributes of the corresponding &xml-surfaces; and &xml-hypersurfaces; elements instead.

### Parents

The following elements contain `params`:

- &xml-packet-normalhypersurfacelist;
- &xml-packet-normalsurfacelist;

.

### Children

Element `params` has no children.

## Attributes

`algorithm`

- Specifies the algorithm that was used to enumerate these normal surfaces/hypersurfaces.

  This must be an integer, formed as a bitwise OR combination of constants from ®ina;'s calculation engine. For normal surfaces in a 3-manifold triangulation, these constants are taken from the `NormalAlg` enumeration; for normal hypersurfaces in a 4-manifold triangulation, they are taken from the `HyperAlg` enumeration.

  An example of such an integer might be 17, which combines the constants `NormalAlg::VertexViaReduced` (1) and `NormalAlg::VertexTree` (16).

`embedded`

- Deprecated. This should be `T` if only embedded normal surfaces were enumerated to form this list, or `F` if all (embedded, immersed and singular) normal surfaces were enumerated.

  You should write this tag if you want your file to be read by ®ina; 4.93 or earlier. Later versions of ®ina; can also read it; however, they prefer the new `type` and `algorithm` tags, which contain richer information. If both `type` and `algorithm` are present then this `embedded` tag will be ignored.

`flavour`

- The flavour of coordinate system used in the normal surface/hypersurface enumeration, expressed as a human-readable string. Example flavours are `Quad normal` and `Standard almost normal (tri-quad-oct)`.

`flavourid`

- The flavour of coordinate system used in the normal surface/hypersurface enumeration, expressed as an internal identification code. This must be a non-negative integer that matches one of the coordinate system constants in ®ina;'s calculation engine. For normal surfaces in a 3-manifold triangulation, this constant is taken from the `NormalCoords` enumeration; for normal hypersurfaces in a 4-manifold triangulation, it is taken from the `HyperCoords` enumeration.

  An example of such an integer might be 102, which is the 3-dimensional constant `NormalCoords::QuadOct` that represents standard coordinates for octagonal almost normal surfaces.

`type`

- Specifies exactly which normal surfaces/hypersurfaces this list contains. In particular, this flag indicates whether the list contains all vertex surfaces, all fundamental surfaces, or some other customised list. It also indicates whether the list is restricted to properly embedded surfaces (thereby replacing the obsolete `embedded` tag described above).

  This must be an integer, formed as a bitwise OR combination of constants from ®ina;'s calculation engine. For normal surfaces in a 3-manifold triangulation, these constants are taken from the `NormalList` enumeration; for normal hypersurfaces in a 4-manifold triangulation, they are taken from the `HyperList` enumeration.

  An example of such an integer might be 5, which combines the constants `NormalList::EmbeddedOnly` (1) and `NormalList::Vertex` (4).