ComplexMatrixElementWiseMultiply(ComplexMatrix, ComplexMatrix) Method

Determines the element wise product of two matrices.

Definition

Namespace: Novacta.Analytics
Assembly: Novacta.Analytics (in Novacta.Analytics.dll) Version: 2.1.0+428f3840cfab98dda567bb0ed350b302533e273a

C#

public static ComplexMatrix ElementWiseMultiply(
	ComplexMatrix left,
	ComplexMatrix right
)

VB

Public Shared Function ElementWiseMultiply ( 
	left As ComplexMatrix,
	right As ComplexMatrix
) As ComplexMatrix

C++

public:
static ComplexMatrix^ ElementWiseMultiply(
	ComplexMatrix^ left, 
	ComplexMatrix^ right
)

F#

static member ElementWiseMultiply : 
        left : ComplexMatrix * 
        right : ComplexMatrix -> ComplexMatrix

Parameters

left ComplexMatrix: The left operand.
right ComplexMatrix: The right operand.

Return Value

ComplexMatrix
The result of element wise multiplying left by right.

Remarks

Let LaTeX equation and be the left number of rows and columns, respectively, and consider its generic entry

Analogously, Let and be the right number of rows and columns, respectively, and let its generic entry given by

LaTeX equation

The method returns a matrix whose generic entry is

LaTeX equation

provided that the dimensions of left agree with those of right; otherwise, an exception is thrown.

Example

In the following example, some matrices are element wise multiplied.

C#

using System;
using System.Numerics;

namespace Novacta.Analytics.CodeExamples
{
    public class ComplexElementWiseMultiplyExample0  
    {
        public void Main()
        {
            // Create the left operand.
            var data = new Complex[6] {
                new(1, -1), new(5, -5),
                new(2, -2), new(6, -6),
                new(3, -3), new(7, -7)
            };
            var left = ComplexMatrix.Dense(3, 2, data, StorageOrder.RowMajor);
            Console.WriteLine("left =");
            Console.WriteLine(left);

            // Create the right operand.
            data = [
                new(-1, 1), new(-5, 5),
                new(-2, 2), new(-6, 6),
                new(-3, 3), new(-7, 7)
            ];
            var right = ComplexMatrix.Dense(3, 2, data, StorageOrder.RowMajor);
            Console.WriteLine("right =");
            Console.WriteLine(right);

            // Element wise multiply left by right.
            var result = ComplexMatrix.ElementWiseMultiply(left, right);

            Console.WriteLine();
            Console.WriteLine("Element wise multiplication: left * right =");
            Console.WriteLine(result);

            // Class ReadOnlyComplexMatrix supports element wise multiplications
            // where some arguments are read-only matrices.
            // Compute the product using a read-only wrapper of left.
            ReadOnlyComplexMatrix readOnlyLeft = left.AsReadOnly();
            result = ReadOnlyComplexMatrix.ElementWiseMultiply(readOnlyLeft, right);

            Console.WriteLine();
            Console.WriteLine("Element wise multiplication: readOnlyLeft * right =");
            Console.WriteLine(result);
        }
    }
}

// Executing method Main() produces the following output:
// 
// left =
// (                1,               -1) (                5,               -5) 
// (                2,               -2) (                6,               -6) 
// (                3,               -3) (                7,               -7) 
// 
// 
// right =
// (               -1,                1) (               -5,                5) 
// (               -2,                2) (               -6,                6) 
// (               -3,                3) (               -7,                7) 
// 
// 
// 
// Element wise multiplication: left * right =
// (                0,                2) (                0,               50) 
// (                0,                8) (                0,               72) 
// (                0,               18) (                0,               98) 
// 
// 
// 
// Element wise multiplication: readOnlyLeft * right =
// (                0,                2) (                0,               50) 
// (                0,                8) (                0,               72) 
// (                0,               18) (                0,               98) 
// 
//

Exceptions

ArgumentNullException	left is null. -or- right is null.
ArgumentException	left and right have not the same number of rows and columns.