Symbols

Description :
This module enables a symbol to be placed to represent the statistical data.

Results as a function of the inputs

This module can have a maximum of two inputs. If this is the case, one of the inputs must of necessity be a continuous data input.
This means that the module can have as its inputs, as desired :

• 1 continuous data input
• 1 discrete data input
• 1 qualitative data input
• 1 continuous data input and 1 discrete data input
• 1 continuous data input and 1 qualitative data input

If the continuous data input is the only one available, the symbols are proportional (in surface) to the data. Positive and negative values can have different colors.

If the discrete (or qualitative) data input is the only one available, the symbols are all the same size, but in different colors depending on the class.

If the continuous data input and the discrete (or qualitative) data input are available, the symbols are proportional to the continuous data and colored according to class.

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)

As a result, their surface is proportional to the data:
    surface = maximum surface  x  current data / 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.

• image on disk
• text
• custom image
• circle
• square
• triangle pointing downwards
• triangle pointing upwards
• cross
• diagonal cross
• long cross
• horizontal ellipse
• vertical ellipse
• horizontal rectangle
• vertical rectangle
• five-pointed star
• six-pointed star
• man
• woman
• house
• watch
• flash of lightning

List of the symbols available for Cartes & Données Personal Edition :

• circle
• square
• triangle pointing upwards
• cross

To use an image symbol, you have two possibilities:

• Choosing a file containing an image. For this, select image on disk in the symbols list, and then click on the Choose image on disk button. The path of the selected file appears in the field located on the right of this button.
• Choosing an image in the custom image list. For this, select image in the symbols list, and then click on the square of the image to open the provided image list. This list can be changed in the Options/Preferences menu.

If the discrete (or qualitative) data input is available, the symbol used cannot be an image (see qualitative symbols for a representation with different images).

To use a text symbol, first select text in the symbols list, and then specify your text in the corresponding field.
When you click on the 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 in this tab.

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.

• Sizes

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

If the continuous data input is available, 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.

If the discrete (or qualitative) data input is the only one available, the symbols are all the same size, indicated by the Size field.

Symbols that are smaller than the Visual threshold are not displayed. This threshold depends on the diameter chosen in the Size field.

If the With stroke box of the Colors tab has been checked, you can choose the stroke thickness in map unit.

If the Sort objects box has been checked, the module sorts the symbols according to decreasing surface area. It thus draws the small surfaces over the large ones.

If the discrete (or qualitative) data input is available, the palette is made of as many colors as classes or qualities. A number in each color gives the correspondence between the color and the class or quality.

If the discrete data input is available, you can check the Automatic palette box.

If the Automatic palette box is checked, a gradation is automatically done between the first and the last colors of the used palette. Then you can change only the first and the last colors of the palette. If you want to change the intermediate colors, you just have to uncheck the Automatic palette box.

Four lists of predefined palettes are supplied:

• automatic color gradiation palettes
• bicolor palettes and a multicolor palette
• automatic lines hatch palettes
• automatic points hatch palettes

You can choose not to color the interior of the symbols by unchecking the With filling box.

The symbols can be shown with an outline by checking the With stroke box. In this case, the outline of the symbols can be given the color of your choice by clicking on the colored square to open the color panel.
You can also choose the stroke thickness, in map unit, in the Parameters tab.

If the symbol is a text, its color will be the filling color. The stroke color will not be used.

If the symbol is an image, neither filling nor stroke are used.

If you check neither the With stroke nor the With filling boxes, the symbols and the caption will not be visible.

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.

When the module is linked for the first time to a qualitative data, the qualities of input data are automatically inserted in the table.
The Qualities import button fills the table with the new qualities if input data has changed. The already inserted qualities are not removed.

The aim of this table is to keep the qualities order associated to the colors, and also to keep the values of qualities even if the input data has changed and that one quality is no more present temporarily.

The number of lines in the table is equal to the number of qualities. The values typed in here must correspond to the input data.

The vertical palette on the left of the Qualities table is a reminder of the color palette located in the Colors tab. You can therefore change colors associated with qualities indifferently in one of these two palettes.

Caption

If the Display caption box has been checked, you have access to the various parametrizing commands.
A black frame can be added for this caption by checking the With frame box.

• Texts

If the module has two data inputs, then it will have two captions : a proportional one and a class (discrete or qualitative) one.
The specifical parameters for these two captions are available in the Proportional and Class tabs.
The parameters available in this Caption tab are common to the two captions.

