LINGO13.0 Copyright(c)20052011 LINDOSystems,Inc.312.988.7422 1415NorthDaytonSt.info@lindo.com Chicago,IL60642http://www.lindo.

com

Contents 1.Introduction 2.Installation 2.1WindowsPlatforms 2.2Unix/LinuxPlatforms 3.LicenseFile 4.SampleModels 5.ProgrammingSamples 6.TechnicalSupport 7.ContactInformation 1.Introduction LINGOisatoolforutilizingthepoweroflinear,integerandnonlinear optimizationtoformulatelargeproblemsconcisely,solvethem,and analyzethesolution.Optimizationhelpsyoufindtheanswerthatyields thebestresult;attainsthehighestprofit,output,orhappiness;orthe onethatachievesthelowestcost,waste,ordiscomfort.Oftenthese problemsinvolvemakingthemostefficientuseofyourresourcesincluding money,time,machinery,staff,inventory,andmore.Optimizationproblems areoftenclassifiedaslinearornonlinear,dependingonwhetherthe relationshipsintheproblemarelinearwithrespecttothevariables.

2.Installation ThecurrentreleaseofLINGOhasthefollowingdirectorystructure lingo13/'Installationdirectory lingo13/bin/<PLATFORM>'Executables,dynamiclibraries lingo13/doc'Usermanualanddocumentation lingo13/license/<PLATFORM>'Licensefiles,byplatform lingo13/samples'Samplemodelsdirectory lingo13/programming_samples'ExamplesoncallingLINGOfrom 'C,FORTRAN&Java 2.1WindowsPlatforms:Nospecificinstallationprocedureisrequiredon Windowsplatforms,otherthantorunthesuppliedsetupprogramandfollow theprompts.

2.2.Unix/LinuxPlatforms:Followthestepsbelowtocompletethe installation: Step1.For32bitLinuxplatforms,locatethe: LINGOLINUXIA3213.0.tar.gz fileonyourCD.Alternatively,ifyouarerunninga64bitversionof Linux,thenyoucanchoosetoinstalla64bitversionofLINGOusing: LINGOLINUX64x8613.0.tar.gz Step2.Copythisfileintoaninstallationdirectoryofyourchoice(e.g. $HOME): %>cpLINGOLINUXIA3213.0.tar.gz$HOME Step3.Changetheworkingdirectoryto$HOMEanduncompressthefileusing thegzipdcommandasbelow.ThisoperationcreatesLINGOLINUX IA3213.0.tar(inthecaseof64bitversions,LINGOLINUX64x8613.0.tar willbecreated). %>gzipdLAPILINUXIA3213.0.tar.gz Step4.Uncompressthetarfileusingthetarxvfcommandasbelow.This willcreatetheLINGOdirectorylingo13/. %>tarxvfLINGOLINUXIA3213.0.tar Step5.Gotothelingo13/bin/<PLATFORM>binariesdirectoryandmakesure allthefilesareinexecutablemode.Iftheyarenot,youshouldchange theirmodebytyping %>chmod755* For32bitinstallations,the<PLATFORM>folderwillbelinux32/andfor 64bitinstallationsthefolderwillbelinux64/.

Step6.UpdatetheLD_LIBRARY_PATHenvironmentvariablesothatitalso pointstotheLINGObinariesfolder.Itisassumedthattheinstallation directoryis$HOME/lingo13. %>LD_LIBRARY_PATH=$HOME/lingo13/bin/<PLATFORM>:$LD_LIBRARY_PATH %>exportLD_LIBRARY_PATH Step7.SettheLINGO_13_HOMEenvironmentvariabletopointtothemain LINGOfolder.Forexample,ifyourinstallationdirectoryis $HOME/lingo13,thentheenvironmentvariableshouldbesetas: %>LINGO_13_HOME=$HOME/lingo13 %>exportLINGO_13_HOME Youmayalsoexecutetheshellscriptlingo13/bin/<PLATFORM>/lingovars.sh toperformtherequiredupdatesontheseenvironmentvariables.To executethisscriptmanually,enterthefollowingatcommandline %>source$HOME/lingo13/bin/<PLATFORM>/lingovars.sh Alternatively,toexecutethescriptautomaticallyatlogon,appendthis linetotheendofyourstartupscript(.bashrcor.bash_profileforthe bashshell). Step8.IfyouwereprovidedaLINGOlicensefile(lookforafilecalled lndlng13.lic),thenyoushouldcopythisfileintotheappropriatefolder, e.g.:$HOME/lingo13/license/<PLATFORM>. IfyoudonothaveavalidLINGOlicensefileandyouwishtocreatea demolicense,thengotothelingo13folderandrunthe create_demo_licensescriptasfollows: cd$HOME/lingo13 shcreate_demo_license.sh AdemoversionofLINGOwillrunjustasstandardversionsdo,however, themaximummodelcapacityisrestricted. Step9.YoushouldnowbeabletorunLINGObyentering'lingo13'toa commandprompt.64bitusersshouldenter'lingo64_13'.Ifthe environmentvariablesarenotsetupcorrectly,youwillreceivethe followingerrormessageeverytimeyoustartLINGO. [ErrorCode:171] Licensekeywasnotfoundorisinvalid. Inthiscase,pleaserefertothestepsabovetobesuretherequired environmentvariablesaresetupcorrectlyandthatyouhaverunthe scripttocreateademolicense. NOTE:UnliketheWindowsversionofLINGO,whichhasaGUIfrontend, Unix/Linuxversionsarecommandlineapplications.Allcommandsaretyped intoLINGOscommandlinepromptthatbeginswithacoloncharacter(:). AvailablecommandsarediscussedindetailinChapter6,CommandLine Commands,oftheLINGOUsersManual.

