httk.atomistic.models.bareprotostructure.api
============================================

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

.. autoapi-nested-parse::

   The assigned-species Wyckoff-only classification interface.



Classes
-------

.. autoapisummary::

   httk.atomistic.models.bareprotostructure.api.BareProtostructureAPI


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

.. py:class:: BareProtostructureAPI

   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, ...]

      :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.formulatype_view.FormulatypeView


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

      :return: The conventional-cell anonymous formula view.


   .. py:property:: label
      :type: httk.atomistic.models.bareprotostructure.label.BareProtostructureLabel


      Return the httk protostructure label of this protostructure.

      The label's unsuffixed part orders classes by their Wyckoff letters, so it is the
      prototype label of the erased anonymous prototype; the suffix lists the class species names.
      This is NOT an AFLOW label: AFLOW orders classes alphabetically by element (see
      :attr:`aflow_label`). Any faithful render is *the* protostructure label; the
      *canonical* protostructure label comes from a normalizer-canonical protostructure.

      :return: The protostructure label view.


   .. py:property:: aflow_label
      :type: str


      Return the AFLOW-style label of this protostructure.

      Unlike :attr:`label`, AFLOW orders classes alphabetically by element symbol and
      reassigns the anonymous symbols in that order, so the unsuffixed prefix depends on
      the chemistry. Provided for interoperability only.

      :return: The AFLOW-style label text.


   .. py:property:: bare_protostructure
      :type: Self


      Return this protostructure value.