DoubleMatrixFindWhile Method

Searches for entries in this instance that matches the conditions defined by the specified predicate, and returns their zero-based linear indexes.

Definition

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

C#

public IndexCollection FindWhile(
	Predicate<double> match
)

VB

Public Function FindWhile ( 
	match As Predicate(Of Double)
) As IndexCollection

C++

public:
IndexCollection^ FindWhile(
	Predicate<double>^ match
)

F#

member FindWhile : 
        match : Predicate<float> -> IndexCollection

Parameters

match PredicateDouble: The predicate that defines the conditions of the entries to search for.

Return Value

IndexCollection
The collection of zero-based linear indexes of the entries that matches the conditions defined by match, if found; otherwise null.

Remarks

Matrix entries are interpreted as well ordered following a column major ordering. The position of an entry in such well ordering is referred to as the linear position of that entry.

Example

In the following example, the negative entries of a data matrix are found.

C#

using System;

namespace Novacta.Analytics.CodeExamples
{
    public class FindWhileExample0  
    {
        public void Main()
        {
            // Create a matrix.
            var data = new double[6] {
               -1,  2,
                2, -3,
                3,  4,
            };
            var matrix = DoubleMatrix.Dense(3, 2, data, StorageOrder.RowMajor);
            Console.WriteLine("The data matrix:");
            Console.WriteLine(matrix);

            // Match negative entries.
            static bool match(double value) { return value < 0.0; }

            // Find the linear indexes of negative entries in data.
            var indexes = matrix.FindWhile(match);

            Console.WriteLine();
            Console.WriteLine("Linear indexes of negative entries in data:");
            Console.WriteLine(indexes);

            // FindWhile is available for read-only matrices:
            // find negative entries using a read-only wrapper of the data matrix.
            ReadOnlyDoubleMatrix readOnlyMatrix = matrix.AsReadOnly();
            indexes = readOnlyMatrix.FindWhile(match);

            Console.WriteLine();
            Console.WriteLine("Using read-only data. Linear indexes of negative entries:");
            Console.WriteLine(indexes);
        }
    }
}

// Executing method Main() produces the following output:
// 
// The data matrix:
// -1               2                
// 2                -3               
// 3                4                
// 
// 
// 
// Linear indexes of negative entries in data:
// 0, 4
// 
// Using read-only data. Linear indexes of negative entries:
// 0, 4

Exceptions

ArgumentNullException

match is null.