{"id":23956,"library":"large-image-source-mapnik","title":"large-image-source-mapnik","description":"A Mapnik tilesource for large_image, enabling rendering of vector tile sources as raster tiles. Version 1.34.1, released as part of the large_image ecosystem with regular updates.","status":"active","version":"1.34.1","language":"python","source_language":"en","source_url":"https://github.com/girder/large_image","tags":["large-image","mapnik","tilesource","geospatial","girder"],"install":[{"cmd":"pip install large-image-source-mapnik","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Core framework; this source is a plugin","package":"large-image","optional":false},{"reason":"Mapnik rendering library (native dependency, may require system install)","package":"mapnik","optional":false}],"imports":[{"note":"The class name is case-sensitive.","symbol":"MapnikTilesource","correct":"from large_image_source_mapnik import MapnikTilesource"}],"quickstart":{"code":"from large_image_source_mapnik import MapnikTilesource\nimport os\nts = MapnikTilesource(path=os.environ.get('MAPNIK_XML', ''))\nprint(ts.tileSourceMetadata)","lang":"python","description":"Initialize a Mapnik tilesource from an XML file path."},"warnings":[{"fix":"Install Mapnik via conda: conda install -c conda-forge mapnik, or follow OS-specific instructions.","message":"Requires Mapnik system library installed separately. pip install does not install Mapnik C++ bindings.","severity":"gotcha","affected_versions":"all"},{"fix":"Use Python 3.10 or newer.","message":"Python 3.14 support added in v1.34.0. Python 3.10+ required as of v1.34.1.","severity":"breaking","affected_versions":">=1.34.0"},{"fix":"Use 'from large_image_source_mapnik import MapnikTilesource'.","message":"The class is named 'MapnikTilesource' not 'MapnikTileSource' or 'MapnikSource'.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Use 'MapnikTilesource' (note: 'tilesource' all lowercase).","cause":"Typo in class name (capitalization).","error":"ImportError: cannot import name 'MapnikTileSource' from 'large_image_source_mapnik'"},{"fix":"Install Mapnik system package (e.g., apt-get install libmapnik-dev mapnik) or conda install -c conda-forge mapnik.","cause":"Mapnik C++ library not installed or not found by Python bindings.","error":"RuntimeError: Mapnik module not found. Please install Mapnik."}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}