httk.atomistic.models.protostructure.api
========================================

.. py:module:: httk.atomistic.models.protostructure.api

.. autoapi-nested-parse::

   The geometry-free protostructure interface.



Classes
-------

.. autoapisummary::

   httk.atomistic.models.protostructure.api.ProtostructureAPI


Module Contents
---------------

.. py:class:: ProtostructureAPI

   Bases: :py:obj:`abc.ABC`


   The common interface for standard-setting occupied Wyckoff positions.

   Composition and formula derivations from this interface use the standard-setting
   conventional-cell scale, independently of the setting or transform of a source
   structure from which a protostructure was recognized.


   .. py:property:: spacegroup
      :type: httk.atomistic.symmetry.spacegroup.Spacegroup

      :abstractmethod:


      Return the standard-setting space group.


   .. py:property:: occupations
      :type: tuple[httk.atomistic.models.protostructure.occupation.WyckoffOccupation, Ellipsis]

      :abstractmethod:


      Return the occupied Wyckoff positions in canonical order.


   .. py:method:: multiplicities()

      Return tabulated standard-setting multiplicities for each occupation.

      These are deliberately not multiplicities from a source structure's transform;
      they define the provenance-independent conventional-cell scale of this value.

      :return: The standard-setting multiplicity for each occupation.



   .. py:property:: nsites_conventional
      :type: int


      Return the total number of sites in the standard conventional cell.

      :return: The conventional-cell site count.


   .. py:property:: formula
      :type: httk.atomistic.models.formula.formula_view.ChemicalFormulaView


      Return a reduced formula at the standard conventional-cell scale.

      :return: The conventional-cell reduced formula view.


   .. py:property:: anonymous_formula
      :type: httk.atomistic.models.formula.anonymous_view.AnonymousFormulaView


      Return a reduced anonymous formula at the standard conventional-cell scale.

      :return: The conventional-cell anonymous formula view.


   .. py:property:: protostructure
      :type: Self


      Return this protostructure value.