campaign-planning-tool:
Python library for planning and configuring scanning lidar measurement campaigns
Planning scanning lidar measurement campaigns is not a trivial task. There are many constraints, originating both from the campaign site as well from the lidar technology, which a campaign planner needs to consider to derive the best possible layout of the campaign. The same can be said for configuring scanning lidars to acquire high-quality measurements.
These tasks have been typically done ad-hoc and manually, thus requiring lidar expertize. However, since 2018 a work has been put to digitalize these processes, making them simpler for end-users.
After almost a decade of planning and configuring scanning lidar measurement campaigns, the accumulated experience and knowledge has been converted to campaign-planning-tool library, facilitating the above mentioned tasks.
You don't need to be a scanning lidar expert anymore to design and configure scanning lidar campaigns!!!
That burden has been eliminated now, or at least that's the hope!
campaign-planning-tool provides users with a set of methods (read functions) that will allow them to:
- Optimize measurement positions
- Generate GIS layers which facilitate placement of lidars
- Optimize and synchronize trajectories for multiple lidars
- Export results in human and machine readable formats (KML, XML, YAML, etc.)
- and more ...
...and this is only the beginning !
For more details check out a:
- paper that describes the campaign-planning-tool background
- presentation from the WESC conference in Cork.
With every new version of the library new functionalities will be aded, and this is where you as a community of users can help!
If you don't have Anaconda or Miniconda installed on your computer you should install either of them first.
Afterwards, copy and execute the following command in the terminal:
conda create -n CPT -c https://conda.windenergy.dtu.dk/channel/open -c conda-forge campaign-planning-tool rasterio=1.0.28
This will create a new conda enviroment CPT, and download and install campaign-planning-tool library together with all the dependencies. Feel free to change the name of the environment to whatever name it suites you (i.e., simply change CPT to something else).
Following the installation you need to activate newly made environment in the terminal:
conda activate CPT
Now start the python editor of your choice, for example jupyter:
jupyter-notebook
Once in jupyter import the CPT class:
from campaign_planning_tool import CPT
and start using the library (using underscores to call library is not a mistake!).
The library is fully documented so hit help to get a class or class method description:
help(CPT)
or
help(CPT.set_utm_zone)
Working with a new library is always a bit of pain.
To get you up with speed download Jupyter examples.
If you have issues running campaign-planning-tool or you have requests or by any chance you want to contribute to the further development of the library please post Issues or make Pull requests on Github.
If you are using campaign-planning-tool, it would be great to cite this repository as well the paper which describes methodology which was used to develop the library:
*repository*
Nikola Vasiljevic. (2019, August 28).
campaign-planning-tool v0.1.3
Zenodo. http://doi.org/10.5281/zenodo.3462049 Sep 26, 2019
*paper*
Vasiljević, N., Vignaroli, A., Bechmann, A., and Wagner, R.:
Digitalization of scanning lidar measurement campaign planning,
Wind Energ. Sci. Discuss., in review, 2019.
Well deserved kudos go to awesome developers of following Python libraries that are an integrating part of campaign-planning-tool:
- whitebox
- srtm.py
- rasterio
- geopandas
- numpy
- pandas
- pillow
- dicttoxml
- simplekml
- pyyaml
- matplotlib
- jupyter
- pylint
as well to the members of RECAST project: Andrea Vignaroli (DTU), Andreas Bechmann (DTU), Rozenn Wagner (DTU) and Morten Thøgersen (EMD) who helped in crafting the methodology, and not to forget Neil Davis (DTU) who helped making the library available through DTU Wind Energy's conda channel.
campaign-planning-tool is provided under the BSD-3-Clause license.