= WatchPoints in Renew 

== Features

- Add Watchpoints to nets that generate runtime trace data during simulation
- Use automatic instrumentation to automatically generate traces for simulation events
- Generate Heatmaps based on collected data
- Perform interval analysis on collected data

== Download

Full download of Renew with WatchPoints: [https://fbicloud.informatik.uni-hamburg.de/index.php/s/dbQGcZXejcGD3Bw Download Page]

The included Renew is a slightly adapted version of the 5.0 prerelease. 
Please check [http://www.renew.de Renew Website] for license terms and a user guide for Renew itself.

== Requirements

Java JDK 17+ (should at least work until Java 21, no guarantees behind this.)


== Installation

=== Quick

1. Extract the zip file.
2. Navigate to renew5.0-Pre
3. Execute {{{ java -p libs:. -m de.renew.loader gui }}} (unix) or {{{ java -p "libs;." -m de.renew.loader gui }}} (windows)


=== Full

1. Extract the zip file
2. Navigate to renew5.0-Pre/bin/YOUR_OS/ and run the install script installrenew for your operating system
3. To start renew now run the script renew5.0-Pre/bin/YOUR_OS/renew

== Example usage

1. Open or create a *.rnw drawing that contains places and transitions.
2. Select places or transitions and use the Plugins -> Watchpoints menu to set or clear watchpoints.
3. Run a simulation. Trace data will be generated when watched transitions fire or watched places
   change markings. The generated file can be found in USER_HOME/.renew/monitoring.log.
4. Use the Plugins -> Watchpoints -> Analysis menu to generate a HeatMap to color elements based on
   collected data or perform interval analysis.

=== Example net

1. Open the watchpoints-transition-distribution.rnw file from the samples directory.
2. Run a simulation for a few seconds.
3. Use the Plugins -> Watchpoints -> Analysis -> Apply Heatmap command.
4. Select the monitoring.log.
5. Observe how the transitions are colored based on their firing counts.
6. A refresh of the net may be required to see the updated colors. (E.g. by selecting all elements
   and
   moving them slightly.)

== Notes

At the moment a manual deletion of the monitoring.log and a restart of Renew is required between simulation runs.