DoubleMatrixDivide(DoubleMatrix, Double) Method

Determines the division of a matrix by a scalar.

Definition

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

C#

public static DoubleMatrix Divide(
	DoubleMatrix left,
	double right
)

VB

Public Shared Function Divide ( 
	left As DoubleMatrix,
	right As Double
) As DoubleMatrix

C++

public:
static DoubleMatrix^ Divide(
	DoubleMatrix^ left, 
	double right
)

F#

static member Divide : 
        left : DoubleMatrix * 
        right : float -> DoubleMatrix

Parameters

left DoubleMatrix: The left operand.
right Double: The right operand.

Return Value

DoubleMatrix
The result of dividing left by right.

Remarks

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

The method returns a matrix having the same dimensions of left, whose generic entry is:

LaTeX equation

Example

In the following example, a matrix is divided by a scalar.

C#

using System;

namespace Novacta.Analytics.CodeExamples
{
    public class DivisionExample1  
    {
        public void Main()
        {
            // Create the left operand.
            var data = new double[6] {
                0,  2,  4,
                1,  3,  5,
            };
            var left = DoubleMatrix.Dense(2, 3, data, StorageOrder.RowMajor);
            Console.WriteLine("left =");
            Console.WriteLine(left);

            // Create the right operand.
            double right = 10.0;
            Console.WriteLine("right =");
            Console.WriteLine(right);

            // Divide left by right.
            var result = left / right;

            Console.WriteLine();
            Console.WriteLine("left / right =");
            Console.WriteLine(result);

            // In .NET languages that do not support overloaded operators,
            // you can use the alternative methods named Divide.
            result = DoubleMatrix.Divide(left, right);

            Console.WriteLine();
            Console.WriteLine("DoubleMatrix.Divide(left, right) returns");
            Console.WriteLine();
            Console.WriteLine(result);

            // Both operators and alternative methods are overloaded to 
            // support read-only matrix arguments.
            // Compute the division using a read-only wrapper of left.
            ReadOnlyDoubleMatrix readOnlyLeft = left.AsReadOnly();
            result = readOnlyLeft / right;

            Console.WriteLine();
            Console.WriteLine("readOnlyLeft / right =");
            Console.WriteLine(result);
        }
    }
}

// Executing method Main() produces the following output:
// 
// left =
// 0                2                4                
// 1                3                5                
// 
// 
// right =
// 10
// 
// left / right =
// 0                0.2              0.4              
// 0.1              0.3              0.5              
// 
// 
// 
// DoubleMatrix.Divide(left, right) returns
// 
// 0                0.2              0.4              
// 0.1              0.3              0.5              
// 
// 
// 
// readOnlyLeft / right =
// 0                0.2              0.4              
// 0.1              0.3              0.5              
// 
//

Exceptions

ArgumentNullException

left is null.