Please ensure Javascript is enabled for purposes of website accessibility
Powered by Zoomin Software. For more details please contactZoomin

CONNECT visualization

TABLE OF CONTENTS

Donut half graphic

Save PDF
Save selected topicSave selected topic and subtopicsSave all topics
Share
Share to emailCopy topic URL
  • Last UpdatedSep 12, 2025
  • 6 minute read

The donut half graphic offers a dynamic appearance and can be rendered at 180 or 290 degrees. Its fluid shape captures attention while blending in with other graphics.

It provides a clear and intuitive visualization of performance metrics so that you cn quickly assess values within specified limits. You can set limits for ranges, which automatically adjusts the text and dial color. This improves clarity and ensures effective monitoring.

Examples

The following donut half graphic has its SelectAngle property set to Angle180.

The following donut half graphic has its SelectAngle property set to Angle290.

The following donut half graphic has its SelectAngle property set to Angle90.

Configure the graphic

Configure the following properties for this graphic:

  • Follow asset context - The asset context affects properties that are configured to display asset stream ref data and asset metadata. When this is enabled:

  • Follow time context - When this is enabled:

    • If this content is in a visualization, it uses the visualization's time context as the time range for the data it displays. For details, see Create a new visualization.

    • If this content is in an experience, it uses the time selected in the time selector content item as the time range for the data it displays. For details, see Add a time selector.

  • Time - If Follow time context is disabled, select the time range for the data displayed in the content item.

  • In the Options section:

    • SelectAngle - The angle of the arc in the graphic.

      Set this to 290°, 180°, or 90°.

    • Statistics - The retrieval mode for the graphic.

      If Current is selected, configure the DataPoint property for each data point. If another option is selected, configure the DataPointReference, StartTime, and DataPointDuration properties for each data point.

      See Understand retrieval mode for details.

    • Color - The color used in the graphic.

    • ShowTitleAs - Enables the Title property in the Graphic Properties section to set the graphic title and sets the font size.

      Title is a larger font. Subtitle is a smaller font.

    • ShowTimeProperties - Enables the DataPointDuration property.

      This option is not available when Statistics is Current or Simulation is enabled.

    • Limits - Enables limits for the graphic.

      If enabled, the HiHiLimit, HiLimit, LoLimit, LoLoLimit, and TargetLimit properties are available.

    • HiHiLimit - Enables the high alert limit for the graphic.

      This is available when Limits is enabled. If enabled, the HiHiLimit property in the Graphic Properties section is available.

    • HiLimit - Enables the high warning limit for the graphic.

      This is available when Limits is enabled. If enabled, the HiLimit property in the Graphic Properties section is available.

    • LoLimit - Enables the low warning limit for the graphic.

      This is available when Limits is enabled. If enabled, the LoLimit property in the Graphic Properties section is available.

    • LoLoLimit - Enables the low alert limit for the graphic.

      This is available when Limits is enabled. If enabled, the LoLoLimit property in the Graphic Properties section is available.

    • TargetLimit - Enables the target value for the graphic.

      This is available when Limits is enabled. If enabled, the Target property in the Graphic Properties section is available.

    • ShowValues - Displays the values for the data points.

    • ShowUOM - Enables units of measure for the data point, if ShowValues is enabled.

      Set the UOM property for the data point in the Graphic Properties section.

    • ShowLegend - Enables the legend for the data points.

      If enabled, the Legend property in the Graphic Properties section is available.

    • ShowCard - Displays a colored background behind the graphic.

    • Simulation - Displays test data for the graphic.

      If enabled, the Statistics and DataPoint properties are not available and the SimMax, SimMin, and SimPeriod properties are available.

  • In the Graphic Properties section:

    • DataPoint - The data point or value for the graphic.

      This is available when Statistics is Current and Simulation is disabled.

      To select a data stream, select the field and then select the pencil icon. In the DataPoint window, select Streams. In the Search window, use the filters to find and then select the stream, asset stream reference, or asset metadata to display.

    • DataPointDuration - The period, in minutes, used when calculating statistics.

      This is available when Statistics is not Current and ShowTimeProperties is enabled. This can't be zero, but it can be negative if you specify a StartTime.

    • DataPointReference - The data point reference or value for the graphic.

      This is available when Statistics is not Current and Simulation is disabled.

      To select a data stream, select the field and then select the pencil icon. In the DataPointReference window, select Streams. In the Search window, use the filters to find and then select the stream, asset stream reference, or asset metadata to display.

    • Decimals - The number of decimal places for the data point value, up to 2.

      Invalid values are discarded.

    • HiHiLimit - The value above which a high alert color appears on the graphic.

      This is available when HiHiLimit is enabled.

    • HiLimit - The value above which a high warning color appears on the graphic.

      This is available when HiLimit is enabled.

    • Legend - The legend text shown on the graphic, up to 20 characters.

      This is available when ShowLegend is enabled.

    • LoLimit - The value below which the low warning color appears on the graphic.

      This is available when LoLimit is enabled.

    • LoLoLimit - The value below which a low alert color appears on the graphic.

      This is available when LoLoLimit is enabled.

    • Max - The highest value for the graphic. Default is 100.

      This value must be greater than the Min value.

    • Min - The lowest value for the graphic. Default is 0.

      This value must be lower than the Max value.

    • ShowLimitSymbol - Displays the limit flags on the graphic.

      This is available when Limits are enabled.

    • SimMax - The highest simulated value for the graphic, when Simulation is enabled.

      Default is 100. This value must be greater than the SimMin value.

    • SimMin - The lowest simulated value for the graphic, when Simulation is enabled.

      Default is 0. This value must be less than the SimMax value.

    • SimPeriod - The simulation refresh period, in seconds, from 1 to 60.

      This is available when Simulation is enabled.

    • StartTime - The start time for use with statistics.

      This is available when Statistics is not Current and ShowTimeProperties is enabled. If no value is specified, auto refresh is applied. The start and end times of the summary period are determined based on current time.

    • Target - The target value for the data point.

    • Title - The title text for the graphic.

      This is available when ShowTitleAs is Title or Subtitle.

    • UOM - The unit of measure text used in legends, up to 5 characters.

      This is available when ShowValues and ShowUOM are enabled.

  • In the Advanced tab:

    • Title - The title displayed for this content item in the grid visualization.

      This is not available in a canvas visualization or experience. Set this value in the Title property in the Graphic Properties section.

In This Topic
TitleResults for “How to create a CRG?”Also Available in