httk.atomistic.entries.definitions
==================================

.. py:module:: httk.atomistic.entries.definitions

.. autoapi-nested-parse::

   Loading the vendored property definitions published by schemas.httk.org.

   OPTIMADE standardises a good deal about a structure but nothing about *which setting* it is
   written in, nor about how precisely its numbers were stated. Both are served here as
   database-specific properties, and rather than describing them locally the descriptions are
   taken from the published definitions at `schemas.httk.org <https://schemas.httk.org>`_,
   vendored verbatim in ``httk.registry.schemas.atomistic``.

   The served *name* carries the ``_httk_`` prefix that OPTIMADE requires of a
   database-specific property; the definition keeps its own ``$id``, so a client following the
   link reaches the authoritative schema rather than a local paraphrase.



Functions
---------

.. autoapisummary::

   httk.atomistic.entries.definitions.load_httk_definitions


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

.. py:function:: load_httk_definitions(names)

   Load vendored property definitions by served name.

   Each document is loaded verbatim, ``$id`` included. Note that a definition's own
   ``x-optimade-definition.name`` stays the unprefixed name it was published under, which
   will differ from the prefixed name httk serves it as — that is correct, and rewriting a
   published document to match a local naming choice would defeat the point of pointing at
   it.

   :param names: A map from served property name to vendored definition stem.
   :return: The loaded definitions keyed by served property name.