AIMMS Tutorial for Beginners

1 AIMMSA One-Hour Tutorialfor BeginnersSeptember 2017 AIMMSC opyrightc 1993 2017 by AIMMS All rights 29-352033 AP HaarlemThe NetherlandsTel.: +31 23 5511512 AIMMS SE 8th StreetSuite 303 Bellevue, WA 98005 USATel.: +1 425 458 4024 AIMMS Pte. Market Street #10-00 Singapore 048941 Tel.: +65 6521 2827 AIMMSS hanghai Representative OfficeMiddle Huaihai Road 333 Shuion Plaza, Room 1206 ShanghaiChinaTel.: +86 21 51160733 Email: xx xxxxxx x xAimmsis a registered trademark of AIMMS ILOG CPLEXandCPLEXis a registered trademark ofIBM a registered trademark of Gurobi Optimization, a registeredtrademark of registered trademarks of Microsoft Corporation. TEX, LATEX,andAMS-LATEX are trademarks of the American Mathematical a registered trademark ofBigelow & Holmes a registered trademark of Adobe Systems Inc.

2 Other brandsand theirproducts are trademarks of their respective in this document is subject to change without notice and does not represent a commitment onthe part of AIMMS The software described in this document is furnished under a license agreement andmay only be used and copied in accordance with the terms of theagreement. The documentation may not,in whole or in part, be copied, photocopied, reproduced, translated, or reduced to any electronic mediumor machine-readable form without prior consent, in writing, from AIMMS makes no representation or warranty with respectto the adequacy of this documentation orthe programs which it describes for any particular purpose or with respect to its adequacy to produceany particular result. In no event shall AIMMS , its employees, its contractors or the authors of thisdocumentation be liable for special, direct, indirect or consequential damages, losses, costs, charges,claims, demands, or claims for lost profits, fees or expensesof any nature or addition to the foregoing, users should recognize that all complex software systems and their docu-mentation contain errors and omissions.

3 The authors, and its employees, and its contractorsshall not be responsible under any circumstances for providing information or corrections to errorsand omissions discovered at any time in this book or the software it describes, whether or not theyare aware of the errors or omissions. The authors, AIMMS its employees, and its contractorsdo not recommend the use of the software described in this book for applications in which errors oromissions could threaten life, injury or significant documentation was typeset by AIMMS using LATEX and theLucidafont Keysiv1 Introduction12 What to Scope of one-hour Tutorial .. Problem description and model statement.. A preview of your output.. 63 Building the Starting a new project .. The Model Explorer.. Entering sets and indices.

4 Entering parameters and variables.. Entering constraints and the mathematical program.. Viewing the identifiers.. 154 Entering and Saving the Entering set data.. Entering parameter data.. Saving your data.. 235 Solving the Computing the solution.. 266 Building a Creating a new page.. Presenting the input data.. Presenting the output data.. Finishing the page.. 337 Performing a What-If Modifying input data.. 38 CommonAimmsShortcut Keys40 CommonAimmsShortcut KeysKeyFunctionF1 OpenAimmsHelpF2 Rename the selected identifierF3 Find and repeat findF4 Switch between edit mode and end-user mode(for the active page)F5 Compile allF6 RunMainExecutionAlt+F6 Switch to debugger modeF7 Save the active pageF8 Open Model ExplorerCtrl+F8 Open Identifer SelectorF9 Open Page ManagerAlt+F9 Open Template ManagerCtrl+F9 Open Menu BuilderF11 Open Identifer Info dialogCtrl+BInsert a break point in debugger modeCtrl+DOpen Data PageCtrl+FOpen Find dialogCtrl+MOpen Message WindowCtrl+POpen Progress WindowCtrl+TView Text Representation of selected part(s)

5 Ctrl+Shift+TView Text Representation of whole modelCtrl+WOpen WizardCtrl+SpaceName completionCtrl+Shift+SpaceName completion includingAimmsPredeclaredIdentifersCtrl+ EnterCheck, commit, and closeInsertInsert a node (when single insert choice) orOpen Select Node Type dialog (when multipleinsert choices)Chapter 1 IntroductionWays to are several ways in which you can learn theAimmslanguage and get a ba-sic understanding of its underlying development environment. The followingopportunities are immediately available, and are part of theAimmsinstallation. There are twotutorialsonAimmsto provide you with some initial work-ing knowledge of the system and its language. One Tutorial isintendedfor Beginners , while the other is aimed at professional users ofAimms. There is amodel librarywith a variety of examples to illustrate simpleand advanced applications together with particular aspects of both thelanguage and the graphical user interface.

