Instructions for using the Add_a_point_road_sign plugin (APRS) to perform traffic management projects in the QGIS program (tested on version 3.6.0).
Discussion of the various elements of the plugin interface (from the upper left corner):
1.view of the selected road sign (type);
2.the [set type groups folder] button is used to set the parent folder containing groups of road signs (see the folder structure "road_signs_SVG '" of this plugin);
3.the "type groups" combo box is used to select a group of road signs displayed in the main road signs selection box;
4.the [preview] button is used to open the window with the selected road sign in order to try / determine the most appropriate size and proportion (width and height fields) of the road sign’s view in the project;
5.the "graphics" check box is used to determine which road signs are downloaded to the plugin, whether they will be files with vector graphics (.svg) or with raster graphics (.png, .jpg). The selection of raster graphics is available from QGIS version 3.6;
6.the [manual] button is used to display this instruction;
7.the [about] button is used to display general information about this plugin;
8.below is the path of the currently opened parent folder containing groups of road signs (set with the [set type groups folder] button);
9.the type of the selected road sign is displayed below (the name of the file);
10.next to the right is a road sign filter window in the main road sign selection box;
11.the [filter] button starts filtration;
12.main road sign selection box;
13.the "start date" field is used to set the start date of the road sign;
14.the "width" field is used to determine the width of the road sign on the map (see the style of the "vertical_road_signs" and "supports" layers from the "Test_SHP" folder of this plugin);
15.the "height" field is used to determine the height of the road sign on the map;
16.the "angle" field is used to determine the angle of rotation (in degrees) of the sign on the map (if the angle is entered into this field, it will be used to enter the sign, and if this field is empty, the angle must be set when entering the road sign, ie: move the cursor over the point where you want to find the road sign, press LMB, move the cursor in the appropriate direction, release the LMB);
17.the [sa] button is used to set the angle by indicating it on the map, eg along the curb (press LMB, move the cursor, release LMB);
18.the [cp] button is used to copy settings from the road sign already in the project (mark the selected road sign in the project and press the [cp] button);
19.the [Df] button is used to restore the default settings (from the Setup.py file of this plug-in);
20.a set of six buttons for memorizing settings during operation, switching between them, and for deleting them;
21.the field "comments" is used to enter comments about the inserted road sign.
Discussing the Setup.py file of this plug-in:
# -*- coding: utf-8 -*-
class Setup:
WIDTH = 7
HEIGHT = 7
START_DATE = '2019-02-11T11:19'
COMMENTS = ''
COMMENTS_MAX_LENGTH = 100
DB_FIELD_NAMES_MAPPING_DICT = {
'ROAD_SIGN_TYPE': 'type',
'ANGLE': 'angle',
'WIDTH': 'width',
'HEIGHT': 'height',
'START_DATE': 'start',
'COMMENTS': 'comments'
}
MANUAL_FILE_NAME = 'APRS_manual_EN .pdf'
1.remember that this file is a normal python script, so you need to keep all the requirements for such scripts (in particular the number of tabs at the beginning of each line, the presence of apostrophes, etc.);
2.WIDTH, HEIGHT, START_DATE and COMMENTS settings contain the default values of the respective interface fields of this plugin;
3.COMMENTS_MAX_LENGTH setting specifies the maximum number of characters from which a comment may be made (it should match the setting of the road sign layer for this field). The "comments" field of this plugin will not allow you to enter a longer comment;
4.setting DB_FIELD_NAMES_MAPPING_DICT is a dictionary containing data mapping from the plugin to the layers with road signs (eg, pair: 'START_DATE': 'start' means that the date from the 'start date' field of this plugin is to be saved to the field named 'start' of the layer with road signs);
5.MANUAL_FILE_NAME setting refers to the file name in which the instruction displayed by the [manual] button (in the default program to open .pdf files) is located.
Setting paths to folders with .SVG files containing images of road signs:
>> Settings >> Options ... >> System >> SVG paths >> [+]
Review the layer structure from the "Test_SHP" folder: >> Layer Properties >> Source Fields
Review the layer Symbology from the "Test_SHP" folder: >> Layer Properties >> Symbology
Example, inserting a D-6 road sign:
1.open the project "test_svg.qgz" from the "Test_SHP" folder of this plugin;
2.select the "vertical_road_signs" layer;
3.press the icon of this plugin;
4.press the [set type groups folder] button and set the parent folder ("road_signs_SVG” folder of this plugin);
5.in the "type groups" combo box, select the "D" group;
6.in the main road sign selection box, select the "D-6" sign;
7.hover the cursor over the map point where you want to place the sign, press LMB, move the cursor to the proper side, release LMB;
8.if the road sign has not been displayed, set the corresponding SVG Image in the layer properties for the unique value "D-6";
Additives:
1.graphics .png road signs can be downloaded from github.com/piotrm35/APRS_additives
2.instructions for entering horizontal road signs (linear and surface) can be downloaded from github.com/piotrm35/APRS_additives
--------------------------------------------------------------------------------------------------------------------------------------
LMB - left mouse button manual version: 0.2