Publish version 2.0.0a0

MICS-Lab · May 23, 2024 · be12449 · be12449
1 parent ae2b4bb
commit be12449
Show file tree

Hide file tree

Showing 67 changed files with 283 additions and 206 deletions.
diff --git a/doc-sources/changelog.rst b/doc-sources/changelog.rst
@@ -4,6 +4,12 @@
 Changelog
 =========
 
+Version 2.0.0a0 (2024-05-23)
+============================
+
+- **Breaking** Let some thresholds be unreachable! (Fix bug found in real-life ASA data)
+- Support Python 3.12
+
 Version 1.1.0 (2024-02-08)
 ==========================
 

diff --git a/doc-sources/conceptual-overview/conceptual-overview.ipynb b/doc-sources/conceptual-overview/conceptual-overview.ipynb
@@ -21,7 +21,7 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "# Reproduction command (with lincs version 1.1.1.dev0): lincs classify problem.yml model.yml alternatives.csv\n",
+      "# Reproduction command (with lincs version 2.0.0a0): lincs classify problem.yml model.yml alternatives.csv\n",
       "name,Math,Physics,Literature,History,category\n",
       "A,1,1,1,1,\"Full scholarship\"\n",
       "B,1,1,1,0,\"Full scholarship\"\n",

diff --git a/doc-sources/get-started.rst b/doc-sources/get-started.rst
@@ -73,7 +73,7 @@ The generated ``problem.yml`` should look like:
 
 .. code:: yaml
 
-    # Reproduction command (with lincs version 1.1.1.dev0): lincs generate classification-problem 4 3 --random-seed 40
+    # Reproduction command (with lincs version 2.0.0a0): lincs generate classification-problem 4 3 --random-seed 40
     kind: classification-problem
     format_version: 1
     criteria:
@@ -144,7 +144,7 @@ It should look like:
 
 .. code:: yaml
 
-    # Reproduction command (with lincs version 1.1.1.dev0): lincs generate classification-model problem.yml --random-seed 41 --model-type mrsort
+    # Reproduction command (with lincs version 2.0.0a0): lincs generate classification-model problem.yml --random-seed 41 --model-type mrsort
     kind: ncs-classification-model
     format_version: 1
     accepted_values:
@@ -217,7 +217,7 @@ It should start with something like this, and contain 1000 alternatives:
 
 .. code:: text
 
-    # Reproduction command (with lincs version 1.1.1.dev0): lincs generate classified-alternatives problem.yml model.yml 1000 --random-seed 42 --misclassified-count 0
+    # Reproduction command (with lincs version 2.0.0a0): lincs generate classified-alternatives problem.yml model.yml 1000 --random-seed 42 --misclassified-count 0
     name,"Criterion 1","Criterion 2","Criterion 3","Criterion 4",category
     "Alternative 1",0.37454012,0.796543002,0.95071429,0.183434784,"Best category"
     "Alternative 2",0.731993914,0.779690981,0.598658502,0.596850157,"Intermediate category 1"
@@ -253,7 +253,7 @@ so it is numerically different:
 
 .. code:: yaml
 