You can first choose the proportional caption title for the continuous data. You can then set the Caption Title (quantitative and qualitative) for the quantitative or qualitative data. The default caption title is the module name.

If the discrete data input or the continuous data input is available, 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 : on the left, on the right or on the comma (for continuous data). The default choice is "automatic alignment" which choose the best format among the 3 available ones depending on the type of the input data : "left alignment" for qualitative and quantified data, "comma alignment" for continuous data.

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

• Font

• Sizes

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

Three presentations are provided : the classic representation of aligned symbols, the abaque representation and the representation of encased symbols.

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

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.

The Invert order box is available only if the representation is aligned symbols.

• Elements

If the Automatic caption steps 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.

• Classes

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 classes and the texts.
If the discrete data input is available, the caption texts are filled by default with hooks to indicate the class thresholds. From now on you can choose the automatic filling of these texts by using the formulation [x1 ; x2], from x1 to x2, x1 - x2 or the inset texts representation.
If the qualitative data input is available, the caption texts are filled by default with the qualities names that you have specified in parametrizing the module.

• Presentation

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.

The Invert order box is available only if the representation is aligned symbols.

The caption symbol can be the real symbol (chosen in the Parameters tab), a square or a rectangle.

Script :

2      module untyped_list ""
3        mod_type integer "104"
3        mod_subtype integer "601"
3        mod_name string "Symboles"
3        mod_dads integer_list ""
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        symbol_nb integer "-1"
3        lib_symbol_nb integer "6"
3        lib_symbol_name string "sphere_Jaune.png"
3        path_symbol path ""
4          file_type integer "-1"
4          type integer "2"
4          win32_net boolean "F"
4          volume string ""
4          path_elem string_list ""
3        symbol_text string ""
3        symbol_text_font string "family:Times New Roman-face:medium roman-size:12"
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 "200"
3        value double "1619000"
3        min_size double "0"
3        stroke_thickness double "0"
3        size_sorting boolean "T"
3        auto_palette boolean "F"
3        fill_list fill_list ""
4          ? fill ""
5            fill_color fill_color ""
6              red255 integer "157"
6              green255 integer "190"
6              blue255 integer "255"
6              hue360 integer "219"
6              light255 integer "206"
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        has_fill boolean "T"
3        stroke stroke ""
4          stroke_color stroke_color ""
5            red255 integer "255"
5            green255 integer "255"
5            blue255 integer "255"
5            hue360 integer "0"
5            light255 integer "255"
5            saturation255 integer "0"
4          dash dash ""
5            desc_list double_list ""
4          has_dash boolean "F"
3        has_stroke boolean "T"
3        user_qual string_list ""
3        prj_show_caption boolean "T"
3        prj_title_string string "internautes"
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:Arial-face:Regular-size:12"
3        caption_auto_height boolean "T"
3        caption_height double "19.1233"
3        caption_space integer "1"
3        caption_pres integer "0"
3        empty_symb boolean "F"
3        prop_invert boolean "F"
3        prj_steps integer "3"
3        is_auto_values boolean "F"
3        user_values double_list ""
4          ? double "1600000"
4          ? double "800000"
4          ? double "400000"
3        caption_symb integer "10"
3        class_invert boolean "F"
3        caption_text integer "20"
3        prj_is_auto_strings boolean "T"
3        prj_user_string string_list ""
3        input_types integer_list ""
4          ? integer "2"
3        class_nb integer "0"
1    icon_positions integer_list ""
2      x integer "60"
2      y integer "390"
2      x integer "60"
2      y integer "282"
2      x integer "60"
2      y integer "30"
2      x integer "120"
2      y integer "102"
2      x integer "120"
2      y integer "210"

Values for symbol_nb :
Image on disk         -3
Text                  -2
Custom image          -1
Circle                 0
Horizontal ellipse     1
Vertical ellipse       2
Square                 3
Horizontal rectangle   4
Vertical rectangle     5
Triangle pointing up   6
Triangle pointing down 7
Five-pointed star      8
Six-pointed star       9
Man                   10
Woman                 11
House                 12
Cross                 13
Long cross            14
Diagonal cross        15
Watch                 16
Lightning flash       17

In Cartes & Données, the custom images are set in the preferences panel. These images are stored in the /cd_5.0/symbols/ directory which is located into the "My documents/articque/" folder (default installation).

lib_symbol_name stores the current custom image file name.