6 There are threereference booksonAimms, which are available in PDF for-mat and in hard copy form. They areThe User s Guideto introduce youtoAimmsand its development environment,The Language Referencetodescribe the modeling language in detail, andOptimization Modelingtoenable you to become familiar with building beginnersAs a beginner into optimization modeling languages, you maynot have muchtime for learning yet another tool in order to finish some project or homeworkrequirements. In this case, concentrate your efforts on thistutorial. After com-pleting this Tutorial , you should be able to use the system tobuild your ownsimple models, and to enter your own small data sets for subsequent book onOptimization Modelingmay teach you some useful tricks, and willshow you different (mostly non-trivial) examples of optimization forprofessionalsAs a professional in the field of optimization modeling you are looking for atool that simplifies your work and minimizes the time needed for model con-struction and model maintenance.

7 In this situation, you cannot get around thefact that you will need to initially make a substantial time investment to get toknow several of the advanced features that will subsequently support you inyour role as a professional application builder. Dependingon your skills, expe-rience, and learning habits you should determine your own individual learningpath. Along this path you are advised to work through the extensive tutorialespecially designed for professionals. This Tutorial for professionals providesa good start, and should create excitement about the possibilities examples in the library, plus selected portionsof the three books,Chapter 1. Introduction2will subsequently offer you additional ideas on how to useAimmseffectivelywhile building your own advanced aredifferent inscopeThe one-hour Tutorial for Beginners is designed as the bare minimum neededto build simple models using theAimmsModel Explorer.

8 Data values are en-tered by hand using data pages, and the student can build a page with objectsto view and modify the data. The extensive Tutorial for professionals is an elab-orate tour ofAimmscovering a range of advanced language features plus anintroduction to all the building tools. Especially of interest will be the modelingof time using the concepts of horizon and calendar, the use ofquantities andunits, the link to a database, the connection to an external DLL, and advancedreporting facilities. Even then, some topics such as efficiency considerations(execution efficiency, matrix manipulation routines) and theAimmsAPI willremain 2 What to ExpectThis chapterIn this chapter you will find a brief overview of the tasks to beperformed, acompact statement of the underlying model to be built, and a glimpse of theoutput you will Scope of one-hour tutorialSummarizingyour workOnce you have read the short problem description and the associated mathe-matical model statement, you will be asked to complete a series of tasks thatmake up this one-hour Tutorial , namely.

9 Create a new project inAimms, enter all identifier declarations, enter the data manually, save your data in a case, build a small procedure, build a single page with header text, a standard table and two bar charts with input data, a composite table and a stacked bar chart with output data, a button to execute the procedure, and a scalar object with the optimal value, perform a what-if Problem description and model statementProblemdescriptionTruckloads of beer are to be shipped from two plants to five customers dur-ing a particular period of time. Both the available supply ateach plant andthe required demand by each customer (measured in terms of truckloads) areknown. The cost associated with moving one truck load from a plant to acustomer is also provided. The objective is to make a least-cost plan for mov-ing the beer such that the demand is met and shipments do not exceed theavailable supply from each 2.

10 What to Expect4 Data overviewThe following table provides the data for the problem described in the Transport CostPlantsAmsterdam Breda Gouda Amersfoort Den BoschSupplyHaarlem131405 18839648547 Eindhoven554351 47936615563 Demand2816223112 Table : Input data for beer transport problemIdentifierdeclarationsThe following declarations list the identifiers that are part of the mathematicalprogram to be :pplantsccustomersParameters:Spsupply at plantpDcdemand by customercUpcunit transport cost fromptocVariables:xpctransport fromptocztotal transport costModel summaryThe mathematical model summary below captures the least-cost plan to trans-port beer such that the demand is met and shipments do not exceed :z= pcUpcxpcSubject to: cxpc Sp p pxpc Dc cxpc 0 (p,c)Chapter 2. What to Expect5 AmsterdamHaarlemGoudaAmersfoortBredaDen BoschEindhovenFigure : The NetherlandsUsing explicitnamesEven though the above notation with one-letter symbols is typical of smallmathematical optimization models, it will not be used to represent the modelinAimms.