TILESTACHE-SEED(1)

📦 version 1.51.14, in fedora 43, fedora 44

🌸 TILESTACHE-SEED 💅

okay so bestie, this is the manual page for tilestache-seed, a lil command from the General Commands Manual section (section 1, for the uninitiated). she's a one-trick pony but the trick is GOOD. let's get into it 🫶

✨ NAME ✨

tilestache-seed — seed a single layer in your TileStache configuration 🎀

🦋 SYNOPSIS 🦋

tilestache-seed [options] zoom...

💖 DESCRIPTION 💖

This page documents briefly the tilestache-seed command. Cute, brief, iconic.

tilestache-seed seeds a single layer in your TileStache configuration. No images come back to you — sorry babe, that's not the vibe here — but TileStache ends up with a pre-filled cache, which is lowkey the whole point. ✨

The bounding box gets handed in as a pair of lat/lon coordinates, like this:

37.788 -122.349 37.833 -122.246

Output is a list of tile paths as they are created. Just a lil running commentary of every tile she births. 🌈

🚨 Configuration, BBox, and Layer options are required. No cap. She will not run without all three.

👑 REQUIRED OPTIONS 👑

these are not optional bestie, they are the bare minimum, the entry fee, the price of admission:

  • -c, --config file — path to configuration file. Required. 📁
  • -l, --layer layer — layer name from configuration. Required. 🧚
  • -b, --bbox south west north east — bounding box in floating point geographic coordinates. Required. 🗺️

🔥 OPTIONS 🔥

  • -h, --help — show a summary of options. the classic. she never misses. 💅
  • -p, --padding padding — extra margin of tiles to add around the bounded area. default value is 0 (aka no extra tiles, we stay in our lane).
  • -e, --extension extension — optional file type for rendered tiles. default value is "png" for most image layers, and some variety of JSON for Vector or Mapnik Grid providers. iykyk. 🎀
  • -f, --progress-file file — optional JSON progress file that gets written on every single iteration, so you don't have to pay close attention. she's keeping notes so you don't have to. main character behavior fr. 📝
  • -q — suppress chatty output. and yes, --progress-file works well with this. 🤫
  • -i, --include-path — add the following colon-separated list of paths to Python's include path (aka sys.path). 🐍
  • -d, --output-directory — optional output directory for tiles, to override the configured cache with the equivalent of:
{"name": "Disk", "path": <output directory>, "dirs": "portable", "gzip": []}

More information in http://tilestache.org/doc/#caches. 🔗

  • --to-mbtiles — optional output file for tiles, will be created as an MBTiles 1.1 tileset. See http://mbtiles.org for more information. 🗃️
  • --from-mbtiles — optional input file for tiles, will be read as an MBTiles 1.1 tileset. See http://mbtiles.org for more information.
⚠️ Heads up bestie: this one overrides --extension, --bbox and --padding (this may change). so dramatic, she just takes over. 💀
  • --to-s3 — optional output bucket for tiles, will be populated with tiles in a standard Z/X/Y layout. Three required arguments: AWS access-key, secret, and bucket name. three whole arguments, she's demanding but she delivers. ☁️
  • --tile-list — optional file of tile coordinates, a simple text list of Z/X/Y coordinates. Overrides --bbox and --padding. 🗒️
  • --error-list — optional file of failed tile coordinates, a simple text list of Z/X/Y coordinates. If provided, failed tiles get logged to this file instead of stopping tilestache-seed. she forgives and moves on, growth. 🌱
  • --enable-retries — if true, this causes tilestache-seed to retry failed tile renderings up to (3) times. default value is False. she'll try again, but only three times, she has boundaries. 🔁
  • -x, --ignore-cached — re-render every tile, whether it's in the cache already or not. no shortcuts, no skipping, full send. 🔥
  • --jsonp-callback — add a JSONP callback for tiles with a json mime-type, causing "*.js" tiles to be written to the cache wrapped in the callback function. Ignored for non-JSON tiles. she only does this for the json girlies. ✨

🌈 SEE ALSO 🌈

💌 AUTHOR 💌

TileStache was written by Michal Migurski <mike@stamen.com>. legend behavior honestly.

This manual page was written by David Paleino <dapal@debian.org>, for the Debian project (and may be used by others). slay 🎀

and that's the whole page bestie!! 🦋 this lil writeup is from the TILESTACHE-SEED(1) manual, dated Nov 10, 2010 — yeah she's vintage, she's an elder, but she still eats. mwah 💋✨

📦 where this page comes from