ampycloud

Python package to determine the sky coverage fraction and base height of cloud layers using ceilometer data

https://github.com/meteoswiss/ampycloud

Science Score: 67.0%

This score indicates how likely this project is to be science-related based on various indicators:

✓
CITATION.cff file
Found CITATION.cff file
✓
codemeta.json file
Found codemeta.json file
✓
.zenodo.json file
Found .zenodo.json file
✓
DOI references
Found 1 DOI reference(s) in README
✓
Academic publication links
Links to: zenodo.org
○
Committers with academic emails
○
Institutional organization owner
○
JOSS paper metadata
○
Scientific vocabulary similarity
Low similarity (7.5%) to scientific vocabulary

Last synced: 6 months ago · JSON representation ·

Repository

Python package to determine the sky coverage fraction and base height of cloud layers using ceilometer data

Basic Info

Host: GitHub
Owner: MeteoSwiss
License: bsd-3-clause
Language: Python
Default Branch: develop
Homepage: https://meteoswiss.github.io/ampycloud/
Size: 9.52 MB

Statistics

Stars: 5
Watchers: 5
Forks: 2
Open Issues: 6
Releases: 11

Created about 4 years ago · Last pushed over 1 year ago

Metadata Files

Readme Changelog Contributing License Code of conduct Citation Codeowners

ampycloud

Introduction

ampycloud refers to both this Python package and the algorithm at its core, designed to characterize cloud layers (i.e. height and sky coverage fraction) using ceilometer measurements (i.e. automatic cloud base hits measurements), and derive the corresponding METAR-like message.

For the full documentation, installation instructions, etc ..., go to: https://meteoswiss.github.io/ampycloud

License & Copyright

ampycloud is released under the terms of the 3-Clause BSD license. The copyright (2021-2024) belongs to MeteoSwiss.

Contributing to ampycloud

Please see the contributing guidelines for details.

Owner

Name: MeteoSwiss
Login: MeteoSwiss
Kind: organization
Location: Zurich, Geneva, Locarno, Payerne

Website: https://www.meteoswiss.ch
Twitter: meteosuisse
Repositories: 22
Profile: https://github.com/MeteoSwiss

Federal Office of Meteorology and Climatology MeteoSwiss

Citation (CITATION.cff)

