ECP Integral Plan

cuest.bindings.cuestECPIntPlanCreate(

*,

handle: cuest.bindings.cuest.cuestHandle,

basis: cuest.bindings.cuest.cuestAOBasisHandle,

xyz: list[float],

numECPAtoms: int,

activeIndices: list[int],

activeAtoms: list[cuest.bindings.cuest.cuestECPAtomHandle],

parameters: cuest.bindings.cuest.Parameters,

persistentWorkspace: int,

temporaryWorkspace: int,

outPlan: cuest.bindings.cuest.cuestECPIntPlanHandle,

) → cuest.bindings.cuest.CuestStatus

Create an ECP integral plan with specified parameters.

Parameters

handle[in]cuestHandle

cuEST handle. Must not be NULL.

basis[in]cuestAOBasisHandle

Handle to cuestAOBasis. Must not be NULL.

xyz[in]List[float]

List of Cartesian coordinates for the atoms in the system (size: 3 * natom) on the CPU. Must not be NULL.

numECPAtoms[in]int

Number of atoms with ECPs.

activeIndices[in]List[int]

List of indices of the atoms with ECPs (size: numECPAtoms) on the CPU. Must not be NULL.

activeAtoms[in]List[cuestECPAtomHandle]

List of ECP atom handles.

parameters[in]cuestECPIntPlanParameters

Handle to cuestECPIntPlanParameters. Must not be NULL.

persistentWorkspaceDescriptor[in]cuestWorkspaceDescriptorHandle

Handle to cuestWorkspaceDescriptor. Must not be NULL.

temporaryWorkspaceDescriptor[in]cuestWorkspaceDescriptorHandle

Handle to cuestWorkspaceDescriptor. Must not be NULL.

outPlan[out]cuestECPIntPlanHandle

Pointer to output ECP integral plan object; receives opaque handle on success. Must not be NULL.

Returns

status[out]CuestStatus

• CUEST_STATUS_SUCCESS on success;

• CUEST_STATUS_INVALID_HANDLE if the cuEST handle is NULL;

• CUEST_STATUS_NULL_POINTER if any required pointer is NULL;

• CUEST_STATUS_INVALID_TYPE if the cuEST handle or parameters are not of the correct type;

• CUEST_STATUS_INVALID_ARGUMENT if numECPAtoms is zero;

• CUEST_STATUS_EXCEPTION or CUEST_STATUS_UNKNOWN_ERROR on error.

cuest.bindings.cuestECPIntPlanCreateWorkspaceQuery(

*,

handle: cuest.bindings.cuest.cuestHandle,

basis: cuest.bindings.cuest.cuestAOBasisHandle,

xyz: list[float],

numECPAtoms: int,

activeIndices: list[int],

activeAtoms: list[cuest.bindings.cuest.cuestECPAtomHandle],

parameters: cuest.bindings.cuest.Parameters,

persistentWorkspaceDescriptor: int,

temporaryWorkspaceDescriptor: int,

outPlan: cuest.bindings.cuest.cuestECPIntPlanHandle,

) → cuest.bindings.cuest.CuestStatus

Query the temporary workspace required (in bytes) for an ECP integral plan.

Parameters

handle[in]cuestHandle

cuEST handle. Must not be NULL.

basis[in]cuestAOBasisHandle

Handle to cuestAOBasis. Must not be NULL.

xyz[in]List[float]

List of Cartesian coordinates for the atoms in the system (size: 3 * natom) on the CPU. Must not be NULL.

numECPAtoms[in]int

Number of atoms with ECPs.

activeIndices[in]List[int]

List of indices of the atoms with ECPs (size: numECPAtoms) on the CPU. Must not be NULL.

activeAtoms[in]List[cuestECPAtomHandle]

List of ECP atom handles. Must not be NULL.

parameters[in]cuestECPIntPlanParameters

Handle to cuestECPIntPlanParameters. Must not be NULL.

persistentWorkspaceDescriptor[out]cuestWorkspaceDescriptorHandle

Handle to cuestWorkspaceDescriptor. Must not be NULL.

temporaryWorkspaceDescriptor[out]cuestWorkspaceDescriptorHandle

Handle to cuestWorkspaceDescriptor. Must not be NULL.

outPlan[in]cuestECPIntPlanHandle

Pointer to output ECP integral plan object. May be NULL.

Returns

status[out]CuestStatus

• CUEST_STATUS_SUCCESS on success;

• CUEST_STATUS_INVALID_HANDLE if the cuEST handle is NULL;

• CUEST_STATUS_NULL_POINTER if any required pointer is NULL;

• CUEST_STATUS_INVALID_TYPE if the cuEST handle or parameters are not of the correct type;

• CUEST_STATUS_INVALID_ARGUMENT if numECPAtoms is zero;

• CUEST_STATUS_EXCEPTION or CUEST_STATUS_UNKNOWN_ERROR on error.

cuest.bindings.cuestECPIntPlanDestroy(

*,

handle: cuest.bindings.cuest.cuestECPIntPlanHandle,

) → cuest.bindings.cuest.CuestStatus

Destroy an ECP integral plan object.

Parameters

handle[in]cuestECPIntPlanHandle

Pointer to ECP integral plan object to destroy. Must not be NULL.

Returns

status[out]CuestStatus

• CUEST_STATUS_SUCCESS on success;

• CUEST_STATUS_NULL_POINTER if the ECP integral plan handle is NULL;

• CUEST_STATUS_INVALID_TYPE if the ECP integral plan handle is not of the correct type;

• CUEST_STATUS_EXCEPTION or CUEST_STATUS_UNKNOWN_ERROR on error.