Graphing Reference Manual

Transcription

1 Graphing Reference Manual Improvision, Viscount Centre II, University of Warwick Science Park, Millburn Hill Road, Coventry. CV4 7HS Tel: 0044 (0) Fax: 0044 (0) Internet:

2 Printing History Edition Date Edition 1 September 1998 Improvision believes the information in this manual to be correct at the date of issue. However, it is subject to change at any time and does not represent a commitment on the part of Improvision. Improvision shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this manual. Improvision has a policy of continual development and reserves the right to change information within this manual without notice to reflect changes in the system s design and specification Improvision, Image Processing & Vision Company Limited. All rights reserved. Copyright Notice Apple, Finder and Macintosh are registered trademarks of Apple Computer, Inc. Other brand or product names are the trademarks of their respective holders.

3 GRAPHING MODULE Graphing Module Overview The Graphing Module allows you to create line charts from variables. It is used in conjunction with the Automator module, and consists of a Graphing Window and a number of tasks in the Automator. You can have any number of Graphing Windows open, and any number of traces on each one. Graphing Windows are automatically saved with the document. You will find graphing particularly useful if you also have the Advanced Measurements module. You can create an automation that captures the measurements that you want to graph and plots the results simultaneously on-line. Alternatively, you can create an automation that plots measurements off-line against results that have been previously saved. Refer to Chapter 2 of the Openlab Core Guide for instructions on installing modules and to the Advanced Measurements and Automator User Reference Guides for more information about using these two modules. Contents Overview...1 The Graphing Window...2 Graph Menu Bar...3 Graphing Automator Tasks...6 Printing and Saving Graphs...10 Plotting a Simple Graph...11 Graphing 1

4 OPENLAB The Graphing Window Select Graph from the File-New menu. An empty window is displayed for the new graph. Graph menu bar List of traces on the graph Graticules Graph window Click and drag to resize graph window Graticule values 2 Graphing

5 GRAPHING MODULE Graph Menu Bar Graph Menu Select New Trace to create a new trace for the graph. The trace appears in the scrollable list. Once you have created a trace, you will be able to select it and deselect it in the list. A tick appears next to the trace name when it is selected. You can edit the trace name. Click once on the name and type in the new name. You can also edit the trace color. Click on the color bar and select a new one from the pop-up menu. Select Clear Traces to clear selected traces from the graph window. They will re-appear on the graph, if you select them again in the scrollable list or replot the data. Select Delete Traces to delete selected traces from the graph and the scrollable list. Once you have deleted a trace, you will not be able to retrieve it. Graphing 3

6 OPENLAB Select Fit to Window to make the graph fit to the size of the current window. Select Unfit to Window if you want to allow the graph to extend beyond the size of the current window. Use the scroll bars to view any parts of the graph that are no longer visible. Options Menu Select Set Axes... to define the minimum and maximum values on the X and Y axes. Enter the required values in the X0, X1, Y0 and Y1 boxes. If you want the Y values to be set automatically, check the Auto checkbox. You will notice that the Y(1) and Y(0) change to -INF and INF respectively. Select Graticules... to define the number of grid lines on the graph. Enter a value for the number of divisions across the X axis (Divisions Vertically) and the number of divisions across the Y axis (Divisions Horizontally). Openlab calculates co-ordinates for each grid line and displays them where the graticule intersects the X and Y axes. 4 Graphing

7 GRAPHING MODULE Select Hide Graticule to hide the grid lines on the graph. Select Auto extend X axis if you want the X axis to extend automatically if the values exceed your preset end value (X1). Select Scroll to latest data if you want the graph to automatically scroll to the latest data, if the graph is larger than the graph window. Events Menu Select New Event Marker to create a new event marker on the graph. Event markers appear along the X axis. You can move an event marker along the axis. Hold down the Apple command button _, click on the marker and drag it to its new location. You can edit the event name. Just double-click on the name and overtype the new name. You can also edit the color of the event marker. Click on the color bar and select a new one from the pop-up menu. Graphing 5

8 OPENLAB Select Delete Markers to delete event markers. This will delete all event markers on the graph. Click OK at the prompt. Select Hide Markers to hide all markers. This command toggles between Show/Hide Markers so that you can re-display the markers once you have hidden them. Graphing Automator Tasks Before you can plot a graph, you will need to create an automation using the Automator Graphing tasks. The tasks will appear in the Task List in the Automator Window. You will also find an additional task in the Window Targeting section. This task allows you to target a graph window for the results. 6 Graphing

9 GRAPHING MODULE Graph a Variable Task This task allows you to create a variable that defines a point on your graph. You need to create a trace before you set up this task. Use the Setup dialogue to: Identify the trace against which the value will be plotted. Click on one of the buttons, and enter either an expression for the Trace or the trace ID. The trace ID is automatically created when you add a new trace. (You can use the Add New Trace setup dialogue to assign the trace ID to a variable, if required.) Specify the exact location of the variable/point on the graph. Enter expressions for the X and Y co-ordinates. Identify which trace the value is to be plotted against Enter the X and Y coordinates for the point on the graph Graphing 7

