//
// Math.NET Numerics, part of the Math.NET Project
// http://numerics.mathdotnet.com
// http://github.com/mathnet/mathnet-numerics
//
// Copyright (c) 2009-2015 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.
//
using System;
using System.Collections.Generic;
namespace IStation.Numerics
{
///
/// Sorting algorithms for single, tuple and triple lists.
///
public static class Sorting
{
///
/// Sort a list of keys, in place using the quick sort algorithm using the quick sort algorithm.
///
/// The type of elements in the key list.
/// List to sort.
/// Comparison, defining the sort order.
public static void Sort(IList keys, IComparer comparer = null)
{
int count = keys.Count;
if (count <= 1)
{
return;
}
if (null == comparer)
{
comparer = Comparer.Default;
}
if (count == 2)
{
if (comparer.Compare(keys[0], keys[1]) > 0)
{
Swap(keys, 0, 1);
}
return;
}
// insertion sort
if (count <= 10)
{
for (int i = 1; i < count; i++)
{
var key = keys[i];
int j = i - 1;
while (j >= 0 && comparer.Compare(keys[j], key) > 0)
{
keys[j + 1] = keys[j];
j--;
}
keys[j + 1] = key;
}
return;
}
// array case
if (keys is T[] keysArray)
{
Array.Sort(keysArray, comparer);
return;
}
// generic list case
if (keys is List keysList)
{
keysList.Sort(comparer);
return;
}
// local sort implementation
QuickSort(keys, comparer, 0, count - 1);
}
///
/// Sort a list of keys and items with respect to the keys, in place using the quick sort algorithm.
///
/// The type of elements in the key list.
/// The type of elements in the item list.
/// List to sort.
/// List to permute the same way as the key list.
/// Comparison, defining the sort order.
public static void Sort(IList keys, IList items, IComparer comparer = null)
{
int count = keys.Count;
if (count <= 1)
{
return;
}
if (null == comparer)
{
comparer = Comparer.Default;
}
if (count == 2)
{
if (comparer.Compare(keys[0], keys[1]) > 0)
{
Swap(keys, 0, 1);
Swap(items, 0, 1);
}
return;
}
// insertion sort
if (count <= 10)
{
for (int i = 1; i < count; i++)
{
var key = keys[i];
var item = items[i];
int j = i - 1;
while (j >= 0 && comparer.Compare(keys[j], key) > 0)
{
keys[j + 1] = keys[j];
items[j + 1] = items[j];
j--;
}
keys[j + 1] = key;
items[j + 1] = item;
}
return;
}
// array case
if (keys is TKey[] keysArray && items is TItem[] itemsArray)
{
Array.Sort(keysArray, itemsArray, comparer);
return;
}
// local sort implementation
QuickSort(keys, items, comparer, 0, count - 1);
}
///
/// Sort a list of keys, items1 and items2 with respect to the keys, in place using the quick sort algorithm.
///
/// The type of elements in the key list.
/// The type of elements in the first item list.
/// The type of elements in the second item list.
/// List to sort.
/// First list to permute the same way as the key list.
/// Second list to permute the same way as the key list.
/// Comparison, defining the sort order.
public static void Sort(IList keys, IList items1, IList items2, IComparer comparer = null)
{
int count = keys.Count;
if (count <= 1)
{
return;
}
if (null == comparer)
{
comparer = Comparer.Default;
}
if (count == 2)
{
if (comparer.Compare(keys[0], keys[1]) > 0)
{
Swap(keys, 0, 1);
Swap(items1, 0, 1);
Swap(items2, 0, 1);
}
return;
}
// insertion sort
if (count <= 10)
{
for (int i = 1; i < count; i++)
{
var key = keys[i];
var item1 = items1[i];
var item2 = items2[i];
int j = i - 1;
while (j >= 0 && comparer.Compare(keys[j], key) > 0)
{
keys[j + 1] = keys[j];
items1[j + 1] = items1[j];
items2[j + 1] = items2[j];
j--;
}
keys[j + 1] = key;
items1[j + 1] = item1;
items2[j + 1] = item2;
}
return;
}
// local sort implementation
QuickSort(keys, items1, items2, comparer, 0, count - 1);
}
///
/// Sort a range of a list of keys, in place using the quick sort algorithm.
///
/// The type of element in the list.
/// List to sort.
/// The zero-based starting index of the range to sort.
/// The length of the range to sort.
/// Comparison, defining the sort order.
public static void Sort(IList keys, int index, int count, IComparer comparer = null)
{
if (index < 0)
{
throw new ArgumentOutOfRangeException(nameof(index));
}
if (count < 0 || index + count > keys.Count)
{
throw new ArgumentOutOfRangeException(nameof(count));
}
if (count <= 1)
{
return;
}
if (null == comparer)
{
comparer = Comparer.Default;
}
if (count == 2)
{
if (comparer.Compare(keys[index], keys[index + 1]) > 0)
{
Swap(keys, index, index + 1);
}
return;
}
// insertion sort
if (count <= 10)
{
int to = index + count;
for (int i = index + 1; i < to; i++)
{
var key = keys[i];
int j = i - 1;
while (j >= index && comparer.Compare(keys[j], key) > 0)
{
keys[j + 1] = keys[j];
j--;
}
keys[j + 1] = key;
}
return;
}
// array case
if (keys is T[] keysArray)
{
Array.Sort(keysArray, index, count, comparer);
return;
}
// generic list case
if (keys is List keysList)
{
keysList.Sort(index, count, comparer);
return;
}
// fall back: local sort implementation
QuickSort(keys, comparer, index, count - 1);
}
///
/// Sort a list of keys and items with respect to the keys, in place using the quick sort algorithm.
///
/// The type of elements in the key list.
/// The type of elements in the item list.
/// List to sort.
/// List to permute the same way as the key list.
/// The zero-based starting index of the range to sort.
/// The length of the range to sort.
/// Comparison, defining the sort order.
public static void Sort(IList keys, IList items, int index, int count, IComparer comparer = null)
{
if (index < 0)
{
throw new ArgumentOutOfRangeException(nameof(index));
}
if (count < 0 || index + count > keys.Count)
{
throw new ArgumentOutOfRangeException(nameof(count));
}
if (count <= 1)
{
return;
}
if (null == comparer)
{
comparer = Comparer.Default;
}
if (count == 2)
{
if (comparer.Compare(keys[index], keys[index + 1]) > 0)
{
Swap(keys, index, index + 1);
Swap(items, index, index + 1);
}
return;
}
// insertion sort
if (count <= 10)
{
int to = index + count;
for (int i = index + 1; i < to; i++)
{
var key = keys[i];
var item = items[i];
int j = i - 1;
while (j >= index && comparer.Compare(keys[j], key) > 0)
{
keys[j + 1] = keys[j];
items[j + 1] = items[j];
j--;
}
keys[j + 1] = key;
items[j + 1] = item;
}
return;
}
// array case
if (keys is TKey[] keysArray && items is TItem[] itemsArray)
{
Array.Sort(keysArray, itemsArray, index, count, comparer);
return;
}
// fall back: local sort implementation
QuickSort(keys, items, comparer, index, count - 1);
}
///
/// Sort a list of keys, items1 and items2 with respect to the keys, in place using the quick sort algorithm.
///
/// The type of elements in the key list.
/// The type of elements in the first item list.
/// The type of elements in the second item list.
/// List to sort.
/// First list to permute the same way as the key list.
/// Second list to permute the same way as the key list.
/// The zero-based starting index of the range to sort.
/// The length of the range to sort.
/// Comparison, defining the sort order.
public static void Sort(IList keys, IList items1, IList items2, int index, int count, IComparer comparer = null)
{
if (index < 0)
{
throw new ArgumentOutOfRangeException(nameof(index));
}
if (count < 0 || index + count > keys.Count)
{
throw new ArgumentOutOfRangeException(nameof(count));
}
if (count <= 1)
{
return;
}
if (null == comparer)
{
comparer = Comparer.Default;
}
if (count == 2)
{
if (comparer.Compare(keys[index], keys[index + 1]) > 0)
{
Swap(keys, index, index + 1);
Swap(items1, index, index + 1);
Swap(items2, index, index + 1);
}
return;
}
// insertion sort
if (count <= 10)
{
int to = index + count;
for (int i = index + 1; i < to; i++)
{
var key = keys[i];
var item1 = items1[i];
var item2 = items2[i];
int j = i - 1;
while (j >= index && comparer.Compare(keys[j], key) > 0)
{
keys[j + 1] = keys[j];
items1[j + 1] = items1[j];
items2[j + 1] = items2[j];
j--;
}
keys[j + 1] = key;
items1[j + 1] = item1;
items2[j + 1] = item2;
}
return;
}
// fall back: local sort implementation
QuickSort(keys, items1, items2, comparer, index, count - 1);
}
///
/// Sort a list of keys and items with respect to the keys, in place using the quick sort algorithm.
///
/// The type of elements in the primary list.
/// The type of elements in the secondary list.
/// List to sort.
/// List to sort on duplicate primary items, and permute the same way as the key list.
/// Comparison, defining the primary sort order.
/// Comparison, defining the secondary sort order.
public static void SortAll(IList primary, IList secondary, IComparer primaryComparer = null, IComparer secondaryComparer = null)
{
if (null == primaryComparer)
{
primaryComparer = Comparer.Default;
}
if (null == secondaryComparer)
{
secondaryComparer = Comparer.Default;
}
// local sort implementation
QuickSortAll(primary, secondary, primaryComparer, secondaryComparer, 0, primary.Count - 1);
}
///
/// Recursive implementation for an in place quick sort on a list.
///
/// The type of the list on which the quick sort is performed.
/// The list which is sorted using quick sort.
/// The method with which to compare two elements of the quick sort.
/// The left boundary of the quick sort.
/// The right boundary of the quick sort.
static void QuickSort(IList keys, IComparer comparer, int left, int right)
{
do
{
// Pivoting
int a = left;
int b = right;
int p = a + ((b - a) >> 1); // midpoint
if (comparer.Compare(keys[a], keys[p]) > 0)
{
Swap(keys, a, p);
}
if (comparer.Compare(keys[a], keys[b]) > 0)
{
Swap(keys, a, b);
}
if (comparer.Compare(keys[p], keys[b]) > 0)
{
Swap(keys, p, b);
}
T pivot = keys[p];
// Hoare Partitioning
do
{
while (comparer.Compare(keys[a], pivot) < 0)
{
a++;
}
while (comparer.Compare(pivot, keys[b]) < 0)
{
b--;
}
if (a > b)
{
break;
}
if (a < b)
{
Swap(keys, a, b);
}
a++;
b--;
} while (a <= b);
// In order to limit the recursion depth to log(n), we sort the
// shorter partition recursively and the longer partition iteratively.
if ((b - left) <= (right - a))
{
if (left < b)
{
QuickSort(keys, comparer, left, b);
}
left = a;
}
else
{
if (a < right)
{
QuickSort(keys, comparer, a, right);
}
right = b;
}
} while (left < right);
}
///
/// Recursive implementation for an in place quick sort on a list while reordering one other list accordingly.
///
/// The type of the list on which the quick sort is performed.
/// The type of the list which is automatically reordered accordingly.
/// The list which is sorted using quick sort.
/// The list which is automatically reordered accordingly.
/// The method with which to compare two elements of the quick sort.
/// The left boundary of the quick sort.
/// The right boundary of the quick sort.
static void QuickSort(IList keys, IList items, IComparer comparer, int left, int right)
{
do
{
// Pivoting
int a = left;
int b = right;
int p = a + ((b - a) >> 1); // midpoint
if (comparer.Compare(keys[a], keys[p]) > 0)
{
Swap(keys, a, p);
Swap(items, a, p);
}
if (comparer.Compare(keys[a], keys[b]) > 0)
{
Swap(keys, a, b);
Swap(items, a, b);
}
if (comparer.Compare(keys[p], keys[b]) > 0)
{
Swap(keys, p, b);
Swap(items, p, b);
}
T pivot = keys[p];
// Hoare Partitioning
do
{
while (comparer.Compare(keys[a], pivot) < 0)
{
a++;
}
while (comparer.Compare(pivot, keys[b]) < 0)
{
b--;
}
if (a > b)
{
break;
}
if (a < b)
{
Swap(keys, a, b);
Swap(items, a, b);
}
a++;
b--;
} while (a <= b);
// In order to limit the recursion depth to log(n), we sort the
// shorter partition recursively and the longer partition iteratively.
if ((b - left) <= (right - a))
{
if (left < b)
{
QuickSort(keys, items, comparer, left, b);
}
left = a;
}
else
{
if (a < right)
{
QuickSort(keys, items, comparer, a, right);
}
right = b;
}
} while (left < right);
}
///
/// Recursive implementation for an in place quick sort on one list while reordering two other lists accordingly.
///
/// The type of the list on which the quick sort is performed.
/// The type of the first list which is automatically reordered accordingly.
/// The type of the second list which is automatically reordered accordingly.
/// The list which is sorted using quick sort.
/// The first list which is automatically reordered accordingly.
/// The second list which is automatically reordered accordingly.
/// The method with which to compare two elements of the quick sort.
/// The left boundary of the quick sort.
/// The right boundary of the quick sort.
static void QuickSort(
IList keys, IList items1, IList items2,
IComparer comparer,
int left, int right)
{
do
{
// Pivoting
int a = left;
int b = right;
int p = a + ((b - a) >> 1); // midpoint
if (comparer.Compare(keys[a], keys[p]) > 0)
{
Swap(keys, a, p);
Swap(items1, a, p);
Swap(items2, a, p);
}
if (comparer.Compare(keys[a], keys[b]) > 0)
{
Swap(keys, a, b);
Swap(items1, a, b);
Swap(items2, a, b);
}
if (comparer.Compare(keys[p], keys[b]) > 0)
{
Swap(keys, p, b);
Swap(items1, p, b);
Swap(items2, p, b);
}
T pivot = keys[p];
// Hoare Partitioning
do
{
while (comparer.Compare(keys[a], pivot) < 0)
{
a++;
}
while (comparer.Compare(pivot, keys[b]) < 0)
{
b--;
}
if (a > b)
{
break;
}
if (a < b)
{
Swap(keys, a, b);
Swap(items1, a, b);
Swap(items2, a, b);
}
a++;
b--;
} while (a <= b);
// In order to limit the recursion depth to log(n), we sort the
// shorter partition recursively and the longer partition iteratively.
if ((b - left) <= (right - a))
{
if (left < b)
{
QuickSort(keys, items1, items2, comparer, left, b);
}
left = a;
}
else
{
if (a < right)
{
QuickSort(keys, items1, items2, comparer, a, right);
}
right = b;
}
} while (left < right);
}
///
/// Recursive implementation for an in place quick sort on the primary and then by the secondary list while reordering one secondary list accordingly.
///
/// The type of the primary list.
/// The type of the secondary list.
/// The list which is sorted using quick sort.
/// The list which is sorted secondarily (on primary duplicates) and automatically reordered accordingly.
/// The method with which to compare two elements of the primary list.
/// The method with which to compare two elements of the secondary list.
/// The left boundary of the quick sort.
/// The right boundary of the quick sort.
static void QuickSortAll(
IList primary, IList secondary,
IComparer primaryComparer, IComparer secondaryComparer,
int left, int right)
{
do
{
// Pivoting
int a = left;
int b = right;
int p = a + ((b - a) >> 1); // midpoint
int ap = primaryComparer.Compare(primary[a], primary[p]);
if (ap > 0 || ap == 0 && secondaryComparer.Compare(secondary[a], secondary[p]) > 0)
{
Swap(primary, a, p);
Swap(secondary, a, p);
}
int ab = primaryComparer.Compare(primary[a], primary[b]);
if (ab > 0 || ab == 0 && secondaryComparer.Compare(secondary[a], secondary[b]) > 0)
{
Swap(primary, a, b);
Swap(secondary, a, b);
}
int pb = primaryComparer.Compare(primary[p], primary[b]);
if (pb > 0 || pb == 0 && secondaryComparer.Compare(secondary[p], secondary[b]) > 0)
{
Swap(primary, p, b);
Swap(secondary, p, b);
}
T1 pivot1 = primary[p];
T2 pivot2 = secondary[p];
// Hoare Partitioning
do
{
int ax;
while ((ax = primaryComparer.Compare(primary[a], pivot1)) < 0 || ax == 0 && secondaryComparer.Compare(secondary[a], pivot2) < 0)
{
a++;
}
int xb;
while ((xb = primaryComparer.Compare(pivot1, primary[b])) < 0 || xb == 0 && secondaryComparer.Compare(pivot2, secondary[b]) < 0)
{
b--;
}
if (a > b)
{
break;
}
if (a < b)
{
Swap(primary, a, b);
Swap(secondary, a, b);
}
a++;
b--;
} while (a <= b);
// In order to limit the recursion depth to log(n), we sort the
// shorter partition recursively and the longer partition iteratively.
if ((b - left) <= (right - a))
{
if (left < b)
{
QuickSortAll(primary, secondary, primaryComparer, secondaryComparer, left, b);
}
left = a;
}
else
{
if (a < right)
{
QuickSortAll(primary, secondary, primaryComparer, secondaryComparer, a, right);
}
right = b;
}
} while (left < right);
}
///
/// Performs an in place swap of two elements in a list.
///
/// The type of elements stored in the list.
/// The list in which the elements are stored.
/// The index of the first element of the swap.
/// The index of the second element of the swap.
static void Swap(IList keys, int a, int b)
{
if (a == b)
{
return;
}
T local = keys[a];
keys[a] = keys[b];
keys[b] = local;
}
}
}