A curated list of open technology projects to sustain a stable climate, energy supply, biodiversity and natural resources.

lidarwind

Retrieve wind speed and direction profiles from Doppler lidar observations from the WindCube-200s.
https://github.com/jdiasn/lidarwind

Category: Renewable Energy
Sub Category: Wind Energy

Last synced: about 9 hours ago
JSON representation

Repository metadata

Wind retrievals for the WindCube lidar

README.rst

          ======================
lidarwind introduction
======================

.. image:: https://joss.theoj.org/papers/28430a0c6a79e6d1ff33579ff13458f7/status.svg
   :target: https://doi.org/10.21105/joss.04852

.. image:: https://zenodo.org/badge/DOI/10.5281/zenodo.7026548.svg
   :target: https://doi.org/10.5281/zenodo.7026548

.. image:: https://readthedocs.org/projects/lidarwind/badge/?version=latest
    :target: https://lidarwind.readthedocs.io/en/latest/?badge=latest
    :alt: Documentation Status

.. image:: https://mybinder.org/badge_logo.svg
   :target: https://mybinder.org/v2/gh/jdiasn/lidarwind/main?labpath=docs%2Fexamples

.. image:: https://img.shields.io/pypi/v/lidarwind.svg
   :target: https://pypi.python.org/pypi/lidarwind/

.. image:: https://codecov.io/gh/jdiasn/lidarwind/branch/main/graph/badge.svg?token=CEZM17YY3I
   :target: https://codecov.io/gh/jdiasn/lidarwind


.. note::
    Now lidarwind supports data from RPG cloud radars. If you are interested, have a look at Radar usage section.


lidarwind is an open-source Python project that retrieves wind speed and direction profiles from Doppler velocity observations recorded by Doppler-capable instruments. Initially, this package was developed to work with observations from the WindCube-200s lidar, but with this new release, lidarwind starts to support data from RPG Cloud Radars. Currently, It can retrieve wind profiles from the PPI, 6-beam and DBS scanning strategies and calculate the Reynolds stress tensor matrix elements from the 6-beam observation. The package can be further extended to process data from other Doppler lidar and radar and from other scanning strategies.

lidarwind results from an effort to create a flexible and easy-to-use package to process observations recorded by the WindCube Doppler lidar. The package development started in 2021 when I had to retrieve wind profiles from the 6-beam observations.


--------
Citation
--------

If you use lidarwind, or replicate part of it, in your work/package, please consider including the reference:

Neto, J. D. and Castelão, G. P., (2023). lidarwind: A Python package for retrieving wind profiles from Doppler lidar observations. Journal of Open Source Software, 8(82), 4852, https://doi.org/10.21105/joss.04852

