[jboss-svn-commits] JBL Code SVN: r26352 - labs/jbossrules/trunk/drools-docs/drools-docs-solver/src/main/docbook/en-US/Chapter-Solver.

[jboss-svn-commits at lists.jboss.org]

Author: ge0ffrey
Date: 2009-05-03 13:27:36 -0400 (Sun, 03 May 2009)
New Revision: 26352

Modified:
   labs/jbossrules/trunk/drools-docs/drools-docs-solver/src/main/docbook/en-US/Chapter-Solver/Section-Score_calculation.xml
Log:
document score traps

Modified: labs/jbossrules/trunk/drools-docs/drools-docs-solver/src/main/docbook/en-US/Chapter-Solver/Section-Score_calculation.xml
===================================================================
--- labs/jbossrules/trunk/drools-docs/drools-docs-solver/src/main/docbook/en-US/Chapter-Solver/Section-Score_calculation.xml	2009-05-03 17:04:56 UTC (rev 26351)
+++ labs/jbossrules/trunk/drools-docs/drools-docs-solver/src/main/docbook/en-US/Chapter-Solver/Section-Score_calculation.xml	2009-05-03 17:27:36 UTC (rev 26352)
@@ -188,6 +188,25 @@
       </listitem>
 
       <listitem>
+        <para>Be watchfull for score traps. A score trap is a state in which several moves need to be done to resolve or
+        lower the weight of a single constraint occurrence. Some examples of score traps:</para>
+
+        <itemizedlist>
+          <listitem>
+            <para>If you need 2 doctors at each table, but you're only moving 1 doctor at a time, then the solver has no
+            insentive to move a doctor to a table with no doctors. Punish a table with no doctors more then a table with
+            only 1 doctor in your score function.</para>
+          </listitem>
+
+          <listitem>
+            <para>If you only add the table as a cause of the ConstraintOccurrence and forget the jobType (which is
+            doctor or politician), then the solver has no insentive to move a docter to table which is short of a doctor
+            and a politician.</para>
+          </listitem>
+        </itemizedlist>
+      </listitem>
+
+      <listitem>
         <para>If you use tabu search, combine it with a <literal>relativeSelection</literal> selector. Take some time to
         tweak the value of <literal>relativeSelection</literal>.</para>
       </listitem>