Portions

Description :
Each surface and each point on the working map receive a circle divided into sectors (one for each input). Each sector is a regular portion of the circle. If there are four inputs, the circle is divided into four equal portions. Each portion has its own color.

The surface of each portion is proportional to the data input.

Calculation of proportions

The symbols are reduced or increased in size as a function of the statistical data, keeping the proportions of the symbol. The exact calculation is as follows:
    width = maximum width  x  square_root (current data / maximum data)
    length = maximum length  x  square_root (current data / maximum data)

This calculation gives the radius of each sector.

As a result, their surface is proportional to the data:
    surface = maximum surface  x  current data / maximum data

Warnings

If the data associated with a geographical entity are all negative, they are taken as absolute values. On the other hand, if some are positive and others negative, the circle is not displayed.

If certain entities are made up of several surfaces (for example Italy, which is made up of the "boot" and two islands), the symbol is placed on the largest surface.

Parameters

The start and end angles are used to generate partial circles instead of full circles. The start angle must be between 0 and 359 inclusive, and the end angle must be between "start angle" and "start angle +360" inclusive.

The symbol offset allows you to move symbols horizontally (first entry field : x) and/or vertically (second entry field : y) as compared with the centroid, in map unit.
This enables various representations to be displayed on the same map without being superimposed.
By default, the symbols will be placed at the centroid of the entities.

• Colors

The palette is made of as many colors as input data. A number in each color gives the correspondence between the color and the data.

By clicking on the Change all colors button, you reset the palette to colors proposed by default.

The sectors can be shown with an outline by checking the With stroke box. In this case, the outline of the sectors can be given the color of your choice by clicking on the colored square to open the color panel.

Remarks on colors

To change a color, click on the desired color to open the color panel.

To create, remove or change a hatching, click on the desired color with the right button on PC, or click with the Apple key down on MAC, to open the hatch panel.
The values in the hatch panel are in map unit. If the module is in a user library or if no map is supplied in input, you can nevertheless set the values but you cannot see them.

• Sizes

The sectors sizes are automatically set at startup. When you uncheck the Automatic size box, you can specify the desired size in map unit.

You have two choices:

• Maximum size : the Size field contains the maximum diameter which corresponds to the highest value.
• Size for particular value : the Size field contains the diameter which corresponds to the value specified in the Value field.

Caption

The module has always two special captions : a proportional one and a data source one.

If the Display caption box has been checked, you have access to the various parametrizing commands for the caption.

• Texts

You can first choose the proportional caption title. You can then set the Qualitative caption title. The default caption titles are the module name.

The number precision enables you to specify the number of figures to be shown before and after the comma. The number before the comma can be between 1 and 10, and the one after can be between 0 and 10. You can also check the automatic number precision checkbox to set a maximum of 9 significant numbers for the integer part and the decimal part together.

The number alignment allows you to set the alignment of the texts of the proportional caption : on the left, on the right or on the comma. The default choice is "automatic alignment" which choose the best format among the 3 available ones depending on the type of the input data : "comma alignment" for continuous data.

The column number is also modifiable. It enables you to have a classic vertical representation or an horizontal one or a representation in columns. The column number is limited to 12.

The text color can be set by clicking on the colored square to open the color panel.

You can set the texts on the right or under the symbols in the caption.

A black frame can be added for this caption by checking the With frame box.

• Font

• Sizes

When you click on the Choose font button, the font list opens and enables you to select the desired font. Font size, however, is not selected from the list, this is done in the Size field located below. You just have to uncheck the Automatic size box to specify a different size in the map unit.

Finally, you can select the desired space between symbols and texts in caption by choosing a small, normal or large caption.

• Proportional

You can choose not to color the interior of the symbols in the caption by checking the Empty symbols box.

The caption steps specifies the number of symbols shown in the caption. It is limited to 12.

If the Automatic caption values box has been checked, the biggest symbol corresponds to the maximum value, the smallest one corresponds to the maximum value divided by four, and the intermediate symbols have surface areas in a linear progression.
By unchecking this box, you can specify in the 12 text fields the values that you want to be shown in the caption.

The Invert order box enables you to invert the order of caption elements.
Attention, the order of the values specified in this tab will not be inverted.
Therefore:
- if the Invert order box is unchecked, the value of the first text zone will be at the top of the caption.
- if the Invert order box is checked, the value of the first text zone will be at the bottom of the caption.

