Package: campaign-planning-tool
campaign-planning-tool:Python library for planning and configuring scanning lidar measurement campaignsWhy campaign-planning-tool?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 tocampaign-planning-toollibrary, fascilitating 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!What campaign-planning-tool is capable of doing?campaign-planning-toolprovides users with a set of methods (read functions) that will allow them to:Optimize measurement positionsGenerate GIS layers which facilitate placement of lidarsOptimize and synchronize trajectories for multiple lidarsExport 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 backgroundpresentation 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!How can I get campaign-planning-tool?Through DTU hostedconda-forge!If you don't haveAnacondaorMinicondainstalled 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 --no-channel-priority campaign-planning-toolThis will create a new conda enviromentCPT, and download and installcampaign-planning-toollibrary 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 enviroment in the terminal:source activate CPTNow start the python editor of your choice, for examplejupyter:jupyter-notebookOnce injupyterimport the CPT class:from campaign_planning_tool import CPTand start using the library (using underscores to call library is not a mistake!).The library is fully documented so hithelpto get a class or class method description:help(CPT)
or
help(CPT.set_utm_zone)ExamplesWorking with a new library is always a bit of pain.To get you up with speed downloadJupyter examples.Soon the instructional videos will be available as well!Issues, Requests, Kudos and CursesIf 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.So far Windows user are currently facing an issue running methodexport_kml.Currently version 0.1.2 is under test which solves the reported issue.How to cite campaign-planning-toolIf you are usingcampaign-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.AcknowledgementWell deserved kudos go to awesome developers of following Python libraries that are an integrating part ofcampaign-planning-tool:whiteboxsrtm.pyrasteriogeopandasnumpypandaspillowdicttoxmlsimplekmlpyyamlmatplotlibjupyterpylintas well to the members ofRECASTproject:Andrea Vignaroli(DTU),Andreas Bechmann(DTU),Rozenn Wagner(DTU) andMorten Thøgersen(EMD) who helped in crafting the methodology, and not to forgetNeil Davis(DTU) who helped making the library available throughconda-forge.Licensecampaign-planning-tool is provided under theBSD-3-Clauselicense.ContactNikola Vasiljević,niva@dtu.dk