CMPL <Coliop|Coin> Mathematical Programming Language Version 1.8.0 June 2013 Manual M. Steglich, T. Schleiff CMPL v.1.8.0 - Manual 1 Table of contents 1 About CMPL .......................................................................................................................................5 2 CMPL elements.................................................................................................................................... 5 2.1 General structure of a CMPL model................................................................................................5 2.2 Keywords and other syntactic elements......................................................................................... 7 2.3 Objects........................................................................................................................................8 2.3.1 Parameters...........................................................................................................................8 2.3.2 Variables............................................................................................................................ 10 2.3.3 Indices and sets..................................................................................................................11 2.3.4 Line names.........................................................................................................................13 2.4 CMPL header..............................................................................................................................15 3 Parameter Expressions....................................................................................................................... 18 3.1 Overview................................................................................................................................... 18 3.2 Array functions ..........................................................................................................................18 3.3 Set operations and functions ..................................................................................................... 19 3.4 Mathematical functions............................................................................................................... 21 3.5 Type casts..................................................................................................................................23 3.6 String operations........................................................................................................................ 24 4 Input and output operations .............................................................................................................. 25 4.1 Error and user messages.............................................................................................................26 4.2 cmplData files............................................................................................................................ 26 4.3 Readcsv and readstdin................................................................................................................30 4.4 Include ..................................................................................................................................... 31 5 Statements ....................................................................................................................................... 32 5.1 parameters and variables section.................................................................................................32 5.2 objectives and constraints section ...............................................................................................32 6 Control structure................................................................................................................................33 6.1 Overview................................................................................................................................... 33 6.2 Control header........................................................................................................................... 34 6.2.1 Iteration headers................................................................................................................ 34 6.2.2 Condition headers............................................................................................................... 35 6.2.3 Local assignments ..............................................................................................................35 6.3 Alternative bodies ......................................................................................................................36 6.4 Control statements..................................................................................................................... 37 6.5 Specific control structures........................................................................................................... 38 6.5.1 For loop..............................................................................................................................38 6.5.2 If-then clause..................................................................................................................... 39 6.5.3 Switch clause......................................................................................................................40 6.5.4 While loop.......................................................................................................................... 40 6.6 Set and sum control structure as expression................................................................................ 41 7 Matrix-Vector notations.......................................................................................................................42 8 Automatic model reformulations .........................................................................................................45 8.1 Overview................................................................................................................................... 45 CMPL v.1.8.0 - Manual 2 8.2 Matrix reductions........................................................................................................................45 8.3 Equivalent transformations of Variable Products ...........................................................................46 8.3.1 Variable Products with at least one binary variable................................................................ 46 8.3.2 Variable Product with at least one integer variable................................................................ 47 9 CMPL as command line tool ............................................................................................................... 48 9.1 Usage ....................................................................................................................................... 48 9.2 Syntax checks............................................................................................................................ 50 9.3 Input and output file formats...................................................................................................... 51 9.3.1 Overview............................................................................................................................51 9.3.2 CMPL................................................................................................................................. 52 9.3.3 MPS................................................................................................................................... 53 9.3.4 Free - MPS..........................................................................................................................53 9.3.5 OSiL...................................................................................................................................54 9.3.6 OSoL..................................................................................................................................55 9.3.7 OSrL...................................................................................................................................56 9.3.8 GLPK plain text (result) format.............................................................................................58 9.3.9 CPLEX solution file format ...................................................................................................58 9.3.10 SCIP solution file format ................................................................................................... 59 9.3.11 CmplSolutions................................................................................................................... 59 9.3.12 CmplMessages.................................................................................................................. 60 9.4 Using CMPL with several solvers.................................................................................................. 62 9.4.1 COIN-OR OSSolverService................................................................................................... 62 9.4.2 GLPK..................................................................................................................................63 9.4.3 Gurobi................................................................................................................................64 9.4.4 SCIP...................................................................................................................................65