1

InstallationinstructionsforMARSANIMAP

Filename:InstallationinstructionsforMARS_v0.doc

Date:Thursday,December13,2007

Author:GuenterEmberger,InstitutforTransportPlanningandTrafficEngineering,ViennaUniversityofTechnology

TableofContents

1 Systemrequirements......................................................................................................................2

2 Installationsteps.............................................................................................................................2

3 HowtouseMARSAniMap...........................................................................................................2

3.1 WhatisMARS..........................................................................................................................2

3.2 UsingMARSFS........................................................................................................................3

3.3 Readthehelptext...................................................................................................................4

3.4 ReviewModelstructure..........................................................................................................4

3.5 Simulatethemodel.................................................................................................................6

4 AniMap..........................................................................................................................................10

2

1 Systemrequirements1) NormalstandardPC2) OperatingSystemWindowsNT,XPorhigher3) Optional2screens

ToruntheMARSAniMapSWfollowingSWcomponentshavetobeinstalledonthePC

1) VENSIMModelreaderSW2) MicrosoftExplorer3) SVGsoftware(VectorGraphicaddinforMicrosoftExplorer

AllthesecomponentsarefreedownloadablefromtheInternetorfromourHomepage(www.ivv.tuwien.ac.at).

2 Installationsteps1) DownloadofVensimModelReaderlink:http://www.vensim.com/freedownload.html2) InstallationofVensimModelreader3) DownloadofSVGSWlink:http://www.ivv.tuwien.ac.at/uploads/media/SVGView.exe4) InstallationofSVGSW5) DownloadoftheMARSFSzipfilelink:http://128.130.97.5/cms/fileadmin/mediapool

verkehrsplanung/Diverse/Forschung/MARS/Downloads/MARSFSLeedsv7.zip6) Extractionofallfilesinthezipfiletoafolderhereitisimportantthatthefolderstructure

remainsthesameasitisstoredinthezipfile.

3 HowtouseMARSAniMap

3.1 WhatisMARSTheMARSFSapplicationisdesignedtosupportdecisionmakerstoassesscasestudyspecific

transportandlandusestrategies.TheMARSFSisasimpletousepushbuttoninterfacefortheMARS

landusetransportmodel.Theapplicationusesasetofcommandstogiveuserssimplifiedaccessto

themodel.Totheuser,theMARSFSappearsasaseriesofbuttons,menus,orasequenceofscreens

allowinghimorhertouseandanalyzetheMARSmodelinastraightforwardandmeaningfulway.

Decisionmakerscanthemselvestryouttheirpoliciesandseetheconsequencesimmediately.

TonavigatethroughMARSFSyouhavetooperatetheappropriatebuttons,justlikeinanyother

Windowsapplication.

3

3.2 UsingMARSFSStartofthemodelreaderSWintheWindows"Start" "Programs" "VENSIM" "VENSIMModelReader"

IntheModelReaderclickon"File"andselect"open"SelectfileMARSFScitynameversionnumber.vpa"pressenter.

TheVENSIMModelReaderopensthemodel;themodelopensalso2EXCELfileswhichcontaincasestudyspecificdata.Itispossibletolookwhichinputdataaredefinedforthecasestudy.Tosetupthesystemexpect30secondsloadingtime.

Attention:datacanbealteredintheEXCELfilestodefinenewscenarios,itmustbementionedthatthisshouldonlybedonebyexperiencedMARSusers.

Thefollowingscreenappears(LEEDSCasestudy)Introductionscreen.

Figure1:MARSFSintroductionscreen

Bypressinganybuttonthefollowingscreenappears:

4

Figure2:MARSFSmainmenu

Heretheusercanchooseeitherto1) reviewthemodelstructure2) simulatethemodel,or3) readthehelptext

3.3 ReadthehelptextSelfexplaining

3.4 ReviewModelstructureThebuttonReviewModelStructureleadstheusertoasectionofMARSFSwherehecanexplore

themodelinherentcauseeffectrelations.Tobeabletodosotwodifferentwaysareoffered:

a) Viewmode

Themodelissplitupintodifferentviews,whichinturndepictspecificthematicissueswithintheland

usetransportsystem.ToreviewthemodelstructurewiththeMARSFSapplication,youcango

througheverysingleview,andzoominandoutasnecessary.

5

Figure3:MARSFSmodelstructure

b) CausesTreemode

AnotherwaytoreviewtherelationshipsbetweenthemodelvariablesistousetheCausesTree

function.Hereatreetypegraphicalrepresentationiscreatedshowingthecausesofthechosen

modelvariable.Byclickingonavariablename,thecausestreecanbeexpandeduntilthefinalcause

isreached.

6

Figure4:MARSFSCausestreeview

3.5 SimulatethemodelWhenselecting"SimulatetheModel"awindowopenswhereallimplementedpolicyinstrumentsareshown.

ThepolicyinstrumentsarecasestudydependentinFigure5theintheLeedscasestudyavailablepolicyinstrumentsareshownintotalthereare19differentpolicyinstruments.

TherearedifferentpoliciesforeachmodeimplementedwithintheMARSmodelandcanbesimulatedusingtheMARSFSThefollowinglistwillgiveyouanIdeawhatispossibletotestwithinMARS(attentionthelistisnotcomprehensiveandiscasestudydepending):

SlowModes

