mapgis2shp: an open-source Python reader for the MapGIS 6.x/67 binary vector formats, validated against the native export
This paper introduces **mapgis2shp**, an open-source Python library that reverse-engineers the undocumented MapGIS 6.x/67 binary vector formats to convert them into standard geospatial data, achieving near-perfect validation against the proprietary software's native export in terms of geometry, attributes, and coordinate reference systems.
Original paper licensed under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). This is an AI-generated explanation of the paper below. It is not written or endorsed by the authors. For technical accuracy, refer to the original paper. Read full disclaimer
Imagine the world of digital maps as a giant, bustling library where every country keeps its own secret collection of books. Some of these books are written in a language everyone knows, like English or Spanish, so anyone can walk in and read them. But others are written in a secret code that only the library's owner understands. In the world of geography, this "secret code" is a file format. For decades, a massive amount of China's geological data—maps showing rocks, minerals, and underground water—has been locked inside a specific type of digital file called MapGIS. These files are like treasure chests that only one specific, expensive software key can open. If you don't have that key, the data is invisible to the rest of the world, trapped in a digital vault.
To understand why this matters, think of a "vector" as a drawing made of math. Instead of a blurry photograph, a vector map is a set of instructions: "Draw a line from point A to point B," or "Fill this circle with blue." These instructions are incredibly precise and can be zoomed in on forever without losing quality. However, if the instructions are written in a secret language, you can't use them with modern, free tools that scientists and students love to use. This paper tackles the problem of that locked library. It asks: Can we figure out the secret code without the original key? Can we build a new, open tool that translates these locked files into a language everyone understands, while making sure we don't accidentally change the map's shape or lose any of the precious details inside?
The authors of this paper, a team of geologists and software developers, have built a new open-source tool called mapgis2shp (which you can also call pymapgis if you are a computer programmer). Think of this tool as a master translator and a digital locksmith combined. Its job is to take those locked MapGIS files (which end in .wt, .wl, and .wp) and turn them into a universal format called a Shapefile, which can be opened by almost any mapping software in the world. But the team didn't just want to guess how the code worked; they wanted to prove they got it right.
To do this, they performed a massive "taste test." They took 36 real-world geological maps from the field and ran them through their new translator. Then, they took the exact same maps and opened them with the official, expensive MapGIS software to see what the "correct" version looked like. The results were astonishingly precise. For the 16,874 features (like individual rock lines or mineral points) they checked, the new tool produced maps that were geometrically identical to the official ones. If you were to lay the two maps on top of each other, they would match perfectly, with differences so small they are smaller than a single pixel on a screen.
Even more impressively, the new tool actually did a better job than the official software in some ways. The official software, when saving these maps, sometimes accidentally "rounds off" numbers, turning a very precise measurement like 0.6218423 into a less precise 0.62. It also sometimes deletes extra spaces in text that were originally there. The new mapgis2shp tool, however, keeps every single digit and every single space exactly as they were in the original secret file. It's like a photocopier that doesn't just copy the text, but also preserves the exact ink density and paper texture.
The team also solved a mystery that the official software leaves behind: the coordinate system. Imagine a map without a compass or a grid; you know what the land looks like, but you don't know exactly where it is on Earth. The official software often forgets to save this "where" information when it converts files. The new tool, however, reads the secret codes inside the file to figure out the exact location and adds a digital compass back in, ensuring the map knows it belongs to a specific spot on Earth.
To make sure this wasn't just a fluke with small maps, the team tested their tool on a gigantic file weighing 400 megabytes, containing nearly 79,000 features. Even with this huge dataset, the new tool matched the official software's coverage area with 99.73% accuracy. The tiny differences that did exist were due to the way the tool connects lines to form shapes, but even then, the actual land area covered was almost exactly the same.
In short, this paper presents a tool that unlocks a massive library of Chinese geological data, translating it from a secret code into a language everyone can read. It doesn't just open the door; it ensures that the treasure inside is preserved with even greater care than the original owner did. By making this tool free and open to everyone, the authors have allowed scientists, students, and curious minds to finally explore these hidden maps without needing to buy the expensive key, paving the way for new discoveries and better sharing of Earth's secrets.
Drowning in papers in your field?
Get daily digests of the most novel papers matching your research keywords — with technical summaries, in your language.