Skip to main contentIBM Quantum Documentation
This page is from an old version of Qiskit SDK and does not exist in the latest version. We recommend you migrate to the latest version. See the release notes for more information.
Important

IBM Quantum Platform is moving and this version will be sunset on July 1. To get started on the new platform, read the migration guide.

qiskit.chemistry.core.MolecularGroundStateResult

class MolecularGroundStateResult(a_dict=None)

GitHub

Molecular Ground State Energy Result.

Energies are in Hartree and dipole moments in A.U unless otherwise stated.

__init__

__init__(a_dict=None)

Initialize self. See help(type(self)) for accurate signature.


Methods

__init__([a_dict])Initialize self.
clear()rtypeNone
combine(result)Any property from the argument that exists in the receiver is updated.
copy()
fromkeys(iterable[, value])
get(k[,d])
has_dipole()Returns whether dipole moment is present in result or not
has_observables()Returns whether result has aux op observables such as spin, num particles
items()
keys()
pop(key[, default])If key is not found, d is returned if given, otherwise KeyError is raised.
popitem()as a 2-tuple; but raise KeyError if D is empty.
setdefault(k[,d])
update(*args, **kwargs)If E present and has a .keys() method, does: for k in E: D[k] = E[k] If E present and lacks .keys() method, does: for (k, v) in E: D[k] = v In either case, this is followed by: for k, v in F.items(): D[k] = v
values()

Attributes

algorithm_resultReturns raw algorithm result
computed_dipole_momentReturns computed electronic part of dipole moment
computed_electronic_energyReturns computed electronic part of ground state energy
dipole_momentReturns dipole moment
dipole_moment_in_debyeReturns dipole moment in Debye
electronic_dipole_momentReturns electronic dipole moment
electronic_energyReturns electronic part of ground state energy
energyReturns ground state energy if nuclear_repulsion_energy is available from driver
formattedFormatted result as a list of strings
frozen_extracted_dipole_momentReturns frozen extracted part of dipole moment
frozen_extracted_energyReturns frozen extracted part of ground state energy
hartree_fock_energyReturns Hartree-Fock energy
magnetizationReturns measured magnetization
nuclear_dipole_momentReturns nuclear dipole moment X,Y,Z components in A.U when available from driver
nuclear_repulsion_energyReturns nuclear repulsion energy when available from driver
num_particlesReturns measured number of particles
ph_extracted_dipole_momentReturns particle hole extracted part of dipole moment
ph_extracted_energyReturns particle hole extracted part of ground state energy
reverse_dipole_signReturns if electronic dipole moment sign should be reversed when adding to nuclear
spinReturns computed spin
total_angular_momentumReturns total angular momentum (S^2)
total_dipole_momentReturns total dipole of moment
total_dipole_moment_in_debyeReturns total dipole of moment in Debye

algorithm_result

Returns raw algorithm result

Return type

AlgorithmResult

clear

clear()

Return type

None

combine

combine(result)

Any property from the argument that exists in the receiver is updated. :type result: AlgorithmResult :param result: Argument result with properties to be set.

Raises

TypeError – Argument is None

Return type

None

computed_dipole_moment

Returns computed electronic part of dipole moment

Return type

Optional[Tuple[Optional[float], Optional[float], Optional[float]]]

computed_electronic_energy

Returns computed electronic part of ground state energy

Return type

float

dipole_moment

Returns dipole moment

Return type

Optional[Tuple[Optional[float], Optional[float], Optional[float]]]

dipole_moment_in_debye

Returns dipole moment in Debye

Return type

Optional[Tuple[Optional[float], Optional[float], Optional[float]]]

electronic_dipole_moment

Returns electronic dipole moment

Return type

Optional[Tuple[Optional[float], Optional[float], Optional[float]]]

electronic_energy

Returns electronic part of ground state energy

Return type

float

energy

Returns ground state energy if nuclear_repulsion_energy is available from driver

Return type

Optional[float]

formatted

Formatted result as a list of strings

Return type

List[str]

frozen_extracted_dipole_moment

Returns frozen extracted part of dipole moment

Return type

Optional[Tuple[Optional[float], Optional[float], Optional[float]]]

frozen_extracted_energy

Returns frozen extracted part of ground state energy

Return type

float

get

get(k[, d]) → D[k] if k in D, else d. d defaults to None.

hartree_fock_energy

Returns Hartree-Fock energy

Return type

float

has_dipole

has_dipole()

Returns whether dipole moment is present in result or not

Return type

bool

has_observables

has_observables()

Returns whether result has aux op observables such as spin, num particles

items

items() → a set-like object providing a view on D’s items

keys

keys() → a set-like object providing a view on D’s keys

magnetization

Returns measured magnetization

Return type

Optional[float]

nuclear_dipole_moment

Returns nuclear dipole moment X,Y,Z components in A.U when available from driver

Return type

Optional[Tuple[Optional[float], Optional[float], Optional[float]]]

nuclear_repulsion_energy

Returns nuclear repulsion energy when available from driver

Return type

Optional[float]

num_particles

Returns measured number of particles

Return type

Optional[float]

ph_extracted_dipole_moment

Returns particle hole extracted part of dipole moment

Return type

Optional[Tuple[Optional[float], Optional[float], Optional[float]]]

ph_extracted_energy

Returns particle hole extracted part of ground state energy

Return type

float

pop

pop(key, default=None)

If key is not found, d is returned if given, otherwise KeyError is raised.

Return type

object

popitem

popitem()

as a 2-tuple; but raise KeyError if D is empty.

Return type

Tuple[object, object]

reverse_dipole_sign

Returns if electronic dipole moment sign should be reversed when adding to nuclear

Return type

bool

setdefault

setdefault(k[, d]) → D.get(k,d), also set D[k]=d if k not in D

spin

Returns computed spin

Return type

Optional[float]

total_angular_momentum

Returns total angular momentum (S^2)

Return type

Optional[float]

total_dipole_moment

Returns total dipole of moment

Return type

Optional[float]

total_dipole_moment_in_debye

Returns total dipole of moment in Debye

Return type

Optional[float]

update

update(*args, **kwargs)

If E present and has a .keys() method, does: for k in E: D[k] = E[k] If E present and lacks .keys() method, does: for (k, v) in E: D[k] = v In either case, this is followed by: for k, v in F.items(): D[k] = v

Return type

None

values

values() → an object providing a view on D’s values

Was this page helpful?
Report a bug or request content on GitHub.