Index: dam engine/trunk/src/Deltares.DamEngine.Data/General/Segment.cs
===================================================================
diff -u -r452 -r537
--- dam engine/trunk/src/Deltares.DamEngine.Data/General/Segment.cs	(.../Segment.cs)	(revision 452)
+++ dam engine/trunk/src/Deltares.DamEngine.Data/General/Segment.cs	(.../Segment.cs)	(revision 537)
@@ -28,15 +28,62 @@
 
 namespace Deltares.DamEngine.Data.General
 {
+    /// <summary>
+    /// Class holding the soilprofile (either 1D or 2D) and its probability
+    /// </summary>
+    /// <seealso cref="System.IComparable{Deltares.DamEngine.Data.General.SoilGeometryProbability}" />
     public class SoilGeometryProbability : IComparable<SoilGeometryProbability>
     {
+        /// <summary>
+        /// Gets or sets the soil profile.
+        /// </summary>
+        /// <value>
+        /// The soil profile.
+        /// </value>
         public virtual SoilProfile1D SoilProfile { get; set; }
+
+        /// <summary>
+        /// Gets or sets the name of the soilgeometry2d.
+        /// </summary>
+        /// <value>
+        /// The name of the soilgeometry2d.
+        /// </value>
+
         public virtual string SoilGeometry2DName { get; set; }
+
+        /// <summary>
+        /// Gets or sets the name of the soilgeometry1d.
+        /// </summary>
+        /// <value>
+        /// The name of the soilgeometry1d.
+        /// </value>
+        public virtual string SoilGeometry1DName { get; set; }
+
+        /// <summary>
+        /// Gets or sets the soilprofile2d.
+        /// </summary>
+        /// <value>
+        /// The soilprofile2d.
+        /// </value>
         public virtual SoilProfile2D SoilProfile2D { get; set; }
+
+        /// <summary>
+        /// Gets or sets the type of the segment failure mechanism.
+        /// </summary>
+        /// <value>
+        /// The type of the segment failure mechanism.
+        /// </value>
         public virtual FailureMechanismSystemType? SegmentFailureMechanismType { get; set; }
-        public virtual double Probability { get; set; } // Probability of occurance; number between 0.0 and 100.0
 
         /// <summary>
+        /// Gets or sets the probability of occurance; number between 0.0 and 100.0.
+        /// </summary>
+        /// <value>
+        /// The probability.
+        /// </value>
+        public virtual double Probability { get; set; }
+
+        /// <summary>
         /// Assigns the specified soil geometry probability.
         /// </summary>
         /// <param name="soilGeometryProbability">The soil geometry probability.</param>
@@ -52,6 +99,13 @@
             SoilGeometry2DName = soilGeometryProbability.SoilGeometry2DName;
         }
 
+        /// <summary>
+        /// Gets the type of the soil geometry.
+        /// </summary>
+        /// <value>
+        /// The type of the soil geometry.
+        /// </value>
+        /// <exception cref="System.Exception">No soilprofile assigned</exception>
         public SoilGeometryType SoilGeometryType
         {
             get
@@ -90,16 +144,32 @@
             } 
         }
 
+        /// <summary>
+        /// Compares the current instance with another object of the same type and returns an integer that indicates whether the current instance precedes, follows, or occurs in the same position in the sort order as the other object.
+        /// </summary>
+        /// <param name="other">An object to compare with this instance.</param>
+        /// <returns>
+        /// A value that indicates the relative order of the objects being compared. The return value has these meanings: Value Meaning Less than zero This instance precedes <paramref name="other" /> in the sort order.  Zero This instance occurs in the same position in the sort order as <paramref name="other" />. Greater than zero This instance follows <paramref name="other" /> in the sort order.
+        /// </returns>
         public int CompareTo(SoilGeometryProbability other)
         {
             return - this.Probability.CompareTo(other.Probability);
         }
     }
 
+    /// <summary>
+    /// Class holding all soilprofiles (1D/2D) and their probabilities as segment.
+    /// </summary>
     public class Segment
     {
         private List<SoilGeometryProbability> soilGeometryProbabilities = new List<SoilGeometryProbability>();
 
+        /// <summary>
+        /// Gets or sets the name.
+        /// </summary>
+        /// <value>
+        /// The name.
+        /// </value>
         public virtual string Name { get; set; }
 
         /// <summary>
@@ -110,6 +180,11 @@
             get { return this.soilGeometryProbabilities; }
         }
 
