started pyrad notebooks that explains config files

notebooks/pyart/README.md

@@ -0,0 +1,12 @@
+# Py-ART Tutorial
+
+This is a brief overview of the main Py-ART functionalities.
+
+## Py-ART Basics and Gridding
+The foundational content includes the:
+
+- Py-ART Basics - an overview of Py-ART package, how to read in data, and basic plotting functionality
+- Py-ART Gridding - how to utilize the gridding tools in Py-ART
+- Py-ART Processing - how to perform some common radar processing in Py-ART
+
+If you are new to Py-ART, starting with the basics is a good place to start, and is required to know before moving onto Py-ART Gridding.

notebooks/pyart/pyart-basics.ipynb

@@ -514,13 +514,6 @@
     "* [Mailing list](groups.google.com/group/pyart-users/)\n",
     "* [Issue Tracker](github.com/ARM-DOE/pyart/issues)"
    ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {},
-   "outputs": [],
-   "source": []
   }
  ],
  "metadata": {

notebooks/pyrad/description-config.ipynb

@@ -0,0 +1,57 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## 0 : Plot a volume scan (pyrad_config/00_plot_vol)\n",
+    "---\n",
+    "   \n",
+    "This pyrad configuration file does the following:\n",
+    "- Read polar data from JMA\n",
+    "- Perform a series of plots from the reflectivity data\n",
+    "    - PPI plot\n",
+    "    - PseudoRHI plot\n",
+    "    - Bscope plot\n",
+    "    - Histogram plot\n",
+    "    - Plot along specific polar coordinates\n",
+    "\n",
+    "\n",
+    "**How to run** : *cd pyrad_config/00_plot_vol; main_process_data.py --cfgpath ./ --starttime 20230801000000 --endtime 20230802000000 jma_plot_vol.txt*\n",
+    "\n",
+    "## 4 : KDP and specific attenuation (pyrad_config/04_attenuation)\n",
+    "---\n",
+    "This pyrad configuration file does the following:\n",
+    "- Read raw radar data from one of the Swiss operational C-band radars\n",
+    "- Plot PPI of reflectivity\n",
+    "- Perform echo classification and filter clutter\n",
+    "- Estimate KDP with the Maesaka method\n",
+    "- Estimate the specific attenuation with the ZPHI method.\n",
+    "- Create PPI maps of KDP, corrected reflectivity and specific attenuation.\n",
+    "\n",
+    "\n",
+    "**How to run** : *cd pyrad_config/04_attenuation; main_process_data.py --cfgpath ./ --starttime  20220628072500 --endtime 20220628072500 attenuation.txt*\n",
+    "\n",
+    "## 11 : Radar visibility from a DEM with the GECSX tool (pyrad_config/11_visibility/)\n",
+    "---\n",
+    "\n",
+    "This pyrad configuration file does the following:\n",
+    "- Read a DEM of the Swiss topography in geotiff format\n",
+    "- Estimate the static radar visibility and clutter power/reflectivity using either data from an X-band mobile radar (visibility.txt) or using user specified radar parameters and no actual radar data (visibility_norad.txt).\n",
+    "- Create PPI plots of the clutter and the visibility\n",
+    "- Create Grid map plots of several other products generated by GECSX (e.g. slope, aspect, min. visible elevation angle,...)\n",
+    "\n",
+    "**How to run** : \n",
+    "- *cd pyrad_config/11_visibility/; main_process_gecsx.py --cfgpath ./ visibility_norad.txt* (no radar data)\n",
+    "- *cd pyrad_config/11_visibility/; main_process_gecsx.py --cfgpath ./ --starttime 20231127170000 --endtime 20231127180000 visibility.txt* (with radar data)"
+   ]
+  }
+ ],
+ "metadata": {
+  "language_info": {
+   "name": "python"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}