::

  @article{Neto2023,
  doi = {10.21105/joss.04852},
  url = {https://doi.org/10.21105/joss.04852},
  year = {2023}, publisher = {Journal of Open Source Software},
  volume = {8}, number = {82}, pages = {4852},
  author = {José Dias Neto and Guilherme P. Castelao},
  title = {lidarwind: A Python package for retrieving wind profiles from Doppler lidar observations},
  journal = {Journal of Open Source Software}
  }



-------------
Documentation
-------------

The lidarwind's documentation is available at https://lidarwind.readthedocs.io. There you can find the steps needed for installing the package. You can also find a short description of how lidarwind derives the wind speed and direction from observations.


Notebooks
=========

An introductory set of rendered notebooks are available at https://nbviewer.org/github/jdiasn/lidarwind/tree/main/docs/examples/ or at https://github.com/jdiasn/lidarwind/tree/main/docs/examples. If you want to try the package without installing it locally, click on the binder badge above. You will be redirected to a virtual environment where you can also access the same notebooks and test the package.

.. warning::

    Beware that between versions 0.1.6 and 0.2.0, the package underwent significant refactoring. Now the classes' names
    follow the Pascal case, while module names, functions and attributes follow the snake case. Codes developed using the previous
    version will need revision.

        

Citation (CITATION.cff)

cff-version: 1.1.0
message: If you use this software, please cite it using these metadata.
title: 'A python package for retrieving wind profiles from Doppler lidar observations'
authors:
- given-names: José
  family-names: Dias Neto
  affiliation: Delft University of Technology - The Netherlands
  orcid: https://orcid.org/0000-0002-8488-8486
- given-names: Guilherme
  family-names: Castelao
  affiliation: Scripps Institution of Oceanography - UC San Diego
  orcid: https://orcid.org/0000-0002-6765-0708
version: 0.1.4
doi: 10.5281/zenodo.7026548
repository-code: https://github.com/jdiasn/lidarwind
license: BSD-3-Clause

Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: 7 days ago

Total Commits: 173
Total Committers: 3
Avg Commits per committer: 57.667
Development Distribution Score (DDS): 0.075

Commits in past year: 23
Committers in past year: 1
Avg Commits per committer in past year: 23.0
Development Distribution Score (DDS) in past year: 0.0

Name Email Commits
Dias Neto j****n@g****m 160
Guilherme Castelão g****e@c****t 12
Jose Dias Neto j****e@s****l 1

Committer domains:


Issue and Pull Request metadata

Last synced: 1 day ago

Total issues: 13
Total pull requests: 98
Average time to close issues: 4 months
Average time to close pull requests: 3 days
Total issue authors: 5
Total pull request authors: 3
Average comments per issue: 2.0
Average comments per pull request: 0.99
Merged pull request: 95
Bot issues: 0
Bot pull requests: 2

Past year issues: 0
Past year pull requests: 2
Past year average time to close issues: N/A
Past year average time to close pull requests: 12 days
Past year issue authors: 0
Past year pull request authors: 1
Past year average comments per issue: 0
Past year average comments per pull request: 2.0
Past year merged pull request: 2
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/jdiasn/lidarwind

Top Issue Authors

  • tgoelles (4)
  • StevenKnoopKNMI (3)
  • jdiasn (3)
  • acocac (2)
  • bgailleton (1)

Top Pull Request Authors

  • jdiasn (84)
  • castelao (12)
  • dependabot[bot] (2)

Top Issue Labels

Top Pull Request Labels

  • dependencies (2)

Package metadata

pypi.org: lidarwind

LIDAR procedures

  • Homepage:
  • Documentation: https://lidarwind.readthedocs.io/
  • Licenses: BSD License Copyright (c) 2022, Jose Dias Neto All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. * Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  • Latest release: 1.0.1 (published 6 months ago)
  • Last Synced: 2025-04-26T12:03:33.884Z (1 day ago)
  • Versions: 6
  • Dependent Packages: 0
  • Dependent Repositories: 1
  • Downloads: 279 Last month
  • Rankings:
    • Dependent packages count: 10.126%
    • Dependent repos count: 21.535%
    • Average: 23.471%
    • Downloads: 38.754%
  • Maintainers (1)

Dependencies

requirements_dev.txt pypi
  • Click ==7.1.2 development
  • Sphinx ==1.8.5 development
  • black ==21.7b0 development
  • bump2version ==0.5.11 development
  • coverage ==4.5.4 development
  • flake8 ==3.7.8 development
  • pip ==21.1 development
  • pytest ==6.2.4 development
  • tox ==3.14.0 development
  • twine ==1.14.0 development
  • watchdog ==0.9.0 development
  • wheel ==0.33.6 development
.github/workflows/ci.yml actions
  • actions/cache v3 composite
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
  • codecov/codecov-action v3 composite
.github/workflows/tox.yml actions
  • actions/cache v3 composite
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
  • codecov/codecov-action v3 composite
pyproject.toml pypi
  • click >=8.1.2
  • gdown ~=4.5.1
  • matplotlib >=3.4.3
  • netCDF4 >= 1.5
  • numpy >=1.22
  • pandas >=1.3.3
  • xarray >=0.20
  • xarray-datatree ==0.0.9
  • xrft >=0.3.0
setup.py pypi
docs/environment.yml pypi
  • gdown *
  • lidarwind *
  • pooch *
  • xrft *
docs/requirements.pip pypi
  • gdown *
  • matplotlib *
  • nbsphinx *
  • numpy *
  • pandas *
  • pooch *
  • sphinx *
  • sphinx-gallery *
  • sphinx_rtd_theme *
  • xarray *
  • xarray-datatree *
  • xrft *
environment.yml pypi
  • gdown ==4.5.1
  • lidarwind ==0.2.4
  • pooch ==1.6.0

Score: 9.570180302058072