Eloquent

Eclipse Linear Optimization, Query, 'n' Transformation

Eloquent is an Eclipse feature that supports model-driven (language) engineers in specifing and solving constraint-driven allocation problem. Eloquent is useable for any EMF (Eclipse Modeling Framework)-based model. It supports engineers in two ways. First, it provides the ability to specify allocation constraints using the domain-specific Eloquent language, which embeds standard OCL (Object Constraint Language). Second, it provides an automatic transformation to state of are constraint solvers like, LPSolve, SCIP, Gurobi, Neo Server, OPT4J. Thereby, the constraint allocation problems are solved automatically and the solution is provided as an EMF model.

Dependency Update Site for Neon.3:

• http://download.eclipse.org/modeling/mdt/ocl/updates/interim/

Eloquent Update Site:

• https://muml-build.cs.upb.de/job/ELOQUENT-Github/lastSuccessfulBuild/artifact/plugins/org.muml.eloquent.repository/target/repository

Installing the tools for Eloquent

Eloquent is a plug-in for Eclipse Neon.3 and Oxygen. We develop and test it under Eclipse installations for Windows 7, 10 and Linux;

Java

• For installing Eloquent, you need a Java Runtime Environment (JRE) or Java Development Kit (JDK) on your machine. We recommend using the latest version of Java 8 provided by Oracle.

LPSolve

For solving the allocation problem, you need LPSolve, SCIP, GUROBI, or OPT4J on your machine.

• http://sourceforge.net/projects/lpsolve/
• http://scip.zib.de/
• http://www.gurobi.com
• http://opt4j.org/

Alternatively, you can use the online solver https://neos-server.org.

The installed software must be referred within the PATH environment variable.

On Windows machines you need to do the following:

• Go to Control Panel --> System and Security --> System
• Click Advanced system settings
• Click Environment Variables
• In the System Variables area, locate the PATH variable, highlight it and click Edit...
• Make the required changes, e.g., Add "C:\Program Files (x86)\lp_solve", Click OK, OK, OK

You can test if LPSolve is available via typing in the command line (Run "cmd"): "lp_solve -h"

Eloquent Installation

Currently, we support the Eclipse Oxygen and Neon.3 release. Download one of the following releases

• Eclipse Oxygen Modeling Tools [http://www.eclipse.org/downloads/packages/eclipse-modeling-tools/oxygenr] and unzip the contents of the zip-file into a folder of your choice.
• Eclipse Neon Modeling Tools SR3 [http://www.eclipse.org/downloads/packages/eclipse-modeling-tools/neon3] and unzip the contents of the zip-file into a folder of your choice.

1. In Eclipse, choose Help -> Install New Software from the menu. Make sure to enable the option "Contact all update sites during install to find required software".
2. (only for Neon.3 User) click "Add..." and enter the following information in the dialog: Name = OCL, Location = [http://download.eclipse.org/modeling/mdt/ocl/updates/interim/]
3. click "Add..." and enter the following information in the dialog: Name = Eloquent, Location = [https://muml-build.cs.upb.de/job/ELOQUENT-Github/lastSuccessfulBuild/artifact/plugins/org.muml.eloquent.repository/target/repository]
4. After the list of features has been updated, choose at least "MechatronicUML ELOQUENT" from the "ELOQUENT" category.
5. Click "Next" to accept the features to be installed.
6. Click "Next" to accept the license agreements.
7. Click "Finish".