CycloPhaser

CycloPhaser: A Python Package for Detecting Extratropical Cyclone Life Cycles - Published in JOSS (2025)

https://github.com/daniloceano/cyclophaser

Science Score: 93.0%

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

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 4 DOI reference(s) in README and JOSS metadata
  • Academic publication links
    Links to: joss.theoj.org
  • Committers with academic emails
  • Institutional organization owner
  • JOSS paper metadata
    Published in Journal of Open Source Software

Scientific Fields

Engineering Computer Science - 60% confidence
Last synced: 6 months ago · JSON representation

Repository

This package calculates extratropical cyclone life cycle phases from vorticity data using Python.

Basic Info
  • Host: GitHub
  • Owner: daniloceano
  • License: gpl-3.0
  • Language: Python
  • Default Branch: master
  • Homepage:
  • Size: 5.68 MB
Statistics
  • Stars: 5
  • Watchers: 1
  • Forks: 0
  • Open Issues: 0
  • Releases: 1
Created over 2 years ago · Last pushed 11 months ago
Metadata Files
Readme Changelog License

README.md

CycloPhaser: A Python Package for Detecting Extratropical Cyclone Life Cycles

Documentation Status PyPI version PyPI Downloads CircleCI License: GPL v3 Python Versions DOI

CycloPhaser is a package designed to automate and improve the accuracy of detecting and categorizing cyclone life cycle phases, including intensification, maturation, and decay. Understanding these phases is crucial for analyzing cyclone behavior and the dynamic processes that drive their development. This knowledge supports both operational forecasters and researchers focused on improving cyclone representation in numerical models, ultimately enhancing forecast accuracy. Traditionally, phase identification requires manual analysis, which introduces subjectivity and limits the feasibility of analyzing large datasets. CycloPhaser addresses these challenges by offering an efficient, objective approach, compatible with high-resolution reanalysis data and real-time observations alike. With CycloPhaser, users gain a powerful tool for cyclone life cycle classification, supporting both advanced meteorological research and practical forecasting applications.

CycloPhaser is described in detail in the paper by de Souza et al. (under review) and has been used to generate results presented by de Souza et al. (2024).

CycloPhaser Example Plot

Important Note: CycloPhaser requires cyclone tracking data as input but does not perform cyclone tracking itself. There are various cyclone tracking algorithms available in the literature. Walker et al. (2020) provide a discussion on these methods, while open-source tracking tools, such as CyTRACK by Pérez-Alarcón et al. (2024), are publicly accessible. Additionally, cyclone track databases, like the Atlantic extratropical cyclone tracks database by Gramcianinov et al. (2020), are available for use.

Installation

  1. Install using pip

``` pip install cyclophaser

Documentation

For detailed documentation, visit the CycloPhaser Documentation. This includes function parameters, module descriptions, and more.

Support and Contact

For support, feature requests, or any queries, please open an issue on the GitHub repository.

License

This project is licensed under the GNU General Public License v3.0. You may obtain a copy of the license at https://www.gnu.org/licenses/gpl-3.0.html.

References

  • de Souza, D. C., da Silva Dias, P. L., Gramcianinov, C. B., & de Camargo, R. (under review). CycloPhaser: A Python Package for Detecting Extratropical Cyclone Life Cycles. Journal of Open Source Software.

  • de Souza, D. C., da Silva Dias, P. L., Gramcianinov, C. B., da Silva, M. B. L., & de Camargo, R. (2024). New perspectives on South Atlantic storm track through an automatic method for detecting extratropical cyclones' lifecycle. International Journal of Climatology, 44(10), 3568-3588.

  • Gramcianinov, C. B., Campos, R. M., de Camargo, R., Hodges, K. I., Guedes Soares, C., & da Silva Dias, P. L. (2020). Atlantic extratropical cyclone tracks in 41 years of ERA5 and CFSR/CFSv2 databases. Mendeley Data, 4, 108111.

  • Pérez-Alarcón, A., Coll-Hidalgo, P., Trigo, R. M., Nieto, R., & Gimeno, L. (2024). CyTRACK: An open-source and user-friendly Python toolbox for detecting and tracking cyclones. Environmental Modelling & Software, 176, 106027.

  • Walker, E., Mitchell, D. M., & Seviour, W. J. (2020). The numerous approaches to tracking extratropical cyclones and the challenges they present. Weather, 75(11), 336-341.

Owner

  • Name: Danilo Couto de Souza
  • Login: daniloceano
  • Kind: user
  • Location: São Paulo

JOSS Publication

CycloPhaser: A Python Package for Detecting Extratropical Cyclone Life Cycles
Published
April 09, 2025
Volume 10, Issue 108, Page 7363
Authors
Danilo Couto de Souza ORCID
Institute of Astronomy, Geophysics and Atmospheric Sciences of the São Paulo University, Rua do Matão, 226, Cidade Universitária, 05508-090, São Paulo, Brazil
Pedro Leite Silva da Dias ORCID
Institute of Astronomy, Geophysics and Atmospheric Sciences of the São Paulo University, Rua do Matão, 226, Cidade Universitária, 05508-090, São Paulo, Brazil
Carolina Barnez Gramcianinov ORCID
Institute for Coastal Systems – Analysis and Modeling, Helmholtz-Zentrum Hereon, Geesthacht, Germany
Ricardo de Camargo ORCID
Institute of Astronomy, Geophysics and Atmospheric Sciences of the São Paulo University, Rua do Matão, 226, Cidade Universitária, 05508-090, São Paulo, Brazil
Editor
Hauke Schulz ORCID
Tags
meteorology atmospheric dynamics diagnostic cyclones

GitHub Events

Total
  • Create event: 1
  • Release event: 1
  • Issues event: 2
  • Watch event: 4
  • Issue comment event: 6
  • Push event: 28
  • Pull request event: 10
Last Year
  • Create event: 1
  • Release event: 1
  • Issues event: 2
  • Watch event: 4
  • Issue comment event: 6
  • Push event: 28
  • Pull request event: 10

Committers

Last synced: 7 months ago

All Time
  • Total Commits: 89
  • Total Committers: 1
  • Avg Commits per committer: 89.0
  • Development Distribution Score (DDS): 0.0
Past Year
  • Commits: 21
  • Committers: 1
  • Avg Commits per committer: 21.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
daniloceano d****o@g****m 89

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 3
  • Total pull requests: 42
  • Average time to close issues: 3 days
  • Average time to close pull requests: 2 minutes
  • Total issue authors: 1
  • Total pull request authors: 1
  • Average comments per issue: 2.0
  • Average comments per pull request: 0.0
  • Merged pull requests: 39
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 3
  • Pull requests: 13
  • Average time to close issues: 3 days
  • Average time to close pull requests: 1 minute
  • Issue authors: 1
  • Pull request authors: 1
  • Average comments per issue: 2.0
  • Average comments per pull request: 0.0
  • Merged pull requests: 12
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • stella-bourdin (3)
Pull Request Authors
  • daniloceano (50)
Top Labels
Issue Labels
Pull Request Labels

Packages

  • Total packages: 1
  • Total downloads:
    • pypi 64 last-month
  • Total dependent packages: 0
  • Total dependent repositories: 0
  • Total versions: 33
  • Total maintainers: 1
pypi.org: cyclophaser

Determine phases from extratropical cyclone life cycle

  • Versions: 33
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 64 Last month
Rankings
Dependent packages count: 7.5%
Average: 38.6%
Dependent repos count: 69.7%
Maintainers (1)
Last synced: 6 months ago