-    # Reproduction command (with lincs version 1.1.1.dev0): lincs learn classification-model problem.yml learning-set.csv --model-type mrsort --mrsort.strategy weights-profiles-breed --mrsort.weights-profiles-breed.models-count 9 --mrsort.weights-profiles-breed.accuracy-heuristic.random-seed 43 --mrsort.weights-profiles-breed.initialization-strategy maximize-discrimination-per-criterion --mrsort.weights-profiles-breed.weights-strategy linear-program --mrsort.weights-profiles-breed.linear-program.solver glop --mrsort.weights-profiles-breed.profiles-strategy accuracy-heuristic --mrsort.weights-profiles-breed.accuracy-heuristic.processor cpu --mrsort.weights-profiles-breed.breed-strategy reinitialize-least-accurate --mrsort.weights-profiles-breed.reinitialize-least-accurate.portion 0.5 --mrsort.weights-profiles-breed.target-accuracy 1.0
+    # Reproduction command (with lincs version 2.0.0a0): lincs learn classification-model problem.yml learning-set.csv --model-type mrsort --mrsort.strategy weights-profiles-breed --mrsort.weights-profiles-breed.models-count 9 --mrsort.weights-profiles-breed.accuracy-heuristic.random-seed 43 --mrsort.weights-profiles-breed.initialization-strategy maximize-discrimination-per-criterion --mrsort.weights-profiles-breed.weights-strategy linear-program --mrsort.weights-profiles-breed.linear-program.solver glop --mrsort.weights-profiles-breed.profiles-strategy accuracy-heuristic --mrsort.weights-profiles-breed.accuracy-heuristic.processor cpu --mrsort.weights-profiles-breed.breed-strategy reinitialize-least-accurate --mrsort.weights-profiles-breed.reinitialize-least-accurate.portion 0.5 --mrsort.weights-profiles-breed.target-accuracy 1.0
     kind: ncs-classification-model
     format_version: 1
     accepted_values:

diff --git a/doc-sources/get-started/get-started.ipynb b/doc-sources/get-started/get-started.ipynb
@@ -48,7 +48,7 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "# Reproduction command (with lincs version 1.1.1.dev0): lincs generate classification-problem 4 3 --random-seed 40\n",
+      "# Reproduction command (with lincs version 2.0.0a0): lincs generate classification-problem 4 3 --random-seed 40\n",
       "kind: classification-problem\n",
       "format_version: 1\n",
       "criteria:\n",
@@ -126,7 +126,7 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "# Reproduction command (with lincs version 1.1.1.dev0): lincs generate classification-model problem.yml --random-seed 41 --model-type mrsort\n",
+      "# Reproduction command (with lincs version 2.0.0a0): lincs generate classification-model problem.yml --random-seed 41 --model-type mrsort\n",
       "kind: ncs-classification-model\n",
       "format_version: 1\n",
       "accepted_values:\n",
@@ -211,7 +211,7 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "# Reproduction command (with lincs version 1.1.1.dev0): lincs generate classified-alternatives problem.yml model.yml 1000 --random-seed 42 --misclassified-count 0\n",
+      "# Reproduction command (with lincs version 2.0.0a0): lincs generate classified-alternatives problem.yml model.yml 1000 --random-seed 42 --misclassified-count 0\n",
       "name,\"Criterion 1\",\"Criterion 2\",\"Criterion 3\",\"Criterion 4\",category\n",
       "\"Alternative 1\",0.37454012,0.796543002,0.95071429,0.183434784,\"Best category\"\n",
       "\"Alternative 2\",0.731993914,0.779690981,0.598658502,0.596850157,\"Intermediate category 1\"\n",
@@ -260,7 +260,7 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "# Reproduction command (with lincs version 1.1.1.dev0): lincs learn classification-model problem.yml learning-set.csv --model-type mrsort --mrsort.strategy weights-profiles-breed --mrsort.weights-profiles-breed.models-count 9 --mrsort.weights-profiles-breed.accuracy-heuristic.random-seed 43 --mrsort.weights-profiles-breed.initialization-strategy maximize-discrimination-per-criterion --mrsort.weights-profiles-breed.weights-strategy linear-program --mrsort.weights-profiles-breed.linear-program.solver glop --mrsort.weights-profiles-breed.profiles-strategy accuracy-heuristic --mrsort.weights-profiles-breed.accuracy-heuristic.processor cpu --mrsort.weights-profiles-breed.breed-strategy reinitialize-least-accurate --mrsort.weights-profiles-breed.reinitialize-least-accurate.portion 0.5 --mrsort.weights-profiles-breed.target-accuracy 1.0\n",
+      "# Reproduction command (with lincs version 2.0.0a0): lincs learn classification-model problem.yml learning-set.csv --model-type mrsort --mrsort.strategy weights-profiles-breed --mrsort.weights-profiles-breed.models-count 9 --mrsort.weights-profiles-breed.accuracy-heuristic.random-seed 43 --mrsort.weights-profiles-breed.initialization-strategy maximize-discrimination-per-criterion --mrsort.weights-profiles-breed.weights-strategy linear-program --mrsort.weights-profiles-breed.linear-program.solver glop --mrsort.weights-profiles-breed.profiles-strategy accuracy-heuristic --mrsort.weights-profiles-breed.accuracy-heuristic.processor cpu --mrsort.weights-profiles-breed.breed-strategy reinitialize-least-accurate --mrsort.weights-profiles-breed.reinitialize-least-accurate.portion 0.5 --mrsort.weights-profiles-breed.target-accuracy 1.0\n",
       "kind: ncs-classification-model\n",
       "format_version: 1\n",
       "accepted_values:\n",

