Globals
=======

|
Particle Types
--------------
Particle types are defined as single bytes in the oap library.
They can be used to classify optical-arrays.
The following particle types are already defined:
::
    UNDEFINED = b'u'    # Not yet classified
    INDEFINABLE = b'i'  # Not possible to classify
    ERRONEOUS = b'e'    # Artefacts or erroneous images
    SPHERE = b's'       # Spherical particles
    COLUMN = b'c'       # Column-like particles
    ROSETTE = b'r'      # Rosettes
    DENDRITE = b'd'     # Dendrites
    PLATE = b'p'        # Plates
|
**Example:**
::
    >>> import oap
    >>> oap.COLUMN
    b'c'
    >>> array, p_type = oap.read_oap_file("example01.oap")
    >>> oap.print_array(array)
          1 1 1 2 2 1
        1 2 3 2 3 3 2 2 2 2 3 2 2 1 1
        1 2 3 3 3 3 2 2 2 2 3 2 2 2 2 1 1 2 1 1 1
        2 3 3 3 3 3 2 3 3 2 3 3 3 3 3 2 2 3 2 2 2 2 2 2 2   1
        2 3 3 3 3 3 2 3 3 3 3 3 3 3 3 3 2 3 2 3 3 2 2 2 3 1 1
          1 2 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 2 2 2 2
              2 2 1 2 2 2 3 3 2 3 3 3 3 3 3 3 3 3 3 3 2 3 3 2
                          1 1   1 2 2 3 2 3 3 3 3 3 3 2 3 3 2
                                1 1 2 1 2 2 3 3 3 3 3 2 3 2 1
                                                  1 1 1 1
    >>> p_type == oap.COLUMN
    True
If the given particle types are not sufficient, you can use unused bytes to define your own types. For example:
::
    >>> oap.array_as_oap_file(array, "example02", p_type=b'x')
    >>> array, p_type = oap.oap.read_oap_file("example02.oap")
    >>> p_type
    b'x'