Configuring Histogram

This topic describes how to configure a histogram chart at runtime.

Before you begin

You need a Historian data source. See Create a Data Source (Classic).

Procedure

  1. Run the histogram application.
  2. From the toolbar menu, select to access the Histogram Configuration settings.
  3. Use these settings to configure your Histogram chart:
    Setting Description
    Duration Specify a duration to plot the data. This duration is subtracted from the specified End time. You can go back in time in minutes, hours, or provide a customized duration for the histogram chart. Choose from any of these options:
    • 1, 5, or 30 minutes
    • 1, 2, 4, 8, or 24 hours
    • Select Custom to enter a different duration in the time format text box.
    End You have the option to either choose a custom datetime using the calendar, (or) set the current system datetime.

    Select to set a custom end date and time for data.
    Now Use this option to update the End time to your current system data and time. The toggle is enabled by default. Choosing a different end date and time (using calendar) automatically disables the toggle.

    Select to refresh charts set to 'Now'. The refresh option instantly updates the end time to current time.
    Display Use this option to set a display style for the tag added to the histogram chart. You can choose any of these display styles:
    • Tag Name: Displays only tag name.
    • Tag Description: Displays only tag description. Lengthy descriptions are truncated with an ellipsis. Move your cursor over ... to reveal the complete description. In the absence of a description, tag name is displayed by default.
    • Tag Name and Description: Displays both tag name and description.
    Sampling Increment Select whether you want to increment the sampling data based on time or count, and then specify the time or count, respectively.
    Note: The sampling increment may not always be honored. The maximum number of data points plotted on the histogram chart is 3000 when sampling by time, and 8000 when sampling by count. You can zoom in to view more accurate data.
    No. of Bins Indicates the default number of bins to appear on a histogram chart. You have the option to increase/decrease the bin count at runtime.
    Note: You can add any number of bins from 1 to 200.
    Auto-detect Data Range If auto-detect is enabled, the X-axis values are automatically populated from the tag added to histogram. You have the option to modify the auto-detected value range for the chart.

    To disable auto-detect, turn off the toggle and enter manual Data Range X-axis values. The histogram chart is updated to show the data analysis based on the newly specified X-axis values.
    Normalized Curve Use this option to format the normalized curve (bell curve) in a histogram chart.
    • Apply a color to the curve.
    • If auto scale is enabled, the Y-axis values on the right side of the graph are automatically populated from the tag added to histogram. You can disable the auto scale option to enter specific Min and Max values.
    • To show or hide the curve on the histogram chart, select the eye icon in settings, (or) the Normalized Curve label on the chart.
    Counts Use this option to format histogram counts that appear on the left Y-axis of the graph.
    • Apply a color to the bins.
    • If auto scale is enabled, the Y-axis counts on the left side of the graph are automatically populated from the tag added to histogram. You can disable the auto scale option to enter Min and Max count values. In case, the counts range is reduced, then less number of bins appear on the chart even if the default is set to a higher number.
    • To show or hide the bins on the chart, select the eye icon in settings, (or) the Counts label on the chart.
    Sources Select Add Tag for Histogram to browse the Proficy Historian data source, and select a tag to add to histogram.
    Note: You can add only one tag.
  4. Use the toolbar menu options to achieve the following tasks:
    Task Procedure
    Show/Hide legend Select to show or hide the histogram chart legend.
    View statistics Select to show/hide the statistical data for Historian tags. The statistics appear below the chart.
    Export data Select and then select Export to export and save the histogram chart data to a CSV file.
    Print data Select and then select Print. Enter the title and print.
    Note: The x-axis and y-axis scale values may change when printing the histogram. However, the graph remains functionally accurate.
    Reset histogram chart Select and then select Reset. Any changes made to the duration, start time, axis preferences, and properties are reverted.
    Zoom in/out Mouse-click and drag anywhere on the chart to zoom in.

    Select Reset zoom to zoom out.