Histograms

Description :
A histogram is assigned to each surface and point on the working map. All the bars are of the same width, but their height is proportional to the values. Each bar has its own color.

Parameters :

If the Horizontal box is checked, the histograms are placed horizontally.

By default, all the bars are drawn using the same vertical scale. This scale varies from the minimum value of the data as a whole to their maximum value, in absolute values. You can choose to hide the scale by unchecking the With a scale box.

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 bars can be shown with an outline by checking the With stroke box. In this case, the outline of the bars 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.

It is not necessary to close the color or hatch panel each time. If you have two colors to change, click on the first one, parametrize it in the panel and then click on Apply in this panel (the panel will not be closed). Then click on the second color in the parametrizing window and do the same. Close the panel only when you have finished.

• Sizes
  
  
  

The histogram sizes are automatically set at startup. When you uncheck the Automatic size box, you can specify the desired size and width of the bars in map unit.

You have two choices for specifying the size:

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

Calculation of proportions

The bar height varies according to the data item. The exact calculation is as follows:
    height = maximum height  x  current data / absolute_value(maximum data)

Warning

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.

Caption :

The module has always two captions : a proportional one and a data source one.
The specifical parameters for these two captions are available in the Proportional and Elements tabs.
The parameters available in this Caption tab are common to the two captions.

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

• 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.

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

• Font
  
  
  

You have the possibility of choosing the desired fontt. However, the size will not be here selected but in the Sizes option.

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

• Sizes
  
  
  

When you uncheck the Automatic size box, you can specify the desired size in 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.

Elements

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.

• Elements
  
  
  

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
  
  
  

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.

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.

Script :

2      module untyped_list ""
3        mod_type integer "104"
3        mod_subtype integer "606"
3        mod_name string "Histogrammes"
3        mod_dads integer_list ""
4          ? integer "7"
4          ? integer "4"
4          ? integer "5"
4          ? integer "6"
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 "-1155.359009"
5            y_val double "4049.871094"
5            z_val double "0"
4          top_right vector ""
5            x_val double "3489.684082"
5            y_val double "9442.255859"
5            z_val double "0"
3        is_horizontal boolean "F"
3        has_scale boolean "T"
3        prj_delta vector ""
4          x_val double "0"
4          y_val double "0"
4          z_val double "0"
3        is_auto_size boolean "T"
3        is_max_size boolean "T"
3        max_size double "269.619238"
3        value double "95"
3        width double "67.40481"
3        fill_list fill_list ""
4          ? fill ""
5            fill_color fill_color ""
6              red double "0"
6              green double "0"
6              blue double "1"
6              red255 integer "0"
6              green255 integer "0"
6              blue255 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              red double "0"
6              green double "0.698039"
6              blue double "0"
6              red255 integer "0"
6              green255 integer "178"
6              blue255 integer "0"
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              red double "1"
6              green double "0"
6              blue double "0"
6              red255 integer "255"
6              green255 integer "0"
6              blue255 integer "0"
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              red double "1"
6              green double "0.698039"
6              blue double "0"
6              red255 integer "255"
6              green255 integer "178"
6              blue255 integer "0"
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            red double "0"
5            green double "0"
5            blue double "0"
5            red255 integer "0"
5            green255 integer "0"
5            blue255 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 "Seats number"
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            red double "0"
5            green double "0"
5            blue double "0"
5            red255 integer "0"
5            green255 integer "0"
5            blue255 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:medium roman-size:12"
3        caption_auto_height boolean "T"
3        caption_height double "91.670541"
3        caption_space integer "1"
3        empty_symb boolean "F"
3        prj_steps integer "4"
3        is_auto_values boolean "T"
3        user_values double_list ""
4          ? double "95"
4          ? double "71.25"
4          ? double "47.5"
4          ? double "23.75"
3        class_invert boolean "F"
3        prj_is_auto_strings boolean "F"
3        prj_user_string string_list ""
4          ? string "Party 1"
4          ? string "Party 2"
4          ? string "Party 3"
4          ? string "Party 4"
3        elem_nb integer "4"