ffsim.UCCSDOpRestricted

class ffsim.UCCSDOpRestricted(t1, t2, final_orbital_rotation=None, validate=True, rtol=1e-05, atol=1e-08)

Bases: SupportsApplyUnitary, SupportsApproximateEquality

Restricted unitary coupled cluster, singles and doubles operator.

UCCSD operator with complex-valued t-amplitudes.

t1

The t1 amplitudes, as a Numpy array of shape (nocc, nvrt).

Type:

np.ndarray

t2

The t2 amplitudes, as a Numpy array of shape (nocc, nocc, nvrt, nvrt).

Type:

np.ndarray

final_orbital_rotation

The optional final orbital rotation, as a Numpy array of shape (norb, norb).

Type:

np.ndarray | None

Parameters:

• validate (InitVar) – Whether to validate the operator attributes. Setting this to False skips validation, which is useful if you need to create many instances of this class and are confident that the attributes are valid.

• rtol (InitVar) – Relative numerical tolerance for validation checks.

• atol (InitVar) – Absolute numerical tolerance for validation checks.

Methods

from_parameters(params, *, norb, nocc[, ...])	Initialize the UCCSD operator from a real-valued parameter vector.
n_params(norb, nocc, *[, ...])	Return the number of parameters of an ansatz with given settings.
to_parameters()	Convert the UCCSD operator to a real-valued parameter vector.

static from_parameters(params, *, norb, nocc, with_final_orbital_rotation=False)

Initialize the UCCSD operator from a real-valued parameter vector.

Parameters:

• params (ndarray) – The real-valued parameter vector.

• norb (int) – The number of spatial orbitals.

• nocc (int) – The number of spatial orbitals that are occupied by electrons.

• with_final_orbital_rotation (bool) – Whether to include a final orbital rotation in the operator.

Return type:

UCCSDOpRestricted

Returns:

The UCCSD operator constructed from the given parameters.

Raises:

ValueError – The number of parameters passed did not match the number expected based on the function inputs.

static n_params(norb, nocc, *, with_final_orbital_rotation=False)

Return the number of parameters of an ansatz with given settings.

Parameters:

• norb (int) – The number of spatial orbitals.

• nocc (int) – The number of spatial orbitals that are occupied by electrons.

• with_final_orbital_rotation (bool) – Whether to include a final orbital rotation in the operator.

Return type:

int

Returns:

The number of parameters of the ansatz.

to_parameters()

Convert the UCCSD operator to a real-valued parameter vector.

Return type:

ndarray

Returns:

The real-valued parameter vector.

Attributes

atol
final_orbital_rotation
norb	The number of spatial orbitals.
rtol
validate
t1
t2