-ERAD 2022 Open Radar Science Shortcourse
-
-
This tutorial covers how to get started with the Open Radar Science stack!
-Motivation
-The course will take place on 28 August 2022, the day before before the 2022 ERAD Radar Conference. We will introduce the participants to community software packages designed for radar data processing, including (but not limited to) BALTRAD, LROSE, Py-ART, and wradlib. Following a welcome, there will be an introduction to Open Science concepts with the Open Radar context.
-The common ground for most of those tools is Python, so we’ll feature a quick intro to the Python programming language, and endow participants with the basics of how to contribute to community software.
-List of Instructors
--
-
Scott Collis (Argonne National Laboratory, USA)
-Bobby Jackson (Argonne National Laboratory, USA)
-Maxwell Grover (Argonne National Laboratory, USA)
-Daniel Michelson (Environment and Climate Change Canada)
-Jordi Figueras i Ventura (Météo-France, France)
-Daniel Wolfensberger (MeteoSwiss, Switzerland)
-Mike Dixon (National Center for Atmospheric Research, USA)
-Kai Mühlbauer (University of Bonn, Germany)
-Velibor Pejčić (University of Bonn, Germany)
-
Contributors
- -Course program
--
-
09:00 - 09:15 Welcome and getting started
-09:15 - 09:45 Community weather radar software and Open Science
-09:45 - 10:30 Overview of the open source radar processing packages
-10:30 - 11:00 Coffee break
-11:00 - 11:45 Hands on Py-ART
-11:45 - 12:30 Hands on wradlib
-12:30 - 13:30 Lunch break
-13:30 - 14:15 Hands on BALTRAD BALTRAD
-14:15 - 15:00 Hands on LROSE
-15:00 - 15:30 Coffee break
-15:30 - 16:00 Combining multiple packages
-16:00 - 16:30 Becoming a developer in an open source project, best practices
-16:30 - 17:00 Open slot, discussion, evaluation
-
Structure
- - -Things You Need to Prepare
-Participants need to bring their own 64-bit notebook (Linux, Windows, Mac). The exercices will take place on a cloud server. On Windows, the use of a ssh-client such as Putty or MobaXterm will be necessary.
-![](\"./images/erad2022_cidd_mosaic.png\")
\n",
- " \n",
- "The case we will use is from 2021/07/06 22:00 UTC, when a series of MCSs passed through the NW region of Kansas in the USA.\n",
- "\n",
- "We will combine the reflectivity of 3 NEXRAD radars into a mini-mosaic:\n",
- "\n",
- "- KGLD - Goodland, Kansas\n",
- "- KUEX - Hastings, Nebraska\n",
- "- KDDC - Dodge City, Kansas\n",
- "\n",
- "\n",
- "We will download the following data sets from the cloud:\n",
- "\n",
- "- raw NEXRAD files for KGLD, KUEX and KDDC, 2021/07/06 from 22:00 UTC to 22:30 UTC\n",
- "- RUC model output for Kansas region, CF-NetCDF format, from 2021/07/06 at 23:00 UTC\n",
- "\n",
- "The model data will provide a temperature profile for computing PID and Echo Type.\n",
- "\n",
- "The workflow is as follows:\n",
- "\n",
- "- download the data into ```/tmp/lrose_data/nexrad_mosaic```.\n",
- "- run LROSE app RadxConvert, to convert raw NEXRAD files to CfRadial.\n",
- "- plot an example PPI from KGLD using PyArt.\n",
- "- read in temperature data from RUC file, plot cross sections using Matplotlib.\n",
- "- run the LROSE app Mdv2SoundingSpdb to derive the temperature profile for each radar site from the RUC data file, and store in SPDB (a simple time-indexed data base).\n",
- "- run the LROSE app RadxRate to compute precipition rate and Particle ID (PID).\n",
- "- plot KDP, PID and precipitation rate for an example PPI.\n",
- "- run the LROSE app Radx2Grid to convert the polar CfRadial files into Cartesian coordinates.\n",
- "- run the LROSE app MdvMerge2 to merge the Cartesian files from the 3 radars into a reflectivity mini-mosaic.\n",
- "- plot selected views of the reflectivity mosaic, using Matplotlib.\n",
- "- run the LROSE app Ecco to compute the convective/stratiform partition using the reflectivity mosaic and the RUC temperature profile.\n",
- "- plot the results of Ecco using Matplotlib.\n",
- "\n",
- "We will use the following parameter files for the LROSE applications:\n",
- "\n",
- "- params/RadxConvert.nexrad - convert raw NEXRAD files to CfRadial.\n",
- "- params/Mdv2SoundingSpdb.ruc - create temperature profiles for each radar from RUC model temperature.\n",
- "- params/RadxRate.nexrad - computes KDP, PID and precipition rate.\n",
- "- params/kdp_params.nexrad - used by RadxRate to compute KDP.\n",
- "- params/pid_params.nexrad - used by RadxRate to compute PID.\n",
- "- params/pid_thresholds.nexrad - used by RadxRate to compute PID.\n",
- "- params/rate_params.nexrad - used by RadxRate to compute precipitation rate.\n",
- "- params/Ecco.nexrad_mosaic - used by Ecco to compute echo type classifications.\n",
- "\n",
- "After the download step, the input files will be in:\n",
- "\n",
- "```\n",
- " /tmp/lrose_data/nexrad_mosaic/raw/KGLD\n",
- " /tmp/lrose_data/nexrad_mosaic/raw/KUEX\n",
- " /tmp/lrose_data/nexrad_mosaic/raw/KDDC\n",
- " /tmp/lrose_data/nexrad_mosaic/mdv/ruc\n",
- "```\n",
- "\n",
- "The output files will be stored in:\n",
- "\n",
- "```\n",
- " /tmp/lrose_data/nexrad_mosaic/cfradial (polar data)\n",
- " /tmp/lrose_data/nexrad_mosaic/mdv (Cartesian data)\n",
- " /tmp/lrose_data/nexrad_mosaic/spdb (temperature profile per radar)\n",
- "```"
- ]
- },
- {
- "cell_type": "markdown",
- "id": "52e9d69e",
- "metadata": {},
- "source": [
- "### Initialize python"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": 2,
- "id": "22982961",
- "metadata": {},
- "outputs": [
- {
- "name": "stdout",
- "output_type": "stream",
- "text": [
- "====>> nexradDataDir: /tmp/lrose_data/nexrad_mosaic\n"
- ]
- }
- ],
- "source": [
- "#\n",
- "# Extra packages to be added to anaconda3 standard packages for this notebook:\n",
- "#\n",
- "# conda update --all\n",
- "# conda install cartopy netCDF4\n",
- "# conda install -c conda-forge arm_pyart\n",
- "#\n",
- "\n",
- "import warnings\n",
- "warnings.filterwarnings('ignore')\n",
- "\n",
- "import os\n",
- "import datetime\n",
- "import pytz\n",
- "import math\n",
- "import numpy as np\n",
- "import matplotlib as mp\n",
- "import matplotlib.pyplot as plt\n",
- "import matplotlib.ticker as plticker\n",
- "from matplotlib.lines import Line2D\n",
- "import cartopy\n",
- "import cartopy.crs as ccrs\n",
- "import cartopy.io.shapereader as shpreader\n",
- "import cartopy.geodesic as cgds\n",
- "from cartopy.mpl.gridliner import LONGITUDE_FORMATTER, LATITUDE_FORMATTER\n",
- "from cartopy import feature as cfeature\n",
- "import shapely\n",
- "import netCDF4 as nc\n",
- "import pyart\n",
- "\n",
- "# Set data dir in environment variable\n",
- "os.environ['NEXRAD_DATA_DIR'] = '/tmp/lrose_data/nexrad_mosaic'\n",
- "nexradDataDir = os.environ['NEXRAD_DATA_DIR']\n",
- "print('====>> nexradDataDir: ', nexradDataDir)"
- ]
- },
- {
- "cell_type": "markdown",
- "id": "6de68023",
- "metadata": {},
- "source": [
- "### Download data sets from web"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": 3,
- "id": "f9f896c7",
- "metadata": {},
- "outputs": [
- {
- "name": "stdout",
- "output_type": "stream",
- "text": [
- "====>> Downloading data tar files into dir: /tmp/lrose_data/nexrad_mosaic\n",
- "--2022-08-23 17:16:34-- http://front.eol.ucar.edu/data/notebooks/nexrad_mosaic/nexrad_mosaic.KGLD.20210706_220000.tgz\n",
- "Resolving front.eol.ucar.edu (front.eol.ucar.edu)... 128.117.43.125\n",
- "Connecting to front.eol.ucar.edu (front.eol.ucar.edu)|128.117.43.125|:80... connected.\n",
- "HTTP request sent, awaiting response... 200 OK\n",
- "Length: 74762580 (71M) [application/x-gzip]\n",
- "Saving to: 'nexrad_mosaic.KGLD.20210706_220000.tgz'\n",
- "\n",
- "nexrad_mosaic.KGLD. 100%[===================>] 71.30M 111MB/s in 0.6s \n",
- "\n",
- "2022-08-23 17:16:35 (111 MB/s) - 'nexrad_mosaic.KGLD.20210706_220000.tgz' saved [74762580/74762580]\n",
- "\n",
- "--2022-08-23 17:16:35-- http://front.eol.ucar.edu/data/notebooks/nexrad_mosaic/nexrad_mosaic.KDDC.20210706_220000.tgz\n",
- "Resolving front.eol.ucar.edu (front.eol.ucar.edu)... 128.117.43.125\n",
- "Connecting to front.eol.ucar.edu (front.eol.ucar.edu)|128.117.43.125|:80... connected.\n",
- "HTTP request sent, awaiting response... 200 OK\n",
- "Length: 69853288 (67M) [application/x-gzip]\n",
- "Saving to: 'nexrad_mosaic.KDDC.20210706_220000.tgz'\n",
- "\n",
- "nexrad_mosaic.KDDC. 100%[===================>] 66.62M 109MB/s in 0.6s \n",
- "\n",
- "2022-08-23 17:16:35 (109 MB/s) - 'nexrad_mosaic.KDDC.20210706_220000.tgz' saved [69853288/69853288]\n",
- "\n",
- "--2022-08-23 17:16:36-- http://front.eol.ucar.edu/data/notebooks/nexrad_mosaic/nexrad_mosaic.KUEX.20210706_220000.tgz\n",
- "Resolving front.eol.ucar.edu (front.eol.ucar.edu)... 128.117.43.125\n",
- "Connecting to front.eol.ucar.edu (front.eol.ucar.edu)|128.117.43.125|:80... connected.\n",
- "HTTP request sent, awaiting response... 200 OK\n",
- "Length: 59062156 (56M) [application/x-gzip]\n",
- "Saving to: 'nexrad_mosaic.KUEX.20210706_220000.tgz'\n",
- "\n",
- "nexrad_mosaic.KUEX. 100%[===================>] 56.33M 111MB/s in 0.5s \n",
- "\n",
- "2022-08-23 17:16:36 (111 MB/s) - 'nexrad_mosaic.KUEX.20210706_220000.tgz' saved [59062156/59062156]\n",
- "\n",
- "--2022-08-23 17:16:37-- http://front.eol.ucar.edu/data/notebooks/nexrad_mosaic/nexrad_mosaic.ruc.20210706_220000.tgz\n",
- "Resolving front.eol.ucar.edu (front.eol.ucar.edu)... 128.117.43.125\n",
- "Connecting to front.eol.ucar.edu (front.eol.ucar.edu)|128.117.43.125|:80... connected.\n",
- "HTTP request sent, awaiting response... 200 OK\n",
- "Length: 4039462 (3.9M) [application/x-gzip]\n",
- "Saving to: 'nexrad_mosaic.ruc.20210706_220000.tgz'\n",
- "\n",
- "nexrad_mosaic.ruc.2 100%[===================>] 3.85M --.-KB/s in 0.06s \n",
- "\n",
- "2022-08-23 17:16:37 (68.3 MB/s) - 'nexrad_mosaic.ruc.20210706_220000.tgz' saved [4039462/4039462]\n",
- "\n",
- "====>> The following data files are unpacked in dir: /tmp/lrose_data/nexrad_mosaic\n",
- "mdv/\n",
- "mdv/ruc/\n",
- "mdv/ruc/20210706/\n",
- "mdv/ruc/20210706/20210706_230000.mdv.cf.nc\n",
- "raw/KGLD/\n",
- "raw/KGLD/20210706/\n",
- "raw/KGLD/20210706/KGLD20210706_220003_V06\n",
- "raw/KGLD/20210706/KGLD20210706_220448_V06\n",
- "raw/KGLD/20210706/KGLD20210706_220935_V06\n",
- "raw/KGLD/20210706/KGLD20210706_221420_V06\n",
- "raw/KGLD/20210706/KGLD20210706_221906_V06\n",
- "raw/KGLD/20210706/KGLD20210706_222350_V06\n",
- "raw/KGLD/20210706/KGLD20210706_222834_V06\n",
- "raw/KDDC/\n",
- "raw/KDDC/20210706/\n",
- "raw/KDDC/20210706/KDDC20210706_220000_V06\n",
- "raw/KDDC/20210706/KDDC20210706_220430_V06\n",
- "raw/KDDC/20210706/KDDC20210706_220921_V06\n",
- "raw/KDDC/20210706/KDDC20210706_221600_V06\n",
- "raw/KDDC/20210706/KDDC20210706_222051_V06\n",
- "raw/KDDC/20210706/KDDC20210706_222533_V06\n",
- "raw/KUEX/\n",
- "raw/KUEX/20210706/\n",
- "raw/KUEX/20210706/KUEX20210706_220249_V06\n",
- "raw/KUEX/20210706/KUEX20210706_220723_V06\n",
- "raw/KUEX/20210706/KUEX20210706_221204_V06\n",
- "raw/KUEX/20210706/KUEX20210706_221633_V06\n",
- "raw/KUEX/20210706/KUEX20210706_222102_V06\n",
- "raw/KUEX/20210706/KUEX20210706_222531_V06\n"
- ]
- }
- ],
- "source": [
- "# Download input data sets\n",
- "#\n",
- "# 1. NEXRAD raw data files for KGLD, KDDC and KUEX\n",
- "# 2. RUC model data for temperature profile, Kansas and surroundings\n",
- "#\n",
- "# These will be put in:\n",
- "# ${NEXRAD_DATA_DIR}\n",
- "#\n",
- "\n",
- "# ensure the data dir exists and is clean\n",
- "\n",
- "!/bin/rm -rf ${NEXRAD_DATA_DIR}\n",
- "!mkdir -p ${NEXRAD_DATA_DIR}\n",
- "\n",
- "# download the data from github\n",
- "\n",
- "print(\"====>> Downloading data tar files into dir: \", nexradDataDir)\n",
- "\n",
- "!cd ${NEXRAD_DATA_DIR}; wget http://front.eol.ucar.edu/data/notebooks/nexrad_mosaic/nexrad_mosaic.KGLD.20210706_220000.tgz \n",
- "!cd ${NEXRAD_DATA_DIR}; wget http://front.eol.ucar.edu/data/notebooks/nexrad_mosaic/nexrad_mosaic.KDDC.20210706_220000.tgz \n",
- "!cd ${NEXRAD_DATA_DIR}; wget http://front.eol.ucar.edu/data/notebooks/nexrad_mosaic/nexrad_mosaic.KUEX.20210706_220000.tgz \n",
- "!cd ${NEXRAD_DATA_DIR}; wget http://front.eol.ucar.edu/data/notebooks/nexrad_mosaic/nexrad_mosaic.ruc.20210706_220000.tgz \n",
- " \n",
- "# !cd ${NEXRAD_DATA_DIR}; wget https://raw.githubusercontent.com/NCAR/lrose-data-examples/master/notebooks/nexrad_mosaic/nexrad_mosaic.ruc.20210706_220000.tgz\n",
- "# !cd ${NEXRAD_DATA_DIR}; wget https://raw.githubusercontent.com/NCAR/lrose-data-examples/master/notebooks/nexrad_mosaic/nexrad_mosaic.KGLD.20210706_220000.tgz\n",
- "# !cd ${NEXRAD_DATA_DIR}; wget https://raw.githubusercontent.com/NCAR/lrose-data-examples/master/notebooks/nexrad_mosaic/nexrad_mosaic.KDDC.20210706_220000.tgz\n",
- "# !cd ${NEXRAD_DATA_DIR}; wget https://raw.githubusercontent.com/NCAR/lrose-data-examples/master/notebooks/nexrad_mosaic/nexrad_mosaic.KUEX.20210706_220000.tgz\n",
- "\n",
- "# extract the data from the tar files\n",
- "\n",
- "print(\"====>> The following data files are unpacked in dir: \", nexradDataDir)\n",
- "!cd ${NEXRAD_DATA_DIR}; tar xvfz nexrad_mosaic.ruc.20210706_220000.tgz\n",
- "!cd ${NEXRAD_DATA_DIR}; tar xvfz nexrad_mosaic.KGLD.20210706_220000.tgz\n",
- "!cd ${NEXRAD_DATA_DIR}; tar xvfz nexrad_mosaic.KDDC.20210706_220000.tgz\n",
- "!cd ${NEXRAD_DATA_DIR}; tar xvfz nexrad_mosaic.KUEX.20210706_220000.tgz\n",
- "\n",
- "# clean up\n",
- "\n",
- "!cd ${NEXRAD_DATA_DIR}; /bin/rm -f *tgz\n"
- ]
- },
- {
- "cell_type": "markdown",
- "id": "3511188c",
- "metadata": {},
- "source": [
- "## Notes on LROSE Parameter files\n",
- "\n",
- "All LROSE applications have a detailed parameter file, which is read in at startup.\n",
- "\n",
- "The parameters allow the user to control the processing in the LROSE apps.\n",
- "\n",
- "To generate a default parameter file, you use the -print_params option for the app.\n",
- "\n",
- "For example, for RadxConvert you would use:\n",
- "\n",
- "```\n",
- " RadxConvert -print_params > RadxConvert.nexrad\n",
- "```\n",
- "\n",
- "and then edit RadxConvert.nexrad appropriately.\n",
- "\n",
- "At runtime you would use:\n",
- "\n",
- "```\n",
- " RadxConvert -params RadxConvert.nexrad ... etc ...\n",
- "```"
- ]
- },
- {
- "cell_type": "markdown",
- "id": "d34dfd14",
- "metadata": {},
- "source": [
- "## View the RadxConvert parameter file\n",
- "\n",
- "Note that we can use environment variables in the parameter files.\n",
- "\n",
- "Environment variables are inserted using the format:\n",
- "\n",
- "```\n",
- " $(env_var_name)\n",
- "```\n",
- "\n",
- "For example:\n",
- "\n",
- "```\n",
- " input_dir = \"$(NEXRAD_DATA_DIR)/raw/$(RADAR_NAME)\";\n",
- "```\n"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": 4,
- "id": "9eccf394",
- "metadata": {},
- "outputs": [
- {
- "name": "stdout",
- "output_type": "stream",
- "text": [
- "/**********************************************************************\r\n",
- " * TDRP params for RadxConvert\r\n",
- " **********************************************************************/\r\n",
- "\r\n",
- "//======================================================================\r\n",
- "//\r\n",
- "// Converts files between CfRadial and other radial formats.\r\n",
- "//\r\n",
- "//======================================================================\r\n",
- " \r\n",
- "//======================================================================\r\n",
- "//\r\n",
- "// DEBUGGING.\r\n",
- "//\r\n",
- "//======================================================================\r\n",
- " \r\n",
- "///////////// debug ///////////////////////////////////\r\n",
- "//\r\n",
- "// Debug option.\r\n",
- "// If set, debug messages will be printed appropriately.\r\n",
- "//\r\n",
- "// Type: enum\r\n",
- "// Options:\r\n",
- "// DEBUG_OFF\r\n",
- "// DEBUG_NORM\r\n",
- "// DEBUG_VERBOSE\r\n",
- "// DEBUG_EXTRA\r\n",
- "//\r\n",
- "\r\n",
- "debug = DEBUG_OFF;\r\n",
- "\r\n",
- "///////////// instance ////////////////////////////////\r\n",
- "//\r\n",
- "// Program instance for process registration.\r\n",
- "// This application registers with procmap. This is the instance used \r\n",
- "// for registration.\r\n",
- "// Type: string\r\n",
- "//\r\n",
- "\r\n",
- "instance = \"$(RADAR_NAME)\";\r\n",
- "\r\n",
- "//======================================================================\r\n",
- "//\r\n",
- "// DATA INPUT.\r\n",
- "//\r\n",
- "//======================================================================\r\n",
- " \r\n",
- "///////////// input_dir ///////////////////////////////\r\n",
- "//\r\n",
- "// Input directory for searching for files.\r\n",
- "// Files will be searched for in this directory.\r\n",
- "// Type: string\r\n",
- "//\r\n",
- "\r\n",
- "input_dir = \"$(NEXRAD_DATA_DIR)/raw/$(RADAR_NAME)\";\r\n",
- "\r\n",
- "///////////// mode ////////////////////////////////////\r\n",
- "//\r\n",
- "// Operating mode.\r\n",
- "// In REALTIME mode, the program waits for a new input file. In ARCHIVE \r\n",
- "// mode, it moves through the data between the start and end times set \r\n",
- "// on the command line. In FILELIST mode, it moves through the list of \r\n",
- "// file names specified on the command line. Paths (in ARCHIVE mode, at \r\n",
- "// least) MUST contain a day-directory above the data file -- \r\n",
- "// ./data_file.ext will not work as a file path, but \r\n",
- "// ./yyyymmdd/data_file.ext will.\r\n",
- "//\r\n",
- "// Type: enum\r\n",
- "// Options:\r\n",
- "// REALTIME\r\n",
- "// ARCHIVE\r\n",
- "// FILELIST\r\n",
- "//\r\n",
- "\r\n",
- "mode = ARCHIVE;\r\n",
- "\r\n",
- "///////////// max_realtime_data_age_secs //////////////\r\n",
- "//\r\n",
- "// Maximum age of realtime data (secs).\r\n",
- "// Only data less old than this will be used.\r\n",
- "// Type: int\r\n",
- "//\r\n",
- "\r\n",
- "max_realtime_data_age_secs = 300;\r\n",
- "\r\n",
- "///////////// latest_data_info_avail //////////////////\r\n",
- "//\r\n",
- "// Is _latest_data_info file available?.\r\n",
- "// If TRUE, will watch the latest_data_info file. If FALSE, will scan \r\n",
- "// the input directory for new files.\r\n",
- "// Type: boolean\r\n",
- "//\r\n",
- "\r\n",
- "latest_data_info_avail = FALSE;\r\n",
- "\r\n",
- "///////////// search_recursively //////////////////////\r\n",
- "//\r\n",
- "// Option to recurse to subdirectories while looking for new files.\r\n",
- "// If TRUE, all subdirectories with ages less than max_dir_age will be \r\n",
- "// searched. This may take considerable CPU, so be careful in its use. \r\n",
- "// Only applies if latest_data_info_avail is FALSE.\r\n",
- "// Type: boolean\r\n",
- "//\r\n",
- "\r\n",
- "search_recursively = TRUE;\r\n",
- "\r\n",
- "///////////// max_recursion_depth /////////////////////\r\n",
- "//\r\n",
- "// Maximum depth for recursive directory scan.\r\n",
- "// Only applies search_recursively is TRUE. This is the max depth, below \r\n",
- "// input_dir, to which the recursive directory search will be carried \r\n",
- "// out. A depth of 0 will search the top-level directory only. A depth \r\n",
- "// of 1 will search the level below the top directory, etc.\r\n",
- "// Type: int\r\n",
- "//\r\n",
- "\r\n",
- "max_recursion_depth = 5;\r\n",
- "\r\n",
- "///////////// wait_between_checks /////////////////////\r\n",
- "//\r\n",
- "// Sleep time between checking directory for input - secs.\r\n",
- "// If a directory is large and files do not arrive frequently, set this \r\n",
- "// to a higher value to reduce the CPU load from checking the directory. \r\n",
- "// Only applies if latest_data_info_avail is FALSE.\r\n",
- "// Minimum val: 1\r\n",
- "// Type: int\r\n",
- "//\r\n",
- "\r\n",
- "wait_between_checks = 2;\r\n",
- "\r\n",
- "///////////// file_quiescence /////////////////////////\r\n",
- "//\r\n",
- "// File quiescence when checking for files - secs.\r\n",
- "// This allows you to make sure that a file coming from a remote machine \r\n",
- "// is complete before reading it. Only applies if latest_data_info_avail \r\n",
- "// is FALSE.\r\n",
- "// Type: int\r\n",
- "//\r\n",
- "\r\n",
- "file_quiescence = 60;\r\n",
- "\r\n",
- "///////////// search_ext //////////////////////////////\r\n",
- "//\r\n",
- "// File name extension.\r\n",
- "// If set, only files with this extension will be processed.\r\n",
- "// Type: string\r\n",
- "//\r\n",
- "\r\n",
- "search_ext = \"\";\r\n",
- "\r\n",
- "///////////// gematronik_realtime_mode ////////////////\r\n",
- "//\r\n",
- "// Set to TRUE if we are watching for Gematronik XML volumes.\r\n",
- "// Gematronik volumes (for a given time) are stored in multiple files, \r\n",
- "// one for each field. Therefore, after the time on a volume changes and \r\n",
- "// a new field file is detected, we need to wait a while to ensure that \r\n",
- "// all of the files have had a chance to be writted to disk. You need to \r\n",
- "// set gematronik_realtime_wait_secs to a value in excess of the time it \r\n",
- "// takes for all of the files to be written.\r\n",
- "// Type: boolean\r\n",
- "//\r\n",
- "\r\n",
- "gematronik_realtime_mode = FALSE;\r\n",
- "\r\n",
- "///////////// gematronik_realtime_wait_secs ///////////\r\n",
- "//\r\n",
- "// Number of seconds to wait, so that all field files can be written to \r\n",
- "// disk before we start to read.\r\n",
- "// See 'gematronik_realtime_mode'.\r\n",
- "// Type: int\r\n",
- "//\r\n",
- "\r\n",
- "gematronik_realtime_wait_secs = 5;\r\n",
- "\r\n",
- "//======================================================================\r\n",
- "//\r\n",
- "// OPTIONAL FIXED ANGLE OR SWEEP NUMBER LIMITS.\r\n",
- "//\r\n",
- "// Fixed angles are elevation in PPI mode and azimuth in RHI mode.\r\n",
- "//\r\n",
- "//======================================================================\r\n",
- " \r\n",
- "///////////// set_fixed_angle_limits //////////////////\r\n",
- "//\r\n",
- "// Option to set fixed angle limits.\r\n",
- "// Only use sweeps within the specified fixed angle limits.\r\n",
- "// Type: boolean\r\n",
- "//\r\n",
- "\r\n",
- "set_fixed_angle_limits = FALSE;\r\n",
- "\r\n",
- "///////////// lower_fixed_angle_limit /////////////////\r\n",
- "//\r\n",
- "// Lower fixed angle limit - degrees.\r\n",
- "// Type: double\r\n",
- "//\r\n",
- "\r\n",
- "lower_fixed_angle_limit = 0;\r\n",
- "\r\n",
- "///////////// upper_fixed_angle_limit /////////////////\r\n",
- "//\r\n",
- "// Upper fixed angle limit - degrees.\r\n",
- "// Type: double\r\n",
- "//\r\n",
- "\r\n",
- "upper_fixed_angle_limit = 90;\r\n",
- "\r\n",
- "///////////// set_sweep_num_limits ////////////////////\r\n",
- "//\r\n",
- "// Option to set sweep number limits.\r\n",
- "// If 'apply_strict_angle_limits' is set, only read sweeps within the \r\n",
- "// specified limits. If strict checking is false and no data lies within \r\n",
- "// the limits, return the closest applicable sweep.\r\n",
- "// Type: boolean\r\n",
- "//\r\n",
- "\r\n",
- "set_sweep_num_limits = FALSE;\r\n",
- "\r\n",
- "///////////// lower_sweep_num /////////////////////////\r\n",
- "//\r\n",
- "// Lower sweep number limit.\r\n",
- "// Type: int\r\n",
- "//\r\n",
- "\r\n",
- "lower_sweep_num = 0;\r\n",
- "\r\n",
- "///////////// upper_sweep_num /////////////////////////\r\n",
- "//\r\n",
- "// Upper sweep number limit.\r\n",
- "// Type: int\r\n",
- "//\r\n",
- "\r\n",
- "upper_sweep_num = 0;\r\n",
- "\r\n",
- "///////////// apply_strict_angle_limits ///////////////\r\n",
- "//\r\n",
- "// Option to apply strict checking for angle or sweep number limits on \r\n",
- "// read.\r\n",
- "// If true, an error will occur if the fixed angle limits or sweep num \r\n",
- "// limits are outside the bounds of the data. If false, a read is \r\n",
- "// guaranteed to return at least 1 sweep - if no sweep lies within the \r\n",
- "// angle limits set, the nearest sweep will be returned.\r\n",
- "// Type: boolean\r\n",
- "//\r\n",
- "\r\n",
- "apply_strict_angle_limits = TRUE;\r\n",
- "\r\n",
- "///////////// read_set_radar_num //////////////////////\r\n",
- "//\r\n",
- "// Option to set the radar number.\r\n",
- "// See read_radar_num.\r\n",
- "// Type: boolean\r\n",
- "//\r\n",
- "\r\n",
- "read_set_radar_num = FALSE;\r\n",
- "\r\n",
- "///////////// read_radar_num //////////////////////////\r\n",
- "//\r\n",
- "// Set the radar number for the data to be extracted.\r\n",
- "// Most files have data from a single radar, so this does not apply. The \r\n",
- "// NOAA HRD files, however, have data from both the lower fuselage (LF, \r\n",
- "// radar_num = 1) and tail (TA, radar_num = 2) radars. For HRD files, by \r\n",
- "// default the TA radar will be used, unless the radar num is set to 1 \r\n",
- "// for the LF radar.\r\n",
- "// Type: int\r\n",
- "//\r\n",
- "\r\n",
- "read_radar_num = 0;\r\n",
- "\r\n",
- "//======================================================================\r\n",
- "//\r\n",
- "// READ OPTIONS.\r\n",
- "//\r\n",
- "//======================================================================\r\n",
- " \r\n",
- "///////////// aggregate_sweep_files_on_read ///////////\r\n",
- "//\r\n",
- "// Option to aggregate sweep files into a volume on read.\r\n",
- "// If true, and the input data is in sweeps rather than volumes (e.g. \r\n",
- "// DORADE), the sweep files from a volume will be aggregated into a \r\n",
- "// volume.\r\n",
- "// Type: boolean\r\n",
- "//\r\n",
- "\r\n",
- "aggregate_sweep_files_on_read = FALSE;\r\n",
- "\r\n",
- "///////////// aggregate_all_files_on_read /////////////\r\n",
- "//\r\n",
- "// Option to aggregate all files in the file list on read.\r\n",
- "// If true, all of the files specified with the '-f' arg will be \r\n",
- "// aggregated into a single volume as they are read in. This only \r\n",
- "// applies to FILELIST mode. Overrides 'aggregate_sweep_files_on_read'.\r\n",
- "// Type: boolean\r\n",
- "//\r\n",
- "\r\n",
- "aggregate_all_files_on_read = FALSE;\r\n",
- "\r\n",
- "///////////// ignore_idle_scan_mode_on_read ///////////\r\n",
- "//\r\n",
- "// Option to ignore data taken in IDLE mode.\r\n",
- "// If true, on read will ignore files with an IDLE scan mode.\r\n",
- "// Type: boolean\r\n",
- "//\r\n",
- "\r\n",
- "ignore_idle_scan_mode_on_read = TRUE;\r\n",
- "\r\n",
- "///////////// remove_rays_with_all_data_missing ///////\r\n",
- "//\r\n",
- "// Option to remove rays for which all data is missing.\r\n",
- "// If true, ray data will be checked. If all fields have missing data at \r\n",
- "// all gates, the ray will be removed after reading.\r\n",
- "// Type: boolean\r\n",
- "//\r\n",
- "\r\n",
- "remove_rays_with_all_data_missing = FALSE;\r\n",
- "\r\n",
- "///////////// remove_rays_with_antenna_transitions ////\r\n",
- "//\r\n",
- "// Option to remove rays taken while the antenna was in transition.\r\n",
- "// If true, rays with the transition flag set will not be used. The \r\n",
- "// transiton flag is set when the antenna is in transtion between one \r\n",
- "// sweep and the next.\r\n",
- "// Type: boolean\r\n",
- "//\r\n",
- "\r\n",
- "remove_rays_with_antenna_transitions = FALSE;\r\n",
- "\r\n",
- "///////////// transition_nrays_margin /////////////////\r\n",
- "//\r\n",
- "// Number of transition rays to include as a margin.\r\n",
- "// Sometimes the transition flag is turned on too early in a transition, \r\n",
- "// on not turned off quickly enough after a transition. If you set this \r\n",
- "// to a number greater than 0, that number of rays will be included at \r\n",
- "// each end of the transition, i.e. the transition will effectively be \r\n",
- "// shorter at each end by this number of rays.\r\n",
- "// Type: int\r\n",
- "//\r\n",
- "\r\n",
- "transition_nrays_margin = 0;\r\n",
- "\r\n",
- "///////////// trim_surveillance_sweeps_to_360deg //////\r\n",
- "//\r\n",
- "// Option to trip surveillance sweeps so that they only cover 360 \r\n",
- "// degrees.\r\n",
- "// Some sweeps will have rays which cover more than a 360-degree \r\n",
- "// rotation. Often these include antenna transitions. If this is set to \r\n",
- "// true, rays are trimmed off either end of the sweep to limit the \r\n",
- "// coverage to 360 degrees. The median elevation angle is computed and \r\n",
- "// the end ray which deviates from the median in elevation is trimmed \r\n",
- "// first.\r\n",
- "// Type: boolean\r\n",
- "//\r\n",
- "\r\n",
- "trim_surveillance_sweeps_to_360deg = FALSE;\r\n",
- "\r\n",
- "///////////// set_max_range ///////////////////////////\r\n",
- "//\r\n",
- "// Option to set the max range for any ray.\r\n",
- "// Type: boolean\r\n",
- "//\r\n",
- "\r\n",
- "set_max_range = TRUE;\r\n",
- "\r\n",
- "///////////// max_range_km ////////////////////////////\r\n",
- "//\r\n",
- "// Specified maximim range - km.\r\n",
- "// Gates beyond this range are removed.\r\n",
- "// Type: double\r\n",
- "//\r\n",
- "\r\n",
- "max_range_km = 230.0;\r\n",
- "\r\n",
- "///////////// preserve_sweeps /////////////////////////\r\n",
- "//\r\n",
- "// Preserve sweeps just as they are in the file.\r\n",
- "// Applies generally to NEXRAD data. If true, the sweep details are \r\n",
- "// preserved. If false, we consolidate sweeps from split cuts into a \r\n",
- "// single sweep.\r\n",
- "// Type: boolean\r\n",
- "//\r\n",
- "\r\n",
- "preserve_sweeps = FALSE;\r\n",
- "\r\n",
- "///////////// remove_long_range_rays //////////////////\r\n",
- "//\r\n",
- "// Option to remove long range rays.\r\n",
- "// Applies to NEXRAD data. If true, data from the non-Doppler long-range \r\n",
- "// sweeps will be removed.\r\n",
- "// Type: boolean\r\n",
- "//\r\n",
- "\r\n",
- "remove_long_range_rays = TRUE;\r\n",
- "\r\n",
- "///////////// remove_short_range_rays /////////////////\r\n",
- "//\r\n",
- "// Option to remove short range rays.\r\n",
- "// Applies to NEXRAD data. If true, data from the Doppler short-range \r\n",
- "// sweeps will be removed.\r\n",
- "// Type: boolean\r\n",
- "//\r\n",
- "\r\n",
- "remove_short_range_rays = FALSE;\r\n",
- "\r\n",
- "///////////// set_ngates_constant /////////////////////\r\n",
- "//\r\n",
- "// Option to force the number of gates to be constant.\r\n",
- "// If TRUE, the number of gates on all rays will be set to the maximum, \r\n",
- "// and gates added to shorter rays will be filled with missing values.\r\n",
- "// Type: boolean\r\n",
- "//\r\n",
- "\r\n",
- "set_ngates_constant = FALSE;\r\n",
- "\r\n",
- "//======================================================================\r\n",
- "//\r\n",
- "// OPTION TO OVERRIDE INSTRUMENT AND/OR NAME.\r\n",
- "//\r\n",
- "//======================================================================\r\n",
- " \r\n",
- "///////////// override_instrument_name ////////////////\r\n",
- "//\r\n",
- "// Option to override the instrument name.\r\n",
- "// If true, the name provided will be used.\r\n",
- "// Type: boolean\r\n",
- "//\r\n",
- "\r\n",
- "override_instrument_name = FALSE;\r\n",
- "\r\n",
- "///////////// instrument_name /////////////////////////\r\n",
- "//\r\n",
- "// Instrument name.\r\n",
- "// See override_instrument_name.\r\n",
- "// Type: string\r\n",
- "//\r\n",
- "\r\n",
- "instrument_name = \"unknown\";\r\n",
- "\r\n",
- "///////////// override_site_name //////////////////////\r\n",
- "//\r\n",
- "// Option to override the site name.\r\n",
- "// If true, the name provided will be used.\r\n",
- "// Type: boolean\r\n",
- "//\r\n",
- "\r\n",
- "override_site_name = FALSE;\r\n",
- "\r\n",
- "///////////// site_name ///////////////////////////////\r\n",
- "//\r\n",
- "// Site name.\r\n",
- "// See override_site_name.\r\n",
- "// Type: string\r\n",
- "//\r\n",
- "\r\n",
- "site_name = \"unknown\";\r\n",
- "\r\n",
- "//======================================================================\r\n",
- "//\r\n",
- "// OPTION TO OVERRIDE RADAR LOCATION.\r\n",
- "//\r\n",
- "//======================================================================\r\n",
- " \r\n",
- "///////////// override_radar_location /////////////////\r\n",
- "//\r\n",
- "// Option to override the radar location.\r\n",
- "// If true, the location in this file will be used. If not, the location \r\n",
- "// in the time series data will be used.\r\n",
- "// Type: boolean\r\n",
- "//\r\n",
- "\r\n",
- "override_radar_location = FALSE;\r\n",
- "\r\n",
- "///////////// radar_latitude_deg //////////////////////\r\n",
- "//\r\n",
- "// Radar latitude (deg).\r\n",
- "// See override_radar_location.\r\n",
- "// Type: double\r\n",
- "//\r\n",
- "\r\n",
- "radar_latitude_deg = -999;\r\n",
- "\r\n",
- "///////////// radar_longitude_deg /////////////////////\r\n",
- "//\r\n",
- "// Radar longitude (deg).\r\n",
- "// See override_radar_location.\r\n",
- "// Type: double\r\n",
- "//\r\n",
- "\r\n",
- "radar_longitude_deg = -999;\r\n",
- "\r\n",
- "///////////// radar_altitude_meters ///////////////////\r\n",
- "//\r\n",
- "// Radar altitude (meters).\r\n",
- "// See override_radar_location.\r\n",
- "// Type: double\r\n",
- "//\r\n",
- "\r\n",
- "radar_altitude_meters = -999;\r\n",
- "\r\n",
- "///////////// change_radar_latitude_sign //////////////\r\n",
- "//\r\n",
- "// Option to negate the latitude.\r\n",
- "// Mainly useful for RAPIC files. In RAPIC, latitude is always positive, \r\n",
- "// so mostly you need to set the latitiude to the negative value of \r\n",
- "// itself.\r\n",
- "// Type: boolean\r\n",
- "//\r\n",
- "\r\n",
- "change_radar_latitude_sign = FALSE;\r\n",
- "\r\n",
- "///////////// apply_georeference_corrections //////////\r\n",
- "//\r\n",
- "// Option to apply the georeference info for moving platforms.\r\n",
- "// For moving platforms, measured georeference information is sometimes \r\n",
- "// available. If this is set to true, the georeference data is applied \r\n",
- "// and appropriate corrections made. If possible, Earth-centric azimuth \r\n",
- "// and elevation angles will be computed.\r\n",
- "// Type: boolean\r\n",
- "//\r\n",
- "\r\n",
- "apply_georeference_corrections = FALSE;\r\n",
- "\r\n",
- "//======================================================================\r\n",
- "//\r\n",
- "// OPTION TO OVERRIDE SELECTED GLOBAL ATTRIBUTES.\r\n",
- "//\r\n",
- "//======================================================================\r\n",
- " \r\n",
- "///////////// version_override ////////////////////////\r\n",
- "//\r\n",
- "// Option to override the version global attribute.\r\n",
- "// If empty, no effect. If not empty, this string is used to override \r\n",
- "// the version attribute.\r\n",
- "// Type: string\r\n",
- "//\r\n",
- "\r\n",
- "version_override = \"\";\r\n",
- "\r\n",
- "///////////// title_override //////////////////////////\r\n",
- "//\r\n",
- "// Option to override the title global attribute.\r\n",
- "// If empty, no effect. If not empty, this string is used to override \r\n",
- "// the title attribute.\r\n",
- "// Type: string\r\n",
- "//\r\n",
- "\r\n",
- "title_override = \"\";\r\n",
- "\r\n",
- "///////////// institution_override ////////////////////\r\n",
- "//\r\n",
- "// Option to override the institution global attribute.\r\n",
- "// If empty, no effect. If not empty, this string is used to override \r\n",
- "// the institution attribute.\r\n",
- "// Type: string\r\n",
- "//\r\n",
- "\r\n",
- "institution_override = \"\";\r\n",
- "\r\n",
- "///////////// references_override /////////////////////\r\n",
- "//\r\n",
- "// Option to override the references global attribute.\r\n",
- "// If empty, no effect. If not empty, this string is used to override \r\n",
- "// the references attribute.\r\n",
- "// Type: string\r\n",
- "//\r\n",
- "\r\n",
- "references_override = \"\";\r\n",
- "\r\n",
- "///////////// source_override /////////////////////////\r\n",
- "//\r\n",
- "// Option to override the source global attribute.\r\n",
- "// If empty, no effect. If not empty, this string is used to override \r\n",
- "// the source attribute.\r\n",
- "// Type: string\r\n",
- "//\r\n",
- "\r\n",
- "source_override = \"\";\r\n",
- "\r\n",
- "///////////// history_override ////////////////////////\r\n",
- "//\r\n",
- "// Option to override the history global attribute.\r\n",
- "// If empty, no effect. If not empty, this string is used to override \r\n",
- "// the history attribute.\r\n",
- "// Type: string\r\n",
- "//\r\n",
- "\r\n",
- "history_override = \"\";\r\n",
- "\r\n",
- "///////////// comment_override ////////////////////////\r\n",
- "//\r\n",
- "// Option to override the comment global attribute.\r\n",
- "// If empty, no effect. If not empty, this string is used to override \r\n",
- "// the comment attribute.\r\n",
- "// Type: string\r\n",
- "//\r\n",
- "\r\n",
- "comment_override = \"\";\r\n",
- "\r\n",
- "///////////// author_override /////////////////////////\r\n",
- "//\r\n",
- "// Option to override the author global attribute.\r\n",
- "// If empty, no effect. If not empty, this string is used to override \r\n",
- "// the author attribute.\r\n",
- "// Type: string\r\n",
- "//\r\n",
- "\r\n",
- "author_override = \"\";\r\n",
- "\r\n",
- "//======================================================================\r\n",
- "//\r\n",
- "// OPTION TO CORRECT ANTENNA ANGLES.\r\n",
- "//\r\n",
- "//======================================================================\r\n",
- " \r\n",
- "///////////// apply_azimuth_offset ////////////////////\r\n",
- "//\r\n",
- "// Option to apply an offset to the azimuth values.\r\n",
- "// If TRUE, this offset will be ADDED to the measured azimuth angles. \r\n",
- "// This is useful, for example, in the case of a mobile platform which \r\n",
- "// is not set up oriented to true north. Suppose you have a truck (like \r\n",
- "// the DOWs) which is oriented off true north. Then if you add in the \r\n",
- "// truck HEADING relative to true north, the measured azimuth angles \r\n",
- "// will be adjusted by the heading, to give azimuth relative to TRUE \r\n",
- "// north.\r\n",
- "// Type: boolean\r\n",
- "//\r\n",
- "\r\n",
- "apply_azimuth_offset = FALSE;\r\n",
- "\r\n",
- "///////////// azimuth_offset //////////////////////////\r\n",
- "//\r\n",
- "// Azimuth offset (degrees).\r\n",
- "// See 'apply_azimuth_offset'. This value will be ADDED to the measured \r\n",
- "// azimuths.\r\n",
- "// Type: double\r\n",
- "//\r\n",
- "\r\n",
- "azimuth_offset = 0;\r\n",
- "\r\n",
- "///////////// apply_elevation_offset //////////////////\r\n",
- "//\r\n",
- "// Option to apply an offset to the elevation values.\r\n",
- "// If TRUE, this offset will be ADDED to the measured elevation angles. \r\n",
- "// This is useful to correct for a systematic bias in measured elevation \r\n",
- "// angles.\r\n",
- "// Type: boolean\r\n",
- "//\r\n",
- "\r\n",
- "apply_elevation_offset = FALSE;\r\n",
- "\r\n",
- "///////////// elevation_offset ////////////////////////\r\n",
- "//\r\n",
- "// Elevation offset (degrees).\r\n",
- "// See 'apply_elevation_offset'. This value will be ADDED to the \r\n",
- "// measured elevations.\r\n",
- "// Type: double\r\n",
- "//\r\n",
- "\r\n",
- "elevation_offset = 0;\r\n",
- "\r\n",
- "//======================================================================\r\n",
- "//\r\n",
- "// OPTION TO SPECIFY FIELD NAMES AND OUTPUT ENCODING.\r\n",
- "//\r\n",
- "//======================================================================\r\n",
- " \r\n",
- "///////////// set_output_fields ///////////////////////\r\n",
- "//\r\n",
- "// Set the field names and output encoding.\r\n",
- "// If false, all fields will be used.\r\n",
- "// Type: boolean\r\n",
- "//\r\n",
- "\r\n",
- "set_output_fields = TRUE;\r\n",
- "\r\n",
- "///////////// output_fields ///////////////////////////\r\n",
- "//\r\n",
- "// Output field details.\r\n",
- "// Set the details for the output fields. The output_field_name is the \r\n",
- "// ndtCDF variable name. Set the long name to a more descriptive name. \r\n",
- "// Set the standard name to the CF standard name for this field. If the \r\n",
- "// long name or standard name are empty, the existing names are used. If \r\n",
- "// SCALING_SPECIFIED, then the scale and offset is used.\r\n",
- "//\r\n",
- "// Type: struct\r\n",
- "// typedef struct {\r\n",
- "// string input_field_name;\r\n",
- "// string output_field_name;\r\n",
- "// string long_name;\r\n",
- "// string standard_name;\r\n",
- "// string output_units;\r\n",
- "// output_encoding_t encoding;\r\n",
- "// Options:\r\n",
- "// OUTPUT_ENCODING_ASIS\r\n",
- "// OUTPUT_ENCODING_FLOAT32\r\n",
- "// OUTPUT_ENCODING_INT32\r\n",
- "// OUTPUT_ENCODING_INT16\r\n",
- "// OUTPUT_ENCODING_INT08\r\n",
- "// output_scaling_t output_scaling;\r\n",
- "// Options:\r\n",
- "// SCALING_DYNAMIC\r\n",
- "// SCALING_SPECIFIED\r\n",
- "// double output_scale;\r\n",
- "// double output_offset;\r\n",
- "// }\r\n",
- "//\r\n",
- "// 1D array - variable length.\r\n",
- "//\r\n",
- "\r\n",
- "output_fields = {\r\n",
- " {\r\n",
- " input_field_name = \"REF\",\r\n",
- " output_field_name = \"DBZ\",\r\n",
- " long_name = \"radar_reflectivity\",\r\n",
- " standard_name = \"equivalent_reflectivity_factor\",\r\n",
- " output_units = \"dBZ\",\r\n",
- " encoding = OUTPUT_ENCODING_INT16,\r\n",
- " output_scaling = SCALING_DYNAMIC,\r\n",
- " output_scale = 0.01,\r\n",
- " output_offset = 0\r\n",
- " }\r\n",
- " ,\r\n",
- " {\r\n",
- " input_field_name = \"VEL\",\r\n",
- " output_field_name = \"VEL\",\r\n",
- " long_name = \"radial_velocity\",\r\n",
- " standard_name = \"radial_velocity_of_scatterers_away_from_instrument\",\r\n",
- " output_units = \"m/s\",\r\n",
- " encoding = OUTPUT_ENCODING_INT16,\r\n",
- " output_scaling = SCALING_DYNAMIC,\r\n",
- " output_scale = 0.01,\r\n",
- " output_offset = 0\r\n",
- " }\r\n",
- " ,\r\n",
- " {\r\n",
- " input_field_name = \"SW\",\r\n",
- " output_field_name = \"WIDTH\",\r\n",
- " long_name = \"spectrum_width\",\r\n",
- " standard_name = \"doppler_spectrum_width\",\r\n",
- " output_units = \"m/s\",\r\n",
- " encoding = OUTPUT_ENCODING_INT16,\r\n",
- " output_scaling = SCALING_DYNAMIC,\r\n",
- " output_scale = 0.01,\r\n",
- " output_offset = 0\r\n",
- " }\r\n",
- " ,\r\n",
- " {\r\n",
- " input_field_name = \"ZDR\",\r\n",
- " output_field_name = \"ZDR\",\r\n",
- " long_name = \"differential_reflectivity\",\r\n",
- " standard_name = \"log_differential_reflectivity_hv\",\r\n",
- " output_units = \"dB\",\r\n",
- " encoding = OUTPUT_ENCODING_INT16,\r\n",
- " output_scaling = SCALING_DYNAMIC,\r\n",
- " output_scale = 0.01,\r\n",
- " output_offset = 0\r\n",
- " }\r\n",
- " ,\r\n",
- " {\r\n",
- " input_field_name = \"PHI\",\r\n",
- " output_field_name = \"PHIDP\",\r\n",
- " long_name = \"differential_phase\",\r\n",
- " standard_name = \"differential_phase_hv\",\r\n",
- " output_units = \"deg\",\r\n",
- " encoding = OUTPUT_ENCODING_INT16,\r\n",
- " output_scaling = SCALING_DYNAMIC,\r\n",
- " output_scale = 0.01,\r\n",
- " output_offset = 0\r\n",
- " }\r\n",
- " ,\r\n",
- " {\r\n",
- " input_field_name = \"RHO\",\r\n",
- " output_field_name = \"RHOHV\",\r\n",
- " long_name = \"cross_correlation\",\r\n",
- " standard_name = \"cross_correlation_ratio_hv\",\r\n",
- " output_units = \"\",\r\n",
- " encoding = OUTPUT_ENCODING_INT16,\r\n",
- " output_scaling = SCALING_DYNAMIC,\r\n",
- " output_scale = 0.01,\r\n",
- " output_offset = 0\r\n",
- " }\r\n",
- "};\r\n",
- "\r\n",
- "///////////// write_other_fields_unchanged ////////////\r\n",
- "//\r\n",
- "// Option to write out the unspecified fields as they are.\r\n",
- "// If false, only the fields listed in output_fields will be written. If \r\n",
- "// this is true, all other fields will be written unchanged.\r\n",
- "// Type: boolean\r\n",
- "//\r\n",
- "\r\n",
- "write_other_fields_unchanged = FALSE;\r\n",
- "\r\n",
- "///////////// exclude_specified_fields ////////////////\r\n",
- "//\r\n",
- "// Option to exclude fields in the specified list.\r\n",
- "// If true, the specified fields will be excluded. This may be easier \r\n",
- "// than specifiying all of the fields to be included, if that list is \r\n",
- "// very long.\r\n",
- "// Type: boolean\r\n",
- "//\r\n",
- "\r\n",
- "exclude_specified_fields = FALSE;\r\n",
- "\r\n",
- "///////////// excluded_fields /////////////////////////\r\n",
- "//\r\n",
- "// List of fields to be excluded.\r\n",
- "// List the names to be excluded.\r\n",
- "// Type: string\r\n",
- "// 1D array - variable length.\r\n",
- "//\r\n",
- "\r\n",
- "excluded_fields = {\r\n",
- " \"DBZ\",\r\n",
- " \"VEL\"\r\n",
- "};\r\n",
- "\r\n",
- "//======================================================================\r\n",
- "//\r\n",
- "// OPTION TO SPECIFY OUTPUT ENCODING FOR ALL FIELDS.\r\n",
- "//\r\n",
- "//======================================================================\r\n",
- " \r\n",
- "///////////// set_output_encoding_for_all_fields //////\r\n",
- "//\r\n",
- "// Option to set output encoding for all fields.\r\n",
- "// Type: boolean\r\n",
- "//\r\n",
- "\r\n",
- "set_output_encoding_for_all_fields = FALSE;\r\n",
- "\r\n",
- "///////////// output_encoding /////////////////////////\r\n",
- "//\r\n",
- "// Output encoding for all fields, if requested.\r\n",
- "//\r\n",
- "// Type: enum\r\n",
- "// Options:\r\n",
- "// OUTPUT_ENCODING_ASIS\r\n",
- "// OUTPUT_ENCODING_FLOAT32\r\n",
- "// OUTPUT_ENCODING_INT32\r\n",
- "// OUTPUT_ENCODING_INT16\r\n",
- "// OUTPUT_ENCODING_INT08\r\n",
- "//\r\n",
- "\r\n",
- "output_encoding = OUTPUT_ENCODING_ASIS;\r\n",
- "\r\n",
- "//======================================================================\r\n",
- "//\r\n",
- "// CENSORING.\r\n",
- "//\r\n",
- "// You have the option of censoring the data fields - i.e. setting the \r\n",
- "// fields to missing values - at gates which meet certain criteria. If \r\n",
- "// this is done correctly, it allows you to preserve the valid data and \r\n",
- "// discard the noise, thereby improving compression.\r\n",
- "//\r\n",
- "//======================================================================\r\n",
- " \r\n",
- "///////////// apply_censoring /////////////////////////\r\n",
- "//\r\n",
- "// Apply censoring based on field values and thresholds.\r\n",
- "// If TRUE, censoring will be performed. See 'censoring_fields' for \r\n",
- "// details on how the censoring is applied.\r\n",
- "// Type: boolean\r\n",
- "//\r\n",
- "\r\n",
- "apply_censoring = FALSE;\r\n",
- "\r\n",
- "///////////// censoring_fields ////////////////////////\r\n",
- "//\r\n",
- "// Fields to be used for censoring.\r\n",
- "// Specify the fields to be used to determine whether a gate should be \r\n",
- "// censored. The name refers to the input data field names. Valid field \r\n",
- "// values lie in the range from min_valid_value to max_valid_value \r\n",
- "// inclusive. If the value of a field at a gate lies within this range, \r\n",
- "// it is considered valid. Each specified field is examined at each \r\n",
- "// gate, and is flagged as valid if its value lies in the valid range. \r\n",
- "// These field flags are then combined as follows: first, all of the \r\n",
- "// LOGICAL_OR flags are combined, yielding a single combined_or flag \r\n",
- "// which is true if any of the LOGICAL_OR fields is true. The \r\n",
- "// combined_or flag is then combined with all of the LOGICAL_AND fields, \r\n",
- "// yielding a true value only if the combined_or flag and the \r\n",
- "// LOGICAL_AND fields are all true. If this final flag is true, then the \r\n",
- "// data at the gate is regarded as valid and is retained. If the final \r\n",
- "// flag is false, the data at the gate is censored, and all of the \r\n",
- "// fields at the gate are set to missing.\r\n",
- "//\r\n",
- "// Type: struct\r\n",
- "// typedef struct {\r\n",
- "// string name;\r\n",
- "// double min_valid_value;\r\n",
- "// double max_valid_value;\r\n",
- "// logical_t combination_method;\r\n",
- "// Options:\r\n",
- "// LOGICAL_AND\r\n",
- "// LOGICAL_OR\r\n",
- "// }\r\n",
- "//\r\n",
- "// 1D array - variable length.\r\n",
- "//\r\n",
- "\r\n",
- "censoring_fields = {\r\n",
- " {\r\n",
- " name = \"SNR\",\r\n",
- " min_valid_value = 0,\r\n",
- " max_valid_value = 1000,\r\n",
- " combination_method = LOGICAL_OR\r\n",
- " }\r\n",
- " ,\r\n",
- " {\r\n",
- " name = \"NCP\",\r\n",
- " min_valid_value = 0.15,\r\n",
- " max_valid_value = 1000,\r\n",
- " combination_method = LOGICAL_OR\r\n",
- " }\r\n",
- "};\r\n",
- "\r\n",
- "///////////// censoring_min_valid_run /////////////////\r\n",
- "//\r\n",
- "// Minimum valid run of non-censored gates.\r\n",
- "// Only active if set to 2 or greater. A check is made to remove short \r\n",
- "// runs of noise. Looking along the radial, we compute the number of \r\n",
- "// contiguous gates (a 'run') with uncensored data. For the gates in \r\n",
- "// this run to be accepted the length of the run must exceed \r\n",
- "// censoring_min_valid_run. If the number of gates in a run is less than \r\n",
- "// this, then all gates in the run are censored.\r\n",
- "// Type: int\r\n",
- "//\r\n",
- "\r\n",
- "censoring_min_valid_run = 1;\r\n",
- "\r\n",
- "//======================================================================\r\n",
- "//\r\n",
- "// OPTION TO APPLY LINEAR TRANSFORM TO SPECIFIED FIELDS.\r\n",
- "//\r\n",
- "// These transforms are fixed. The same transform is applied to all \r\n",
- "// files.\r\n",
- "//\r\n",
- "//======================================================================\r\n",
- " \r\n",
- "///////////// apply_linear_transforms /////////////////\r\n",
- "//\r\n",
- "// Apply linear transform to specified fields.\r\n",
- "// If true, we will apply a linear transform to selected fields.\r\n",
- "// Type: boolean\r\n",
- "//\r\n",
- "\r\n",
- "apply_linear_transforms = FALSE;\r\n",
- "\r\n",
- "///////////// transform_fields ////////////////////////\r\n",
- "//\r\n",
- "// transform field details.\r\n",
- "// Set the field name, scale and offset to be applied to the selected \r\n",
- "// fields. NOTE: the field name is the INPUT field name.\r\n",
- "//\r\n",
- "// Type: struct\r\n",
- "// typedef struct {\r\n",
- "// string input_field_name;\r\n",
- "// double transform_scale;\r\n",
- "// double transform_offset;\r\n",
- "// }\r\n",
- "//\r\n",
- "// 1D array - variable length.\r\n",
- "//\r\n",
- "\r\n",
- "transform_fields = {\r\n",
- " {\r\n",
- " input_field_name = \"DBZ\",\r\n",
- " transform_scale = 1,\r\n",
- " transform_offset = 0\r\n",
- " }\r\n",
- " ,\r\n",
- " {\r\n",
- " input_field_name = \"VEL\",\r\n",
- " transform_scale = 1,\r\n",
- " transform_offset = 0\r\n",
- " }\r\n",
- "};\r\n",
- "\r\n",
- "//======================================================================\r\n",
- "//\r\n",
- "// OPTION TO APPLY VARIABLE LINEAR TRANSFORM TO SPECIFIED FIELDS.\r\n",
- "//\r\n",
- "// These transforms vary from file to file, controlled by specific \r\n",
- "// metadata.\r\n",
- "//\r\n",
- "//======================================================================\r\n",
- " \r\n",
- "///////////// apply_variable_transforms ///////////////\r\n",
- "//\r\n",
- "// Apply linear transforms that vary based on specific metadata.\r\n",
- "// If true, we will apply variable linear transform to selected fields.\r\n",
- "// Type: boolean\r\n",
- "//\r\n",
- "\r\n",
- "apply_variable_transforms = FALSE;\r\n",
- "\r\n",
- "///////////// variable_transform_fields ///////////////\r\n",
- "//\r\n",
- "// Details for variable transforms.\r\n",
- "// We based the field decision off the input_field_name. You need to \r\n",
- "// pick the method of control: STATUS_XML_FIELD - based on the value \r\n",
- "// associated with an XML tag in the status block; ELEVATION_DEG - based \r\n",
- "// on the elevation in degrees; PULSE_WIDTH_US - based on the pulse with \r\n",
- "// in microsecs. For STATUS_XML_FIELD Set the relevant status_xml_tag, \r\n",
- "// which will be used to find the relevant value. The lookup table is a \r\n",
- "// series of entries specifying the metadata_value and the scale and \r\n",
- "// offset to be appied for that given metadata value. Each entry is \r\n",
- "// enclosed in parentheses, and is of the form (metadata_value, scale, \r\n",
- "// offset). The entries themselves are also are comma-separated. \r\n",
- "// Interpolation is used for metadata values that lie between those \r\n",
- "// specified in the lookup table. The enries in the lookup table should \r\n",
- "// have metadata_values that are monotonically increasing.\r\n",
- "//\r\n",
- "// Type: struct\r\n",
- "// typedef struct {\r\n",
- "// string input_field_name;\r\n",
- "// variable_transform_control_t control;\r\n",
- "// Options:\r\n",
- "// STATUS_XML_FIELD\r\n",
- "// string xml_tag;\r\n",
- "// string lookup_table;\r\n",
- "// }\r\n",
- "//\r\n",
- "// 1D array - variable length.\r\n",
- "//\r\n",
- "\r\n",
- "variable_transform_fields = {\r\n",
- " {\r\n",
- " input_field_name = \"dBZ\",\r\n",
- " control = STATUS_XML_FIELD,\r\n",
- " xml_tag = \"gdrxanctxfreq\",\r\n",
- " lookup_table = \"(57.0, 1.0, -0.7), (60.0, 1.0, -0.2), (64.0, 1.0, -0.3), (67.0, 1.0, -1.8), (68.0, 1.0, -1.2), (69.0, 1.0, -1.3)\"\r\n",
- " }\r\n",
- " ,\r\n",
- " {\r\n",
- " input_field_name = \"dBZv\",\r\n",
- " control = STATUS_XML_FIELD,\r\n",
- " xml_tag = \"gdrxanctxfreq\",\r\n",
- " lookup_table = \"(57.0, 1.0, 0.1), (58.0, 1.0, 0.3), (60.0, 1.0, -0.3), (67.0, 1.0, -2.3), (69.0, 1.0, -2.0)\"\r\n",
- " }\r\n",
- " ,\r\n",
- " {\r\n",
- " input_field_name = \"ZDR\",\r\n",
- " control = STATUS_XML_FIELD,\r\n",
- " xml_tag = \"gdrxanctxfreq\",\r\n",
- " lookup_table = \"(56.0, 1.0, -0.75), (58.0, 1.0, -0.75), (61.0, 1.0, 0.1), (63.5, 1.0, 0.2), (64.0, 1.0, 0.6), (69.0, 1.0, 0.6)\"\r\n",
- " }\r\n",
- "};\r\n",
- "\r\n",
- "//======================================================================\r\n",
- "//\r\n",
- "// OUTPUT FORMAT.\r\n",
- "//\r\n",
- "//======================================================================\r\n",
- " \r\n",
- "///////////// output_format ///////////////////////////\r\n",
- "//\r\n",
- "// Format for the output files.\r\n",
- "//\r\n",
- "// Type: enum\r\n",
- "// Options:\r\n",
- "// OUTPUT_FORMAT_CFRADIAL\r\n",
- "// OUTPUT_FORMAT_DORADE\r\n",
- "// OUTPUT_FORMAT_FORAY\r\n",
- "// OUTPUT_FORMAT_NEXRAD\r\n",
- "// OUTPUT_FORMAT_UF\r\n",
- "// OUTPUT_FORMAT_MDV_RADIAL\r\n",
- "//\r\n",
- "\r\n",
- "output_format = OUTPUT_FORMAT_CFRADIAL;\r\n",
- "\r\n",
- "///////////// netcdf_style ////////////////////////////\r\n",
- "//\r\n",
- "// NetCDF style - if output_format is CFRADIAL.\r\n",
- "// netCDF classic format, netCDF 64-bit offset format, netCDF4 using \r\n",
- "// HDF5 format, netCDF4 using HDF5 format but only netCDF3 calls.\r\n",
- "//\r\n",
- "// Type: enum\r\n",
- "// Options:\r\n",
- "// CLASSIC\r\n",
- "// NC64BIT\r\n",
- "// NETCDF4\r\n",
- "// NETCDF4_CLASSIC\r\n",
- "//\r\n",
- "\r\n",
- "netcdf_style = NETCDF4;\r\n",
- "\r\n",
- "//======================================================================\r\n",
- "//\r\n",
- "// OUTPUT BYTE-SWAPPING and COMPRESSION.\r\n",
- "//\r\n",
- "//======================================================================\r\n",
- " \r\n",
- "///////////// output_native_byte_order ////////////////\r\n",
- "//\r\n",
- "// Option to leave data in native byte order.\r\n",
- "// If false, data will be byte-swapped as appropriate on output.\r\n",
- "// Type: boolean\r\n",
- "//\r\n",
- "\r\n",
- "output_native_byte_order = FALSE;\r\n",
- "\r\n",
- "///////////// output_compressed ///////////////////////\r\n",
- "//\r\n",
- "// Option to compress data fields on output.\r\n",
- "// Applies to netCDF and Dorade. UF does not support compression.\r\n",
- "// Type: boolean\r\n",
- "//\r\n",
- "\r\n",
- "output_compressed = TRUE;\r\n",
- "\r\n",
- "//======================================================================\r\n",
- "//\r\n",
- "// OUTPUT OPTIONS FOR CfRadial FILES.\r\n",
- "//\r\n",
- "//======================================================================\r\n",
- " \r\n",
- "///////////// output_force_ngates_vary ////////////////\r\n",
- "//\r\n",
- "// Option to force the use of ragged arrays for CfRadial files.\r\n",
- "// Only applies to CfRadial. If true, forces the use of ragged arrays \r\n",
- "// even if the number of gates for all rays is constant.\r\n",
- "// Type: boolean\r\n",
- "//\r\n",
- "\r\n",
- "output_force_ngates_vary = FALSE;\r\n",
- "\r\n",
- "///////////// compression_level ///////////////////////\r\n",
- "//\r\n",
- "// Compression level for output, if compressed.\r\n",
- "// Applies to netCDF only. Dorade compression is run-length encoding, \r\n",
- "// and has not options..\r\n",
- "// Type: int\r\n",
- "//\r\n",
- "\r\n",
- "compression_level = 4;\r\n",
- "\r\n",
- "//======================================================================\r\n",
- "//\r\n",
- "// OUTPUT DIRECTORY AND FILE NAME.\r\n",
- "//\r\n",
- "//======================================================================\r\n",
- " \r\n",
- "///////////// output_dir //////////////////////////////\r\n",
- "//\r\n",
- "// Output directory path.\r\n",
- "// Files will be written to this directory.\r\n",
- "// Type: string\r\n",
- "//\r\n",
- "\r\n",
- "output_dir = \"$(NEXRAD_DATA_DIR)/cfradial/moments/$(RADAR_NAME)\";\r\n",
- "\r\n",
- "///////////// output_filename_mode ////////////////////\r\n",
- "//\r\n",
- "// Mode for computing output file name.\r\n",
- "// START_AND_END_TIMES: include both start and end times in file name. \r\n",
- "// START_TIME_ONLY: include only start time in file name. END_TIME_ONLY: \r\n",
- "// include only end time in file name. SPECIFY_FILE_NAME: file of this \r\n",
- "// name will be written to output_dir.\r\n",
- "//\r\n",
- "// Type: enum\r\n",
- "// Options:\r\n",
- "// START_AND_END_TIMES\r\n",
- "// START_TIME_ONLY\r\n",
- "// END_TIME_ONLY\r\n",
- "// SPECIFY_FILE_NAME\r\n",
- "//\r\n",
- "\r\n",
- "output_filename_mode = START_AND_END_TIMES;\r\n",
- "\r\n",
- "///////////// output_filename_prefix //////////////////\r\n",
- "//\r\n",
- "// Optional prefix for output filename.\r\n",
- "// If empty, the standard prefix will be used.\r\n",
- "// Type: string\r\n",
- "//\r\n",
- "\r\n",
- "output_filename_prefix = \"\";\r\n",
- "\r\n",
- "///////////// include_instrument_name_in_file_name ////\r\n",
- "//\r\n",
- "// Option to include the instrument name in the file name.\r\n",
- "// Default is true. Only applies to CfRadial files. If true, the \r\n",
- "// instrument name will be included just before the volume number in the \r\n",
- "// output file name.\r\n",
- "// Type: boolean\r\n",
- "//\r\n",
- "\r\n",
- "include_instrument_name_in_file_name = TRUE;\r\n",
- "\r\n",
- "///////////// include_subsecs_in_file_name ////////////\r\n",
- "//\r\n",
- "// Option to include sub-seconds in date-time part of file name.\r\n",
- "// Default is true. Only applies to CfRadial files. If true, the \r\n",
- "// millisecs of the start and end time will be included in the file \r\n",
- "// name.\r\n",
- "// Type: boolean\r\n",
- "//\r\n",
- "\r\n",
- "include_subsecs_in_file_name = TRUE;\r\n",
- "\r\n",
- "///////////// use_hyphen_in_file_name_datetime_part ///\r\n",
- "//\r\n",
- "// Option to use a hyphen between date and time in filename.\r\n",
- "// Default is false. Only applies to CfRadial files. Normally an \r\n",
- "// underscore is used.\r\n",
- "// Type: boolean\r\n",
- "//\r\n",
- "\r\n",
- "use_hyphen_in_file_name_datetime_part = FALSE;\r\n",
- "\r\n",
- "///////////// output_filename /////////////////////////\r\n",
- "//\r\n",
- "// Name of output file.\r\n",
- "// Applies only if output_filename_mode is SPECIFY_FILE_NAME. File of \r\n",
- "// this name will be written to output_dir.\r\n",
- "// Type: string\r\n",
- "//\r\n",
- "\r\n",
- "output_filename = \"cfradial.test.nc\";\r\n",
- "\r\n",
- "///////////// append_day_dir_to_output_dir ////////////\r\n",
- "//\r\n",
- "// Add the day directory to the output directory.\r\n",
- "// Path will be output_dir/yyyymmdd/filename.\r\n",
- "// Type: boolean\r\n",
- "//\r\n",
- "\r\n",
- "append_day_dir_to_output_dir = TRUE;\r\n",
- "\r\n",
- "///////////// append_year_dir_to_output_dir ///////////\r\n",
- "//\r\n",
- "// Add the year directory to the output directory.\r\n",
- "// Path will be output_dir/yyyy/yyyymmdd/filename.\r\n",
- "// Type: boolean\r\n",
- "//\r\n",
- "\r\n",
- "append_year_dir_to_output_dir = FALSE;\r\n",
- "\r\n",
- "///////////// write_individual_sweeps /////////////////\r\n",
- "//\r\n",
- "// Option to write out individual sweeps if appropriate.\r\n",
- "// If true, the volume is split into individual sweeps for writing. \r\n",
- "// Applies to CfRadial format. This is always true for DORADE format \r\n",
- "// files.\r\n",
- "// Type: boolean\r\n",
- "//\r\n",
- "\r\n",
- "write_individual_sweeps = FALSE;\r\n",
- "\r\n",
- "///////////// write_latest_data_info //////////////////\r\n",
- "//\r\n",
- "// Option to write out _latest_data_info files.\r\n",
- "// If true, the _latest_data_info files will be written after the \r\n",
- "// converted file is written.\r\n",
- "// Type: boolean\r\n",
- "//\r\n",
- "\r\n",
- "write_latest_data_info = TRUE;\r\n",
- "\r\n",
- "//======================================================================\r\n",
- "//\r\n",
- "// OPTION TO OVERRIDE MISSING VALUES.\r\n",
- "//\r\n",
- "// Missing values are applicable to both metadata and field data. The \r\n",
- "// default values should be satisfactory for most purposes. However, you \r\n",
- "// can choose to override these if you are careful with the selected \r\n",
- "// values.\r\n",
- "\r\n",
- "// The default values for metadata are:\r\n",
- "// \tmissingMetaDouble = -9999.0\r\n",
- "// \tmissingMetaFloat = -9999.0\r\n",
- "// \tmissingMetaInt = -9999\r\n",
- "// \tmissingMetaChar = -128\r\n",
- "\r\n",
- "// The default values for field data are:\r\n",
- "// \tmissingFl64 = -9.0e33\r\n",
- "// \tmissingFl32 = -9.0e33\r\n",
- "// \tmissingSi32 = -2147483647\r\n",
- "// \tmissingSi16 = -32768\r\n",
- "// \tmissingSi08 = -128.\r\n",
- "//\r\n",
- "//======================================================================\r\n",
- " \r\n",
- "///////////// override_missing_metadata_values ////////\r\n",
- "//\r\n",
- "// Option to override the missing values for meta-data.\r\n",
- "// See following parameter options.\r\n",
- "// Type: boolean\r\n",
- "//\r\n",
- "\r\n",
- "override_missing_metadata_values = FALSE;\r\n",
- "\r\n",
- "///////////// missing_metadata_double /////////////////\r\n",
- "//\r\n",
- "// Missing value for metadata of type double.\r\n",
- "// Only applies if override_missing_metadata_values is TRUE.\r\n",
- "// Type: double\r\n",
- "//\r\n",
- "\r\n",
- "missing_metadata_double = -9999;\r\n",
- "\r\n",
- "///////////// missing_metadata_float //////////////////\r\n",
- "//\r\n",
- "// Missing value for metadata of type float.\r\n",
- "// Only applies if override_missing_metadata_values is TRUE.\r\n",
- "// Type: float\r\n",
- "//\r\n",
- "\r\n",
- "missing_metadata_float = -9999;\r\n",
- "\r\n",
- "///////////// missing_metadata_int ////////////////////\r\n",
- "//\r\n",
- "// Missing value for metadata of type int.\r\n",
- "// Only applies if override_missing_metadata_values is TRUE.\r\n",
- "// Type: int\r\n",
- "//\r\n",
- "\r\n",
- "missing_metadata_int = -9999;\r\n",
- "\r\n",
- "///////////// missing_metadata_char ///////////////////\r\n",
- "//\r\n",
- "// Missing value for metadata of type char.\r\n",
- "// Only applies if override_missing_metadata_values is TRUE.\r\n",
- "// Type: int\r\n",
- "//\r\n",
- "\r\n",
- "missing_metadata_char = -128;\r\n",
- "\r\n",
- "///////////// override_missing_field_values ///////////\r\n",
- "//\r\n",
- "// Option to override the missing values for field data.\r\n",
- "// See following parameter options.\r\n",
- "// Type: boolean\r\n",
- "//\r\n",
- "\r\n",
- "override_missing_field_values = FALSE;\r\n",
- "\r\n",
- "///////////// missing_field_fl64 //////////////////////\r\n",
- "//\r\n",
- "// Missing value for field data of type 64-bit float.\r\n",
- "// Only applies if override_missing_field_values is TRUE.\r\n",
- "// Type: double\r\n",
- "//\r\n",
- "\r\n",
- "missing_field_fl64 = -9999;\r\n",
- "\r\n",
- "///////////// missing_field_fl32 //////////////////////\r\n",
- "//\r\n",
- "// Missing value for field data of type 32-bit float.\r\n",
- "// Only applies if override_missing_field_values is TRUE.\r\n",
- "// Type: double\r\n",
- "//\r\n",
- "\r\n",
- "missing_field_fl32 = -9999;\r\n",
- "\r\n",
- "///////////// missing_field_si32 //////////////////////\r\n",
- "//\r\n",
- "// Missing value for field data of type 32-bit integer.\r\n",
- "// Only applies if override_missing_field_values is TRUE.\r\n",
- "// Type: int\r\n",
- "//\r\n",
- "\r\n",
- "missing_field_si32 = -999999;\r\n",
- "\r\n",
- "///////////// missing_field_si16 //////////////////////\r\n",
- "//\r\n",
- "// Missing value for field data of type 16-bit integer.\r\n",
- "// Only applies if override_missing_field_values is TRUE.\r\n",
- "// Type: int\r\n",
- "//\r\n",
- "\r\n",
- "missing_field_si16 = -232768;\r\n",
- "\r\n",
- "///////////// missing_field_si08 //////////////////////\r\n",
- "//\r\n",
- "// Missing value for field data of type 8-bit integer.\r\n",
- "// Only applies if override_missing_field_values is TRUE.\r\n",
- "// Type: int\r\n",
- "//\r\n",
- "\r\n",
- "missing_field_si08 = -128;\r\n",
- "\r\n"
- ]
- }
- ],
- "source": [
- "# View the param file\n",
- "!cat ./params/RadxConvert.nexrad"
- ]
- },
- {
- "cell_type": "markdown",
- "id": "aabdc353",
- "metadata": {},
- "source": [
- "## Convert raw nexrad files to CfRadial format"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": 6,
- "id": "5f9c2fd1",
- "metadata": {},
- "outputs": [
- {
- "name": "stdout",
- "output_type": "stream",
- "text": [
- "======================================================================\n",
- "Program 'RadxConvert'\n",
- "Run-time 2022/08/23 23:18:17.\n",
- "\n",
- "Copyright (c) 1992 - 2022\n",
- "University Corporation for Atmospheric Research (UCAR)\n",
- "National Center for Atmospheric Research (NCAR)\n",
- "Boulder, Colorado, USA.\n",
- "\n",
- "Redistribution and use in source and binary forms, with\n",
- "or without modification, are permitted provided that the following\n",
- "conditions are met:\n",
- "\n",
- "1) Redistributions of source code must retain the above copyright\n",
- "notice, this list of conditions and the following disclaimer.\n",
- "\n",
- "2) Redistributions in binary form must reproduce the above copyright\n",
- "notice, this list of conditions and the following disclaimer in the\n",
- "documentation and/or other materials provided with the distribution.\n",
- "\n",
- "3) Neither the name of UCAR, NCAR nor the names of its contributors, if\n",
- "any, may be used to endorse or promote products derived from this\n",
- "software without specific prior written permission.\n",
- "\n",
- "4) If the software is modified to produce derivative works, such modified\n",
- "software should be clearly marked, so as not to confuse it with the\n",
- "version available from UCAR.\n",
- "\n",
- "======================================================================\n",
- "INFO - RadxConvert::Run\n",
- " Input path: /tmp/lrose_data/nexrad_mosaic/raw/KGLD/20210706/KGLD20210706_220003_V06\n",
- "WARNING - NexradRadxFile::readFromPath\n",
- " Adaptation data probably not set, ignoring\n",
- " File: /tmp/lrose_data/nexrad_mosaic/raw/KGLD/20210706/KGLD20210706_220003_V06\n",
- "INFO: RadxFile::writeToDir\n",
- " Writing CfRadial file to dir: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD\n",
- "DEBUG - NcfRadxFile::writeToDir\n",
- " Writing to dir: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD\n",
- "DEBUG - NcfRadxFile::writeToPath\n",
- " Writing to path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD/20210706/cfrad.20210706_220003.963_to_20210706_220439.770_KGLD_SUR.nc\n",
- " Tmp path is: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD/20210706/tmp.20569.1661296699.955749.tmp\n",
- " Writing fields and compressing ...\n",
- " ... writing field: DBZ\n",
- " ... writing field: VEL\n",
- " ... writing field: WIDTH\n",
- " ... writing field: ZDR\n",
- " ... writing field: PHIDP\n",
- " ... writing field: RHOHV\n",
- "DEBUG - NcfRadxFile::writeToPath\n",
- " Renamed tmp path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD/20210706/tmp.20569.1661296699.955749.tmp\n",
- " to final path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD/20210706/cfrad.20210706_220003.963_to_20210706_220439.770_KGLD_SUR.nc\n",
- "INFO: RadxFile::writeToDir\n",
- " Wrote CfRadial file to path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD/20210706/cfrad.20210706_220003.963_to_20210706_220439.770_KGLD_SUR.nc\n",
- "INFO - RadxConvert::Run\n",
- " Input path: /tmp/lrose_data/nexrad_mosaic/raw/KGLD/20210706/KGLD20210706_220448_V06\n",
- "WARNING - NexradRadxFile::readFromPath\n",
- " Adaptation data probably not set, ignoring\n",
- " File: /tmp/lrose_data/nexrad_mosaic/raw/KGLD/20210706/KGLD20210706_220448_V06\n",
- "INFO: RadxFile::writeToDir\n",
- " Writing CfRadial file to dir: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD\n",
- "DEBUG - NcfRadxFile::writeToDir\n",
- " Writing to dir: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD\n",
- "DEBUG - NcfRadxFile::writeToPath\n",
- " Writing to path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD/20210706/cfrad.20210706_220448.793_to_20210706_220926.383_KGLD_SUR.nc\n",
- " Tmp path is: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD/20210706/tmp.20569.1661296703.72851.tmp\n",
- " Writing fields and compressing ...\n",
- " ... writing field: DBZ\n",
- " ... writing field: VEL\n",
- " ... writing field: WIDTH\n",
- " ... writing field: ZDR\n",
- " ... writing field: PHIDP\n",
- " ... writing field: RHOHV\n",
- "DEBUG - NcfRadxFile::writeToPath\n",
- " Renamed tmp path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD/20210706/tmp.20569.1661296703.72851.tmp\n",
- " to final path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD/20210706/cfrad.20210706_220448.793_to_20210706_220926.383_KGLD_SUR.nc\n",
- "INFO: RadxFile::writeToDir\n",
- " Wrote CfRadial file to path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD/20210706/cfrad.20210706_220448.793_to_20210706_220926.383_KGLD_SUR.nc\n",
- "INFO - RadxConvert::Run\n",
- " Input path: /tmp/lrose_data/nexrad_mosaic/raw/KGLD/20210706/KGLD20210706_220935_V06\n",
- "WARNING - NexradRadxFile::readFromPath\n",
- " Adaptation data probably not set, ignoring\n",
- " File: /tmp/lrose_data/nexrad_mosaic/raw/KGLD/20210706/KGLD20210706_220935_V06\n",
- "INFO: RadxFile::writeToDir\n",
- " Writing CfRadial file to dir: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD\n",
- "DEBUG - NcfRadxFile::writeToDir\n",
- " Writing to dir: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD\n",
- "DEBUG - NcfRadxFile::writeToPath\n",
- " Writing to path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD/20210706/cfrad.20210706_220935.631_to_20210706_221411.627_KGLD_SUR.nc\n",
- " Tmp path is: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD/20210706/tmp.20569.1661296706.337293.tmp\n",
- " Writing fields and compressing ...\n",
- " ... writing field: DBZ\n",
- " ... writing field: VEL\n",
- " ... writing field: WIDTH\n",
- " ... writing field: ZDR\n",
- " ... writing field: PHIDP\n",
- " ... writing field: RHOHV\n",
- "DEBUG - NcfRadxFile::writeToPath\n",
- " Renamed tmp path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD/20210706/tmp.20569.1661296706.337293.tmp\n",
- " to final path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD/20210706/cfrad.20210706_220935.631_to_20210706_221411.627_KGLD_SUR.nc\n",
- "INFO: RadxFile::writeToDir\n",
- " Wrote CfRadial file to path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD/20210706/cfrad.20210706_220935.631_to_20210706_221411.627_KGLD_SUR.nc\n",
- "INFO - RadxConvert::Run\n",
- " Input path: /tmp/lrose_data/nexrad_mosaic/raw/KGLD/20210706/KGLD20210706_221420_V06\n",
- "WARNING - NexradRadxFile::readFromPath\n",
- " Adaptation data probably not set, ignoring\n",
- " File: /tmp/lrose_data/nexrad_mosaic/raw/KGLD/20210706/KGLD20210706_221420_V06\n",
- "INFO: RadxFile::writeToDir\n",
- " Writing CfRadial file to dir: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD\n",
- "DEBUG - NcfRadxFile::writeToDir\n",
- " Writing to dir: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD\n",
- "DEBUG - NcfRadxFile::writeToPath\n",
- " Writing to path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD/20210706/cfrad.20210706_221420.555_to_20210706_221857.324_KGLD_SUR.nc\n",
- " Tmp path is: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD/20210706/tmp.20569.1661296709.384453.tmp\n",
- " Writing fields and compressing ...\n",
- " ... writing field: DBZ\n",
- " ... writing field: VEL\n",
- " ... writing field: WIDTH\n",
- " ... writing field: ZDR\n",
- " ... writing field: PHIDP\n",
- " ... writing field: RHOHV\n",
- "DEBUG - NcfRadxFile::writeToPath\n",
- " Renamed tmp path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD/20210706/tmp.20569.1661296709.384453.tmp\n",
- " to final path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD/20210706/cfrad.20210706_221420.555_to_20210706_221857.324_KGLD_SUR.nc\n",
- "INFO: RadxFile::writeToDir\n",
- " Wrote CfRadial file to path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD/20210706/cfrad.20210706_221420.555_to_20210706_221857.324_KGLD_SUR.nc\n",
- "INFO - RadxConvert::Run\n",
- " Input path: /tmp/lrose_data/nexrad_mosaic/raw/KGLD/20210706/KGLD20210706_221906_V06\n",
- "WARNING - NexradRadxFile::readFromPath\n",
- " Adaptation data probably not set, ignoring\n",
- " File: /tmp/lrose_data/nexrad_mosaic/raw/KGLD/20210706/KGLD20210706_221906_V06\n",
- "INFO: RadxFile::writeToDir\n",
- " Writing CfRadial file to dir: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD\n",
- "DEBUG - NcfRadxFile::writeToDir\n",
- " Writing to dir: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD\n",
- "DEBUG - NcfRadxFile::writeToPath\n",
- " Writing to path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD/20210706/cfrad.20210706_221906.199_to_20210706_222341.850_KGLD_SUR.nc\n",
- " Tmp path is: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD/20210706/tmp.20569.1661296712.316541.tmp\n",
- " Writing fields and compressing ...\n",
- " ... writing field: DBZ\n",
- " ... writing field: VEL\n",
- " ... writing field: WIDTH\n",
- " ... writing field: ZDR\n",
- " ... writing field: PHIDP\n",
- " ... writing field: RHOHV\n",
- "DEBUG - NcfRadxFile::writeToPath\n",
- " Renamed tmp path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD/20210706/tmp.20569.1661296712.316541.tmp\n",
- " to final path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD/20210706/cfrad.20210706_221906.199_to_20210706_222341.850_KGLD_SUR.nc\n",
- "INFO: RadxFile::writeToDir\n",
- " Wrote CfRadial file to path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD/20210706/cfrad.20210706_221906.199_to_20210706_222341.850_KGLD_SUR.nc\n"
- ]
- },
- {
- "name": "stdout",
- "output_type": "stream",
- "text": [
- "INFO - RadxConvert::Run\n",
- " Input path: /tmp/lrose_data/nexrad_mosaic/raw/KGLD/20210706/KGLD20210706_222350_V06\n",
- "WARNING - NexradRadxFile::readFromPath\n",
- " Adaptation data probably not set, ignoring\n",
- " File: /tmp/lrose_data/nexrad_mosaic/raw/KGLD/20210706/KGLD20210706_222350_V06\n",
- "INFO: RadxFile::writeToDir\n",
- " Writing CfRadial file to dir: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD\n",
- "DEBUG - NcfRadxFile::writeToDir\n",
- " Writing to dir: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD\n",
- "DEBUG - NcfRadxFile::writeToPath\n",
- " Writing to path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD/20210706/cfrad.20210706_222350.154_to_20210706_222826.584_KGLD_SUR.nc\n",
- " Tmp path is: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD/20210706/tmp.20569.1661296715.451022.tmp\n",
- " Writing fields and compressing ...\n",
- " ... writing field: DBZ\n",
- " ... writing field: VEL\n",
- " ... writing field: WIDTH\n",
- " ... writing field: ZDR\n",
- " ... writing field: PHIDP\n",
- " ... writing field: RHOHV\n",
- "DEBUG - NcfRadxFile::writeToPath\n",
- " Renamed tmp path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD/20210706/tmp.20569.1661296715.451022.tmp\n",
- " to final path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD/20210706/cfrad.20210706_222350.154_to_20210706_222826.584_KGLD_SUR.nc\n",
- "INFO: RadxFile::writeToDir\n",
- " Wrote CfRadial file to path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD/20210706/cfrad.20210706_222350.154_to_20210706_222826.584_KGLD_SUR.nc\n",
- "INFO - RadxConvert::Run\n",
- " Input path: /tmp/lrose_data/nexrad_mosaic/raw/KGLD/20210706/KGLD20210706_222834_V06\n",
- "WARNING - NexradRadxFile::readFromPath\n",
- " Adaptation data probably not set, ignoring\n",
- " File: /tmp/lrose_data/nexrad_mosaic/raw/KGLD/20210706/KGLD20210706_222834_V06\n",
- "INFO: RadxFile::writeToDir\n",
- " Writing CfRadial file to dir: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD\n",
- "DEBUG - NcfRadxFile::writeToDir\n",
- " Writing to dir: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD\n",
- "DEBUG - NcfRadxFile::writeToPath\n",
- " Writing to path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD/20210706/cfrad.20210706_222834.963_to_20210706_223310.845_KGLD_SUR.nc\n",
- " Tmp path is: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD/20210706/tmp.20569.1661296718.213276.tmp\n",
- " Writing fields and compressing ...\n",
- " ... writing field: DBZ\n",
- " ... writing field: VEL\n",
- " ... writing field: WIDTH\n",
- " ... writing field: ZDR\n",
- " ... writing field: PHIDP\n",
- " ... writing field: RHOHV\n",
- "DEBUG - NcfRadxFile::writeToPath\n",
- " Renamed tmp path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD/20210706/tmp.20569.1661296718.213276.tmp\n",
- " to final path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD/20210706/cfrad.20210706_222834.963_to_20210706_223310.845_KGLD_SUR.nc\n",
- "INFO: RadxFile::writeToDir\n",
- " Wrote CfRadial file to path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD/20210706/cfrad.20210706_222834.963_to_20210706_223310.845_KGLD_SUR.nc\n",
- "======================================================================\n",
- "Program 'RadxConvert'\n",
- "Run-time 2022/08/23 23:18:39.\n",
- "\n",
- "Copyright (c) 1992 - 2022\n",
- "University Corporation for Atmospheric Research (UCAR)\n",
- "National Center for Atmospheric Research (NCAR)\n",
- "Boulder, Colorado, USA.\n",
- "\n",
- "Redistribution and use in source and binary forms, with\n",
- "or without modification, are permitted provided that the following\n",
- "conditions are met:\n",
- "\n",
- "1) Redistributions of source code must retain the above copyright\n",
- "notice, this list of conditions and the following disclaimer.\n",
- "\n",
- "2) Redistributions in binary form must reproduce the above copyright\n",
- "notice, this list of conditions and the following disclaimer in the\n",
- "documentation and/or other materials provided with the distribution.\n",
- "\n",
- "3) Neither the name of UCAR, NCAR nor the names of its contributors, if\n",
- "any, may be used to endorse or promote products derived from this\n",
- "software without specific prior written permission.\n",
- "\n",
- "4) If the software is modified to produce derivative works, such modified\n",
- "software should be clearly marked, so as not to confuse it with the\n",
- "version available from UCAR.\n",
- "\n",
- "======================================================================\n",
- "INFO - RadxConvert::Run\n",
- " Input path: /tmp/lrose_data/nexrad_mosaic/raw/KUEX/20210706/KUEX20210706_220249_V06\n",
- "WARNING - NexradRadxFile::readFromPath\n",
- " Adaptation data probably not set, ignoring\n",
- " File: /tmp/lrose_data/nexrad_mosaic/raw/KUEX/20210706/KUEX20210706_220249_V06\n",
- "INFO: RadxFile::writeToDir\n",
- " Writing CfRadial file to dir: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KUEX\n",
- "DEBUG - NcfRadxFile::writeToDir\n",
- " Writing to dir: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KUEX\n",
- "DEBUG - NcfRadxFile::writeToPath\n",
- " Writing to path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KUEX/20210706/cfrad.20210706_220249.032_to_20210706_220715.866_KUEX_SUR.nc\n",
- " Tmp path is: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KUEX/20210706/tmp.20588.1661296721.479173.tmp\n",
- " Writing fields and compressing ...\n",
- " ... writing field: DBZ\n",
- " ... writing field: VEL\n",
- " ... writing field: WIDTH\n",
- " ... writing field: ZDR\n",
- " ... writing field: PHIDP\n",
- " ... writing field: RHOHV\n",
- "DEBUG - NcfRadxFile::writeToPath\n",
- " Renamed tmp path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KUEX/20210706/tmp.20588.1661296721.479173.tmp\n",
- " to final path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KUEX/20210706/cfrad.20210706_220249.032_to_20210706_220715.866_KUEX_SUR.nc\n",
- "INFO: RadxFile::writeToDir\n",
- " Wrote CfRadial file to path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KUEX/20210706/cfrad.20210706_220249.032_to_20210706_220715.866_KUEX_SUR.nc\n",
- "INFO - RadxConvert::Run\n",
- " Input path: /tmp/lrose_data/nexrad_mosaic/raw/KUEX/20210706/KUEX20210706_220723_V06\n",
- "WARNING - NexradRadxFile::readFromPath\n",
- " Adaptation data probably not set, ignoring\n",
- " File: /tmp/lrose_data/nexrad_mosaic/raw/KUEX/20210706/KUEX20210706_220723_V06\n",
- "INFO: RadxFile::writeToDir\n",
- " Writing CfRadial file to dir: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KUEX\n",
- "DEBUG - NcfRadxFile::writeToDir\n",
- " Writing to dir: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KUEX\n",
- "DEBUG - NcfRadxFile::writeToPath\n",
- " Writing to path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KUEX/20210706/cfrad.20210706_220723.969_to_20210706_221157.362_KUEX_SUR.nc\n",
- " Tmp path is: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KUEX/20210706/tmp.20588.1661296724.703157.tmp\n",
- " Writing fields and compressing ...\n",
- " ... writing field: DBZ\n",
- " ... writing field: VEL\n",
- " ... writing field: WIDTH\n",
- " ... writing field: ZDR\n",
- " ... writing field: PHIDP\n",
- " ... writing field: RHOHV\n",
- "DEBUG - NcfRadxFile::writeToPath\n",
- " Renamed tmp path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KUEX/20210706/tmp.20588.1661296724.703157.tmp\n",
- " to final path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KUEX/20210706/cfrad.20210706_220723.969_to_20210706_221157.362_KUEX_SUR.nc\n",
- "INFO: RadxFile::writeToDir\n",
- " Wrote CfRadial file to path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KUEX/20210706/cfrad.20210706_220723.969_to_20210706_221157.362_KUEX_SUR.nc\n",
- "INFO - RadxConvert::Run\n",
- " Input path: /tmp/lrose_data/nexrad_mosaic/raw/KUEX/20210706/KUEX20210706_221204_V06\n",
- "WARNING - NexradRadxFile::readFromPath\n",
- " Adaptation data probably not set, ignoring\n",
- " File: /tmp/lrose_data/nexrad_mosaic/raw/KUEX/20210706/KUEX20210706_221204_V06\n",
- "INFO: RadxFile::writeToDir\n",
- " Writing CfRadial file to dir: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KUEX\n",
- "DEBUG - NcfRadxFile::writeToDir\n",
- " Writing to dir: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KUEX\n",
- "DEBUG - NcfRadxFile::writeToPath\n",
- " Writing to path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KUEX/20210706/cfrad.20210706_221204.520_to_20210706_221625.502_KUEX_SUR.nc\n",
- " Tmp path is: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KUEX/20210706/tmp.20588.1661296727.891951.tmp\n",
- " Writing fields and compressing ...\n",
- " ... writing field: DBZ\n",
- " ... writing field: VEL\n",
- " ... writing field: WIDTH\n",
- " ... writing field: ZDR\n",
- " ... writing field: PHIDP\n",
- " ... writing field: RHOHV\n",
- "DEBUG - NcfRadxFile::writeToPath\n",
- " Renamed tmp path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KUEX/20210706/tmp.20588.1661296727.891951.tmp\n",
- " to final path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KUEX/20210706/cfrad.20210706_221204.520_to_20210706_221625.502_KUEX_SUR.nc\n",
- "INFO: RadxFile::writeToDir\n",
- " Wrote CfRadial file to path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KUEX/20210706/cfrad.20210706_221204.520_to_20210706_221625.502_KUEX_SUR.nc\n"
- ]
- },
- {
- "name": "stdout",
- "output_type": "stream",
- "text": [
- "INFO - RadxConvert::Run\n",
- " Input path: /tmp/lrose_data/nexrad_mosaic/raw/KUEX/20210706/KUEX20210706_221633_V06\n",
- "WARNING - NexradRadxFile::readFromPath\n",
- " Adaptation data probably not set, ignoring\n",
- " File: /tmp/lrose_data/nexrad_mosaic/raw/KUEX/20210706/KUEX20210706_221633_V06\n",
- "INFO: RadxFile::writeToDir\n",
- " Writing CfRadial file to dir: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KUEX\n",
- "DEBUG - NcfRadxFile::writeToDir\n",
- " Writing to dir: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KUEX\n",
- "DEBUG - NcfRadxFile::writeToPath\n",
- " Writing to path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KUEX/20210706/cfrad.20210706_221633.850_to_20210706_222054.868_KUEX_SUR.nc\n",
- " Tmp path is: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KUEX/20210706/tmp.20588.1661296730.935994.tmp\n",
- " Writing fields and compressing ...\n",
- " ... writing field: DBZ\n",
- " ... writing field: VEL\n",
- " ... writing field: WIDTH\n",
- " ... writing field: ZDR\n",
- " ... writing field: PHIDP\n",
- " ... writing field: RHOHV\n",
- "DEBUG - NcfRadxFile::writeToPath\n",
- " Renamed tmp path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KUEX/20210706/tmp.20588.1661296730.935994.tmp\n",
- " to final path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KUEX/20210706/cfrad.20210706_221633.850_to_20210706_222054.868_KUEX_SUR.nc\n",
- "INFO: RadxFile::writeToDir\n",
- " Wrote CfRadial file to path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KUEX/20210706/cfrad.20210706_221633.850_to_20210706_222054.868_KUEX_SUR.nc\n",
- "INFO - RadxConvert::Run\n",
- " Input path: /tmp/lrose_data/nexrad_mosaic/raw/KUEX/20210706/KUEX20210706_222102_V06\n",
- "WARNING - NexradRadxFile::readFromPath\n",
- " Adaptation data probably not set, ignoring\n",
- " File: /tmp/lrose_data/nexrad_mosaic/raw/KUEX/20210706/KUEX20210706_222102_V06\n",
- "INFO: RadxFile::writeToDir\n",
- " Writing CfRadial file to dir: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KUEX\n",
- "DEBUG - NcfRadxFile::writeToDir\n",
- " Writing to dir: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KUEX\n",
- "DEBUG - NcfRadxFile::writeToPath\n",
- " Writing to path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KUEX/20210706/cfrad.20210706_222102.216_to_20210706_222523.504_KUEX_SUR.nc\n",
- " Tmp path is: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KUEX/20210706/tmp.20588.1661296734.109793.tmp\n",
- " Writing fields and compressing ...\n",
- " ... writing field: DBZ\n",
- " ... writing field: VEL\n",
- " ... writing field: WIDTH\n",
- " ... writing field: ZDR\n",
- " ... writing field: PHIDP\n",
- " ... writing field: RHOHV\n",
- "DEBUG - NcfRadxFile::writeToPath\n",
- " Renamed tmp path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KUEX/20210706/tmp.20588.1661296734.109793.tmp\n",
- " to final path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KUEX/20210706/cfrad.20210706_222102.216_to_20210706_222523.504_KUEX_SUR.nc\n",
- "INFO: RadxFile::writeToDir\n",
- " Wrote CfRadial file to path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KUEX/20210706/cfrad.20210706_222102.216_to_20210706_222523.504_KUEX_SUR.nc\n",
- "INFO - RadxConvert::Run\n",
- " Input path: /tmp/lrose_data/nexrad_mosaic/raw/KUEX/20210706/KUEX20210706_222531_V06\n",
- "WARNING - NexradRadxFile::readFromPath\n",
- " Adaptation data probably not set, ignoring\n",
- " File: /tmp/lrose_data/nexrad_mosaic/raw/KUEX/20210706/KUEX20210706_222531_V06\n",
- "INFO: RadxFile::writeToDir\n",
- " Writing CfRadial file to dir: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KUEX\n",
- "DEBUG - NcfRadxFile::writeToDir\n",
- " Writing to dir: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KUEX\n",
- "DEBUG - NcfRadxFile::writeToPath\n",
- " Writing to path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KUEX/20210706/cfrad.20210706_222531.244_to_20210706_222952.818_KUEX_SUR.nc\n",
- " Tmp path is: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KUEX/20210706/tmp.20588.1661296737.35478.tmp\n",
- " Writing fields and compressing ...\n",
- " ... writing field: DBZ\n",
- " ... writing field: VEL\n",
- " ... writing field: WIDTH\n",
- " ... writing field: ZDR\n",
- " ... writing field: PHIDP\n",
- " ... writing field: RHOHV\n",
- "DEBUG - NcfRadxFile::writeToPath\n",
- " Renamed tmp path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KUEX/20210706/tmp.20588.1661296737.35478.tmp\n",
- " to final path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KUEX/20210706/cfrad.20210706_222531.244_to_20210706_222952.818_KUEX_SUR.nc\n",
- "INFO: RadxFile::writeToDir\n",
- " Wrote CfRadial file to path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KUEX/20210706/cfrad.20210706_222531.244_to_20210706_222952.818_KUEX_SUR.nc\n",
- "======================================================================\n",
- "Program 'RadxConvert'\n",
- "Run-time 2022/08/23 23:18:58.\n",
- "\n",
- "Copyright (c) 1992 - 2022\n",
- "University Corporation for Atmospheric Research (UCAR)\n",
- "National Center for Atmospheric Research (NCAR)\n",
- "Boulder, Colorado, USA.\n",
- "\n",
- "Redistribution and use in source and binary forms, with\n",
- "or without modification, are permitted provided that the following\n",
- "conditions are met:\n",
- "\n",
- "1) Redistributions of source code must retain the above copyright\n",
- "notice, this list of conditions and the following disclaimer.\n",
- "\n",
- "2) Redistributions in binary form must reproduce the above copyright\n",
- "notice, this list of conditions and the following disclaimer in the\n",
- "documentation and/or other materials provided with the distribution.\n",
- "\n",
- "3) Neither the name of UCAR, NCAR nor the names of its contributors, if\n",
- "any, may be used to endorse or promote products derived from this\n",
- "software without specific prior written permission.\n",
- "\n",
- "4) If the software is modified to produce derivative works, such modified\n",
- "software should be clearly marked, so as not to confuse it with the\n",
- "version available from UCAR.\n",
- "\n",
- "======================================================================\n",
- "INFO - RadxConvert::Run\n",
- " Input path: /tmp/lrose_data/nexrad_mosaic/raw/KDDC/20210706/KDDC20210706_220000_V06\n",
- "WARNING - NexradRadxFile::readFromPath\n",
- " Adaptation data probably not set, ignoring\n",
- " File: /tmp/lrose_data/nexrad_mosaic/raw/KDDC/20210706/KDDC20210706_220000_V06\n",
- "INFO: RadxFile::writeToDir\n",
- " Writing CfRadial file to dir: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KDDC\n",
- "DEBUG - NcfRadxFile::writeToDir\n",
- " Writing to dir: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KDDC\n",
- "DEBUG - NcfRadxFile::writeToPath\n",
- " Writing to path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KDDC/20210706/cfrad.20210706_220000.765_to_20210706_220422.888_KDDC_SUR.nc\n",
- " Tmp path is: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KDDC/20210706/tmp.20608.1661296740.562900.tmp\n",
- " Writing fields and compressing ...\n",
- " ... writing field: DBZ\n",
- " ... writing field: VEL\n",
- " ... writing field: WIDTH\n",
- " ... writing field: ZDR\n",
- " ... writing field: PHIDP\n",
- " ... writing field: RHOHV\n",
- "DEBUG - NcfRadxFile::writeToPath\n",
- " Renamed tmp path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KDDC/20210706/tmp.20608.1661296740.562900.tmp\n",
- " to final path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KDDC/20210706/cfrad.20210706_220000.765_to_20210706_220422.888_KDDC_SUR.nc\n",
- "INFO: RadxFile::writeToDir\n",
- " Wrote CfRadial file to path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KDDC/20210706/cfrad.20210706_220000.765_to_20210706_220422.888_KDDC_SUR.nc\n",
- "INFO - RadxConvert::Run\n",
- " Input path: /tmp/lrose_data/nexrad_mosaic/raw/KDDC/20210706/KDDC20210706_220430_V06\n",
- "WARNING - NexradRadxFile::readFromPath\n",
- " Adaptation data probably not set, ignoring\n",
- " File: /tmp/lrose_data/nexrad_mosaic/raw/KDDC/20210706/KDDC20210706_220430_V06\n",
- "INFO: RadxFile::writeToDir\n",
- " Writing CfRadial file to dir: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KDDC\n",
- "DEBUG - NcfRadxFile::writeToDir\n",
- " Writing to dir: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KDDC\n",
- "DEBUG - NcfRadxFile::writeToPath\n",
- " Writing to path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KDDC/20210706/cfrad.20210706_220430.757_to_20210706_220912.758_KDDC_SUR.nc\n",
- " Tmp path is: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KDDC/20210706/tmp.20608.1661296744.43960.tmp\n",
- " Writing fields and compressing ...\n",
- " ... writing field: DBZ\n",
- " ... writing field: VEL\n",
- " ... writing field: WIDTH\n",
- " ... writing field: ZDR\n",
- " ... writing field: PHIDP\n",
- " ... writing field: RHOHV\n",
- "DEBUG - NcfRadxFile::writeToPath\n",
- " Renamed tmp path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KDDC/20210706/tmp.20608.1661296744.43960.tmp\n",
- " to final path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KDDC/20210706/cfrad.20210706_220430.757_to_20210706_220912.758_KDDC_SUR.nc\n",
- "INFO: RadxFile::writeToDir\n",
- " Wrote CfRadial file to path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KDDC/20210706/cfrad.20210706_220430.757_to_20210706_220912.758_KDDC_SUR.nc\n"
- ]
- },
- {
- "name": "stdout",
- "output_type": "stream",
- "text": [
- "INFO - RadxConvert::Run\n",
- " Input path: /tmp/lrose_data/nexrad_mosaic/raw/KDDC/20210706/KDDC20210706_220921_V06\n",
- "WARNING - NexradRadxFile::readFromPath\n",
- " Adaptation data probably not set, ignoring\n",
- " File: /tmp/lrose_data/nexrad_mosaic/raw/KDDC/20210706/KDDC20210706_220921_V06\n",
- "INFO: RadxFile::writeToDir\n",
- " Writing CfRadial file to dir: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KDDC\n",
- "DEBUG - NcfRadxFile::writeToDir\n",
- " Writing to dir: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KDDC\n",
- "DEBUG - NcfRadxFile::writeToPath\n",
- " Writing to path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KDDC/20210706/cfrad.20210706_220921.610_to_20210706_221350.957_KDDC_SUR.nc\n",
- " Tmp path is: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KDDC/20210706/tmp.20608.1661296747.410519.tmp\n",
- " Writing fields and compressing ...\n",
- " ... writing field: DBZ\n",
- " ... writing field: VEL\n",
- " ... writing field: WIDTH\n",
- " ... writing field: ZDR\n",
- " ... writing field: PHIDP\n",
- " ... writing field: RHOHV\n",
- "DEBUG - NcfRadxFile::writeToPath\n",
- " Renamed tmp path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KDDC/20210706/tmp.20608.1661296747.410519.tmp\n",
- " to final path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KDDC/20210706/cfrad.20210706_220921.610_to_20210706_221350.957_KDDC_SUR.nc\n",
- "INFO: RadxFile::writeToDir\n",
- " Wrote CfRadial file to path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KDDC/20210706/cfrad.20210706_220921.610_to_20210706_221350.957_KDDC_SUR.nc\n",
- "INFO - RadxConvert::Run\n",
- " Input path: /tmp/lrose_data/nexrad_mosaic/raw/KDDC/20210706/KDDC20210706_221600_V06\n",
- "WARNING - NexradRadxFile::readFromPath\n",
- " Adaptation data probably not set, ignoring\n",
- " File: /tmp/lrose_data/nexrad_mosaic/raw/KDDC/20210706/KDDC20210706_221600_V06\n",
- "INFO: RadxFile::writeToDir\n",
- " Writing CfRadial file to dir: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KDDC\n",
- "DEBUG - NcfRadxFile::writeToDir\n",
- " Writing to dir: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KDDC\n",
- "DEBUG - NcfRadxFile::writeToPath\n",
- " Writing to path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KDDC/20210706/cfrad.20210706_221600.999_to_20210706_222043.450_KDDC_SUR.nc\n",
- " Tmp path is: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KDDC/20210706/tmp.20608.1661296750.664431.tmp\n",
- " Writing fields and compressing ...\n",
- " ... writing field: DBZ\n",
- " ... writing field: VEL\n",
- " ... writing field: WIDTH\n",
- " ... writing field: ZDR\n",
- " ... writing field: PHIDP\n",
- " ... writing field: RHOHV\n",
- "DEBUG - NcfRadxFile::writeToPath\n",
- " Renamed tmp path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KDDC/20210706/tmp.20608.1661296750.664431.tmp\n",
- " to final path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KDDC/20210706/cfrad.20210706_221600.999_to_20210706_222043.450_KDDC_SUR.nc\n",
- "INFO: RadxFile::writeToDir\n",
- " Wrote CfRadial file to path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KDDC/20210706/cfrad.20210706_221600.999_to_20210706_222043.450_KDDC_SUR.nc\n",
- "INFO - RadxConvert::Run\n",
- " Input path: /tmp/lrose_data/nexrad_mosaic/raw/KDDC/20210706/KDDC20210706_222051_V06\n",
- "WARNING - NexradRadxFile::readFromPath\n",
- " Adaptation data probably not set, ignoring\n",
- " File: /tmp/lrose_data/nexrad_mosaic/raw/KDDC/20210706/KDDC20210706_222051_V06\n",
- "INFO: RadxFile::writeToDir\n",
- " Writing CfRadial file to dir: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KDDC\n",
- "DEBUG - NcfRadxFile::writeToDir\n",
- " Writing to dir: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KDDC\n",
- "DEBUG - NcfRadxFile::writeToPath\n",
- " Writing to path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KDDC/20210706/cfrad.20210706_222051.218_to_20210706_222526.565_KDDC_SUR.nc\n",
- " Tmp path is: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KDDC/20210706/tmp.20608.1661296754.68540.tmp\n",
- " Writing fields and compressing ...\n",
- " ... writing field: DBZ\n",
- " ... writing field: VEL\n",
- " ... writing field: WIDTH\n",
- " ... writing field: ZDR\n",
- " ... writing field: PHIDP\n",
- " ... writing field: RHOHV\n",
- "DEBUG - NcfRadxFile::writeToPath\n",
- " Renamed tmp path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KDDC/20210706/tmp.20608.1661296754.68540.tmp\n",
- " to final path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KDDC/20210706/cfrad.20210706_222051.218_to_20210706_222526.565_KDDC_SUR.nc\n",
- "INFO: RadxFile::writeToDir\n",
- " Wrote CfRadial file to path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KDDC/20210706/cfrad.20210706_222051.218_to_20210706_222526.565_KDDC_SUR.nc\n",
- "INFO - RadxConvert::Run\n",
- " Input path: /tmp/lrose_data/nexrad_mosaic/raw/KDDC/20210706/KDDC20210706_222533_V06\n",
- "WARNING - NexradRadxFile::readFromPath\n",
- " Adaptation data probably not set, ignoring\n",
- " File: /tmp/lrose_data/nexrad_mosaic/raw/KDDC/20210706/KDDC20210706_222533_V06\n",
- "INFO: RadxFile::writeToDir\n",
- " Writing CfRadial file to dir: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KDDC\n",
- "DEBUG - NcfRadxFile::writeToDir\n",
- " Writing to dir: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KDDC\n",
- "DEBUG - NcfRadxFile::writeToPath\n",
- " Writing to path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KDDC/20210706/cfrad.20210706_222533.934_to_20210706_223025.212_KDDC_SUR.nc\n",
- " Tmp path is: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KDDC/20210706/tmp.20608.1661296757.488861.tmp\n",
- " Writing fields and compressing ...\n",
- " ... writing field: DBZ\n",
- " ... writing field: VEL\n",
- " ... writing field: WIDTH\n",
- " ... writing field: ZDR\n",
- " ... writing field: PHIDP\n",
- " ... writing field: RHOHV\n",
- "DEBUG - NcfRadxFile::writeToPath\n",
- " Renamed tmp path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KDDC/20210706/tmp.20608.1661296757.488861.tmp\n",
- " to final path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KDDC/20210706/cfrad.20210706_222533.934_to_20210706_223025.212_KDDC_SUR.nc\n",
- "INFO: RadxFile::writeToDir\n",
- " Wrote CfRadial file to path: /tmp/lrose_data/nexrad_mosaic/cfradial/moments/KDDC/20210706/cfrad.20210706_222533.934_to_20210706_223025.212_KDDC_SUR.nc\n"
- ]
- }
- ],
- "source": [
- "# Convert raw nexrad data to cfradial for 3 NEXRAD radars\n",
- "\n",
- "for radar_name in ['KGLD', 'KUEX', 'KDDC']:\n",
- " # Set radar in name environment variable\n",
- " os.environ['RADAR_NAME'] = radar_name\n",
- " # Run RadxConvert using param file\n",
- " !/usr/local/lrose/bin/RadxConvert -params ./params/RadxConvert.nexrad -debug -start \"2021 07 06 22 00 00\" -end \"2021 07 06 22 30 00\"\n"
- ]
- },
- {
- "cell_type": "markdown",
- "id": "ac26ceb6",
- "metadata": {},
- "source": [
- "## List the CfRadial files created by RadxConvert"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": 7,
- "id": "100476d3",
- "metadata": {},
- "outputs": [
- {
- "name": "stdout",
- "output_type": "stream",
- "text": [
- "/tmp/lrose_data/nexrad_mosaic/cfradial/moments/KDDC/20210706:\r\n",
- "cfrad.20210706_220000.765_to_20210706_220422.888_KDDC_SUR.nc\r\n",
- "cfrad.20210706_220430.757_to_20210706_220912.758_KDDC_SUR.nc\r\n",
- "cfrad.20210706_220921.610_to_20210706_221350.957_KDDC_SUR.nc\r\n",
- "cfrad.20210706_221600.999_to_20210706_222043.450_KDDC_SUR.nc\r\n",
- "cfrad.20210706_222051.218_to_20210706_222526.565_KDDC_SUR.nc\r\n",
- "cfrad.20210706_222533.934_to_20210706_223025.212_KDDC_SUR.nc\r\n",
- "\r\n",
- "/tmp/lrose_data/nexrad_mosaic/cfradial/moments/KGLD/20210706:\r\n",
- "cfrad.20210706_220003.963_to_20210706_220439.770_KGLD_SUR.nc\r\n",
- "cfrad.20210706_220448.793_to_20210706_220926.383_KGLD_SUR.nc\r\n",
- "cfrad.20210706_220935.631_to_20210706_221411.627_KGLD_SUR.nc\r\n",
- "cfrad.20210706_221420.555_to_20210706_221857.324_KGLD_SUR.nc\r\n",
- "cfrad.20210706_221906.199_to_20210706_222341.850_KGLD_SUR.nc\r\n",
- "cfrad.20210706_222350.154_to_20210706_222826.584_KGLD_SUR.nc\r\n",
- "cfrad.20210706_222834.963_to_20210706_223310.845_KGLD_SUR.nc\r\n",
- "\r\n",
- "/tmp/lrose_data/nexrad_mosaic/cfradial/moments/KUEX/20210706:\r\n",
- "cfrad.20210706_220249.032_to_20210706_220715.866_KUEX_SUR.nc\r\n",
- "cfrad.20210706_220723.969_to_20210706_221157.362_KUEX_SUR.nc\r\n",
- "cfrad.20210706_221204.520_to_20210706_221625.502_KUEX_SUR.nc\r\n",
- "cfrad.20210706_221633.850_to_20210706_222054.868_KUEX_SUR.nc\r\n",
- "cfrad.20210706_222102.216_to_20210706_222523.504_KUEX_SUR.nc\r\n",
- "cfrad.20210706_222531.244_to_20210706_222952.818_KUEX_SUR.nc\r\n"
- ]
- }
- ],
- "source": [
- "# List the CfRadial files created by RadxConvert\n",
- "!ls -R ${NEXRAD_DATA_DIR}/cfradial/moments/K*/20*"
- ]
- },
- {
- "cell_type": "markdown",
- "id": "e885ed48",
- "metadata": {},
- "source": [
- "## Plot one example of the NEXRAD Goodland radar (KGLD) CfRadial files"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": 8,
- "id": "304e140e",
- "metadata": {},
- "outputs": [
- {
- "name": "stdout",
- "output_type": "stream",
- "text": [
- "altitude: ![\"Project](\"images/ProjectPythia_Logo_Final-01-Blue.svg\"){kind=logo}
"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "# Project Pythia Notebook Template\n",
- "\n",
- "Next, title your notebook appropriately with a top-level Markdown header, `#`. Do not use this level header anywhere else in the notebook. Our book build process will use this title in the navbar, table of contents, etc. Keep it short, keep it descriptive. Follow this with a `---` cell to visually distinguish the transition to the prerequisites section."
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "---"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## Overview\n",
- "If you have an introductory paragraph, lead with it here! Keep it short and tied to your material, then be sure to continue into the required list of topics below,\n",
- "\n",
- "1. This is a numbered list of the specific topics\n",
- "1. These should map approximately to your main sections of content\n",
- "1. Or each second-level, `##`, header in your notebook\n",
- "1. Keep the size and scope of your notebook in check\n",
- "1. And be sure to let the reader know up front the important concepts they'll be leaving with"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## Prerequisites\n",
- "This section was inspired by [this template](https://github.com/alan-turing-institute/the-turing-way/blob/master/book/templates/chapter-template/chapter-landing-page.md) of the wonderful [The Turing Way](https://the-turing-way.netlify.app) Jupyter Book.\n",
- "\n",
- "Following your overview, tell your reader what concepts, packages, or other background information they'll **need** before learning your material. Tie this explicitly with links to other pages here in Foundations or to relevant external resources. Remove this body text, then populate the Markdown table, denoted in this cell with `|` vertical brackets, below, and fill out the information following. In this table, lay out prerequisite concepts by explicitly linking to other Foundations material or external resources, or describe generally helpful concepts.\n",
- "\n",
- "Label the importance of each concept explicitly as **helpful/necessary**.\n",
- "\n",
- "| Concepts | Importance | Notes |\n",
- "| --- | --- | --- |\n",
- "| [Intro to Cartopy](https://foundations.projectpythia.org/core/cartopy/cartopy.html) | Necessary | |\n",
- "| [Understanding of NetCDF](https://foundations.projectpythia.org/core/data-formats/netcdf-cf.html) | Helpful | Familiarity with metadata structure |\n",
- "| Project management | Helpful | |\n",
- "\n",
- "- **Time to learn**: estimate in minutes. For a rough idea, use 5 mins per subsection, 10 if longer; add these up for a total. Safer to round up and overestimate.\n",
- "- **System requirements**:\n",
- " - Populate with any system, version, or non-Python software requirements if necessary\n",
- " - Otherwise use the concepts table above and the Imports section below to describe required packages as necessary\n",
- " - If no extra requirements, remove the **System requirements** point altogether"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "---"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## Imports\n",
- "Begin your body of content with another `---` divider before continuing into this section, then remove this body text and populate the following code cell with all necessary Python imports **up-front**:"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "import sys"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## Your first content section"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "This is where you begin your first section of material, loosely tied to your objectives stated up front. Tie together your notebook as a narrative, with interspersed Markdown text, images, and more as necessary,"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "# as well as any and all of your code cells\n",
- "print(\"Hello world!\")"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "### A content subsection\n",
- "Divide and conquer your objectives with Markdown subsections, which will populate the helpful navbar in Jupyter Lab and here on the Jupyter Book!"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "# some subsection code\n",
- "new = \"helpful information\""
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "### Another content subsection\n",
- "Keep up the good work! A note, *try to avoid using code comments as narrative*, and instead let them only exist as brief clarifications where necessary."
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## Your second content section\n",
- "Here we can move on to our second objective, and we can demonstrate"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "### Subsection to the second section\n",
- "\n",
- "#### a quick demonstration\n",
- "\n",
- "##### of further and further\n",
- "\n",
- "###### header levels"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "as well $m = a * t / h$ text! Similarly, you have access to other $\\LaTeX$ equation [**functionality**](https://jupyter-notebook.readthedocs.io/en/stable/examples/Notebook/Typesetting%20Equations.html) via MathJax (demo below from link),\n",
- "\n",
- "\\begin{align}\n",
- "\\dot{x} & = \\sigma(y-x) \\\\\n",
- "\\dot{y} & = \\rho x - y - xz \\\\\n",
- "\\dot{z} & = -\\beta z + xy\n",
- "\\end{align}"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "Check out [**any number of helpful Markdown resources**](https://www.markdownguide.org/basic-syntax/) for further customizing your notebooks and the [**Jupyter docs**](https://jupyter-notebook.readthedocs.io/en/stable/examples/Notebook/Working%20With%20Markdown%20Cells.html) for Jupyter-specific formatting information. Don't hesitate to ask questions if you have problems getting it to look *just right*."
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## Last Section\n",
- "\n",
- "If you're comfortable, and as we briefly used for our embedded logo up top, you can embed raw html into Jupyter Markdown cells (edit to see):"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "![\"qpe_op.png\"](\"images/qpe_op.png\")
"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "The agreement near the radar is not too bad, even with such a simple aggregation method. In the south we see some large discrepancies. This is due to the fact that the operational QPE includes many additional steps. In this case, the difference is likely due to the correction for partial beam blocking that is performed by the operational QPE in this mountaineous region south of the radar."
- ]
- }
- ],
- "metadata": {
- "kernelspec": {
- "display_name": "Python 3 (ipykernel)",
- "language": "python",
- "name": "python3"
- },
- "language_info": {
- "codemirror_mode": {
- "name": "ipython",
- "version": 3
- },
- "file_extension": ".py",
- "mimetype": "text/x-python",
- "name": "python",
- "nbconvert_exporter": "python",
- "pygments_lexer": "ipython3",
- "version": "3.9.13"
- },
- "widgets": {
- "application/vnd.jupyter.widget-state+json": {
- "state": {},
- "version_major": 2,
- "version_minor": 0
- }
- }
- },
- "nbformat": 4,
- "nbformat_minor": 4
-}
diff --git a/_preview/93/_sources/notebooks/pyart/exercice1_swiss_thunderstorm.ipynb b/_preview/93/_sources/notebooks/pyart/exercice1_swiss_thunderstorm.ipynb
deleted file mode 100644
index 9f5e5fe0..00000000
--- a/_preview/93/_sources/notebooks/pyart/exercice1_swiss_thunderstorm.ipynb
+++ /dev/null
@@ -1,400 +0,0 @@
-{
- "cells": [
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "# Filtering and retrievals on raw Swiss C-band data\n",
- "\n",
- "In this exercice we will load raw unfiltered Swiss C-band data during a thunderstorm event and process it to ultimately estimate the precipitation intensities. The following topics will be tackled.\n",
- "\n",
- "- Ground clutter detection\n",
- "- Attenuation correction\n",
- "- KDP estimation\n",
- "- Hydrometeor classification\n",
- "- QPE\n"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "# Imports\n",
- "\n",
- "import numpy as np\n",
- "import cartopy.crs as ccrs\n",
- "import cartopy\n",
- "import matplotlib.pyplot as plt\n",
- "\n",
- "import pyart\n",
- "pyart.config.load_config('mch_config.py')\n"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "Note that you can create your own Py-ART configuration file, which defines default field names, default colormaps, limits, and much more. This is the one we use at MeteoSwiss. You can then either load it at startup in your python code or define the environment variable PYART_CONFIG to point to your file in your work environment."
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## Reading the data\n",
- "\n",
- "Let's start by loading our radar file which is of the standard CFRadial type. It corresponds to the third sweep of the operational radar scans, which is a PPI at 1° elevation. It contains raw radar data (before pre-processing) at a resolution of 83 m. We then add the temperature obtained from the COSMO NWP model to our radar object (note that this temperature was previously interpolated from the model grid to the radar polar grid). Note that the freezing level is quite high in this example (around 4200 m.)."
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "# Open radar file\n",
- "file_radar = './data/exercice1_swiss_thunderstorm/MHL2217907250U.003.nc'\n",
- "radar = pyart.io.read_cfradial(file_radar)\n",
- "\n",
- "# Add temperature\n",
- "temp = pyart.io.read_cfradial('./data/exercice1_swiss_thunderstorm/20220628073500_savevol_COSMO_LOOKUP_TEMP.nc')\n",
- "radar.add_field('temperature', temp.fields['temperature'])\n"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## Ground-clutter and noise removal\n",
- "\n",
- "Py-ART uses gatefilters which are a kind of mask to filter out problematic measurements. Most processing routines can take a gatefilter as input and will ignore pixels that were filtered out. \n",
- "\n",
- "Here we create a gate __[filter](https://arm-doe.github.io/pyart/API/generated/pyart.filters.moment_and_texture_based_gate_filter.html)__ based on the radar moments and their texture to filter out noise and ground clutter. Since we are interested in a strong thunderstorm we also extend this filter to remove all measurements with a SNR ratio of less than 10 dB.\n",
- "\n"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "gtfilter = pyart.filters.moment_and_texture_based_gate_filter(radar)\n",
- "gtfilter.exclude_below('signal_to_noise_ratio', 10)"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "Let's compare visually the reflectivity before and after filtering. Note that the plot function of Py-ART take a gatefilter as input. "
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "fig, ax = plt.subplots(1,2, figsize=(10,6), sharex= True, sharey=True)\n",
- "display = pyart.graph.RadarDisplay(radar)\n",
- "display.plot_ppi('reflectivity', 0, vmin=0, vmax=60., ax = ax[0], colorbar_label = 'Raw')\n",
- "display.plot_ppi('reflectivity', 0, vmin=0, vmax=60., gatefilter = gtfilter, \n",
- " ax = ax[1], colorbar_label = 'Filtered')\n",
- "ax[0].set_xlim([-50,50])\n",
- "ax[0].set_ylim([-50,50])\n",
- "ax[0].set_aspect('equal', 'box')\n",
- "ax[1].set_aspect('equal', 'box')"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "Here it is clear that most ground clutter (mostly north west and east of the radar), as well as noise have been filtered out."
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## Attenuation correction\n",
- "\n",
- "We can expect strong attenuation behind a thunderstorm like this. So it is a good idea to try to correct for it. Knowledge of the specific attenuation can also be very insightful."
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "out = pyart.correct.calculate_attenuation_zphi(radar, fzl = 4200,\n",
- " gatefilter=gtfilter,\n",
- " phidp_field = 'uncorrected_differential_phase',\n",
- " temp_field = 'temperature',\n",
- " temp_ref = 'temperature')\n",
- "spec_at, pia, cor_z, spec_diff_at, pida, cor_zdr = out\n",
- "radar.add_field('corrected_reflectivity', cor_z)\n",
- "radar.add_field('corrected_differential_reflectivity', cor_zdr)\n",
- "radar.add_field('specific_attenuation', spec_at)\n"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "Here we use the Z-PHI method, which uses the relation between differential phase shift and specific attenuation. However it works only in the liquid phase. So you need to provide it either with a fixed freezing level height, a field of freezing level heights or a field of temperature. Here we provide the later.\n",
- "\n",
- "This method provides us with 5 output variables\n",
- "- specific attenuation dB/km\n",
- "- path integrated attenuation dB\n",
- "- corrected reflectivity dBZ\n",
- "- differential specific attenuation dB\n",
- "- path integrated differential attenuation dB\n",
- "- corrected differential reflectivity (ZDR) dB\n",
- "\n",
- "We will now plot the specific attenuation as well as the raw and corrected reflectivities."
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "fig, ax = plt.subplots(1,3, figsize=(16,6), sharex= True, sharey=True)\n",
- "display = pyart.graph.RadarDisplay(radar)\n",
- "display.plot_ppi('specific_attenuation', 0, vmin=0, vmax=1.5, gatefilter = gtfilter,\n",
- " ax = ax[0])\n",
- "display.plot_ppi('reflectivity', 0, vmin=0, vmax=60., ax = ax[1], gatefilter = gtfilter,\n",
- " colorbar_label = 'ZH with attenuation [dBZ]')\n",
- "display.plot_ppi('corrected_reflectivity', 0, vmin=0, vmax=60., gatefilter = gtfilter,\n",
- " ax = ax[2], colorbar_label = 'ZH attenuation corrected [dBZ]')\n",
- "ax[0].set_xlim([-50,50])\n",
- "ax[0].set_ylim([-50,50])\n",
- "ax[0].set_aspect('equal', 'box')\n",
- "ax[1].set_aspect('equal', 'box')\n",
- "ax[2].set_aspect('equal', 'box')"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "We can clearly observe a strong specific attenuation within the thunderstorm as well as a significant difference in reflectivity before/after correction behind the thunderstorm to the west."
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## KDP estimation\n",
- "\n",
- "Another very interesting radar variable is the specific differential phase shift KDP. Large KDP indicates the presence of large oblate drops and is linked to very strong precipitation. KDP is also needed for the hydrometeor classification algorithm. However KDP is not measured directly and needs to be estimated numerically from the raw differential phase shift (PHIDP). Py-ART provides three different retrieval methods. We will use the method by __[Maesaka et al. (2012)](https://arm-doe.github.io/pyart/API/generated/pyart.retrieve.kdp_maesaka.html)__ which is fast and robust but assumes KDP to be positive and is therefore limited to rainfall below the melting layer and/or warm clouds. "
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "kdp, _, _ = pyart.retrieve.kdp_maesaka(radar, gatefilter = gtfilter,\n",
- " psidp_field = 'uncorrected_differential_phase')\n",
- "radar.add_field('specific_differential_phase', kdp)\n",
- "\n",
- "fig, ax = plt.subplots(1,1, figsize=(6,6))\n",
- "display = pyart.graph.RadarDisplay(radar)\n",
- "display.plot_ppi('specific_differential_phase', 0, vmin = 0, vmax = 10,\n",
- " ax = ax, gatefilter = gtfilter)\n",
- "\n",
- "ax.set_xlim([-50,50])\n",
- "ax.set_ylim([-50,50])\n",
- "ax.set_aspect('equal', 'box')"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "A look at the KDP field shows clusters of very large KDP (> 5 °/km) at the center of the thunderstorm."
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## Hydrometeor classification\n",
- "\n",
- "The hydrometeor classification algorithm in Py-ART by __[Besic et al. (2016)](https://arm-doe.github.io/pyart/API/generated/pyart.retrieve.kdp_maesaka.html)__ uses ZH, ZDR, RHOHV, KDP and the temperature to classify hydrometeors into one of 8 classes:\n",
- "- Ice hail, high density Graupel\n",
- "- Melting hail\n",
- "- Wet snow\n",
- "- Vertically oriented ice\n",
- "- Rain\n",
- "- Rimed particles\n",
- "- Light rain\n",
- "- Crystals\n",
- "- Aggregates\n",
- "\n",
- "This algorithm requires centroids of polarimetric variables for the different hydrometeor classes. Below we provide it with centroids specifically suited for the radar of Monte Lema. If left empty, the algorithm will use default centroids at the right frequency band (X, C or S).\n"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "centroids = np.array([[13.8231,0.2514,0.0644,0.9861,1380.6],\n",
- "[3.0239,0.1971,0.,0.9661,1464.1],\n",
- "[4.9447,0.1142,0.,0.9787,-974.7],\n",
- "[34.2450,0.5540,0.1459,0.9937,945.3],\n",
- "[40.9432,1.0110,0.5141,0.9928,-993.5],\n",
- "[3.5202,-0.3498,0.,0.9746,843.2],\n",
- "[32.5287,0.9751,0.2640,0.9804,-55.5],\n",
- "[52.6547,2.7054,2.5101,0.9765,-1114.6],\n",
- "[46.4998,0.1978,0.6431,0.9845,1010.1]])\n",
- "\n",
- "\n",
- "hydro = pyart.retrieve.hydroclass_semisupervised(radar, mass_centers = centroids,\n",
- " refl_field = 'corrected_reflectivity',\n",
- " zdr_field = 'corrected_differential_reflectivity',\n",
- " kdp_field = 'specific_differential_phase',\n",
- " rhv_field = 'uncorrected_cross_correlation_ratio',\n",
- " temp_field = 'temperature')\n",
- "\n",
- "radar.add_field('radar_echo_classification', hydro)\n",
- "\n",
- "fig, ax = plt.subplots(1,1, figsize=(6,6))\n",
- "display = pyart.graph.RadarDisplay(radar)\n",
- "import matplotlib as mpl\n",
- "\n",
- "labels = ['NC','AG', 'CR', 'LR', 'RP', 'RN', 'VI', 'WS', 'MH', 'IH/HDG']\n",
- "ticks = np.arange(len(labels))\n",
- "boundaries = np.arange(-0.5, len(labels) )\n",
- "norm = mpl.colors.BoundaryNorm(boundaries, 256)\n",
- "\n",
- "cax = display.plot_ppi('radar_echo_classification', 0, ax = ax, gatefilter = gtfilter,\n",
- " norm = norm, ticks = ticks, ticklabs = labels)\n",
- "\n",
- "ax.set_xlim([-50,50])\n",
- "ax.set_ylim([-50,50])\n",
- "ax.set_aspect('equal', 'box')"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "Note that the plotting commands are slightly more complicated due to the categorical colormap.\n",
- "\n",
- "A look at the hydrometeor classification reveals the presence of wet hail in the center of the thunderstorm surrounded by rain and by light rain. A few isolated pixels (unfiltered ground clutter) are also classified as hail. \n",
- "There was indeed intense hail at the ground on that day."
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## QPE\n",
- "\n",
- "Py-ART provides several QPE algorithms but the most refined relies on the hydrometeor classification and uses different relations between radar variables and precipitation intensities within the different hydrometeor classes."
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "qpe = pyart.retrieve.est_rain_rate_hydro(radar, refl_field = 'corrected_reflectivity',\n",
- " hydro_field = 'radar_echo_classification',\n",
- " a_field = 'specific_attenuation',\n",
- " thresh=40)\n",
- "\n",
- "radar.add_field('radar_estimated_rain_rate', qpe)\n"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "We will now plot the precipitation intensity on a Cartopy map and add some spatial features (land borders) using __[RadarMapDisplay](https://arm-doe.github.io/pyart/API/generated/pyart.graph.GridMapDisplay.html)__"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "lon_bnds = [8.2, 9.5]\n",
- "lat_bnds = [45.5, 46.5]\n",
- "\n",
- "display = pyart.graph.RadarMapDisplay(radar)\n",
- "\n",
- "fig = plt.figure(figsize=(8,8))\n",
- "display.plot_ppi_map('radar_estimated_rain_rate', 0, vmin=0, vmax=120.,\n",
- " colorbar_label='', title='Precipitation intensity [mm/h]', gatefilter = gtfilter,\n",
- " min_lon = lon_bnds[0], max_lon = lon_bnds[1],mask_outside = True,\n",
- " min_lat = lat_bnds[0], max_lat = lat_bnds[1],\n",
- " lon_lines=np.arange(lon_bnds[0], lon_bnds[1], .2), resolution='10m',\n",
- " lat_lines=np.arange(lat_bnds[0], lat_bnds[1], .2),\n",
- " lat_0=radar.latitude['data'][0],\n",
- " lon_0=radar.longitude['data'][0], embellish=True)\n",
- "\n",
- "states_provinces = cartopy.feature.NaturalEarthFeature(\n",
- " category='cultural',\n",
- " name='admin_0_countries',\n",
- " scale='10m',\n",
- " facecolor='none')\n",
- "lakes = cartopy.feature.NaturalEarthFeature(\n",
- " category='physical',\n",
- " name='lakes',\n",
- " scale='10m',\n",
- " facecolor='blue')\n",
- "rivers = cartopy.feature.NaturalEarthFeature(\n",
- " category='physical',\n",
- " name='rivers',\n",
- " scale='10m',\n",
- " facecolor='blue')\n",
- "display.ax.add_feature(states_provinces, edgecolor='gray')\n",
- "display.ax.add_feature(lakes, edgecolor='blue', alpha = 0.25)\n",
- "display.ax.add_feature(cartopy.feature.RIVERS)\n",
- "\n"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "Note that we didn't estimate precipitation intensity at the ground but only aloft. Within the thunderstorm precipitation intensity is extremely high. This is likely too high because QPE in wet hail is very uncertain. However, even the operational QPE algorithm at MeteoSwiss estimated precipitation intensities at the ground close to 120 mm/h. "
- ]
- }
- ],
- "metadata": {
- "kernelspec": {
- "display_name": "Python 3 (ipykernel)",
- "language": "python",
- "name": "python3"
- },
- "language_info": {
- "codemirror_mode": {
- "name": "ipython",
- "version": 3
- },
- "file_extension": ".py",
- "mimetype": "text/x-python",
- "name": "python",
- "nbconvert_exporter": "python",
- "pygments_lexer": "ipython3",
- "version": "3.9.12"
- }
- },
- "nbformat": 4,
- "nbformat_minor": 4
-}
diff --git a/_preview/93/_sources/notebooks/pyart/exercice2_swiss_doppler.ipynb b/_preview/93/_sources/notebooks/pyart/exercice2_swiss_doppler.ipynb
deleted file mode 100644
index 4bd7cf2c..00000000
--- a/_preview/93/_sources/notebooks/pyart/exercice2_swiss_doppler.ipynb
+++ /dev/null
@@ -1,322 +0,0 @@
-{
- "cells": [
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "# Processing of Doppler wind data from a Swiss volumetric scan\n",
- "\n",
- "In this exercice we will load low-resolution filtered Swiss C-band data and process it to estimate a profile of horizontal wind aloft the radar. The following topics will be tackled.\n",
- "\n",
- "- Dealiasing of radial velocity\n",
- "- CAPPI plots and profiles\n",
- "- PseudoRHI profiles\n",
- "- Computation of a VAD (velocity azimuth display)\n"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "# Imports\n",
- "\n",
- "import numpy as np\n",
- "import cartopy.crs as ccrs\n",
- "import cartopy\n",
- "import matplotlib.pyplot as plt\n",
- "import glob\n",
- "\n",
- "import pyart\n",
- "pyart.config.load_config('mch_config.py')\n"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "\n",
- "## Reading and dealiasing the data\n",
- "\n",
- "The Swiss operational C-band radar network performs 20 PPIs at 20 different elevations (from 0.2° to 40°) every 5 minutes. All PPIs are stored in separate files. \n",
- "\n",
- "We will thus read all 20 elevations one after the other for a given timestep and use the Py-ART function __[join_radar](https://arm-doe.github.io/pyart/API/generated/pyart.util.join_radar.html?highlight=join_radar)__ to merge them all into a single radar object which containes 20 sweeps. \n",
- "\n",
- "To avoid using too much memory we will read the pre-processed MeteoSwiss radar data which has a resolution of 500 m in range.\n",
- "\n",
- "At the end, we will also dealias the radial velocity field. Indeed, at lower elevations, low PRFs are used which result in low Nyquist velocities between 8-12 m/s. This means that a lot of folding will occur, especially in strong winds. In this example we use the simplest dealiasing method of Py-ART which performs by finding regions of similar velocities and unfolding and merging pairs of regions until all regions are unfolded."
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "# Read all 20 elevations for one timestep\n",
- "files_radar = sorted(glob.glob('./data/exercice2_swiss_doppler/MLL221790725*'))\n",
- "for i,f in enumerate(files_radar):\n",
- " radar = pyart.io.read_cfradial(f)\n",
- " \n",
- " if i == 0:\n",
- " radar_merged = radar\n",
- " else:\n",
- " radar_merged = pyart.util.join_radar(radar_merged, \n",
- " radar)\n",
- " \n",
- "corr_vel = pyart.correct.dealias_region_based(radar_merged)\n",
- "radar_merged.add_field('corrected_velocity', corr_vel)"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "We will now plot the raw and dealiased velocities at two different elevations to see the effect of the correction.\n",
- "\n"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "fig, ax = plt.subplots(2,2, figsize=(10,10), sharex= True, sharey=True)\n",
- "ax = ax.ravel()\n",
- "display = pyart.graph.RadarDisplay(radar_merged)\n",
- "display.plot_ppi('velocity', 2, vmin=-30, vmax=30., ax = ax[0], title='El=1 deg',\n",
- " colorbar_label = 'Mean Doppler velocity (m/s)')\n",
- "display.plot_ppi('corrected_velocity', 2, vmin=-30, vmax=30., title='El=1 deg',\n",
- " ax = ax[1], colorbar_label = 'corr. Mean Doppler velocity (m/s)')\n",
- "display.plot_ppi('velocity', 6, vmin=-30, vmax=30., ax = ax[2], title='El=4.5 deg',\n",
- " colorbar_label = 'Mean Doppler velocity (m/s)')\n",
- "display.plot_ppi('corrected_velocity', 6, vmin=-30, vmax=30., title='El=4.5 deg',\n",
- " ax = ax[3], colorbar_label = 'corr. Mean Doppler velocity (m/s)')\n",
- "ax[0].set_xlim([-50,50])\n",
- "ax[0].set_ylim([-50,50])\n",
- "for a in ax:\n",
- " a.set_aspect('equal', 'box')"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "Indeed the raw velocity shows alternating bands of negative and positive velocities which indicates aliasing. The dealiased velocity looks much less discontinuous. Note however that a major difficulty for these algorithms is the presence of isolated pixels, which tend to get arbitrary values as can be seen in the south of the radar."
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## CAPPI plots\n",
- "\n",
- "We will now create a CAPPI (constant altitude PPI) of the reflectivity during this event. The idea is to interpolate the volumetric scan on a 3D Cartesian grid using the function __[grid_from_radars](https://arm-doe.github.io/pyart/API/generated/pyart.map.grid_from_radars.html)__. Here we will create slices every 500 m from 500 m to 8000 m above the radar."
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "zmin = 500\n",
- "zmax = 8000\n",
- "ymin= xmin = -100000\n",
- "ymax = xmax = 100000\n",
- "lat = float(radar.latitude['data'])\n",
- "lon = float(radar.longitude['data'])\n",
- "alt = float(radar.altitude['data'])\n",
- "# number of grid points in cappi\n",
- "cappi_res_h = 500\n",
- "cappi_res_v = 500\n",
- "ny = int((ymax-ymin)/cappi_res_h)+1\n",
- "nx = int((xmax-xmin)/cappi_res_h)+1\n",
- "nz = int((zmax-zmin)/cappi_res_v)+1\n",
- "\n",
- "cappi_zh = pyart.map.grid_from_radars(radar_merged, grid_shape=(nz, ny, nx),\n",
- " grid_limits=((zmin, zmax), (ymin, ymax),\n",
- " (xmin, xmax)),\n",
- " fields=['reflectivity'])\n"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "Now we plot the reflectivity at 4 different altitudes (0.5, 3, 5.5 and 8 km), as well as a profile along as a W-E profile at the radar location throught the thunderstorm."
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "display = pyart.graph.GridMapDisplay(cappi_zh)\n",
- "projection = ccrs.PlateCarree()\n",
- "fig = plt.figure(figsize=(18,14))\n",
- "ax = plt.subplot(221, projection = projection)\n",
- "display.plot_grid('reflectivity',0, ax = ax, projection = projection)\n",
- "ax = plt.subplot(222, projection = projection)\n",
- "display.plot_grid('reflectivity',5, ax = ax, projection = projection)\n",
- "ax = plt.subplot(223, projection = projection)\n",
- "display.plot_grid('reflectivity',10, ax = ax, projection = projection)\n",
- "ax = plt.subplot(224, projection = projection)\n",
- "display.plot_grid('reflectivity',15, ax = ax, projection = projection)\n",
- "\n",
- "ax = fig.add_axes([0.25, -0.20, .5, .25])\n",
- "display.plot_latitude_slice('reflectivity', lon=lon, lat=lat, ax = ax)\n"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "We will now create a pseudo RHI (altitudinal cross-section through a set of PPIs) of the radial velocity and the reflectivity through the thunderstorm at azimuth 270° (to the west)."
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "pseudorhi = pyart.util.cross_section_ppi(radar_merged, [270])\n",
- "\n",
- "display = pyart.graph.RadarDisplay(pseudorhi)\n",
- "fig, ax = plt.subplots(2,1, sharex=True,sharey=True, figsize= (10,10))\n",
- "display.plot_rhi('corrected_velocity', ax = ax[0], vmin = -30, vmax = 30)\n",
- "display.plot_rhi('reflectivity', ax = ax[1])\n",
- "ax[0].set_ylim([0,20])\n",
- "ax[0].set_xlim([0,100])\n",
- "\n"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "The convention at MeteoSwiss (which is different from the one used by Py-ART) is that positive velocities are moving away from the radar. In this example we see clearly the downdraft in the center of storm and the updraft in its surroundings."
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## Velocity azimuth display (VAD)\n",
- "\n",
- "We will now make a VAD retrieval to estimate the horizontal wind profile above the radar. This technique requires to have measurements in as many azimuths as possible and works better for stratiform rain when the radar coverage is wider. We will load data from a cold front event on the 13th July 2021 near the Albis radar (south of Zürich), that showed widespread precipitation around the radar. "
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "Unfortunately the VAD estimation technique in Py-ART can process only one sweep at a time. So we will average the wind vectors obtained over all sweeps to obtain a more reliable estimate. Note that we skip the first four sweeps which are more prone to ground echoes and have a very low Nyquist velocity."
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "files_radar = sorted(glob.glob('./data/question_pyart_meteoswiss/MLA211941205*'))\n",
- "u_allsweeps = []\n",
- "v_allsweeps = [] \n",
- "zlevels = np.arange(100,5000,100)\n",
- "speed = []\n",
- "for i,f in enumerate(files_radar[4:]):\n",
- " radar = pyart.io.read_cfradial(f)\n",
- " corr_vel = pyart.correct.dealias_region_based(radar)\n",
- " corr_vel['data'] *= -1 \n",
- " radar.add_field('corrected_velocity_neg', corr_vel)\n",
- " \n",
- " vad = pyart.retrieve.vad_browning(radar, 'corrected_velocity_neg', z_want = zlevels)\n",
- " u_allsweeps.append(vad.u_wind)\n",
- " v_allsweeps.append(vad.v_wind)\n",
- " \n",
- "u_avg = np.nanmean(np.array(u_allsweeps), axis = 0)\n",
- "v_avg = np.nanmean(np.array(v_allsweeps), axis = 0)\n",
- "orientation = np.rad2deg(np.arctan2(-u_avg, -v_avg))%360\n",
- "speed = np.sqrt(u_avg**2 + v_avg**2)\n"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "Note that because the convention at MeteoSwiss is different than the one in Py-ART we have to flip the sign of the radial velocity field. \n",
- "\n",
- "Finally we do a plot of the vertical profiles or horizontal wind speed and direction"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "fig,ax = plt.subplots(1,2, sharey=True)\n",
- "ax[0].plot(speed*2, zlevels+radar.altitude['data'])\n",
- "ax[1].plot(orientation, zlevels+radar.altitude['data'])\n",
- "ax[0].set_xlabel('Wind speed [m/s]')\n",
- "ax[1].set_xlabel('Wind direction [deg]')\n",
- "ax[0].set_ylabel('Altitude [m]')\n",
- "fig.suptitle('Wind profile obtained from VAD')"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "Now let's compare this wind profile with the one recorded by the nearest radiosounding operated in Payerne (around 130 km west from the radar):\n"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "![\"radiosounding_pay_20210713\"](\"images/radiosounding_pay_20210713.png\")
"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "Though there are some discrepancies the match is not bad, given the distance and the very different ways of measuring wind!"
- ]
- }
- ],
- "metadata": {
- "kernelspec": {
- "display_name": "Python 3 (ipykernel)",
- "language": "python",
- "name": "python3"
- },
- "language_info": {
- "codemirror_mode": {
- "name": "ipython",
- "version": 3
- },
- "file_extension": ".py",
- "mimetype": "text/x-python",
- "name": "python",
- "nbconvert_exporter": "python",
- "pygments_lexer": "ipython3",
- "version": "3.9.12"
- },
- "widgets": {
- "application/vnd.jupyter.widget-state+json": {
- "state": {},
- "version_major": 2,
- "version_minor": 0
- }
- }
- },
- "nbformat": 4,
- "nbformat_minor": 4
-}
diff --git a/_preview/93/_sources/notebooks/pyart/pyart-basics.ipynb b/_preview/93/_sources/notebooks/pyart/pyart-basics.ipynb
deleted file mode 100644
index 2a4a3c22..00000000
--- a/_preview/93/_sources/notebooks/pyart/pyart-basics.ipynb
+++ /dev/null
@@ -1,552 +0,0 @@
-{
- "cells": [
- {
- "cell_type": "markdown",
- "metadata": {
- "tags": []
- },
- "source": [
- "# Py-ART Basics\n",
- "---"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## Overview\n",
- " \n",
- "Within this notebook, we will cover:\n",
- "\n",
- "1. General overview of Py-ART and its functionality\n",
- "1. Reading data using Py-ART\n",
- "1. An overview of the `pyart.Radar` object\n",
- "1. Create a Plot of our Radar Data\n"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {
- "tags": []
- },
- "source": [
- "## Prerequisites\n",
- "| Concepts | Importance | Notes |\n",
- "| --- | --- | --- |\n",
- "| [Intro to Cartopy](https://foundations.projectpythia.org/core/cartopy/cartopy.html) | Helpful | Basic features |\n",
- "| [Matplotlib Basics](https://foundations.projectpythia.org/core/matplotlib/matplotlib-basics.html) | Helpful | Basic plotting |\n",
- "| [NumPy Basics](https://foundations.projectpythia.org/core/numpy/numpy-basics.html) | Helpful | Basic arrays |\n",
- "\n",
- "- **Time to learn**: 45 minutes\n",
- "---"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## Imports"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "import os\n",
- "import warnings\n",
- "\n",
- "import cartopy.crs as ccrs\n",
- "import matplotlib.pyplot as plt\n",
- "\n",
- "\n",
- "import pyart\n",
- "from pyart.testing import get_test_data\n",
- "\n",
- "warnings.filterwarnings('ignore')"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## An Overview of Py-ART"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {
- "tags": []
- },
- "source": [
- "### History of the Py-ART\n",
- "\n",
- " * Development began to address the needs of ARM with the acquisition of a number of\n",
- " new scanning cloud and precipitation radar as part of the American Recovery Act.\n",
- " * The project has since expanded to work with a variety of weather radars and a wider user\n",
- " base including radar researchers and climate modelers.\n",
- " * The software has been released on GitHub as open source software under a BSD license.\n",
- " Runs on Linux, OS X. It also runs on Windows with more limited functionality.\n",
- "\n",
- "### What can PyART Do?\n",
- "\n",
- "Py-ART can be used for a variety of tasks from basic plotting to more complex\n",
- "processing pipelines. Specific uses for Py-ART include:\n",
- "\n",
- " * Reading radar data in a variety of file formats.\n",
- " * Creating plots and visualization of radar data.\n",
- " * Correcting radar moments while in antenna coordinates, such as:\n",
- " * Doppler unfolding/de-aliasing.\n",
- " * Attenuation correction.\n",
- " * Phase processing using a Linear Programming method.\n",
- " * Mapping data from one or multiple radars onto a Cartesian grid.\n",
- " * Performing retrievals.\n",
- " * Writing radial and Cartesian data to NetCDF files."
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## Reading in Data Using Py-ART"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "### Reading data in using `pyart.io.read`"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "When reading in a radar file, we use the `pyart.io.read` module.\n",
- "\n",
- "`pyart.io.read` can read a variety of different radar formats, such as Cf/Radial, LASSEN, and more. \n",
- "The documentation on what formats can be read by Py-ART can be found here:\n",
- "\n",
- "* [Py-ART IO Documentation](https://arm-doe.github.io/pyart/API/generated/pyart.io.html)\n",
- "\n",
- "For most file formats listed on the page, using `pyart.io.read` should suffice since Py-ART has the ability to automatically detect the file format.\n",
- "\n",
- "Let's check out what arguments arguments `pyart.io.read()` takes in!"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "pyart.io.read?"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "Let's use a sample data file from `pyart` - which is [**cfradial** format](https://github.com/NCAR/CfRadial).\n",
- "\n",
- "When we read this in, we get a [`pyart.Radar` object](https://arm-doe.github.io/pyart/API/generated/pyart.core.Radar.html#pyart.core.Radar)!"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "file = get_test_data('swx_20120520_0641.nc')\n",
- "radar = pyart.io.read(file)\n",
- "radar"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "### Investigate the [`pyart.Radar` object](https://arm-doe.github.io/pyart/API/generated/pyart.core.Radar.html#pyart.core.Radar)"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "Within this [`pyart.Radar` object](https://arm-doe.github.io/pyart/API/generated/pyart.core.Radar.html#pyart.core.Radar) object are the actual data fields.\n",
- "\n",
- "This is where data such as reflectivity and velocity are stored.\n",
- "\n",
- "To see what fields are present we can add the fields and keys additions to the variable where the radar object is stored."
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "radar.fields.keys()"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "#### Extract a sample data field"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "The fields are stored in a dictionary, each containing coordinates, units and more.\n",
- "All can be accessed by just adding the fields addition to the radar object variable.\n",
- "\n",
- "For an individual field, we add a string in brackets after the fields addition to see\n",
- "the contents of that field.\n",
- "\n",
- "Let's take a look at `'corrected_reflectivity_horizontal'`, which is a common field to investigate."
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "print(radar.fields['corrected_reflectivity_horizontal'])"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "We can go even further in the dictionary and access the actual reflectivity data.\n",
- "\n",
- "We use add `'data'` at the end, which will extract the **data array** (which is a masked numpy array) from the dictionary."
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {
- "tags": []
- },
- "outputs": [],
- "source": [
- "reflectivity = radar.fields['corrected_reflectivity_horizontal']['data']\n",
- "print(type(reflectivity), reflectivity)"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "Lets' check the size of this array..."
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "reflectivity.shape"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "This reflectivity data array, numpy array, is a two-dimensional array with dimensions:\n",
- "- Gates (number of samples away from the radar)\n",
- "- Rays (direction around the radar)"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "print(radar.nrays, radar.ngates)"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "If we wanted to look the 300th ray, at the second gate, we would use something like the following:"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "print(reflectivity[300, 2])"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## Plotting our Radar Data"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {
- "tags": []
- },
- "source": [
- "### An Overview of Py-ART Plotting Utilities\n",
- "\n",
- "Now that we have loaded the data and inspected it, the next logical thing to do is to visualize the data! Py-ART's visualization functionality is done through the objects in the [pyart.graph](https://arm-doe.github.io/pyart/API/generated/pyart.graph.html) module.\n",
- "\n",
- "In Py-ART there are 4 primary visualization classes in pyart.graph:\n",
- "\n",
- "* [RadarDisplay](https://arm-doe.github.io/pyart/API/generated/pyart.graph.RadarDisplay.html)\n",
- "* [RadarMapDisplay](https://arm-doe.github.io/pyart/API/generated/pyart.graph.RadarMapDisplay.html)\n",
- "* [AirborneRadarDisplay](https://arm-doe.github.io/pyart/API/generated/pyart.graph.AirborneRadarDisplay.html)\n",
- "\n",
- "Plotting grid data\n",
- "* [GridMapDisplay](https://arm-doe.github.io/pyart/API/generated/pyart.graph.GridMapDisplay.html)\n",
- "\n",
- "### Use the [RadarMapDisplay](https://arm-doe.github.io/pyart/API/generated/pyart.graph.RadarMapDisplay.html) with our data\n",
- "\n",
- "For the this example, we will be using `RadarMapDisplay`, using Cartopy to deal with geographic coordinates.\n",
- "\n",
- "\n",
- "We start by creating a figure first."
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "fig = plt.figure(figsize=[10, 10])"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "Once we have a figure, let's add our `RadarMapDisplay`"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "fig = plt.figure(figsize=[10, 10])\n",
- "display = pyart.graph.RadarMapDisplay(radar)"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "Adding our map display without specifying a field to plot **won't do anything** we need to specifically add a field to field using `.plot_ppi_map()`"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "display.plot_ppi_map('corrected_reflectivity_horizontal')"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "By default, it will plot the elevation scan, the the default colormap from `Matplotlib`... let's customize!\n",
- "\n",
- "We add the following arguements:\n",
- "- `sweep=3` - The fourth elevation scan (since we are using Python indexing)\n",
- "- `vmin=-20` - Minimum value for our plotted field/colorbar\n",
- "- `vmax=60` - Maximum value for our plotted field/colorbar\n",
- "- `projection=ccrs.PlateCarree()` - Cartopy latitude/longitude coordinate system\n",
- "- `cmap='pyart_HomeyerRainbow'` - Colormap to use, selecting one provided by PyART "
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "fig = plt.figure(figsize=[12, 12])\n",
- "display = pyart.graph.RadarMapDisplay(radar)\n",
- "display.plot_ppi_map('corrected_reflectivity_horizontal',\n",
- " sweep=3,\n",
- " vmin=-20,\n",
- " vmax=60,\n",
- " projection=ccrs.PlateCarree(),\n",
- " cmap='pyart_HomeyerRainbow')\n",
- "plt.show()"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "You can change many parameters in the graph by changing the arguments to plot_ppi_map. As you can recall from earlier. simply view these arguments in a Jupyter notebook by typing:"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "display.plot_ppi_map?"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "For example, let's change the colormap to something different"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "fig = plt.figure(figsize=[12, 12])\n",
- "display = pyart.graph.RadarMapDisplay(radar)\n",
- "display.plot_ppi_map('corrected_reflectivity_horizontal',\n",
- " sweep=3,\n",
- " vmin=-20,\n",
- " vmax=60,\n",
- " projection=ccrs.PlateCarree(),\n",
- " cmap='pyart_Carbone42')\n",
- "plt.show()"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "Or, let's view a different elevation scan! To do this, change the sweep parameter in the plot_ppi_map function."
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "fig = plt.figure(figsize=[12, 12])\n",
- "display = pyart.graph.RadarMapDisplay(radar)\n",
- "display.plot_ppi_map('corrected_reflectivity_horizontal',\n",
- " sweep=0,\n",
- " vmin=-20,\n",
- " vmax=60,\n",
- " projection=ccrs.PlateCarree(),\n",
- " cmap='pyart_Carbone42')\n",
- "plt.show()"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "Let's take a look at a different field - for example, correlation coefficient (`corr_coeff`)"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "fig = plt.figure(figsize=[12, 12])\n",
- "display = pyart.graph.RadarMapDisplay(radar)\n",
- "display.plot_ppi_map('copol_coeff',\n",
- " sweep=0,\n",
- " vmin=0.8,\n",
- " vmax=1.,\n",
- " projection=ccrs.PlateCarree(),\n",
- " cmap='pyart_Carbone42')\n",
- "plt.show()"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "---\n",
- "## Summary\n",
- "Within this notebook, we covered the basics of working with radar data using `pyart`, including:\n",
- "- Reading in a file using `pyart.io`\n",
- "- Investigating the `Radar` object\n",
- "- Visualizing radar data using the `RadarMapDisplay`\n",
- "\n",
- "### What's Next\n",
- "In the next few notebooks, we walk through gridding radar data, applying data cleaning methods, and advanced visualization methods!"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## Resources and References\n",
- "Py-ART essentials links:\n",
- "\n",
- "* [Landing page](arm-doe.github.io/pyart/)\n",
- "* [Examples](https://arm-doe.github.io/pyart/examples/index.html)\n",
- "* [Source Code](github.com/ARM-DOE/pyart)\n",
- "* [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": {
- "kernelspec": {
- "display_name": "Python 3.8.9 64-bit",
- "language": "python",
- "name": "python3"
- },
- "language_info": {
- "codemirror_mode": {
- "name": "ipython",
- "version": 3
- },
- "file_extension": ".py",
- "mimetype": "text/x-python",
- "name": "python",
- "nbconvert_exporter": "python",
- "pygments_lexer": "ipython3",
- "version": "3.8.9"
- },
- "vscode": {
- "interpreter": {
- "hash": "31f2aee4e71d21fbe5cf8b01ff0e069b9275f58929596ceb00d14d90e3e16cd6"
- }
- }
- },
- "nbformat": 4,
- "nbformat_minor": 4
-}
diff --git a/_preview/93/_sources/notebooks/pyart/pyart-gridding.ipynb b/_preview/93/_sources/notebooks/pyart/pyart-gridding.ipynb
deleted file mode 100644
index 6b4f4ff5..00000000
--- a/_preview/93/_sources/notebooks/pyart/pyart-gridding.ipynb
+++ /dev/null
@@ -1,466 +0,0 @@
-{
- "cells": [
- {
- "cell_type": "markdown",
- "metadata": {
- "tags": []
- },
- "source": [
- "# Py-ART Gridding \n",
- "---"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## Overview\n",
- " \n",
- "Within this notebook, we will cover:\n",
- "\n",
- "1. What is gridding and why is it important?\n",
- "1. An overview of gridding with Py-ART \n",
- "1. How to choose a gridding routine\n",
- "1. Gridding multiple radars to the same grid\n"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {
- "tags": []
- },
- "source": [
- "## Prerequisites\n",
- "| Concepts | Importance | Notes |\n",
- "| --- | --- | --- |\n",
- "| [Py-ART Basics](pyart-basics) | Helpful | Basic features |\n",
- "| [Intro to Cartopy](https://foundations.projectpythia.org/core/cartopy/cartopy.html) | Helpful | Basic features |\n",
- "| [Matplotlib Basics](https://foundations.projectpythia.org/core/matplotlib/matplotlib-basics.html) | Helpful | Basic plotting |\n",
- "| [NumPy Basics](https://foundations.projectpythia.org/core/numpy/numpy-basics.html) | Helpful | Basic arrays |\n",
- "\n",
- "- **Time to learn**: 45 minutes\n",
- "---"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## Imports"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "import os\n",
- "import warnings\n",
- "\n",
- "import cartopy.crs as ccrs\n",
- "import matplotlib.pyplot as plt\n",
- "\n",
- "\n",
- "import pyart\n",
- "from pyart.testing import get_test_data\n",
- "\n",
- "warnings.filterwarnings('ignore')"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## What is gridding and why is it important?"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {
- "tags": []
- },
- "source": [
- "### Antenna vs. Cartesian Coordinates\n",
- "\n",
- "Radar data, by default, is stored in a **polar (or antenna) coordinate system**, with the data coordinates stored as an angle (ranging from 0 to 360 degrees with 0 == North), and a radius from the radar, and an elevation which is the angle between the ground and the ground.\n",
- "\n",
- "This format can be challenging to plot, since it is scan/radar specific. Also, it can make comparing with model data, which is on a lat/lon grid, challenging since one would need to **transform** the model daa cartesian coordinates to polar/antenna coordiantes.\n",
- "\n",
- "Fortunately, PyART has a variety of gridding routines, which can be used to **grid your data to a Cartesian grid**. Once it is in this new grid, one can easily slice/dice the dataset, and compare to other data sources.\n",
- "\n",
- "### Why is Gridding Important?\n",
- "\n",
- "Gridding is essential to combining multiple data sources (ex. multiple radars), and comparing to other data sources (ex. model data). There are also decisions that are made during the gridding process that have a large impact on the regridded data - for example:\n",
- "- What resolution should my grid be?\n",
- "- Which interpolation routine should I use?\n",
- "- How smooth should my interpolated data be?\n",
- "\n",
- "While there is not always a right or wrong answer, it is important to understand the options available, and document which routine you used with your data! Also - experiment with different options and choose the best for your use case!\n",
- "\n"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## An overview of gridding with Py-ART\n",
- "Let's dig into the regridding process with PyART!"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "### Read in and Visualize a Test Dataset\n",
- "Let's start with the same file used in the previous notebook (`PyART Basics`), which is a radar file from Northern Oklahoma."
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "file = get_test_data('swx_20120520_0641.nc')\n",
- "radar = pyart.io.read(file)"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "Let's plot up quick look of reflectivity, at the lowest elevation scan (closest to the ground)"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {
- "tags": []
- },
- "outputs": [],
- "source": [
- "fig = plt.figure(figsize=[12, 12])\n",
- "display = pyart.graph.RadarDisplay(radar)\n",
- "display.plot_ppi('corrected_reflectivity_horizontal',\n",
- " cmap='pyart_HomeyerRainbow')"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "As mentioned before, the dataset is currently in the **antenna coordinate system** measured as distance from the radar"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "### Setup our Gridding Routine with `pyart.map.grid_from_radars()`\n",
- "\n",
- "Py-ART has the [Grid object](https://arm-doe.github.io/pyart/API/generated/pyart.core.Grid.html#pyart.core.Grid) which has characteristics similar to that of the [Radar object](https://arm-doe.github.io/pyart/API/generated/pyart.core.Radar.html), except that the data are stored in Cartesian coordinates instead of the radar's antenna coordinates."
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "pyart.core.Grid?"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "We can **transform our data** into this grid object, from the radars, using `pyart.map.grid_from_radars()`.\n",
- "\n",
- "Beforing gridding our data, we need to make a decision about the desired grid resolution and extent. For example, one might imagine a grid configuration of:\n",
- "- Grid extent/limits\n",
- " - 20 km in the x-direction (north/south)\n",
- " - 20 km in the y-direction (west/east)\n",
- " - 15 km in the z-direction (vertical)\n",
- "- 500 m spatial resolution\n",
- "\n",
- "The `pyart.map.grid_from_radars()` function takes the grid shape and grid limits as input, with the order `(z, y, x)`.\n",
- "\n",
- "Let's setup our configuration, setting our grid extent **first**, with the distance measured in **meters**"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "z_grid_limits = (500.,15_000.)\n",
- "y_grid_limits = (-20_000.,20_000.)\n",
- "x_grid_limits = (-20_000.,20_000.)"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "Now that we have our grid limits, we can set our desired resolution (again, in meters)"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "grid_resolution = 500"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "Let's compute our grid shape - using the extent and resolution to compute the number of grid points in each direction."
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "def compute_number_of_points(extent, resolution):\n",
- " return int((extent[1] - extent[0])/resolution)"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "Now that we have a helper function to compute this, let's apply it to our vertical dimension"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "z_grid_points = compute_number_of_points(z_grid_limits, grid_resolution)\n",
- "z_grid_points"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "We can apply this to the horizontal (x, y) dimensions as well."
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "x_grid_points = compute_number_of_points(x_grid_limits, grid_resolution)\n",
- "y_grid_points = compute_number_of_points(y_grid_limits, grid_resolution)\n",
- "\n",
- "print(z_grid_points,\n",
- " y_grid_points,\n",
- " x_grid_points)"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "#### Use our configuration to grid the data!\n",
- "Now that we have the grid shape and grid limits, let's grid up our radar!"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "grid = pyart.map.grid_from_radars(radar,\n",
- " grid_shape=(z_grid_points,\n",
- " y_grid_points,\n",
- " x_grid_points),\n",
- " grid_limits=(z_grid_limits,\n",
- " y_grid_limits,\n",
- " x_grid_limits),\n",
- " )\n",
- "grid"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "We now have a `pyart.core.Grid` object!"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "### Plot up the Grid Object\n",
- "\n",
- "#### Plot a horizontal view of the data\n",
- "We can use the `GridMapDisplay` from `pyart.graph` to visualize our regridded data, starting with a horizontal view (slice along a single vertical level)"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "display = pyart.graph.GridMapDisplay(grid)\n",
- "display.plot_grid('corrected_reflectivity_horizontal',\n",
- " level=0,\n",
- " vmin=-20,\n",
- " vmax=60,\n",
- " cmap='pyart_HomeyerRainbow')"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "#### Plot a Latitudinal Slice"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "We can also slice through a single latitude or longitude!"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "display.plot_latitude_slice('corrected_reflectivity_horizontal',\n",
- " lat=36.5,\n",
- " vmin=-20,\n",
- " vmax=60,\n",
- " cmap='pyart_HomeyerRainbow')\n",
- "plt.xlim([-20, 20]);"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "#### Plot with Xarray"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "Another neat feature of the `Grid` object is that we can transform it to an `xarray.Dataset`!"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "ds = grid.to_xarray()\n",
- "ds"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "Now, our plotting routine is a **one-liner**, starting with the horizontal slice:"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "ds.isel(z=0).corrected_reflectivity_horizontal.plot(cmap='pyart_HomeyerRainbow',\n",
- " vmin=-20,\n",
- " vmax=60);"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "And a vertical slice at a given y dimension (latitude)"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "ds.sel(y=1300,\n",
- " method='nearest').corrected_reflectivity_horizontal.plot(cmap='pyart_HomeyerRainbow',\n",
- " vmin=-20,\n",
- " vmax=60);"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "---\n",
- "## Summary\n",
- "Within this notebook, we covered the basics of gridding radar data using `pyart`, including:\n",
- "- What we mean by gridding and why is it matters\n",
- "- Configuring your gridding routine\n",
- "- Visualize gridded radar data\n",
- "\n",
- "### What's Next\n",
- "In the next few notebooks, we walk through applying data cleaning methods, and advanced visualization methods!"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## Resources and References\n",
- "Py-ART essentials links:\n",
- "\n",
- "* [Landing page](arm-doe.github.io/pyart/)\n",
- "* [Examples](https://arm-doe.github.io/pyart/examples/index.html)\n",
- "* [Source Code](github.com/ARM-DOE/pyart)\n",
- "* [Mailing list](groups.google.com/group/pyart-users/)\n",
- "* [Issue Tracker](github.com/ARM-DOE/pyart/issues)"
- ]
- }
- ],
- "metadata": {
- "language_info": {
- "codemirror_mode": {
- "name": "ipython",
- "version": 3
- },
- "file_extension": ".py",
- "mimetype": "text/x-python",
- "name": "python",
- "nbconvert_exporter": "python",
- "pygments_lexer": "ipython3",
- "version": "3.9.12"
- }
- },
- "nbformat": 4,
- "nbformat_minor": 4
-}
diff --git a/_preview/93/_sources/notebooks/pyart/question_pyart_meteoswiss.ipynb b/_preview/93/_sources/notebooks/pyart/question_pyart_meteoswiss.ipynb
deleted file mode 100644
index 3c2943d4..00000000
--- a/_preview/93/_sources/notebooks/pyart/question_pyart_meteoswiss.ipynb
+++ /dev/null
@@ -1,46 +0,0 @@
-{
- "cells": [
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "# Exercice\n",
- "\n",
- "The goal of this exercice is to do a QPE for every sweep and perform a weighted average of precipitation aloft to get an estimation of the precipitation intensity at the ground. The following steps will need to be taken:\n",
- "\n",
- "1. Load all radar files in */data/question_pyart_meteoswiss* and merge them into one single radar object\n",
- "2. Perform attenuation correction of ZH, you can use a constant freezing level height of 2700 m.\n",
- "3. Estimate the QPE with a __[a polynomial Z-R relation](https://arm-doe.github.io/pyart/_modules/pyart/retrieve/qpe.html#est_rain_rate_za)__.\n",
- "4. Compute a CAPPI of the resulting radar estimate rain rate from 500 to 8000 m above the radar using a vertical resolution of 100 m and a horizontal resolution of 500 m.\n",
- "5. Using numpy, perform a weighted average of all CAPPI levels using the weights \n",
- "\n",
- "![\"wradlib](\"../images/logos/wradlib_logo.svg.png\"){kind=logo}
"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "# wradlib data quality"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "---"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## Overview\n",
- "\n",
- "Within this notebook, we will cover:\n",
- "\n",
- "1. Reading radar volume data into xarray based RadarVolume\n",
- "1. Wrapping numpy-based functions to work with Xarray\n",
- "1. Clutter detection\n",
- "1. Beam Blockage calculation"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## Prerequisites\n",
- "\n",
- "| Concepts | Importance | Notes |\n",
- "| --- | --- | --- |\n",
- "| [Xarray Basics](https://tutorial.xarray.dev/intro.html) | Helpful | Basic Dataset/DataArray |\n",
- "| [Matplotlib Basics](https://foundations.projectpythia.org/core/matplotlib/matplotlib-basics.html) | Helpful | Basic Plotting |\n",
- "| [Intro to Cartopy](https://foundations.projectpythia.org/core/cartopy/cartopy.html) | Helpful | Projections |\n",
- "\n",
- "- **Time to learn**: 10 minutes"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "---"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## Imports"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {
- "jupyter": {
- "outputs_hidden": false
- }
- },
- "outputs": [],
- "source": [
- "import glob\n",
- "import os\n",
- "\n",
- "import cartopy\n",
- "import cartopy.crs as ccrs\n",
- "import cartopy.feature as cfeature\n",
- "import matplotlib as mpl\n",
- "import matplotlib.pyplot as plt\n",
- "import numpy as np\n",
- "import xarray as xr\n",
- "\n",
- "import wradlib as wrl"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## Import Swiss Radar Data from CfRadial1 Volumes\n",
- "\n",
- "We use some of the pyrad example data here. Sweeps are provided as single files, so we open each file separately and create the RadarVolume from the open Datasets."
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {
- "jupyter": {
- "outputs_hidden": false
- }
- },
- "outputs": [],
- "source": [
- "fglob = \"../pyart/data/example_pyrad/22179/MLL22179/MLL2217907250U*.nc\"\n",
- "flist = glob.glob(fglob)\n",
- "flist.sort()\n",
- "print(\"Files available: {}\".format(len(flist)))"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {
- "jupyter": {
- "outputs_hidden": false
- }
- },
- "outputs": [],
- "source": [
- "ds = [xr.open_dataset(f, group=\"sweep_1\", engine=\"cfradial1\", chunks={}) for f in flist]"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {
- "jupyter": {
- "outputs_hidden": false
- }
- },
- "outputs": [],
- "source": [
- "vol = wrl.io.RadarVolume(engine=\"cfradial1\")\n",
- "vol.extend(ds)\n",
- "vol.sort(key=lambda x: x.time.min())"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {
- "jupyter": {
- "outputs_hidden": false
- }
- },
- "outputs": [],
- "source": [
- "display(vol)"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "vol.root"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {
- "jupyter": {
- "outputs_hidden": false
- }
- },
- "outputs": [],
- "source": [
- "sweep_number = 3\n",
- "display(vol[sweep_number])"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## Clutter detection with Gabella\n",
- "\n",
- "While in Switzerland, why not use the well-known clutter detection scheme by Marco Gabella et. al.\n",
- "\n",
- "### Wrap Gabella Clutter detection in Xarray `apply_ufunc`\n",
- "\n",
- "The routine is implemented in wradlib in pure `Numpy`. `Numpy` based processing routines can be transformed to a first class `Xarray` citizen with the help of `xr.apply_ufunc`."
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {
- "jupyter": {
- "outputs_hidden": false
- }
- },
- "outputs": [],
- "source": [
- "def extract_clutter(da, wsize=5, thrsnorain=0, tr1=6.0, n_p=6, tr2=1.3, rm_nans=False):\n",
- " return xr.apply_ufunc(\n",
- " wrl.clutter.filter_gabella,\n",
- " da,\n",
- " input_core_dims=[[\"azimuth\", \"range\"]],\n",
- " output_core_dims=[[\"azimuth\", \"range\"]],\n",
- " dask=\"parallelized\",\n",
- " kwargs=dict(\n",
- " wsize=wsize,\n",
- " thrsnorain=thrsnorain,\n",
- " tr1=tr1,\n",
- " n_p=n_p,\n",
- " tr2=tr2,\n",
- " rm_nans=rm_nans,\n",
- " ),\n",
- " )"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "### Calculate clutter map\n",
- "\n",
- "Now we apply Gabella scheme and add the result to the Dataset."
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {
- "jupyter": {
- "outputs_hidden": false
- }
- },
- "outputs": [],
- "source": [
- "swp = vol[sweep_number]\n",
- "clmap = swp.reflectivity_hh_clut.pipe(\n",
- " extract_clutter, wsize=5, thrsnorain=0.0, tr1=21.0, n_p=23, tr2=1.3, rm_nans=False\n",
- ")\n",
- "swp = swp.assign({\"CMAP\": clmap})\n",
- "display(swp)"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "### Plot Reflectivities, Clutter and Cluttermap"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "from osgeo import osr\n",
- "\n",
- "wgs84 = osr.SpatialReference()\n",
- "wgs84.ImportFromEPSG(4326)"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {
- "jupyter": {
- "outputs_hidden": false
- }
- },
- "outputs": [],
- "source": [
- "fig = plt.figure(figsize=(15, 12))\n",
- "\n",
- "swpx = swp.sel(range=slice(0, 100000)).pipe(wrl.georef.georeference_dataset, proj=wgs84)\n",
- "\n",
- "ax1 = fig.add_subplot(221)\n",
- "swpx.reflectivity_hh_clut.plot(x=\"x\", y=\"y\", ax=ax1, vmin=0, vmax=60)\n",
- "ax1.set_title(\"Reflectivity raw\")\n",
- "\n",
- "ax2 = fig.add_subplot(222)\n",
- "swpx.CMAP.plot(x=\"x\", y=\"y\", ax=ax2)\n",
- "ax2.set_title(\"Cluttermap\")\n",
- "\n",
- "ax3 = fig.add_subplot(223)\n",
- "swpx.reflectivity_hh_clut.where(swpx.CMAP == 1).plot(\n",
- " x=\"x\", y=\"y\", ax=ax3, vmin=0, vmax=60\n",
- ")\n",
- "ax3.set_title(\"Clutter\")\n",
- "\n",
- "ax4 = fig.add_subplot(224)\n",
- "swpx.reflectivity_hh_clut.where(swpx.CMAP < 1).plot(\n",
- " x=\"x\", y=\"y\", ax=ax4, vmin=0, vmax=60\n",
- ")\n",
- "ax4.set_title(\"Reflectivity clutter removed\")"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## SRTM based clutter and beamblockage processing"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "### Download needed SRTM data\n",
- "\n",
- "For the course we already provide the needed SRTM tiles. For normal operation you would need a NASA EARTHDATA account and a connected bearer token.\n",
- "\n",
- "The data will be loaded using GDAL machinery and transformed into an Xarray DataArray."
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {
- "jupyter": {
- "outputs_hidden": false
- }
- },
- "outputs": [],
- "source": [
- "extent = wrl.zonalstats.get_bbox(swpx.x.values, swpx.y.values)\n",
- "extent"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {
- "jupyter": {
- "outputs_hidden": false
- }
- },
- "outputs": [],
- "source": [
- "# apply fake token, data is already available\n",
- "os.environ[\"WRADLIB_EARTHDATA_BEARER_TOKEN\"] = \"\"\n",
- "# set location of wradlib-data, where wradlib will search for any available data\n",
- "os.environ[\"WRADLIB_DATA\"] = \"data/wradlib-data\"\n",
- "# get the tiles\n",
- "dem = wrl.io.get_srtm(extent.values())"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {
- "jupyter": {
- "outputs_hidden": false
- }
- },
- "outputs": [],
- "source": [
- "elevation = wrl.georef.read_gdal_values(dem)\n",
- "coords = wrl.georef.read_gdal_coordinates(dem)"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {
- "jupyter": {
- "outputs_hidden": false
- }
- },
- "outputs": [],
- "source": [
- "elev = xr.DataArray(\n",
- " data=elevation,\n",
- " dims=[\"y\", \"x\"],\n",
- " coords={\"lat\": ([\"y\", \"x\"], coords[..., 1]), \"lon\": ([\"y\", \"x\"], coords[..., 0])},\n",
- ")\n",
- "elev"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "### Plot Clutter on DEM"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {
- "jupyter": {
- "outputs_hidden": false
- }
- },
- "outputs": [],
- "source": [
- "fig = plt.figure(figsize=(13, 10))\n",
- "ax1 = fig.add_subplot(111)\n",
- "\n",
- "swpx.CMAP.where(swpx.CMAP == 1).plot(\n",
- " x=\"x\", y=\"y\", ax=ax1, vmin=0, vmax=1, cmap=\"turbo\", add_colorbar=False\n",
- ")\n",
- "ax1.set_title(\"Reflectivity corr\")\n",
- "\n",
- "ax1.plot(swpx.longitude.values, swpx.latitude.values, marker=\"*\", c=\"r\")\n",
- "\n",
- "elev.plot(x=\"lon\", y=\"lat\", ax=ax1, zorder=-2, cmap=\"terrain\")"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "### Use hvplot for interactive zooming and panning\n",
- "\n",
- "Often it is desirable to quickly zoom and pan in the plots. Although matplotlib has that ability, it still is quite slow. Here `hvplot`, a `holoviews` based plotting framework, can be utilized. As frontend `bokeh` is used."
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {
- "jupyter": {
- "outputs_hidden": false
- }
- },
- "outputs": [],
- "source": [
- "import hvplot\n",
- "import hvplot.xarray"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "We need to rechunk the coordinates as hvplot needs chunked variables and coords.\n",
- "\n",
- "todo # vergleichbar machen mit beam blockage angle/entfernung"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {
- "jupyter": {
- "outputs_hidden": false
- }
- },
- "outputs": [],
- "source": [
- "cl = (\n",
- " swpx.CMAP.where(swpx.CMAP == 1)\n",
- " .chunk(chunks={})\n",
- " .hvplot.quadmesh(\n",
- " x=\"x\", y=\"y\", cmap=\"Reds\", width=800, height=700, clim=(0, 1), alpha=0.6\n",
- " )\n",
- ")\n",
- "dm = elev.hvplot.quadmesh(\n",
- " x=\"lon\",\n",
- " y=\"lat\",\n",
- " cmap=\"terrain\",\n",
- " width=800,\n",
- " height=700,\n",
- " clim=(0, 4000),\n",
- " rasterize=True,\n",
- ")\n",
- "dm * cl"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "### Convert DEM to spherical coordinates"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "sitecoords = (swpx.longitude.values, swpx.latitude.values, swpx.altitude.values)\n",
- "r = swpx.range.values\n",
- "az = swpx.azimuth.values\n",
- "bw = 0.8\n",
- "beamradius = wrl.util.half_power_radius(r, bw)"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {
- "jupyter": {
- "outputs_hidden": false
- }
- },
- "outputs": [],
- "source": [
- "rastervalues, rastercoords, proj = wrl.georef.extract_raster_dataset(\n",
- " dem, nodata=-32768.0\n",
- ")\n",
- "\n",
- "rlimits = (extent[\"left\"], extent[\"bottom\"], extent[\"right\"], extent[\"top\"])\n",
- "# Clip the region inside our bounding box\n",
- "ind = wrl.util.find_bbox_indices(rastercoords, rlimits)\n",
- "rastercoords = rastercoords[ind[1] : ind[3], ind[0] : ind[2], ...]\n",
- "rastervalues = rastervalues[ind[1] : ind[3], ind[0] : ind[2]]\n",
- "\n",
- "polcoords = np.dstack([swpx.x.values, swpx.y.values])\n",
- "# Map rastervalues to polar grid points\n",
- "polarvalues = wrl.ipol.cart_to_irregular_spline(\n",
- " rastercoords, rastervalues, polcoords, order=3, prefilter=False\n",
- ")"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "### Partial and Cumulative Beamblockage"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {
- "jupyter": {
- "outputs_hidden": false
- }
- },
- "outputs": [],
- "source": [
- "PBB = wrl.qual.beam_block_frac(polarvalues, swpx.z.values, beamradius)\n",
- "PBB = np.ma.masked_invalid(PBB)\n",
- "print(PBB.shape)"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {
- "jupyter": {
- "outputs_hidden": false
- }
- },
- "outputs": [],
- "source": [
- "CBB = wrl.qual.cum_beam_block_frac(PBB)\n",
- "print(CBB.shape)"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "### Plotting Beamblockage\n"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {
- "jupyter": {
- "outputs_hidden": false
- }
- },
- "outputs": [],
- "source": [
- "# just a little helper function to style x and y axes of our maps\n",
- "def annotate_map(ax, cm=None, title=\"\"):\n",
- " xticks = ax.get_xticks()\n",
- " ticks = (xticks / 1000).astype(int)\n",
- " ax.set_xticks(xticks)\n",
- " ax.set_xticklabels(ticks)\n",
- " yticks = ax.get_yticks()\n",
- " ticks = (yticks / 1000).astype(int)\n",
- " ax.set_yticks(yticks)\n",
- " ax.set_yticklabels(ticks)\n",
- " ax.set_xlabel(\"Kilometers\")\n",
- " ax.set_ylabel(\"Kilometers\")\n",
- " if not cm is None:\n",
- " plt.colorbar(cm, ax=ax)\n",
- " if not title == \"\":\n",
- " ax.set_title(title)\n",
- " ax.grid()"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "alt = swpx.z.values\n",
- "fig = plt.figure(figsize=(15, 12))\n",
- "\n",
- "# create subplots\n",
- "ax1 = plt.subplot2grid((2, 2), (0, 0))\n",
- "ax2 = plt.subplot2grid((2, 2), (0, 1))\n",
- "ax3 = plt.subplot2grid((2, 2), (1, 0), colspan=2, rowspan=1)\n",
- "\n",
- "# azimuth angle\n",
- "angle = 270\n",
- "\n",
- "# Plot terrain (on ax1)\n",
- "ax1, dem = wrl.vis.plot_ppi(\n",
- " polarvalues, ax=ax1, r=r, az=az, cmap=mpl.cm.terrain, vmin=0.0\n",
- ")\n",
- "ax1.plot(\n",
- " [0, np.sin(np.radians(angle)) * 1e5], [0, np.cos(np.radians(angle)) * 1e5], \"r-\"\n",
- ")\n",
- "ax1.plot(sitecoords[0], sitecoords[1], \"ro\")\n",
- "annotate_map(ax1, dem, \"Terrain within {0} km range\".format(np.max(r / 1000.0) + 0.1))\n",
- "ax1.set_xlim(-100000, 100000)\n",
- "ax1.set_ylim(-100000, 100000)\n",
- "\n",
- "# Plot CBB (on ax2)\n",
- "ax2, cbb = wrl.vis.plot_ppi(CBB, ax=ax2, r=r, az=az, cmap=mpl.cm.PuRd, vmin=0, vmax=1)\n",
- "annotate_map(ax2, cbb, \"Beam-Blockage Fraction\")\n",
- "ax2.set_xlim(-100000, 100000)\n",
- "ax2.set_ylim(-100000, 100000)\n",
- "\n",
- "# Plot single ray terrain profile on ax3\n",
- "(bc,) = ax3.plot(r / 1000.0, alt[angle, :], \"-b\", linewidth=3, label=\"Beam Center\")\n",
- "(b3db,) = ax3.plot(\n",
- " r / 1000.0,\n",
- " (alt[angle, :] + beamradius),\n",
- " \":b\",\n",
- " linewidth=1.5,\n",
- " label=\"3 dB Beam width\",\n",
- ")\n",
- "ax3.plot(r / 1000.0, (alt[angle, :] - beamradius), \":b\")\n",
- "ax3.fill_between(r / 1000.0, 0.0, polarvalues[angle, :], color=\"0.75\")\n",
- "ax3.set_xlim(0.0, np.max(r / 1000.0) + 0.1)\n",
- "ax3.set_ylim(0.0, 3000)\n",
- "ax3.set_xlabel(\"Range (km)\")\n",
- "ax3.set_ylabel(\"Altitude (m)\")\n",
- "ax3.grid()\n",
- "\n",
- "axb = ax3.twinx()\n",
- "(bbf,) = axb.plot(r / 1000.0, CBB[angle, :], \"-g\", label=\"BBF\")\n",
- "axb.spines[\"right\"].set_color(\"g\")\n",
- "axb.tick_params(axis=\"y\", colors=\"g\")\n",
- "axb.set_ylabel(\"Beam-blockage fraction\", c=\"g\")\n",
- "axb.set_ylim(0.0, 1.0)\n",
- "axb.set_xlim(0.0, np.max(r / 1000.0) + 0.1)\n",
- "\n",
- "\n",
- "legend = ax3.legend(\n",
- " (bc, b3db, bbf),\n",
- " (\"Beam Center\", \"3 dB Beam width\", \"BBF\"),\n",
- " loc=\"upper left\",\n",
- " fontsize=10,\n",
- ")"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "### Plotting Beamblockage on Curvelinear Grid\n",
- "\n",
- "Here you get an better impression of the actual beam progression ."
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "def height_formatter(x, pos):\n",
- " x = (x - 6370000) / 1000\n",
- " fmt_str = \"{:g}\".format(x)\n",
- " return fmt_str\n",
- "\n",
- "\n",
- "def range_formatter(x, pos):\n",
- " x = x / 1000.0\n",
- " fmt_str = \"{:g}\".format(x)\n",
- " return fmt_str"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "fig = plt.figure(figsize=(15, 8))\n",
- "\n",
- "cgax, caax, paax = wrl.vis.create_cg(fig=fig, rot=0, scale=1)\n",
- "\n",
- "# azimuth angle\n",
- "angle = 270\n",
- "\n",
- "# fix grid_helper\n",
- "er = 6370000\n",
- "gh = cgax.get_grid_helper()\n",
- "gh.grid_finder.grid_locator2._nbins = 80\n",
- "gh.grid_finder.grid_locator2._steps = [1, 2, 4, 5, 10]\n",
- "\n",
- "# calculate beam_height and arc_distance for ke=1\n",
- "# means line of sight\n",
- "bhe = wrl.georef.bin_altitude(r, 0, sitecoords[2], re=er, ke=1.0)\n",
- "ade = wrl.georef.bin_distance(r, 0, sitecoords[2], re=er, ke=1.0)\n",
- "nn0 = np.zeros_like(r)\n",
- "# for nice plotting we assume earth_radius = 6370000 m\n",
- "ecp = nn0 + er\n",
- "# theta (arc_distance sector angle)\n",
- "thetap = -np.degrees(ade / er) + 90.0\n",
- "\n",
- "# zero degree elevation with standard refraction\n",
- "bh0 = wrl.georef.bin_altitude(r, 0, sitecoords[2], re=er)\n",
- "\n",
- "# plot (ecp is earth surface normal null)\n",
- "(bes,) = paax.plot(thetap, ecp, \"-k\", linewidth=3, label=\"Earth Surface NN\")\n",
- "(bc,) = paax.plot(thetap, ecp + alt[angle, :], \"-b\", linewidth=3, label=\"Beam Center\")\n",
- "(bc0r,) = paax.plot(thetap, ecp + bh0, \"-g\", label=\"0 deg Refraction\")\n",
- "(bc0n,) = paax.plot(thetap, ecp + bhe, \"-r\", label=\"0 deg line of sight\")\n",
- "(b3db,) = paax.plot(\n",
- " thetap, ecp + alt[angle, :] + beamradius, \":b\", label=\"+3 dB Beam width\"\n",
- ")\n",
- "paax.plot(thetap, ecp + alt[angle, :] - beamradius, \":b\", label=\"-3 dB Beam width\")\n",
- "\n",
- "# orography\n",
- "paax.fill_between(thetap, ecp, ecp + polarvalues[angle, :], color=\"0.75\")\n",
- "\n",
- "# shape axes\n",
- "cgax.set_xlim(0, np.max(ade))\n",
- "cgax.set_ylim([ecp.min() - 1000, ecp.max() + 2500])\n",
- "caax.grid(True, axis=\"x\")\n",
- "cgax.grid(True, axis=\"y\")\n",
- "cgax.axis[\"top\"].toggle(all=False)\n",
- "caax.yaxis.set_major_locator(\n",
- " mpl.ticker.MaxNLocator(steps=[1, 2, 4, 5, 10], nbins=20, prune=\"both\")\n",
- ")\n",
- "caax.xaxis.set_major_locator(mpl.ticker.MaxNLocator())\n",
- "caax.yaxis.set_major_formatter(mpl.ticker.FuncFormatter(height_formatter))\n",
- "caax.xaxis.set_major_formatter(mpl.ticker.FuncFormatter(range_formatter))\n",
- "\n",
- "caax.set_xlabel(\"Range (km)\")\n",
- "caax.set_ylabel(\"Altitude (km)\")\n",
- "\n",
- "legend = paax.legend(\n",
- " (bes, bc0n, bc0r, bc, b3db),\n",
- " (\n",
- " \"Earth Surface NN\",\n",
- " \"0 deg line of sight\",\n",
- " \"0 deg std refraction\",\n",
- " \"Beam Center\",\n",
- " \"3 dB Beam width\",\n",
- " ),\n",
- " loc=\"lower left\",\n",
- " fontsize=10,\n",
- ")"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## Use Clutter and Beamblockage as Quality Index\n",
- "\n",
- "Simple masking with cumulative beam blockage and Gabella."
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "swpx = swpx.assign({\"CBB\": ([\"azimuth\", \"range\"], CBB)})\n",
- "# recalculate georeferencing for AEQD\n",
- "swpx = swpx.pipe(wrl.georef.georeference_dataset)"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "fig = plt.figure(figsize=(12, 4))\n",
- "\n",
- "ax1 = fig.add_subplot(121)\n",
- "swpx.reflectivity.plot(x=\"x\", y=\"y\", ax=ax1, cmap=\"turbo\", vmin=0, vmax=60)\n",
- "ax1.set_title(f\"Signal Processor - {swpx.time.values.astype('M8[s]')}\")\n",
- "ax1.set_aspect(\"equal\")\n",
- "\n",
- "ax2 = fig.add_subplot(122)\n",
- "# CBB > 0.5, CMAP == 1, RHOHV < 0.8 is masked\n",
- "swpx.where(\n",
- " (swpx.CBB <= 0.5)\n",
- " & (swpx.CMAP < 1.0)\n",
- " & (swpx.uncorrected_cross_correlation_ratio >= 0.8)\n",
- ").reflectivity_hh_clut.plot(x=\"x\", y=\"y\", ax=ax2, cmap=\"turbo\", vmin=0, vmax=60)\n",
- "ax2.set_title(f\"Gabella+CBB+RHOHV - {swpx.time.values.astype('M8[s]')}\")\n",
- "ax2.set_aspect(\"equal\")"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "---"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## Summary\n",
- "We've just learned how to use $\\omega radlib$'s Gabella clutter detection for single sweeps. Wrapping numpy based functions for use with `xarray.apply_ufunc` has been shown. We've looked into digital elevation maps and beam blockage calculations.\n",
- "\n",
- "### What's next?\n",
- "In the next notebook we dive into processing of differential phase."
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## Resources and references\n",
- "\n",
- "- [SRTM - NASA - EARTHDATA](https://urs.earthdata.nasa.gov/)\n",
- "- [xarray](https://docs.xarray.dev)\n",
- "- [apply_ufunc](https://docs.xarray.dev/en/stable/generated/xarray.apply_ufunc.html)\n",
- "- [dask](https://docs.dask.org/)\n",
- "- [gdal](https://gdal.org/index.html)\n",
- "- [hvplot](https://hvplot.holoviz.org/)\n",
- "- [wradlib xarray backends](https://docs.wradlib.org/en/stable/notebooks/fileio/wradlib_xarray_backends.html)\n",
- "- [CfRadial1](https://ncar.github.io/CfRadial/)\n",
- "- [OPERA ODIM_H5](https://www.eumetnet.eu/activities/observations-programme/current-activities/opera/)\n",
- "- [WMO JET-OWR](https://community.wmo.int/governance/commission-membership/commission-observation-infrastructure-and-information-systems-infcom/commission-infrastructure-officers/infcom-management-group/standing-committee-measurements-instrumentation-and-traceability-sc-mint/joint-expert-team)"
- ]
- }
- ],
- "metadata": {
- "language_info": {
- "codemirror_mode": {
- "name": "ipython",
- "version": 3
- },
- "file_extension": ".py",
- "mimetype": "text/x-python",
- "name": "python",
- "nbconvert_exporter": "python",
- "pygments_lexer": "ipython3",
- "version": "3.9.13"
- },
- "nbdime-conflicts": {
- "local_diff": [
- {
- "diff": [
- {
- "diff": [
- {
- "key": 0,
- "op": "addrange",
- "valuelist": [
- "Python 3"
- ]
- },
- {
- "key": 0,
- "length": 1,
- "op": "removerange"
- }
- ],
- "key": "display_name",
- "op": "patch"
- }
- ],
- "key": "kernelspec",
- "op": "patch"
- }
- ],
- "remote_diff": [
- {
- "diff": [
- {
- "diff": [
- {
- "key": 0,
- "op": "addrange",
- "valuelist": [
- "Python3"
- ]
- },
- {
- "key": 0,
- "length": 1,
- "op": "removerange"
- }
- ],
- "key": "display_name",
- "op": "patch"
- }
- ],
- "key": "kernelspec",
- "op": "patch"
- }
- ]
- },
- "toc-autonumbering": false
- },
- "nbformat": 4,
- "nbformat_minor": 4
-}
diff --git a/_preview/93/_sources/notebooks/wradlib/wradlib_differential_phase.ipynb b/_preview/93/_sources/notebooks/wradlib/wradlib_differential_phase.ipynb
deleted file mode 100644
index 93e63e6b..00000000
--- a/_preview/93/_sources/notebooks/wradlib/wradlib_differential_phase.ipynb
+++ /dev/null
@@ -1,1137 +0,0 @@
-{
- "cells": [
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "![\"grayscale](\"grayscale.png\")
\n",
- "![\"paletted](\"paletted.png\")
"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "### Import with Xarray, rasterio backend"
- ]
- },
- {
- "cell_type": "code",
- "execution_count": null,
- "metadata": {},
- "outputs": [],
- "source": [
- "with xr.open_dataset(\"gridded_DBZH_20191021_082409.tif\", engine=\"rasterio\") as ds_grd:\n",
- " display(ds_grd)\n",
- " ds_grd.band_data.plot(cmap=\"turbo\")"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "---"
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## Summary\n",
- "We've just learned how to use $\\omega radlib$'s xarray backends to make radar volume data available as xarray Datasets and DataArrays. Accessing, plotting and exporting data has been shown.\n",
- "\n",
- "### What's next?\n",
- "In the next notebook we dive into data quality processing."
- ]
- },
- {
- "cell_type": "markdown",
- "metadata": {},
- "source": [
- "## Resources and references\n",
- "\n",
- "- [xarray](https://docs.xarray.dev)\n",
- "- [dask](https://docs.dask.org)\n",
- "- [matplotlib](https://matplotlib.org/stable/index.html)\n",
- "- [matplotlib axisartist](https://matplotlib.org/stable/tutorials/toolkits/axisartist.html)\n",
- "- [cartopy](https://scitools.org.uk/cartopy/docs/latest)\n",
- "- [gdal](https://gdal.org/index.html)\n",
- "- [wradlib xarray backends](https://docs.wradlib.org/en/stable/notebooks/fileio/wradlib_xarray_backends.html)\n",
- "- [rioxarray](https://corteva.github.io/rioxarray/stable/)\n",
- "- [wradlib scan strategy](https://docs.wradlib.org/en/stable/notebooks/visualisation/wradlib_plot_scan_strategy.html)\n",
- "- [Leonardo - Rainbow5](https://electronics.leonardo.com/en/products/rainbow-5-application-software)\n",
- "- [OPERA ODIM_H5](https://www.eumetnet.eu/activities/observations-programme/current-activities/opera/)\n",
- "- [WMO JET-OWR](https://community.wmo.int/governance/commission-membership/commission-observation-infrastructure-and-information-systems-infcom/commission-infrastructure-officers/infcom-management-group/standing-committee-measurements-instrumentation-and-traceability-sc-mint/joint-expert-team)"
- ]
- }
- ],
- "metadata": {
- "language_info": {
- "codemirror_mode": {
- "name": "ipython",
- "version": 3
- },
- "file_extension": ".py",
- "mimetype": "text/x-python",
- "name": "python",
- "nbconvert_exporter": "python",
- "pygments_lexer": "ipython3",
- "version": "3.9.13"
- },
- "nbdime-conflicts": {
- "local_diff": [
- {
- "diff": [
- {
- "diff": [
- {
- "key": 0,
- "op": "addrange",
- "valuelist": [
- "Python 3"
- ]
- },
- {
- "key": 0,
- "length": 1,
- "op": "removerange"
- }
- ],
- "key": "display_name",
- "op": "patch"
- }
- ],
- "key": "kernelspec",
- "op": "patch"
- }
- ],
- "remote_diff": [
- {
- "diff": [
- {
- "diff": [
- {
- "key": 0,
- "op": "addrange",
- "valuelist": [
- "Python3"
- ]
- },
- {
- "key": 0,
- "length": 1,
- "op": "removerange"
- }
- ],
- "key": "display_name",
- "op": "patch"
- }
- ],
- "key": "kernelspec",
- "op": "patch"
- }
- ]
- },
- "toc-autonumbering": false
- },
- "nbformat": 4,
- "nbformat_minor": 4
-}
diff --git a/_preview/93/_sources/package-development/README.md b/_preview/93/_sources/package-development/README.md
deleted file mode 100644
index c8f48818..00000000
--- a/_preview/93/_sources/package-development/README.md
+++ /dev/null
@@ -1,54 +0,0 @@
-# Developing Open Source Software Packages
-
-This section covers best practises of contributing to existing software packages
-and of creating new packages.
-
-## HowTo collaborate
-
-Collaboration is a wide field, not only code contribution.
-
-- **GitHub Discussions**
- - [pyart](https://github.com/ARM-DOE/pyart/discussions)
- - [xarray](https://github.com/pydata/xarray/discussions)
-- **Issues**
- - Bug Report eg. [wradlib](https://github.com/wradlib/wradlib/issues/549)
- - Feature Requests eg. [wradlib](https://github.com/wradlib/wradlib/issues/461)
-- **Pull Request/Merge Request**
-
- Not only code but also documentation can be added or extended. Even correcting typos is useful and appreciated by most package maintainers.
- Sometimes issues are labeled (eg `easy first issue`) for easy identification.
- - [wradlib](https://github.com/wradlib/wradlib/pull/550)
- - [pyart](https://github.com/ARM-DOE/pyart/pull/807)
-- **Mailing Lists**
- - [wradlib](https://groups.google.com/g/wradlib-users)
- - [xarray](https://groups.google.com/g/xarray)
-- **Discourse**
- - [pangeo](https://discourse.pangeo.io/)
- - [matplotlib](https://discourse.matplotlib.org/)
-
-The main documentation of the projects are a good place to get information about collaboration.
-For the projects involved here, those documentation locations can be found here:
-
-https://openradarscience.org/projects/
-
-```{important}
-It's good practice to adhere to the project's Code of Conduct. But in any case - be friendly and welcoming.
-```
-
-## HowTo create an own package
-
-```{important}
-Advise: use a cookiecutter!
-A cookiecutter is a command-line utility that creates projects from cookiecutters (project templates), e.g. creating a Python package project from a Python package project template.
-```
-
-We use the Python cookiecutter-template from https://github.com/audreyr/cookiecutter-pypackage.git but without all bells and whistles.
-
-Let's just create a package with some function, install and test it.
-
-
-
-
-
-
-
diff --git a/_preview/93/_sources/package-overview/README.md b/_preview/93/_sources/package-overview/README.md
deleted file mode 100644
index ff030428..00000000
--- a/_preview/93/_sources/package-overview/README.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Open Radar Community
-
-An overview of the open radar science community.
\ No newline at end of file
diff --git a/_preview/93/_sources/pyart/README.md b/_preview/93/_sources/pyart/README.md
deleted file mode 100644
index 0e3506c9..00000000
--- a/_preview/93/_sources/pyart/README.md
+++ /dev/null
@@ -1,19 +0,0 @@
-# Py-ART Tutorial
-
-This is an overview of Py-ART, in 45 minutes!
-
-## 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
-
-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.
-
-## Py-ART Corrections and Calculations
-Once learning the basics, we jump into applying filtering, corrections, and analyzing wind data, focusing on:
-- Filtering and retrievals on raw Swiss C-band data
-- Processing of Doppler wind data from a Swiss volumetric scan
-
-These notebooks also come with an exercise, where you can apply the lessons learned from the basics and workflows to complete a set of tasks!
-
diff --git a/_preview/93/_sources/workflows/README.md b/_preview/93/_sources/workflows/README.md
deleted file mode 100644
index ef79b972..00000000
--- a/_preview/93/_sources/workflows/README.md
+++ /dev/null
@@ -1,3 +0,0 @@
-# Combining Radar Workflows
-
-How to combine the different tools to complete your radar data workflow.
\ No newline at end of file
diff --git a/_preview/93/_sources/wradlib/README.md b/_preview/93/_sources/wradlib/README.md
deleted file mode 100644
index 229115ea..00000000
--- a/_preview/93/_sources/wradlib/README.md
+++ /dev/null
@@ -1,33 +0,0 @@
-# Wradlib Tutorial
-
-This is a short overview of wradlib capabilities in 45 minutes. Brace yourself.
-
-## Radar data IO, Visualisation, Gridding and GIS export
-
-Reading routines for several radar data formats based on xarray are shown.
-Data will be read into xarray datasets with easy access for quick analysis and
-visualisation. Datasets can be written to ODIM_H5 and CfRadial2-like files.
-Easy multiprocessing using DASK can be facilitated. Data is gridded and
-exported to Geoinformation Systems (GIS) formats.
-
-## Data Quality Processing and Beamblockage
-
-A very short overview on the available data quality algorithms with clutter
-detection and beamblockage calculations.
-
-## Attenuation Correction using ZPHI-Method
-
-Already quite aged, the attenuation correction based on the ZPHI-method
-(see [Testud et. al.](https://doi.org/10.1175/1520-0426(2000)017%3C0332:TRPAAT%3E2.0.CO;2))
-is still one of the most used algorithms in weather radar. A quick walk through
-the necessary steps to derive specific attenuation is shown. The benefits of
-specific attenuation derived KDP is shown.
-
-## Quasi Vertical Profiles (QVP)
-
-A short introduction into QVPs is given.
-
-## Short Overview over wradlib features
-
-Here we just mention the capabilities of wradlib and emphasize a few of the new
-enhancements in recent wradlib versions.
diff --git a/_preview/93/_sphinx_design_static/design-style.4045f2051d55cab465a707391d5b2007.min.css b/_preview/93/_sphinx_design_static/design-style.4045f2051d55cab465a707391d5b2007.min.css
deleted file mode 100644
index 3225661c..00000000
--- a/_preview/93/_sphinx_design_static/design-style.4045f2051d55cab465a707391d5b2007.min.css
+++ /dev/null
@@ -1 +0,0 @@
-.sd-bg-primary{background-color:var(--sd-color-primary) !important}.sd-bg-text-primary{color:var(--sd-color-primary-text) !important}button.sd-bg-primary:focus,button.sd-bg-primary:hover{background-color:var(--sd-color-primary-highlight) !important}a.sd-bg-primary:focus,a.sd-bg-primary:hover{background-color:var(--sd-color-primary-highlight) !important}.sd-bg-secondary{background-color:var(--sd-color-secondary) !important}.sd-bg-text-secondary{color:var(--sd-color-secondary-text) !important}button.sd-bg-secondary:focus,button.sd-bg-secondary:hover{background-color:var(--sd-color-secondary-highlight) !important}a.sd-bg-secondary:focus,a.sd-bg-secondary:hover{background-color:var(--sd-color-secondary-highlight) !important}.sd-bg-success{background-color:var(--sd-color-success) !important}.sd-bg-text-success{color:var(--sd-color-success-text) !important}button.sd-bg-success:focus,button.sd-bg-success:hover{background-color:var(--sd-color-success-highlight) !important}a.sd-bg-success:focus,a.sd-bg-success:hover{background-color:var(--sd-color-success-highlight) !important}.sd-bg-info{background-color:var(--sd-color-info) !important}.sd-bg-text-info{color:var(--sd-color-info-text) !important}button.sd-bg-info:focus,button.sd-bg-info:hover{background-color:var(--sd-color-info-highlight) !important}a.sd-bg-info:focus,a.sd-bg-info:hover{background-color:var(--sd-color-info-highlight) !important}.sd-bg-warning{background-color:var(--sd-color-warning) !important}.sd-bg-text-warning{color:var(--sd-color-warning-text) !important}button.sd-bg-warning:focus,button.sd-bg-warning:hover{background-color:var(--sd-color-warning-highlight) !important}a.sd-bg-warning:focus,a.sd-bg-warning:hover{background-color:var(--sd-color-warning-highlight) !important}.sd-bg-danger{background-color:var(--sd-color-danger) !important}.sd-bg-text-danger{color:var(--sd-color-danger-text) !important}button.sd-bg-danger:focus,button.sd-bg-danger:hover{background-color:var(--sd-color-danger-highlight) !important}a.sd-bg-danger:focus,a.sd-bg-danger:hover{background-color:var(--sd-color-danger-highlight) !important}.sd-bg-light{background-color:var(--sd-color-light) !important}.sd-bg-text-light{color:var(--sd-color-light-text) !important}button.sd-bg-light:focus,button.sd-bg-light:hover{background-color:var(--sd-color-light-highlight) !important}a.sd-bg-light:focus,a.sd-bg-light:hover{background-color:var(--sd-color-light-highlight) !important}.sd-bg-muted{background-color:var(--sd-color-muted) !important}.sd-bg-text-muted{color:var(--sd-color-muted-text) !important}button.sd-bg-muted:focus,button.sd-bg-muted:hover{background-color:var(--sd-color-muted-highlight) !important}a.sd-bg-muted:focus,a.sd-bg-muted:hover{background-color:var(--sd-color-muted-highlight) !important}.sd-bg-dark{background-color:var(--sd-color-dark) !important}.sd-bg-text-dark{color:var(--sd-color-dark-text) !important}button.sd-bg-dark:focus,button.sd-bg-dark:hover{background-color:var(--sd-color-dark-highlight) !important}a.sd-bg-dark:focus,a.sd-bg-dark:hover{background-color:var(--sd-color-dark-highlight) !important}.sd-bg-black{background-color:var(--sd-color-black) !important}.sd-bg-text-black{color:var(--sd-color-black-text) !important}button.sd-bg-black:focus,button.sd-bg-black:hover{background-color:var(--sd-color-black-highlight) !important}a.sd-bg-black:focus,a.sd-bg-black:hover{background-color:var(--sd-color-black-highlight) !important}.sd-bg-white{background-color:var(--sd-color-white) !important}.sd-bg-text-white{color:var(--sd-color-white-text) !important}button.sd-bg-white:focus,button.sd-bg-white:hover{background-color:var(--sd-color-white-highlight) !important}a.sd-bg-white:focus,a.sd-bg-white:hover{background-color:var(--sd-color-white-highlight) !important}.sd-text-primary,.sd-text-primary>p{color:var(--sd-color-primary) !important}a.sd-text-primary:focus,a.sd-text-primary:hover{color:var(--sd-color-primary-highlight) !important}.sd-text-secondary,.sd-text-secondary>p{color:var(--sd-color-secondary) !important}a.sd-text-secondary:focus,a.sd-text-secondary:hover{color:var(--sd-color-secondary-highlight) !important}.sd-text-success,.sd-text-success>p{color:var(--sd-color-success) !important}a.sd-text-success:focus,a.sd-text-success:hover{color:var(--sd-color-success-highlight) !important}.sd-text-info,.sd-text-info>p{color:var(--sd-color-info) !important}a.sd-text-info:focus,a.sd-text-info:hover{color:var(--sd-color-info-highlight) !important}.sd-text-warning,.sd-text-warning>p{color:var(--sd-color-warning) !important}a.sd-text-warning:focus,a.sd-text-warning:hover{color:var(--sd-color-warning-highlight) !important}.sd-text-danger,.sd-text-danger>p{color:var(--sd-color-danger) !important}a.sd-text-danger:focus,a.sd-text-danger:hover{color:var(--sd-color-danger-highlight) !important}.sd-text-light,.sd-text-light>p{color:var(--sd-color-light) !important}a.sd-text-light:focus,a.sd-text-light:hover{color:var(--sd-color-light-highlight) !important}.sd-text-muted,.sd-text-muted>p{color:var(--sd-color-muted) !important}a.sd-text-muted:focus,a.sd-text-muted:hover{color:var(--sd-color-muted-highlight) !important}.sd-text-dark,.sd-text-dark>p{color:var(--sd-color-dark) !important}a.sd-text-dark:focus,a.sd-text-dark:hover{color:var(--sd-color-dark-highlight) !important}.sd-text-black,.sd-text-black>p{color:var(--sd-color-black) !important}a.sd-text-black:focus,a.sd-text-black:hover{color:var(--sd-color-black-highlight) !important}.sd-text-white,.sd-text-white>p{color:var(--sd-color-white) !important}a.sd-text-white:focus,a.sd-text-white:hover{color:var(--sd-color-white-highlight) !important}.sd-outline-primary{border-color:var(--sd-color-primary) !important;border-style:solid !important;border-width:1px !important}a.sd-outline-primary:focus,a.sd-outline-primary:hover{border-color:var(--sd-color-primary-highlight) !important}.sd-outline-secondary{border-color:var(--sd-color-secondary) !important;border-style:solid !important;border-width:1px !important}a.sd-outline-secondary:focus,a.sd-outline-secondary:hover{border-color:var(--sd-color-secondary-highlight) !important}.sd-outline-success{border-color:var(--sd-color-success) !important;border-style:solid !important;border-width:1px !important}a.sd-outline-success:focus,a.sd-outline-success:hover{border-color:var(--sd-color-success-highlight) !important}.sd-outline-info{border-color:var(--sd-color-info) !important;border-style:solid !important;border-width:1px !important}a.sd-outline-info:focus,a.sd-outline-info:hover{border-color:var(--sd-color-info-highlight) !important}.sd-outline-warning{border-color:var(--sd-color-warning) !important;border-style:solid !important;border-width:1px !important}a.sd-outline-warning:focus,a.sd-outline-warning:hover{border-color:var(--sd-color-warning-highlight) !important}.sd-outline-danger{border-color:var(--sd-color-danger) !important;border-style:solid !important;border-width:1px !important}a.sd-outline-danger:focus,a.sd-outline-danger:hover{border-color:var(--sd-color-danger-highlight) !important}.sd-outline-light{border-color:var(--sd-color-light) !important;border-style:solid !important;border-width:1px !important}a.sd-outline-light:focus,a.sd-outline-light:hover{border-color:var(--sd-color-light-highlight) !important}.sd-outline-muted{border-color:var(--sd-color-muted) !important;border-style:solid !important;border-width:1px !important}a.sd-outline-muted:focus,a.sd-outline-muted:hover{border-color:var(--sd-color-muted-highlight) !important}.sd-outline-dark{border-color:var(--sd-color-dark) !important;border-style:solid !important;border-width:1px !important}a.sd-outline-dark:focus,a.sd-outline-dark:hover{border-color:var(--sd-color-dark-highlight) !important}.sd-outline-black{border-color:var(--sd-color-black) !important;border-style:solid !important;border-width:1px !important}a.sd-outline-black:focus,a.sd-outline-black:hover{border-color:var(--sd-color-black-highlight) !important}.sd-outline-white{border-color:var(--sd-color-white) !important;border-style:solid !important;border-width:1px !important}a.sd-outline-white:focus,a.sd-outline-white:hover{border-color:var(--sd-color-white-highlight) !important}.sd-bg-transparent{background-color:transparent !important}.sd-outline-transparent{border-color:transparent !important}.sd-text-transparent{color:transparent !important}.sd-p-0{padding:0 !important}.sd-pt-0,.sd-py-0{padding-top:0 !important}.sd-pr-0,.sd-px-0{padding-right:0 !important}.sd-pb-0,.sd-py-0{padding-bottom:0 !important}.sd-pl-0,.sd-px-0{padding-left:0 !important}.sd-p-1{padding:.25rem !important}.sd-pt-1,.sd-py-1{padding-top:.25rem !important}.sd-pr-1,.sd-px-1{padding-right:.25rem !important}.sd-pb-1,.sd-py-1{padding-bottom:.25rem !important}.sd-pl-1,.sd-px-1{padding-left:.25rem !important}.sd-p-2{padding:.5rem !important}.sd-pt-2,.sd-py-2{padding-top:.5rem !important}.sd-pr-2,.sd-px-2{padding-right:.5rem !important}.sd-pb-2,.sd-py-2{padding-bottom:.5rem !important}.sd-pl-2,.sd-px-2{padding-left:.5rem !important}.sd-p-3{padding:1rem !important}.sd-pt-3,.sd-py-3{padding-top:1rem !important}.sd-pr-3,.sd-px-3{padding-right:1rem !important}.sd-pb-3,.sd-py-3{padding-bottom:1rem !important}.sd-pl-3,.sd-px-3{padding-left:1rem !important}.sd-p-4{padding:1.5rem !important}.sd-pt-4,.sd-py-4{padding-top:1.5rem !important}.sd-pr-4,.sd-px-4{padding-right:1.5rem !important}.sd-pb-4,.sd-py-4{padding-bottom:1.5rem !important}.sd-pl-4,.sd-px-4{padding-left:1.5rem !important}.sd-p-5{padding:3rem !important}.sd-pt-5,.sd-py-5{padding-top:3rem !important}.sd-pr-5,.sd-px-5{padding-right:3rem !important}.sd-pb-5,.sd-py-5{padding-bottom:3rem !important}.sd-pl-5,.sd-px-5{padding-left:3rem !important}.sd-m-auto{margin:auto !important}.sd-mt-auto,.sd-my-auto{margin-top:auto !important}.sd-mr-auto,.sd-mx-auto{margin-right:auto !important}.sd-mb-auto,.sd-my-auto{margin-bottom:auto !important}.sd-ml-auto,.sd-mx-auto{margin-left:auto !important}.sd-m-0{margin:0 !important}.sd-mt-0,.sd-my-0{margin-top:0 !important}.sd-mr-0,.sd-mx-0{margin-right:0 !important}.sd-mb-0,.sd-my-0{margin-bottom:0 !important}.sd-ml-0,.sd-mx-0{margin-left:0 !important}.sd-m-1{margin:.25rem !important}.sd-mt-1,.sd-my-1{margin-top:.25rem !important}.sd-mr-1,.sd-mx-1{margin-right:.25rem !important}.sd-mb-1,.sd-my-1{margin-bottom:.25rem !important}.sd-ml-1,.sd-mx-1{margin-left:.25rem !important}.sd-m-2{margin:.5rem !important}.sd-mt-2,.sd-my-2{margin-top:.5rem !important}.sd-mr-2,.sd-mx-2{margin-right:.5rem !important}.sd-mb-2,.sd-my-2{margin-bottom:.5rem !important}.sd-ml-2,.sd-mx-2{margin-left:.5rem !important}.sd-m-3{margin:1rem !important}.sd-mt-3,.sd-my-3{margin-top:1rem !important}.sd-mr-3,.sd-mx-3{margin-right:1rem !important}.sd-mb-3,.sd-my-3{margin-bottom:1rem !important}.sd-ml-3,.sd-mx-3{margin-left:1rem !important}.sd-m-4{margin:1.5rem !important}.sd-mt-4,.sd-my-4{margin-top:1.5rem !important}.sd-mr-4,.sd-mx-4{margin-right:1.5rem !important}.sd-mb-4,.sd-my-4{margin-bottom:1.5rem !important}.sd-ml-4,.sd-mx-4{margin-left:1.5rem !important}.sd-m-5{margin:3rem !important}.sd-mt-5,.sd-my-5{margin-top:3rem !important}.sd-mr-5,.sd-mx-5{margin-right:3rem !important}.sd-mb-5,.sd-my-5{margin-bottom:3rem !important}.sd-ml-5,.sd-mx-5{margin-left:3rem !important}.sd-w-25{width:25% !important}.sd-w-50{width:50% !important}.sd-w-75{width:75% !important}.sd-w-100{width:100% !important}.sd-w-auto{width:auto !important}.sd-h-25{height:25% !important}.sd-h-50{height:50% !important}.sd-h-75{height:75% !important}.sd-h-100{height:100% !important}.sd-h-auto{height:auto !important}.sd-d-none{display:none !important}.sd-d-inline{display:inline !important}.sd-d-inline-block{display:inline-block !important}.sd-d-block{display:block !important}.sd-d-grid{display:grid !important}.sd-d-flex-row{display:-ms-flexbox !important;display:flex !important;flex-direction:row !important}.sd-d-flex-column{display:-ms-flexbox !important;display:flex !important;flex-direction:column !important}.sd-d-inline-flex{display:-ms-inline-flexbox !important;display:inline-flex !important}@media(min-width: 576px){.sd-d-sm-none{display:none !important}.sd-d-sm-inline{display:inline !important}.sd-d-sm-inline-block{display:inline-block !important}.sd-d-sm-block{display:block !important}.sd-d-sm-grid{display:grid !important}.sd-d-sm-flex{display:-ms-flexbox !important;display:flex !important}.sd-d-sm-inline-flex{display:-ms-inline-flexbox !important;display:inline-flex !important}}@media(min-width: 768px){.sd-d-md-none{display:none !important}.sd-d-md-inline{display:inline !important}.sd-d-md-inline-block{display:inline-block !important}.sd-d-md-block{display:block !important}.sd-d-md-grid{display:grid !important}.sd-d-md-flex{display:-ms-flexbox !important;display:flex !important}.sd-d-md-inline-flex{display:-ms-inline-flexbox !important;display:inline-flex !important}}@media(min-width: 992px){.sd-d-lg-none{display:none !important}.sd-d-lg-inline{display:inline !important}.sd-d-lg-inline-block{display:inline-block !important}.sd-d-lg-block{display:block !important}.sd-d-lg-grid{display:grid !important}.sd-d-lg-flex{display:-ms-flexbox !important;display:flex !important}.sd-d-lg-inline-flex{display:-ms-inline-flexbox !important;display:inline-flex !important}}@media(min-width: 1200px){.sd-d-xl-none{display:none !important}.sd-d-xl-inline{display:inline !important}.sd-d-xl-inline-block{display:inline-block !important}.sd-d-xl-block{display:block !important}.sd-d-xl-grid{display:grid !important}.sd-d-xl-flex{display:-ms-flexbox !important;display:flex !important}.sd-d-xl-inline-flex{display:-ms-inline-flexbox !important;display:inline-flex !important}}.sd-align-major-start{justify-content:flex-start !important}.sd-align-major-end{justify-content:flex-end !important}.sd-align-major-center{justify-content:center !important}.sd-align-major-justify{justify-content:space-between !important}.sd-align-major-spaced{justify-content:space-evenly !important}.sd-align-minor-start{align-items:flex-start !important}.sd-align-minor-end{align-items:flex-end !important}.sd-align-minor-center{align-items:center !important}.sd-align-minor-stretch{align-items:stretch !important}.sd-text-justify{text-align:justify !important}.sd-text-left{text-align:left !important}.sd-text-right{text-align:right !important}.sd-text-center{text-align:center !important}.sd-font-weight-light{font-weight:300 !important}.sd-font-weight-lighter{font-weight:lighter !important}.sd-font-weight-normal{font-weight:400 !important}.sd-font-weight-bold{font-weight:700 !important}.sd-font-weight-bolder{font-weight:bolder !important}.sd-font-italic{font-style:italic !important}.sd-text-decoration-none{text-decoration:none !important}.sd-text-lowercase{text-transform:lowercase !important}.sd-text-uppercase{text-transform:uppercase !important}.sd-text-capitalize{text-transform:capitalize !important}.sd-text-wrap{white-space:normal !important}.sd-text-nowrap{white-space:nowrap !important}.sd-text-truncate{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.sd-fs-1,.sd-fs-1>p{font-size:calc(1.375rem + 1.5vw) !important;line-height:unset !important}.sd-fs-2,.sd-fs-2>p{font-size:calc(1.325rem + 0.9vw) !important;line-height:unset !important}.sd-fs-3,.sd-fs-3>p{font-size:calc(1.3rem + 0.6vw) !important;line-height:unset !important}.sd-fs-4,.sd-fs-4>p{font-size:calc(1.275rem + 0.3vw) !important;line-height:unset !important}.sd-fs-5,.sd-fs-5>p{font-size:1.25rem !important;line-height:unset !important}.sd-fs-6,.sd-fs-6>p{font-size:1rem !important;line-height:unset !important}.sd-border-0{border:0 solid !important}.sd-border-top-0{border-top:0 solid !important}.sd-border-bottom-0{border-bottom:0 solid !important}.sd-border-right-0{border-right:0 solid !important}.sd-border-left-0{border-left:0 solid !important}.sd-border-1{border:1px solid !important}.sd-border-top-1{border-top:1px solid !important}.sd-border-bottom-1{border-bottom:1px solid !important}.sd-border-right-1{border-right:1px solid !important}.sd-border-left-1{border-left:1px solid !important}.sd-border-2{border:2px solid !important}.sd-border-top-2{border-top:2px solid !important}.sd-border-bottom-2{border-bottom:2px solid !important}.sd-border-right-2{border-right:2px solid !important}.sd-border-left-2{border-left:2px solid !important}.sd-border-3{border:3px solid !important}.sd-border-top-3{border-top:3px solid !important}.sd-border-bottom-3{border-bottom:3px solid !important}.sd-border-right-3{border-right:3px solid !important}.sd-border-left-3{border-left:3px solid !important}.sd-border-4{border:4px solid !important}.sd-border-top-4{border-top:4px solid !important}.sd-border-bottom-4{border-bottom:4px solid !important}.sd-border-right-4{border-right:4px solid !important}.sd-border-left-4{border-left:4px solid !important}.sd-border-5{border:5px solid !important}.sd-border-top-5{border-top:5px solid !important}.sd-border-bottom-5{border-bottom:5px solid !important}.sd-border-right-5{border-right:5px solid !important}.sd-border-left-5{border-left:5px solid !important}.sd-rounded-0{border-radius:0 !important}.sd-rounded-1{border-radius:.2rem !important}.sd-rounded-2{border-radius:.3rem !important}.sd-rounded-3{border-radius:.5rem !important}.sd-rounded-pill{border-radius:50rem !important}.sd-rounded-circle{border-radius:50% !important}.shadow-none{box-shadow:none !important}.sd-shadow-sm{box-shadow:0 .125rem .25rem var(--sd-color-shadow) !important}.sd-shadow-md{box-shadow:0 .5rem 1rem var(--sd-color-shadow) !important}.sd-shadow-lg{box-shadow:0 1rem 3rem var(--sd-color-shadow) !important}@keyframes sd-slide-from-left{0%{transform:translateX(-100%)}100%{transform:translateX(0)}}@keyframes sd-slide-from-right{0%{transform:translateX(200%)}100%{transform:translateX(0)}}@keyframes sd-grow100{0%{transform:scale(0);opacity:.5}100%{transform:scale(1);opacity:1}}@keyframes sd-grow50{0%{transform:scale(0.5);opacity:.5}100%{transform:scale(1);opacity:1}}@keyframes sd-grow50-rot20{0%{transform:scale(0.5) rotateZ(-20deg);opacity:.5}75%{transform:scale(1) rotateZ(5deg);opacity:1}95%{transform:scale(1) rotateZ(-1deg);opacity:1}100%{transform:scale(1) rotateZ(0);opacity:1}}.sd-animate-slide-from-left{animation:1s ease-out 0s 1 normal none running sd-slide-from-left}.sd-animate-slide-from-right{animation:1s ease-out 0s 1 normal none running sd-slide-from-right}.sd-animate-grow100{animation:1s ease-out 0s 1 normal none running sd-grow100}.sd-animate-grow50{animation:1s ease-out 0s 1 normal none running sd-grow50}.sd-animate-grow50-rot20{animation:1s ease-out 0s 1 normal none running sd-grow50-rot20}.sd-badge{display:inline-block;padding:.35em .65em;font-size:.75em;font-weight:700;line-height:1;text-align:center;white-space:nowrap;vertical-align:baseline;border-radius:.25rem}.sd-badge:empty{display:none}a.sd-badge{text-decoration:none}.sd-btn .sd-badge{position:relative;top:-1px}.sd-btn{background-color:transparent;border:1px solid transparent;border-radius:.25rem;cursor:pointer;display:inline-block;font-weight:400;font-size:1rem;line-height:1.5;padding:.375rem .75rem;text-align:center;text-decoration:none;transition:color .15s ease-in-out,background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out;vertical-align:middle;user-select:none;-moz-user-select:none;-ms-user-select:none;-webkit-user-select:none}.sd-btn:hover{text-decoration:none}@media(prefers-reduced-motion: reduce){.sd-btn{transition:none}}.sd-btn-primary,.sd-btn-outline-primary:hover,.sd-btn-outline-primary:focus{color:var(--sd-color-primary-text) !important;background-color:var(--sd-color-primary) !important;border-color:var(--sd-color-primary) !important;border-width:1px !important;border-style:solid !important}.sd-btn-primary:hover,.sd-btn-primary:focus{color:var(--sd-color-primary-text) !important;background-color:var(--sd-color-primary-highlight) !important;border-color:var(--sd-color-primary-highlight) !important;border-width:1px !important;border-style:solid !important}.sd-btn-outline-primary{color:var(--sd-color-primary) !important;border-color:var(--sd-color-primary) !important;border-width:1px !important;border-style:solid !important}.sd-btn-secondary,.sd-btn-outline-secondary:hover,.sd-btn-outline-secondary:focus{color:var(--sd-color-secondary-text) !important;background-color:var(--sd-color-secondary) !important;border-color:var(--sd-color-secondary) !important;border-width:1px !important;border-style:solid !important}.sd-btn-secondary:hover,.sd-btn-secondary:focus{color:var(--sd-color-secondary-text) !important;background-color:var(--sd-color-secondary-highlight) !important;border-color:var(--sd-color-secondary-highlight) !important;border-width:1px !important;border-style:solid !important}.sd-btn-outline-secondary{color:var(--sd-color-secondary) !important;border-color:var(--sd-color-secondary) !important;border-width:1px !important;border-style:solid !important}.sd-btn-success,.sd-btn-outline-success:hover,.sd-btn-outline-success:focus{color:var(--sd-color-success-text) !important;background-color:var(--sd-color-success) !important;border-color:var(--sd-color-success) !important;border-width:1px !important;border-style:solid !important}.sd-btn-success:hover,.sd-btn-success:focus{color:var(--sd-color-success-text) !important;background-color:var(--sd-color-success-highlight) !important;border-color:var(--sd-color-success-highlight) !important;border-width:1px !important;border-style:solid !important}.sd-btn-outline-success{color:var(--sd-color-success) !important;border-color:var(--sd-color-success) !important;border-width:1px !important;border-style:solid !important}.sd-btn-info,.sd-btn-outline-info:hover,.sd-btn-outline-info:focus{color:var(--sd-color-info-text) !important;background-color:var(--sd-color-info) !important;border-color:var(--sd-color-info) !important;border-width:1px !important;border-style:solid !important}.sd-btn-info:hover,.sd-btn-info:focus{color:var(--sd-color-info-text) !important;background-color:var(--sd-color-info-highlight) !important;border-color:var(--sd-color-info-highlight) !important;border-width:1px !important;border-style:solid !important}.sd-btn-outline-info{color:var(--sd-color-info) !important;border-color:var(--sd-color-info) !important;border-width:1px !important;border-style:solid !important}.sd-btn-warning,.sd-btn-outline-warning:hover,.sd-btn-outline-warning:focus{color:var(--sd-color-warning-text) !important;background-color:var(--sd-color-warning) !important;border-color:var(--sd-color-warning) !important;border-width:1px !important;border-style:solid !important}.sd-btn-warning:hover,.sd-btn-warning:focus{color:var(--sd-color-warning-text) !important;background-color:var(--sd-color-warning-highlight) !important;border-color:var(--sd-color-warning-highlight) !important;border-width:1px !important;border-style:solid !important}.sd-btn-outline-warning{color:var(--sd-color-warning) !important;border-color:var(--sd-color-warning) !important;border-width:1px !important;border-style:solid !important}.sd-btn-danger,.sd-btn-outline-danger:hover,.sd-btn-outline-danger:focus{color:var(--sd-color-danger-text) !important;background-color:var(--sd-color-danger) !important;border-color:var(--sd-color-danger) !important;border-width:1px !important;border-style:solid !important}.sd-btn-danger:hover,.sd-btn-danger:focus{color:var(--sd-color-danger-text) !important;background-color:var(--sd-color-danger-highlight) !important;border-color:var(--sd-color-danger-highlight) !important;border-width:1px !important;border-style:solid !important}.sd-btn-outline-danger{color:var(--sd-color-danger) !important;border-color:var(--sd-color-danger) !important;border-width:1px !important;border-style:solid !important}.sd-btn-light,.sd-btn-outline-light:hover,.sd-btn-outline-light:focus{color:var(--sd-color-light-text) !important;background-color:var(--sd-color-light) !important;border-color:var(--sd-color-light) !important;border-width:1px !important;border-style:solid !important}.sd-btn-light:hover,.sd-btn-light:focus{color:var(--sd-color-light-text) !important;background-color:var(--sd-color-light-highlight) !important;border-color:var(--sd-color-light-highlight) !important;border-width:1px !important;border-style:solid !important}.sd-btn-outline-light{color:var(--sd-color-light) !important;border-color:var(--sd-color-light) !important;border-width:1px !important;border-style:solid !important}.sd-btn-muted,.sd-btn-outline-muted:hover,.sd-btn-outline-muted:focus{color:var(--sd-color-muted-text) !important;background-color:var(--sd-color-muted) !important;border-color:var(--sd-color-muted) !important;border-width:1px !important;border-style:solid !important}.sd-btn-muted:hover,.sd-btn-muted:focus{color:var(--sd-color-muted-text) !important;background-color:var(--sd-color-muted-highlight) !important;border-color:var(--sd-color-muted-highlight) !important;border-width:1px !important;border-style:solid !important}.sd-btn-outline-muted{color:var(--sd-color-muted) !important;border-color:var(--sd-color-muted) !important;border-width:1px !important;border-style:solid !important}.sd-btn-dark,.sd-btn-outline-dark:hover,.sd-btn-outline-dark:focus{color:var(--sd-color-dark-text) !important;background-color:var(--sd-color-dark) !important;border-color:var(--sd-color-dark) !important;border-width:1px !important;border-style:solid !important}.sd-btn-dark:hover,.sd-btn-dark:focus{color:var(--sd-color-dark-text) !important;background-color:var(--sd-color-dark-highlight) !important;border-color:var(--sd-color-dark-highlight) !important;border-width:1px !important;border-style:solid !important}.sd-btn-outline-dark{color:var(--sd-color-dark) !important;border-color:var(--sd-color-dark) !important;border-width:1px !important;border-style:solid !important}.sd-btn-black,.sd-btn-outline-black:hover,.sd-btn-outline-black:focus{color:var(--sd-color-black-text) !important;background-color:var(--sd-color-black) !important;border-color:var(--sd-color-black) !important;border-width:1px !important;border-style:solid !important}.sd-btn-black:hover,.sd-btn-black:focus{color:var(--sd-color-black-text) !important;background-color:var(--sd-color-black-highlight) !important;border-color:var(--sd-color-black-highlight) !important;border-width:1px !important;border-style:solid !important}.sd-btn-outline-black{color:var(--sd-color-black) !important;border-color:var(--sd-color-black) !important;border-width:1px !important;border-style:solid !important}.sd-btn-white,.sd-btn-outline-white:hover,.sd-btn-outline-white:focus{color:var(--sd-color-white-text) !important;background-color:var(--sd-color-white) !important;border-color:var(--sd-color-white) !important;border-width:1px !important;border-style:solid !important}.sd-btn-white:hover,.sd-btn-white:focus{color:var(--sd-color-white-text) !important;background-color:var(--sd-color-white-highlight) !important;border-color:var(--sd-color-white-highlight) !important;border-width:1px !important;border-style:solid !important}.sd-btn-outline-white{color:var(--sd-color-white) !important;border-color:var(--sd-color-white) !important;border-width:1px !important;border-style:solid !important}.sd-stretched-link::after{position:absolute;top:0;right:0;bottom:0;left:0;z-index:1;content:""}.sd-hide-link-text{font-size:0}.sd-octicon,.sd-material-icon{display:inline-block;fill:currentColor;vertical-align:middle}.sd-avatar-xs{border-radius:50%;object-fit:cover;object-position:center;width:1rem;height:1rem}.sd-avatar-sm{border-radius:50%;object-fit:cover;object-position:center;width:3rem;height:3rem}.sd-avatar-md{border-radius:50%;object-fit:cover;object-position:center;width:5rem;height:5rem}.sd-avatar-lg{border-radius:50%;object-fit:cover;object-position:center;width:7rem;height:7rem}.sd-avatar-xl{border-radius:50%;object-fit:cover;object-position:center;width:10rem;height:10rem}.sd-avatar-inherit{border-radius:50%;object-fit:cover;object-position:center;width:inherit;height:inherit}.sd-avatar-initial{border-radius:50%;object-fit:cover;object-position:center;width:initial;height:initial}.sd-card{background-clip:border-box;background-color:var(--sd-color-card-background);border:1px solid var(--sd-color-card-border);border-radius:.25rem;color:var(--sd-color-card-text);display:-ms-flexbox;display:flex;-ms-flex-direction:column;flex-direction:column;min-width:0;position:relative;word-wrap:break-word}.sd-card>hr{margin-left:0;margin-right:0}.sd-card-hover:hover{border-color:var(--sd-color-card-border-hover);transform:scale(1.01)}.sd-card-body{-ms-flex:1 1 auto;flex:1 1 auto;padding:1rem 1rem}.sd-card-title{margin-bottom:.5rem}.sd-card-subtitle{margin-top:-0.25rem;margin-bottom:0}.sd-card-text:last-child{margin-bottom:0}.sd-card-link:hover{text-decoration:none}.sd-card-link+.card-link{margin-left:1rem}.sd-card-header{padding:.5rem 1rem;margin-bottom:0;background-color:var(--sd-color-card-header);border-bottom:1px solid var(--sd-color-card-border)}.sd-card-header:first-child{border-radius:calc(0.25rem - 1px) calc(0.25rem - 1px) 0 0}.sd-card-footer{padding:.5rem 1rem;background-color:var(--sd-color-card-footer);border-top:1px solid var(--sd-color-card-border)}.sd-card-footer:last-child{border-radius:0 0 calc(0.25rem - 1px) calc(0.25rem - 1px)}.sd-card-header-tabs{margin-right:-0.5rem;margin-bottom:-0.5rem;margin-left:-0.5rem;border-bottom:0}.sd-card-header-pills{margin-right:-0.5rem;margin-left:-0.5rem}.sd-card-img-overlay{position:absolute;top:0;right:0;bottom:0;left:0;padding:1rem;border-radius:calc(0.25rem - 1px)}.sd-card-img,.sd-card-img-bottom,.sd-card-img-top{width:100%}.sd-card-img,.sd-card-img-top{border-top-left-radius:calc(0.25rem - 1px);border-top-right-radius:calc(0.25rem - 1px)}.sd-card-img,.sd-card-img-bottom{border-bottom-left-radius:calc(0.25rem - 1px);border-bottom-right-radius:calc(0.25rem - 1px)}.sd-cards-carousel{width:100%;display:flex;flex-wrap:nowrap;-ms-flex-direction:row;flex-direction:row;overflow-x:hidden;scroll-snap-type:x mandatory}.sd-cards-carousel.sd-show-scrollbar{overflow-x:auto}.sd-cards-carousel:hover,.sd-cards-carousel:focus{overflow-x:auto}.sd-cards-carousel>.sd-card{flex-shrink:0;scroll-snap-align:start}.sd-cards-carousel>.sd-card:not(:last-child){margin-right:3px}.sd-card-cols-1>.sd-card{width:90%}.sd-card-cols-2>.sd-card{width:45%}.sd-card-cols-3>.sd-card{width:30%}.sd-card-cols-4>.sd-card{width:22.5%}.sd-card-cols-5>.sd-card{width:18%}.sd-card-cols-6>.sd-card{width:15%}.sd-card-cols-7>.sd-card{width:12.8571428571%}.sd-card-cols-8>.sd-card{width:11.25%}.sd-card-cols-9>.sd-card{width:10%}.sd-card-cols-10>.sd-card{width:9%}.sd-card-cols-11>.sd-card{width:8.1818181818%}.sd-card-cols-12>.sd-card{width:7.5%}.sd-container,.sd-container-fluid,.sd-container-lg,.sd-container-md,.sd-container-sm,.sd-container-xl{margin-left:auto;margin-right:auto;padding-left:var(--sd-gutter-x, 0.75rem);padding-right:var(--sd-gutter-x, 0.75rem);width:100%}@media(min-width: 576px){.sd-container-sm,.sd-container{max-width:540px}}@media(min-width: 768px){.sd-container-md,.sd-container-sm,.sd-container{max-width:720px}}@media(min-width: 992px){.sd-container-lg,.sd-container-md,.sd-container-sm,.sd-container{max-width:960px}}@media(min-width: 1200px){.sd-container-xl,.sd-container-lg,.sd-container-md,.sd-container-sm,.sd-container{max-width:1140px}}.sd-row{--sd-gutter-x: 1.5rem;--sd-gutter-y: 0;display:-ms-flexbox;display:flex;-ms-flex-wrap:wrap;flex-wrap:wrap;margin-top:calc(var(--sd-gutter-y) * -1);margin-right:calc(var(--sd-gutter-x) * -0.5);margin-left:calc(var(--sd-gutter-x) * -0.5)}.sd-row>*{box-sizing:border-box;flex-shrink:0;width:100%;max-width:100%;padding-right:calc(var(--sd-gutter-x) * 0.5);padding-left:calc(var(--sd-gutter-x) * 0.5);margin-top:var(--sd-gutter-y)}.sd-col{flex:1 0 0%;-ms-flex:1 0 0%}.sd-row-cols-auto>*{flex:0 0 auto;width:auto}.sd-row-cols-1>*{flex:0 0 auto;-ms-flex:0 0 auto;width:100%}.sd-row-cols-2>*{flex:0 0 auto;-ms-flex:0 0 auto;width:50%}.sd-row-cols-3>*{flex:0 0 auto;-ms-flex:0 0 auto;width:33.3333333333%}.sd-row-cols-4>*{flex:0 0 auto;-ms-flex:0 0 auto;width:25%}.sd-row-cols-5>*{flex:0 0 auto;-ms-flex:0 0 auto;width:20%}.sd-row-cols-6>*{flex:0 0 auto;-ms-flex:0 0 auto;width:16.6666666667%}.sd-row-cols-7>*{flex:0 0 auto;-ms-flex:0 0 auto;width:14.2857142857%}.sd-row-cols-8>*{flex:0 0 auto;-ms-flex:0 0 auto;width:12.5%}.sd-row-cols-9>*{flex:0 0 auto;-ms-flex:0 0 auto;width:11.1111111111%}.sd-row-cols-10>*{flex:0 0 auto;-ms-flex:0 0 auto;width:10%}.sd-row-cols-11>*{flex:0 0 auto;-ms-flex:0 0 auto;width:9.0909090909%}.sd-row-cols-12>*{flex:0 0 auto;-ms-flex:0 0 auto;width:8.3333333333%}@media(min-width: 576px){.sd-col-sm{flex:1 0 0%;-ms-flex:1 0 0%}.sd-row-cols-sm-auto{flex:1 0 auto;-ms-flex:1 0 auto;width:100%}.sd-row-cols-sm-1>*{flex:0 0 auto;-ms-flex:0 0 auto;width:100%}.sd-row-cols-sm-2>*{flex:0 0 auto;-ms-flex:0 0 auto;width:50%}.sd-row-cols-sm-3>*{flex:0 0 auto;-ms-flex:0 0 auto;width:33.3333333333%}.sd-row-cols-sm-4>*{flex:0 0 auto;-ms-flex:0 0 auto;width:25%}.sd-row-cols-sm-5>*{flex:0 0 auto;-ms-flex:0 0 auto;width:20%}.sd-row-cols-sm-6>*{flex:0 0 auto;-ms-flex:0 0 auto;width:16.6666666667%}.sd-row-cols-sm-7>*{flex:0 0 auto;-ms-flex:0 0 auto;width:14.2857142857%}.sd-row-cols-sm-8>*{flex:0 0 auto;-ms-flex:0 0 auto;width:12.5%}.sd-row-cols-sm-9>*{flex:0 0 auto;-ms-flex:0 0 auto;width:11.1111111111%}.sd-row-cols-sm-10>*{flex:0 0 auto;-ms-flex:0 0 auto;width:10%}.sd-row-cols-sm-11>*{flex:0 0 auto;-ms-flex:0 0 auto;width:9.0909090909%}.sd-row-cols-sm-12>*{flex:0 0 auto;-ms-flex:0 0 auto;width:8.3333333333%}}@media(min-width: 768px){.sd-col-md{flex:1 0 0%;-ms-flex:1 0 0%}.sd-row-cols-md-auto{flex:1 0 auto;-ms-flex:1 0 auto;width:100%}.sd-row-cols-md-1>*{flex:0 0 auto;-ms-flex:0 0 auto;width:100%}.sd-row-cols-md-2>*{flex:0 0 auto;-ms-flex:0 0 auto;width:50%}.sd-row-cols-md-3>*{flex:0 0 auto;-ms-flex:0 0 auto;width:33.3333333333%}.sd-row-cols-md-4>*{flex:0 0 auto;-ms-flex:0 0 auto;width:25%}.sd-row-cols-md-5>*{flex:0 0 auto;-ms-flex:0 0 auto;width:20%}.sd-row-cols-md-6>*{flex:0 0 auto;-ms-flex:0 0 auto;width:16.6666666667%}.sd-row-cols-md-7>*{flex:0 0 auto;-ms-flex:0 0 auto;width:14.2857142857%}.sd-row-cols-md-8>*{flex:0 0 auto;-ms-flex:0 0 auto;width:12.5%}.sd-row-cols-md-9>*{flex:0 0 auto;-ms-flex:0 0 auto;width:11.1111111111%}.sd-row-cols-md-10>*{flex:0 0 auto;-ms-flex:0 0 auto;width:10%}.sd-row-cols-md-11>*{flex:0 0 auto;-ms-flex:0 0 auto;width:9.0909090909%}.sd-row-cols-md-12>*{flex:0 0 auto;-ms-flex:0 0 auto;width:8.3333333333%}}@media(min-width: 992px){.sd-col-lg{flex:1 0 0%;-ms-flex:1 0 0%}.sd-row-cols-lg-auto{flex:1 0 auto;-ms-flex:1 0 auto;width:100%}.sd-row-cols-lg-1>*{flex:0 0 auto;-ms-flex:0 0 auto;width:100%}.sd-row-cols-lg-2>*{flex:0 0 auto;-ms-flex:0 0 auto;width:50%}.sd-row-cols-lg-3>*{flex:0 0 auto;-ms-flex:0 0 auto;width:33.3333333333%}.sd-row-cols-lg-4>*{flex:0 0 auto;-ms-flex:0 0 auto;width:25%}.sd-row-cols-lg-5>*{flex:0 0 auto;-ms-flex:0 0 auto;width:20%}.sd-row-cols-lg-6>*{flex:0 0 auto;-ms-flex:0 0 auto;width:16.6666666667%}.sd-row-cols-lg-7>*{flex:0 0 auto;-ms-flex:0 0 auto;width:14.2857142857%}.sd-row-cols-lg-8>*{flex:0 0 auto;-ms-flex:0 0 auto;width:12.5%}.sd-row-cols-lg-9>*{flex:0 0 auto;-ms-flex:0 0 auto;width:11.1111111111%}.sd-row-cols-lg-10>*{flex:0 0 auto;-ms-flex:0 0 auto;width:10%}.sd-row-cols-lg-11>*{flex:0 0 auto;-ms-flex:0 0 auto;width:9.0909090909%}.sd-row-cols-lg-12>*{flex:0 0 auto;-ms-flex:0 0 auto;width:8.3333333333%}}@media(min-width: 1200px){.sd-col-xl{flex:1 0 0%;-ms-flex:1 0 0%}.sd-row-cols-xl-auto{flex:1 0 auto;-ms-flex:1 0 auto;width:100%}.sd-row-cols-xl-1>*{flex:0 0 auto;-ms-flex:0 0 auto;width:100%}.sd-row-cols-xl-2>*{flex:0 0 auto;-ms-flex:0 0 auto;width:50%}.sd-row-cols-xl-3>*{flex:0 0 auto;-ms-flex:0 0 auto;width:33.3333333333%}.sd-row-cols-xl-4>*{flex:0 0 auto;-ms-flex:0 0 auto;width:25%}.sd-row-cols-xl-5>*{flex:0 0 auto;-ms-flex:0 0 auto;width:20%}.sd-row-cols-xl-6>*{flex:0 0 auto;-ms-flex:0 0 auto;width:16.6666666667%}.sd-row-cols-xl-7>*{flex:0 0 auto;-ms-flex:0 0 auto;width:14.2857142857%}.sd-row-cols-xl-8>*{flex:0 0 auto;-ms-flex:0 0 auto;width:12.5%}.sd-row-cols-xl-9>*{flex:0 0 auto;-ms-flex:0 0 auto;width:11.1111111111%}.sd-row-cols-xl-10>*{flex:0 0 auto;-ms-flex:0 0 auto;width:10%}.sd-row-cols-xl-11>*{flex:0 0 auto;-ms-flex:0 0 auto;width:9.0909090909%}.sd-row-cols-xl-12>*{flex:0 0 auto;-ms-flex:0 0 auto;width:8.3333333333%}}.sd-col-auto{flex:0 0 auto;-ms-flex:0 0 auto;width:auto}.sd-col-1{flex:0 0 auto;-ms-flex:0 0 auto;width:8.3333333333%}.sd-col-2{flex:0 0 auto;-ms-flex:0 0 auto;width:16.6666666667%}.sd-col-3{flex:0 0 auto;-ms-flex:0 0 auto;width:25%}.sd-col-4{flex:0 0 auto;-ms-flex:0 0 auto;width:33.3333333333%}.sd-col-5{flex:0 0 auto;-ms-flex:0 0 auto;width:41.6666666667%}.sd-col-6{flex:0 0 auto;-ms-flex:0 0 auto;width:50%}.sd-col-7{flex:0 0 auto;-ms-flex:0 0 auto;width:58.3333333333%}.sd-col-8{flex:0 0 auto;-ms-flex:0 0 auto;width:66.6666666667%}.sd-col-9{flex:0 0 auto;-ms-flex:0 0 auto;width:75%}.sd-col-10{flex:0 0 auto;-ms-flex:0 0 auto;width:83.3333333333%}.sd-col-11{flex:0 0 auto;-ms-flex:0 0 auto;width:91.6666666667%}.sd-col-12{flex:0 0 auto;-ms-flex:0 0 auto;width:100%}.sd-g-0,.sd-gy-0{--sd-gutter-y: 0}.sd-g-0,.sd-gx-0{--sd-gutter-x: 0}.sd-g-1,.sd-gy-1{--sd-gutter-y: 0.25rem}.sd-g-1,.sd-gx-1{--sd-gutter-x: 0.25rem}.sd-g-2,.sd-gy-2{--sd-gutter-y: 0.5rem}.sd-g-2,.sd-gx-2{--sd-gutter-x: 0.5rem}.sd-g-3,.sd-gy-3{--sd-gutter-y: 1rem}.sd-g-3,.sd-gx-3{--sd-gutter-x: 1rem}.sd-g-4,.sd-gy-4{--sd-gutter-y: 1.5rem}.sd-g-4,.sd-gx-4{--sd-gutter-x: 1.5rem}.sd-g-5,.sd-gy-5{--sd-gutter-y: 3rem}.sd-g-5,.sd-gx-5{--sd-gutter-x: 3rem}@media(min-width: 576px){.sd-col-sm-auto{-ms-flex:0 0 auto;flex:0 0 auto;width:auto}.sd-col-sm-1{-ms-flex:0 0 auto;flex:0 0 auto;width:8.3333333333%}.sd-col-sm-2{-ms-flex:0 0 auto;flex:0 0 auto;width:16.6666666667%}.sd-col-sm-3{-ms-flex:0 0 auto;flex:0 0 auto;width:25%}.sd-col-sm-4{-ms-flex:0 0 auto;flex:0 0 auto;width:33.3333333333%}.sd-col-sm-5{-ms-flex:0 0 auto;flex:0 0 auto;width:41.6666666667%}.sd-col-sm-6{-ms-flex:0 0 auto;flex:0 0 auto;width:50%}.sd-col-sm-7{-ms-flex:0 0 auto;flex:0 0 auto;width:58.3333333333%}.sd-col-sm-8{-ms-flex:0 0 auto;flex:0 0 auto;width:66.6666666667%}.sd-col-sm-9{-ms-flex:0 0 auto;flex:0 0 auto;width:75%}.sd-col-sm-10{-ms-flex:0 0 auto;flex:0 0 auto;width:83.3333333333%}.sd-col-sm-11{-ms-flex:0 0 auto;flex:0 0 auto;width:91.6666666667%}.sd-col-sm-12{-ms-flex:0 0 auto;flex:0 0 auto;width:100%}.sd-g-sm-0,.sd-gy-sm-0{--sd-gutter-y: 0}.sd-g-sm-0,.sd-gx-sm-0{--sd-gutter-x: 0}.sd-g-sm-1,.sd-gy-sm-1{--sd-gutter-y: 0.25rem}.sd-g-sm-1,.sd-gx-sm-1{--sd-gutter-x: 0.25rem}.sd-g-sm-2,.sd-gy-sm-2{--sd-gutter-y: 0.5rem}.sd-g-sm-2,.sd-gx-sm-2{--sd-gutter-x: 0.5rem}.sd-g-sm-3,.sd-gy-sm-3{--sd-gutter-y: 1rem}.sd-g-sm-3,.sd-gx-sm-3{--sd-gutter-x: 1rem}.sd-g-sm-4,.sd-gy-sm-4{--sd-gutter-y: 1.5rem}.sd-g-sm-4,.sd-gx-sm-4{--sd-gutter-x: 1.5rem}.sd-g-sm-5,.sd-gy-sm-5{--sd-gutter-y: 3rem}.sd-g-sm-5,.sd-gx-sm-5{--sd-gutter-x: 3rem}}@media(min-width: 768px){.sd-col-md-auto{-ms-flex:0 0 auto;flex:0 0 auto;width:auto}.sd-col-md-1{-ms-flex:0 0 auto;flex:0 0 auto;width:8.3333333333%}.sd-col-md-2{-ms-flex:0 0 auto;flex:0 0 auto;width:16.6666666667%}.sd-col-md-3{-ms-flex:0 0 auto;flex:0 0 auto;width:25%}.sd-col-md-4{-ms-flex:0 0 auto;flex:0 0 auto;width:33.3333333333%}.sd-col-md-5{-ms-flex:0 0 auto;flex:0 0 auto;width:41.6666666667%}.sd-col-md-6{-ms-flex:0 0 auto;flex:0 0 auto;width:50%}.sd-col-md-7{-ms-flex:0 0 auto;flex:0 0 auto;width:58.3333333333%}.sd-col-md-8{-ms-flex:0 0 auto;flex:0 0 auto;width:66.6666666667%}.sd-col-md-9{-ms-flex:0 0 auto;flex:0 0 auto;width:75%}.sd-col-md-10{-ms-flex:0 0 auto;flex:0 0 auto;width:83.3333333333%}.sd-col-md-11{-ms-flex:0 0 auto;flex:0 0 auto;width:91.6666666667%}.sd-col-md-12{-ms-flex:0 0 auto;flex:0 0 auto;width:100%}.sd-g-md-0,.sd-gy-md-0{--sd-gutter-y: 0}.sd-g-md-0,.sd-gx-md-0{--sd-gutter-x: 0}.sd-g-md-1,.sd-gy-md-1{--sd-gutter-y: 0.25rem}.sd-g-md-1,.sd-gx-md-1{--sd-gutter-x: 0.25rem}.sd-g-md-2,.sd-gy-md-2{--sd-gutter-y: 0.5rem}.sd-g-md-2,.sd-gx-md-2{--sd-gutter-x: 0.5rem}.sd-g-md-3,.sd-gy-md-3{--sd-gutter-y: 1rem}.sd-g-md-3,.sd-gx-md-3{--sd-gutter-x: 1rem}.sd-g-md-4,.sd-gy-md-4{--sd-gutter-y: 1.5rem}.sd-g-md-4,.sd-gx-md-4{--sd-gutter-x: 1.5rem}.sd-g-md-5,.sd-gy-md-5{--sd-gutter-y: 3rem}.sd-g-md-5,.sd-gx-md-5{--sd-gutter-x: 3rem}}@media(min-width: 992px){.sd-col-lg-auto{-ms-flex:0 0 auto;flex:0 0 auto;width:auto}.sd-col-lg-1{-ms-flex:0 0 auto;flex:0 0 auto;width:8.3333333333%}.sd-col-lg-2{-ms-flex:0 0 auto;flex:0 0 auto;width:16.6666666667%}.sd-col-lg-3{-ms-flex:0 0 auto;flex:0 0 auto;width:25%}.sd-col-lg-4{-ms-flex:0 0 auto;flex:0 0 auto;width:33.3333333333%}.sd-col-lg-5{-ms-flex:0 0 auto;flex:0 0 auto;width:41.6666666667%}.sd-col-lg-6{-ms-flex:0 0 auto;flex:0 0 auto;width:50%}.sd-col-lg-7{-ms-flex:0 0 auto;flex:0 0 auto;width:58.3333333333%}.sd-col-lg-8{-ms-flex:0 0 auto;flex:0 0 auto;width:66.6666666667%}.sd-col-lg-9{-ms-flex:0 0 auto;flex:0 0 auto;width:75%}.sd-col-lg-10{-ms-flex:0 0 auto;flex:0 0 auto;width:83.3333333333%}.sd-col-lg-11{-ms-flex:0 0 auto;flex:0 0 auto;width:91.6666666667%}.sd-col-lg-12{-ms-flex:0 0 auto;flex:0 0 auto;width:100%}.sd-g-lg-0,.sd-gy-lg-0{--sd-gutter-y: 0}.sd-g-lg-0,.sd-gx-lg-0{--sd-gutter-x: 0}.sd-g-lg-1,.sd-gy-lg-1{--sd-gutter-y: 0.25rem}.sd-g-lg-1,.sd-gx-lg-1{--sd-gutter-x: 0.25rem}.sd-g-lg-2,.sd-gy-lg-2{--sd-gutter-y: 0.5rem}.sd-g-lg-2,.sd-gx-lg-2{--sd-gutter-x: 0.5rem}.sd-g-lg-3,.sd-gy-lg-3{--sd-gutter-y: 1rem}.sd-g-lg-3,.sd-gx-lg-3{--sd-gutter-x: 1rem}.sd-g-lg-4,.sd-gy-lg-4{--sd-gutter-y: 1.5rem}.sd-g-lg-4,.sd-gx-lg-4{--sd-gutter-x: 1.5rem}.sd-g-lg-5,.sd-gy-lg-5{--sd-gutter-y: 3rem}.sd-g-lg-5,.sd-gx-lg-5{--sd-gutter-x: 3rem}}@media(min-width: 1200px){.sd-col-xl-auto{-ms-flex:0 0 auto;flex:0 0 auto;width:auto}.sd-col-xl-1{-ms-flex:0 0 auto;flex:0 0 auto;width:8.3333333333%}.sd-col-xl-2{-ms-flex:0 0 auto;flex:0 0 auto;width:16.6666666667%}.sd-col-xl-3{-ms-flex:0 0 auto;flex:0 0 auto;width:25%}.sd-col-xl-4{-ms-flex:0 0 auto;flex:0 0 auto;width:33.3333333333%}.sd-col-xl-5{-ms-flex:0 0 auto;flex:0 0 auto;width:41.6666666667%}.sd-col-xl-6{-ms-flex:0 0 auto;flex:0 0 auto;width:50%}.sd-col-xl-7{-ms-flex:0 0 auto;flex:0 0 auto;width:58.3333333333%}.sd-col-xl-8{-ms-flex:0 0 auto;flex:0 0 auto;width:66.6666666667%}.sd-col-xl-9{-ms-flex:0 0 auto;flex:0 0 auto;width:75%}.sd-col-xl-10{-ms-flex:0 0 auto;flex:0 0 auto;width:83.3333333333%}.sd-col-xl-11{-ms-flex:0 0 auto;flex:0 0 auto;width:91.6666666667%}.sd-col-xl-12{-ms-flex:0 0 auto;flex:0 0 auto;width:100%}.sd-g-xl-0,.sd-gy-xl-0{--sd-gutter-y: 0}.sd-g-xl-0,.sd-gx-xl-0{--sd-gutter-x: 0}.sd-g-xl-1,.sd-gy-xl-1{--sd-gutter-y: 0.25rem}.sd-g-xl-1,.sd-gx-xl-1{--sd-gutter-x: 0.25rem}.sd-g-xl-2,.sd-gy-xl-2{--sd-gutter-y: 0.5rem}.sd-g-xl-2,.sd-gx-xl-2{--sd-gutter-x: 0.5rem}.sd-g-xl-3,.sd-gy-xl-3{--sd-gutter-y: 1rem}.sd-g-xl-3,.sd-gx-xl-3{--sd-gutter-x: 1rem}.sd-g-xl-4,.sd-gy-xl-4{--sd-gutter-y: 1.5rem}.sd-g-xl-4,.sd-gx-xl-4{--sd-gutter-x: 1.5rem}.sd-g-xl-5,.sd-gy-xl-5{--sd-gutter-y: 3rem}.sd-g-xl-5,.sd-gx-xl-5{--sd-gutter-x: 3rem}}.sd-flex-row-reverse{flex-direction:row-reverse !important}details.sd-dropdown{position:relative}details.sd-dropdown .sd-summary-title{font-weight:700;padding-right:3em !important;-moz-user-select:none;-ms-user-select:none;-webkit-user-select:none;user-select:none}details.sd-dropdown:hover{cursor:pointer}details.sd-dropdown .sd-summary-content{cursor:default}details.sd-dropdown summary{list-style:none;padding:1em}details.sd-dropdown summary .sd-octicon.no-title{vertical-align:middle}details.sd-dropdown[open] summary .sd-octicon.no-title{visibility:hidden}details.sd-dropdown summary::-webkit-details-marker{display:none}details.sd-dropdown summary:focus{outline:none}details.sd-dropdown .sd-summary-icon{margin-right:.5em}details.sd-dropdown .sd-summary-icon svg{opacity:.8}details.sd-dropdown summary:hover .sd-summary-up svg,details.sd-dropdown summary:hover .sd-summary-down svg{opacity:1;transform:scale(1.1)}details.sd-dropdown .sd-summary-up svg,details.sd-dropdown .sd-summary-down svg{display:block;opacity:.6}details.sd-dropdown .sd-summary-up,details.sd-dropdown .sd-summary-down{pointer-events:none;position:absolute;right:1em;top:1em}details.sd-dropdown[open]>.sd-summary-title .sd-summary-down{visibility:hidden}details.sd-dropdown:not([open])>.sd-summary-title .sd-summary-up{visibility:hidden}details.sd-dropdown:not([open]).sd-card{border:none}details.sd-dropdown:not([open])>.sd-card-header{border:1px solid var(--sd-color-card-border);border-radius:.25rem}details.sd-dropdown.sd-fade-in[open] summary~*{-moz-animation:sd-fade-in .5s ease-in-out;-webkit-animation:sd-fade-in .5s ease-in-out;animation:sd-fade-in .5s ease-in-out}details.sd-dropdown.sd-fade-in-slide-down[open] summary~*{-moz-animation:sd-fade-in .5s ease-in-out,sd-slide-down .5s ease-in-out;-webkit-animation:sd-fade-in .5s ease-in-out,sd-slide-down .5s ease-in-out;animation:sd-fade-in .5s ease-in-out,sd-slide-down .5s ease-in-out}.sd-col>.sd-dropdown{width:100%}.sd-summary-content>.sd-tab-set:first-child{margin-top:0}@keyframes sd-fade-in{0%{opacity:0}100%{opacity:1}}@keyframes sd-slide-down{0%{transform:translate(0, -10px)}100%{transform:translate(0, 0)}}.sd-tab-set{border-radius:.125rem;display:flex;flex-wrap:wrap;margin:1em 0;position:relative}.sd-tab-set>input{opacity:0;position:absolute}.sd-tab-set>input:checked+label{border-color:var(--sd-color-tabs-underline-active);color:var(--sd-color-tabs-label-active)}.sd-tab-set>input:checked+label+.sd-tab-content{display:block}.sd-tab-set>input:not(:checked)+label:hover{color:var(--sd-color-tabs-label-hover);border-color:var(--sd-color-tabs-underline-hover)}.sd-tab-set>input:focus+label{outline-style:auto}.sd-tab-set>input:not(.focus-visible)+label{outline:none;-webkit-tap-highlight-color:transparent}.sd-tab-set>label{border-bottom:.125rem solid transparent;margin-bottom:0;color:var(--sd-color-tabs-label-inactive);border-color:var(--sd-color-tabs-underline-inactive);cursor:pointer;font-size:var(--sd-fontsize-tabs-label);font-weight:700;padding:1em 1.25em .5em;transition:color 250ms;width:auto;z-index:1}html .sd-tab-set>label:hover{color:var(--sd-color-tabs-label-active)}.sd-col>.sd-tab-set{width:100%}.sd-tab-content{box-shadow:0 -0.0625rem var(--sd-color-tabs-overline),0 .0625rem var(--sd-color-tabs-underline);display:none;order:99;padding-bottom:.75rem;padding-top:.75rem;width:100%}.sd-tab-content>:first-child{margin-top:0 !important}.sd-tab-content>:last-child{margin-bottom:0 !important}.sd-tab-content>.sd-tab-set{margin:0}.sd-sphinx-override,.sd-sphinx-override *{-moz-box-sizing:border-box;-webkit-box-sizing:border-box;box-sizing:border-box}.sd-sphinx-override p{margin-top:0}:root{--sd-color-primary: #007bff;--sd-color-secondary: #6c757d;--sd-color-success: #28a745;--sd-color-info: #17a2b8;--sd-color-warning: #f0b37e;--sd-color-danger: #dc3545;--sd-color-light: #f8f9fa;--sd-color-muted: #6c757d;--sd-color-dark: #212529;--sd-color-black: black;--sd-color-white: white;--sd-color-primary-highlight: #0069d9;--sd-color-secondary-highlight: #5c636a;--sd-color-success-highlight: #228e3b;--sd-color-info-highlight: #148a9c;--sd-color-warning-highlight: #cc986b;--sd-color-danger-highlight: #bb2d3b;--sd-color-light-highlight: #d3d4d5;--sd-color-muted-highlight: #5c636a;--sd-color-dark-highlight: #1c1f23;--sd-color-black-highlight: black;--sd-color-white-highlight: #d9d9d9;--sd-color-primary-text: #fff;--sd-color-secondary-text: #fff;--sd-color-success-text: #fff;--sd-color-info-text: #fff;--sd-color-warning-text: #212529;--sd-color-danger-text: #fff;--sd-color-light-text: #212529;--sd-color-muted-text: #fff;--sd-color-dark-text: #fff;--sd-color-black-text: #fff;--sd-color-white-text: #212529;--sd-color-shadow: rgba(0, 0, 0, 0.15);--sd-color-card-border: rgba(0, 0, 0, 0.125);--sd-color-card-border-hover: hsla(231, 99%, 66%, 1);--sd-color-card-background: transparent;--sd-color-card-text: inherit;--sd-color-card-header: transparent;--sd-color-card-footer: transparent;--sd-color-tabs-label-active: hsla(231, 99%, 66%, 1);--sd-color-tabs-label-hover: hsla(231, 99%, 66%, 1);--sd-color-tabs-label-inactive: hsl(0, 0%, 66%);--sd-color-tabs-underline-active: hsla(231, 99%, 66%, 1);--sd-color-tabs-underline-hover: rgba(178, 206, 245, 0.62);--sd-color-tabs-underline-inactive: transparent;--sd-color-tabs-overline: rgb(222, 222, 222);--sd-color-tabs-underline: rgb(222, 222, 222);--sd-fontsize-tabs-label: 1rem}
diff --git a/_preview/93/_sphinx_design_static/design-tabs.js b/_preview/93/_sphinx_design_static/design-tabs.js
deleted file mode 100644
index 36b38cf0..00000000
--- a/_preview/93/_sphinx_design_static/design-tabs.js
+++ /dev/null
@@ -1,27 +0,0 @@
-var sd_labels_by_text = {};
-
-function ready() {
- const li = document.getElementsByClassName("sd-tab-label");
- for (const label of li) {
- syncId = label.getAttribute("data-sync-id");
- if (syncId) {
- label.onclick = onLabelClick;
- if (!sd_labels_by_text[syncId]) {
- sd_labels_by_text[syncId] = [];
- }
- sd_labels_by_text[syncId].push(label);
- }
- }
-}
-
-function onLabelClick() {
- // Activate other inputs with the same sync id.
- syncId = this.getAttribute("data-sync-id");
- for (label of sd_labels_by_text[syncId]) {
- if (label === this) continue;
- label.previousElementSibling.checked = true;
- }
- window.localStorage.setItem("sphinx-design-last-tab", syncId);
-}
-
-document.addEventListener("DOMContentLoaded", ready, false);
diff --git a/_preview/93/_static/__init__.py b/_preview/93/_static/__init__.py
deleted file mode 100644
index e69de29b..00000000
diff --git a/_preview/93/_static/__pycache__/__init__.cpython-39.pyc b/_preview/93/_static/__pycache__/__init__.cpython-39.pyc
deleted file mode 100644
index 2a38c054..00000000
Binary files a/_preview/93/_static/__pycache__/__init__.cpython-39.pyc and /dev/null differ
diff --git a/_preview/93/_static/basic.css b/_preview/93/_static/basic.css
deleted file mode 100644
index d54be806..00000000
--- a/_preview/93/_static/basic.css
+++ /dev/null
@@ -1,906 +0,0 @@
-/*
- * basic.css
- * ~~~~~~~~~
- *
- * Sphinx stylesheet -- basic theme.
- *
- * :copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
- * :license: BSD, see LICENSE for details.
- *
- */
-
-/* -- main layout ----------------------------------------------------------- */
-
-div.clearer {
- clear: both;
-}
-
-div.section::after {
- display: block;
- content: '';
- clear: left;
-}
-
-/* -- relbar ---------------------------------------------------------------- */
-
-div.related {
- width: 100%;
- font-size: 90%;
-}
-
-div.related h3 {
- display: none;
-}
-
-div.related ul {
- margin: 0;
- padding: 0 0 0 10px;
- list-style: none;
-}
-
-div.related li {
- display: inline;
-}
-
-div.related li.right {
- float: right;
- margin-right: 5px;
-}
-
-/* -- sidebar --------------------------------------------------------------- */
-
-div.sphinxsidebarwrapper {
- padding: 10px 5px 0 10px;
-}
-
-div.sphinxsidebar {
- float: left;
- width: 270px;
- margin-left: -100%;
- font-size: 90%;
- word-wrap: break-word;
- overflow-wrap : break-word;
-}
-
-div.sphinxsidebar ul {
- list-style: none;
-}
-
-div.sphinxsidebar ul ul,
-div.sphinxsidebar ul.want-points {
- margin-left: 20px;
- list-style: square;
-}
-
-div.sphinxsidebar ul ul {
- margin-top: 0;
- margin-bottom: 0;
-}
-
-div.sphinxsidebar form {
- margin-top: 10px;
-}
-
-div.sphinxsidebar input {
- border: 1px solid #98dbcc;
- font-family: sans-serif;
- font-size: 1em;
-}
-
-div.sphinxsidebar #searchbox form.search {
- overflow: hidden;
-}
-
-div.sphinxsidebar #searchbox input[type="text"] {
- float: left;
- width: 80%;
- padding: 0.25em;
- box-sizing: border-box;
-}
-
-div.sphinxsidebar #searchbox input[type="submit"] {
- float: left;
- width: 20%;
- border-left: none;
- padding: 0.25em;
- box-sizing: border-box;
-}
-
-
-img {
- border: 0;
- max-width: 100%;
-}
-
-/* -- search page ----------------------------------------------------------- */
-
-ul.search {
- margin: 10px 0 0 20px;
- padding: 0;
-}
-
-ul.search li {
- padding: 5px 0 5px 20px;
- background-image: url(file.png);
- background-repeat: no-repeat;
- background-position: 0 7px;
-}
-
-ul.search li a {
- font-weight: bold;
-}
-
-ul.search li p.context {
- color: #888;
- margin: 2px 0 0 30px;
- text-align: left;
-}
-
-ul.keywordmatches li.goodmatch a {
- font-weight: bold;
-}
-
-/* -- index page ------------------------------------------------------------ */
-
-table.contentstable {
- width: 90%;
- margin-left: auto;
- margin-right: auto;
-}
-
-table.contentstable p.biglink {
- line-height: 150%;
-}
-
-a.biglink {
- font-size: 1.3em;
-}
-
-span.linkdescr {
- font-style: italic;
- padding-top: 5px;
- font-size: 90%;
-}
-
-/* -- general index --------------------------------------------------------- */
-
-table.indextable {
- width: 100%;
-}
-
-table.indextable td {
- text-align: left;
- vertical-align: top;
-}
-
-table.indextable ul {
- margin-top: 0;
- margin-bottom: 0;
- list-style-type: none;
-}
-
-table.indextable > tbody > tr > td > ul {
- padding-left: 0em;
-}
-
-table.indextable tr.pcap {
- height: 10px;
-}
-
-table.indextable tr.cap {
- margin-top: 10px;
- background-color: #f2f2f2;
-}
-
-img.toggler {
- margin-right: 3px;
- margin-top: 3px;
- cursor: pointer;
-}
-
-div.modindex-jumpbox {
- border-top: 1px solid #ddd;
- border-bottom: 1px solid #ddd;
- margin: 1em 0 1em 0;
- padding: 0.4em;
-}
-
-div.genindex-jumpbox {
- border-top: 1px solid #ddd;
- border-bottom: 1px solid #ddd;
- margin: 1em 0 1em 0;
- padding: 0.4em;
-}
-
-/* -- domain module index --------------------------------------------------- */
-
-table.modindextable td {
- padding: 2px;
- border-collapse: collapse;
-}
-
-/* -- general body styles --------------------------------------------------- */
-
-div.body {
- min-width: 450px;
- max-width: 800px;
-}
-
-div.body p, div.body dd, div.body li, div.body blockquote {
- -moz-hyphens: auto;
- -ms-hyphens: auto;
- -webkit-hyphens: auto;
- hyphens: auto;
-}
-
-a.headerlink {
- visibility: hidden;
-}
-
-a.brackets:before,
-span.brackets > a:before{
- content: "[";
-}
-
-a.brackets:after,
-span.brackets > a:after {
- content: "]";
-}
-
-h1:hover > a.headerlink,
-h2:hover > a.headerlink,
-h3:hover > a.headerlink,
-h4:hover > a.headerlink,
-h5:hover > a.headerlink,
-h6:hover > a.headerlink,
-dt:hover > a.headerlink,
-caption:hover > a.headerlink,
-p.caption:hover > a.headerlink,
-div.code-block-caption:hover > a.headerlink {
- visibility: visible;
-}
-
-div.body p.caption {
- text-align: inherit;
-}
-
-div.body td {
- text-align: left;
-}
-
-.first {
- margin-top: 0 !important;
-}
-
-p.rubric {
- margin-top: 30px;
- font-weight: bold;
-}
-
-img.align-left, figure.align-left, .figure.align-left, object.align-left {
- clear: left;
- float: left;
- margin-right: 1em;
-}
-
-img.align-right, figure.align-right, .figure.align-right, object.align-right {
- clear: right;
- float: right;
- margin-left: 1em;
-}
-
-img.align-center, figure.align-center, .figure.align-center, object.align-center {
- display: block;
- margin-left: auto;
- margin-right: auto;
-}
-
-img.align-default, figure.align-default, .figure.align-default {
- display: block;
- margin-left: auto;
- margin-right: auto;
-}
-
-.align-left {
- text-align: left;
-}
-
-.align-center {
- text-align: center;
-}
-
-.align-default {
- text-align: center;
-}
-
-.align-right {
- text-align: right;
-}
-
-/* -- sidebars -------------------------------------------------------------- */
-
-div.sidebar,
-aside.sidebar {
- margin: 0 0 0.5em 1em;
- border: 1px solid #ddb;
- padding: 7px;
- background-color: #ffe;
- width: 40%;
- float: right;
- clear: right;
- overflow-x: auto;
-}
-
-p.sidebar-title {
- font-weight: bold;
-}
-
-div.admonition, div.topic, blockquote {
- clear: left;
-}
-
-/* -- topics ---------------------------------------------------------------- */
-
-div.topic {
- border: 1px solid #ccc;
- padding: 7px;
- margin: 10px 0 10px 0;
-}
-
-p.topic-title {
- font-size: 1.1em;
- font-weight: bold;
- margin-top: 10px;
-}
-
-/* -- admonitions ----------------------------------------------------------- */
-
-div.admonition {
- margin-top: 10px;
- margin-bottom: 10px;
- padding: 7px;
-}
-
-div.admonition dt {
- font-weight: bold;
-}
-
-p.admonition-title {
- margin: 0px 10px 5px 0px;
- font-weight: bold;
-}
-
-div.body p.centered {
- text-align: center;
- margin-top: 25px;
-}
-
-/* -- content of sidebars/topics/admonitions -------------------------------- */
-
-div.sidebar > :last-child,
-aside.sidebar > :last-child,
-div.topic > :last-child,
-div.admonition > :last-child {
- margin-bottom: 0;
-}
-
-div.sidebar::after,
-aside.sidebar::after,
-div.topic::after,
-div.admonition::after,
-blockquote::after {
- display: block;
- content: '';
- clear: both;
-}
-
-/* -- tables ---------------------------------------------------------------- */
-
-table.docutils {
- margin-top: 10px;
- margin-bottom: 10px;
- border: 0;
- border-collapse: collapse;
-}
-
-table.align-center {
- margin-left: auto;
- margin-right: auto;
-}
-
-table.align-default {
- margin-left: auto;
- margin-right: auto;
-}
-
-table caption span.caption-number {
- font-style: italic;
-}
-
-table caption span.caption-text {
-}
-
-table.docutils td, table.docutils th {
- padding: 1px 8px 1px 5px;
- border-top: 0;
- border-left: 0;
- border-right: 0;
- border-bottom: 1px solid #aaa;
-}
-
-table.footnote td, table.footnote th {
- border: 0 !important;
-}
-
-th {
- text-align: left;
- padding-right: 5px;
-}
-
-table.citation {
- border-left: solid 1px gray;
- margin-left: 1px;
-}
-
-table.citation td {
- border-bottom: none;
-}
-
-th > :first-child,
-td > :first-child {
- margin-top: 0px;
-}
-
-th > :last-child,
-td > :last-child {
- margin-bottom: 0px;
-}
-
-/* -- figures --------------------------------------------------------------- */
-
-div.figure, figure {
- margin: 0.5em;
- padding: 0.5em;
-}
-
-div.figure p.caption, figcaption {
- padding: 0.3em;
-}
-
-div.figure p.caption span.caption-number,
-figcaption span.caption-number {
- font-style: italic;
-}
-
-div.figure p.caption span.caption-text,
-figcaption span.caption-text {
-}
-
-/* -- field list styles ----------------------------------------------------- */
-
-table.field-list td, table.field-list th {
- border: 0 !important;
-}
-
-.field-list ul {
- margin: 0;
- padding-left: 1em;
-}
-
-.field-list p {
- margin: 0;
-}
-
-.field-name {
- -moz-hyphens: manual;
- -ms-hyphens: manual;
- -webkit-hyphens: manual;
- hyphens: manual;
-}
-
-/* -- hlist styles ---------------------------------------------------------- */
-
-table.hlist {
- margin: 1em 0;
-}
-
-table.hlist td {
- vertical-align: top;
-}
-
-/* -- object description styles --------------------------------------------- */
-
-.sig {
- font-family: 'Consolas', 'Menlo', 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', monospace;
-}
-
-.sig-name, code.descname {
- background-color: transparent;
- font-weight: bold;
-}
-
-.sig-name {
- font-size: 1.1em;
-}
-
-code.descname {
- font-size: 1.2em;
-}
-
-.sig-prename, code.descclassname {
- background-color: transparent;
-}
-
-.optional {
- font-size: 1.3em;
-}
-
-.sig-paren {
- font-size: larger;
-}
-
-.sig-param.n {
- font-style: italic;
-}
-
-/* C++ specific styling */
-
-.sig-inline.c-texpr,
-.sig-inline.cpp-texpr {
- font-family: unset;
-}
-
-.sig.c .k, .sig.c .kt,
-.sig.cpp .k, .sig.cpp .kt {
- color: #0033B3;
-}
-
-.sig.c .m,
-.sig.cpp .m {
- color: #1750EB;
-}
-
-.sig.c .s, .sig.c .sc,
-.sig.cpp .s, .sig.cpp .sc {
- color: #067D17;
-}
-
-
-/* -- other body styles ----------------------------------------------------- */
-
-ol.arabic {
- list-style: decimal;
-}
-
-ol.loweralpha {
- list-style: lower-alpha;
-}
-
-ol.upperalpha {
- list-style: upper-alpha;
-}
-
-ol.lowerroman {
- list-style: lower-roman;
-}
-
-ol.upperroman {
- list-style: upper-roman;
-}
-
-:not(li) > ol > li:first-child > :first-child,
-:not(li) > ul > li:first-child > :first-child {
- margin-top: 0px;
-}
-
-:not(li) > ol > li:last-child > :last-child,
-:not(li) > ul > li:last-child > :last-child {
- margin-bottom: 0px;
-}
-
-ol.simple ol p,
-ol.simple ul p,
-ul.simple ol p,
-ul.simple ul p {
- margin-top: 0;
-}
-
-ol.simple > li:not(:first-child) > p,
-ul.simple > li:not(:first-child) > p {
- margin-top: 0;
-}
-
-ol.simple p,
-ul.simple p {
- margin-bottom: 0;
-}
-
-dl.footnote > dt,
-dl.citation > dt {
- float: left;
- margin-right: 0.5em;
-}
-
-dl.footnote > dd,
-dl.citation > dd {
- margin-bottom: 0em;
-}
-
-dl.footnote > dd:after,
-dl.citation > dd:after {
- content: "";
- clear: both;
-}
-
-dl.field-list {
- display: grid;
- grid-template-columns: fit-content(30%) auto;
-}
-
-dl.field-list > dt {
- font-weight: bold;
- word-break: break-word;
- padding-left: 0.5em;
- padding-right: 5px;
-}
-
-dl.field-list > dt:after {
- content: ":";
-}
-
-dl.field-list > dd {
- padding-left: 0.5em;
- margin-top: 0em;
- margin-left: 0em;
- margin-bottom: 0em;
-}
-
-dl {
- margin-bottom: 15px;
-}
-
-dd > :first-child {
- margin-top: 0px;
-}
-
-dd ul, dd table {
- margin-bottom: 10px;
-}
-
-dd {
- margin-top: 3px;
- margin-bottom: 10px;
- margin-left: 30px;
-}
-
-dl > dd:last-child,
-dl > dd:last-child > :last-child {
- margin-bottom: 0;
-}
-
-dt:target, span.highlighted {
- background-color: #fbe54e;
-}
-
-rect.highlighted {
- fill: #fbe54e;
-}
-
-dl.glossary dt {
- font-weight: bold;
- font-size: 1.1em;
-}
-
-.versionmodified {
- font-style: italic;
-}
-
-.system-message {
- background-color: #fda;
- padding: 5px;
- border: 3px solid red;
-}
-
-.footnote:target {
- background-color: #ffa;
-}
-
-.line-block {
- display: block;
- margin-top: 1em;
- margin-bottom: 1em;
-}
-
-.line-block .line-block {
- margin-top: 0;
- margin-bottom: 0;
- margin-left: 1.5em;
-}
-
-.guilabel, .menuselection {
- font-family: sans-serif;
-}
-
-.accelerator {
- text-decoration: underline;
-}
-
-.classifier {
- font-style: oblique;
-}
-
-.classifier:before {
- font-style: normal;
- margin: 0 0.5em;
- content: ":";
- display: inline-block;
-}
-
-abbr, acronym {
- border-bottom: dotted 1px;
- cursor: help;
-}
-
-/* -- code displays --------------------------------------------------------- */
-
-pre {
- overflow: auto;
- overflow-y: hidden; /* fixes display issues on Chrome browsers */
-}
-
-pre, div[class*="highlight-"] {
- clear: both;
-}
-
-span.pre {
- -moz-hyphens: none;
- -ms-hyphens: none;
- -webkit-hyphens: none;
- hyphens: none;
- white-space: nowrap;
-}
-
-div[class*="highlight-"] {
- margin: 1em 0;
-}
-
-td.linenos pre {
- border: 0;
- background-color: transparent;
- color: #aaa;
-}
-
-table.highlighttable {
- display: block;
-}
-
-table.highlighttable tbody {
- display: block;
-}
-
-table.highlighttable tr {
- display: flex;
-}
-
-table.highlighttable td {
- margin: 0;
- padding: 0;
-}
-
-table.highlighttable td.linenos {
- padding-right: 0.5em;
-}
-
-table.highlighttable td.code {
- flex: 1;
- overflow: hidden;
-}
-
-.highlight .hll {
- display: block;
-}
-
-div.highlight pre,
-table.highlighttable pre {
- margin: 0;
-}
-
-div.code-block-caption + div {
- margin-top: 0;
-}
-
-div.code-block-caption {
- margin-top: 1em;
- padding: 2px 5px;
- font-size: small;
-}
-
-div.code-block-caption code {
- background-color: transparent;
-}
-
-table.highlighttable td.linenos,
-span.linenos,
-div.highlight span.gp { /* gp: Generic.Prompt */
- user-select: none;
- -webkit-user-select: text; /* Safari fallback only */
- -webkit-user-select: none; /* Chrome/Safari */
- -moz-user-select: none; /* Firefox */
- -ms-user-select: none; /* IE10+ */
-}
-
-div.code-block-caption span.caption-number {
- padding: 0.1em 0.3em;
- font-style: italic;
-}
-
-div.code-block-caption span.caption-text {
-}
-
-div.literal-block-wrapper {
- margin: 1em 0;
-}
-
-code.xref, a code {
- background-color: transparent;
- font-weight: bold;
-}
-
-h1 code, h2 code, h3 code, h4 code, h5 code, h6 code {
- background-color: transparent;
-}
-
-.viewcode-link {
- float: right;
-}
-
-.viewcode-back {
- float: right;
- font-family: sans-serif;
-}
-
-div.viewcode-block:target {
- margin: -1px -10px;
- padding: 0 10px;
-}
-
-/* -- math display ---------------------------------------------------------- */
-
-img.math {
- vertical-align: middle;
-}
-
-div.body div.math p {
- text-align: center;
-}
-
-span.eqno {
- float: right;
-}
-
-span.eqno a.headerlink {
- position: absolute;
- z-index: 1;
-}
-
-div.math:hover a.headerlink {
- visibility: visible;
-}
-
-/* -- printout stylesheet --------------------------------------------------- */
-
-@media print {
- div.document,
- div.documentwrapper,
- div.bodywrapper {
- margin: 0 !important;
- width: 100%;
- }
-
- div.sphinxsidebar,
- div.related,
- div.footer,
- #top-link {
- display: none;
- }
-}
\ No newline at end of file
diff --git a/_preview/93/_static/check-solid.svg b/_preview/93/_static/check-solid.svg
deleted file mode 100644
index 92fad4b5..00000000
--- a/_preview/93/_static/check-solid.svg
+++ /dev/null
@@ -1,4 +0,0 @@
-
diff --git a/_preview/93/_static/clipboard.min.js b/_preview/93/_static/clipboard.min.js
deleted file mode 100644
index 54b3c463..00000000
--- a/_preview/93/_static/clipboard.min.js
+++ /dev/null
@@ -1,7 +0,0 @@
-/*!
- * clipboard.js v2.0.8
- * https://clipboardjs.com/
- *
- * Licensed MIT © Zeno Rocha
- */
-!function(t,e){"object"==typeof exports&&"object"==typeof module?module.exports=e():"function"==typeof define&&define.amd?define([],e):"object"==typeof exports?exports.ClipboardJS=e():t.ClipboardJS=e()}(this,function(){return n={686:function(t,e,n){"use strict";n.d(e,{default:function(){return o}});var e=n(279),i=n.n(e),e=n(370),u=n.n(e),e=n(817),c=n.n(e);function a(t){try{return document.execCommand(t)}catch(t){return}}var f=function(t){t=c()(t);return a("cut"),t};var l=function(t){var e,n,o,r=1