la_eig::eig Interface Reference

Eigendecomposition of a square matrix: return eigenvalues, and optionally eigenvectors. More...

Public Member Functions
subroutine	la_eig_standard_s (a, lambda, right, left, overwrite_a, err)
subroutine	la_eig_standard_d (a, lambda, right, left, overwrite_a, err)
subroutine	la_eig_standard_q (a, lambda, right, left, overwrite_a, err)
subroutine	la_eig_standard_c (a, lambda, right, left, overwrite_a, err)
subroutine	la_eig_standard_z (a, lambda, right, left, overwrite_a, err)
subroutine	la_eig_standard_w (a, lambda, right, left, overwrite_a, err)
subroutine	la_real_eig_standard_s (a, lambda, right, left, overwrite_a, err)
subroutine	la_real_eig_standard_d (a, lambda, right, left, overwrite_a, err)
subroutine	la_real_eig_standard_q (a, lambda, right, left, overwrite_a, err)
subroutine	la_eig_generalized_s (a, b, lambda, right, left, overwrite_a, overwrite_b, err)
subroutine	la_eig_generalized_d (a, b, lambda, right, left, overwrite_a, overwrite_b, err)
subroutine	la_eig_generalized_q (a, b, lambda, right, left, overwrite_a, overwrite_b, err)
subroutine	la_eig_generalized_c (a, b, lambda, right, left, overwrite_a, overwrite_b, err)
subroutine	la_eig_generalized_z (a, b, lambda, right, left, overwrite_a, overwrite_b, err)
subroutine	la_eig_generalized_w (a, b, lambda, right, left, overwrite_a, overwrite_b, err)
subroutine	la_real_eig_generalized_s (a, b, lambda, right, left, overwrite_a, overwrite_b, err)
subroutine	la_real_eig_generalized_d (a, b, lambda, right, left, overwrite_a, overwrite_b, err)
subroutine	la_real_eig_generalized_q (a, b, lambda, right, left, overwrite_a, overwrite_b, err)

Detailed Description

Eigendecomposition of a square matrix: return eigenvalues, and optionally eigenvectors.

Eigenvalues of a square matrix Eigendecomposition of a real symmetric or complex hermitian matrix Eigenvalues of a real symmetric or complex hermitian matrix

Member Function/Subroutine Documentation

la_eig_generalized_c()

subroutine la_eig::eig::la_eig_generalized_c	(	complex(sp), dimension(:,:), intent(inout), target	a,
		complex(sp), dimension(:,:), intent(inout), target	b,
		complex(sp), dimension(:), intent(out)	lambda,
		complex(sp), dimension(:,:), intent(out), optional, target	right,
		complex(sp), dimension(:,:), intent(out), optional, target	left,
		logical(lk), intent(in), optional	overwrite_a,
		logical(lk), intent(in), optional	overwrite_b,
		type(la_state), intent(out), optional	err
	)

Parameters

[in,out]	a	Input matrix A[m,n]
[in,out]	b	Generalized problem matrix B[n,n]
[out]	lambda	Array of eigenvalues
[out]	right	[optional] RIGHT eigenvectors of A (as columns)
[out]	left	[optional] LEFT eigenvectors of A (as columns)
[in]	overwrite_a	[optional] Can A data be overwritten and destroyed? (default: no)
[in]	overwrite_b	[optional] Can B data be overwritten and destroyed? (default: no)
[out]	err	[optional] state return flag. On error if not requested, the code will stop

la_eig_generalized_d()

subroutine la_eig::eig::la_eig_generalized_d	(	real(dp), dimension(:,:), intent(inout), target	a,
		real(dp), dimension(:,:), intent(inout), target	b,
		complex(dp), dimension(:), intent(out)	lambda,
		complex(dp), dimension(:,:), intent(out), optional, target	right,
		complex(dp), dimension(:,:), intent(out), optional, target	left,
		logical(lk), intent(in), optional	overwrite_a,
		logical(lk), intent(in), optional	overwrite_b,
		type(la_state), intent(out), optional	err
	)

Parameters