diff --git a/doc-sources/roadmap.rst b/doc-sources/roadmap.rst
@@ -9,7 +9,7 @@ This is not set in stone and can change based on the time we can spend working o
 external contributions, *etc.*
 Items listed in named versions are more likely to happen than items listed in "later versions".
 
-Version 1.2
+Version 2.0
 ===========
 
 (planned late 2024)

diff --git a/doc-sources/user-guide.rst b/doc-sources/user-guide.rst
@@ -512,7 +512,7 @@ They produce a different kind of model, with the sufficient coalitions specified
 
 .. code:: yaml
 
-    # Reproduction command (with lincs version 1.1.1.dev0): lincs learn classification-model problem.yml learning-set.csv --model-type ucncs --ucncs.strategy sat-by-coalitions
+    # Reproduction command (with lincs version 2.0.0a0): lincs learn classification-model problem.yml learning-set.csv --model-type ucncs --ucncs.strategy sat-by-coalitions
     kind: ncs-classification-model
     format_version: 1
     accepted_values:

diff --git a/doc-sources/user-guide/alglib-learning/alglib-learning.ipynb b/doc-sources/user-guide/alglib-learning/alglib-learning.ipynb
@@ -27,7 +27,7 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "# Reproduction command (with lincs version 1.1.1.dev0): lincs learn classification-model problem.yml learning-set.csv --model-type mrsort --mrsort.strategy weights-profiles-breed --mrsort.weights-profiles-breed.models-count 9 --mrsort.weights-profiles-breed.accuracy-heuristic.random-seed 43 --mrsort.weights-profiles-breed.initialization-strategy maximize-discrimination-per-criterion --mrsort.weights-profiles-breed.weights-strategy linear-program --mrsort.weights-profiles-breed.linear-program.solver alglib --mrsort.weights-profiles-breed.profiles-strategy accuracy-heuristic --mrsort.weights-profiles-breed.accuracy-heuristic.processor cpu --mrsort.weights-profiles-breed.breed-strategy reinitialize-least-accurate --mrsort.weights-profiles-breed.reinitialize-least-accurate.portion 0.5 --mrsort.weights-profiles-breed.target-accuracy 1.0\n",
+      "# Reproduction command (with lincs version 2.0.0a0): lincs learn classification-model problem.yml learning-set.csv --model-type mrsort --mrsort.strategy weights-profiles-breed --mrsort.weights-profiles-breed.models-count 9 --mrsort.weights-profiles-breed.accuracy-heuristic.random-seed 43 --mrsort.weights-profiles-breed.initialization-strategy maximize-discrimination-per-criterion --mrsort.weights-profiles-breed.weights-strategy linear-program --mrsort.weights-profiles-breed.linear-program.solver alglib --mrsort.weights-profiles-breed.profiles-strategy accuracy-heuristic --mrsort.weights-profiles-breed.accuracy-heuristic.processor cpu --mrsort.weights-profiles-breed.breed-strategy reinitialize-least-accurate --mrsort.weights-profiles-breed.reinitialize-least-accurate.portion 0.5 --mrsort.weights-profiles-breed.target-accuracy 1.0\n",
       "kind: ncs-classification-model\n",
       "format_version: 1\n",
       "accepted_values:\n",

