Construct an identity matrix of size $m \times n$ . More...

Public Member Functions
pure real(dp) function, dimension(:,:), allocatable	la_eye_d (m, n, mold)
	Function to construct an identity matrix of size `m x n`. This function returns a diagonal identity matrix, with the diagonal elements equal to 1 and all other elements set to 0.

pure real(qp) function, dimension(:,:), allocatable	la_eye_q (m, n, mold)
	Function to construct an identity matrix of size `m x n`. This function returns a diagonal identity matrix, with the diagonal elements equal to 1 and all other elements set to 0.

pure complex(sp) function, dimension(:,:), allocatable	la_eye_c (m, n, mold)
	Function to construct an identity matrix of size `m x n`. This function returns a diagonal identity matrix, with the diagonal elements equal to 1 and all other elements set to 0.

pure complex(dp) function, dimension(:,:), allocatable	la_eye_z (m, n, mold)
	Function to construct an identity matrix of size `m x n`. This function returns a diagonal identity matrix, with the diagonal elements equal to 1 and all other elements set to 0.

pure complex(qp) function, dimension(:,:), allocatable	la_eye_w (m, n, mold)
	Function to construct an identity matrix of size `m x n`. This function returns a diagonal identity matrix, with the diagonal elements equal to 1 and all other elements set to 0.

real(sp) function, dimension(:,:), allocatable	la_eye_s_errhandle (m, n, mold, err)
	Function to construct an identity matrix of size `m x n`. This function returns a diagonal identity matrix, with the diagonal elements equal to 1 and all other elements set to 0.

real(dp) function, dimension(:,:), allocatable	la_eye_d_errhandle (m, n, mold, err)
	Function to construct an identity matrix of size `m x n`. This function returns a diagonal identity matrix, with the diagonal elements equal to 1 and all other elements set to 0.

real(qp) function, dimension(:,:), allocatable	la_eye_q_errhandle (m, n, mold, err)
	Function to construct an identity matrix of size `m x n`. This function returns a diagonal identity matrix, with the diagonal elements equal to 1 and all other elements set to 0.

complex(sp) function, dimension(:,:), allocatable	la_eye_c_errhandle (m, n, mold, err)
	Function to construct an identity matrix of size `m x n`. This function returns a diagonal identity matrix, with the diagonal elements equal to 1 and all other elements set to 0.

complex(dp) function, dimension(:,:), allocatable	la_eye_z_errhandle (m, n, mold, err)
	Function to construct an identity matrix of size `m x n`. This function returns a diagonal identity matrix, with the diagonal elements equal to 1 and all other elements set to 0.

complex(qp) function, dimension(:,:), allocatable	la_eye_w_errhandle (m, n, mold, err)
	Function to construct an identity matrix of size `m x n`. This function returns a diagonal identity matrix, with the diagonal elements equal to 1 and all other elements set to 0.

Detailed Description

Construct an identity matrix of size $m \times n$ .

This function returns a diagonal identity matrix of size $m \times n$ , where all diagonal elements are set to 1 and all off-diagonal elements are set to 0. The number of rows and columns can be specified. If only one parameter is provided, a square matrix of size $m \times m$ is returned.

Parameters

[in]	m	The number of rows of the identity matrix.
[in]	n	(Optional) The number of columns of the identity matrix. If omitted, the matrix is square ( $m \times m$ ).
[in]	mold	(Optional) Data type to define the return type. Defaults to `real(real64)`.

Returns: The identity matrix with size $m \times n$ .

Note: If the mold parameter is omitted, the default type is real(real64). If specified, the return type matches the given type.

Warning: Ensure that the matrix dimensions are valid and consistent with the type definition.

Return a square diagonal matrix with diagonal values.

This function generates a square diagonal matrix where the diagonal elements are either equal to the specified scalar value or populated by the input array. The size of the matrix is determined by the input parameter $n$ or the size of the input array.

Parameters

[in]	n	The size of the square matrix (only used if a scalar is provided for the diagonal).
[in]	source	If a scalar, this value is used to populate the diagonal of the matrix. If an array, the elements of the array are used for the diagonal.
[out]	err	(Optional) State return flag. If not provided, the function will stop on error.

Returns: The diagonal matrix with size $n \times n$ , where the diagonal elements are populated by $source$ .

Note: If a scalar value is passed, the diagonal elements of the matrix will all be equal to $source$ . If an array is passed, its length determines the size of the matrix, and the array elements are placed along the diagonal. The err parameter is optional. If not requested, the code will stop on error. Otherwise, it returns the error state of the function.