• Elements

• Elements

This tab contains the parameters of the data source caption. It is accessible if the Display caption box of the Caption tab has been checked.

The caption symbol can be a circle or a 3/4 circle.

You can change the caption texts by unchecking the Automatic strings computation box. You can then specify your texts in the Custom captions column. The first column gives the correspondence between the data and the texts.
The caption texts are filled by default with the input data names.

The Invert order box enables you to invert the order of caption elements.
Attention, the order of the texts specified in this tab will not be inverted.
Therefore:
- if the Invert order box is unchecked, the text associated to the Data Nb 1 will be at the top of the caption.
- if the Invert order box is checked, the text associated to the Data Nb 1 will be at the bottom of the caption.

• Texts

Script :

2      module untyped_list ""
3        mod_type integer "104"
3        mod_subtype integer "605"
3        mod_name string "Portions"
3        mod_dads integer_list ""
4          ? integer "6"
4          ? integer "4"
3        caption_origin vector ""
4          x_val double "0"
4          y_val double "0"
4          z_val double "0"
3        map_bounds bounds ""
4          bottom_left vector ""
5            x_val double "72.699997"
5            y_val double "1620.900024"
5            z_val double "0"
4          top_right vector ""
5            x_val double "1197.599976"
5            y_val double "2675.399902"
5            z_val double "0"
3        proportionnal boolean "F"
3        min_angle double "0"
3        max_angle double "360"
3        prj_delta vector ""
4          x_val double "0"
4          y_val double "0"
4          z_val double "0"
3        is_auto_size boolean "F"
3        is_max_size boolean "T"
3        max_size double "150"
3        value double "12496216"
3        min_size double "0"
3        fill_list fill_list ""
4          ? fill ""
5            fill_color fill_color ""
6              red255 integer "0"
6              green255 integer "0"
6              blue255 integer "255"
6              hue360 integer "240"
6              light255 integer "127"
6              saturation255 integer "255"
5            hatch hatch ""
6              angle1 double "0"
6              angle2 double "0"
6              desc_list1 double_list ""
6              desc_list2 double_list ""
6              is_weft boolean "T"
5            has_hatch boolean "F"
4          ? fill ""
5            fill_color fill_color ""
6              red255 integer "0"
6              green255 integer "178"
6              blue255 integer "0"
6              hue360 integer "120"
6              light255 integer "89"
6              saturation255 integer "255"
5            hatch hatch ""
6              angle1 double "0"
6              angle2 double "0"
6              desc_list1 double_list ""
6              desc_list2 double_list ""
6              is_weft boolean "T"
5            has_hatch boolean "F"
3        stroke stroke ""
4          stroke_color stroke_color ""
5            red255 integer "0"
5            green255 integer "0"
5            blue255 integer "0"
5            hue360 integer "0"
5            light255 integer "0"
5            saturation255 integer "0"
4          dash dash ""
5            desc_list double_list ""
4          has_dash boolean "F"
3        has_stroke boolean "T"
3        prj_show_caption boolean "T"
3        prj_title_string string "Résultat et potentiel de clientèle"
3        prj_precision_before integer "10"
3        prj_precision_after integer "0"
3        col_nb integer "1"
3        text_color stroke ""
4          stroke_color stroke_color ""
5            red255 integer "0"
5            green255 integer "0"
5            blue255 integer "0"
5            hue360 integer "0"
5            light255 integer "0"
5            saturation255 integer "0"
4          dash dash ""
5            desc_list double_list ""
4          has_dash boolean "F"
3        has_back_square boolean "T"
3        right_pos boolean "T"
3        caption_font string "family:Times New Roman-face:Regular-size:12"
3        caption_auto_height boolean "T"
3        caption_height double "19.1233"
3        caption_space integer "1"
3        empty_symb boolean "F"
3        prop_invert boolean "F"
3        prj_steps integer "3"
3        is_auto_values boolean "T"
3        user_values double_list ""
4          ? double "10952011"
4          ? double "5476005.5"
4          ? double "2738002.75"
3        full_circle boolean "T"
3        class_invert boolean "F"
3        prj_is_auto_strings boolean "F"
3        prj_user_string string_list ""
4          ? string "Clients"
4          ? string "Prospects"
3        equal_pies boolean "T"
3        elem_nb integer "2"