How finnishtransportagency/liikennemerkit works
Project type and purpose
• This is an open-source QGIS resource library, not a full web app or microservice.
• It provides three SVG image collections (old signs, new signs, style scripts) plus a Python “sign stylizer” script to automate symbolization in QGIS.
File structure
• Top-level files and folders:
• README.md – explains usage
• metadata.ini – QGIS Resource Sharing metadata
• collections/
– new_signs/ (SVG assets, license, previews)
– old_signs/ (SVG assets, license, previews)
– style_script/ (sign_stylizer.py under processing/)
• No backend or database. The processing script runs inside QGIS’s Processing Toolbox.
README for additional insights
• The library is installed via QGIS’s Resource Sharing plugin.
• Users load point-layer data (e.g. Digiroad or Tierekisteri) and run the Python script to map feature codes to the correct SVG.
Main components
a. QGIS Application
b. Resource Sharing Plugin (inside QGIS)
c. Collections Repository
• new_signs SVG folder
• old_signs SVG folder
• style_script/processing/sign_stylizer.py
• metadata.ini
d. External point-layer data sources
• Digiroad / Tierekisteri CSV or PostGIS layer
e. User interaction (GIS analyst running the tool)
Relationships and interactions
• User → QGIS Application: invokes Resource Sharing plugin
• Resource Sharing plugin → Collections Repository: installs or updates collections
• User loads point-layer data into QGIS
• User runs “Finnish traffic sign stylizer” script
• sign_stylizer.py reads feature attribute codes and metadata.ini
• sign_stylizer.py selects appropriate SVG from new_signs or old_signs
• Script applies SVG symbols to the point layer symbology
Architectural patterns and design principles
• Plug-in/extension architecture: QGIS core + Resource Sharing plugin + processing script
• Separation of concerns:
• Static asset storage (SVG files)
• Metadata and installation info (metadata.ini)
• Processing logic (Python script)
• Extensibility: new collections can be added by following same folder structure and updating metadata.ini
Relevant technologies
• QGIS 3.x
• QGIS Resource Sharing plugin
• Python (sign_stylizer.py, QGIS Processing framework)
Diagramming recommendations
• QGIS Application
• Resource Sharing Plugin
• Collections Repository
• Processing Script
• External Data Sources
• User
• Installation flow (plugin → repository)
• Data flow (external sources → QGIS → script → map canvas)
• Annotations for key files (metadata.ini, sign_stylizer.py) next to their components