{"id":34834329,"url":"https://github.com/ltelab/disdrodb","last_synced_at":"2026-02-04T01:15:44.533Z","repository":{"id":37777608,"uuid":"429018433","full_name":"ltelab/disdrodb","owner":"ltelab","description":"An open-source python software for standardized processing, sharing, and analysis of disdrometer data","archived":false,"fork":false,"pushed_at":"2026-01-26T17:22:03.000Z","size":64828,"stargazers_count":25,"open_issues_count":3,"forks_count":11,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-27T05:35:23.829Z","etag":null,"topics":["disdrometer","disdrometer-data","dsd","hydrometeors","meteorology","parsivel","parsivel-data","precipitation","psd","radar","rainfall","remote-sensing","snowfall","t-matrix"],"latest_commit_sha":null,"homepage":"https://disdrodb.readthedocs.io/en/latest/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ltelab.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.rst","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":"AUTHORS.md","dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2021-11-17T11:27:59.000Z","updated_at":"2026-01-02T09:11:51.000Z","dependencies_parsed_at":"2023-02-17T18:15:38.578Z","dependency_job_id":"8215de33-e382-489d-acbc-0f12ef228890","html_url":"https://github.com/ltelab/disdrodb","commit_stats":null,"previous_names":[],"tags_count":24,"template":false,"template_full_name":null,"purl":"pkg:github/ltelab/disdrodb","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ltelab%2Fdisdrodb","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ltelab%2Fdisdrodb/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ltelab%2Fdisdrodb/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ltelab%2Fdisdrodb/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ltelab","download_url":"https://codeload.github.com/ltelab/disdrodb/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ltelab%2Fdisdrodb/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29063682,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-04T00:26:14.114Z","status":"ssl_error","status_checked_at":"2026-02-04T00:23:06.435Z","response_time":96,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["disdrometer","disdrometer-data","dsd","hydrometeors","meteorology","parsivel","parsivel-data","precipitation","psd","radar","rainfall","remote-sensing","snowfall","t-matrix"],"created_at":"2025-12-25T15:59:46.339Z","updated_at":"2026-02-04T01:15:44.528Z","avatar_url":"https://github.com/ltelab.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📦 disdrodb\n\nAn open-source python software for standardized processing, sharing, and analysis of disdrometer data\n\n|                   |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |\n| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| Deployment        | [![PyPI](https://badge.fury.io/py/disdrodb.svg?style=flat)](https://pypi.org/project/disdrodb/) [![Conda](https://img.shields.io/conda/vn/conda-forge/disdrodb.svg?logo=conda-forge\u0026logoColor=white\u0026style=flat)](https://anaconda.org/conda-forge/disdrodb)                                                                                                                                                                                                                                                                                                                                                                        |\n| Activity          | [![PyPI Downloads](https://img.shields.io/pypi/dm/disdrodb.svg?label=PyPI%20downloads\u0026style=flat)](https://pypi.org/project/disdrodb/) [![Conda Downloads](https://img.shields.io/conda/dn/conda-forge/disdrodb.svg?label=Conda%20downloads\u0026style=flat)](https://anaconda.org/conda-forge/disdrodb)                                                                                                                                                                                                                                                                                                                                |\n| Python Versions   | [![Python Versions](https://img.shields.io/badge/Python-3.11%20%203.12%20%203.13%20%203.14-blue?style=flat)](https://www.python.org/downloads/)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |\n| Supported Systems | [![Linux](https://img.shields.io/github/actions/workflow/status/ltelab/disdrodb/.github/workflows/tests.yml?label=Linux\u0026style=flat)](https://github.com/ltelab/disdrodb/actions/workflows/tests.yml) [![macOS](https://img.shields.io/github/actions/workflow/status/ltelab/disdrodb/.github/workflows/tests.yml?label=macOS\u0026style=flat)](https://github.com/ltelab/disdrodb/actions/workflows/tests.yml) [![Windows](https://img.shields.io/github/actions/workflow/status/ltelab/disdrodb/.github/workflows/tests_windows.yml?label=Windows\u0026style=flat)](https://github.com/ltelab/disdrodb/actions/workflows/tests_windows.yml) |\n| Project Status    | [![Project Status](https://www.repostatus.org/badges/latest/active.svg?style=flat)](https://www.repostatus.org/#active)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |\n| Build Status      | [![Tests](https://github.com/ltelab/disdrodb/actions/workflows/tests.yml/badge.svg?style=flat)](https://github.com/ltelab/disdrodb/actions/workflows/tests.yml) [![Lint](https://github.com/ltelab/disdrodb/actions/workflows/lint.yml/badge.svg?style=flat)](https://github.com/ltelab/disdrodb/actions/workflows/lint.yml) [![Docs](https://readthedocs.org/projects/disdrodb/badge/?version=latest\u0026style=flat)](https://disdrodb.readthedocs.io/en/latest/)                                                                                                                                                                     |\n| Linting           | [![Black](https://img.shields.io/badge/code%20style-black-000000.svg?style=flat)](https://github.com/psf/black) [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json\u0026style=flat)](https://github.com/astral-sh/ruff) [![Codespell](https://img.shields.io/badge/Codespell-enabled-brightgreen?style=flat)](https://github.com/codespell-project/codespell)                                                                                                                                                                                                      |\n| Code Coverage     | [![Coveralls](https://coveralls.io/repos/github/ltelab/disdrodb/badge.svg?branch=main\u0026style=flat)](https://coveralls.io/github/ltelab/disdrodb?branch=main) [![Codecov](https://codecov.io/gh/ltelab/disdrodb/branch/main/graph/badge.svg?style=flat)](https://codecov.io/gh/ltelab/disdrodb)                                                                                                                                                                                                                                                                                                                                      |\n| Code Quality      | [![Codefactor](https://www.codefactor.io/repository/github/ltelab/disdrodb/badge?style=flat)](https://www.codefactor.io/repository/github/ltelab/disdrodb) [![Codacy](https://app.codacy.com/project/badge/Grade/d823c50a7ad14268bd347b5aba384623?style=flat)](https://app.codacy.com/gh/ltelab/disdrodb/dashboard?utm_source=gh\u0026utm_medium=referral\u0026utm_content=\u0026utm_campaign=Badge_grade) [![Codescene](https://codescene.io/projects/36773/status-badges/code-health?style=flat)](https://codescene.io/projects/36773)                                                                                                          |\n| License           | [![License](https://img.shields.io/github/license/ltelab/disdrodb?style=flat)](https://github.com/ltelab/disdrodb/blob/main/LICENSE)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |\n| Community         | [![Slack](https://img.shields.io/badge/Slack-disdrodb-green.svg?logo=slack\u0026style=flat)](https://join.slack.com/t/disdrodbworkspace/shared_invite/zt-25l4mvgo7-cfBdXalzlWGd4Pt7H~FqoA) [![GitHub Discussions](https://img.shields.io/badge/GitHub-Discussions-green?logo=github\u0026style=flat)](https://github.com/ltelab/disdrodb/discussions)                                                                                                                                                                                                                                                                                        |\n| Citation          | [![DOI](https://zenodo.org/badge/429018433.svg?style=flat)](https://zenodo.org/doi/10.5281/zenodo.7680581)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |\n\n[**Slack**](https://join.slack.com/t/disdrodbworkspace/shared_invite/zt-25l4mvgo7-cfBdXalzlWGd4Pt7H~FqoA) | [**Documentation**](https://disdrodb.readthedocs.io/en/latest/)\n\nDISDRODB is an international joint effort to index, collect and homogenize drop size distribution (DSD) data from around the world.\nDISDRODB aims to establish a global standard for sharing disdrometer observations.\nBuilt on FAIR data principles and Climate \u0026 Forecast (CF) conventions, DISDRODB standards facilitate the processing, analysis and visualization of disdrometer data.\n\n## ℹ️ Software Overview\n\nThe software enables you to:\n\n- Upload raw data of new disdrometer stations to the DISDRODB Decentralized Data Archive\n\n- Download the raw disdrometer data from stations included in the DISDRODB Decentralized Data Archive\n\n- Convert raw disdrometer data into a standard NetCDF format (DISDRODB L0 product)\n\n- Generate standardized, homogenized, and quality-checked disdrometer measurements (DISDRODB L1 product)\n\n- Compute empirical and model-based drop size distribution parameters and derive geophysical and polarimetric radar variables of interest (DISDRODB L2 product)\n\nIf you have ideas, algorithms, data, or expertise to share, or you want to contribute to the future DISDRODB products, do not hesitate to get in touch!!!\n\nJoin the [**DISDRODB Slack Workspace**](https://join.slack.com/t/disdrodbworkspace/shared_invite/zt-25l4mvgo7-cfBdXalzlWGd4Pt7H~FqoA) to meet the DISDRODB Community!\n\n## 🚀 Quick Start\n\nCreate your own DISDRODB Local Data Archive.\n\n### 📚 Download the DISDRODB Metadata Archive\n\nThe DISDRODB Metadata Archive is a collection of metadata files that describe the disdrometer stations included in DISDRODB.\n\nTo download the DISDRODB Metadata Archive, navigate to the desired directory and run:\n\n```bash\ngit clone https://github.com/ltelab/DISDRODB-METADATA.git\n```\n\nOr download a static snapshot without using git:\n\n```bash\ndisdrodb_download_metadata_archive /path/to/DISDRODB-METADATA\n```\n\n### 📚 Define the DISDRODB Configuration File\n\nThe disdrodb software requires to know two directories:\n\n- `metadata_archive_dir`: the base of your local DISDRODB Metadata Archive\n- `data_archive_dir`: the base of your local DISDRODB Data Archive\n\nOn Windows, paths must end with `\\DISDRODB`; on macOS/Linux, they must end with `/DISDRODB`.\n\n```python\nimport disdrodb\n\nmetadata_archive_dir = \"/\u003cpath_to\u003e/DISDRODB-METADATA/DISDRODB\"\ndata_archive_dir = \"/\u003cpath_to\u003e/DISDRODB\"\ndisdrodb.define_configs(\n    metadata_archive_dir=metadata_archive_dir, data_archive_dir=data_archive_dir\n)\n```\n\nThis creates a `.config_disdrodb.yml` file in your home directory (e.g., `~/.config_disdrodb.yml`).\n\nTo verify the configuration, open a new Python session and run:\n\n```python\nimport disdrodb\n\nprint(\"Metadata Archive Directory:\", disdrodb.get_metadata_archive_dir())\nprint(\"Data Archive Directory:\", disdrodb.get_data_archive_dir())\n```\n\nOr in the shell:\n\n```bash\ndisdrodb_metadata_archive_directory\ndisdrodb_data_archive_directory\n```\n\n### 📥 Download the DISDRODB Raw Data Archive\n\nTo download all data stored into the DISDRODB Decentralized Data Archive,\nyou just have to run the following command:\n\n```bash\ndisdrodb_download_archive\n```\n\nTo download from a specific source (e.g., EPFL):\n\n```bash\ndisdrodb_download_archive --data-sources EPFL\n```\n\nType `disdrodb_download_archive --help` to see further options.\n\nTo open the local DISDRODB Data Archive directory, type:\n\n```bash\ndisdrodb_open_data_archive\n```\n\n### 💫 Transform Raw Data to Standardized netCDFs\n\nIf you want to convert all stations raw data into standardized netCDF4 files, run the following command in the terminal:\n\n```bash\ndisdrodb_run_l0\n```\n\nType `disdrodb_run_l0 --help` to see further options.\n\n### 💫 Generate DISDRODB L1 and p2 products\n\nTo generate DISDRODB L1 and L2 products, run the following commands in the terminal:\n\n```bash\ndisdrodb_run_l1\ndisdrodb_run_l2e\ndisdrodb_run_l2m\n```\n\n### 💫 Analyze Analysis-Ready Products\n\nThe software's `open_dataset` function **lazily** opens all station files of a given product:\n\n```python\nimport disdrodb\n\nds = disdrodb.open_dataset(\n    product=\"L0C\",\n    data_source=\"EPFL\",\n    campaign_name=\"HYMEX_LTE_SOP3\",\n    station_name=\"10\",\n)\nds\n```\n\nThis allows you to jump directly into analyzing disdrometer data without worrying about processing steps.\n\n### 💫 Explore the DISDRODB Metadata Archive\n\nTo explore the DISDRODB Metadata Archive, you can type into the terminal:\n\n```bash\ndisdrodb_open_metadata_archive\n```\n\nIf you wish to analyze the DISDRODB Metadata Archive information of all stations,\nthe `read_metadata_archive` python function returns all stations metadata information into an easy to analyze `pandas.DataFrame`:\n\n```python\nimport disdrodb\n\ndf = disdrodb.read_metadata_archive()\nprint(df)\n```\n\n## 📖 Explore the DISDRODB documentation\n\nWith this introduction, we just scratched the surface of the disdrodb software capabilities.\nTo discover more about the DISDRODB products, the download and processing options, or how to contribute your own data to DISDRODB,\nplease read the software documentation available at [https://disdrodb.readthedocs.io/en/latest/](https://disdrodb.readthedocs.io/en/latest/).\n\n## 🛠️ Installation\n\n### conda\n\nDISDRODB can be installed via [conda][conda_link] on Linux, Mac, and Windows.\nInstall the package by typing the following command in the terminal:\n\n```bash\nconda install disdrodb\n```\n\nIn case conda-forge is not set up for your system yet, see the easy to follow instructions on [conda-forge][conda_forge_link].\n\n### pip\n\nDISDRODB can be installed also via [pip][pip_link] on Linux, Mac, and Windows.\nOn Windows you can install [WinPython][winpy_link] to get Python and pip running.\n\nThen, install the DISDRODB package by typing the following command in the terminal:\n\n```bash\npip install disdrodb\n```\n\nTo install the latest development version via pip, see the [documentation][dev_install_link].\n\n## 💭 Feedback and Contributing Guidelines\n\nIf you aim to contribute your data or discuss the future development of DISDRODB,\nwe highly recommend to join the [**DISDRODB Slack Workspace**](https://join.slack.com/t/disdrodbworkspace/shared_invite/zt-25l4mvgo7-cfBdXalzlWGd4Pt7H~FqoA)\n\nFeel free to also open a [GitHub Issue](https://github.com/ltelab/disdrodb/issues) or a\n[GitHub Discussion](https://github.com/ltelab/disdrodb/discussions) specific to your questions or ideas.\n\n## ✍️ Contributors\n\n- [Gionata Ghiggi](https://people.epfl.ch/gionata.ghiggi)\n- [Kim Candolfi](https://github.com/KimCandolfi)\n- [Régis Longchamp](https://people.epfl.ch/regis.longchamp)\n- [Charlotte Gisèle Weil](https://people.epfl.ch/charlotte.weil)\n- [Jacopo Grazioli](https://people.epfl.ch/jacopo.grazioli)\n- [Alexis Berne](https://people.epfl.ch/alexis.berne?lang=en)\n\n## Citation\n\nYou can cite the DISDRODB software by:\n\n\u003e Gionata Ghiggi, Kim Candolfi, Régis Longchamp, Charlotte Weil, Alexis Berne (2023). ltelab/disdrodb Zenodo. https://doi.org/10.5281/zenodo.7680581\n\nIf you want to cite a specific version, have a look at the [Zenodo site](https://doi.org/10.5281/zenodo.7680581)\n\n## License\n\nThe content of this repository is released under the terms of the [GPL 3.0 license](LICENSE).\n\n[conda_forge_link]: https://github.com/conda-forge/disdrodb-feedstock#installing-disdrodb\n[conda_link]: https://docs.conda.io/en/latest/miniconda.html\n[dev_install_link]: https://disdrodb.readthedocs.io/en/latest/installation.html#installation-for-contributors\n[pip_link]: https://pypi.org/project/disdrodb\n[winpy_link]: https://winpython.github.io/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fltelab%2Fdisdrodb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fltelab%2Fdisdrodb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fltelab%2Fdisdrodb/lists"}