Collection — Histograms

Accessing Histograms

When you access a collection, click on the Histograms tab to view histograms of collection metric data across the scorecards defined for the current collection.

Configuring Histogram Settings

Using the Metric field, select the metric you wish to view from the available list. If the metric that you are looking for does not exist, make sure that it has been defined in one of your scorecards.
(Optional) Set the Scorecard Objectives field to a scorecard defined in the collection to display scorecard objectives behind the histogram. If the selected metric does not exist on the scorecard or if objectives have not been defined for that metric, this field will be ignored, and the histogram will not display any objectives.
(Optional) Set the Group By field to a custom text or choice metric (or Workspace for Organization Collections). The histogram view will update to display a series of histograms where the data is grouped by the selected item.
(Optional) Toggle on the Compact switch located in the toolbar to view the data as compact boxplots instead of histograms.

Not seeing the metric you want to analyze?

Here are some reasons why you may not be seeing a particular metric available in the metric dropdown:

The metric is not the right type (numeric vs non-numeric). Only numeric metrics will appear in the Metric dropdown. Non-numeric custom metrics like text and choice fields are available to select in the Group By field.
The metric has not been added yet to a collection scorecard. In order for a metric to show up in the Metric or Group By field, it must be defined in at least one scorecard that belongs to the collection.

Downloading Histogram Data

Download data for the selected metric by clicking the download button in the toolbar above the histogram. Select the type of data you wish to download. Available options include Patient Metric Values, Histogram Distribution Data, and Boxplot Distribution Data. Press Download to initiate the download.

Data Drill-down and Patient Highlight

To view a list of patients that comprise a particular histogram bin, click on the bin. A list of patients will appear below the histograms in the section titled "Bin Selected for Drill-Down Analysis." Double-click on a patient row to inspect the patient.

To determine where a patient falls in the population for the selected metric, open the patients right sidebar, and click the patient to select it. The bin containing the selected patient will be highlighted with a solid black outline.

Selected Patient Actions

Exporting Patients from a Collection

With a bin from the histogram(s) selected, use the table to select one or more patients.
Press the Export button from the Selected Patients dropdown located in the toolbar above the histogram(s).
Press the Export button to begin the download.

Removing Patients from a Collection

With a bin from the histogram(s) selected, use the table to select one or more patients.
Press the Remove button from the Selected Patients dropdown located in the toolbar above the histogram(s).
Press the Remove button to confirm.

Note: You must have the Remove Collection Patients permission on a collection to remove patients from that collection.

Creating a New Collection from Selected Patients

With a bin from the histogram(s) selected, use the table to select one or more patients.
Press the Create New Collection button from the Selected Patients dropdown located in the toolbar above the histogram(s). Please note that this option is not available when viewing an organization collection across all workspaces.
Enter the information for the new collection, and press Create to create the collection.

Note: You must have the Create Collections permission on a workspace to create a workspace collection for that workspace.

Adding Selected Patients to an Existing Collection

With a bin from the histogram(s) selected, use the table to select one or more patients from the patients table.
Press the Add to Existing Collection button from the Selected Patients dropdown located in the toolbar above the histogram(s). Please note that this option is not available when viewing an organization collection across all workspaces.
Choose a collection from the list, and press Submit to add the patients.

Note: You must have the Add Collection Patients permission on a collection to add selected patients to that collection.

Managing Bookmarks

Recalling Histogram Bookmarks

To recall a saved histogram bookmark, open the histogram right sidebar and click on the bookmark you wish to load. The current histogram configuration settings will be updated automatically.

Note: You must have the Read Collection Bookmarks permission on a collection to view bookmarks for the collection.

Creating Histogram Bookmarks

Note: You must have the Create Collection Bookmarks permission on a collection to create bookmarks for the collection.

To save a histogram configuration for later, configure your settings according to the Configuring Histogram Settings instructions above.
Press the bookmark button located in the toolbar above the histograms.
Choose a Name for the bookmark. You can use any characters you'd like, but the name must be 64 characters or fewer.
Press the Save button to save the bookmark.

Renaming Histogram Bookmarks

Note: You must have the Update Collection Bookmarks permission on a collection to rename bookmarks for the collection.

To rename a histogram bookmark, open the histogram right sidebar.
Press the edit button (denoted by a pencil icon).
Choose a new Name for the bookmark. You can use any characters you'd like, but the name must be 64 characters or fewer.
Press the Save button to save the bookmark name.

Deleting Histogram Bookmarks

Note: You must have the Delete Collection Bookmarks permission on a collection to delete bookmarks for the collection.

To delete a histogram bookmark, open the histogram right sidebar.
Press the Delete button (denoted by a trash icon).
Confirm that you wish to delete the bookmark by pressing the Delete button.