Update Names and Values in Hover Labels
When you hover over an element in a JMP graph (such as a point or bar), you see content in the hover label for that element. By default, the hover label contains name and value pairs that are in a grid. The value can come from the data table or can be an arbitrary calculation or JSL expression. You can customize these names or values with gridlets. For example, here are some actions that you can do:
• remove a name and its associated value
• add a name and its associated value
• change a name
• change the style of a name (for example, bold) or a value (for example, decimal places)
Tip: Another way to customize hover label grid entries is by using labels. See Add Images from JMP Data Tables to Hover Labels.
Example of Updating Names and Values in a Hover Label
In this example, you create a graph and update content in the hover label by using gridlets.
Create the Original Graph
1. Select Help > Sample Data Folder and open Movie Inventory.jmp.
These data show movie rental data.
2. Select Graph > Graph Builder.
3. Select Length and drag it to the Y zone.
4. Select Year and drag it to the X zone.
5. Click Done.
6. Hover over the point in row 34 (Figure 9.72).
Figure 9.72 Initial Hover Label Content for Row 34
For the data point in row 34, you see the row number, the year in which the movie was made, and the length of the movie (in minutes). Change what appears in the hover labels:
• Remove the row number and the length entry.
• Add the movie name and genre.
• Create a new entry that shows the length of the movie in hours and minutes.
• Make the genre name bold.
Update Names and Values
1. Hover over the hover label for row 34 and click the Pin element (
).
Pinning the hover label lets you see your changes as you apply them.
2. Right-click in the hover label and click Edit.
3. In the thumbnail on the left side, click Row.
4. Select the Delete tab.
“Row” appears as an entry to be deleted.
5. Click Add. Click Apply.
In the graph window, notice that Row is removed from the hover label.
Figure 9.73 Hover Label with Row Removed
6. In the thumbnail on the left side, click Length (the other entry that you want to remove).
7. In the Delete tab, click Add.
“Length” appears under the entries to delete.
8. Click Apply.
In the graph window, notice that Length is removed from the hover label, leaving only Year.
9. Add the movie name and genre:
a. Click the Append tab. The Type should be set to Name.
b. Under Target, type Name (the name that you want to add).
c. Under Value, copy and paste the following JSL expression:
:Name[local:_firstRow]
Name is the column reference. Brackets indicate to get the corresponding column value for the given index. local:_firstRow is the index, which is a Hover Label Execution Context (HLEC) variable. For details, see “Work with the Hover Label Execution Context” in the Scripting Guide.
d. Click Add and then click Apply.
In the thumbnail and in the graph hover label, you see that the name of the movie is added.
Figure 9.74 Hover Label with Name Added
e. Under Target, type Genre (the next name that you want to add).
f. Under Value, copy and paste the following JSL expression:
:Genre[local:_firstRow]
g. Click Add and then click Apply.
In the thumbnail and in the graph hover label, you can see that the genre of the movie is added.
10. Convert the Length data from minutes to hours and minutes:
a. On the Append tab, in the Target box, type Duration (the name of the new hover label that you want to add).
b. Under Value, copy and paste the following JSL expression:
local:_Length * 60
local:_Length is an HLEC variable, with the value of the grid entry Length. Length is in the graph, so you have access to this value in the hover label context. For details, see “Work with the Hover Label Execution Context” in the Scripting Guide.
* 60 converts the duration from minutes to seconds. To apply the hours:minutes format, the duration must be in seconds.
c. Click Add and then click Apply.
In the thumbnail and in the graph hover label, you see that the Duration label is added. But the value needs to be formatted correctly.
Figure 9.75 Hover Label with Duration Added
d. Click the Reformat tab.
e. Under Target, type Duration (the name of the hover label entry that you want to reformat).
f. Click Edit.
g. Next to Format, select Duration > hr:m and then click OK.
h. Click Add and then click Apply.
On the hover label, notice that the Duration is now in hours and minutes.
Figure 9.76 Hover Label with Duration in Hours and Minutes
11. Make the Genre values bold:
a. Click the Style tab.
b. Under Target, type Genre (the name of the hover label entry that you want to make bold).
Notice that Scope is set to Values. This bolds the Genre values instead of the name Genre.
c. Click Font.
d. Under Font style, click Bold and then click OK.
e. Click Add and then click Apply.
On the hover label, you see that the Genre value, Romance, is now bold.
Figure 9.77 Hover Label with Genre Value in Bold
Hover over the other labels to see that they are all updated.
Figure 9.78 Updated Hover Labels
Use Labels in Data Tables
In addition to gridlets, you can also do some basic customization of hover labels by adding Labels to columns in data tables.
• If your hover label contains a Row entry, you can replace it with values in columns by adding a Label.
• After you add a Label, you can make it persist on the graph. You can also move the label’s location on the graph. A tag line might be added to connect the label to its point.
Example Using Labels in Data Tables
1. Select Help > Sample Data Folder and open Iris.jmp.
2. Select Graph > Graph Builder.
3. Select Sepal length and drag it to the Y zone.
4. Select Sepal width and drag it to the X zone.
5. Click Done.
6. Hover over the point in row 109.
Figure 9.79 Hover Label for Row 109
You see that a Row entry appears in the hover label. You want to replace it with a column and its value from the data table called Species.
7. In the data table, right-click the Species column and select Label/Unlabel.
A label icon (
) appears beside the column name in the Columns panel.
8. In Graph Builder, hover over the same data point.
Figure 9.80 Hover Label Showing Species Column
You see that the Row entry is replaced by the Species column.
Note: If you specify multiple labeled columns, their values appear alphabetically in the hover label.
Now, you want to make some of the labels persist on the graph.
9. Click the same data point to highlight it.
10. Right-click anywhere and select Rows > Row Label.
Note: In a histogram, right-click the box plot area on the right.
Figure 9.81 Species Label That Shows on Graph
You see that the label that contains the Species value for this data point appears on the graph.
11. Click and drag the label to move its position.
A tag line is added to connect the label to the point.
Figure 9.82 Reposition the Species Label
In the data table, a label icon appears beside the row number.
Data remains labeled until you highlight the column or row and select Label/Unlabel again.