Grapher: Creating a Script using the Script Recorder

Grapher introduced basic scripting abilities when Grapher 2 was released in 1998. Since then, the scripting abilities have become stronger and more functional. Now, all features that you manually do in Grapher can be done through a script. With the release of Grapher 7, you now have the ability to have Grapher record the script for you as you do the desired steps.

Recording a script to create a new graph

Open Grapher 7 and make sure that you are working in a blank plot window. If you have anything present on the plot window, choose File | New. In the New window, select Plot and click OK. A new, blank plot window is displayed. Choose Edit | Script Recorder | Record or click on the button. The Script Recorder is now recording your steps. We will create a graph and edit the properties of various elements.

1. Choose Graph | 2D Graphs | Line/Scatter.
2. Select the data file you wish to use, such as sample3.dat, located in the Samples folder and click Open. The graph is created.
3. With the line/scatter plot selected, change some of the properties in the property inspector. You can change the line,fill, clipping, or any other properties you wish.
4. After you have made all of the changes to the line/scatter plot, continue making changes to the axes, graph, or by adding drawn objects such as text, polygons, etc.
5. Choose Edit | Script Recorder | Stop or click the button to stop the recording process.
6. In the Save As dialog, type in the name that you want to use to save the script and click the Save button.


In the Save As dialog, type in the desired File name and click the Save button to save the script.
7. The script has now been saved and can be used to make a new graph in the future. To view the script in the Script Manager window, choose View | Toolbars/Managers | Script Manager. The Script Manager window will open and the sample script you just recorded will be shown.


The Script Manager window is shown with the sample script.

Recording a script to alter an existing graph

After a script has been created, either by typing in the various commands in a Scripter window or recording the commands, the script can be used over and over again to create the same graph. This is not always the desired result from recording a script. Occasionally, you may want to make changes to existing graphs. These steps can also be recorded, but you will need to do some editing after the script has finished recording.

1. Open Grapher 7 and choose File | Open.
2. Select the GRF file that you want to edit and click the Open button.
3. Choose Edit | Script Recorder | Record or click on the button. The Script Recorder is now recording your steps. Click on the desired portion of the graph to edit. For instance, you may want to add clipping or change the fill color for a plot, or you may wish to change the tick marks or tick labels for an axis. You can also add new items to the graph, such as text, drawn objects, or additional plots.
4. After you have made all of the desired changes, choose Edit | Script Recorder | Stop or click the button to stop the recording process.
5. In the Save As dialog, click the Cancel button. This will not save the script, but will display it in the Script Manager window.
6. Click in the Script Manager window. We will now make a few edits so that the script will be used on existing open graphs in the future. Scroll to the top of the script. You will find these lines:
'Create a new document window
Set Plot1 = Grapher.Documents.Add(grfPlotDoc)

Change the second line to:

'Create a new document window
Set Plot1 = Grapher.Documents.Active

7. If you added a plot or text that uses a specific worksheet or added grid lines, plot labels, or anything else that specifies a worksheet, you may need to make changes to this line, as well.
8. Right-click in the Script Manager window and choose File | Save. In the Save As dialog, type in the new File name and click the Save button. The script can now be used with any open Grapher GRF file.