# PhysGraph Class

Physics Education Research Lab at MSU edited this page May 28, 2015 · 4 revisions

In this section we describe the PhysGraph class which assists students in creating dynamic graphs with advanced functionality.

## Setting Up the Graph

Here is an example of how to set up a simple graph:

``````from physutil import *
from visual.graph import *

graphExample = PhysGraph(numPlots=1)
``````

Importing from physutil makes all the Physics utility tools including the PhysGraph available for use in the current program and visual.graph makes available all Visual objects plus the graph plotting module.

The variable ''numPlots'' represents the number of dependent variables that you want to plot in relation to the dependent variable. However, this variable is optional. If you do not type anything, the program will only make one plot by default. The lines of code below are all synonymous and work equally well for only one plot.

``````graphExample = PhysGraph(numPlots=1)
graphExample = PhysGraph(1)
graphExample = PhysGraph()
``````

## Updating PhysGraph in a Loop

In order to see your graph you will need to update PhysGraph in the while loop. To plot the cart object’s x-position vs. time (t) using PhysGraph, type this in the loop:

``````graphExample.plot(t, cart.pos.x)
``````

## Creating Multiple Plots on Graph

If you want to create multiple plots, first specify how many plots you want PhysGraph to create. In this example we want it to print two plots:

``````graphExample = PhysGraph(2)
``````

Then, specify which values you want PhysGraph to plot in the while loop. In this example it will plot the cart’s x-position (this values would have to be instantiated earlier in the code) compared to time (t). It also draws a horizontal line at 2:

``````graphExample.plot(t, cart.pos.x, 2)
``````

By default, colors for each plot are chosen in this order: starting with red, green, blue, yellow, orange, cyan, magenta, and finally white.

## Formatting the Plots

Many of the vPython plotting options have been enumerated in PhysGraph. By adding the following arguments to the initial call to PhysGraph you can change those parameters.

title='...some text...'
Use this parameter to add a title to the plotting window.

xlabel='...some text...'
Use this parameter to add a title to the x-axis.

ylabel='...some text...'
Use this parameter to add a title to the y-axis.

backgroundColor = XXX
Use this parameter to change the background color of the plots. The default color is white. You can either specify some standard colors using the color.white, color.red, etc. key-words or by specifying an RGB tupple [0-1,0-1,0-1].

graphColors=
Use this parameter to specify the color order of the plots being displayed. The list may include color key-words (color.red, etc.) or RGB tupples [0-1,0-1,0-1].