Graph-Based ILP Problem Specification Tool
Go to file
Maximilian Kratz 13e882471a
Merge pull request #144 from Echtzeitsysteme/hotfix/reset_validationLog
Fixed the validation log issue
2024-04-19 13:05:50 +02:00
org.emoflon.gips.build Merge remote-tracking branch 'origin/master' into hotfix/mapping_feature_values 2024-04-12 14:58:32 +02:00
org.emoflon.gips.core + Fixed the validation log issue, by resetting the validation log before each Problem is built. 2024-04-19 13:00:49 +02:00
org.emoflon.gips.core.dependencies Updates Gurobi dependency to v11.0.1 2024-03-13 10:01:00 +01:00
org.emoflon.gips.feature Fixes package/plug-in vendor information 2022-07-28 10:23:38 +02:00
org.emoflon.gips.gipsl Enforces the Eclipse code style + organize imports on all projects 2024-04-12 15:32:39 +02:00
org.emoflon.gips.gipsl.ide Fixes missing export of bin files 2022-07-28 11:42:36 +02:00
org.emoflon.gips.gipsl.ui Enforces the Eclipse code style + organize imports on all projects 2024-04-12 15:32:39 +02:00
org.emoflon.gips.intermediate Fixes broken dependencies 2023-12-05 14:13:58 +01:00
org.emoflon.gips.updatesite Fixes copy paste error on update site project: index.html 2022-11-15 10:04:21 +01:00
.gitignore Adds .gitkeep for missing xtend-gen folders 2022-01-12 13:19:15 +01:00
CITATION.cff Adapts: CITATION, README, and PSF to new name 2022-05-03 12:41:04 +02:00
LICENSE Adds first version of README, LICENSE, CITATION 2022-03-15 17:29:29 +01:00
README.md Updates Gurobi dependency to v11.0.1 2024-03-13 10:01:00 +01:00
devProjectSet.psf Change git protocol from SSH to HTTPS in PSF file 2023-03-27 13:18:18 +02:00

README.md

GIPS

GIPS is an open-source framework for Graph-Based ILP Problem Specification.

Installation (development)

  • Install AdoptOpenJDK 17 (HotSpot JVM) or newer.
  • Install eMoflon::IBeX as described here.
  • Install at least one of the supported ILP solvers:
    • Install Gurobi in version 11.0.1 and activate a license for your computer.
      • Currently, Gurobi is the default ILP solver used in GIPS because of the great performance.
    • Install GLPK in the newest version (4.6.5) and add it to your path.
      • GLPK is an open-source ILP solver that can be used without a charge.
    • Install CPLEX in version 22.1.1 and activate a license for your computer (if neccessary).
      • CPLEX is a commercial alternative to the other ILP solvers implemented in GIPS.
  • Clone this Git repository to your local machine and import it into Eclipse: File -> Import -> General -> Existing Projects into Workspace. Import all projects.
    • As an alternative, you can use this PSF file for the import.
  • Inside the Eclipse development workspace ...
    • ... Run Run all GIPS MWE2 files.launch from org.emoflon.gips.core/launch with right click Run As -> Build all GIPS MWE2 files.
    • ... build all projects (Project -> Clean... -> Clean all projects) to trigger code generation.
  • Launch a runtime workspace (while using a runtime Eclipse) as stated in the eMoflon::IBeX installation steps to start using GIPS.

A good start point to verify your installation is to run some of the GIPS examples or the GIPS tests.

Code-Style

This project uses the built-in code-style and code-formatter of Eclipse. Before contributing, please set-up your Eclipse code-style settings as follows:

  • Window -> Preferences -> Java
    • -> Code Style -> Clean Up -> Active profile: -> "Eclipse [built-in]" (default)
    • -> Code Style -> Formatter -> Active profile: -> "Eclipse [built-in]" (default)
    • -> Code Style -> _Organize Imports: -> "java, javax, org, com" (default)
    • -> Editor -> _Save Actions:
      • Check "Perform the selected actions on save"
      • Check "Format source code"
      • Check "Format all lines"
      • Check "Organize imports"
      • Check "Additional actions"

By using this settings, you should be unable to commit unformatted code.

Installation (user)

  • Install AdoptOpenJDK 17 (HotSpot JVM) or newer.
  • Install eMoflon::IBeX as described here.
  • Install at least one of the supported ILP solvers:
    • Install Gurobi in version 11.0.1 and activate a license for your computer.
      • Currently, Gurobi is the default ILP solver used in GIPS because of the great performance.
    • Install GLPK in the newest version (4.6.5) and add it to your path.
      • GLPK is an open-source ILP solver that can be used without a charge.
    • Install CPLEX in version 22.1.1 and activate a license for your computer (if neccessary).
      • CPLEX is a commercial alternative to the other ILP solvers implemented in GIPS.
  • Install GIPS from the public Eclipse update site: https://echtzeitsysteme.github.io/gips-updatesite/snapshot/updatesite/
  • Launch a runtime workspace (while using a runtime Eclipse) as stated in the eMoflon::IBeX installation steps to start using GIPS.

Usage (running simulations)

Please refer to the GIPS examples reposiory.

Tests

Please refer to the GIPS tests repository.

License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for more details.