This is an old revision of the document!
### START ###
The installation of ToolMap is rather simple. First you have to download the windows installer. It can be found on our web site:
http://www.crealp.ch/fr/accueil/thematiques/cartographie/toolmap/telechargement.html.
The setup wizard will then guide you through the installation process.
Once you have activated the next step, the wizard will generate a default destination folder for the installation; you can, of course, change the destination folder.
If you click on the [install] button, the installation will begin. Otherwise you can go back to change settings or simply cancel the operation. If you decided to launch the installation, a progress window will pop up. The installation process should be pretty fast.
Once the installation has been completed you'll have the choice to create a desktop shortcut before closing the setup wizard.
ToolMap can now be launched using either the desktop icon or the menu entry located in Programs → ToolMap2 → ToolMap
ToolMap may also be installed without requiring the user to select options or click next. This mode, also called unattended installation, may be particularly useful for system administrator trying to deploy ToolMap on multiple computers without the hassle to go through all the wizard pages.
The following command line may be used for the silent installation of ToolMap:
InstallToolMap_d967.exe /S /INSTDIR=”C:\Program Files\ToolMap2” /AllUsers
The following command line may be used for uninstalling ToolMap silently:
“C:\Program File\ToolMap2\uninst.exe” /S
Download the ToolMap’s .DMG file from http://www.crealp.ch/fr/toolmap-telechargement.html and then double-click on it. A new Finder window similar to the one illustrated bellow should appear.
Drag the ToolMap icon into the “Applications” folder to install ToolMap. Once ToolMap is installed, you can safely eject it's disk image. Click on the ToolMap disk icon on the Desktop and then press CMD-E.
Delete the .DMG file by dragging it to the trash.
ToolMap is actually only available as Debian (*.DEB) package for Ubuntu. To install ToolMap, you may either run the following command line: sudo dpkg -i toolmap_2.4.1337_amd64.deb or use your favorite package manager
The ToolMap user interface integrates the following elements:
In the menu bar nine menus are available, each of them will lead you to different options:
The toolbar is accessible on top of the application window, right under the menu bar. It allows to quickly access to the different main tools available in ToolMap. Most of the toolbar buttons are grayed out while no project is open.
The table of content shows a list of all the layers loaded in the project. It looks like the following:
The status bar at the bottom of the application window provides additional information like geographical coordinates or the number of features selected.
Keyboard Shortcuts have been set to the most used functions to make the use of Toolmap easier and quicker.
The whole management of the project is made with the menu Project, which includes the following options:
To create a new project, select Project → New Project → Empty…. The dialog box illustrated bellow appears.
The Project Properties tab of the Project Definition window allows to complete some generic project information.
The Spatial Model tab of the Project Definition window lists the layers. Each layer contains objects and may have attributes.
The Thematic layer definition window appears when adding a new layer:
The objects belonging to a layer are defined in the Object kind tab of the Thematic layer Definition window
The attributes management is made from the Attributes tab of the Thematic layer definition window.
It's possible to orientate an object of a layer. However, several constraints have to be considered:
Activation of the orientation
In the Object Attribute tab of the Thematic layer definition window, you have to select the attribute by clicking on it, and then activate the case Orientation Field at the bottom of the window(1)(see also attribute orientation to point for further information).
The option Project → New Project → From template… allows you to create a new project with the same layers/objects/attribute as an existing one. This option will create a new project from an existing template. The creation is made through the two following steps:
There are two possibilities to open an existing project:
The Edit option from the menu Project allows editing the characteristics and components (layers, objects, attributes, settings) of the current project.
The layers and attributes of the project can be modified with the Project Definition…function of the Edit submenu.
The first tab Project Properties of the window allows modifying the properties of the project like the name of author and the eventual comments. (See chap. Generalities)
The second Tab Spatial Model allows modifying the layers (see chap. Spatial model) and the attributes (see chap. Attributes definition).
The objects can be modified with the menu Project→Edit→Objects kind… They are distributed in the three spatial kinds: point, line and polygon.
The attributes can be modified with the option Project→Edit→Object Attribute…
The settings edition is activated with the option Project → Edit → Settings…
The project settings tab of the project settings window allows to manage the export and backup properties
The scale tab of the project settings window allows managing the scales
When working on ToolMap the changes are automatically and constantly saved. Because of that it is safe to create frequent backups of the project. The Backup function from the menu Project allows you to make backups of your current project.
At the creation of a backup, you can write a comment about your save.
The comment will appear in the Manage Backup window.
The Manage Backup window is accessible with the option Manage backup from the menu Project. This window lists all the backups stored in your backup file. The name of the backups is automatically generated following this model: Projectname-YYYY-MM-DD-HHMMSS
You can create templates of your project with the option Save as template… from the menu Project. The creation of a template is made as such:
After saving your template you can enter a comment that will appear if you use the create from template option.
The exportation allows generating layers, which were defined at the spatial model level in order to be used in others programs. The export path and format have to be beforehand defined (see chap. Settings)
The exportation is made with the option Export Layer… from the menu Project. When selecting this option the following window appears:
When Exporting a Polygon Layer, ToolMap automatically create a column “NB_LABELS” in the resulting file. This column is filled for each polygon with the number of labels inside that polygon.
Once the spatial model of a project is set, you can get a PDF layout of it using the Export Model as PDF tool (Project→Export→Export Model as PDF…).
The following window will then open :
Checking the “use very simple decorations” box in the next window will allow you to print a lighter version of the document.
To quit the project, you just have to click on the upper-right icon or select the option Project → Exit.
The data management is made through the Data menu, it contains the following elements:
The Link Data… option from the menu Data allows loading some support themes for the vectorization of the construction layers. Those support themes can be vector data (*.shp) or raster data (*.tif, *.JPG and Esri's binary GRID).
In the opposite of the construction layers, the support themes are not stocked in the project but only referenced.
Some of your files may have rotation information, which is not yet supported by ToolMap. In that case you will see the following message:
This message will pop up every time you make an action regarding the layer (including trivial actions like zoom or pan), so be sure to convert your images into non-rotated rasters. If the rotation is insignificant, you may prefer to simply ignore the message by checking the option Hide warnings for this layer. This option prevent the appearance of the message for the current session, but it will pop again the next time you launch your project.
The Import data… option from the menu Data allows you to import some existing information into your construction layers. You can only import lines or points geometries. The process is made in 3 different steps.
If you choose to add a shapefile the following step comes ahead
If you choose to add a CSV file the following step comes ahead
The CSV files are composed of columns of data separated with commas, you will have to choose wich column you want to assign to the X and Y coordinates
The contextual menus are opened by right-clicking on a layer of the table of contents. They vary according to the selected layer.
The different tools allowing you to explore your project in the visualization window are stored in the View menu, it regroups the following elements:
The symbology windows allow you to manage the style of each layer. You have several options available depending of the layer style. They are accessible by double clicking on the layer name in the table of content or with the option Symbology… of the contextual menu.
The points have an additional option found on the other tab of the window (multiple). Under this tab you are able to attribute two different symbology to your lines. The differentiation of the points is made through the queries.
The symbology is directly connected to the attribution of the point, changing its attributes may instantly change its symbology. This option can be very helpful to highlight specific classes.
The lines have an additional option found on the other tab of the window (multiple). Under this tab you are able to attribute two different symbology to your lines. The differentiation of the lines is made through the queries.
The symbology is directly connected to the attribution of the line, changing its attributes may instantly change its symbology. This option can be very helpful to highlight specific structures.
If your imported polygons have attributes, you can class them to have a multiple symbology. (see also Redactor mode)
The tools allowing you to select features in the visualization window are regrouped in the Selection menu:
Regardless you want to make a simple or a multiple selection, you have to be in edition of the correct construction layer to target an object.
You have two ways to select a unique feature:
The multiple selection is made with the selection tool. You can either click and drag your cursor to select all the features within the rectangle or by selecting single features one by one maintaining the Shift key.
All the edition tools are regrouped in the menu Edition, which contains the following elements:
To edit objects with the different tools in ToolMap you will have to enter the edition mode.
This operation activate the edition menu
The draw tool allows creating new features
The modify option allows modifying features.
The draw Bezier tool allows building Bezier curves. For each section of Bezier you’ll have to click four time(see below).
While drawing your Bezier curves, you can modify them using the option Modify Bezier. This option allows you to move your starting/arriving points also the orientation and intensity of the way.
In the Bezier settings you can manage the parameters of the Bezier. You have access to two styles of parameters:
The Preview option displays how the line will be created regarding the parameters. It is only available while drawing a Bezier.
While drawing a line or a Bezier, this tool allows you to remove your last vertices. This tool works only during the vectorization process. This tool will not remove vertices from a validated line.
Allows modifying the geographical coordinates of the vertices.
This tool allows you to insert vertices on a selected line. To do so activate the tool with the option insert vertex in the edition menu or with the I shortcut and simply click on your selected line where you want an additional vertex.
The Delete vertex tool allows you to delete any vertices on a selected line. To do so simply activate the tool selecting the option delete vertex in the Edition menu or with the C shortcut and aim for an unwanted vertex, it will be obliterated.
The Move shared Node allows to move a vertex which is assigned to more than one line. The point is to move a vertex by keeping the boundaries of every lines related to it. This tool is activated using the menu Edition→Move shared node(Ctrl+T) or using the corresponding button in the toolbar.
allows deleting the selected features
In the case of a multiple selection, a window appears asking a confirmation of the suppression.
The cut lines option allows cutting lines. The cut can only be done on a vertex.
The two lines will then have the attributes of the original line.
Allows merging the selected lines. The selected lines have to be adjacent, the lines must have a begin/end vertex in common.
Allows creating intersections between lines which cross themselves. All the segments created will keep their previous attributes
The Flip line option allows to reverse the polarity of the selected line. To check the polarity of the line you have to either open the vertex editor (see Edit vertex) and check the coordinates of the first vertex or use the Oriented line symbology. The tool can be used on multiple lines at once.
The snapping tools are accessible via the menu Edition → Snapping
During the vectorization of a point or line feature, the snapping function allows to hang on the nodes of an existing feature. The snapping can be done on the features of the active layer (i.e. current edition) and/or on features belonging to other layers (construction layers and vectorial support themes)
The snapping panel (Ctrl+G) is defined by the following elements:
Using the option Show snapping radius on map (Ctrl+Alt+G); you will display a circle in the top left corner of the visualization window representing the snapping tolerence.
The options Add layer… and Remove layer… are both accessible in the menu Edition → Snapping or with the contextual menu of the snapping panel.
The attribution function allows assigning descriptive properties to the selected feature or group of features. The descriptive properties of an object are defined by the following elements:
The access to the attribution functions is made with the menu Attribution
This level of attribution is made with the object kind panel. This panel can be activated with the object kind… option of the Attribution menu or by clicking on the Object Kind button in the toolbar.
Object kind attribution scheme
Some layers have linked attributes, which describe the related objects. The attributes can be assigned with the Object attribute (single feature) window. This window can only be displayed when selecting an unique object. It is available through the Object Attribute (single feature)… option of the Attribution menu or by clicking on the Object Attribute button in the toolbar.
The Object attribute(multiple features)… option from the menu Attribution allows you to assign a same attribute to all the selected features having the same object kind:
The object Kind Panel from the menu Attribution allows you to activate three options if checked:
In the case where the object can be oriented, you can give a feature an orientation. You have two ways to do it:
Once you have release the click, the value of the orientation indicator is attributed to the feature.
The Shortcut… option of the attribution menu allows to assign shortcuts to facilitate the attribution.
The shortcuts edition window looks like the following:
At the attribution with a shortcut, you have a message in the status bar that confirms the attribution.
The validation allows verifying the geometrical and semantic meaning of the objects. It is done with the menu Validation:
The semantic validation of your data is made with the use of queries. The queries are available in the Queries panel. You can activate it by clicking on the Queries Panel option in the Validation menu.
There is basically two types of queries; the attribution and the geometry based queries:
The Validation menu includes the option Dangling Nodes… which allows to highlight the geometrical errors of the lines related to polygonal layers. The problematic nodes are identified with a red and white circle. The geometrical validation tool window looks like the following:
There is basically two types of errors:
The polygon is not closed. This is mainly due to a bad snapping. Make sure to use the snapping panel efficiently.
The nodes are correctly snapped but the segment between the highlighted nodes is badly attributed, it shall have the same object kind as the orange lines.
This is actually a semantic error, but sometimes you can miss it with the queries because of very small lines.
The redactor mode allows you to export your layers and reimport them into ToolMap so you can check the consistency of your data. The process is made with the Export Layer… option from the Project menu.
The reimported layers will appear in the table of content as support layers. Like other layers you can access to the symbology window with the contextual menu. This window allows you to classify the different objects in your layers.
By double-clicking on a class you can edit its own symbology.
Several options can be changed:
Those layers can then be displayed like any other support themes.
The redactor mode is very usefull to sort out the labelization errors. The classification with the number of labels lying in each polygon grant you an easy view of the missing or excess labels.
accessible | add | all |
alter | analyze | and |
as | asc | asensitive |
before | between | bigint |
binary | blob | both |
by | call | cascade |
case | change | char |
character | check | collate |
column | condition | connection |
constraint | continue | convert |
create | cross | current_date |
current_time | current_timestamp | current_user |
cursor | database | databases |
day_hour | day_microsecond | day_minute |
day_second | dec | decimal |
declare | default | delayed |
delete | desc | describe |
deterministic | distinct | distinctrow |
div | double | drop |
dual | each | else |
elseif | enclosed | escaped |
exists | exit | explain |
false | fetch | float |
float4 | float8 | for |
force | foreign | from |
fulltext | goto | grant |
group | having | high_priority |
hour_microsecond | hour_minute | hour_second |
if | ignore | in |
index | infile | inner |
inout | insensitive | insert |
int | int1 | int2 |
int3 | int4 | int8 |
integer | interval | into |
is | iterate | join |
key | keys | kill |
label | leading | leave |
left | like | limit |
linear | lines | load |
localtime | localtimestamp | lock |
long | longblob | longtext |
loop | low_priority | master_ssl_verify_server_cert |
match | mediumblob | mediumint |
mediumtext | middleint | minute_microsecond |
minute_second | mod | modifies |
natural | not | no_write_to_binlog |
null | numeric | on |
optimize | option | optionally |
or | order | out |
outer | outfile | precision |
primary | procedure | purge |
range | read | reads |
read_only | read_write | real |
references | regexp | release |
rename | repeat | replace |
require | restrict | return |
revoke | right | rlike |
schema | schemas | second_microsecond |
select | sensitive | separator |
set | show | smallint |
spatial | specific | sql |
sqlexception | sqlstate | sqlwarning |
sql_big_result | sql_calc_found_rows | sql_small_result |
ssl | starting | straight_join |
table | terminated | then |
tinyblob | tinyint | tinytext |
to | trailing | trigger |
true | undo | union |
unique | unlock | unsigned |
update | upgrade | usage |
use | using | utc_date |
utc_time | utc_timestamp | values |
varbinary | varchar | varcharacter |
varying | when | where |
while | with | write |
xor | year_month | zerofill |
### END ###