Watch the video above for a quick narrated overview of exporting in MapKnitter...
Public Lab is an open community which collaboratively develops accessible, open source, Do-It-Yourself technologies for investigating local environmental health and justice issues.
Public Lab chatroom
Reset your password
Watch the video above for a quick narrated overview of exporting in MapKnitter. For faster downloading, please see per-image exporting below.
Learn how to export your completed maps in GeoTiff, TMS/OpenLayers, and JPG formats, and how to tune your export resolution to optimize for size. Learn to use advanced options to see the range of possible resolutions, and avoid exporting at excessively high resolutions.
MapKnitter now features a per-image download which bypasses the sometimes tedious map exporting process. Instead of generating a full-size merged map, you can individually download images in their distorted state, using the button next to the image in the Images tab, as shown below. Note that generating the full-resolution download may take a little while depending on your computer's specs. This is made possible using the client-side webgl-distort module.
One consideration when using MapKnitter (especially since the 2.0 launch) is whether you need to export at all. Since you can now embed un-exported maps, and they can display dozens of images on even low-power computers or even smartphones, consider whether you need a full-resolution JPG or GeoTiff of your data, since it may take some time and require changes to your map. Of course, if you need to print the map, exporting is the way to go.
Choose a good export resolution with the slider under the "Advanced options" tab (as shown below); too high a resolution may stall the export if the resulting file is too big, while too low a resolution causes lots of processing to resize the images. A reasonable range for many balloon maps is 5-15 cm/px.
The default you'll see on the slider is the average resolution of the images you've laid out, but it rounds up to 5 cm/px if your images are too detailed. You can override this, however.
Also consider that if your images are from very different heights, some will have to be resized dramatically as they're all combined into a single-resolution composite. So it's easier for MapKnitter to process images which are at roughly the same resolution, which typically means roughly the same altitude.
Images of different sizes can force MapKnitter to do a lot of resizing and resampling, which can cause an export to fail.
If your map has very high resolution images, more than 20 images, or images which are far apart on the base map, the resulting output image might be huge. If one image is 10 megapixels, or 10,000,000 pixels, 30 of those could be 30 million, and if they're spaced out, that number could be a lot higher. MapKnitter can run out of memory, or just get stuck trying to create such a large output image.
Here are some things you can do:
Images spaced far apart can cause extremely large export sizes, and may fail.
Some exports are so big or high resolution, they just don't make it -- the computer runs out of memory, or just gets stuck trying to create such a large output image. We do have a script checking if exports get "too big" and cancelling those exports. See "My export takes forever" above to try reducing the size or complexity of your export.
If images were skipped or distorted incorrectly in your export, please contact email@example.com or -- if white edges appear displacing your map images (as shown below), please take a look at this bug report and add your input.