cff-version: 1.2.0
message: If ampycloud was useful for your research, please cite both the dedicated article (https://doi.org/10.5194/amt-17-4891-2024) and the software itself.
type: software
authors:
  - family-names: Vogt
    given-names: Frédéric P.A.
  - family-names: Foresti
    given-names: Loris
  - family-names: Regenass
    given-names: Daniel
  - family-names: Réthoré
    given-names: Sophie
  - family-names: Tarin Burriel
    given-names: Néstor
title: ampycloud
identifiers:
  - type: doi
    value: 10.5281/zenodo.8399683
    description: Zenodo entry
repository-code: 'https://github.com/MeteoSwiss/ampycloud/'
url: 'https://meteoswiss.github.io/ampycloud/'
license: BSD-3-Clause
preferred-citation:
  title: "ampycloud: an open-source algorithm to determine cloud base heights and sky coverage fractions from ceilometer data"
  abstract: |
    Ceilometers are used routinely at aerodromes worldwide to derive the height and sky coverage fraction of cloud layers. This information, possibly combined with direct observations by human observers, contributes to the production of meteorological aerodrome reports (METARs). Here, we present ampycloud, a new algorithm, and its associated Python package for automatic processing of ceilometer data with the aim of determining the sky coverage fraction and base height of cloud layers above aerodromes. The ampycloud algorithm was developed at the Swiss Federal Office of Meteorology and Climatology (MeteoSwiss) as part of the AMAROC (AutoMETAR/AutoReport rOund the Clock) program to help in the fully automatic production of METARs at Swiss civil aerodromes. ampycloud is designed to work with no direct human supervision. The algorithm consists of three distinct, sequential steps that rely on agglomerative clustering methods and Gaussian mixture models to identify distinct cloud layers from individual cloud base hits reported by ceilometers. The robustness of the ampycloud algorithm stems from the first processing step, which is simple and reliable. It constrains the two subsequent processing steps that are more sensitive but also better suited to handling complex cloud distributions. The software implementation of the ampycloud algorithm takes the form of an eponymous, pip-installable Python package developed on GitHub and made publicly accessible.
  type: article
  journal: Atmospheric Measurement Techniques
  issue: 16
  languages:
    - eng
  pages: 4891-4914
  volume: 17
  url: https://amt.copernicus.org/articles/17/4891/2024/
  authors:
    - family-names: Vogt
      given-names: Frédéric P. A.
    - family-names: Foresti
      given-names: Loris
    - family-names: Regenass
      given-names: Daniel
    - family-names: Réthoré
      given-names: Sophie
    - family-names: Tarin Burriel
      given-names: Néstor
    - family-names: Bibby
      given-names: Mervyn
    - family-names: Juda
      given-names: Przemysław
    - family-names: Balmelli
      given-names: Simone
    - family-names: Hanselmann
      given-names: Tobias
    - family-names: du Preez
      given-names: Pieter
    - family-names: Furrer
      given-names: Dirk
  date-published: 2024-08-27
  doi: 10.5194/amt-17-4891-2024

GitHub Events

Total

Issues event: 1
Watch event: 1
Member event: 1

Last Year

Issues event: 1
Watch event: 1
Member event: 1

Committers

Last synced: 7 months ago

All Time

Total Commits: 319
Total Committers: 4
Avg Commits per committer: 79.75
Development Distribution Score (DDS): 0.194

Past Year

Commits: 10
Committers: 2
Avg Commits per committer: 5.0
Development Distribution Score (DDS): 0.3

Top Committers

Name	Email	Commits
13974615+fpavogt	1****t	257
Daniel Regenass	d**s@m**h	47
Sophie Rethore	s**e@m**h	14
nestabur	6****r	1

Committer Domains (Top 20 + Academic)

meteoswiss.ch: 2

Issues and Pull Requests

Last synced: 7 months ago

All Time

Total issues: 66
Total pull requests: 71
Average time to close issues: 3 months
Average time to close pull requests: 8 days
Total issue authors: 4
Total pull request authors: 5
Average comments per issue: 1.03
Average comments per pull request: 0.79
Merged pull requests: 68
Bot issues: 0
Bot pull requests: 0

Past Year

Issues: 2
Pull requests: 12
Average time to close issues: 20 days
Average time to close pull requests: 2 days
Issue authors: 2
Pull request authors: 2
Average comments per issue: 2.5
Average comments per pull request: 0.5
Merged pull requests: 11
Bot issues: 0
Bot pull requests: 0

View more stats

Top Authors

Issue Authors

fpavogt (60)
regDaniel (3)
wingunder (2)
loforest (1)

Pull Request Authors

fpavogt (66)
regDaniel (23)
srethore (2)
loforest (1)
nestabur (1)

Top Labels

Issue Labels

todo (34) bug (23) enhancement (11) help !!! (6) documentation (4) CI/CD (4) wontfix (2) invalid (1) triage (1)

Pull Request Labels

enhancement (2) documentation (1) bug (1)

Packages

Total packages: 1
Total downloads:
- pypi 93 last-month

Total dependent packages: 0
Total dependent repositories: 1
Total versions: 10
Total maintainers: 1

pypi.org: ampycloud

Determining the sky coverage fraction and base height of cloud layers usingceilometer data

Homepage: https://meteoswiss.github.io/ampycloud
Documentation: https://ampycloud.readthedocs.io/
License: BSD-3-Clause
Latest release: 2.1.1
published over 1 year ago

Versions: 10
Dependent Packages: 0
Dependent Repositories: 1
Downloads: 93 Last month

Rankings

Dependent packages count: 10.0%

Dependent repos count: 21.8%

Average: 21.9%

Forks count: 22.7%

Downloads: 27.4%

Stargazers count: 27.8%

Maintainers (1)

MeteoSwiss

Last synced: 6 months ago

Dependencies

setup.py pypi

matplotlib *
numpy *
pandas *
pyyaml *
ruamel.yaml *
scikit-learn *

.github/workflows/CI_check_version.yml actions

actions/checkout v2 composite
actions/setup-python v2 composite

.github/workflows/CI_docs_build_and_check.yml actions

actions/checkout v2 composite
actions/setup-python v2 composite

.github/workflows/CI_docs_build_and_publish.yml actions

actions/checkout v2 composite
actions/setup-python v2 composite

.github/workflows/CI_pylinter.yml actions

actions/checkout v2 composite
actions/setup-python v2 composite

.github/workflows/CI_pypi.yml actions

actions/checkout v2 composite
actions/setup-python v2 composite

.github/workflows/CI_pytest.yml actions

actions/checkout v2 composite
actions/setup-python v2 composite

.github/workflows/CI_speed_check.yml actions

actions/checkout v2 composite
actions/setup-python v2 composite

.github/workflows/CI_changelog.yml actions

.github/workflows/CI_pytest_weekly.yml actions

actions/checkout v3 composite
actions/setup-python v4 composite

ampycloud

Science Score: 67.0%

Repository

Basic Info

Statistics

Metadata Files

README.md

ampycloud

Introduction

License & Copyright

Contributing to ampycloud

Owner

Citation (CITATION.cff)

GitHub Events

Total

Last Year

Committers

All Time

Past Year

Top Committers

Committer Domains (Top 20 + Academic)

Issues and Pull Requests

All Time

Past Year

Top Authors

Issue Authors

Pull Request Authors

Top Labels

Issue Labels

Pull Request Labels

Packages

pypi.org: ampycloud

Rankings

Maintainers (1)

Dependencies