[in,out]	a	Input matrix A[m,n]
[in,out]	b	Generalized problem matrix B[n,n]
[out]	lambda	Array of eigenvalues
[out]	right	[optional] RIGHT eigenvectors of A (as columns)
[out]	left	[optional] LEFT eigenvectors of A (as columns)
[in]	overwrite_a	[optional] Can A data be overwritten and destroyed? (default: no)
[in]	overwrite_b	[optional] Can B data be overwritten and destroyed? (default: no)
[out]	err	[optional] state return flag. On error if not requested, the code will stop

la_eig_generalized_q()

subroutine la_eig::eig::la_eig_generalized_q	(	real(qp), dimension(:,:), intent(inout), target	a,
		real(qp), dimension(:,:), intent(inout), target	b,
		complex(qp), dimension(:), intent(out)	lambda,
		complex(qp), dimension(:,:), intent(out), optional, target	right,
		complex(qp), dimension(:,:), intent(out), optional, target	left,
		logical(lk), intent(in), optional	overwrite_a,
		logical(lk), intent(in), optional	overwrite_b,
		type(la_state), intent(out), optional	err
	)

Parameters

[in,out]	a	Input matrix A[m,n]
[in,out]	b	Generalized problem matrix B[n,n]
[out]	lambda	Array of eigenvalues
[out]	right	[optional] RIGHT eigenvectors of A (as columns)
[out]	left	[optional] LEFT eigenvectors of A (as columns)
[in]	overwrite_a	[optional] Can A data be overwritten and destroyed? (default: no)
[in]	overwrite_b	[optional] Can B data be overwritten and destroyed? (default: no)
[out]	err	[optional] state return flag. On error if not requested, the code will stop

la_eig_generalized_s()

subroutine la_eig::eig::la_eig_generalized_s	(	real(sp), dimension(:,:), intent(inout), target	a,
		real(sp), dimension(:,:), intent(inout), target	b,
		complex(sp), dimension(:), intent(out)	lambda,
		complex(sp), dimension(:,:), intent(out), optional, target	right,
		complex(sp), dimension(:,:), intent(out), optional, target	left,
		logical(lk), intent(in), optional	overwrite_a,
		logical(lk), intent(in), optional	overwrite_b,
		type(la_state), intent(out), optional	err
	)

Parameters

[in,out]	a	Input matrix A[m,n]
[in,out]	b	Generalized problem matrix B[n,n]
[out]	lambda	Array of eigenvalues
[out]	right	[optional] RIGHT eigenvectors of A (as columns)
[out]	left	[optional] LEFT eigenvectors of A (as columns)
[in]	overwrite_a	[optional] Can A data be overwritten and destroyed? (default: no)
[in]	overwrite_b	[optional] Can B data be overwritten and destroyed? (default: no)
[out]	err	[optional] state return flag. On error if not requested, the code will stop

la_eig_generalized_w()

subroutine la_eig::eig::la_eig_generalized_w	(	complex(qp), dimension(:,:), intent(inout), target	a,
		complex(qp), dimension(:,:), intent(inout), target	b,
		complex(qp), dimension(:), intent(out)	lambda,
		complex(qp), dimension(:,:), intent(out), optional, target	right,
		complex(qp), dimension(:,:), intent(out), optional, target	left,
		logical(lk), intent(in), optional	overwrite_a,
		logical(lk), intent(in), optional	overwrite_b,
		type(la_state), intent(out), optional	err
	)

Parameters

[in,out]	a	Input matrix A[m,n]
[in,out]	b	Generalized problem matrix B[n,n]
[out]	lambda	Array of eigenvalues
[out]	right	[optional] RIGHT eigenvectors of A (as columns)
[out]	left	[optional] LEFT eigenvectors of A (as columns)
[in]	overwrite_a	[optional] Can A data be overwritten and destroyed? (default: no)
[in]	overwrite_b	[optional] Can B data be overwritten and destroyed? (default: no)
[out]	err	[optional] state return flag. On error if not requested, the code will stop

la_eig_generalized_z()

