Provides numba framework for topographic analysis within the LSDTopoTools ecosystem. It aims to provdide full python access to the main algorithms of LSDTopoTools while avoiding the neeeds of c++. It does not replace or provide numba portage of the full LSDTopoTools, just the main one for quick use or quick developments
DISCLAIMER: early and WIP, do not use if you don’t know what you are doing!
Provides numba framework for topographic analysis within the LSDTopoTools ecosystem. It aims to provdide full python access to the main algorithms of LSDTopoTools while avoiding the neeeds of c++. It does not replace or provide numba portage of the full LSDTopoTools, just the main one for quick use or quick developments. The data structure is heavily based on xarray.
License: Free software: MIT license
Numba is a Just-in-time (JIT) compiler for python code, which means that it translates at runtime some pieces of code into assembly language using LLVM engine. It has the power to make some python functions as performant as C code under few conditions. Although it does not allow as much flexibility and power as C++ does, it is powerful enough for function with simple data-structure (numpy arrays). The huge advantage is that it fits in the interpreted python language and allow very quick development/debugging/distribution of code without the need of compiling for different platform and making bindings between python and C, making it an ideal tool for (i) testing algorithms before implementing them in heavier languages and (ii) develop a light version of the LSDTopoTools framework usable in full-python when the full stack of LSDTopoTools are not needed.
### Node graph
So far I mostly worked on the node graph object, which build on demand neighbouring info (Queen, King); single (Braun et al. 2013) and multiple (see fastscapelib-fortran](https://github.com/fastscape-lem/fastscapelib-fortran) ) flow topological order, and periodic/closed boundary conditions.
If I start using this package more seriously, I will make a conda-forge package. Otherwise, clone this repository, and install the following dependencies: numba, numpy, matplotlib, pandas and it should do the trick. I recommend using conda as python environment manager.
## Quick Start
As a quick start, I added a jupyter notebook in the notebook folder.
Contact: Boris Gailleton (email@example.com)
- First release on PyPI.
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Hashes for lsdnumbatools-0.0.5-py2.py3-none-any.whl