python-awips/examples/notebooks/GOES_Geostationary_Lightning_Mapper.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "The Geostationary Lightning Mapper, or GLM, on board GOES-R Series spacecraft, is the first operational lightning mapper flown in geostationary orbit. GLM detects the light emitted by lightning at the tops of clouds day and night and collects information such as the frequency, location and extent of lightning discharges. The instrument measures total lightning, both in-cloud and cloud-to-ground, to aid in forecasting developing severe storms and a wide range of high-impact environmental phenomena including hailstorms, microburst winds, tornadoes, hurricanes, flash floods, snowstorms and fires.\n",
    "\n",
    "AWIPS GLM point data are available in three formats\n",
    "\n",
    "* `GLMev` Events\n",
    "* `GLMfl` Flashes\n",
    "* `GLMgr` Groups\n",
    "\n",
    "and with seven attributes:\n",
    "\n",
    "* height\n",
    "* intensity\n",
    "* msgType\n",
    "* pulseCount\n",
    "* pulseIndex\n",
    "* sensorCount\n",
    "* strikeType\n",
    "\n",
    "\n",
    "## GLM Sources and Parameters"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "available sources:\n",
      "['GLMgr', 'GLMfl', 'GLMev']\n",
      "\n",
      "available parameters:\n",
      "['height', 'intensity', 'msgType', 'pulseCount', 'pulseIndex', 'sensorCount', 'strikeType']\n"
     ]
    }
   ],
   "source": [
    "from awips.dataaccess import DataAccessLayer\n",
    "import cartopy.crs as ccrs\n",
    "import cartopy.feature as cfeat\n",
    "import matplotlib.pyplot as plt\n",
    "from cartopy.mpl.gridliner import LONGITUDE_FORMATTER, LATITUDE_FORMATTER\n",
    "import numpy as np\n",
    "import datetime\n",
    "\n",
    "%matplotlib inline\n",
    "\n",
    "# Create an EDEX data request\n",
    "edexServer = \"edex-cloud.unidata.ucar.edu\"\n",
    "datatype = \"binlightning\"\n",
    "DataAccessLayer.changeEDEXHost(edexServer)\n",
    "request = DataAccessLayer.newDataRequest(datatype)\n",
    "\n",
    "# Show available sources\n",
    "sources = DataAccessLayer.getIdentifierValues(request, \"source\")\n",
    "print(\"available sources:\")\n",
    "print(list(sources))\n",
    "print(\"\")\n",
    "availableParms = DataAccessLayer.getAvailableParameters(request)\n",
    "availableParms.sort()\n",
    "print(\"available parameters:\")\n",
    "print(list(availableParms))"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 7,
   "metadata": {},
   "outputs": [],
   "source": [
    "request.addIdentifier(\"source\", \"GLMgr\")\n",
    "request.setParameters(\"intensity\")\n",
    "times = DataAccessLayer.getAvailableTimes(request)\n",
    "response = DataAccessLayer.getGeometryData(request, [times[-1]])\n",
    "glm_points = []\n",
    "for data in response:\n",
    "       glm_points.append(data.getGeometry())\n",
    "ob = response[0]"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 13,
   "metadata": {
    "scrolled": true
   },
   "outputs": [
    {
     "data": {
      "text/plain": [
       "Text(0.5,1,'Oct 15 18 22:15:07 GMT | GLMgr | edex-cloud.unidata.ucar.edu')"
      ]
     },
     "execution_count": 13,
     "metadata": {},
     "output_type": "execute_result"
    },
    {
     "data": {
      "image/png": "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
      "text/plain": [
       "<Figure size 1152x1152 with 1 Axes>"
      ]
     },
     "metadata": {
      "needs_background": "light"
     },
     "output_type": "display_data"
    }
   ],
   "source": [
    "# Plot markers\n",
    "fig, ax = plt.subplots(figsize=(16,16),subplot_kw=dict(projection=ccrs.Orthographic(central_longitude=-90.0)))\n",
    "ax.coastlines(resolution='50m')\n",
    "ax.gridlines()\n",
    "ax.scatter([point.x for point in glm_points],\n",
    "       [point.y for point in glm_points],\n",
    "       transform=ccrs.PlateCarree(),marker=\"+\",facecolor='red')\n",
    "ax.set_title(str(response[-1].getDataTime().getRefTime()) + \" | \" + ob.getAttribute('source') + \" | \" + edexServer)\n"
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python 3",
   "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.6.6"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 1
}