From 47c8de6ba0c2ab67a7e895bffccb5b784e7fe89b Mon Sep 17 00:00:00 2001 From: Christian F Date: Thu, 25 Apr 2024 22:55:11 -0400 Subject: [PATCH 1/9] Update README.txt --- tutorials/README.txt | 18 ++++++++++++++---- 1 file changed, 14 insertions(+), 4 deletions(-) diff --git a/tutorials/README.txt b/tutorials/README.txt index 568a1bf6c6d..034d9f10761 100644 --- a/tutorials/README.txt +++ b/tutorials/README.txt @@ -1,7 +1,17 @@ .. _tutorials-index: -Tutorials -========= +# MetPy Tutorials -This collection of tutorials (under development) demonstrates the use of MetPy to perform -common meteorological tasks. +Welcome to the MetPy tutorials! These tutorials are designed to help you get started with using MetPy for meteorological data analysis and visualization. Whether you're a beginner looking to explore the basics or an experienced user seeking advanced techniques, these tutorials will guide you through various aspects of MetPy. + +## Purpose + +The purpose of these tutorials is to provide hands-on examples and explanations to help you learn how to use MetPy effectively for your meteorological data analysis tasks. Each tutorial focuses on a specific aspect of MetPy, gradually building your understanding and skills as you progress through them. + +## Getting Started + +To get started with the tutorials, follow these steps: + +1. **Installation**: Ensure you have MetPy installed. You can install it via pip: + ```bash + pip install metpy From d9bb87827ab238092e7c50ab3c2e739d492e4fc6 Mon Sep 17 00:00:00 2001 From: Christian F Date: Thu, 25 Apr 2024 22:56:14 -0400 Subject: [PATCH 2/9] Update README.txt --- tutorials/README.txt | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/tutorials/README.txt b/tutorials/README.txt index 034d9f10761..ca05a132f0f 100644 --- a/tutorials/README.txt +++ b/tutorials/README.txt @@ -1,5 +1,3 @@ -.. _tutorials-index: - # MetPy Tutorials Welcome to the MetPy tutorials! These tutorials are designed to help you get started with using MetPy for meteorological data analysis and visualization. Whether you're a beginner looking to explore the basics or an experienced user seeking advanced techniques, these tutorials will guide you through various aspects of MetPy. @@ -15,3 +13,4 @@ To get started with the tutorials, follow these steps: 1. **Installation**: Ensure you have MetPy installed. You can install it via pip: ```bash pip install metpy +``` From 40ce4af53522dbb02fef8aa5dbf07975737f2576 Mon Sep 17 00:00:00 2001 From: Christian F Date: Thu, 25 Apr 2024 23:00:59 -0400 Subject: [PATCH 3/9] Rename README.txt to README.md --- tutorials/{README.txt => README.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename tutorials/{README.txt => README.md} (100%) diff --git a/tutorials/README.txt b/tutorials/README.md similarity index 100% rename from tutorials/README.txt rename to tutorials/README.md From a0766d1a381fb111e134b089228b2787f375e86c Mon Sep 17 00:00:00 2001 From: Christian F Date: Thu, 25 Apr 2024 23:14:23 -0400 Subject: [PATCH 4/9] Update README.md --- tutorials/README.md | 37 ++++++++++++++++++++++++++++++++++++- 1 file changed, 36 insertions(+), 1 deletion(-) diff --git a/tutorials/README.md b/tutorials/README.md index ca05a132f0f..b3ef227b6e7 100644 --- a/tutorials/README.md +++ b/tutorials/README.md @@ -13,4 +13,39 @@ To get started with the tutorials, follow these steps: 1. **Installation**: Ensure you have MetPy installed. You can install it via pip: ```bash pip install metpy -``` + +2. **Clone the Repository**: Clone or download this repository to access the tutorial files: +```bash + git clone https://github.com/your_username/metpy-tutorials.git + +3. **Navigate to Tutorials**: Open the cloned repository and navigate to the `tutorials` directory. + +4. **Choose a Tutorial**: Browse through the available tutorials and choose one that aligns with your skill level and interests. + +5. **Run the Tutorial**: Open the tutorial file in your preferred Python environment (e.g., Jupyter Notebook) and follow along with the instructions. + +6. **Experiment**: Feel free to experiment with the code examples and modify them to suit your needs. This is the best way to learn! + +## Tutorials by Difficulty Level + +### Beginner Level + +1. **Introduction to MetPy**: Learn the basics of MetPy, including data structures and common operations. + +2. **Plotting Meteorological Data**: Explore how to visualize meteorological data using MetPy's plotting functions. + +### Intermediate Level + +1. **Working with Gridded Data**: Dive deeper into handling and manipulating gridded meteorological data with MetPy. + +2. **Analyzing Atmospheric Soundings**: Learn how to analyze atmospheric soundings and perform thermodynamic calculations. + +### Advanced Level + +1. **Advanced Plotting Techniques**: Discover advanced plotting techniques and customization options available in MetPy. + +2. **Case Studies**: Explore real-world case studies and apply MetPy to analyze and interpret meteorological phenomena. + +## Contribution + +We welcome contributions to these tutorials! If you have any suggestions for improvements or would like to add new tutorials, feel free to submit a pull request. From 54a4c0405e8cf009b58e5951571433733680cbab Mon Sep 17 00:00:00 2001 From: Christian F Date: Thu, 25 Apr 2024 23:14:46 -0400 Subject: [PATCH 5/9] Update README.md --- tutorials/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tutorials/README.md b/tutorials/README.md index b3ef227b6e7..6cd2f552cee 100644 --- a/tutorials/README.md +++ b/tutorials/README.md @@ -15,7 +15,7 @@ To get started with the tutorials, follow these steps: pip install metpy 2. **Clone the Repository**: Clone or download this repository to access the tutorial files: -```bash + ```bash git clone https://github.com/your_username/metpy-tutorials.git 3. **Navigate to Tutorials**: Open the cloned repository and navigate to the `tutorials` directory. From ee828c681950e0f73d96fc8be3c34d4fc282536c Mon Sep 17 00:00:00 2001 From: Christian F Date: Thu, 25 Apr 2024 23:23:52 -0400 Subject: [PATCH 6/9] Update README.md --- tutorials/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tutorials/README.md b/tutorials/README.md index 6cd2f552cee..44acdc94ea1 100644 --- a/tutorials/README.md +++ b/tutorials/README.md @@ -16,7 +16,7 @@ To get started with the tutorials, follow these steps: 2. **Clone the Repository**: Clone or download this repository to access the tutorial files: ```bash - git clone https://github.com/your_username/metpy-tutorials.git + git clone https://github.com/your_username/metpy.git 3. **Navigate to Tutorials**: Open the cloned repository and navigate to the `tutorials` directory. From a28a1bac22a0cb683d462b3bac1d85e3faba9196 Mon Sep 17 00:00:00 2001 From: Christian F Date: Fri, 26 Apr 2024 16:00:40 -0400 Subject: [PATCH 7/9] Update README.md --- tutorials/README.md | 15 +++++++-------- 1 file changed, 7 insertions(+), 8 deletions(-) diff --git a/tutorials/README.md b/tutorials/README.md index 44acdc94ea1..b5ffa97484f 100644 --- a/tutorials/README.md +++ b/tutorials/README.md @@ -30,21 +30,20 @@ To get started with the tutorials, follow these steps: ### Beginner Level -1. **Introduction to MetPy**: Learn the basics of MetPy, including data structures and common operations. +1. **Area Tutorial**: Learn how to use predefined areas with MetPy. -2. **Plotting Meteorological Data**: Explore how to visualize meteorological data using MetPy's plotting functions. +2. **Declarative Tutorial**: MetPy's declarative syntax simplifies data exploration and analysis by streamlining plotting in Python, hiding complexity to make data investigation more accessible. + +3. **Unit Tutorial**: Learn how to work with units within Metpy! ### Intermediate Level -1. **Working with Gridded Data**: Dive deeper into handling and manipulating gridded meteorological data with MetPy. - -2. **Analyzing Atmospheric Soundings**: Learn how to analyze atmospheric soundings and perform thermodynamic calculations. +1. **Upper Air Soundings**: Upper air analysis is a staple of many synoptic and mesoscale analysis problems. In this tutorial we will gather weather balloon data, plot it, perform a series of thermodynamic calculations, and summarize the results. +2. **xarray with MetPy Tutorial**: This tutorial demonstrates how to work with xarray, a powerful Python package for labeled arrays and datasets. MetPy seamlessly integrates with xarray's data model, offering convenient methods and properties for coordinate, coordinate reference system, and unit operations. ### Advanced Level -1. **Advanced Plotting Techniques**: Discover advanced plotting techniques and customization options available in MetPy. - -2. **Case Studies**: Explore real-world case studies and apply MetPy to analyze and interpret meteorological phenomena. +1. **Advanced Tutorials Coming Soon** ## Contribution From 7fa39f331bf016bb0388c66a4d5668dae8f0d87e Mon Sep 17 00:00:00 2001 From: Christian F Date: Tue, 28 May 2024 20:49:06 -0400 Subject: [PATCH 8/9] Update README.md --- tutorials/README.md | 20 ++------------------ 1 file changed, 2 insertions(+), 18 deletions(-) diff --git a/tutorials/README.md b/tutorials/README.md index b5ffa97484f..ce08448b054 100644 --- a/tutorials/README.md +++ b/tutorials/README.md @@ -8,23 +8,7 @@ The purpose of these tutorials is to provide hands-on examples and explanations ## Getting Started -To get started with the tutorials, follow these steps: - -1. **Installation**: Ensure you have MetPy installed. You can install it via pip: - ```bash - pip install metpy - -2. **Clone the Repository**: Clone or download this repository to access the tutorial files: - ```bash - git clone https://github.com/your_username/metpy.git - -3. **Navigate to Tutorials**: Open the cloned repository and navigate to the `tutorials` directory. - -4. **Choose a Tutorial**: Browse through the available tutorials and choose one that aligns with your skill level and interests. - -5. **Run the Tutorial**: Open the tutorial file in your preferred Python environment (e.g., Jupyter Notebook) and follow along with the instructions. - -6. **Experiment**: Feel free to experiment with the code examples and modify them to suit your needs. This is the best way to learn! +If this is your first time using MetPy head over to the [installation guide](https://unidata.github.io/MetPy/latest/userguide/installguide.html) to make sure the required dependencies have been installed. ## Tutorials by Difficulty Level @@ -47,4 +31,4 @@ To get started with the tutorials, follow these steps: ## Contribution -We welcome contributions to these tutorials! If you have any suggestions for improvements or would like to add new tutorials, feel free to submit a pull request. +We welcome contributions to these tutorials! If you have any suggestions for improvements or would like to add new tutorials feel free to submit an issue or make a pull request. More information on how to contribute can be found by checking out the [Contributors Guide](https://github.com/Unidata/MetPy/blob/main/CONTRIBUTING.md) From 6b6bda6b6f2dc5007b898707884980b42883d7cd Mon Sep 17 00:00:00 2001 From: Christian F Date: Tue, 28 May 2024 20:54:00 -0400 Subject: [PATCH 9/9] Update README.md --- tutorials/README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/tutorials/README.md b/tutorials/README.md index ce08448b054..a388761397f 100644 --- a/tutorials/README.md +++ b/tutorials/README.md @@ -29,6 +29,8 @@ If this is your first time using MetPy head over to the [installation guide](htt 1. **Advanced Tutorials Coming Soon** +The [Examples Gallery](https://unidata.github.io/MetPy/latest/examples/index.html) has more examples of what else you can create with MetPy! + ## Contribution We welcome contributions to these tutorials! If you have any suggestions for improvements or would like to add new tutorials feel free to submit an issue or make a pull request. More information on how to contribute can be found by checking out the [Contributors Guide](https://github.com/Unidata/MetPy/blob/main/CONTRIBUTING.md)