Matrix.Generators.cs

using System;

namespace ABCNET.Utils
{
    /// <summary>
    /// Ïðåäîñòàâëÿåò ôóíêöèîíàë äëÿ ðàáîòû ñ ìàòðèöàìè.
    /// </summary>
    public static partial class Matrix
    {
        #region public
        /// <summary>
        /// Ñîçäà¸ò ìàòðèöó èç óêàçàííûõ çíà÷åíèé.
        /// </summary>
        ///  <param name="rowsCount">Êîëè÷åñòâî ñòðîê.</param>
        /// <param name="colsCount">Êîëè÷åñòâî ñòîëáöîâ.</param>
        /// <param name="values">Çíà÷åíèÿ.</param>
        /// <returns>Ìàòðèöà.</returns>
        public static T[,] Of<T>(int rowsCount, int colsCount, params T[] values)
        {
            if (values == null)
                throw new ArgumentNullException(nameof(values));
            if (rowsCount < 0)
                throw new ArgumentOutOfRangeException(nameof(rowsCount));
            if (colsCount < 0)
                throw new ArgumentOutOfRangeException(nameof(colsCount));
            if (rowsCount * colsCount != values.Length)
                throw new ArgumentNullException(nameof(values));

            T[,] source = new T[rowsCount, colsCount];
            int k = 0;
            for (int i = 0; i < rowsCount; i++)
                for (int j = 0; j < colsCount; j++)
                {
                    source[i, j] = values[k];
                    k++;
                }

            return source;
        }

        /// <summary>
        /// Ñîçäà¸ò ìàòðèöó íà îñíîâå ôóíêöèè ñåëåêòîðà.
        /// </summary>
        /// <param name="rowsCount">Êîëè÷åñòâî ñòðîê.</param>
        /// <param name="colsCount">Êîëè÷åñòâî ñòîëáöîâ.</param>
        /// <param name="selector">Ôóíêöèÿ ñåëåêòîð.</param>
        /// <param name="rowFirstIndex">Íà÷àëüíûé èíäåêñ ñòðîêè.</param>
        /// <param name="columnFirstIndex">Íà÷àëüíûé èíäåêñ ñòîëáöà.</param>
        /// <returns>Ìàòðèöà.</returns>
        public static T[,] By<T>(int rowsCount, int colsCount, Func<int, int, T> selector, int rowFirstIndex = 0, int columnFirstIndex = 0)
        {
            if (rowsCount < 0)
                throw new ArgumentOutOfRangeException(nameof(rowsCount));
            if (colsCount < 0)
                throw new ArgumentOutOfRangeException(nameof(colsCount));
            if (selector == null)
                throw new ArgumentNullException(nameof(selector));
            
            T[,] source = new T[rowsCount, colsCount];
            for (int i = 0; i < source.GetLength(0); i++)
                for (int j = 0; j < source.GetLength(1); j++)
                    source[i, j] = selector(i + rowFirstIndex, j + columnFirstIndex);

            return source;
        }

        /// <summary>
        /// Ñîçäà¸ò ìàòðèöó ñëó÷àéíûõ ÷èñåë òèïà Int32.
        /// </summary>
        /// <param name="rowsCount">Êîëè÷åñòâî ñòðîê.</param>
        /// <param name="colsCount">Êîëè÷åñòâî ñòîëáöîâ.</param>
        /// <param name="low">Íèæíÿÿ ãðàíèöà äèàïàçîíà.</param>
        /// <param name="high">Âåðõíÿÿ ãðàíèöà äèàïàçîíà.</param>
        /// <returns>Ìàòðèöà.</returns>
        public static int[,] Random(int rowsCount, int colsCount, int low = Int32BordersHelper.Low, int high = Int32BordersHelper.High)
        {
            if (rowsCount < 0)
                throw new ArgumentOutOfRangeException(nameof(rowsCount));
            if (colsCount < 0)
                throw new ArgumentOutOfRangeException(nameof(colsCount));
            if (low > high)
                throw new ArgumentException(nameof(low));

            int[,] source = new int[rowsCount, colsCount];
            for (int i = 0; i < source.GetLength(0); i++)
                for (int j = 0; j < source.GetLength(1); j++)
                    source[i, j] = Base.Random(low, high);

            return source;
        }

        /// <summary>
        /// Ñîçäà¸ò ìàòðèöó ñëó÷àéíûõ ÷èñåë òèïà Double.
        /// </summary>
        /// <param name="rowsCount">Êîëè÷åñòâî ñòðîê.</param>
        /// <param name="colsCount">Êîëè÷åñòâî ñòîëáöîâ.</param>
        /// <param name="low">Íèæíÿÿ ãðàíèöà äèàïàçîíà.</param>
        /// <param name="high">Âåðõíÿÿ ãðàíèöà äèàïàçîíà.</param>
        /// <returns>Ìàòðèöà.</returns>
        public static double[,] Random(int rowsCount, int colsCount, double low = DoubleBordersHelper.Low, double high = DoubleBordersHelper.High)
        {
            if (rowsCount < 0)
                throw new ArgumentOutOfRangeException(nameof(rowsCount));
            if (colsCount < 0)
                throw new ArgumentOutOfRangeException(nameof(colsCount));
            if (low > high)
                throw new ArgumentException(nameof(low));

            double[,] source = new double[rowsCount, colsCount];
            for (int i = 0; i < source.GetLength(0); i++)
                for (int j = 0; j < source.GetLength(1); j++)
                    source[i, j] = Base.Random(low, high);

            return source;
        }

        /// <summary>
        /// Ñîçäà¸ò ìàòðèöó, çàïîëíåííóþ óêàçàííûì çíà÷åíèåì.
        /// </summary>
        /// <param name="rowsCount">Êîëè÷åñòâî ñòðîê.</param>
        /// <param name="colsCount">Êîëè÷åñòâî ñòîëáöîâ.</param>
        /// <param name="value">Çíà÷åíèå.</param>
        /// <returns>Ìàññèâ.</returns>
        public static T[,] Fill<T>(int rowsCount, int colsCount, T value)
        {
            if (rowsCount < 0)
                throw new ArgumentOutOfRangeException(nameof(rowsCount));
            if (colsCount < 0)
                throw new ArgumentOutOfRangeException(nameof(colsCount));

            T[,] source = new T[rowsCount, colsCount];
            for (int i = 0; i < source.GetLength(0); i++)
                for (int j = 0; j < source.GetLength(1); j++)
                    source[i, j] = value;

            return source;
        }
        #endregion public
    }
}