These are the unofficial Python bindings for Hootenanny.
Hootenanny is an open source map data conflation tool developed with machine learning techniques to facilitate automated and semi-automated conflation of critical Foundation GEOINT features in the topographic domain. In short, it merges multiple maps into a single seamless map.
To call this alpha software would be generous. This wrapper aims to slowly wrap the parts of hoot that are requested and no more. A 1:1 mapping will be maintained where possible while accounting for Python conventions (e.g. snake_case). If you need a specific feature, please head on over to our GitHub repo and let us know.
To see a complete list of wrapped code type this from the command line:
python -c "import hoot; help(hoot.libpyhoot)"
Where appropriate conventions are converted from Hoot's c++ coding standard to typical Python
conventions. E.g. the method getChildWeight() is converted either to get_child_weight() or
a property named child_weight.
BEWARE: due to the early stages of this implementation, nearly no testing is run on this build of hoot. While we're using hoot source code, we may be using different versions of libraries which can sometimes have unexpected side effects. If you're running into a strange issue or crashes this is most likely due to pyhoot and should be reported to the pyhoot github first and we will escalate to the main hoot repo if needed.
As/if pyhoot matures and regression tests are put into place, these issues will go away.
Known Issues:
- GLPK gives an unexpected segfault so GLPK based optimization is disabled by default.
At this time, pyhoot is only available for Python 3.6.
Installing on CentOS 7:
sudo yum install libSM libX11 lzma-sdk-dev
python3 -m pip install hoot
The following python example conflates two sample files that come with pyhoot and writes the result
to out.osm.
import hoot
hoot.ConflateExecutor().conflate(hoot.TOY_TEST_A_PATH, hoot.TOY_TEST_B_PATH, "out.osm")
To see what classes and functions are available via pyhoot, use Python's help:
import hoot
help(hoot.libpyhoot)
Please see the Hootenanny documentation for detailed usage instructions.
pyhoot uses the same names but converts them to python style conventions. E.g. snake_case for functions.
For example, this C++ code:
Tags tags;
tags.set("name", "foo");
LOG_VAR(tags.getName());
Is equivalent to the following Python:
import hoot
tags = hoot.Tags()
tags["name"] = "foo"
print(tags.get_name())
The Hootenanny CLI is conveniently wrapped in a python call:
python -m hoot help