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.
339 lines
11 KiB
C#
339 lines
11 KiB
C#
// Accord Core Library
|
|
// The Accord.NET Framework
|
|
// http://accord-framework.net
|
|
//
|
|
// Copyright © AForge.NET, 2007-2011
|
|
// [email protected]
|
|
//
|
|
// 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
|
|
{
|
|
using Accord;
|
|
using System;
|
|
using Accord.Compat;
|
|
|
|
/// <summary>
|
|
/// Represents a double range with minimum and maximum values,
|
|
/// where values are single-precision floating-point (float) numbers.
|
|
/// </summary>
|
|
///
|
|
/// <remarks>
|
|
/// This class represents a double range with inclusive limits, where
|
|
/// both minimum and maximum values of the range are included into it.
|
|
/// Mathematical notation of such range is <b>[min, max]</b>.
|
|
/// </remarks>
|
|
///
|
|
/// <example>
|
|
/// <code>
|
|
/// // create [0.25, 1.5] range
|
|
/// var range1 = new SingleRange(0.25f, 1.5f);
|
|
///
|
|
/// // create [1.00, 2.25] range
|
|
/// var range2 = new SingleRange(1.00f, 2.25f);
|
|
///
|
|
/// // check if values is inside of the first range
|
|
/// if (range1.IsInside(0.75f))
|
|
/// {
|
|
/// // ...
|
|
/// }
|
|
///
|
|
/// // check if the second range is inside of the first range
|
|
/// if (range1.IsInside(range2))
|
|
/// {
|
|
/// // ...
|
|
/// }
|
|
///
|
|
/// // check if two ranges overlap
|
|
/// if (range1.IsOverlapping(range2))
|
|
/// {
|
|
/// // ...
|
|
/// }
|
|
/// </code>
|
|
/// </example>
|
|
///
|
|
/// <seealso cref="IntRange"/>
|
|
/// <seealso cref="DoubleRange"/>
|
|
/// <seealso cref="ByteRange"/>
|
|
///
|
|
[Serializable]
|
|
public struct Range : IRange<float>, IEquatable<Range>
|
|
{
|
|
private float min, max;
|
|
|
|
/// <summary>
|
|
/// Minimum value of the range.
|
|
/// </summary>
|
|
///
|
|
/// <remarks>
|
|
/// Represents minimum value (left side limit) of the range [<b>min</b>, max].
|
|
/// </remarks>
|
|
///
|
|
public float Min
|
|
{
|
|
get { return min; }
|
|
set { min = value; }
|
|
}
|
|
|
|
/// <summary>
|
|
/// Maximum value of the range.
|
|
/// </summary>
|
|
///
|
|
/// <remarks>
|
|
/// Represents maximum value (right side limit) of the range [min, <b>max</b>].
|
|
/// </remarks>
|
|
///
|
|
public float Max
|
|
{
|
|
get { return max; }
|
|
set { max = value; }
|
|
}
|
|
|
|
/// <summary>
|
|
/// Gets the length of the range, defined as (max - min).
|
|
/// </summary>
|
|
///
|
|
public float Length
|
|
{
|
|
get { return max - min; }
|
|
}
|
|
|
|
/// <summary>
|
|
/// Initializes a new instance of the <see cref="Range"/> class.
|
|
/// </summary>
|
|
///
|
|
/// <param name="min">Minimum value of the range.</param>
|
|
/// <param name="max">Maximum value of the range.</param>
|
|
///
|
|
public Range(float min, float max)
|
|
{
|
|
this.min = min;
|
|
this.max = max;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Check if the specified value is inside of the range.
|
|
/// </summary>
|
|
///
|
|
/// <param name="x">Value to check.</param>
|
|
///
|
|
/// <returns>
|
|
/// <b>True</b> if the specified value is inside of the range or <b>false</b> otherwise.
|
|
/// </returns>
|
|
///
|
|
public bool IsInside(float x)
|
|
{
|
|
return ((x >= min) && (x <= max));
|
|
}
|
|
|
|
/// <summary>
|
|
/// Check if the specified range is inside of the range.
|
|
/// </summary>
|
|
///
|
|
/// <param name="range">Range to check.</param>
|
|
///
|
|
/// <returns>
|
|
/// <b>True</b> if the specified range is inside of the range or <b>false</b> otherwise.
|
|
/// </returns>
|
|
///
|
|
public bool IsInside(Range range)
|
|
{
|
|
return ((IsInside(range.min)) && (IsInside(range.max)));
|
|
}
|
|
|
|
/// <summary>
|
|
/// Check if the specified range overlaps with the range.
|
|
/// </summary>
|
|
///
|
|
/// <param name="range">Range to check for overlapping.</param>
|
|
///
|
|
/// <returns>
|
|
/// <b>True</b> if the specified range overlaps with the range or <b>false</b> otherwise.
|
|
/// </returns>
|
|
///
|
|
public bool IsOverlapping(Range range)
|
|
{
|
|
return ((IsInside(range.min)) || (IsInside(range.max)) ||
|
|
(range.IsInside(min)) || (range.IsInside(max)));
|
|
}
|
|
|
|
/// <summary>
|
|
/// Computes the intersection between two ranges.
|
|
/// </summary>
|
|
///
|
|
/// <param name="range">The second range for which the intersection should be calculated.</param>
|
|
///
|
|
/// <returns>An new <see cref="Range"/> structure containing the intersection
|
|
/// between this range and the <paramref name="range"/> given as argument.</returns>
|
|
///
|
|
public Range Intersection(Range range)
|
|
{
|
|
return new Range(System.Math.Max(this.Min, range.Min), System.Math.Min(this.Max, range.Max));
|
|
}
|
|
|
|
/// <summary>
|
|
/// Determines whether two instances are equal.
|
|
/// </summary>
|
|
///
|
|
public static bool operator ==(Range range1, Range range2)
|
|
{
|
|
return ((range1.min == range2.min) && (range1.max == range2.max));
|
|
}
|
|
|
|
/// <summary>
|
|
/// Determines whether two instances are not equal.
|
|
/// </summary>
|
|
///
|
|
public static bool operator !=(Range range1, Range range2)
|
|
{
|
|
return ((range1.min != range2.min) || (range1.max != range2.max));
|
|
}
|
|
|
|
/// <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(Range other)
|
|
{
|
|
return this == other;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Determines whether the specified <see cref="System.Object" />, is equal to this instance.
|
|
/// </summary>
|
|
///
|
|
/// <param name="obj">The <see cref="System.Object" /> to compare with this instance.</param>
|
|
///
|
|
/// <returns>
|
|
/// <c>true</c> if the specified <see cref="System.Object" /> is equal to this instance; otherwise, <c>false</c>.
|
|
/// </returns>
|
|
///
|
|
public override bool Equals(object obj)
|
|
{
|
|
return (obj is Range) ? (this == (Range)obj) : false;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Returns a hash code for this instance.
|
|
/// </summary>
|
|
///
|
|
/// <returns>
|
|
/// A hash code for this instance, suitable for use in hashing algorithms and data structures like a hash table.
|
|
/// </returns>
|
|
///
|
|
public override int GetHashCode()
|
|
{
|
|
unchecked
|
|
{
|
|
int hash = 17;
|
|
hash = hash * 31 + min.GetHashCode();
|
|
hash = hash * 31 + max.GetHashCode();
|
|
return hash;
|
|
}
|
|
}
|
|
|
|
/// <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 String.Format("[{0}, {1}]", min, max);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Returns a <see cref="System.String" /> that represents this instance.
|
|
/// </summary>
|
|
///
|
|
/// <param name="format">The format.</param>
|
|
/// <param name="formatProvider">The format provider.</param>
|
|
///
|
|
/// <returns>
|
|
/// A <see cref="System.String" /> that represents this instance.
|
|
/// </returns>
|
|
///
|
|
public string ToString(string format, IFormatProvider formatProvider)
|
|
{
|
|
return String.Format("[{0}, {1}]",
|
|
min.ToString(format, formatProvider),
|
|
max.ToString(format, formatProvider));
|
|
}
|
|
|
|
|
|
/// <summary>
|
|
/// Performs an implicit conversion from <see cref="IntRange"/> to <see cref="DoubleRange"/>.
|
|
/// </summary>
|
|
///
|
|
/// <param name="range">The range.</param>
|
|
///
|
|
/// <returns>
|
|
/// The result of the conversion.
|
|
/// </returns>
|
|
///
|
|
public static implicit operator DoubleRange(Range range)
|
|
{
|
|
return new DoubleRange(range.Min, range.Max);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Converts this single-precision range into an <see cref="IntRange"/>.
|
|
/// </summary>
|
|
///
|
|
/// <param name="provideInnerRange">
|
|
/// Specifies if inner integer range must be returned or outer range.</param>
|
|
///
|
|
/// <returns>Returns integer version of the range.</returns>
|
|
///
|
|
/// <remarks>
|
|
/// If <paramref name="provideInnerRange"/> is set to <see langword="true"/>, then the
|
|
/// returned integer range will always fit inside of the current single precision range.
|
|
/// If it is set to <see langword="false"/>, then current single precision range will always
|
|
/// fit into the returned integer range.
|
|
/// </remarks>
|
|
///
|
|
public IntRange ToIntRange(bool provideInnerRange)
|
|
{
|
|
int iMin, iMax;
|
|
|
|
if (provideInnerRange)
|
|
{
|
|
iMin = (int)System.Math.Ceiling(min);
|
|
iMax = (int)System.Math.Floor(max);
|
|
}
|
|
else
|
|
{
|
|
iMin = (int)System.Math.Floor(min);
|
|
iMax = (int)System.Math.Ceiling(max);
|
|
}
|
|
|
|
return new IntRange(iMin, iMax);
|
|
}
|
|
}
|
|
}
|