AFwizard is a Python package to enhance the productivity of ground point filtering workflows in archaeology and beyond. It provides a Jupyter-based environment for "human-in-the-loop" tuned, spatially heterogeneous ground point filterings. Core features:
- Working with Lidar datasets directly in Jupyter notebooks
- Loading/Storing of LAS/LAZ files
- Visualization using hillshade models and slope maps
- Applying of ground point filtering algorithms
- Cropping with a map-based user interface
- Accessibility of existing filtering algorithms under a unified data model:
- Access to predefined filter pipeline settings
- Crowd-sourced library of filter pipelines at https://github.com/ssciwr/afwizard-library/
- Filter definitions can be shared with colleagues as files
- Spatially heterogeneous application of filter pipelines
- Assignment of filter pipeline settings to spatial subregions in map-based user interface
- Command Line Interface for large scale application of filter pipelines
The documentation of AFwizard can be found here: https://afwizard.readthedocs.io/en/latest
In order to work with AFwizard, you need the following required pieces of Software.
If you want to use the respective backends, you also need to install the following pieces of software:
Having a local installation of Conda, the following sequence of commands sets up a new Conda environment and installs afwizard into it:
conda create -n afwizard
conda activate afwizard
conda install -c conda-forge/label/afwizard_dev -c conda-forge -c conda-forge/label/ipywidgets_rc -c conda-forge/label/jupyterlab_widgets_rc -c conda-forge/label/widgetsnbextension_rc afwizard
You can start the JupyterLab frontend by doing:
conda activate afwizard
jupyter lab
If you need some example notebooks to get started, you can copy them into the current working directory like this:
conda activate afwizard
copy_afwizard_notebooks
If you are intending to contribute to the development of the library, we recommend the following setup:
git clone https://github.com/ssciwr/afwizard.git
cd afwizard
conda env create -f environment-dev.yml --force
conda run -n afwizard-dev python -m pip install --no-deps .
You can try AFwizard without prior installation by using Binder, which is a free cloud-hosted service to run Jupyter notebooks. This will give you an impression of the library's capabilities, but you will want to work on a local setup when using the library productively: On Binder, you might experience very long startup times, slow user experience and limitations to disk space and memory.
Having set up Docker, you can use AFwizard directly from a provided Docker image:
docker run -t -p 8888:8888 ssciwr/afwizard:latest
Having executed above command, paste the URL given on the command line into your browser and start using AFwizard by looking at the provided Jupyter notebooks. This image is limited to working with non-proprietary filtering backends (PDAL only).
We advise you to use Conda as AFwizard depends on a lot of other Python packages, some of which have external C/C++ dependencies. Using Conda, you get all of these installed automatically, using pip you might need to do a lot of manual work to get the same result.
That being said, afwizard can be installed from PyPI:
python -m pip install afwizard
If you run into problems using AFwizard, we kindly ask you to do the following in this order:
- Have a look at the list of our Frequently Asked Questions for a solution
- Search through the GitHub issue tracker
- Open a new issue on the GitHub issue tracker providing
- The version of
afwizardused - Information about your OS
- The output of
conda liston your machine - As much information as possible about how to reproduce the bug
- If you can share the data that produced the error, it is much appreciated.
- The version of