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.
- 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.
- Install Conda: If you don't have Conda, download and install it from the official Conda website.
- Open Your Terminal: Access your terminal or command prompt.
- Navigate to Your Desired Directory: Use the
cd
command to navigate to the folder where you want to store TropiDash. - 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
- 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
- Launch Jupyter Lab: Navigate to the TropiDash directory in your terminal and execute:
jupyter lab
- Open the main Notebook: In Jupyter Lab, navigate to the folder containing TropiDash_backbone.ipynb and open it.
- Run the Dashboard: Execute the dashboard by clicking on the Voilà button within Jupyter Lab.
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.
Update the forecast after selecting the cyclone to visualize and the forecast date to consider.
Check the average forecast track and the information at a specific location.
Look at the total precipitation and the probability of 10m wind gusts over 25 m/s associated with the cyclone.
Check the coastal hazard risk over the east coast of North America.
Consult simultaneously the average forecast track and the coastal hazard risk of the region on the cyclone's path.
Check the precipitation forecast in a specific point along the average forecast track.
Contributions to TropiDash are welcome! Whether it's enhancing functionality, improving documentation, or reporting issues, your input helps us make TropiDash better for everyone.
This project is licensed under the Apache-2.0 License - see the LICENSE file for details.
For collaboration or any queries regarding this project, please contact:
- Filippo Dainelli: [[email protected]]
- Paolo Colombo: [[email protected]]
- Laura Paredes i Fortuny: [[email protected]]