Source code for httk.atomistic.cell_api

"""
The minimal canonical cell interface for httk-atomistic.
"""

from abc import ABC, abstractmethod

from httk.core import SurdScalar, SurdVector




class CellAPI(ABC):
    """
    Abstract base class for the canonical cell interface.

    It declares the exact accessors that every cell backend produces from its own native
    representation and every cell view builds its presentation from: the ``basis`` of 3x3 lattice
    vectors (``scale * unscaled_basis``), the positive ``scale``, and the ``unscaled_basis``. All
    three are exact httk-core vectors; this is the single interchange format, with no pairwise
    conversion between backends.
    """

    @property
    @abstractmethod


    def basis(self) -> SurdVector:
        raise NotImplementedError


    @property
    @abstractmethod


    def scale(self) -> SurdScalar:
        raise NotImplementedError


    @property
    @abstractmethod


    def unscaled_basis(self) -> SurdVector:
        raise NotImplementedError