1 changed files with 340 additions and 0 deletions
@ -0,0 +1,340 @@ |
|||
// <copyright file="Matrix.cs" company="Math.NET">
|
|||
// Math.NET Numerics, part of the Math.NET Project
|
|||
// http://mathnet.opensourcedotnet.info
|
|||
// Copyright (c) 2009 Math.NET
|
|||
// Permission is hereby granted, free of charge, to any person
|
|||
// obtaining a copy of this software and associated documentation
|
|||
// files (the "Software"), to deal in the Software without
|
|||
// restriction, including without limitation the rights to use,
|
|||
// copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|||
// copies of the Software, and to permit persons to whom the
|
|||
// Software is furnished to do so, subject to the following
|
|||
// conditions:
|
|||
// The above copyright notice and this permission notice shall be
|
|||
// included in all copies or substantial portions of the Software.
|
|||
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
|||
// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
|
|||
// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
|
|||
// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
|
|||
// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
|
|||
// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
|
|||
// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
|
|||
// OTHER DEALINGS IN THE SOFTWARE.
|
|||
// </copyright>
|
|||
namespace MathNet.Numerics.LinearAlgebra.Double |
|||
{ |
|||
using System; |
|||
using System.Text; |
|||
|
|||
using MathNet.Numerics.Properties; |
|||
|
|||
/// <summary>
|
|||
/// A matrix class.
|
|||
/// </summary>
|
|||
[Serializable] |
|||
public abstract class Matrix : IFormattable, ICloneable, IEquatable<Matrix> |
|||
{ |
|||
/// <summary>
|
|||
/// Initializes a new instance of the <see cref="Matrix"/> class.
|
|||
/// </summary>
|
|||
/// <param name="rows">
|
|||
/// The number of rows.
|
|||
/// </param>
|
|||
/// <param name="columns">
|
|||
/// The number of columns.
|
|||
/// </param>
|
|||
protected Matrix(int rows, int columns) |
|||
{ |
|||
RowCount = rows; |
|||
ColumnCount = columns; |
|||
} |
|||
|
|||
/// <summary>
|
|||
/// Initializes a new instance of the <see cref="Matrix"/> class.
|
|||
/// </summary>
|
|||
/// <param name="order">
|
|||
/// The order of the matrix.
|
|||
/// </param>
|
|||
protected Matrix(int order) |
|||
{ |
|||
RowCount = order; |
|||
ColumnCount = order; |
|||
} |
|||
|
|||
/// <summary>
|
|||
/// Gets the number of columns.
|
|||
/// </summary>
|
|||
/// <value>The number of columns.</value>
|
|||
public virtual int ColumnCount { get; private set; } |
|||
|
|||
/// <summary>
|
|||
/// Gets the number of rows.
|
|||
/// </summary>
|
|||
/// <value>The number of rows.</value>
|
|||
public virtual int RowCount { get; private set; } |
|||
|
|||
/// <summary>
|
|||
/// Gets or sets the value at the given row and column.
|
|||
/// </summary>
|
|||
/// <param name="row">
|
|||
/// The row of the element.
|
|||
/// </param>
|
|||
/// <param name="column">
|
|||
/// The column of the element.
|
|||
/// </param>
|
|||
/// <value>The double value to get or set.</value>
|
|||
/// <remarks>This method is ranged checked. <see cref="At(int,int)"/> and <see cref="At(int,int,double)"/>
|
|||
/// to get and set values without range checking.</remarks>
|
|||
public virtual double this[int row, int column] |
|||
{ |
|||
get |
|||
{ |
|||
RangeCheck(row, column); |
|||
return At(row, column); |
|||
} |
|||
|
|||
set |
|||
{ |
|||
RangeCheck(row, column); |
|||
At(row, column, value); |
|||
} |
|||
} |
|||
|
|||
/// <summary>
|
|||
/// Retrieves the requested element without range checking.
|
|||
/// </summary>
|
|||
/// <param name="row">
|
|||
/// The row of the element.
|
|||
/// </param>
|
|||
/// <param name="column">
|
|||
/// The column of the element.
|
|||
/// </param>
|
|||
/// <returns>
|
|||
/// The requested element.
|
|||
/// </returns>
|
|||
public abstract double At(int row, int column); |
|||
|
|||
/// <summary>
|
|||
/// Sets the value of the given element.
|
|||
/// </summary>
|
|||
/// <param name="row">
|
|||
/// The row of the element.
|
|||
/// </param>
|
|||
/// <param name="column">
|
|||
/// The column of the element.
|
|||
/// </param>
|
|||
/// <param name="value">
|
|||
/// The value to set the element to.
|
|||
/// </param>
|
|||
public abstract void At(int row, int column, double value); |
|||
|
|||
/// <summary>
|
|||
/// Creates a clone of this instance.
|
|||
/// </summary>
|
|||
/// <returns>
|
|||
/// A clone of the instance.
|
|||
/// </returns>
|
|||
public virtual Matrix Clone() |
|||
{ |
|||
var result = CreateMatrix(RowCount, ColumnCount); |
|||
CopyTo(result); |
|||
return result; |
|||
} |
|||
|
|||
/// <summary>
|
|||
/// Copies the elements of this matrix to the given matrix.
|
|||
/// </summary>
|
|||
/// <param name="target">
|
|||
/// The matrix to copy values into.
|
|||
/// </param>
|
|||
/// <exception cref="ArgumentNullException">
|
|||
/// If target is <see langword="null"/>.
|
|||
/// </exception>
|
|||
/// <exception cref="ArgumentException">
|
|||
/// If this and the target matrix do not have the same dimensions..
|
|||
/// </exception>
|
|||
public virtual void CopyTo(Matrix target) |
|||
{ |
|||
if (target == null) |
|||
{ |
|||
throw new ArgumentNullException("target"); |
|||
} |
|||
|
|||
if (ReferenceEquals(this, target)) |
|||
{ |
|||
return; |
|||
} |
|||
|
|||
if (RowCount != target.RowCount || ColumnCount != target.ColumnCount) |
|||
{ |
|||
throw new ArgumentException("target", Resources.ArgumentMatrixSameDimensions); |
|||
} |
|||
|
|||
throw new NotImplementedException(); |
|||
|
|||
/* |
|||
foreach (KeyValuePair<int, Vector> column in GetColumnEnumerator()) |
|||
{ |
|||
foreach (KeyValuePair<int, double> element in column.Value.GetIndexedEnumerator()) |
|||
{ |
|||
target.ValueAt(element.Key, column.Key, element.Value); |
|||
} |
|||
}*/ |
|||
} |
|||
|
|||
/// <summary>
|
|||
/// Creates a <strong>Matrix</strong> for the given number of rows and columns.
|
|||
/// </summary>
|
|||
/// <param name="numberOfRows">
|
|||
/// The number of rows.
|
|||
/// </param>
|
|||
/// <param name="numberOfColumns">
|
|||
/// The number of columns.
|
|||
/// </param>
|
|||
/// <returns>
|
|||
/// A <strong>Matrix</strong> with the given dimensions.
|
|||
/// </returns>
|
|||
/// <remarks>
|
|||
/// Creates a matrix of the same matrix type as the current matrix.
|
|||
/// </remarks>
|
|||
public abstract Matrix CreateMatrix(int numberOfRows, int numberOfColumns); |
|||
|
|||
/// <summary>
|
|||
/// Returns a <see cref="System.String"/> that represents this instance.
|
|||
/// </summary>
|
|||
/// <returns>
|
|||
/// A <see cref="System.String"/> that represents this instance.
|
|||
/// </returns>
|
|||
public override string ToString() |
|||
{ |
|||
return this.ToString(null, null); |
|||
} |
|||
|
|||
#region Implemented Interfaces
|
|||
|
|||
#region ICloneable
|
|||
|
|||
/// <summary>
|
|||
/// Creates a new object that is a copy of the current instance.
|
|||
/// </summary>
|
|||
/// <returns>
|
|||
/// A new object that is a copy of this instance.
|
|||
/// </returns>
|
|||
object ICloneable.Clone() |
|||
{ |
|||
return Clone(); |
|||
} |
|||
|
|||
#endregion
|
|||
|
|||
#region IEquatable<Matrix>
|
|||
|
|||
/// <summary>
|
|||
/// Indicates whether the current object is equal to another object of the same type.
|
|||
/// </summary>
|
|||
/// <param name="other">
|
|||
/// An object to compare with this object.
|
|||
/// </param>
|
|||
/// <returns>
|
|||
/// true if the current object is equal to the <paramref name="other"/> parameter; otherwise, false.
|
|||
/// </returns>
|
|||
public bool Equals(Matrix other) |
|||
{ |
|||
// Reject equality when the argument is null or has a different shape.
|
|||
if (other == null) |
|||
{ |
|||
return false; |
|||
} |
|||
|
|||
if (ColumnCount != other.ColumnCount || RowCount != other.RowCount) |
|||
{ |
|||
return false; |
|||
} |
|||
|
|||
// Accept if the argument is the same object as this.
|
|||
if (ReferenceEquals(this, other)) |
|||
{ |
|||
return true; |
|||
} |
|||
|
|||
// If all else fails, perform element wise comparison.
|
|||
for (var row = 0; row < RowCount; row++) |
|||
{ |
|||
for (var column = 0; column < ColumnCount; column++) |
|||
{ |
|||
if (At(row, column) != other.At(row, column)) |
|||
{ |
|||
return false; |
|||
} |
|||
} |
|||
} |
|||
|
|||
return true; |
|||
} |
|||
|
|||
#endregion
|
|||
|
|||
#region IFormattable
|
|||
|
|||
/// <summary>
|
|||
/// Returns a <see cref="System.String"/> that represents this instance.
|
|||
/// </summary>
|
|||
/// <param name="format">
|
|||
/// The format to use.
|
|||
/// </param>
|
|||
/// <param name="formatProvider">
|
|||
/// The format provider to use.
|
|||
/// </param>
|
|||
/// <returns>
|
|||
/// A <see cref="System.String"/> that represents this instance.
|
|||
/// </returns>
|
|||
public string ToString(string format, IFormatProvider formatProvider) |
|||
{ |
|||
var stringBuilder = new StringBuilder(); |
|||
for (var row = 0; row < RowCount; row++) |
|||
{ |
|||
for (var column = 0; column < ColumnCount; column++) |
|||
{ |
|||
stringBuilder.Append(At(row, column).ToString(format, formatProvider)); |
|||
if (column != ColumnCount - 1) |
|||
{ |
|||
stringBuilder.Append(","); |
|||
} |
|||
} |
|||
|
|||
if (row != RowCount - 1) |
|||
{ |
|||
stringBuilder.Append(Environment.NewLine); |
|||
} |
|||
} |
|||
|
|||
return stringBuilder.ToString(); |
|||
} |
|||
|
|||
#endregion
|
|||
|
|||
#endregion
|
|||
|
|||
/// <summary>
|
|||
/// Ranges the check.
|
|||
/// </summary>
|
|||
/// <param name="row">
|
|||
/// The row of the element.
|
|||
/// </param>
|
|||
/// <param name="column">
|
|||
/// The column of the element.
|
|||
/// </param>
|
|||
private void RangeCheck(int row, int column) |
|||
{ |
|||
if (row < 0 || row >= RowCount) |
|||
{ |
|||
throw new ArgumentOutOfRangeException("row"); |
|||
} |
|||
|
|||
if (column < 0 || column >= ColumnCount) |
|||
{ |
|||
throw new ArgumentOutOfRangeException("column"); |
|||
} |
|||
} |
|||
} |
|||
} |
|||
Loading…
Reference in new issue