www.pudn.com > planetsim_3.0.zip > README


PlanetSim
---------------
@author Jordi Pujol jordi.pujol@estudiants.urv.es
http://ants.etse.urv.es/planetsim

1. Content
------------------------

This directory contains all *.bat and *.sh to run all existing
tests in the planet.test package and subpackages.

The distribution of these scripts is the same than the
planet.test package hierarchy, using the name of the main class
and the subpackages to naming the script file. For example, 
the scripts that execute the test planet.test.bad.SimNetTest 
are called bad.SimNetTest.sh and bad.SimNetTest.bat, omitting 
the package name "planet.test".


2. Ant compatibility
-----------------------

There are planetsim.properties and build.xml for ant compatibility.
The build.xml has been tested and fully functional.

See the results of "ant targets" in the command line.

IMPORTANT: You need to copy the $PLANETSIM/lib/junit.jar to the $ANT_HOME/lib
to successfully run "ant test".


3. How to run tests
-----------------------

If you have modified any class or added any new test, you have to
run "$ ant jar" or "> ant jar" in this directory to build the 
../lib/planetsim.jar distribution file.

One recommend to run any script as follows:

On Windows systems:
...\> script_name.bat > out.txt

On *nix systems:
$ ./script_name.sh > out.txt

to capture the output to the results file named 'out.txt'.



4. GML graphs
-----------------------

This release is able to generate GML graphs representations.
To open any *.gml output file, use the scripts open_GML_viewer.bat/.sh
to see the results.

The Yed library is used. See ../lib/*_yed.html for more details.



3. Feedback
-----------------------

You can make a very good feedback send us your suggestions and 
errors. Email us to Jordi Pujol 

On any error or problem cases, you have to send these information:

1. Version of Planetsim in use
2. Short description of the error (or problem)
3. The detail of the main classes that take part (executed test, etc.)
4. The related stack trace (if exists)
5. Any other remarkable information.

NOTE: The maximum size of the sent mail is 3MB.


-----

Jordi Pujol
Planet Project Member

Planet: http://ants.etse.urv.es/planet
PlanetSim: http://ants.etse.urv.es/planetsim

July 20, 2005