subroutine la_eig::eig::la_eig_generalized_z	(	complex(dp), dimension(:,:), intent(inout), target	a,
		complex(dp), dimension(:,:), intent(inout), target	b,
		complex(dp), dimension(:), intent(out)	lambda,
		complex(dp), dimension(:,:), intent(out), optional, target	right,
		complex(dp), dimension(:,:), intent(out), optional, target	left,
		logical(lk), intent(in), optional	overwrite_a,
		logical(lk), intent(in), optional	overwrite_b,
		type(la_state), intent(out), optional	err
	)

Parameters

[in,out]	a	Input matrix A[m,n]
[in,out]	b	Generalized problem matrix B[n,n]
[out]	lambda	Array of eigenvalues
[out]	right	[optional] RIGHT eigenvectors of A (as columns)
[out]	left	[optional] LEFT eigenvectors of A (as columns)
[in]	overwrite_a	[optional] Can A data be overwritten and destroyed? (default: no)
[in]	overwrite_b	[optional] Can B data be overwritten and destroyed? (default: no)
[out]	err	[optional] state return flag. On error if not requested, the code will stop

la_eig_standard_c()

subroutine la_eig::eig::la_eig_standard_c	(	complex(sp), dimension(:,:), intent(inout), target	a,
		complex(sp), dimension(:), intent(out)	lambda,
		complex(sp), dimension(:,:), intent(out), optional, target	right,
		complex(sp), dimension(:,:), intent(out), optional, target	left,
		logical(lk), intent(in), optional	overwrite_a,
		type(la_state), intent(out), optional	err
	)

Parameters

[in,out]	a	Input matrix A[m,n]
[out]	lambda	Array of eigenvalues
[out]	right	[optional] RIGHT eigenvectors of A (as columns)
[out]	left	[optional] LEFT eigenvectors of A (as columns)
[in]	overwrite_a	[optional] Can A data be overwritten and destroyed? (default: no)
[out]	err	[optional] state return flag. On error if not requested, the code will stop

la_eig_standard_d()

subroutine la_eig::eig::la_eig_standard_d	(	real(dp), dimension(:,:), intent(inout), target	a,
		complex(dp), dimension(:), intent(out)	lambda,
		complex(dp), dimension(:,:), intent(out), optional, target	right,
		complex(dp), dimension(:,:), intent(out), optional, target	left,
		logical(lk), intent(in), optional	overwrite_a,
		type(la_state), intent(out), optional	err
	)

Parameters

[in,out]	a	Input matrix A[m,n]
[out]	lambda	Array of eigenvalues
[out]	right	[optional] RIGHT eigenvectors of A (as columns)
[out]	left	[optional] LEFT eigenvectors of A (as columns)
[in]	overwrite_a	[optional] Can A data be overwritten and destroyed? (default: no)
[out]	err	[optional] state return flag. On error if not requested, the code will stop

la_eig_standard_q()

subroutine la_eig::eig::la_eig_standard_q	(	real(qp), dimension(:,:), intent(inout), target	a,
		complex(qp), dimension(:), intent(out)	lambda,
		complex(qp), dimension(:,:), intent(out), optional, target	right,
		complex(qp), dimension(:,:), intent(out), optional, target	left,
		logical(lk), intent(in), optional	overwrite_a,
		type(la_state), intent(out), optional	err
	)

Parameters

[in,out]	a	Input matrix A[m,n]
[out]	lambda	Array of eigenvalues
[out]	right	[optional] RIGHT eigenvectors of A (as columns)
[out]	left	[optional] LEFT eigenvectors of A (as columns)
[in]	overwrite_a	[optional] Can A data be overwritten and destroyed? (default: no)
[out]	err	[optional] state return flag. On error if not requested, the code will stop

la_eig_standard_s()

subroutine la_eig::eig::la_eig_standard_s	(	real(sp), dimension(:,:), intent(inout), target	a,
		complex(sp), dimension(:), intent(out)	lambda,
		complex(sp), dimension(:,:), intent(out), optional, target	right,
		complex(sp), dimension(:,:), intent(out), optional, target	left,
		logical(lk), intent(in), optional	overwrite_a,
		type(la_state), intent(out), optional	err
	)

Parameters

