small change in doc and readMe for solvers

docs/source/installation.rst

@@ -39,7 +39,7 @@ If you only want GBOML as an uninstalled package, installing the requirements ca
 Installing Solvers
 ------------------
 
-GBOML currently interfaces with Gurobi, CPLEX, Xpress, Cbc/Clp and DSP. Only one of these is required to solve a GBOML model. Gurobi, CPLEX and Xpress are commercial solvers, while Cbc/Clp is an open-source solver. DSP is an experimental open-source project relying on Gurobi, CPLEX and SCIP to implement generic structure-exploiting algorithms (e.g., Dantzig-Wolfe, dual and Benders decompositions).
+GBOML currently interfaces with Gurobi, CPLEX, Xpress, Cbc/Clp, HiGHS and DSP. Only one of these is required to solve a GBOML model. Gurobi, CPLEX and Xpress are commercial solvers, while Cbc/Clp is an open-source solver. DSP is an experimental open-source project relying on Gurobi, CPLEX and SCIP to implement generic structure-exploiting algorithms (e.g., Dantzig-Wolfe, dual and Benders decompositions).
 
 Gurobi
 ~~~~~~
@@ -115,9 +115,9 @@ The next installation steps make use of `cmake <https://cmake.org/install/>`_ an
 
 If the make worked properly, an executable called runDsp and a shared library named libDsp should be created in the *src* subfolder of the build directory. Additional information can be found `here <https://github.com/Argonne-National-Laboratory/DSP/blob/master/docs/install.md>`__.
 
-Highs
+HiGHS
 ~~~~~
-To install Highs please download the solver from https://highs.dev/. The Python API is embedded in GBOML.
+To install HiGHS please download the solver from https://highs.dev/. The Python API is embedded in GBOML. However, you need the HiGHS shared object on your library path.
 
 Testing
 -------

src/gboml/solver_api/README.md

+*GBOML: Graph-Based Optimization Modeling Language*
+
+---
+## Contents of files
+The source code of the GBOML Solver is divided in XX parts : 
+- cbc_solver.py contains a new experimental direct interface to CBC via pycbc
+- clp_solver.py contains a CBC/CLP interface from GBOML via CyLP
+- cplex.opt contains an example of parameters file that can be passed to cplex 
+  (in this case those parameters will be used by default)
+- cplex_solver.py contains the GBOML interface to CPLEX
+- dsp_solver.py contains the GBOML interface to DSP via its experimental interface dsppy.py
+- dsppy.py contains the ctypes experimental interface to DSP via its shared object
+- gurobi.opt contains an example of parameters file that can be passed to gurobi 
+  (in this case those parameters will be used by default)
+- gurobi_solver.py contains the GBOML interface to Gurobi
+- highs.opt contains an example of parameters file that can be passed to HiGHS
+  (in this case those parameters will be used by default)
+- highs_solver.py contains the GBOML HiGHS interface via the experimental package pyhighs.py
+- pycbc.py contains the ctypes experimental interface to CBC via its shared object
+- pyhighs.py contains the ctypes experimental interface to HiGHS via its shared object
+- scipy_solver.py contains a basic interface to the scipy solver (it does not support intergers variables)
+- xpress.opt contains an example of parameters file that can be passed to HiGHS
+  (in this case those parameters will be used by default)
+- xpress_solver.py contains the GBOML interface to Xpress via the xpress package
\ No newline at end of file