行列のトレースの計算

Namespace: FVIL.Data
Assembly: FVILbasic (in FVILbasic.dll) Version: 3.1.0.0 (3.1.0.17)

Syntax

C#
public virtual double trace()
Visual Basic
Public Overridable Function trace As Double

Return Value

Type: Double
現在の行列(正方行列)のトレース(対角成分の和)を計算して返します。
現在の行列の内容は更新されません。

Remarks

生成に失敗した場合は例外を発行します。 例外の原因と発生位置を特定するには、発行された例外クラスの ErrorCode メンバと Function メンバを参照してください。

エラーコード：

値ErrorCode メンバ内容
51FVIL.ErrorCode.LICENSE_ERRORライセンスがありません。
1FVIL.ErrorCode.FAILED_TO_ALLOCATEメモリの確保に失敗しました。
11FVIL.ErrorCode.INVALID_PARAMETERパラメータが不正です。
12FVIL.ErrorCode.INVALID_OBJECTメモリが確保されていません。
29FVIL.ErrorCode.NOT_CALCULABLE計算できません。

関連する FIE 関数：

fnFIE_mat_trace

Examples

ソースコード:
C# Copy imageCopy
//    $Revision: 1.2 $

using System;
using System.Collections.Generic;
using System.Text;
using fvalgcli;    // FvPluginXXXX attribute requires fvalgcli

namespace User.SampleCode
{
    public partial class Matrix
    {
        /// <summary>
        /// 行列のトレースの計算.
        /// </summary>
        [FvPluginExecute]
        public void trace()
        {
            int rows = 4;
            int columns = 4;
            // 1) インスタンスの準備.
            FVIL.Data.CFviMatrix mat = new FVIL.Data.CFviMatrix(rows, columns);

            // 2) 行列の要素の設定.
            mat[0, 0] = 1.0; mat[0, 1] = 5.0; mat[0, 2] = 9.0; mat[0, 3] = 13.0;
            mat[1, 0] = 2.0; mat[1, 1] = 6.0; mat[1, 2] = 10.0; mat[1, 3] = 14.0;
            mat[2, 0] = 3.0; mat[2, 1] = 7.0; mat[2, 2] = 11.0; mat[2, 3] = 15.0;
            mat[3, 0] = 4.0; mat[3, 1] = 8.0; mat[3, 2] = 12.0; mat[3, 3] = 16.0;

            // 3) 計算実行.
            double result = mat.trace();

            // 確認) 処理結果の出力.
            Console.Write("CFviMatrix.trace\n");
            Console.Write("result = {0}\n", result);
        }
    }
}

Visual Basic Copy imageCopy
'    $Revision: 1.1 $

Imports System.Collections.Generic
Imports System.Text
Imports fvalgcli
' FvPluginXXXX attribute requires fvalgcli
Namespace SampleCode
    Public Partial Class Matrix
        ''' <summary>
        ''' 行列のトレースの計算.
        ''' </summary>
        <FvPluginExecute> _
        Public Sub trace()
            Dim rows As Integer = 4
            Dim columns As Integer = 4
            ' 1) インスタンスの準備.
            Dim mat As New FVIL.Data.CFviMatrix(rows, columns)

            ' 2) 行列の要素の設定.
            mat(0, 0) = 1.0
            mat(0, 1) = 5.0
            mat(0, 2) = 9.0
            mat(0, 3) = 13.0
            mat(1, 0) = 2.0
            mat(1, 1) = 6.0
            mat(1, 2) = 10.0
            mat(1, 3) = 14.0
            mat(2, 0) = 3.0
            mat(2, 1) = 7.0
            mat(2, 2) = 11.0
            mat(2, 3) = 15.0
            mat(3, 0) = 4.0
            mat(3, 1) = 8.0
            mat(3, 2) = 12.0
            mat(3, 3) = 16.0

            ' 3) 計算実行.
            Dim result As Double = mat.trace()

            ' 確認) 処理結果の出力.
            Console.Write("CFviMatrix.trace" & vbLf)
            Console.Write("result = {0}" & vbLf, result)
        End Sub
    End Class
End Namespace
【関数の出力】
CFviMatrix.trace
result = 34

Exceptions

ExceptionCondition
FVIL..::..CFviExceptionこの例外の原因については、上記のエラーコード表をご参照ください。

See Also