diff --git a/doc-sources/user-guide/gpu-learning/gpu-learning.ipynb b/doc-sources/user-guide/gpu-learning/gpu-learning.ipynb
@@ -27,7 +27,7 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "# Reproduction command (with lincs version 1.1.1.dev0): lincs learn classification-model problem.yml learning-set.csv --model-type mrsort --mrsort.strategy weights-profiles-breed --mrsort.weights-profiles-breed.models-count 9 --mrsort.weights-profiles-breed.accuracy-heuristic.random-seed 43 --mrsort.weights-profiles-breed.initialization-strategy maximize-discrimination-per-criterion --mrsort.weights-profiles-breed.weights-strategy linear-program --mrsort.weights-profiles-breed.linear-program.solver glop --mrsort.weights-profiles-breed.profiles-strategy accuracy-heuristic --mrsort.weights-profiles-breed.accuracy-heuristic.processor gpu --mrsort.weights-profiles-breed.breed-strategy reinitialize-least-accurate --mrsort.weights-profiles-breed.reinitialize-least-accurate.portion 0.5 --mrsort.weights-profiles-breed.target-accuracy 1.0\n",
+      "# Reproduction command (with lincs version 2.0.0a0): lincs learn classification-model problem.yml learning-set.csv --model-type mrsort --mrsort.strategy weights-profiles-breed --mrsort.weights-profiles-breed.models-count 9 --mrsort.weights-profiles-breed.accuracy-heuristic.random-seed 43 --mrsort.weights-profiles-breed.initialization-strategy maximize-discrimination-per-criterion --mrsort.weights-profiles-breed.weights-strategy linear-program --mrsort.weights-profiles-breed.linear-program.solver glop --mrsort.weights-profiles-breed.profiles-strategy accuracy-heuristic --mrsort.weights-profiles-breed.accuracy-heuristic.processor gpu --mrsort.weights-profiles-breed.breed-strategy reinitialize-least-accurate --mrsort.weights-profiles-breed.reinitialize-least-accurate.portion 0.5 --mrsort.weights-profiles-breed.target-accuracy 1.0\n",
       "kind: ncs-classification-model\n",
       "format_version: 1\n",
       "accepted_values:\n",

diff --git a/doc-sources/user-guide/sat-learning/sat-learning.ipynb b/doc-sources/user-guide/sat-learning/sat-learning.ipynb
@@ -22,7 +22,7 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "# Reproduction command (with lincs version 1.1.1.dev0): lincs learn classification-model problem.yml learning-set.csv --model-type ucncs --ucncs.strategy sat-by-coalitions\n",
+      "# Reproduction command (with lincs version 2.0.0a0): lincs learn classification-model problem.yml learning-set.csv --model-type ucncs --ucncs.strategy sat-by-coalitions\n",
       "kind: ncs-classification-model\n",
       "format_version: 1\n",
       "accepted_values:\n",
@@ -58,7 +58,7 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "# Reproduction command (with lincs version 1.1.1.dev0): lincs learn classification-model problem.yml learning-set.csv --model-type ucncs --ucncs.strategy max-sat-by-separation --ucncs.max-sat-by-separation.solver eval-max-sat --ucncs.max-sat-by-separation.eval-max-sat.nb-minimize-threads 0 --ucncs.max-sat-by-separation.eval-max-sat.timeout-fast-minimize 60 --ucncs.max-sat-by-separation.eval-max-sat.coef-minimize-time 2\n",
+      "# Reproduction command (with lincs version 2.0.0a0): lincs learn classification-model problem.yml learning-set.csv --model-type ucncs --ucncs.strategy max-sat-by-separation --ucncs.max-sat-by-separation.solver eval-max-sat --ucncs.max-sat-by-separation.eval-max-sat.nb-minimize-threads 0 --ucncs.max-sat-by-separation.eval-max-sat.timeout-fast-minimize 60 --ucncs.max-sat-by-separation.eval-max-sat.coef-minimize-time 2\n",
       "kind: ncs-classification-model\n",
       "format_version: 1\n",
       "accepted_values:\n",

