This guide will get you step by step through the process of getting the OptControlCentre and installing it. It is very easy and should only take around 30 min. on a business day assuming you have MATLAB, Maple and a FORTRAN compiler already installed . Additional steps are needed for certain NLP solver components (e.g. Harwell routines).

1. License Agreement

Please read the license carefully. Only proceed if you are willing to comply with the Q Public License version 1. [License]. By using the software, you agree to the terms of the license.

2. System requirements

Please make sure you meet the system requirements. You need MATLAB, Maple and a FORTRAN compiler for the full OptControlCentre version. Please install these programs prior to the OptControlCentre. [Details]

3. Create an account at SourceForge.net

Please go to www.sourceforge.net and register as a new user (https://sourceforge.net/account/register.php). This is a free service. This is obsolete if you already have an account. For details, see OCC on Sourceforge.

4. Subscribe to mailing list

Three mailing lists are currently available. Click on one list to subscribe, post messages and / or browse the archive.

Mailing list for broader public about major events in OCC (low traffic):

• List-name: occ-major_events
• Subscribe/Unsubscribe/Preferences
• occ-major_events Archives

Mailing list intended for OCC users:

• List-name: occ-users
• Subscribe/Unsubscribe/Preferences
• occ-users Archives

Mailing list intended for OCC developers:

• List-name: occ-developers
• Subscribe/Unsubscribe/Preferences
• occ-developers Archives

4. Getting registered as an OCC user / developer

This step is needed for support and keeping up to date with the development. Please e-mail your SourceForge user name to Tobias@Jockenhoevel.com If you haven’t faxed the license agreement, please do so now.

5. Installing and configuring CVS

CVS is the Concurrent Version System. It keeps you always up to date with the OCC development. You can submit your changes easily via CVS. It is already installed on most UNIX systems (type >cvs to test it). For Windows, please install a CVS (Win CVS is strongly recommended). The following instructions are for Windows:

• Make sure you have WinCvs installed on your system.
• Execute the WinCVS client using its icon within the Start Menu.
• Use the Admin->Preferences menu option of WinCVS to access the Preferences dialog. Select the 'General' tab.
• Enter the proper CVS for your user name and project name within the 'Enter the CVSROOT' field, as: username@cvs.sourceforge.net:/cvsroot/occ
• Specify ' “passwd” file on the cvs server' as your authentication method.
• Click on the 'Ok' button. WinCVS is now configured to access your project CVS repository (and you will be able to commit files to this repository).

Downloading the OptControlCentre

You can go ahead to download the OCC package after you have been added to the OptControlCentre users / developers. You will receive an notification e-mail as soon as possible.

1. Start WinCVS
2. In WinCVS > Admin click on “Login” and enter your SourceForge password.
3. In WinCVS > Create > click on “Checkout module”.
4. Enter “occ” as the module name and path on the server.
5. Enter “C:” or any other hard drive as the local folder to checkout to.
6. After clicking “OK” the entire package will be downloaded to this folder in a “occ” subdirectory..

Installing OCC

The OptControlCentre is a set of MATLAB routines and auxiliary files. There’s no need to install the package itself, however some minor changes for system have to be taken into account:

For Windows users only:

1. Go to the GUI sub folder and open the file “system_info.m”.
2. Change the path where your Maple installation is located: e.g. maple_path = 'C:\Program Files\Maple 7\BIN.WNT\';
3. Change on which hard disk you OCC is located, e.g. hard_disk = 'C:\';
4. In occ\ocoma open the makefiles for the solvers you licensed. E.g. occ\ocoma\makefileipopt17_win.txt and change the following two lines according to you local path:
    LIBRARIES_PATH = C:\occ\libraries
   SOLVER_PATH = C:\occ\solver\ipopt17_win\

Attention Windows XP Users:

Matlab 6.1 and lower might not correctly display some Figures. You could run Windows XP in Windows Classic design instead or follow the steps described in this Mathworks support document:

http://www.mathworks.com/support/solutions/data/29388.shtml

UNIX / Linux needs no changes if you install the OCC in you home directory.

Now, it is time to start the OptControlCentre:

1. Start MATLAB
2. Change to the C:\occ folder
3. Type “occ” in the command line.

and the following window will appear:

After accepting the license, OCC will start with the offline menu.

Welcome as a new user !

Getting started

A new User guide for the offline optimization will be added soon in the OptControlCentre section. Example models will be also be added. Sorry for the inconvienience.

Further reading on CVS / Using WinCVS

You may proceed to use CVS for keeping up to date with the development process. We recommend that you review three sets of documentation if this is your first time using CVS.

First, though you are using version 1.2.x of the WinCVS software, the documentation for WinCVS 1.3.x will likely prove quite useful. You may also find benefit in the Online Help provided with the WinCVS application.

Second, the SourceForge.net team has prepared an introduction to SourceForge.net project CVS services, which includes key information about operation of your project CVS repository and the various CVS-related services provided by SourceForge.net. This document should prove to be a good reference should you encounter any difficulties in using project CVS services, or if you want to make the most of CVS.

Finally, the CVS book by Karl Fogel provides an easy-to-understand walkthrough of basic CVS operation. The first chapter of this document should provide enough background information for you to start using project CVS services immediately.

Download the Q Public License as PDF version: