Changeset 850 for trunk/sources/HeuristicLab.Permutation/TranslocationInversionManipulator.cs

Timestamp:

11/28/08 10:32:20 (16 years ago)

Author:

vdorfer

Message:

Created API documentation for HeuristicLab.Permutation namespace (#331)

File:

• trunk/sources/HeuristicLab.Permutation/TranslocationInversionManipulator.cs (modified) (2 diffs)

trunk/sources/HeuristicLab.Permutation/TranslocationInversionManipulator.cs

@@ -26 +26 @@
 
 namespace HeuristicLab.Permutation {
+  /// <summary>
+  /// Manipulates a permutation array by moving and reversing a randomly chosen interval of elements to another 
+  /// (randomly chosen) position in the array.
+  /// </summary>
   public class TranslocationInversionManipulator : PermutationManipulatorBase {
+    /// <inheritdoc select="summary"/>
     public override string Description {
       get { return @"TODO\r\nOperator description still missing ..."; }
     }
 
+    /// <summary>
+    /// Moves a randomly chosen interval of elements to another (randomly chosen) position in the given
+    /// <paramref name="permutation"/> array and reverses it.
+    /// </summary>
+    /// <param name="random">The random number generator.</param>
+    /// <param name="permutation">The permutation array to manipulate.</param>
+    /// <returns>The new permuation array with the manipulated data.</returns>
     public static int[] Apply(IRandom random, int[] permutation) {
       int[] result = (int[])permutation.Clone();
@@ -64 +76 @@
     }
 
+    /// <summary>
+    /// Moves a randomly chosen interval of elements to another (randomly chosen) position in the given
+    /// <paramref name="permutation"/> array and reverses it.
+    /// </summary>
+    /// <remarks>Calls <see cref="Apply"/>.</remarks>
+    /// <param name="scope">The current scope.</param>
+    /// <param name="random">The random number generator.</param>
+    /// <param name="permutation">The permutation array to manipulate.</param>
+    /// <returns>The new permuation array with the manipulated data.</returns>
     protected override int[] Manipulate(IScope scope, IRandom random, int[] permutation) {
       return Apply(random, permutation);