diff --git a/doc-sources/user-guide/synthetic-data/synthetic-data.ipynb b/doc-sources/user-guide/synthetic-data/synthetic-data.ipynb
@@ -14,7 +14,7 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "# Reproduction command (with lincs version 1.1.1.dev0): lincs generate classification-problem 4 3 --random-seed 57\n",
+      "# Reproduction command (with lincs version 2.0.0a0): lincs generate classification-problem 4 3 --random-seed 57\n",
       "kind: classification-problem\n",
       "format_version: 1\n",
       "criteria:\n",
@@ -63,7 +63,7 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "# Reproduction command (with lincs version 1.1.1.dev0): lincs generate classification-model problem.yml --random-seed 58 --model-type mrsort\n",
+      "# Reproduction command (with lincs version 2.0.0a0): lincs generate classification-model problem.yml --random-seed 58 --model-type mrsort\n",
       "kind: ncs-classification-model\n",
       "format_version: 1\n",
       "accepted_values:\n",
@@ -101,7 +101,7 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "# Reproduction command (with lincs version 1.1.1.dev0): lincs generate classified-alternatives problem.yml model.yml 100 --random-seed 59 --misclassified-count 0\n",
+      "# Reproduction command (with lincs version 2.0.0a0): lincs generate classified-alternatives problem.yml model.yml 100 --random-seed 59 --misclassified-count 0\n",
       "name,\"Criterion 1\",\"Criterion 2\",\"Criterion 3\",\"Criterion 4\",category\n",
       "\"Alternative 1\",0.924035132,0.804616809,0.157870576,0.637420833,\"Best category\"\n",
       "\"Alternative 2\",0.866915047,0.979161799,0.0841569453,0.397855282,\"Best category\"\n",
@@ -224,7 +224,7 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "# Reproduction command (with lincs version 1.1.1.dev0): lincs learn classification-model problem.yml learning-set.csv --model-type mrsort --mrsort.strategy weights-profiles-breed --mrsort.weights-profiles-breed.models-count 9 --mrsort.weights-profiles-breed.accuracy-heuristic.random-seed 60 --mrsort.weights-profiles-breed.initialization-strategy maximize-discrimination-per-criterion --mrsort.weights-profiles-breed.weights-strategy linear-program --mrsort.weights-profiles-breed.linear-program.solver glop --mrsort.weights-profiles-breed.profiles-strategy accuracy-heuristic --mrsort.weights-profiles-breed.accuracy-heuristic.processor cpu --mrsort.weights-profiles-breed.breed-strategy reinitialize-least-accurate --mrsort.weights-profiles-breed.reinitialize-least-accurate.portion 0.5 --mrsort.weights-profiles-breed.target-accuracy 1.0\n",
+      "# Reproduction command (with lincs version 2.0.0a0): lincs learn classification-model problem.yml learning-set.csv --model-type mrsort --mrsort.strategy weights-profiles-breed --mrsort.weights-profiles-breed.models-count 9 --mrsort.weights-profiles-breed.accuracy-heuristic.random-seed 60 --mrsort.weights-profiles-breed.initialization-strategy maximize-discrimination-per-criterion --mrsort.weights-profiles-breed.weights-strategy linear-program --mrsort.weights-profiles-breed.linear-program.solver glop --mrsort.weights-profiles-breed.profiles-strategy accuracy-heuristic --mrsort.weights-profiles-breed.accuracy-heuristic.processor cpu --mrsort.weights-profiles-breed.breed-strategy reinitialize-least-accurate --mrsort.weights-profiles-breed.reinitialize-least-accurate.portion 0.5 --mrsort.weights-profiles-breed.target-accuracy 1.0\n",
       "kind: ncs-classification-model\n",
       "format_version: 1\n",
       "accepted_values:\n",

diff --git a/docs/.buildinfo b/docs/.buildinfo
@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: 4476aa03e136408afc0dddac997daaaa
+config: 8d916e58879a5236c33588991f04ca50
 tags: 645f666f9bcd5a90fca523b33c5a78b7