3.LicenseFile Inadefaultinstallation,thelicensefile,lndlng13.lic,islocatedin thelingo13/licensedirectory.Bydefault,thedownloadversionofLINGO availablefromtheLINDOSystemsWebsiteincludesalicenseforademo versionofLINGO.ThedemoversionallowsfullaccesstoLINGOsfeature set,howeverwithalimitedmodelcapacity. IMPORTANT:Ifyoupurchasedalicenseandreceiveditviaemail,you shouldupdatethelicensefileinthelingo13/licensefolderwiththe licensefileyouobtainedfromyoursalesrepresentative.Youshould installthelicensefileunderthenamelndlng13.lic.Ifyoureceiveda distributionCD,yourlicensefilemayhavebeenpreinstalledinthe lingo13/licensedirectory,andnoadditionalstepswillberequired.Your licensekeyisuniquetoyourinstallationandcontainsinformation regardingyourversion'sserialnumber,size,andsupportedoptions. Giventhatyourlicensekeyisuniquetoyourinstallation,youshouldnot shareitwithanyusernotlicensedtouseyourcopyoftheLINGO.

4.SampleModels Thelingo13/samplesdirectorycreatedduringtheinstallationcontains severalmodelexamplesusingLINGOsalgebraicmodelinglanguage.Inthe samplesessionbelow,asmalltransportationmodel,tran.lng,isreadinto LINGOusingtheTAKEcommand(note:usercommandsarelistedinbold italics:

%>lingo13(or'lingo64_13'for64bitversions)
LINGO/LNX3213.0.2.10(13Jul11) LINDOAPI7.0.1.209(Jun2201100:51:10) Copyright(C)200520011LINDOSystemsInc.Licensedmaterial, allrightsreserved.Copyingexceptasauthorizedinlicense agreementisprohibited. Licenselocation:/home/lindo/lingo13/license/linux32/lndlng13.lic Configlocation:/home/lindo/lingo13/LINGO.CNF Licensedforcommercialuse. Branchandboundsolverenabled. Nonlinearsolverenabled. Barriersolverenabled. Globalsolverenabled. Integersolverenabled. Stochasticsolverenabled. :take../../samples/tran.lng

:go Compilingmodel... Structuralanalysis,pass1... Scalarizingmodel... Generatingnonzeromatrix... Solving... ItersStatusObjectiveSuminf 0UNKNOWN0.000.00 6OPTIMAL161.0.00 Globaloptimalsolutionfound. Objectivevalue:161.0000 Infeasibilities:0.000000 Totalsolveriterations:6 :quit

5.ProgrammingSamples InadditiontousingLINGOinteractivelytosolveyourmodels,youmay alsocallLINGOfromwithinyourownprogrammingapplications.The lingo13/programming_samplesdirectorycontainsexampleswritteninC, FORTRANandJava.Makefilesarealsoincludedtoillustratehowtobuild yourapplicationsandlinkthemwiththeLINGOsharedobjectlibraries. IfyouwishtocalltheLINGOlibrariesfromapplicationsthatyoubuild, youwillneedtoestablishsomesymboliclinksintheLINGObinfolder. Youmaydothisbygoingtothelingo13/bin/<PLATFORM>folderforyour installationandrunthesymlinks.shscript.

6.TechnicalSupport Ifyourequiretechnicalsupport,contactLINDOSystemswiththefollowing information 1)TheserialandversionnumbersofLINGOyouarerunning.Theversion numberisprintedontheconsolescreenrightafterLINGOisstarted. 2)Thestepstoreproducetheproblemthatyouhaveencounteredalongwith thecopiesofrequiredinput/parameterfiles. 3)Theoperatingsystemandversion.

7.ContactInformation Youcancontactusviaemailusingthefollowingaddresses: GeneralInformationandQuestions: webinfo@lindo.com Salesandordering: sales@lindo.com TechnicalSupport: tech@lindo.com Or,byphonebyusingthefollowingnumbers: MainNumbers: (800)441BEST(2378)or(312)9887422 TechnicalSupport: (312)9889421 Fax: (312)9889065 Or,bymailviathefollowingaddress: LINDOSystemsInc 1415NorthDaytonStreet Chicago,IL60642 USA