[in,out]	a	Input matrix A[m,n]
[out]	lambda	Array of eigenvalues
[out]	right	[optional] RIGHT eigenvectors of A (as columns)
[out]	left	[optional] LEFT eigenvectors of A (as columns)
[in]	overwrite_a	[optional] Can A data be overwritten and destroyed? (default: no)
[out]	err	[optional] state return flag. On error if not requested, the code will stop

la_eig_standard_w()

subroutine la_eig::eig::la_eig_standard_w	(	complex(qp), dimension(:,:), intent(inout), target	a,
		complex(qp), dimension(:), intent(out)	lambda,
		complex(qp), dimension(:,:), intent(out), optional, target	right,
		complex(qp), dimension(:,:), intent(out), optional, target	left,
		logical(lk), intent(in), optional	overwrite_a,
		type(la_state), intent(out), optional	err
	)

Parameters

[in,out]	a	Input matrix A[m,n]
[out]	lambda	Array of eigenvalues
[out]	right	[optional] RIGHT eigenvectors of A (as columns)
[out]	left	[optional] LEFT eigenvectors of A (as columns)
[in]	overwrite_a	[optional] Can A data be overwritten and destroyed? (default: no)
[out]	err	[optional] state return flag. On error if not requested, the code will stop

la_eig_standard_z()

subroutine la_eig::eig::la_eig_standard_z	(	complex(dp), dimension(:,:), intent(inout), target	a,
		complex(dp), dimension(:), intent(out)	lambda,
		complex(dp), dimension(:,:), intent(out), optional, target	right,
		complex(dp), dimension(:,:), intent(out), optional, target	left,
		logical(lk), intent(in), optional	overwrite_a,
		type(la_state), intent(out), optional	err
	)

Parameters

[in,out]	a	Input matrix A[m,n]
[out]	lambda	Array of eigenvalues
[out]	right	[optional] RIGHT eigenvectors of A (as columns)
[out]	left	[optional] LEFT eigenvectors of A (as columns)
[in]	overwrite_a	[optional] Can A data be overwritten and destroyed? (default: no)
[out]	err	[optional] state return flag. On error if not requested, the code will stop

la_real_eig_generalized_d()

subroutine la_eig::eig::la_real_eig_generalized_d	(	real(dp), dimension(:,:), intent(inout), target	a,
		real(dp), dimension(:,:), intent(inout), target	b,
		real(dp), dimension(:), intent(out)	lambda,
		complex(dp), dimension(:,:), intent(out), optional, target	right,
		complex(dp), dimension(:,:), intent(out), optional, target	left,
		logical(lk), intent(in), optional	overwrite_a,
		logical(lk), intent(in), optional	overwrite_b,
		type(la_state), intent(out), optional	err
	)

Parameters

[in,out]	a	Input matrix A[m,n]
[in,out]	b	Generalized problem matrix B[n,n]
[out]	lambda	Array of real eigenvalues
[out]	right	The columns of RIGHT contain the right eigenvectors of A
[out]	left	The columns of LEFT contain the left eigenvectors of A
[in]	overwrite_a	[optional] Can A data be overwritten and destroyed?
[in]	overwrite_b	[optional] Can B data be overwritten and destroyed? (default: no)
[out]	err	[optional] state return flag. On error if not requested, the code will stop

la_real_eig_generalized_q()

subroutine la_eig::eig::la_real_eig_generalized_q	(	real(qp), dimension(:,:), intent(inout), target	a,
		real(qp), dimension(:,:), intent(inout), target	b,
		real(qp), dimension(:), intent(out)	lambda,
		complex(qp), dimension(:,:), intent(out), optional, target	right,
		complex(qp), dimension(:,:), intent(out), optional, target	left,
		logical(lk), intent(in), optional	overwrite_a,
		logical(lk), intent(in), optional	overwrite_b,
		type(la_state), intent(out), optional	err
	)

Parameters