diff --git a/docs/.doctrees/changelog.doctree b/docs/.doctrees/changelog.doctree
diff --git a/docs/.doctrees/contributor-guide.doctree b/docs/.doctrees/contributor-guide.doctree
diff --git a/docs/.doctrees/environment.pickle b/docs/.doctrees/environment.pickle
diff --git a/docs/.doctrees/get-started.doctree b/docs/.doctrees/get-started.doctree
diff --git a/docs/.doctrees/python-api.doctree b/docs/.doctrees/python-api.doctree
diff --git a/docs/.doctrees/reference.doctree b/docs/.doctrees/reference.doctree
diff --git a/docs/.doctrees/reference/lincs.doctree b/docs/.doctrees/reference/lincs.doctree
diff --git a/docs/.doctrees/roadmap.doctree b/docs/.doctrees/roadmap.doctree
diff --git a/docs/.doctrees/user-guide.doctree b/docs/.doctrees/user-guide.doctree
diff --git a/docs/README.html b/docs/README.html
@@ -5,11 +5,11 @@
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />
 
-    <title>Contributors &#8212; lincs 1.1.0 documentation</title>
+    <title>Contributors &#8212; lincs 2.0.0a0 documentation</title>
     <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=4f649999" />
     <link rel="stylesheet" type="text/css" href="_static/alabaster.css?v=039e1c02" />
     <link rel="stylesheet" type="text/css" href="_static/graphviz.css?v=eafc0fe6" />
-    <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js?v=def9ab29"></script>
+    <script data-url_root="./" id="documentation_options" src="_static/documentation_options.js?v=6727bded"></script>
     <script src="_static/doctools.js?v=888ff710"></script>
     <script src="_static/sphinx_highlight.js?v=4825356b"></script>
     <link rel="index" title="Index" href="genindex.html" />

diff --git a/docs/_downloads/019271a03d05a599bcfb6d68c868c86a/python-api.ipynb b/docs/_downloads/019271a03d05a599bcfb6d68c868c86a/python-api.ipynb
diff --git a/docs/_downloads/88ec4004d09b5e85c9e1ff9b908b40ad/problem-schema.yml b/docs/_downloads/88ec4004d09b5e85c9e1ff9b908b40ad/problem-schema.yml
@@ -18,7 +18,6 @@ properties:
             name:
               type: string
             value_type:
-              description: May be extended in the future to handle criteria with integer values, or explicitly enumerated values.
               type: string
               enum: [real, integer]
             preference_direction:

diff --git a/docs/_images/alternatives.png b/docs/_images/alternatives.png
diff --git a/docs/_images/concept-example-model.png b/docs/_images/concept-example-model.png
diff --git a/docs/_images/model-1.1.png b/docs/_images/model-1.1.png
diff --git a/docs/_images/model.png b/docs/_images/model.png
diff --git a/docs/_images/python-api_15_0.png b/docs/_images/python-api_15_0.png
diff --git a/docs/_images/python-api_23_0.png b/docs/_images/python-api_23_0.png
diff --git a/docs/_images/python-api_89_0.png b/docs/_images/python-api_89_0.png
diff --git a/docs/_images/python-api_91_0.png b/docs/_images/python-api_91_0.png
diff --git a/docs/_images/python-api_93_0.png b/docs/_images/python-api_93_0.png
diff --git a/docs/_images/python-api_95_0.png b/docs/_images/python-api_95_0.png
diff --git a/docs/_images/python-api_97_0.png b/docs/_images/python-api_97_0.png
diff --git a/docs/_sources/changelog.rst.txt b/docs/_sources/changelog.rst.txt
@@ -4,6 +4,12 @@
 Changelog
 =========
 
+Version 2.0.0a0 (2024-05-23)
+============================
+
+- **Breaking** Let some thresholds be unreachable! (Fix bug found in real-life ASA data)
+- Support Python 3.12
+
 Version 1.1.0 (2024-02-08)
 ==========================