# 本文件简要概述了 SUMPlayer 的用法。
# SUMOPlayer 可用于实时（如果可能）播放 SUMO 网络转储文件
# 到经纬度坐标。
# 可以通过实现
# de.psi.telco.sumoplayer.SUMOLocationListener
# 以任何方式进行自定义
# 参见：
# public interface SUMOLocationListener {
#   public void LocationUpdated(String vehicleId, int timestep, double lon, double lat, double speed);
# }
# 您可以通过使用
# -l "<classname>" 参数
# 调用 SUMOPlayer 并使用您自己的实现。
# 如果不使用，SUMOPlayer 会使用 STDOUT CVS 样式，例如：
# <vehicle_id>|<timestep>|<lon>|<lat>|<speed>

# Eclipse 集成很容易实现：
# new-project -> from existing ant buildfile (build.xml)

# 查看可能的 ant 任务：
$> ant -projecthelp

# 编译
$> ant sumoplayer.jar

# 运行 sumoPlayer：
$> ant sumplayer.run
# ... 或者更好地通过 jar 文件集成到您的项目中：
$> java -jar sumoplayer.jar
# 可能的参数：
# ANT 参数                         # 描述
# JAR 参数

 -Dnetfile=<sumo_network_xml_file>  # 使用的 sumo 网络文件
 -n                                 # 地理坐标查找所需

 -Dndump=<sumo_ndump_xml_file>      # sumo 网络转储模拟文件
 -d

 -Dequipped=<propability>           # 0 到 1 之间的浮点值
 -e                                 # 定义跟踪的车辆数量。
                                    # 0.01 表示 1%

 -Djitter=<value_in_meters>         # 以米为单位的随机 GPS 抖动
 -j

 -Dlistener=<full_java_classname>   # 使用的 SUMOLocationListener 的
 -l                                 # Java 实现类全名
                                    # 默认：
                                    # de.psi.telco.sumoplayer.SUMOPipedLocationListener
                                    #    (stdout CSV 样式数据)



# JAVA DOC
$> ant javadoc                      # 在 /build/javadoc 中创建 JAVA 文档

sumo ... --no-step-log --netstate-dump - | java -jar SUMOPlayer.jar -d - -c <probability> -n <used_network_file> ...