Network Plot

 Network Plot

The network plot component is used to plot various network statistics on a sequence graph. The y-axis plots the value of a particular statistic (e.g. density) and the x-axis plots time (i.e. tick count).

Appropriate Parent Component

Default Network Model. Network Plot must be added only to a Network Model.

Properties

Properties are the items that appear in the property pane when you click on a component in the project tree. For more information of properties, see here.

Name     Description
File Name An optional name of the file to record the network stats to. If you wish to record the stats to a file as well as display a plot, then select "write to file" and enter a file name.
Initial X-Axis Size The initial max value of the x-axis. The x-axis will grow as needed as the simulation proceeds.
Initial Y-Axis Size The initial maximum value of the y-axis. The y-axis will grow as needed as the simulation proceeds.
Name The name of the network plot component. This name is used internally by Repast Py. There is no real reason to change the default value. This name becomes a field in your model component.
Schedule See the schedule help and tutorial 3 for more information on the schedule property. The schedule property defines the execution schedule of the actions defined in your network plot

Although there are no user-definable actions associated with the Network Plot component, SimBuilder implicitly defines one action that you MUST schedule in order for plotting to work. In addition a second action will be available if you have choosen to record the plotted statistics to a file. These two actions are:

  1. step. Calculates the current value of the statistics you have chosen to plot, and plots those values.

  2. writeToFile. Writes the statistical values recorded and plotted by step to the file specified by the File Name property.

A typical execution scheme for the Network Plot might have the step action scheduled to execute every tick, and the writeToFile action (assuming recording to a file is desired) every 40 or 50 ticks executing LAST as well as the at the end. The point being that writeToFile should occur at some large interval.

Note that you can edit the relative order of all your scheduled action executions in the master schedule property of your model component. Doing so, you can ensure that step and write are executed when you want them to relative to the rest of your simulation.

Stats To Plot Clicking on the edit button allows you to select which statistics to plot. You can choose from among density, component count, and so forth. You can also set the color and point (mark) type or shape of the plotted stat points.
Title The title of the plot window.