Caveink is a set of Inkscape extensions for drawing cave maps.
It is developed from my similar, previous project that is already well tested and has been used to produce many beautiful drawings. However, as of now, it is still work in progress in an early stage. The functions described below are there and - principally - work, but need extensive testing. Any help in that is appreciated.
DISCLAIMER: These extensions have not yet been extensively tested. It means that all that is described here may not work for you, make your Inkscape crash or make it run painfully slow. Do not use the methods described here for any serious work. It is all not yet ready for that.
If you are using Microsoft Windows, it is easiest to use the self-extracting installer: Inkscape-0.91-1.exe. It installs both Inkscape and the extensions. Before running it, remove any former Inkscape versions from your system.
As an alternative, you can download just the extensions as a zip file: caveink-1.0beta1.zip. Copy files from the symbols, patterns, keys and extensions subdirectories into the relevant directories in your Inkscape installation directory (could be /usr/share/inkscape or C:\Program Files\Inkscape or something similar). You also have to install the SpeleoUIS3 font on your system (from fonts subdirectory in the archive) in order for the line styles to work.
caveink can help you ...
Import your paperless sketch from PocketTopo or any other paperless surveying software as a SVG file. Draw a clean copy of your sketch using standard Inkscape drawing tools, as well as the symbol library, fill patterns for carpeting areas and line styling.
Scan your paper sketch and load it into inkscape. Draw a clean copy using all the tools mentioned above. Mark where your stations are on the drawing. Process your survey data using Survex and morph your drawing to the real centerline.
After everyone has finished drawing their section in their own file, combine these files into one SVG document and merge fragments that are not intersecting. Find symbols of the same kind and make sure they are all uniformly styled.
Add offset windows to clearly show intersecting passages on your map. Generate a neat scalebar and coordinate-annotated grid. Split the drawing into multiple pages. Should you close a loop or find yourself using the wrong magnetic declination figure, load a new centerline and adjust your drawing automatically.
Even in the digital age, we still draw cave maps to scale. Zooming in or out is very difficult, because the symbols usually have to retain their sizes independently of the scale.
Because of that problem, you need to select your scale carefully at the very beginning of your work.
Generally, the more distinct objects you have in your drawing, the slower Inkscape responds.
With this in mind, if your five kilometer long cave is filled with sand, it is a very poor idea to indicate that fact with thousands of little circles. Better use the sand pattern fill. Being only a handful of distinct objects repeated many times, it is much faster for Inkscape to process!
When importing images (such as scans of paper sketches) into Inkscape, you are always asked whether to just Link to the included file in your drawing, or rather to Embed the image inside the SVG document. Always opt for linking!
It is about how Inkscape extensions internally work. Unfortunately, it is extremely simple: every time you use an extension, your whole drawing is saved in a temporary file and then passed to the selected extension for further processing.
Raster files are often very large, and embedding them into your drawing will result in a large amount of data being packed and unpacked every time you use one of the Extension / Speleo menu items. And this essentialy means you will have to wait longer!
Importing paperless sketches as vector graphics is very convenient. These sketches, however, usually contain an enormous amount of data that is not really useful after the sketch has been traced.
I am not suggesting to throw away these sketches! I just say that there is no point in keeping them in the clean copy file. If you need to fix an error or re-work something, you still have them in their original files - and you can always import them again.
Tutorials: Find and replace symbols, Steps and driplines, Morphing paper sketches, Merging drawings, Patterns for area fills, Fixing your map after closing a survey loop, Generating grids and scale bars, Caveink symbol library, Importing PocketTopo sketches into Inkscape, Clarifying overlapping passages, Splitting big drawings into pages
Reference: to be prepared (help appreciated!)
Files for tutorials and experiments: tutorial-files.zip
Mateusz Golicz, mateusz dot golicz on pza dot org pl