[in,out]	a	Input matrix A[m,n]
[in,out]	b	Generalized problem matrix B[n,n]
[out]	lambda	Array of real eigenvalues
[out]	right	The columns of RIGHT contain the right eigenvectors of A
[out]	left	The columns of LEFT contain the left eigenvectors of A
[in]	overwrite_a	[optional] Can A data be overwritten and destroyed?
[in]	overwrite_b	[optional] Can B data be overwritten and destroyed? (default: no)
[out]	err	[optional] state return flag. On error if not requested, the code will stop

la_real_eig_generalized_s()

subroutine la_eig::eig::la_real_eig_generalized_s	(	real(sp), dimension(:,:), intent(inout), target	a,
		real(sp), dimension(:,:), intent(inout), target	b,
		real(sp), dimension(:), intent(out)	lambda,
		complex(sp), dimension(:,:), intent(out), optional, target	right,
		complex(sp), dimension(:,:), intent(out), optional, target	left,
		logical(lk), intent(in), optional	overwrite_a,
		logical(lk), intent(in), optional	overwrite_b,
		type(la_state), intent(out), optional	err
	)

Parameters

[in,out]	a	Input matrix A[m,n]
[in,out]	b	Generalized problem matrix B[n,n]
[out]	lambda	Array of real eigenvalues
[out]	right	The columns of RIGHT contain the right eigenvectors of A
[out]	left	The columns of LEFT contain the left eigenvectors of A
[in]	overwrite_a	[optional] Can A data be overwritten and destroyed?
[in]	overwrite_b	[optional] Can B data be overwritten and destroyed? (default: no)
[out]	err	[optional] state return flag. On error if not requested, the code will stop

la_real_eig_standard_d()

subroutine la_eig::eig::la_real_eig_standard_d	(	real(dp), dimension(:,:), intent(inout), target	a,
		real(dp), dimension(:), intent(out)	lambda,
		complex(dp), dimension(:,:), intent(out), optional, target	right,
		complex(dp), dimension(:,:), intent(out), optional, target	left,
		logical(lk), intent(in), optional	overwrite_a,
		type(la_state), intent(out), optional	err
	)

Parameters

[in,out]	a	Input matrix A[m,n]
[out]	lambda	Array of real eigenvalues
[out]	right	The columns of RIGHT contain the right eigenvectors of A
[out]	left	The columns of LEFT contain the left eigenvectors of A
[in]	overwrite_a	[optional] Can A data be overwritten and destroyed?
[out]	err	[optional] state return flag. On error if not requested, the code will stop

la_real_eig_standard_q()

subroutine la_eig::eig::la_real_eig_standard_q	(	real(qp), dimension(:,:), intent(inout), target	a,
		real(qp), dimension(:), intent(out)	lambda,
		complex(qp), dimension(:,:), intent(out), optional, target	right,
		complex(qp), dimension(:,:), intent(out), optional, target	left,
		logical(lk), intent(in), optional	overwrite_a,
		type(la_state), intent(out), optional	err
	)

Parameters

[in,out]	a	Input matrix A[m,n]
[out]	lambda	Array of real eigenvalues
[out]	right	The columns of RIGHT contain the right eigenvectors of A
[out]	left	The columns of LEFT contain the left eigenvectors of A
[in]	overwrite_a	[optional] Can A data be overwritten and destroyed?
[out]	err	[optional] state return flag. On error if not requested, the code will stop

la_real_eig_standard_s()

subroutine la_eig::eig::la_real_eig_standard_s	(	real(sp), dimension(:,:), intent(inout), target	a,
		real(sp), dimension(:), intent(out)	lambda,
		complex(sp), dimension(:,:), intent(out), optional, target	right,
		complex(sp), dimension(:,:), intent(out), optional, target	left,
		logical(lk), intent(in), optional	overwrite_a,
		type(la_state), intent(out), optional	err
	)

Parameters

[in,out]	a	Input matrix A[m,n]
[out]	lambda	Array of real eigenvalues
[out]	right	The columns of RIGHT contain the right eigenvectors of A
[out]	left	The columns of LEFT contain the left eigenvectors of A
[in]	overwrite_a	[optional] Can A data be overwritten and destroyed?
[out]	err	[optional] state return flag. On error if not requested, the code will stop

---

The documentation for this interface was generated from the following file:

• la_eigs.f90