naginterfaces.library.sparseig.feast_​free

naginterfaces.library.sparseig.feast_free(handle)[source]

feast_free part of the NAG FEAST suite. It is used to deallocate the memory used within the problem handle and to destroy the handle itself.

For full information please refer to the NAG Library document for f12jz

https://www.nag.com/numeric/nl/nagdoc_29.3/flhtml/f12/f12jzf.html

Parameters
handleHandle, modified in place

On entry: the handle to the problem. It needs to be initialized (e.g., by feast_init()) and to hold a problem formulation compatible with feast_free. It must not be changed between calls to the NAG FEAST suite.

On exit: the handle is destroyed and set to a null Handle.

Raises
NagValueError
(errno )

The supplied was not initialized or has become corrupted.

Notes

Each initialized problem handle (e.g., by feast_init()) should be deallocated to avoid memory leaks. Therefore, feast_free should be called on all the handles which are no longer needed, typically after obtaining results from the solver. Please note that passing a handle which has not been properly initialized might cause unpredictable behaviour, including a crash of your program. See the F12 Introduction for more details about the NAG FEAST suite.

References

Polizzi, E, 2009, Density-Matrix-Based Algorithms for Solving Eigenvalue Problems, Phys. Rev. B. (79), 115112