Skip to content

Commit

Permalink
Fix missing file in docs
Browse files Browse the repository at this point in the history
  • Loading branch information
Sieboldianus committed Jul 27, 2022
1 parent 3a6e437 commit a0e08fa
Show file tree
Hide file tree
Showing 2 changed files with 37 additions and 0 deletions.
8 changes: 8 additions & 0 deletions README.md
Expand Up @@ -114,6 +114,9 @@ This project includes and makes use of several other projects/libraries/framewor
> [_Fiona_](https://github.com/Toblerity/Fiona)
> OGR's neat and nimble API for Python programmers.
> [_Mapnik_](https://mapnik.org/)
> Mapnik combines pixel-perfect image output with lightning-fast cartographic algorithms, backing OpenStreetMap
## License

GNU GPLv3
Expand All @@ -122,6 +125,11 @@ GNU GPLv3

This is a high-level summary of version progress. See [CHANGELOG.md](CHANGELOG.md) for a full list of changes.

2022-07-27: **TagMaps v0.21.0**

- Add export to Mapnik ([`9db0d0d`](https://github.com/Sieboldianus/TagMaps/commit/9db0d0dc0a266f9eef7c3aac5bf663337c096f80))
- See a [jupyter lab notebook](https://ad.vgiscience.org/tagmaps-mapnik-jupyter/01_mapnik-tagmaps.html) that illustrates visualization of tag map data in [Mapnik](https://mapnik.org/)

2021-02-22: **TagMaps v0.20.10**

- fix emoji grapheme detection issue with `emoji>=1.01`
Expand Down
29 changes: 29 additions & 0 deletions docs/user-guide/mapnik.md
@@ -0,0 +1,29 @@
# Visualization with Mapnik

As of tagmaps `0.21.0`, visualization in Mapnik is supported, as an alternative
to the visualization in ESRI ArcGIS [illustrated in the tutorial](../tutorial/#arcmap).

[Mapnik][mapnik] is the render engine backing [OpenStreetMap][osm]
and offers extensive options to customize rendering of spatial data such as
produced by tagmaps. Particularly, the label placement algorithm is on a par with
the proprietary ArcGIS Maplex render engine and thus suited to render tagmaps data with Python
Open Source Software.

Enable this option with the flag [`--mapnik_export`](../../argparse/args/#-mapnik_export)
```bash
tagmaps --mapnik_export
```

If this flag is enabled, instead of creating a separate `emojiTable.csv`,
to be joined in ArcGIS to the shapefile,
emoji will be stored directly in the generated output file (`allTagCluster.shp`)
and can be directly rendered with Mapnik.

**Jupyter Notebook Tutorial**

A jupyter notebook illustrates the process for rendering of these shapefiles in Mapnik.

* [Tag Maps rendering with Python and Mapnik](https://ad.vgiscience.org/tagmaps-mapnik-jupyter/01_mapnik-tagmaps.html)

[mapnik]: https://mapnik.org/
[osm]: https://www.openstreetmap.de/

0 comments on commit a0e08fa

Please sign in to comment.