pub unsafe fn cuestPCMIntegrationWeightComputeWorkspaceQuery(
handle: cuestHandle_t,
plan: cuestPCMIntPlan_t,
weightType: cuestPCMIntegrationWeightComputeParametersWeightType_t,
parameters: cuestPCMIntegrationWeightComputeParameters_t,
temporaryWorkspaceDescriptor: *mut cuestWorkspaceDescriptor_t,
outGridWeights: *mut f64,
) -> cuestStatus_tExpand description
@brief Query the temporary workspace required (in bytes) for computing PCM integration weights. @ingroup PCMAdvanced @since v0.2.0
Determines GPU memory workspace requirements to compute integration weights on the molecular grid as defined by the provided PCM integral plan. The required workspace depends on the grid structure and selected weight type.
This query should be executed before calling \c cuestPCMIntegrationWeightCompute to ensure that sufficient device memory is available.
@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] weightType Weight type to return (switching function value or zeta). @param[in] parameters Compute parameters (\c cuestPCMIntegrationWeightComputeParameters_t) Must not be NULL @param[out] temporaryWorkspaceDescriptor Output descriptor for required temporary workspace sizes (in bytes). Must not be NULL. @param outGridWeights Optional output buffer for computed weights. 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_INVALID_ARGUMENT if \c weightType is unsupported;
- \c CUEST_STATUS_EXCEPTION on device or internal error;
- \c CUEST_STATUS_UNKNOWN_ERROR otherwise.