+        /// <summary>
+        /// Gets the most probable profile1D.
+        /// </summary>
+        /// <param name="segmentFailureMechanismType">Type of the segment failure mechanism.</param>
+        /// <returns></returns>
         public SoilProfile1D GetMostProbableProfile(FailureMechanismSystemType? segmentFailureMechanismType)
         {
             IEnumerable<SoilGeometryProbability> spps = from SoilGeometryProbability spp in this.soilGeometryProbabilities
@@ -122,6 +197,11 @@
                 return null;
         }
 
+        /// <summary>
+        /// Gets the name of the most probable geometry2dname (name of profile2D).
+        /// </summary>
+        /// <param name="segmentFailureMechanismType">Type of the segment failure mechanism.</param>
+        /// <returns></returns>
         public string GetMostProbableGeometry2DName(FailureMechanismSystemType? segmentFailureMechanismType)
         {
             IEnumerable<SoilGeometryProbability> spps = from SoilGeometryProbability spp in this.soilGeometryProbabilities
@@ -134,12 +214,24 @@
                 return null;
         }
 
+        /// <summary>
+        /// Adds the soilprofile1D probability.
+        /// </summary>
+        /// <param name="soilProfile">The soil profile.</param>
+        /// <param name="probability">The probability.</param>
+        /// <param name="segmentFailureMechanismType">Type of the segment failure mechanism.</param>
         public void AddSoilProfileProbability(SoilProfile1D soilProfile, double probability, FailureMechanismSystemType? segmentFailureMechanismType)
         {
             if (this.soilGeometryProbabilities.Where(x => x.SoilProfile == soilProfile && x.SegmentFailureMechanismType == segmentFailureMechanismType).Count() == 0)
                 this.soilGeometryProbabilities.Add(new SoilGeometryProbability() { SoilProfile = soilProfile, Probability = probability, SegmentFailureMechanismType = segmentFailureMechanismType, SoilGeometry2DName = null });
         }
 
+        /// <summary>
+        /// Gets the soilprofile1D probability.
+        /// </summary>
+        /// <param name="soilProfile">The soil profile.</param>
+        /// <param name="segmentFailureMechanismType">Type of the segment failure mechanism.</param>
+        /// <returns></returns>
         public double? GetSoilProfileProbability(SoilProfile1D soilProfile, FailureMechanismSystemType? segmentFailureMechanismType)
         {
             IEnumerable<SoilGeometryProbability> probs = this.soilGeometryProbabilities.Where(
@@ -152,12 +244,24 @@
                 return null;
         }
 
+        /// <summary>
+        /// Adds the soilgeometry2d probability.
+        /// </summary>
+        /// <param name="soilGeometry2DName">Name of the soilgeometry2d (= profile2D).</param>
+        /// <param name="probability">The probability.</param>
+        /// <param name="segmentFailureMechanismType">Type of the segment failure mechanism.</param>
         public void AddSoilGeometry2DProbability(string soilGeometry2DName, double probability, FailureMechanismSystemType? segmentFailureMechanismType)
         {
             if (this.soilGeometryProbabilities.Where(x => x.SoilGeometry2DName == soilGeometry2DName && x.SegmentFailureMechanismType == segmentFailureMechanismType).Count() == 0)
                 this.soilGeometryProbabilities.Add(new SoilGeometryProbability() { SoilProfile = null, Probability = probability, SegmentFailureMechanismType = segmentFailureMechanismType, SoilGeometry2DName = soilGeometry2DName });
         }
 
+        /// <summary>
+        /// Gets the soilgeometry2d probability.
+        /// </summary>
+        /// <param name="soilGeometry2DName">Name of the soilgeometry2d (=profile2D).</param>
+        /// <param name="segmentFailureMechanismType">Type of the segment failure mechanism.</param>
+        /// <returns></returns>
         public double? GetSoilGeometry2DProbability(string soilGeometry2DName, FailureMechanismSystemType? segmentFailureMechanismType)
         {
             IEnumerable<SoilGeometryProbability> probs = this.soilGeometryProbabilities.Where(
@@ -170,6 +274,12 @@
                 return null;
         }
 
+        /// <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()
         {
             StringBuilder sb = new StringBuilder();
@@ -198,6 +308,8 @@
         /// <summary>
         /// Assemble a list of key/value pairs with the relevant parameters for the specified 1d-profile
         /// </summary>
+        /// <param name="soilProfile1DId">The soil profile1 d identifier.</param>
+        /// <param name="failureMechanismSystemType">Type of the failure mechanism system.</param>
         /// <returns></returns>
         public Dictionary<string, string> GetParametersForSoilProfile1DAsNameValuePairs(string soilProfile1DId, FailureMechanismSystemType failureMechanismSystemType)
         {