---
name: "nik4"
section: "1"
platform: "linux"
package: "nik4"
version: "1.8-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/nik4"
---

# nik4(1)

Tile-aware Mapnik image renderer

## NAME

nik4 - Tile-aware Mapnik image renderer

## SYNOPSIS

FC**nik4**F\[0\]  \[FC**-h**F\[0\]\] \[FC**--version**F\[0\]\] \[FC**-z**F\[0\] *ZOOM*\] \[FC**-p**F\[0\] *PPI*\] \[FC**--factor**F\[0\] *FACTOR*\] \[FC**-s**F\[0\] *SCALE*\] \[FC**-b**F\[0\] *Xmin Ymin Xmax Ymax*\] \[FC**-a**F\[0\] *PAPER*\] \[FC**-d**F\[0\] *W H*\] \[FC**-x**F\[0\] *W H*\] \[FC**--norotate**F\[0\]\] \[FC**-m**F\[0\] *MARGIN*\] \[FC**-c**F\[0\] *X Y*\] \[FC**--fit**F\[0\] *FIT*\] \[FC**--padding**F\[0\] *PADDING*\] \[FC**--layers**F\[0\] *LAYERS*\] \[FC**--add-layers**F\[0\] *ADD\_LAYERS*\] \[FC**--hide-layers**F\[0\] *HIDE\_LAYERS*\] \[FC**--url**F\[0\] *URL*\] \[FC**--ozi**F\[0\] *OZI*\] \[FC**--wld**F\[0\] *WLD*\] \[FC**-t**F\[0\] *{1,2,3,4,5,6,7,8,9,10,11,12}*\] \[FC**--just-tiles**F\[0\]\] \[FC**-v**F\[0\]\] \[FC**-f**F\[0\] *FMT*\] \[FC**--base**F\[0\] *BASE*\] \[FC**--vars**F\[0\] *\[VARS \[VARS ...\]\]*\] \[FC**--fonts**F\[0\] *\[FONTS \[FONTS ...\]\]*\] *style* *output*

## DESCRIPTION

**nik4** is a Python script to generate images with Mapnik.

## OPTIONS

Positional arguments:

- *style*

  Style file for Mapnik

- *output*

  Resulting image file

Optional arguments:

- FC**-h**F\[0\], FC**--help**F\[0\]

  Show usage information and exit

- FC**--version**F\[0\]

  Show program's version number and exit

- FC**-z**F\[0\] *ZOOM*, FC**--zoom**F\[0\] *ZOOM*

  Target zoom level

- FC**-p**F\[0\] *PPI*, FC**--ppi**F\[0\] *PPI*, FC**--dpi**F\[0\] *PPI*

  Pixels per inch (alternative to scale)

- FC**--factor**F\[0\] *FACTOR*

  Scale factor (affects ppi, default=1)

- FC**-s**F\[0\] *SCALE*, FC**--scale**F\[0\] *SCALE*

  Scale as in 1:100000 (specifying ppi is recommended)

- FC**-b**F\[0\] *Xmin Ymin Xmax Ymax*, FC**--bbox**F\[0\] *Xmin Ymin Xmax Ymax*

  Bounding box

- FC**-a**F\[0\] *PAPER*, FC**--paper**F\[0\] *PAPER*

  Paper format: FC**-a**F\[0\] FC+4F\[0\] for landscape A4, FC**-a**F\[0\] FC-4F\[0\] for portrait A4, FC**-a**F\[0\] FCletterF\[0\] for autorotated US Letter

- FC**-d**F\[0\] *W H*, FC**--size**F\[0\] *W H*

  Target dimensions in mm (one 0 allowed)

- FC**-x**F\[0\] *W H*, FC**--size-px**F\[0\] *W H*

  Target dimensions in pixels (one 0 allowed)

- FC**--norotate**F\[0\]

  Do not swap width and height for bbox

- FC**-m**F\[0\] *MARGIN*, FC**--margin**F\[0\] *MARGIN*

  Amount in mm to reduce paper size

- FC**-c**F\[0\] *X Y*, FC**--center**F\[0\] *X Y*

  Center of an image

- FC**--fit**F\[0\] *FIT*

  Fit layers in the map, comma-separated

- FC**--padding**F\[0\] *PADDING*

  Margin for layers in FC**--fit**F\[0\] (default=5), mm

- FC**--layers**F\[0\] *LAYERS*

  Map layers to render, comma-separated

- FC**--add-layers**F\[0\] *ADD\_LAYERS*

  Map layers to include, comma-separated

- FC**--hide-layers**F\[0\] *HIDE\_LAYERS*

  Map layers to hide, comma-separated

- FC**--url**F\[0\] *URL*

  URL of a map to center on

- FC**--ozi**F\[0\] *OZI*

  Generate ozi map file

- FC**--wld**F\[0\] *WLD*

  Generate world file

- FC**-t**F\[0\] *{1,2,3,4,5,6,7,8,9,10,11,12}*, FC**--tiles**F\[0\] *{1,2,3,4,5,6,7,8,9,10,11,12}*

  Write N×N tiles, then join using ImageMagick

- FC**--just-tiles**F\[0\]

  Do not join tiles, instead write ozi/wld file for each

- FC**-v**F\[0\], FC**--debug**F\[0\]

  Display calculated values

- FC**-f**F\[0\] *FMT*, FC**--format**F\[0\] *FMT*

  Target file format (by default looks at extension)

- FC**--base**F\[0\] *BASE*

  Base path for style file, in case it's piped to STDIN

- FC**--vars**F\[0\] *\[VARS \[VARS ...\]\]*

  List of variables (name=value) to substitute in style file (use ${name:default})

- FC**--fonts**F\[0\] *\[FONTS \[FONTS ...\]\]*

  List of full path to directories containing fonts