10 OPENLAB Add New Trace Task This task allows you to create a new trace for your graph. You need to create a graph window before you set up this task. Use the Setup dialogue to: Identify the targetted graph. Put the trace ID into a variable, if required. (Leave the checkbox blank if you do not want to use this option.) Select a color for the trace. This is the color of the plotted line on the graph. Make the trace visible at the start of the automation. If you do not enable this option, the trace will not appear on the graph, but the trace name will appear in the left hand column (without a tick). Just click on the trace name when you want to display the graph in the graph window. Enter an expression to identify the targetted graph Check box and enter an expression for the Trace ID Select a color for the trace from the pop-up menu Check if you want the trace to be visible at the start of the automation 8 Graphing

11 GRAPHING MODULE Add Event Marker Task This task allows you to add an event marker to your graph and to create a unique label for that event. Use the Setup dialogue to: Specify the X co-ordinate for the marker. This identifies the point on the X axis at which the event occurs. Label the marker. This label will appear on the graph at the point where the event occurred. The name defaults to untitled. Enter an expression for the X co-ordinate Enter an expression for the name of the event marker Clear Graph Trace Task This task allows you to clear a trace from the targetted graph window. Click on one of the buttons in the Setup dialogue to select the trace and enter an expression to identify: Either the trace Or the trace ID. Enter an expression to identify the trace Enter an expression for the trace ID Graphing 9

12 OPENLAB Set Axes Task This task allows you to define the range of values for the X and Y axes on the graph. Use the Setup dialogue to specify: Check the box(es), if you want to enter values. If the box is left unchecked, existing values will be used. Enter values for the minimum (X0, Y0) and maximum (X1, Y1) values of the axes, as required. Check the box if you want to set up a value Enter an expression for the origin (X0, Y0) and end (X1, Y1) values of the axes Printing and Saving Graphs Once you have created a graph, you can print it. Just select Print from the File menu. You can also save a graph. Use the Save or Save as... command from the Openlab File menu, and enter a name for the saved graph. (If you try to close the graph window without saving it first, you will be prompted to save it.) You can then open the graph again like a normal document. 10 Graphing

13 GRAPHING MODULE Plotting a Simple Graph Before you create an automation to plot a graph, you need to decide: What you want to plot. How you will generate the numbers Which variables you need to create and set up. You will also need a Graph Window for the plotted results. Example 1 - Plotting a random line In the following example, we are going to create a simple automation that plots a random line. we have already created a graph window from the File-New command. Graphing 11

14 OPENLAB Setting up the automation The automation is set up as follows: The Target graph window task targets the top-most graph window. The Add new trace task creates the trace, assigns it a name and color, and puts the trace ID into a variable that we can use in subsequent setup dialogues. The Set axes task sets the minimum and maximum values of the y axis. (The Y0 and Y1 boxes are checked.) 12 Graphing

15 GRAPHING MODULE The Loop task determines the number of graph points (or variables) that we will plot and puts the loop count into a variable. The Graph a variable task identifies the trace on which points will be plotted, and then specifies the X and Y co-ordinates for the variable. We are using a random operator to generate the Y co-ordinate, and the loop count variable to set the X co-ordinate. The second Set axes task sets the maximum value of the x axis to the current loop count. (The X1 box is checked.) Graphing 13

16 OPENLAB Running the automation Click on the Run button to produce a graph similar to the following: If you run the automation a second time, you may get a result similar to the following: You can use the graph menu commands, for example to change the color or name of the second trace. 14 Graphing

17 GRAPHING MODULE Example 2 - Plotting a graph from measurement In the following example, we are going to create a simple automation that plots a graph ROI measurements that have already been captured for an image document. You will need to open the image document and its Measurements window before you run the automation. We will create the graph window as part of the Target graph window setup. Setting up the automation The automation is set up as follows: The Target graph window task targets a new, untitled graph window. The Target image window task targets the top-most image window, which is the one to which the measurements are attached. Graphing 15

18 OPENLAB The Input task prompts the user to identify a column in the measurements table. The values in this column will be used to plot the graph. The Add new trace task creates the trace, assigns it a name and color, and puts the trace ID into a variable that we can use in subsequent setup dialogues. The Count measurements task identifies which measurement table will be used, counts the number of rows in that table and stores the result in a variable, called numrows. 16 Graphing

19 GRAPHING MODULE The Loop task uses the numrows variable to define the number of graph points (or variables) that we will plot and puts the loop count into a variable called currentrow. The Extract measurement task defines the measurement table, column and row within that table, from which the measurement will be extracted. (The row uses the loop count variable that was created in the Loop task.) It also defines where the result will be stored, in a new variable called value. The Graph a variable task identifies the trace on which points will be plotted, and then specifies the X and Y co-ordinates for the variable. We are using the value variable (from the extract measurement task) to set the Y co-ordinate, and the loop count (currentrow) variable to set the X co-ordinate. Graphing 17

20 OPENLAB Running the automation Click on the Run button. You will be prompted to select a column for graphing. You must enter the name of one of the ROI columns. Take care to type in the name exactly as it appears in the measurements table. Note: We have used the Options menu to change the axes to Auto in the above example. 18 Graphing