{ "info": { "author": "Ecometrica", "author_email": "admin@ecometrica.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Environment :: Console", "Intended Audience :: Other Audience", "License :: OSI Approved :: Apache Software License", "Operating System :: POSIX", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Topic :: Multimedia :: Graphics :: Graphics Conversion", "Topic :: Scientific/Engineering :: GIS" ], "description": ".. image:: https://api.shippable.com/projects/5a533bf2c944eb0600db12c9/badge?branch=master\n :target: https://app.shippable.com/github/ecometrica/gdal2mbtiles\n\n======================================================\n Convert GDAL-readable datasets into an MBTiles file.\n======================================================\n\n**gdal2mbtiles** helps you generate web mapping tiles that can be shown\nthrough a browser-based mapping library on your website.\n\n`GDAL-readable files`_ are images that are georeference, that means that\nthey are positioned and projected on to the world. In order to display a\ndynamic map on the web, you don't want to serve the whole image at once,\nso it must be sliced into tiles that are hosted by a tile server.\n\nThe MBTiles_ file format was developed by MapBox_ to make tile storage\neasier. You can upload the final file to their service, or run your own\ntile server. MapBox provides one called TileStream_.\n\nLater versions of GDAL (>= 2) allow generation of mbtiles files via the\n``gdal_translate`` and ``gdaladdo`` commands. However, gdal2mbtiles offers some\nadvantages:\n\n* allows you to specify an upper resolution/zoom level. GDAL always uses the\n native resolution of the input raster to determine the highest zoom level of\n the mbtiles output, whereas gdal2mbtiles can also upsample to create zoom levels\n at a higher resolution than your original file.\n* the ``gdal_translate`` command only converts the geotiff at the native resolution,\n so the lower resolutions are added to the file via overviews (``gdaladdo``)\n* ``gdaladdo`` can only add overviews down to the zoom level corresponding to\n the size of the tile/block size (256x256). gdal2mbtiles can always create images\n down to zoom level 1.\n* performance: gdal2mbtiles uses pyvips for image processing, which is parallel\n and quick. Compared to the equivalent processing with GDAL, gdal2mbtiles is\n typically 2-4 times quicker. For example:\n\n * a resolution 14 file, 13000x11000 pixels, min resolution 0, max resolution\n 14: ~5 minutes with gdal2mbtiles and ~8 minutes with GDAL commands.\n * a resoluton 11 file, 200,000x200,000, zoom level 11 only: ~30min with\n gdal2mbtiles and ~133min with GDAL (with ``GDAL_CACHE_MAX`` and\n ``GDAL_NUM_THREADS`` options)\n\n\nInstallation\n============\n\nUsing pip::\n\n $ pip install gdal2mbtiles\n\nPyPi package page https://pypi.python.org/pypi/gdal2mbtiles/\n\nFrom source::\n\n $ git clone https://github.com/ecometrica/gdal2mbtiles.git\n $ cd gdal2mbtiles\n $ python setup.py install\n\nNote that this program requires Python 2.7 or higher.\n\n\nExternal Dependencies\n---------------------\n\nWe rely on GDAL_ to read georeferenced datasets.\n\nUnder Debian or Ubuntu, run the following to install it::\n\n $ sudo add-apt-repository ppa:ubuntugis/ppa && sudo apt-get update\n $ sudo apt-get install gdal-bin libgdal-dev\n\n\nYou will need to install the PyPi GDAL package with the following options::\n\n $ pip install --global-option=build_ext --global-option=--gdal-config=/usr/bin/gdal-config --global-option=--include-dirs=/usr/include/gdal/ GDAL==$(GDAL_VERSION)\n\n\nWe also rely on VIPS_ (version 8.2+) to do fast image processing.\n\nUnder Debian or Ubuntu, run the following to install it::\n\n $ sudo apt-get install libvips libvips-dev\n\n\nYou'll also need a few other libraries to deal with large TIFF files and\nto optimize the resulting PNG tiles.\n\nUnder Debian or Ubuntu, run the following to install them::\n\n $ sudo apt-get install libtiff5 optipng pngquant\n\n\nCommand Line Interface\n======================\n\n.. code-block:: console\n\n $ gdal2mbtiles --help\n usage: gdal2mbtiles [-h] [-v] [--name NAME] [--description DESCRIPTION]\n [--layer-type {baselayer,overlay}] [--version VERSION]\n [--format {jpg,png}]\n [--spatial-reference SPATIAL_REFERENCE]\n [--resampling {near,bilinear,cubic,cubicspline,lanczos}]\n [--min-resolution MIN_RESOLUTION]\n [--max-resolution MAX_RESOLUTION] [--fill-borders]\n [--no-fill-borders] [--zoom-offset N]\n [--coloring {gradient,palette,exact}]\n [--color BAND-VALUE:HTML-COLOR]\n [--colorize-band COLORIZE-BAND]\n [--png8 PNG8]\n [INPUT] [OUTPUT]\n\n Converts a GDAL-readable into an MBTiles file\n\n optional arguments:\n -h, --help show this help message and exit\n -v, --verbose explain what is being done\n\n Positional arguments:\n INPUT GDAL-readable file.\n OUTPUT Output filename. Defaults to INPUT.mbtiles\n\n MBTiles metadata arguments:\n --name NAME Human-readable name of the tileset. Defaults to INPUT\n --description DESCRIPTION\n Description of the layer. Defaults to \"\"\n --layer-type {baselayer,overlay}\n Type of layer. Defaults to \"overlay\"\n --version VERSION Version of the tileset. Defaults to \"1.0.0\"\n --format {jpg,png} Tile image format. Defaults to \"png\"\n\n GDAL warp arguments:\n --spatial-reference SPATIAL_REFERENCE\n Destination EPSG spatial reference. Defaults to 3857\n --resampling {near,bilinear,cubic,cubicspline,lanczos}\n Resampling algorithm for warping. Defaults to \"near\"\n (nearest-neighbour)\n\n Rendering arguments:\n --min-resolution MIN_RESOLUTION\n Minimum resolution to render and slice. Defaults to\n None (do not downsample)\n --max-resolution MAX_RESOLUTION\n Maximum resolution to render and slice. Defaults to\n None (do not upsample)\n --fill-borders Fill image to whole world with empty tiles. Default.\n --no-fill-borders Do not add borders to fill image.\n --zoom-offset N Offset zoom level by N to fit unprojected images to\n square maps. Defaults to 0.\n --png8 Quantizes 32-bit RGBA to 8-bit RGBA paletted PNGs. \n value range from 2 to 256. Default to False.\n\n Coloring arguments:\n --coloring {gradient,palette,exact}\n Coloring algorithm.\n --color BAND-VALUE:HTML-COLOR\n Examples: --color=\"0:#ff00ff\" --color=255:red\n --colorize-band COLORIZE-BAND\n Raster band to colorize. Defaults to 1\n\n\nReporting bugs and submitting patches\n=====================================\n\nPlease check our `issue tracker`_ for known bugs and feature requests.\n\nWe accept pull requests for fixes and new features.\n\n\nCredits\n=======\n\nMaxime Dupuis and Simon Law wrote this program, with the generous\nsupport of Ecometrica_.\n\n.. _GDAL-readable files: http://www.gdal.org/formats_list.html\n.. _MBTiles: http://mapbox.com/developers/mbtiles/\n.. _MapBox: http://mapbox.com/\n.. _TileStream: https://github.com/mapbox/tilestream\n\n.. _GDAL: http://www.gdal.org/\n.. _VIPS: http://www.vips.ecs.soton.ac.uk/\n\n.. _issue tracker: https://github.com/ecometrica/gdal2mbtiles/issues\n.. _Ecometrica: http://ecometrica.com/", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/ecometrica/gdal2mbtiles", "keywords": "", "license": "Apache Software License, version 2.0", "maintainer": "", "maintainer_email": "", "name": "gdal2mbtiles", "package_url": "https://pypi.org/project/gdal2mbtiles/", "platform": "", "project_url": "https://pypi.org/project/gdal2mbtiles/", "project_urls": { "Homepage": "https://github.com/ecometrica/gdal2mbtiles" }, "release_url": "https://pypi.org/project/gdal2mbtiles/2.1.1/", "requires_dist": null, "requires_python": "", "summary": "Converts a GDAL-readable dataset into an MBTiles file. This is used to generate web maps.", "version": "2.1.1" }, "last_serial": 5351598, "releases": { "1.0.0": [ { "comment_text": "", "digests": { "md5": "e4dcb746cbd1177f1a951699ddd0ef54", "sha256": "ed223d38f8266f373ade5b42421b95f57529a2e1faad5bee84349fb6179540a7" }, "downloads": -1, "filename": "gdal2mbtiles-1.0.0.tar.gz", "has_sig": false, "md5_digest": "e4dcb746cbd1177f1a951699ddd0ef54", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 60701, "upload_time": "2012-12-14T18:00:55", "url": "https://files.pythonhosted.org/packages/53/0a/83090acac8832eaa9cb8883c4aa6fdc76a0f66a017f64bdefd99fa547d3e/gdal2mbtiles-1.0.0.tar.gz" } ], "1.1.0": [ { "comment_text": "", "digests": { "md5": "17777db748e36853b7346558896f8c60", "sha256": "24abe96f4cb96b421bb31e11f20eac211ebcbb0d043f50d22b5a12eae026249a" }, "downloads": -1, "filename": "gdal2mbtiles-1.1.0.tar.gz", "has_sig": false, "md5_digest": "17777db748e36853b7346558896f8c60", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 61085, "upload_time": "2013-05-29T16:13:10", "url": "https://files.pythonhosted.org/packages/56/e1/62d963b292623011f829b539632c05967616b2f57048607031c7f5364260/gdal2mbtiles-1.1.0.tar.gz" } ], "1.2.0": [ { "comment_text": "", "digests": { "md5": "7c6b9a164117c36b0a1ac807e332bb74", "sha256": "4dbe4cfb35e152ed07380fe17def02b9017b2719cdc86271859e5b193f828a5f" }, "downloads": -1, "filename": "gdal2mbtiles-1.2.0.tar.gz", "has_sig": false, "md5_digest": "7c6b9a164117c36b0a1ac807e332bb74", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 42487, "upload_time": "2014-12-16T19:05:34", "url": "https://files.pythonhosted.org/packages/18/9e/629fef97aedcb09d2e02616e816e65fe4c099afb4c7739e754ffde6b8e09/gdal2mbtiles-1.2.0.tar.gz" } ], "1.3.0": [ { "comment_text": "", "digests": { "md5": "5889c9edb8d23cd089e1b812a40e3694", "sha256": "9409e7283ad3ef1cc6c6529761e41d2f7683e64be53d42b44d7c9fb3c28b5189" }, "downloads": -1, "filename": "gdal2mbtiles-1.3.0.tar.gz", "has_sig": false, "md5_digest": "5889c9edb8d23cd089e1b812a40e3694", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 43972, "upload_time": "2015-10-23T13:44:18", "url": "https://files.pythonhosted.org/packages/71/94/1a0a66dc4fb393088eb2d86d239398eaf7f40eaba4ee0f6ed4e9f05d763b/gdal2mbtiles-1.3.0.tar.gz" } ], "1.3.1": [ { "comment_text": "", "digests": { "md5": "8d1debeb666e0434417a34c9fd64117e", "sha256": "6e4e49182637404cc79fca2a5d6e191a2a252fdf577874dd70155b250f3f58d1" }, "downloads": -1, "filename": "gdal2mbtiles-1.3.1.tar.gz", "has_sig": false, "md5_digest": "8d1debeb666e0434417a34c9fd64117e", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 46200, "upload_time": "2017-03-14T19:01:20", "url": "https://files.pythonhosted.org/packages/5a/0e/49031ce0dc988d4ba4429882f817b02a41c8a080c68745b723e7b22ae7bd/gdal2mbtiles-1.3.1.tar.gz" } ], "1.3.2": [ { "comment_text": "", "digests": { "md5": "889a42f72497d33db8a4ad84e4c04437", "sha256": "0c0bfdc4ba60d42b90a98314bab3c47d746b72715011b13277209f50c0c16df7" }, "downloads": -1, "filename": "gdal2mbtiles-1.3.2.tar.gz", "has_sig": false, "md5_digest": "889a42f72497d33db8a4ad84e4c04437", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 46199, "upload_time": "2017-04-11T15:08:57", "url": "https://files.pythonhosted.org/packages/d4/ca/a2dfb58d3202848809840285c296a9049bcf07b065a34dbaf455621d7852/gdal2mbtiles-1.3.2.tar.gz" } ], "2.0.0": [ { "comment_text": "", "digests": { "md5": "e46ef4d2bb68be9f338887e7771b4a26", "sha256": "68544c831a4bc2d70ff4b688175b948e850b79b698cb74ce872d230501429cb9" }, "downloads": -1, "filename": "gdal2mbtiles-2.0.0.tar.gz", "has_sig": false, "md5_digest": "e46ef4d2bb68be9f338887e7771b4a26", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 62752, "upload_time": "2018-03-06T10:44:06", "url": "https://files.pythonhosted.org/packages/b4/5b/68f6974116b60e254af90c4a6bf6246b545f2edd525bb817df32a704caaa/gdal2mbtiles-2.0.0.tar.gz" } ], "2.1.0": [ { "comment_text": "", "digests": { "md5": "598cca7c9d0897a6b49bfef9edbed5df", "sha256": "02c6b85a37aafa4d4abd8330d82ae3d7468579a47ea02b90ca05809f90e9c825" }, "downloads": -1, "filename": "gdal2mbtiles-2.1.0.tar.gz", "has_sig": false, "md5_digest": "598cca7c9d0897a6b49bfef9edbed5df", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 63335, "upload_time": "2018-04-03T14:07:46", "url": "https://files.pythonhosted.org/packages/6a/9e/47247ea7236756aefe60486f7f4afc09c388f65050cb0cb07bc06de2bf41/gdal2mbtiles-2.1.0.tar.gz" } ], "2.1.1": [ { "comment_text": "", "digests": { "md5": "3c72a32192f7ab57ff990b0a45ca2bfe", "sha256": "e7e498907459cb75c3991eb6321aaf6dbafa47c7611c65011a55963ef4901158" }, "downloads": -1, "filename": "gdal2mbtiles-2.1.1.tar.gz", "has_sig": false, "md5_digest": "3c72a32192f7ab57ff990b0a45ca2bfe", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 63293, "upload_time": "2018-04-10T15:21:53", "url": "https://files.pythonhosted.org/packages/7f/81/1f93789cbde64bfe402b01976d637ccae17223ab9f04ca18f9daed4676c5/gdal2mbtiles-2.1.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "3c72a32192f7ab57ff990b0a45ca2bfe", "sha256": "e7e498907459cb75c3991eb6321aaf6dbafa47c7611c65011a55963ef4901158" }, "downloads": -1, "filename": "gdal2mbtiles-2.1.1.tar.gz", "has_sig": false, "md5_digest": "3c72a32192f7ab57ff990b0a45ca2bfe", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 63293, "upload_time": "2018-04-10T15:21:53", "url": "https://files.pythonhosted.org/packages/7f/81/1f93789cbde64bfe402b01976d637ccae17223ab9f04ca18f9daed4676c5/gdal2mbtiles-2.1.1.tar.gz" } ] }