MATSim - Laptörténet

Mate: /* A MATSim elindítása */

2017-05-25T09:43:24Z

‎A MATSim elindítása

Horvathakos, 2017. május 11., 18:43-n

2017-05-11T18:43:12Z

Horvathakos, 2017. május 11., 14:37-n

2017-05-11T14:37:06Z

Horvathakos, 2017. május 11., 13:09-n

2017-05-11T13:09:23Z

Horvathakos, 2017. május 11., 11:34-n

2017-05-11T11:34:28Z

Horvathakos, 2017. május 11., 09:03-n

2017-05-11T09:03:26Z

Horvathakos, 2017. május 6., 14:57-n

2017-05-06T14:57:28Z

Horvathakos, 2017. május 6., 14:40-n

2017-05-06T14:40:25Z

Horvathakos, 2017. április 22., 14:52-n

2017-04-22T14:52:31Z

Horvathakos, 2017. április 22., 14:47-n

2017-04-22T14:47:13Z

@@ 49. sor: / 49. sor: @@
 A szoftver automatikusan felismeri a gépünkön futó Java verzióját és könyvtárát. Amennyiben ez nem történt meg, tallózzuk be a könyvtárat, ahol a JRE könyvtárunkat. A MATSim futtatásához legalább 7-es verziójú Java szükséges.
-A MATSim futtatásához be kell tallózzunk egy konfigurációs filet, minden beállítható paraméterünket ez fogja tartalmazni. A letöltött csomag több példakonfigurációt is tartalmaz, ezeket megtaláljuk az ''example'' mappában. Amennyiben a programunk elindítás után hibát dob, abban az esetben nyissuk meg a konfigurációs fájlt és az abban megadott ''network'' és ''plans'' modulok elérhetőségi útját módosítanunk kell, a megadott elérési út elé illesszük be, hogy "../../". Tehát például ha a megadott elérési út "examples/equil/network.xml", akkor ezt módosítsuk "../../examples/equil/network.xml"-re. Ennek az az oka, hogy a szotfver valamiért a Java könyvtárunkhoz képest próbálja megtalálni a konfigurációs file-ban hivatkozott egyéb fileokat, nem pedig a konfigurációs filehoz képest.
+A MATSim futtatásához be kell tallózzunk egy konfigurációs filet, minden beállítható paraméterünket ez fogja tartalmazni. A letöltött csomag több példakonfigurációt is tartalmaz, ezeket megtaláljuk az ''example'' mappában. Amennyiben a programunk elindítás után hibát dob, abban az esetben nyissuk meg a konfigurációs fájlt és az abban megadott ''network'' és ''plans'' modulok elérhetőségi útját módosítanunk kell, a megadott elérési út helyett teljes, abszolút elérési utat adjunk meg. Ennek az az oka, hogy a szotfver alapértelmezetten a Java könyvtárunkhoz képest relatívan értelmezi a konfigurációs file-ban hivatkozott egyéb elérési útvonalakat, nem pedig a konfigurációs filehoz képest.
 A program paramétereit a konfigurációs fájlokban állíthatjuk be.

