/TropiDash

Repository for Tropical Cyclone Dashboard for Code for Earth 2023 project

Primary LanguageJupyter NotebookApache License 2.0Apache-2.0

TropiDash: towards a comprehensive tropical cyclone hazard dashboard

TropiDash is a visualization tool designed to empower researchers, meteorologists, and enthusiasts with the ability to analyze and interpret tropical cyclone data effectively. Utilizing web technologies and data visualization libraries, TropiDash provides a comprehensive overview of tropical cyclones, their paths, intensities, and potential impacts. The dashboard is developed as a Jupyter Notebook allowing also less experienced user to access it without problems. The project was developed as part of the ECMWF Code for Earth 2023 initiative. You can find more details regarding the Code for Earth initiative at their official website. You can find more details about the other projects of 2023 at this GitHub repository .

For the best experience with TropiDash, we recommend downloading and running the dashboard locally. This ensures optimal performance and access to the full range of features. Detailed instructions for setting up the dashboard on your local machine are provided in the Getting Started section. Alternatively, for quick access and convenience, TropiDash is also available online via FIX THIS, allowing for immediate interaction without the need for local installation.

Repository Structure

  • TropiDash folder: Main notebook (TropiDash_backbone.ipynb), utility libraries, and data storage folders.
  • Tutorials Folder: Step-by-step guides for each dashboard section and data downloading instructions.
  • Documentation (TropiDash_documentation.md): Detailed data source, structure, and function explanations for user support.
  • Python Packages (environment.yml): Environment file with essential packages for local deployment.

Getting Started

  1. Install Conda: If you don't have Conda, download and install it from the official Conda website.
  2. Open Your Terminal: Access your terminal or command prompt.
  3. Navigate to Your Desired Directory: Use the cd command to navigate to the folder where you want to store TropiDash.
  4. Clone the repository: Execute the clone command. You should have git installed, if you don't check the Installation guide.
    git clone https://github.com/ECMWFCode4Earth/TropiDash
  1. Create and Activate the Conda Environment: This ensures all dependecies are properly installed. Execute the 2 following commands:
    conda env create -f environment.yml
    conda activate tropidash
  1. Launch Jupyter Lab: Navigate to the TropiDash directory in your terminal and execute:
    jupyter lab
  1. Open the main Notebook: In Jupyter Lab, navigate to the folder containing TropiDash_backbone.ipynb and open it.
  2. Run the Dashboard: Execute the dashboard by clicking on the VoilĂ  button within Jupyter Lab.
Screenshot 2024-03-21 at 19 21 43

Dashboard Preview

Get a closer look at TropiDash in action! These GIFs showcase some of the dashboard's features, demonstrating how users can interact with tropical cyclone data for insightful analysis.

Launching TropiDash in Jupyterlab.

voila_launch

Update the forecast after selecting the cyclone to visualize and the forecast date to consider.

dashboard_launch

Check the average forecast track and the information at a specific location. section1

Look at the total precipitation and the probability of 10m wind gusts over 25 m/s associated with the cyclone. section2

Check the coastal hazard risk over the east coast of North America. section3

Consult simultaneously the average forecast track and the coastal hazard risk of the region on the cyclone's path. section4

Check the precipitation forecast in a specific point along the average forecast track. section5

Getting Involved

Contributions to TropiDash are welcome! Whether it's enhancing functionality, improving documentation, or reporting issues, your input helps us make TropiDash better for everyone.

License

This project is licensed under the Apache-2.0 License - see the LICENSE file for details.

Contact

For collaboration or any queries regarding this project, please contact: