mirror of
https://github.com/hanzoai/jube-fork.git
synced 2026-10-30 18:33:33 +00:00
richard-churchman
cc0a2bee21
Included open-source Accord.net library code natively to the solution given the deprecated state of that project. Accord.net will be supported inside Jube for own needs (such as upgrading to .Net 7+). Accord.net libraries modified to compile to .Net 6. Modified Accord.net libraries to better support Newtonsoft Json.net serialisation. Included annotations in the Accord.net libraries to house important dependency statistics. Serialised json can be used independently of Jube to recall a Neural Network. Removal of Binary Serializer totally as a precursor to the projects support of .Net 7+. Extensive bug fixing in crucial functions of Neural Network training and recall. While this part of the system remains in Alpha, it is substantially more fit for purpose.
636 lines
25 KiB
C#
636 lines
25 KiB
C#
// Accord Math Library
|
|
// The Accord.NET Framework
|
|
// http://accord-framework.net
|
|
//
|
|
// Copyright © César Souza, 2009-2017
|
|
// cesarsouza at gmail.com
|
|
//
|
|
// This library is free software; you can redistribute it and/or
|
|
// modify it under the terms of the GNU Lesser General Public
|
|
// License as published by the Free Software Foundation; either
|
|
// version 2.1 of the License, or (at your option) any later version.
|
|
//
|
|
// This library is distributed in the hope that it will be useful,
|
|
// but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
// Lesser General Public License for more details.
|
|
//
|
|
// You should have received a copy of the GNU Lesser General Public
|
|
// License along with this library; if not, write to the Free Software
|
|
// Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
|
|
//
|
|
|
|
namespace Accord.Math
|
|
{
|
|
using System;
|
|
|
|
public static partial class Matrix
|
|
{
|
|
|
|
#region ToString
|
|
/// <summary>
|
|
/// Returns a <see cref="System.String"/> representation of a given matrix.
|
|
/// </summary>
|
|
/// <param name="matrix">The matrix.</param>
|
|
/// <returns>
|
|
/// A <see cref="System.String"/> that represents this instance.
|
|
/// </returns>
|
|
///
|
|
/// <example>
|
|
/// Please see <see cref="CSharpMatrixFormatProvider"/>,
|
|
/// <see cref="CSharpJaggedMatrixFormatProvider"/>, <see cref="CSharpArrayFormatProvider"/>,
|
|
/// <see cref="OctaveMatrixFormatProvider"/>, or <see cref="OctaveArrayFormatProvider"/>
|
|
/// for more details.
|
|
/// </example>
|
|
///
|
|
public static string ToString<T>(this T[,] matrix)
|
|
{
|
|
return ToString(matrix, DefaultMatrixFormatProvider.CurrentCulture);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Returns a <see cref="System.String"/> representation of a given matrix.
|
|
/// </summary>
|
|
/// <param name="matrix">The matrix.</param>
|
|
/// <returns>
|
|
/// A <see cref="System.String"/> that represents this instance.
|
|
/// </returns>
|
|
///
|
|
/// <example>
|
|
/// Please see <see cref="CSharpMatrixFormatProvider"/>,
|
|
/// <see cref="CSharpJaggedMatrixFormatProvider"/>, <see cref="CSharpArrayFormatProvider"/>,
|
|
/// <see cref="OctaveMatrixFormatProvider"/>, or <see cref="OctaveArrayFormatProvider"/>
|
|
/// for more details.
|
|
/// </example>
|
|
///
|
|
public static string ToCSharp<T>(this T[,] matrix)
|
|
{
|
|
return ToString(matrix, CSharpMatrixFormatProvider.InvariantCulture);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Returns a <see cref="System.String"/> representation of a given matrix.
|
|
/// </summary>
|
|
/// <param name="matrix">The matrix.</param>
|
|
/// <returns>
|
|
/// A <see cref="System.String"/> that represents this instance.
|
|
/// </returns>
|
|
///
|
|
/// <example>
|
|
/// Please see <see cref="CSharpMatrixFormatProvider"/>,
|
|
/// <see cref="CSharpJaggedMatrixFormatProvider"/>, <see cref="CSharpArrayFormatProvider"/>,
|
|
/// <see cref="OctaveMatrixFormatProvider"/>, or <see cref="OctaveArrayFormatProvider"/>
|
|
/// for more details.
|
|
/// </example>
|
|
///
|
|
public static string ToOctave<T>(this T[,] matrix)
|
|
{
|
|
return ToString(matrix, OctaveMatrixFormatProvider.InvariantCulture);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Returns a <see cref="System.String"/> representation of a given matrix.
|
|
/// </summary>
|
|
///
|
|
/// <param name="matrix">The matrix.</param>
|
|
///
|
|
/// <param name="multiline">
|
|
/// If set to <c>true</c>, the matrix will be written using multiple
|
|
/// lines. If set to <c>false</c>, the matrix will be written in a
|
|
/// single line.</param>
|
|
///
|
|
/// <param name="provider">
|
|
/// The <see cref="IMatrixFormatProvider"/> to be used
|
|
/// when creating the resulting string. Default is to use
|
|
/// <see cref="DefaultMatrixFormatProvider.CurrentCulture"/>.
|
|
/// </param>
|
|
///
|
|
/// <returns>
|
|
/// A <see cref="System.String"/> that represents this instance.
|
|
/// </returns>
|
|
///
|
|
/// <example>
|
|
/// Please see <see cref="CSharpMatrixFormatProvider"/>,
|
|
/// <see cref="CSharpJaggedMatrixFormatProvider"/>, <see cref="CSharpArrayFormatProvider"/>,
|
|
/// <see cref="OctaveMatrixFormatProvider"/>, or <see cref="OctaveArrayFormatProvider"/>
|
|
/// for more details.
|
|
/// </example>
|
|
///
|
|
///
|
|
public static string ToString<T>(this T[,] matrix, bool multiline, IMatrixFormatProvider provider)
|
|
{
|
|
if (multiline)
|
|
{
|
|
return ToString(matrix, Environment.NewLine, provider);
|
|
}
|
|
else
|
|
{
|
|
return ToString(matrix, null, provider);
|
|
}
|
|
}
|
|
|
|
/// <summary>
|
|
/// Returns a <see cref="System.String"/> representation of a given matrix.
|
|
/// </summary>
|
|
///
|
|
/// <param name="matrix">The matrix.</param>
|
|
///
|
|
/// <param name="provider">
|
|
/// The <see cref="IMatrixFormatProvider"/> to be used
|
|
/// when creating the resulting string. Default is to use
|
|
/// <see cref="DefaultMatrixFormatProvider.CurrentCulture"/>.
|
|
/// </param>
|
|
///
|
|
/// <returns>
|
|
/// A <see cref="System.String"/> that represents this instance.
|
|
/// </returns>
|
|
///
|
|
/// <example>
|
|
/// Please see <see cref="CSharpMatrixFormatProvider"/>,
|
|
/// <see cref="CSharpJaggedMatrixFormatProvider"/>, <see cref="CSharpArrayFormatProvider"/>,
|
|
/// <see cref="OctaveMatrixFormatProvider"/>, or <see cref="OctaveArrayFormatProvider"/>
|
|
/// for more details.
|
|
/// </example>
|
|
///
|
|
///
|
|
public static string ToString<T>(this T[,] matrix, IMatrixFormatProvider provider)
|
|
{
|
|
return ToString(matrix, null, provider);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Returns a <see cref="System.String"/> representation of a given matrix.
|
|
/// </summary>
|
|
///
|
|
/// <param name="matrix">The matrix.</param>
|
|
/// <param name="format">
|
|
/// The format to use when creating the resulting string.
|
|
/// </param>
|
|
/// <param name="provider">
|
|
/// The <see cref="IMatrixFormatProvider"/> to be used
|
|
/// when creating the resulting string. Default is to use
|
|
/// <see cref="DefaultMatrixFormatProvider.CurrentCulture"/>.
|
|
/// </param>
|
|
///
|
|
/// <returns>
|
|
/// A <see cref="System.String"/> that represents this instance.
|
|
/// </returns>
|
|
///
|
|
/// <example>
|
|
/// Please see <see cref="CSharpMatrixFormatProvider"/>,
|
|
/// <see cref="CSharpJaggedMatrixFormatProvider"/>, <see cref="CSharpArrayFormatProvider"/>,
|
|
/// <see cref="OctaveMatrixFormatProvider"/>, or <see cref="OctaveArrayFormatProvider"/>
|
|
/// for more details.
|
|
/// </example>
|
|
///
|
|
///
|
|
public static string ToString<T>(this T[,] matrix, string format, IMatrixFormatProvider provider)
|
|
{
|
|
return MatrixFormatter.Format(format, matrix, provider);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Returns a <see cref="System.String"/> representation of a given matrix.
|
|
/// </summary>
|
|
///
|
|
/// <param name="matrix">The matrix.</param>
|
|
///
|
|
/// <param name="format">
|
|
/// The format to use when creating the resulting string.
|
|
/// </param>
|
|
///
|
|
/// <returns>
|
|
/// A <see cref="System.String"/> that represents this instance.
|
|
/// </returns>
|
|
///
|
|
/// <example>
|
|
/// Please see <see cref="CSharpMatrixFormatProvider"/>,
|
|
/// <see cref="CSharpJaggedMatrixFormatProvider"/>, <see cref="CSharpArrayFormatProvider"/>,
|
|
/// <see cref="OctaveMatrixFormatProvider"/>, or <see cref="OctaveArrayFormatProvider"/>
|
|
/// for more details.
|
|
/// </example>
|
|
///
|
|
///
|
|
public static string ToString<T>(this T[,] matrix, string format)
|
|
{
|
|
return MatrixFormatter.Format(format, matrix, DefaultMatrixFormatProvider.CurrentCulture);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Returns a <see cref="System.String"/> representation of a given matrix.
|
|
/// </summary>
|
|
///
|
|
/// <param name="matrix">The matrix.</param>
|
|
///
|
|
/// <returns>
|
|
/// A <see cref="System.String"/> that represents this instance.
|
|
/// </returns>
|
|
///
|
|
/// <example>
|
|
/// Please see <see cref="CSharpMatrixFormatProvider"/>,
|
|
/// <see cref="CSharpJaggedMatrixFormatProvider"/>, <see cref="CSharpArrayFormatProvider"/>,
|
|
/// <see cref="OctaveMatrixFormatProvider"/>, or <see cref="OctaveArrayFormatProvider"/>
|
|
/// for more details.
|
|
/// </example>
|
|
///
|
|
///
|
|
public static string ToCSharp<T>(this T[][] matrix)
|
|
{
|
|
return ToString(matrix, CSharpJaggedMatrixFormatProvider.InvariantCulture);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Returns a <see cref="System.String"/> representation of a given matrix.
|
|
/// </summary>
|
|
///
|
|
/// <param name="matrix">The matrix.</param>
|
|
///
|
|
/// <returns>
|
|
/// A <see cref="System.String"/> that represents this instance.
|
|
/// </returns>
|
|
///
|
|
/// <example>
|
|
/// Please see <see cref="CSharpMatrixFormatProvider"/>,
|
|
/// <see cref="CSharpJaggedMatrixFormatProvider"/>, <see cref="CSharpArrayFormatProvider"/>,
|
|
/// <see cref="OctaveMatrixFormatProvider"/>, or <see cref="OctaveArrayFormatProvider"/>
|
|
/// for more details.
|
|
/// </example>
|
|
///
|
|
///
|
|
public static string ToOctave<T>(this T[][] matrix)
|
|
{
|
|
return ToString(matrix, OctaveMatrixFormatProvider.InvariantCulture);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Returns a <see cref="System.String"/> representation of a given matrix.
|
|
/// </summary>
|
|
///
|
|
/// <param name="matrix">The matrix.</param>
|
|
///
|
|
/// <returns>
|
|
/// A <see cref="System.String"/> that represents this instance.
|
|
/// </returns>
|
|
///
|
|
/// <example>
|
|
/// Please see <see cref="CSharpMatrixFormatProvider"/>,
|
|
/// <see cref="CSharpJaggedMatrixFormatProvider"/>, <see cref="CSharpArrayFormatProvider"/>,
|
|
/// <see cref="OctaveMatrixFormatProvider"/>, or <see cref="OctaveArrayFormatProvider"/>
|
|
/// for more details.
|
|
/// </example>
|
|
///
|
|
///
|
|
public static string ToString<T>(this T[][] matrix)
|
|
{
|
|
return ToString(matrix, DefaultMatrixFormatProvider.CurrentCulture);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Returns a <see cref="System.String"/> representation of a given matrix.
|
|
/// </summary>
|
|
///
|
|
/// <param name="matrix">The matrix.</param>
|
|
/// <param name="provider">
|
|
/// The <see cref="IMatrixFormatProvider"/> to be used
|
|
/// when creating the resulting string. Default is to use
|
|
/// <see cref="DefaultMatrixFormatProvider.CurrentCulture"/>.
|
|
/// </param>
|
|
///
|
|
/// <returns>
|
|
/// A <see cref="System.String"/> that represents this instance.
|
|
/// </returns>
|
|
///
|
|
/// <example>
|
|
/// Please see <see cref="CSharpMatrixFormatProvider"/>,
|
|
/// <see cref="CSharpJaggedMatrixFormatProvider"/>, <see cref="CSharpArrayFormatProvider"/>,
|
|
/// <see cref="OctaveMatrixFormatProvider"/>, or <see cref="OctaveArrayFormatProvider"/>
|
|
/// for more details.
|
|
/// </example>
|
|
///
|
|
///
|
|
public static string ToString<T>(this T[][] matrix, IMatrixFormatProvider provider)
|
|
{
|
|
return ToString(matrix, null, provider);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Returns a <see cref="System.String"/> representation of a given matrix.
|
|
/// </summary>
|
|
/// <param name="matrix">The matrix.</param>
|
|
/// <param name="format">
|
|
/// The format to use when creating the resulting string.
|
|
/// </param>
|
|
///
|
|
/// <param name="provider">
|
|
/// The <see cref="IMatrixFormatProvider"/> to be used
|
|
/// when creating the resulting string. Default is to use
|
|
/// <see cref="DefaultMatrixFormatProvider.CurrentCulture"/>.
|
|
/// </param>
|
|
///
|
|
/// <returns>
|
|
/// A <see cref="System.String"/> that represents this instance.
|
|
/// </returns>
|
|
///
|
|
/// <example>
|
|
/// Please see <see cref="CSharpMatrixFormatProvider"/>,
|
|
/// <see cref="CSharpJaggedMatrixFormatProvider"/>, <see cref="CSharpArrayFormatProvider"/>,
|
|
/// <see cref="OctaveMatrixFormatProvider"/>, or <see cref="OctaveArrayFormatProvider"/>
|
|
/// for more details.
|
|
/// </example>
|
|
///
|
|
public static string ToString<T>(this T[][] matrix, string format, IMatrixFormatProvider provider)
|
|
{
|
|
return MatrixFormatter.Format(format, matrix, provider);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Returns a <see cref="System.String"/> representation of a given matrix.
|
|
/// </summary>
|
|
///
|
|
/// <param name="matrix">The matrix.</param>
|
|
///
|
|
/// <param name="format">
|
|
/// The format to use when creating the resulting string.
|
|
/// </param>
|
|
///
|
|
/// <returns>
|
|
/// A <see cref="System.String"/> that represents this instance.
|
|
/// </returns>
|
|
///
|
|
/// <example>
|
|
/// Please see <see cref="CSharpMatrixFormatProvider"/>,
|
|
/// <see cref="CSharpJaggedMatrixFormatProvider"/>, <see cref="CSharpArrayFormatProvider"/>,
|
|
/// <see cref="OctaveMatrixFormatProvider"/>, or <see cref="OctaveArrayFormatProvider"/>
|
|
/// for more details.
|
|
/// </example>
|
|
///
|
|
public static string ToString<T>(this T[][] matrix, string format)
|
|
{
|
|
return MatrixFormatter.Format(format, matrix, DefaultMatrixFormatProvider.CurrentCulture);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Returns a <see cref="System.String"/> representation of a a given array.
|
|
/// </summary>
|
|
///
|
|
/// <param name="array">The array.</param>
|
|
///
|
|
/// <returns>
|
|
/// A <see cref="System.String"/> that represents this instance.
|
|
/// </returns>
|
|
///
|
|
/// <example>
|
|
/// Please see <see cref="CSharpMatrixFormatProvider"/>,
|
|
/// <see cref="OctaveArrayFormatProvider"/> or <see cref="DefaultArrayFormatProvider"/>
|
|
/// for examples and more details.
|
|
/// </example>
|
|
///
|
|
public static string ToString<T>(this T[] array)
|
|
{
|
|
return ToString(array, DefaultArrayFormatProvider.CurrentCulture);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Returns a <see cref="System.String"/> representation of a a given array.
|
|
/// </summary>
|
|
///
|
|
/// <param name="array">The array.</param>
|
|
///
|
|
/// <returns>
|
|
/// A <see cref="System.String"/> that represents this instance.
|
|
/// </returns>
|
|
///
|
|
/// <example>
|
|
/// Please see <see cref="CSharpMatrixFormatProvider"/>,
|
|
/// <see cref="OctaveArrayFormatProvider"/> or <see cref="DefaultArrayFormatProvider"/>
|
|
/// for examples and more details.
|
|
/// </example>
|
|
///
|
|
public static string ToCSharp<T>(this T[] array)
|
|
{
|
|
return ToString(array, CSharpArrayFormatProvider.InvariantCulture);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Returns a <see cref="System.String"/> representation of a a given array.
|
|
/// </summary>
|
|
///
|
|
/// <param name="array">The array.</param>
|
|
///
|
|
/// <returns>
|
|
/// A <see cref="System.String"/> that represents this instance.
|
|
/// </returns>
|
|
///
|
|
/// <example>
|
|
/// Please see <see cref="CSharpMatrixFormatProvider"/>,
|
|
/// <see cref="OctaveArrayFormatProvider"/> or <see cref="DefaultArrayFormatProvider"/>
|
|
/// for examples and more details.
|
|
/// </example>
|
|
///
|
|
public static string ToOctave<T>(this T[] array)
|
|
{
|
|
return ToString(array, OctaveArrayFormatProvider.InvariantCulture);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Returns a <see cref="System.String"/> representation of a a given array.
|
|
/// </summary>
|
|
///
|
|
/// <param name="array">The array.</param>
|
|
///
|
|
/// <param name="provider">
|
|
/// The <see cref="IMatrixFormatProvider"/> to be used
|
|
/// when creating the resulting string. Default is to use
|
|
/// <see cref="DefaultMatrixFormatProvider.CurrentCulture"/>.
|
|
/// </param>
|
|
///
|
|
/// <returns>
|
|
/// A <see cref="System.String"/> that represents this instance.
|
|
/// </returns>
|
|
///
|
|
/// <example>
|
|
/// Please see <see cref="CSharpMatrixFormatProvider"/>,
|
|
/// <see cref="OctaveArrayFormatProvider"/> or <see cref="DefaultArrayFormatProvider"/>
|
|
/// for examples and more details.
|
|
/// </example>
|
|
///
|
|
public static string ToString<T>(this T[] array, IMatrixFormatProvider provider)
|
|
{
|
|
return ToString(array, null, provider);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Returns a <see cref="System.String"/> representation of a a given array.
|
|
/// </summary>
|
|
///
|
|
/// <param name="matrix">The matrix.</param>
|
|
///
|
|
/// <param name="format">
|
|
/// The format to use when creating the resulting string.
|
|
/// </param>
|
|
///
|
|
/// <param name="provider">
|
|
/// The <see cref="IMatrixFormatProvider"/> to be used
|
|
/// when creating the resulting string. Default is to use
|
|
/// <see cref="DefaultMatrixFormatProvider.CurrentCulture"/>.
|
|
/// </param>
|
|
///
|
|
/// <returns>
|
|
/// A <see cref="System.String"/> that represents this instance.
|
|
/// </returns>
|
|
///
|
|
/// <example>
|
|
/// Please see <see cref="CSharpMatrixFormatProvider"/>,
|
|
/// <see cref="OctaveArrayFormatProvider"/> or <see cref="DefaultArrayFormatProvider"/>
|
|
/// for examples and more details.
|
|
/// </example>
|
|
///
|
|
public static string ToString<T>(this T[] matrix, string format, IMatrixFormatProvider provider)
|
|
{
|
|
return MatrixFormatter.Format(format, matrix, provider);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Returns a <see cref="System.String"/> representation of a a given array.
|
|
/// </summary>
|
|
///
|
|
/// <param name="array">The array.</param>
|
|
///
|
|
/// <param name="format">
|
|
/// The format to use when creating the resulting string.
|
|
/// </param>
|
|
///
|
|
/// <returns>
|
|
/// A <see cref="System.String"/> that represents this instance.
|
|
/// </returns>
|
|
///
|
|
/// <example>
|
|
/// Please see <see cref="CSharpMatrixFormatProvider"/>,
|
|
/// <see cref="OctaveArrayFormatProvider"/> or <see cref="DefaultArrayFormatProvider"/>
|
|
/// for examples and more details.
|
|
/// </example>
|
|
///
|
|
public static string ToString<T>(this T[] array, string format)
|
|
{
|
|
return MatrixFormatter.Format(format, array, DefaultArrayFormatProvider.CurrentCulture);
|
|
}
|
|
|
|
#endregion
|
|
|
|
|
|
#region Parse
|
|
/// <summary>
|
|
/// Converts the string representation of a matrix to its
|
|
/// double-precision floating-point number matrix equivalent.
|
|
/// </summary>
|
|
/// <param name="str">The string representation of the matrix.</param>
|
|
/// <returns>A double-precision floating-point number matrix parsed
|
|
/// from the given string using the given format provider.</returns>
|
|
///
|
|
public static double[,] Parse(string str)
|
|
{
|
|
return MatrixFormatter.ParseMultidimensional(str, DefaultMatrixFormatProvider.CurrentCulture);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Converts the string representation of a matrix to its
|
|
/// double-precision floating-point number matrix equivalent.
|
|
/// </summary>
|
|
/// <param name="str">The string representation of the matrix.</param>
|
|
/// <param name="provider">
|
|
/// The format provider to use in the conversion. Default is to use
|
|
/// <see cref="DefaultMatrixFormatProvider.CurrentCulture"/>.
|
|
/// </param>
|
|
/// <returns>A double-precision floating-point number matrix parsed
|
|
/// from the given string using the given format provider.</returns>
|
|
///
|
|
public static double[,] Parse(string str, IMatrixFormatProvider provider)
|
|
{
|
|
return MatrixFormatter.ParseMultidimensional(str, provider);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Converts the string representation of a matrix to its
|
|
/// double-precision floating-point number matrix equivalent.
|
|
/// </summary>
|
|
/// <param name="s">The string representation of the matrix.</param>
|
|
/// <param name="provider">
|
|
/// The format provider to use in the conversion. Default is to use
|
|
/// <see cref="DefaultMatrixFormatProvider.CurrentCulture"/>.
|
|
/// </param>
|
|
/// <returns>A double-precision floating-point number matrix parsed
|
|
/// from the given string using the given format provider.</returns>
|
|
///
|
|
[Obsolete("Please use the Jagged.Parse() method instead.")]
|
|
public static double[][] ParseJagged(string s, IMatrixFormatProvider provider)
|
|
{
|
|
return Jagged.Parse(s, provider);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Converts the string representation of a matrix to its
|
|
/// double-precision floating-point number matrix equivalent.
|
|
/// A return value indicates whether the conversion succeeded or failed.
|
|
/// </summary>
|
|
/// <param name="s">The string representation of the matrix.</param>
|
|
/// <param name="provider">
|
|
/// The format provider to use in the conversion. Default is to use
|
|
/// <see cref="DefaultMatrixFormatProvider.CurrentCulture"/>.
|
|
/// </param>
|
|
/// <param name="matrix">A double-precision floating-point number matrix parsed
|
|
/// from the given string using the given format provider.</param>
|
|
/// <result>When this method returns, contains the double-precision floating-point
|
|
/// number matrix equivalent to the <see param="s"/> parameter, if the conversion succeeded,
|
|
/// or null if the conversion failed. The conversion fails if the <see param="s"/> parameter
|
|
/// is null, is not a matrix in a valid format, or contains elements which represent
|
|
/// a number less than MinValue or greater than MaxValue. This parameter is passed
|
|
/// uninitialized. </result>
|
|
///
|
|
public static bool TryParse(string s, IMatrixFormatProvider provider, out double[,] matrix)
|
|
{
|
|
// TODO: Create a proper TryParse method without
|
|
// resorting to a underlying try-catch block.
|
|
try
|
|
{
|
|
matrix = Parse(s, provider);
|
|
}
|
|
catch (FormatException)
|
|
{
|
|
matrix = null;
|
|
}
|
|
catch (ArgumentNullException)
|
|
{
|
|
matrix = null;
|
|
}
|
|
|
|
return matrix != null;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Converts the string representation of a matrix to its
|
|
/// double-precision floating-point number matrix equivalent.
|
|
/// A return value indicates whether the conversion succeeded or failed.
|
|
/// </summary>
|
|
/// <param name="s">The string representation of the matrix.</param>
|
|
/// <param name="provider">
|
|
/// The format provider to use in the conversion. Default is to use
|
|
/// <see cref="DefaultMatrixFormatProvider.CurrentCulture"/>.
|
|
/// </param>
|
|
/// <param name="matrix">A double-precision floating-point number matrix parsed
|
|
/// from the given string using the given format provider.</param>
|
|
/// <result>When this method returns, contains the double-precision floating-point
|
|
/// number matrix equivalent to the <see param="s"/> parameter, if the conversion succeeded,
|
|
/// or null if the conversion failed. The conversion fails if the <see param="s"/> parameter
|
|
/// is null, is not a matrix in a valid format, or contains elements which represent
|
|
/// a number less than MinValue or greater than MaxValue. This parameter is passed
|
|
/// uninitialized. </result>
|
|
///
|
|
public static bool TryParse(string s, IMatrixFormatProvider provider, out double[][] matrix)
|
|
{
|
|
return Jagged.TryParse(s, provider, out matrix);
|
|
}
|
|
#endregion
|
|
|
|
}
|
|
}
|