Skip to main content

cuestPCMIntegrationGridComputeWorkspaceQuery

Function cuestPCMIntegrationGridComputeWorkspaceQuery 

Source
pub unsafe fn cuestPCMIntegrationGridComputeWorkspaceQuery(
    handle: cuestHandle_t,
    plan: cuestPCMIntPlan_t,
    parameters: cuestPCMIntegrationGridComputeParameters_t,
    temporaryWorkspaceDescriptor: *mut cuestWorkspaceDescriptor_t,
    outGridPoints: *mut f64,
) -> cuestStatus_t
Expand description

@brief Query temporary workspace requirements for PCM grid coordinate computation. @ingroup PCMAdvanced @since v0.2.0

Determines the GPU memory workspace needed to generate the coordinates of molecular integration grid points defined by the provided PCM integral plan. This function must be called before \c cuestPCMIntegrationGridCompute to ensure sufficient allocation.

Only workspace sizes are computed; input and output pointers may be NULL.

@param[in] handle cuEST handle. Must not be NULL. @param[in] plan PCM integral plan (opaque handle) constructed with \c cuestPCMIntPlanCreate. Must not be NULL. @param[in] parameters Compute parameters (\c cuestPCMIntegrationGridComputeParameters_t) Must not be NULL @param[out] temporaryWorkspaceDescriptor Output descriptor for required workspace sizes (in bytes). Must not be NULL. @param outGridPoints Output array for grid point coordinates. May be NULL.

@return

  • \c CUEST_STATUS_SUCCESS on success;
  • \c CUEST_STATUS_INVALID_HANDLE if the cuEST handle is NULL;
  • \c CUEST_STATUS_NULL_POINTER if any required pointer is NULL;
  • \c CUEST_STATUS_INVALID_TYPE if the handle, plan, or parameters type is incorrect;
  • \c CUEST_STATUS_EXCEPTION on device or internal error;
  • \c CUEST_STATUS_UNKNOWN_ERROR otherwise.