Ifyouthinkofimplementingpedestrianzonesorbicyclelanes;youcaninputhowmuchofthezonewillbepedestrianized.Thiswillalsolengthenthedistancetoorfromtheparkingplace.

PublicTransport

Decreaseorincreasebusspeeds,busfaresorthebusfrequency.

7

Car

Chargecarsandmotorcyclesiftheyenterthecordon,changetaxesandcostsofacarpurchase,offercarsmoreorlessinfrastructure,whichhasinfluenceonthespeed,changethefeesforcarparkingandchangethepricesforfuel.

Assoonasthedesiredpolicyleversareset,thesimulationofthemodelcanbeinvokedbypressingtheSIMULATEbutton.

Figure5:MARSFSpolicysetupscreen

Thestructuretoinputapolicyinstrumentisalwaysthesameasshownhereforthepolicyinstrument"TeleWork"(leftcolumn).

Ausercandefinethestartvalue(=percentagechange)oftheshareofteleworkersforastartyearbydraggingtheslidertothedesiredvalueorbykeyinginanumericvalueintheboxbelowtheslidertool.Additionalanusercandefineastartyearinwhichthepolicyinstrumentstarttoworkbykeyinginavalueintheboxontherighthandsideoftheslidertool.

Thesamecanbedoneforanendyearinwhichthepolicyinstrumentsstaysconstantfortherestofthesimulationtime.

8

Figure6:MARSFSpolicyinputslidertool

Atypicalpolicyprofilelookslike

Figure7:MARSFSpolicyprofileview

Thisgraphiccanbeobtainedbyclickingonthe"PolicyGraph"Button.Itshowstheteleworkingpolicyprofilewheretillyear5theshareofteleworkersis0,inyearfivethesharegoesupto10%andincreasestilltheendyear20to60%andstaysthenconstantfortherestofthesimulation.

Theusercandefineanycombinationofpolicyinstruments.Afterfinishingthisprocesstheuserhastoclickonthe"SIMULATE"buttonandthesimulationstarts.Inthecasetherunalreadyexists,theuserwillbeaskedeithertooverwritetheexistingrunortocreateanewone.Theusershouldnametheruninthatwaythathelatercanrememberwhichpolicycombinationhehastested.Importantisherethattheusershouldnotoverridethe"DoNothing"runsincethisrunisusedtocomparethenewcreatedrunwiththeDoNothingscenario.

9

Thedurationofthesimulationdependsonthecomputersystemandwillbesomewherearound45seconds.AfterthesimulationisfinishedadialogwindowpopsupandaskstheuserifhewantstocreateanAniMapoutputfile.Byclickingthe"yes"buttonoraftersomesecondstheAniMapinputfilewillbecreatedandstoredintherightsubdirectory(..\AniMapMARS\Leeds\anidata\runname.js).

Afterthesimulationisfinishedtheusercannavigatethroughthedifferentoutputwindowstoexplorethebehaviorofthemodelovertimeregardingthetestedpolicycombination.Severaloutputwindowsareavailable,wherethedevelopmentofdifferentindicatorsovertimeisshown.Allthesegraphsortablescanbecopiedintotheclipboardbyclickingthe"ExporttoClipboard"buttonandcansoimportedinanyotherapplication(suchasWord,Excel,etc).

Sinceitisnotpossibletopreparepredefinedgraphsforallmodelvariablesaspecialtoolis

implementedwithintheMARSFSsoftware.Thistoolallowstheusertoselectanyvariableused

withinthemodelandtodisplaythedevelopmentofthesevariablesovertime,eitherasagraphoras

atable.Thisfeaturealsoenablestheusertodisplayandexportinformationforacertainrangeof

zones,forspecificmodes,orforspecifictrippurposes,etc.

Figure8:MARSFSIndividualoutputscreentool

10

Bypressingthebutton"ReturntoMainMenu"anewsimulationcanbesetup.

4 AniMapAniMapisapieceofsoftwarewhichcanbeusedtoviewmoviesregardingthespatialdevelopmentofcertainindicatorsovertime.

TostartAniMaptheuserhastodoubleclickonthefile"Index.html"whichislocatedinthedirectory..\AniMapMARS\casestudyname,inourcase..\AniMapMARS\Leeds.BydoingthisnormallytheWindowsExplorershouldopenandloadtheAniMapSW.ImportantisherethatthesecuritysettingoftheexplorermustbesetinthatwaythatActiveXcontrolscanbeexecuted.

Bytickingallthecheckboxesbelow"show"ontherighthandmenuthreegraphsofthecasestudyareaaredisplayed.Bypressingthe"step+"buttonitispossibletomoveforwardintimeyearbyyear.Bypressingthe"run+"buttonthedevelopmentovertimefortheselectedvariablesisshownasamovie.Bydoubleclickingonanyzoneinthemapadetailedlistforthisspecificzonecanbeobtained.

Figure9:AniMap3variablesoutputview

11

Byclickingonthe"Load"tabasecondruncanbeloadedintothesystemtocarryoutcomparisons.Inourcasetherunteleworkerwasloadedandacomparisonofthemodelsplitfiguresbetweenthesetworuns(DoNothingversusTeleworker)wascarriedout.

Figure10:AniMapcomparisonmode

Asitcanbeseenatthemoment7differentindicatorscanbecompared(residents,worplacesservicesector,workplacesproductionsector,modalsplitcar,modalsplitpublictransportbus,modalsplitslowandmodalsplitpublictransportra