[[fr:circle_packing_chart|{{:wiki:flag_fr.png?45 }}]]

====== Circle Packing ======

This is the N4V FOR WEBI Wiki page for the Circle Packing widget.

**Updated for N4V 2025.2.10**

===== Render =====

{{url>https://www.need4viz.com/N4VPublisher/home/Circulars/N4V_Elements/circle_packing.html width=600 height=400 noscroll noborder alignment=center}}

===== Description =====

  * Circular chart for grouping data sets organized on multiple hierarchy levels into concentric bubbles. \\
  * The size of each bubble represents the indicated measurement.

===== How-To Video =====

{{youtube>2zNIf66MxXs}}

===== Parameters =====

  * //Dimension 1// : Dimension for the first level of concentric circles
  * //Dimension 2// : Dimension for the second level of concentric circles
  * //Dimension 3 to 5// : [Optional] Dimensions for the lower levels of concentric circles

  * //Mesaure 1// : Measure for the size of the concentric circle

===== Animations =====

  * Display the tooltip when you move the mouse over a circle (tooltip displayed on the left for the first level, on the top for the second level and on the top for the other levels).
  * When double-clicking on a circle, a drilldown zoom to center and zoom the chart to this level. To drillup, just double-click inside the upper level circle. To display the full chart, double-click outside the first level circle.
  * Use the click-drag to move the circles and display if necessary the labels of the same level of the adjacent circles

===== Settings =====

You can find instructions for accessing settings for Need4viz graphics: [[Format Custom Element]].

For the Circle Packing, the available parameters are :

** Global**
  * **Palette and Style**
    * //General//: You can use the palette tool to define the colors used to build the chart.

**Extended parameters**
  * **Global** -> See the user guide for the "Global" section [[global_extparam | here]]

  * **Menu** -> See the user guide for the "Menu" section [[menu_extparam | here]]

  * **Options**
    * //Zoom & Panning (click drag)// : You can disable the panning (click drag of bubbles). When disabled, a simple click zoom into the bubbles (instead of a double click)
    * //Labels//: This setting allows you to set the label options (Hide, Font). You can also decide to truncate the labels (adding ellipsis) if they are too long. 
    * //Color management mode//: This setting allows you to choose to fix the same color per group (monochrome or multicolor) or per level. You can also set here a gradient effect on the chart.
    * //Background disk//: This setting allows you to define the background of the level 0 circle (main container for all level 1 circles)
 
  * **Tooltip** -> See the user guide for the "Tooltip" section [[tooltip_extparam | here]]
  
  * **Measure**
    * //Measure display//: This setting allows you to specify the name of the measure in the labels (replaces the Webi object name, %SECTION% N4V variable can be used in the label), the unit to add as a measurement prefix or suffix as well as the measurement accuracy. The measurement display format (standard - e.g.: 2,345.67, compact - e.g.: 2.3K or compact long - e.g.: 2.3 thousand) can also be defined.
    * //Aggregation// : Define here the aggregate function to use when drilling

**Export Server** -> See the user guide for the "Export Server" section [[format_export_html | here]]

**Export FTP** -> See the user guide for the "Export FTP" section [[format_export_ftp | here]]

**Export SharePoint** -> See the user guide for the "Export SharePoint" section [[format_export_sharepoint | here]]