/*
* Datei: TestPlug2.java
* Autor(en): Lukas König
* Java-Version: 6.0
* Erstellt: 23.05.2009
*
* (c) This file and the EAS (Easy Agent Simulation) framework containing it
* is protected by Creative Commons by-nc-sa license. Any altered or
* further developed versions of this file have to meet the agreements
* stated by the license conditions.
*
* In a nutshell
* -------------
* You are free:
* - to Share -- to copy, distribute and transmit the work
* - to Remix -- to adapt the work
*
* Under the following conditions:
* - Attribution -- You must attribute the work in the manner specified by the
* author or licensor (but not in any way that suggests that they endorse
* you or your use of the work).
* - Noncommercial -- You may not use this work for commercial purposes.
* - Share Alike -- If you alter, transform, or build upon this work, you may
* distribute the resulting work only under the same or a similar license to
* this one.
*
* + Detailed license conditions (Germany):
* http://creativecommons.org/licenses/by-nc-sa/3.0/de/
* + Detailed license conditions (unported):
* http://creativecommons.org/licenses/by-nc-sa/3.0/deed.en
*
* This header must be placed in the beginning of any version of this file.
*/
package eas.plugins.standard.other.testPlugins;
import java.util.ArrayList;
import java.util.LinkedList;
import java.util.List;
import eas.plugins.PluginProperties;
import eas.plugins.standard.eaPlugin.StandardPluginForEA;
import eas.simulation.Wink;
import eas.simulation.agent.GenericSensor;
import eas.simulation.event.EASEvent;
import eas.simulation.spatial.sim2D.marbSimulation.EnvironmentEA;
import eas.simulation.spatial.sim2D.marbSimulation.RobEA;
import eas.simulation.spatial.sim2D.marbSimulation.endlAutomat.GenericState;
import eas.startSetup.ParCollection;
import eas.startSetup.SingleParameter;
/**
* @author Lukas König
*/
@PluginProperties(pluginIsHidden = true)
public class TestPlug2 extends StandardPluginForEA {
/**
*
*/
private static final long serialVersionUID = -4680679876936141843L;
/**
* führt die Verschiebung, Verzerrung, Rotation... von Wänden in der
* übergebenen Umgebung durch.
*
* @param umg Die Umgebung, in der die Veränderungen stattfinden sollen.
* @param simZyk Der aktuelle Simulationszyklus.
* @param params Die Parameter.
*/
@Override
public void runDuringSimulation(
final EnvironmentEA umg,
final Wink simZyk,
final ParCollection params) {
}
/**
* führt Aktionen aus, die vor dem Start der Simulation fertiggestellt sein
* müssen.
*
* <Methode wird VOR Simulation aufgerufen.>
*
* @param umg Die Umgebung.
* @param params Die Parameter.
*/
@Override
public void runBeforeSimulation(
final EnvironmentEA umg,
final ParCollection params) {
}
/**
* führt Aktionen aus, die nach dem Ende der Simulation abschließend
* ausgeführt werden müssen.
*
* <Methode wird NACH Simulation aufgerufen.>
*
* @param umg Die Umgebung.
* @param params Die Parameter.
*/
@Override
public void runAfterSimulation(
final EnvironmentEA umg,
final ParCollection params) {
}
/**
* @return Identifikation.
*/
@Override
public String id() {
return "test1";
}
/**
* über diese Methode können neue Parameter definiert werden, die nur in
* diesem PluginGültigkeit haben. Wichtig ist zu gewährleisten, dass keine
* gleichnamigen Parameter in verschiedenen Plugins existieren.
*
* @return Die Liste von Parametern.
*/
@Override
public List<SingleParameter> getParameters() {
return null;
}
/**
* über diese Methode können generische Sensoren definiert werden,
* die als Liste von Sensoren zurückgegeben werden müssen. Die Liste kann
* <code>null</code> sein.
*
* @return Die Liste generischer Sensoren.
*/
@Override
public List<GenericSensor<?, ?, ?>> getGenericSensors() {
LinkedList<GenericSensor<?, ?, ?>> sensoren
= new LinkedList<GenericSensor<?, ?, ?>>();
sensoren.add(new GenericSensor<Integer, EnvironmentEA, RobEA>() {
/**
*
*/
private static final long serialVersionUID = -5863735268366945314L;
@Override
public String id() {
return "richtung";
}
@Override
public Integer sense(
final EnvironmentEA umg,
final RobEA rob) {
double richt = rob.getAngle() / 360 * 255;
return (int) richt;
}
});
sensoren.get(0).setEvolvable(true);
return sensoren;
}
/**
* über diese Methode können generische Zustände definiert werden.
*
* @return Die Liste generischer Zustände.
*/
@Override
public List<GenericState> getGenericStates() {
ArrayList<GenericState> liste = new ArrayList<GenericState>(2);
liste.add(new GenericState() {
/**
*
*/
private static final long serialVersionUID = -6730081139571785657L;
@Override
public String stateName() {
return "drv";
}
@Override
public void stateAction(
int statePar,
RobEA rob,
EnvironmentEA umg,
ParCollection params) {
rob.vorwaerts();
}
});
liste.add(new GenericState() {
/**
*
*/
private static final long serialVersionUID = 6903209670531450839L;
@Override
public String stateName() {
return "lft";
}
@Override
public void stateAction(
int statePar,
RobEA rob,
EnvironmentEA umg,
ParCollection params) {
if (rob.getGeschwLinks() < 10) {
rob.setGeschRadLinks(rob.getGeschwLinks() + 0.5);
} else {
if (rob.getGeschwRechts() > -10) {
rob.setGeschRadRechts(rob.getGeschwRechts() - 0.5);
}
}
rob.vorwaerts();
}
});
liste.add(new GenericState() {
/**
*
*/
private static final long serialVersionUID = 3337103524267477306L;
@Override
public String stateName() {
return "rgt";
}
@Override
public void stateAction(int statePar, RobEA rob, EnvironmentEA umg,
ParCollection params) {
if (rob.getGeschwRechts() < 10) {
rob.setGeschRadRechts(rob.getGeschwRechts() + 0.5);
} else {
if (rob.getGeschwLinks() > -10) {
rob.setGeschRadLinks(rob.getGeschwLinks() - 0.5);
}
}
rob.vorwaerts();
}
});
return liste;
}
/**
* über diese Methode können abhängigkeiten zwischen Plugins definiert
* werden. Die hier zurückgegebene Liste sollte die IDs aller Plugins
* enthalten, die von diesem Plugin benötigt werden und ohne die kein
* Start der Simulation möglich sein soll.
*
* @return Die Liste benötigter Plugins. Diese Liste kann <code>null</code>
* sein, wenn keine abhängigkeiten definiert werden sollen.
*/
@Override
public List<String> getRequiredPlugins() {
return null;
}
@Override
public void handleEvent(
final EASEvent e,
final EnvironmentEA env,
final Wink lastTick,
final ParCollection params) {
}
}