Skip to content

kups.application.utils.data

Data structures for application-layer simulation entities.

Adsorbates

Adsorbate thermodynamic parameters and atom data.

Attributes:

Name Type Description
critical_temperatures Array

Critical temperatures per adsorbate species.

critical_pressures Array

Critical pressures per adsorbate species.

acentric_factors Array

Acentric factors per adsorbate species.

atoms Atoms

Per-atom data for all adsorbate atoms.

Source code in src/kups/application/utils/data.py
@dataclass
class Adsorbates:
    """Adsorbate thermodynamic parameters and atom data.

    Attributes:
        critical_temperatures: Critical temperatures per adsorbate species.
        critical_pressures: Critical pressures per adsorbate species.
        acentric_factors: Acentric factors per adsorbate species.
        atoms: Per-atom data for all adsorbate atoms.
    """

    critical_temperatures: Array
    critical_pressures: Array
    acentric_factors: Array
    atoms: Atoms

Atoms

Per-atom arrays shared by host and adsorbate representations.

Attributes:

Name Type Description
positions Array

Cartesian coordinates, shape (n_atoms, 3).

species Array

Integer species indices, shape (n_atoms,).

charges Array

Partial charges, shape (n_atoms,).

masses Array

Atomic masses (amu), shape (n_atoms,).

atomic_numbers Array

Atomic numbers, shape (n_atoms,).

Source code in src/kups/application/utils/data.py
@dataclass
class Atoms:
    """Per-atom arrays shared by host and adsorbate representations.

    Attributes:
        positions: Cartesian coordinates, shape ``(n_atoms, 3)``.
        species: Integer species indices, shape ``(n_atoms,)``.
        charges: Partial charges, shape ``(n_atoms,)``.
        masses: Atomic masses (amu), shape ``(n_atoms,)``.
        atomic_numbers: Atomic numbers, shape ``(n_atoms,)``.
    """

    positions: Array
    species: Array
    charges: Array
    masses: Array
    atomic_numbers: Array

Host

Host framework (e.g. MOF or zeolite) with its unit cell.

Attributes:

Name Type Description
atoms Atoms

Per-atom data for the host framework.

unitcell UnitCell

Periodic unit cell describing the simulation box.

Source code in src/kups/application/utils/data.py
@dataclass
class Host:
    """Host framework (e.g. MOF or zeolite) with its unit cell.

    Attributes:
        atoms: Per-atom data for the host framework.
        unitcell: Periodic unit cell describing the simulation box.
    """

    atoms: Atoms
    unitcell: UnitCell

Molecules

Minimal molecule descriptor carrying species indices.

Attributes:

Name Type Description
species Array

Integer species indices, shape (n_molecules,).

Source code in src/kups/application/utils/data.py
@dataclass
class Molecules:
    """Minimal molecule descriptor carrying species indices.

    Attributes:
        species: Integer species indices, shape ``(n_molecules,)``.
    """

    species: Array