roentgen-icons 0.16.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 Röntgen icons are used in iD editor for OpenStreetMap and other projects using icons from the 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 follow a common design style 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 and not depend on color (they can be recolored without losing their meaning).
• Maximum icon size is 14 × 14 px (equivalent to 16 × 16 px with one pixel padding).
• Lines must not be thinner than 1 px. Lines should preferably have an integer pixel width (1 px, 2 px, etc.) for clean rendering at target size.

Recommendations

• Icon parts should be pixel-aligned for better rendering, when possible.
• Lines should have rounded caps. Line joins and bends should also be rounded where possible, unless sharp corners are essential to the shape.
• Prefer fewer details: omit elements that do not contribute to immediate recognition at small sizes. A simpler silhouette reads better than a detailed but cluttered one.
• Use negative space intentionally: cutouts and gaps inside a filled shape can convey detail without adding strokes, keeping the icon clean.

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 greatly simplifies the process of creating new icons.

To regenerate icons and preview grids, run

python -m roentgen icons

Command-Line Interface

Grid Drawing

Draw an SVG file with an icon grid.

python -m roentgen grid

Option	Description
--columns	Number of columns in the 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)