Simulation plugins: EPP

Event Processing Plugin (EPP) Event Processing Plugin (EPP): A plugin that uses calculations done in the core of SEAMCAT and that processes them to produce alternative results In contrast with the functional plugins, simulation plugins do not compute one value but rather collect as many result values as the plugin specifies. It runs after a snapshot and inspects the values produced. In other words, it runs adjacent to the simulation.

Event Processing Plugin (EPP) Value definitions Using Factory.results() a value is defined and collected. Collector.add(…) is used to capture the value All types that are possible to collect and how they are collected is shown in the following table.

Event Processing Plugin (EPP) Value definitions Type Definition Collection Vector Factory.results().value(“vectorName”, “unit”); collector.add(def, 3.2); Integer Factory.results().single(“intName”,”unit”); collector.add(def, 22); Long Factory.results().single(“longName”,”unit”); collector.add(def, 23419231323991L); Double Factory.results().single(“doubleName”,”unit”); collector.add(def, 2.3); String Factory.results().single(“stringName”,”unit”); collector.add(def, “value”); Bar chart Factory.results().multi(“barName”,”x-axis”,”y-axis”); collector.add(def, new BarChartValue(“name”, 3.4)); Scatter Factory.results().multi(“scatterName”,”x-axis”,”y-axis”); collector.add(def, new Point2D(1.3, 2.5)); Function Factory.results().function(“functionName”,”x-axis”,”y-axis”); Function fun = Factory.functionFactory() .constantFunction(2.3);   collector.add(def, fun);

Event Processing Plugin (EPP) Value definitions Running all of the above code snippets in an EPP produces the following output in the SEAMCAT results tab:

EPP Exercise Sample Event Processing Plugin: In this exercise we will implement a simple Event Processing Plugin and see how it works inside SEAMCAT. To start the exercise you need to access the file SampleEPP.java (under the src folder) in IntelliJ.

EPP Exercise Unzip the file Exercise2_EPP.zip and import it as a project into intelliJ. Set it up as described in the Computer Setup presentation Open the SampleEPP.java file:

EPP: Implement the class SampleEPP.java Fill out the code following the comments in Step 1 to 2:

As described in the Computer setup presentation: EPP: Build the .jar file As described in the Computer setup presentation: Build the .jar file : press Build -> Build Artifacts... -> Exercise2.jar -> Build The generated artifact is available under the folder out -> artifacts -> Exercise2_jar

EPP: Install the .jar file in SEAMCAT Open the new EPP from the Event Processing Plugin library in SEAMCAT. The plugin named Sample EPP should appear:

Add this EPP to the scenario EPP: Run the plugin Add this EPP to the scenario

Running the scenario will give the following results EPP: Run the plugin Running the scenario will give the following results Double clicking will show the rx points collected:

Running the scenario will give the following results EPP: Run the plugin Running the scenario will give the following results Double clicking will show the rx points collected. There are 10 collected points from each snapshot and they appear in random order

EPP: Run the plugin Turning the simulation events up to 1000 the picture shows a circle shape more clearly:

EPP: Run the plugin Change the victim system to OFDMA UpLink Configure it with the following layout:

EPP: Run the plugin Run the simulation with 10 events. You will obtain the following layout. The squares correspond to the receiver positions (base stations). In contrast to the generic system, here the positions are fixed so each event will capture 19 Rx positions.

EPP: SOLUTION

Questions?