Using JMP • JMP Platforms • Add Graphics Elements to a Report
Previous
 • 
Next
Add Graphics Elements to a Report
You can add text notes, lines, polygons, ovals, and rectangles to a report using graphics tools found in the toolbar.
Annotations
You can add editable text notes to a JMP report using the annotate tool . To add an annotation:
1.
Select the annotate tool from the Tools menu or toolbar.
2.
Click the location in the window where you want to add the annotation. Or, click and drag to size the annotation note. A white editable text box appears.
3.
Enter text.
4.
Click outside the annotation. The annotation turns yellow.
5.
(Optional) Right-click the annotation to access the following options:
Background Color
Provides you with a color palette, from which you can select the background color for the annotation.
Text Color
Provides you with a color palette, from which you can select the color for the annotation’s text. The color of the font also defines the color of the annotation outline. If you select the same color for both the background and the font, the font does not show except for black and white. A black font on a black background changes to white, and a white font on a white background appears black.
Font
Lets you change the current font type, style, and size. To change the default font, see Fonts in JMP Preferences.
Tag Line
Attaches a line to the annotation that points to a place in the text, as shown below. To move the line with the annotation to a new position, press the Ctrl key and drag the annotation.
Filled
Removes the background color from the annotation so that it looks transparent. A transparent note is handy for putting titles and footnotes on a graph.
Editable
Makes the annotation editable by double-clicking on it.
Reanchor
Reanchors the annotation.
Delete
Deletes the entire annotation.
Note: When adding multiple annotations, press the Shift key when selecting the annotation tool for the first time. This causes subsequent clicks to add an annotation, and you do not have to select the annotate tool from the toolbar before the addition of each annotation.
Once you have added an annotation, you can do the following:
Using Annotations 
Action
Instructions
Add to or edit an annotation
Click inside the text box.
Move an annotation
Click inside the annotation box and drag it. When an annotation is moved, it becomes selected, as indicated by a double blue line with handles around the perimeter.
Resize an annotation
Place the cursor on the handle of a selected note (showing in the middle of the edges and in the corners). The cursor appears as a single crossed arrow; drag to resize the annotation.
Delete an annotation
Highlight the annotation by clicking the handle of a note. Then press the Delete (or Backspace) key.
Add Shapes
You can add editable lines, polygons, and simple shapes (ovals or rectangles) to a JMP report using the drawing tools . The following sections describe how each of these tools can be used.
Note: Each graphics tool remembers the most recent options chosen. This is useful if you need many annotations or other graphics with the same characteristics. For example, suppose you want many thick green lines with an arrow on one end. Create a line the way you want it, set the options, and subsequent lines appear with those options in effect. The options persist until you change them.
Add a Line
To add a line to a report window:
1.
Click the line tool in the tool palette.
2.
Click and drag where you want to insert the line. The line appears selected, showing handles on both ends.
3.
Click and drag the line to move it.
4.
Click a handle and drag to rotate the line.
5.
Right-click a line for a menu of options to customize the appearance of the line, as follows:
Point to and Point from
Places arrows on either end (or both ends) of the line.
Thick
Changes the width of a line to thick. Lines are thin by default.
Dashed
Changes the line to dashed. Lines are solid by default.
Color
Displays the JMP color palette to change the color of the shape.
Reanchor
Reanchors the shape.
Delete
Removes the shape from the report surface. You can also remove the shape by selecting it and then pressing the Delete (or Backspace) key.
Add a Polygon or Bezier Curve
To add a polygon (or Bezier curve) to a report window:
1.
Click the polygon tool in the tool palette.
2.
Click to create the beginning point for the first side of a polygon.
3.
Click again at the location where you want to complete the first side and begin an adjacent side. A square selection box with handles appears around the polygon area.
4.
Click a third time to complete the second side.
5.
Continue this process until the polygon is the way you want it. Each time a side is complete, the selection box adjusts to encompass the polygon sides.
6.
Double-click to release the polygon tool.
Once you have added a polygon, you can perform the following actions:
Working with Polygons 
Action
Instructions
Select or deselect the polygon
Click the edge of a completed polygon.
Resize the polygon
Select it and drag one of the selection box’s handles.
Move the polygon
Click between the box’s handles and drag the selection box.
Change the number of sides of the polygon
Click and drag the sides to form the new shape.
Right-click a polygon for a menu of options to customize its appearance, as follows:
Filled
Fills or empties the area of the shape.
Raised
Displays thick shaded lines around the shape. If the shape is also filled, the lower edge of the figure appears raised, giving it a three-dimensional look.
Smooth
Smooths the vertices of a polygon to produce a Bezier curve. The smoothed figure is reshaped and resized the same way as the polygon, and can be filled and raised.
Closed
Opens or closes the last segment of a polygon.
Color
Displays the JMP color palette to change the color of the shape’s sides, and its fill color when the Filled option is in effect.
Reanchor
Reanchors the shape.
Delete
Removes the shape from the report. You can also remove the shape by selecting it and then pressing the Delete (or Backspace) key.
Add an Oval or Rectangle
To add an oval or rectangle to a report window:
1.
Click the simple shape tool in the tool palette.
2.
Click and drag where you want to insert the shape. An oval appears with a selection box around it.
3.
(Optional) To turn the oval into a rectangle, right-click on the oval and select Shape > Rectangle.
4.
Double-click to release the simple shape tool.
Once you have added the shape, you can do the following:
•
Select the shape and drag one of the selection box handles to reshape or resize.
•
Click and drag an edge of the selection box (located between the handles) to move it.
•
Select the shape, and then right-click it for a menu of options to customize its appearance, as follows:
Filled
Fills or empties the area of the shape.
Raised
Displays thick shaded lines around the shape. If the shape is also filled, the lower edge of the figure appears raised, giving it a three-dimensional look.
Shape
Displays a submenu whose options transform the shape into either an oval or a rectangle when selected.
Color
Displays the JMP color palette to change the color of the shape’s sides and its fill color when the Filled option is in effect.
Reanchor
Reanchors the shape
Delete
Removes the shape from the report. You can also remove the shape by selecting it and then pressing the Delete (or Backspace) key.
Add Graphics
To enhance your graphs with logos, pictures, or any other type of graphic, you can paste it into a report in .bmp, .jpeg, or .png format. You can also drag and drop graphics into reports.
To add graphics
1.
Open the graphic file and select the graphic. Copy it to the computer’s clipboard.
2.
Right-click inside a graph.
3.
Select Edit > Paste Background Image. The graphic is inserted at the point in the graph that you right-clicked.
You can also add the graphic to the end of a report window: copy the graphic onto your computer’s clipboard, making sure the report is the active window and selecting Edit > Paste.
Customize Graphical Elements
Graphs consist of markers, lines, text, and other graphical elements that you can customize. For example, in a Scatterplot Matrix graph, you might want to highlight data points in one of the bivariate graphs with a pink solid marker. In a Contour Plot graph, you can increase the width or transparency of the contour lines.
Example of Customizing a Contour Plot
1.
Select Help > Sample Data Library and open Little Pond.jmp.
2.
In the Table panel, click on the red triangle next to Contour Plot and select Run Script.
3.
Click the red triangle next to Contour Plot for Z and deselect Fill Areas.
Contour Plot before Customization
4.
Right-click the plot and select Customize.
The Customize Graph window appears.
5.
Click Shape.
6.
Change the Line Width to 2.0.
7.
Click on the color next to Line Color and select a shade of green.
8.
Click OK.
Customized Contour Plot
The graphical elements that you can customize differ on each graph. For example, in a Control Chart graph, there are three line elements (Marker, Lower Limit, Upper Limit and Connect Line). In other graphs, the line element might be named Line or Custom.
To customize graphical elements in the current graph
1.
Right-click the graph and select Customize.
2.
Select the element that you want to change, and then modify the properties.
Your changes are immediately shown on the graph.
3.
Click OK to save your changes to the current graph.
Each element can include properties for line color, marker style and size, text style, and so on. Here are some common properties:
Line Color
Changes the color of the line. Click to select any color in the window. Right-click to choose from more colors.
Line Style
Changes the style of the line. Click to select one of five different styles.
Line Width
Changes the width of the line. Click in the box and enter the desired line width in points.
Marker
Changes the marker shape. For more information about markers, refer to Use Markers.
Marker Size
Changes the size of the marker.
Arrow
Adds an arrowhead to a line at either None, Start, End, or Both ends of the line.
Line of Fit
Changes the color, width, or style of the line.
Text Color
Changes the color of the text.
Font
Changes the font, style, and point size of the text.
Text Style
Changes the text alignment to centered, left-aligned, or right-justified. The Fill option applies the selected color to the background.
Fill Color
Changes the color of objects such as box plots and Fit Confidence regions.
Fill Pattern
Changes the pattern of filled objects.
Transparency
Changes the marker or label transparency. Enter the level of transparency to draw markers (points) on the graph. The degrees of opacity ranges from 0 (clear) to 1 (opaque). For more information about changing the transparency of markers, see Specify Marker Transparency.
Create Scripts for Graphical Elements
In addition to customizing graphical elements, you can write JSL scripts that add elements. These scripts run when you display the graph. You can write the scripts from scratch, or you can select from the following lists of commands and scripts, accessed by clicking on the Add a new script button :
•
Use the Templates list to insert a single JSL command. For example, the Polygon option inserts the Polygon command. The text enclosed in underscores are placeholders for point values, which you replace with your own values.
Polygon([_x0_, _x1_, ... ], [_y0_, _y1_, ...]);
•
Use the Samples list to insert a script that creates elements such as bubble plots and sine waves. In this list, the Polygon option shows examples of the Transparency, Fill Color, and Polygon values, which you replace with your own values.
The Polygon Sample Script
In some graphs, you can view the JSL that creates graphical elements. Example of JSL That Creates Group Labels shows the Group Label script for a Discriminant Analysis graph. The script defines markers and text for group labels. The commands included in these built-in scripts cannot be modified or deleted. You can insert commands from the Templates or Samples list, but you cannot click in the window and type new commands.
Example of JSL That Creates Group Labels
For information about JSL, see the Scripting Guide book.
To create a graphics script
1.
Right-click on the graph and select Customize.
2.
Click the Add a new script button () to create a new script.
The default name, Script, is highlighted.
3.
With the default name highlighted, type a more descriptive name, and then press Enter. (If you already moved the cursor and the name is no longer highlighted, double-click Script, and then enter the new name.)
4.
Do one or more of the following:
‒
Enter JSL in the Properties window.
‒
Select one or more JSL commands from the Templates list, and modify the placeholder text. For example, change the Pen Color option from “blue” to “red.”
‒
Select one or more sample scripts from the Samples list and modify, if necessary.
5.
(Optional) Click Apply to update the graph with your changes without closing the window. Unlike other property changes, script changes to not take effect until you click Apply or OK.
6.
Click OK to save your changes.
One of the following occurs:
‒
The element that you created appears on the graph.
‒
An error message appears if the script contains an error. Select View > Log to read about the error, and then correct the script.
To delete a script that you created, select the script and then select the Delete selected object button ().
Change the Drawing Order of Graphical Elements
The graphical elements are drawn in the order in which they are listed. The first element on the list is drawn first, so it appears behind all other graphical elements. If one element hides another, you can rearrange the order of the elements.
To rearrange graphical elements
1.
Right-click the graph and select Customize.
2.
Select the element that you want to move.
3.
Click the Move up in drawing order button () or Move down in drawing order () button one or more times until the elements are in the order in which you want them drawn.
4.
Click OK.
Save Your Customizations
The graph customizations apply to the current graph and are also used when you redo an analysis. To re-create your graph at a later time with its customizations, select Script from the red triangle menu, and then select one of the Save options. For example, you can save the script to the data table, which applies your customized properties each time you run the script. See Save Your Analysis as a Script in Save and Share Data for details.
Copy Your Customizations
You can copy your customizations from one graph to another. All objects that you created or modified, such as colored text or lines, are pasted to the other graph.
To copy lines from one graph to another, see Copy and Paste Graph Contents.
To copy other objects
1.
Right-click in the graph with custom elements and select Edit > Copy Customizations.
2.
Right-click in the destination graph and select Edit > Paste Customizations.
The objects appear on the current graph and are added to the list of customized elements.
Notes:
•
The customizations are pasted into all similar graphs when you press Ctrl, click, and then paste.
•
The copy customizations feature copies only the elements that you added or modified. It does not copy the other contents of the graph.