Introduction List of sources :
List of operators : List of representations :
Cartes & Données Personal Edition Carto Extension Extra Information User Guide Imports / Exports |
|
| Input | 1 Continuous data
and (optional) 1 Discrete data |
| Output | Drawing |
Description :
This module enables statistical data to be visualized using 3-dimensional representations. The points on the map are
raised along the Z axis (height), in proportion to the data value.
If the discrete data input is available, the data will be visualized using a color gradiant according to the height.
Parameters
The camera height is a figure between -90 and 90 (also called the teta angle ). It is calculated as compared with the plane (x,y) of the drawing.
The camera position is a figure between -180 and 180 (also called the phi angle). It enables the camera to "turn" round the drawing in the (x,y) plane.
- Sizes
By unchecking the Automatic height box , you can enter the desired maximum height in map unit. This height will be associated with the highest value of the data.
The camera ray is the distance between the camera and the center of the drawing. It does not change the size
of the drawing, but it enables the perspective to be changed (the closer the camera is to the drawing, the stronger the
effect of perspective).
By unchecking the Automatic ray box, you can enter the desired camera ray, in map unit.
- Values
If the Show peak values box has been checked or if the Display caption box of the Caption tab has been checked, then 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.
If the continous data input has been generated by a grid module and if the camera
height is a positive figure, you can show peak values on the map by checking the appropriate box. Only the
values above a particular threshold will be visible. This threshold is calculated as follows :
Let :
- Min be the minimum value of the input data
- Avg be the average value of the input data
Then, Threshold = Avg + 2 x ( Avg - Min )
If this calculated value is greater than the maximum value of the input data, then the threshold will be equal to the maximum value. In this case, only one value will be displayed : the one of the first square found corresponding to the maximum value.
When you click on the Choose font button, the font list opens and enables you to select the desired font for this values. 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.
Colors
If the discrete data input is available, the palette is made of as many colors as classes, otherwise the palette is made of only one color. A number in each color gives the correspondence between the color and the class.
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.
Two lists of predefined palettes are supplied:
- automatic color gradiation palettes
- bicolor palettes and a multicolor palette
You can modify the stroke color by clicking on the colored square to open the color panel.
You can see the shadow of the drawing by checking the With shadow box, and you can also modify its filling color by clicking on the colored square to open the color panel.
- Values
If the Show peak values box of the Parameters tab has been checked, you can choose the text color by
clicking on the corresponding colored square.
If the Transparent background box has not been checked, you can choose a background color for the texts
by clicking on the colored square to open the color panel. The texts will appear in a rectangle with black edges.
This tab is accessible if the discrete data input is available.
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 caption title. It is the module name by default.
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 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 : "left alignment" for quantified 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 can choose in a font list the desired font. The text color can be set by clicking on the colored square just below this list.
- 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.
- Classes
You can change the caption texts by unchecking the Automatic caption values box. You can then specify your
texts in the Custom captions column. The first column gives the correspondence between the classes and the
texts.
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.
- Presentation
This tab is accessible if the discrete data input is available and if the Display caption box of the Caption tab has been checked.
The caption symbol can be a square or a rectangle.
Script:
2 module untyped_list "" 3 mod_type integer "104" 3 mod_subtype integer "611" 3 mod_name string "Elévation" 3 mod_dads integer_list "" 4 ? integer "6" 4 ? integer "9" 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 "427.349991" 5 y_val double "2195.650024" 5 z_val double "0" 4 top_right vector "" 5 x_val double "526.349991" 5 y_val double "2300.650024" 5 z_val double "0" 3 space space "" 4 center2d vector "" 5 x_val double "625.349991" 5 y_val double "2248.150024" 5 z_val double "0" 4 center3d vector "" 5 x_val double "476.849991" 5 y_val double "2248.150024" 5 z_val double "24.821591" 4 teta double "30" 4 phi double "-80" 4 ray double "764.784262" 3 is_auto_height boolean "T" 3 map_height double "52.5" 3 is_auto_ray boolean "T" 3 auto_palette boolean "T" 3 fill_list fill_list "" 4 ? fill "" 5 fill_color fill_color "" 6 red255 integer "255" 6 green255 integer "238" 6 blue255 integer "153" 6 hue360 integer "50" 6 light255 integer "204" 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 "255" 6 green255 integer "178" 6 blue255 integer "84" 6 hue360 integer "32" 6 light255 integer "169" 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 "255" 6 green255 integer "80" 6 blue255 integer "16" 6 hue360 integer "16" 6 light255 integer "135" 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 "204" 6 green255 integer "0" 6 blue255 integer "0" 6 hue360 integer "0" 6 light255 integer "102" 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_shadow boolean "T" 3 shadow fill "" 4 fill_color fill_color "" 5 red255 integer "178" 5 green255 integer "178" 5 blue255 integer "178" 5 hue360 integer "0" 5 light255 integer "178" 5 saturation255 integer "0" 4 hatch hatch "" 5 angle1 double "0" 5 angle2 double "0" 5 desc_list1 double_list "" 5 desc_list2 double_list "" 5 is_weft boolean "T" 4 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 precision_before integer "6" 3 precision_after integer "2" 3 has_label boolean "F" 3 label_font string "family:Arial-face:medium-size:12" 3 label_auto_height boolean "F" 3 label_height double "3" 3 label_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 label_is_transparant boolean "T" 3 label_back_color fill "" 4 fill_color fill_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 hatch hatch "" 5 angle1 double "0" 5 angle2 double "0" 5 desc_list1 double_list "" 5 desc_list2 double_list "" 5 is_weft boolean "T" 4 has_hatch boolean "F" 3 show_caption boolean "F" 3 title_string string "Elévation" 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:medium-size:12" 3 caption_auto_height boolean "T" 3 caption_height double "1.785" 3 caption_space integer "1" 3 caption_symb integer "12" 3 caption_text integer "20" 3 is_auto_strings boolean "T" 3 user_string string_list "" 4 ? string "[ 8.345393 ; 100 [" 4 ? string "[ 100 ; 500 [" 4 ? string "[ 500 ; 1000 [" 4 ? string "[ 1000 ; 995.946716 ]" 3 has_square boolean "T" 3 has_quant boolean "T" 3 class_nb integer "4" The space field is used to store the 3 parameters Radius, Teta and Phi. The fields center2d and center3d are given as a guide, but are obligatory for a correct reading of the script.
Samples