Skip to main content

Determine phases from extratropical cyclone life cycle

Project description

CycloPhaser: A Python Package for Detecting Extratropical Cyclone Life Cycles

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

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cyclophaser-1.9.4.tar.gz (41.4 kB view details)

Uploaded Source

Built Distribution

cyclophaser-1.9.4-py3-none-any.whl (40.3 kB view details)

Uploaded Python 3

File details

Details for the file cyclophaser-1.9.4.tar.gz.

File metadata

  • Download URL: cyclophaser-1.9.4.tar.gz
  • Upload date:
  • Size: 41.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.10.12

File hashes

Hashes for cyclophaser-1.9.4.tar.gz
Algorithm Hash digest
SHA256 c743499673e97f94eecda4a957302a241b2327c96c0562f37788a1afa29e36f1
MD5 a6c09bb4fd8a1d86b5c3f0e178ff2d5b
BLAKE2b-256 ad638ea32cb4b429f10334046bd7a21564d777bf4fe9c3237e51d7a5b46ba8fe

See more details on using hashes here.

File details

Details for the file cyclophaser-1.9.4-py3-none-any.whl.

File metadata

  • Download URL: cyclophaser-1.9.4-py3-none-any.whl
  • Upload date:
  • Size: 40.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.10.12

File hashes

Hashes for cyclophaser-1.9.4-py3-none-any.whl
Algorithm Hash digest
SHA256 522d8b1c80ea6ffb752332d46aaedc9a7bdc724a5ead703bd29252aafc4ba733
MD5 0ef203863050c67ffe72b05858e0e2df
BLAKE2b-256 e269bd11f15f2cb49bf29a964d74f9ab4e8c59bff5a06ccce1ecded33bf4ed71

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page