1
0
mirror of https://git.dev.opencascade.org/repos/occt.git synced 2025-05-16 10:54:53 +03:00
occt/src/SortTools/SortTools.cdl
bugmaster b311480ed5 0023024: Update headers of OCCT files
Added appropriate copyright and license information in source files
2012-03-21 19:43:04 +04:00

130 lines
5.9 KiB
Plaintext
Executable File

-- Created on: 1991-03-07
-- Created by: Herve Legrand
-- Copyright (c) 1991-1999 Matra Datavision
-- Copyright (c) 1999-2012 OPEN CASCADE SAS
--
-- The content of this file is subject to the Open CASCADE Technology Public
-- License Version 6.5 (the "License"). You may not use the content of this file
-- except in compliance with the License. Please obtain a copy of the License
-- at http://www.opencascade.org and read it completely before using this file.
--
-- The Initial Developer of the Original Code is Open CASCADE S.A.S., having its
-- main offices at: 1, place des Freres Montgolfier, 78280 Guyancourt, France.
--
-- The Original Code and all software distributed under the License is
-- distributed on an "AS IS" basis, without warranty of any kind, and the
-- Initial Developer hereby disclaims all such warranties, including without
-- limitation, any warranties of merchantability, fitness for a particular
-- purpose or non-infringement. Please see the License for the specific terms
-- and conditions governing the rights and limitations under the License.
-- Revised: Fri Oct 30 1992
-- By : Mireille MERCIEN
package SortTools
---Purpose: This package provides the basic sorting tools generally
-- used.
uses TCollection,
TColStd
is
generic class HeapSort;
---Purpose: Sort an array using the heap sort algorithm.
generic class QuickSort;
---Purpose: Sort an array using the quick sort algorithm.
generic class ShellSort;
---Purpose: Sort an array using the shell sort algorithm.
generic class StraightInsertionSort;
---Purpose: Sort an array using the straight insertion sort algorithm.
-- The table below summarizes the most important characteristics that
-- must be considered when selecting a particular sorting algorithm.
-- A sorting algorithm is known as stable if the initial order of items
-- with equals keys is preserved after the sorting operation.
------------------------------------------------------------------------
-- Algorithm Stable Comparisons Moves
-- Min Avg Max Min Avg Max
------------------------------------------------------------------------
-- 2 2
-- QuickSort No nlogn nlogn n nlogn nlogn n
--
------------------------------------------------------------------------
--
-- HeapSort No nlogn nlogn nlogn nlogn nlogn nlogn
--
------------------------------------------------------------------------
-- 1.25 1.25
-- ShellSort No - n - - n -
--
------------------------------------------------------------------------
-- 2 2 2 2
-- StraightInsertion Yes n n n n n n
--
-------------------------------------------------------------------------
--+ Heap sort exhibits an interesting time complexity, in that it runs
-- on the order of nlogn for the best, average, and worst case.
--+ Quick sort is still faster on the average(its constant of proportiona-
-- lity is lower), but it does not guarantee such good worst-case perfor-
-- mance.
--+ Shell sort is not sensitive to the initial ordering and offers accepta-
-- ble running time even for moderately larges arrays (say, 1000 elements).
--+ Insertion sort is the method of choice for "almost sorted" arrays with
-- few inversions : for such cases, it will outperform even the more
-- sophisticated method (quick sort, heap sort).
-- Instantiations --
-- ************** --
------------------------------------------------------------------------
--
-- Instantiations QuickSort (Integer,Real)
-- ***************************************
class QuickSortOfInteger instantiates QuickSort(Integer,
Array1OfInteger from TColStd,
CompareOfInteger from TCollection);
class QuickSortOfReal instantiates QuickSort(Real,
Array1OfReal from TColStd,
CompareOfReal from TCollection );
-- Instantiations HeapSort (Integer,Real)
-- ***************************************
class HeapSortOfInteger instantiates HeapSort(Integer,
Array1OfInteger from TColStd,
CompareOfInteger from TCollection);
class HeapSortOfReal instantiates HeapSort(Real,
Array1OfReal from TColStd,
CompareOfReal from TCollection);
-- Instantiations ShellSort (Integer,Real)
-- ***************************************
class ShellSortOfInteger instantiates ShellSort(Integer,
Array1OfInteger from TColStd,
CompareOfInteger from TCollection);
class ShellSortOfReal instantiates ShellSort(Real,
Array1OfReal from TColStd,
CompareOfReal from TCollection );
-- Instantiations StraightInsertionSort (Integer,Real)
-- ***************************************************
class StraightInsertionSortOfInteger instantiates
StraightInsertionSort(Integer,
Array1OfInteger from TColStd,
CompareOfInteger from TCollection);
class StraightInsertionSortOfReal instantiates
StraightInsertionSort(Real,
Array1OfReal from TColStd,
CompareOfReal from TCollection);
end SortTools;