GAMGI Formats: Plane Create

# Plane Create

- Type
- Projection
- Scope
- Position
- View

### reference

When reference is cell, the plane is crystallographic so plane indices are required and its parent must be a cell. When reference is atoms, the plane is described by real and integer polygon data inside two <data></data> blocks, so the plane becomes independent of the atoms used to define it.

    Example: <plane ... reference="cell"/> (default)
    Allowed values: cell, atoms (optional)

### h, k, l

Set the indices h, k, l defining a crystallographic plane. The three indices cannot be all zero. An error is shown when these indices are not indicated for a crystallographic plane or when they are indicated for an atomic plane.

    Example: <plane ... h="1" k="0" l="0"/> (no default)
    Allowed values: integer (required, coupled)

### vectors

Set the type of cell vectors, conventional or primitive, used to determine the crystallographic plane with h, k, l indices. When the lattice is primitive there is no difference between conventional or primitive cell vectors. An error is shown when vectors is set for an atomic plane.

    Example: <plane ... vectors="conventional"/> (default)
    (defined in GAMGI_PHYS_PLANE_VECTORS)
    Allowed values: conventional, primitive (optional)

### model

An atomic plane is always represented as a polygon. A crystallographic plane can also be represented as a pole, a trace (for projected planes), or a vector (for reciprocal lattice planes).

    Example: <plane ... model="polygon"/> (default)
    Allowed values: polygon, pole, trace, vector (optional)

Home