← Régebbi változat		A lap 2017. május 11., 18:43-kori változata
288. sor:		288. sor:
	</syntaxhighlight>		</syntaxhighlight>

		+
		+	=== A Controler és eseményei ===
		+	A MATSim magja a Controler. Az adatok beolvasása után ez felelős az egész szimuláció kézben tartásáért, természetesen minden részfeladatot almodulok hajtanak végre. Az alábbi ábrán a MATSim Controler-ének sémája látható. A teljes program eseményvezérelt, az alábbi ábrán látható, hogy a Controler milyen eseményeket válthat ki (ezek a <code>ControlerEvent</code>-ek, amiket <code>ControlerListener</code>-ek kezelnek.
		+
		+	[[Fájl:Matsim_controler.jpg]]
		+
		+	A fenti ábra minden pontjához tartozik egy esemény (pl a Startuphoz <code>StartupEvent</code>, a Before Mobsim-hez <code>BeforeMobsimEvent</code>, és így tovább. Ezek mind a <code>ControlEvent</code> leszármazottai. A teljes lista megtalálható a MATSim javadoc-jában, [http://ci.matsim.org:8080/job/MATSim_M2/ws/matsim/target/site/apidocs/org/matsim/core/controler/events/ControlerEvent.html a ControlerEvent osztály] és [http://ci.matsim.org:8080/job/MATSim_M2/ws/matsim/target/site/apidocs/org/matsim/core/controler/listener/ControlerListener.html a ControlerListener interfész] oldalakon.
		+
		+	A Controlerhez hasonlóan működik minden modul a saját eventjeivel és listenerjeivel. A MATSim saját kiterjesztése történhet ezeknek a moduloknak a kiterjesztésével vagy lecserélésével (például egy új pontozási szabály hozzáadásával), de akár a modulok lecserélése nélkül is kiválthatunk érdekes viselkedést.
		+
		+	=== Egy példakiterjesztés modulváltoztatás nélkül ===
		+	Tegyük fel, hogy statisztikákat szeretnénk a balra kanyarodásról. A MATSim [http://ci.matsim.org:8080/job/MATSim_M2/ws/matsim/target/site/apidocs/index.html eseményeit böngészve] láthatjuk, hogy létezik <code>LinkEnterEvent</code> és <code>LinkLeaveEvent</code>. Ezek rendelkeznek információval az eseményt kiváltó járműről, a szóban forgó útszakaszról, és az <code>Event</code> ősosztályból pedig egy időbélyeggel. A <code>Link</code>-ek rendelkeznek kezdő és végponttal, amik rendelkeznek koordinátákkal, így a két event együtteséből ki tudjuk szűrni a balra kanyarodásokat.
		+
		+	Ehhez egy olyan <code>Listener</code>-t kell definiálnunk, ami a fent említett <code>LinkEnterEvent</code>-re és <code>LinkLeaveEvent</code>-re is figyel, és ezek információiból ki tudjuk szűrni a balra kanyarodásokat.
		+
		+	Egy másik megközelítésben definiálhatnánk egy <code>LeftTurnEvent</code>-et, amit bekötnénk a már létező <code>EventHandler</code>-ek valamelyikébe (például a <code>LinkLeaveEventHandler</code>-be).
		+
		+	Ugyan lehet, hogy a balra kanyarodási statisztikáknak nincsen sok értelme, de hasonló megközelítésű számításokat jelenleg is végez a rendszer, nézzünk erre néhány példát: bizonyos statisztikákat, például az átlagos aktivitáshosszt jelenleg is így számolja a rendszer. Az újratervező modul is felhasználhatja az eseményeket: például megfelelő <code>Listener</code>-ek figyelhetik, hogy milyen élek vannak tele egy-egy adott időpillanatban, és az újratervezőmodul ennek megfelelően választhat más útiterveket. A pontozómodul is használ eseményeket, hiszen a pontozáshoz szükséges tudni, hogy egy-egy aktivitás mennyi ideig tartott.
		+
		+	A MATSimhez egy új modul definiálása hatalmas feladatnak tűnhet - egyrészt bonyolult algoritmusokat és architektúrát kell átlátni, másrészt a jelenlegi program dokumentációja erősen hiányos -, ugyanakkor, ahogy a fenti példa mutatja, a MATSim-et kiterjeszthetjük a meglévő modulok lecserélése nélkül is.
		+

	== Alkalmazások ==		== Alkalmazások ==

@@ 175. sor: / 175. sor: @@
 </syntaxhighlight>
-A ''-convert'' utasítás után megadhatjuk a MATSim output file-ját, az input hálózatot, majd a file-t amibe szeretnénk elmenteni a snapshotot (ezt .mvi kiterjesztéssel tehetjük meg), valamint a snapshotok időtartamát másodpercekben. Tehát a fenti példaparancs ötpercenként fog egy snapshotot készíteni a hálózatunkról, és ezt elmenti egy .mvi fájlba, amit aztán megjeleníthetünk, a következő módon:
+A <code>-convert</code> utasítás után megadhatjuk a MATSim output file-ját, az input hálózatot, majd a file-t amibe szeretnénk elmenteni a snapshotot (ezt .mvi kiterjesztéssel tehetjük meg), valamint a snapshotok időtartamát másodpercekben. Tehát a fenti példaparancs ötpercenként fog egy snapshotot készíteni a hálózatunkról, és ezt elmenti egy .mvi fájlba, amit aztán megjeleníthetünk, a következő módon:
 <syntaxhighlight>
 java -cp MATSim.jar;otfvis/otfvis.jar org.matsim.contrib.otfvis.OTFVis output/50.visualization.mvi
@@ 228. sor: / 228. sor: @@
      // Egyéb, konfigurációval kapcsolatos beállítások
      config.controler().setLastIteration(1); // iterációk számának beállítása
-     config.controler().setOverwriteFileSetting( OverwriteFileSetting.deleteDirectoryIfExists ); //a kimeneti fájlok/mappa felülírása, ha már léteznek
+     config.controler().setOverwriteFileSetting(OverwriteFileSetting.deleteDirectoryIfExists); //a kimeneti fájlok/mappa felülírása, ha már léteznek
      // A Scenario szuperkonténer létrehozása
@@ 234. sor: / 234. sor: @@
      // A Controler létrehozása
-     Controler controler = new Controler( scenario ) ;
+     Controler controler = new Controler(scenario);
      // A szimuláció futtatása
      controler.run();
+}
 </syntaxhighlight>

@@ 193. sor: / 193. sor: @@
 == Fejlesztői használat ==
 Ebben azokat az információkat mutatjuk be, amiket szükséges tudnunk ha szeretnénk a saját programunkban használni a MATSim-et. A MATSim könyvtárat letölthetjük a [http://matsim.org/downloads projekt honlapjáról] vagy akár a [https://github.com/matsim-org/matsim/releases projekt github oldaláról is]. Azért javasoljuk az utóbbit, mert itt számos egyéb kiterjesztése is megtalálható, vagy hasznos third party libraryk, mint például a vizualizációhoz használható OFTVis.
 == Alkalmazások ==

← Régebbi változat		A lap 2017. május 11., 11:34-kori változata
192. sor:		192. sor:
	Az implementációról szóló részben mutatunk példát arra, hogy hogyan futtathatjuk a saját programunkból az OFTVis-t, és hogyan fog kinézni a végeredmény.		Az implementációról szóló részben mutatunk példát arra, hogy hogyan futtathatjuk a saját programunkból az OFTVis-t, és hogyan fog kinézni a végeredmény.

		+	== Fejlesztői használat ==
		+	Ebben azokat az információkat mutatjuk be, amiket szükséges tudnunk ha szeretnénk a saját programunkban használni a MATSim-et. A MATSim könyvtárat letölthetjük a [http://matsim.org/downloads projekt honlapjáról] vagy akár a [https://github.com/matsim-org/matsim/releases projekt github oldaláról is]. Azért javasoljuk az utóbbit, mert itt számos egyéb kiterjesztése is megtalálható, vagy hasznos third party libraryk, mint például a vizualizációhoz használható OFTVis.

	== Alkalmazások ==		== Alkalmazások ==

← Régebbi változat		A lap 2017. május 6., 14:57-kori változata
177. sor:		177. sor:

	[https://vimeo.com/166501600 A szimulációból készült videót itt lehet megtekinteni.]		[https://vimeo.com/166501600 A szimulációból készült videót itt lehet megtekinteni.]
		+
		+	=== Európa légiforgalma ===
		+	A VSP, TU Berlin által készített szimuláció az OAG Aviation repülési adataira épül, és jó példája annak, hogy a MATSim-et nem csak úthálózatok szimulálására lehet használni. A modell a MATSim egy átalakított verzióját használja, amiben lehetőség van a csomópontok (ezesetben repterek) számára korlátokat szabni (például kifutópályák száma).
		+
		+	A szimulációban jól megfigyelhető, hogy a sok reptéren tiltott éjszakai repülési időszak végeztével (körülbelül hajnali 5 óra) milyen drasztikus mértékben megemelkedik a légiforgalom.
		+
		+	[https://vimeo.com/54271303 A szimulációból készült videót itt lehet megtekinteni.]

← Régebbi változat		A lap 2017. május 6., 14:40-kori változata
156. sor:		156. sor:
	</population>		</population>
	</syntaxhighlight>		</syntaxhighlight>
		+
		+	== Alkalmazások ==
		+	Ebben a részben néhány konkrét példát nézünk, ahol a való életben alkalmazták a MATSimet.
		+
		+	=== Németország ===
		+	Az alábbi videóban látható példa egy ötszázezer fős részmintán elvégzett szimuláció eredménye. A teljes szimulációban négymillió résztvevő jármű volt. A résztvevők adatait egy 2008-as közlekedési felmérésből extrapolálták. A hálózat mintegy 360.000. élből és négymillió aktivitás-helyszínből áll, melyek az openstreetmap.org-ról származnak.
		+
		+	A szimulációban a résztvevők teljes napi tervei szerepelnek, az aktivitásokat pedig otthon, munka, oktatás, vásárlás, kikapcsolódás és egyéb kategóriákba sorolták: a videóban egy-egy felvillanó pont egy aktivitás elkezdését jelenti, utána pedig a résztvevő színe jelzi az éppen aktuális aktivitás típusát.
		+
		+	[https://vimeo.com/124704874 A szimulációból készült videót itt lehet megtekinteni.]
		+
		+	=== Vorarlberg, Ausztria ===
		+	Az Austrian Institute of Technology 2015-ben fejlesztett ki egy MATSim modellt az ország legnyugatibb tartománya, Vorarlberg számára.
		+
		+	A tartomány hálózatát OpenStreetMap-ből származtatták, a populációt pedig egy 2013-as mobilitási felmérés alapján készítették.
		+
		+	A tartománynak 380.000. lakója van, és a modell mindnyájukat szimulálja, de nem vesz figyelembe ünnepi forgalmat illetve más tartományokból érkezők által okozott forgalmat.
		+
		+	A modell alapján három különböző lehetséges közlekedésfejlesztési tervet és azok hatásait kutatták: a tömegközlekedés fejlesztését, városfejlesztést és elektromos töltőállomások elhelyezését.
		+
		+	[https://vimeo.com/166501600 A szimulációból készült videót itt lehet megtekinteni.]

← Régebbi változat		A lap 2017. április 22., 14:52-kori változata
138. sor:		138. sor:
	* Az aktivitások helyszínéhez elgendő csak a koordinátáit megadni (tehát a ''link'' attribútum elhagyható)		* Az aktivitások helyszínéhez elgendő csak a koordinátáit megadni (tehát a ''link'' attribútum elhagyható)
	* A ''leg''eknek elegendő módot megadni, utat nem szükséges (azaz a ''route'' attribútum elhagyható)		* A ''leg''eknek elegendő módot megadni, utat nem szükséges (azaz a ''route'' attribútum elhagyható)
		+
		+	Egy példa minimális adatokkal:
		+	<syntaxhighlight lang="xml">
		+	<population>
		+	<person id="1">
		+	<plan>
		+	<act type="home" x="5.0" y="8.0" end_time="08:00:00" />
		+	<leg mode="car" />
		+	<act type="work" x="1500.0" y="890.0" end_time="17:30:00" />
		+	<leg mode="car" />
		+	<act type="home" x="5.0" y="8.0" />
		+	</plan>
		+	</person>
		+	<person id="2">
		+	...
		+	</person>
		+	</population>
		+	</syntaxhighlight>

← Régebbi változat		A lap 2017. április 22., 14:47-kori változata
132. sor:		132. sor:
	Egy résztvevő egyből elkezdi a következő leget, amint az előző (leg vagy activity) befejeződött. Amennyiben a mobsim olyan ''mode''-ba ütközik, amit nem ismer, úgy a teleportálás utazási módot választja: ebben az esetben a kezdeti pontról eltűnik a résztvevő és a célponton felbukkan a várható utazási idő elteltével.		Egy résztvevő egyből elkezdi a következő leget, amint az előző (leg vagy activity) befejeződött. Amennyiben a mobsim olyan ''mode''-ba ütközik, amit nem ismer, úgy a teleportálás utazási módot választja: ebben az esetben a kezdeti pontról eltűnik a résztvevő és a célponton felbukkan a várható utazási idő elteltével.

−	=== Minimális populációs ~~file~~ ===	+	==== Minimális populációs adatok ====
		+	A populáció konfigurálása első pillantásra könnyen tűnhet túlságosan soknak, de az adatok között számos olyan van, amely opcionális. Adott esetben nehezen követhető, hogy mit kötelező és mit nem kötelező megadni, ezért álljon itt egy lista a könnyítő faktorokról:
		+	* Egy emberhez elég egyetlen tervet megadni
		+	* A terveket nem kell kiválasztani, se pontozni, vagyis mind a ''selected'', mint a ''score'' attribútum elhagyható
		+	* Az aktivitások helyszínéhez elgendő csak a koordinátáit megadni (tehát a ''link'' attribútum elhagyható)
		+	* A ''leg''eknek elegendő módot megadni, utat nem szükséges (azaz a ''route'' attribútum elhagyható)