roentgen-icons 0.14.0

Set of monochrome 14 × 14 px pixel-aligned map icons

Röntgen

Röntgen is a set of monochrome 14 × 14 px pixel-aligned icons. All icons are under the CC BY 4.0 license. You can use them freely, but please give the appropriate credit.

Röntgen was created for the Map Machine project to represent different map features from the OpenStreetMap database. However, it can be easily used for any map project or even for non-map-related projects. Some icons can also be used as emoji symbols. Several of Röntgen icons are used in iD editor for OpenStreetMap and other projects using icons from iD tagging schema.

To use the icons, you can

• browse and download them from the Röntgen website,
• use the npm package @enzet/roentgen: npm i @enzet/roentgen,
• use the PyPI package roentgen-icons: pip install roentgen-icons,
• download them from the icons directory,
• download the release ZIP file from GitHub Releases.

All icons are stored as optimized SVG files. The majority of them contain only one path element with a minimal number of points. File sizes range from 207 bytes to 4 KB, with mean and median sizes of about 1 KB.

All icons tend to follow a common design style, which is heavily inspired by Maki, Osmic, and Temaki.

Feel free to request new icons via issues on GitHub.

Installation

npm Package

Röntgen is available as an npm package:

npm install @enzet/roentgen

After installation, you can use SVG files directly:

import treeIcon from '@enzet/roentgen/icons/tree.svg';

Or use them in HTML:

<img src="node_modules/@enzet/roentgen/icons/tree.svg" alt="Tree icon" />

PyPI Package

Röntgen is available as a PyPI package:

pip install roentgen-icons

After installation, you can use the icons in your Python code:

from roentgen import get_roentgen, Roentgen
from svgwrite.path import Path

instance: Roentgen = get_roentgen()

shape: Shape | None = instance.get_shape("tree")
if shape is not None:
    svg_path: Path = shape.get_svg_path()
    path_commands: str = shape.get_path_commands()

Design Principles

Requirements

• Icons must be monochrome, meaning they cannot have parts in different colors. This ensures they can be recolored without losing their meaning.
• Icons must be 14 × 14 px in size (equivalent to 16 × 16 px with one pixel padding).

Recommendations

• Icon parts should be pixel-aligned for better rendering, when possible.
• Lines should have rounded caps if it doesn't affect shape recognition.

Icon Generation

The icons directory contains generated and optimized SVG icons. Some of the icons are described with iconscript files in the iconscript directory. Others are generated from sketch SVG files in the data directory by Python scripts. This hugely simplifies the process of creating new icons.

To regenerate icons and preview grids, run

python -m roentgen icons

Command-Line Interface

Grid Drawing

Draw SVG file with icon grid.

python -m roentgen grid

Option	Description
--columns	Number of columns in grid
--filter	Regular expression for filtering icons
--new-in	Draw only icons new in a given version (e.g. --new-in 0.13.0 or --new-in HEAD)
--output	Output SVG file
--scale	Icons scale

OpenStreetMap Tags

Röntgen was created for the Map Machine, a rendering engine for OpenStreetMap data, and its primary purpose is to represent tags of objects from the OpenStreetMap database.

The data/tags.json file contains a possible mapping from OpenStreetMap tags to Röntgen icons.

License

All Röntgen icons are licensed under the CC BY 4.0. This means you can use them for any purpose, but please give the appropriate credit, e.g.:

Röntgen icons by Sergey Vartanov (CC BY 4.0)