{ "cells": [ { "cell_type": "markdown", "id": "904910c7-c805-4a97-94cb-a5e285026e2d", "metadata": {}, "source": [ "# Solar Position\n", "\n", "This notebook demonstrates several aspects of the solar zenith angles returned from the API:\n", "\n", "1) The solar position algorithm used by the API is equivalent to pvlib's implementation of the SPA to within the precision of the values returned from the API (2 digits after the decimal).\n", "2) The solar zenith angle returned from the API is refraction-corrected.\n", "3) The refraction correction uses time-varying ambient temperature and pressure, not annual averages as prescribed in the original SPA reference.\n", "4) The solar zenith angle returned from the API is calculated for the center of the PSM3 pixel, not the coordinates specified in the API request." ] }, { "cell_type": "code", "execution_count": 1, "id": "b539e7d9-3ce4-4697-a22f-8830ee4974db", "metadata": {}, "outputs": [], "source": [ "import pvlib\n", "import pandas as pd\n", "import numpy as np\n", "import matplotlib.pyplot as plt" ] }, { "cell_type": "code", "execution_count": 2, "id": "03c0628d-794e-4c5d-a099-90eefc3db4a4", "metadata": {}, "outputs": [], "source": [ "# fetch an example PSM3 dataset\n", "lat, lon = 40.005, -80.015 # not at the center/on edge of pixel\n", "df, meta = pvlib.iotools.get_psm3(lat, lon,\n", " api_key='DEMO_KEY', email='assessingsolar@gmail.com',\n", " names=2020, interval=5, map_variables=True, leap_day=True,\n", " attributes=['solar_zenith_angle', 'air_temperature', 'surface_pressure'])\n", "\n", "df['pressure'] = df['pressure'] * 100 # mbar to Pa" ] }, { "cell_type": "markdown", "id": "56208135-e91d-4651-b09c-88f6bf45c901", "metadata": {}, "source": [ "First, let's determine whether the zenith angles are corrected for atmospheric refraction. Refraction correction as modeled in the SPA manifests as a small jump on the order of half a degree when the zenith crosses the horizon. Indeed we observe such a jump in the values returned from the API:" ] }, { "cell_type": "code", "execution_count": 3, "id": "f7ac6675-1574-49a7-84c3-8f554df07282", "metadata": {}, "outputs": [ { "data": { "text/plain": [ "Text(0, 0.5, 'PSM3 Solar Zenith [degrees]')" ] }, "execution_count": 3, "metadata": {}, "output_type": "execute_result" }, { "data": { "image/png": "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\n", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "df.loc['2020-01-01 07:15':'2020-01-01 08:15', 'solar_zenith'].plot()\n", "plt.ylabel('PSM3 Solar Zenith [degrees]')" ] }, { "cell_type": "markdown", "id": "a8c2d751-615a-41df-91a5-79b4db514de5", "metadata": {}, "source": [ "Now, let's show several things at once by reproducing the API's zenith values using pvlib:\n", "- First, that the refraction correction uses time-varying temperature and pressure (as opposed to annual averages as in the original SPA reference).\n", "- Second, that both the underlying geometric solar position and the refraction correction are exactly consistent with pvlib's SPA implementation (with a small exception).\n", "- Third, that the API calculates solar positions for the center of the pixel, _not_ the coordinates specified in the API request.\n", "\n", "Note that, because the API values are rounded to 2 decimal places, we can only expect agreement to $\\pm 0.005°$." ] }, { "cell_type": "code", "execution_count": 4, "id": "9adeb93a-585d-4c34-aeed-2c0a81e4e903", "metadata": {}, "outputs": [], "source": [ "# note: we specify coordinates for the center of pixel here\n", "kwargs = dict(time=df.index, latitude=40.00, longitude=-80.01, altitude=meta['altitude'])\n", "\n", "sp1 = pvlib.solarposition.spa_python(**kwargs, temperature=df['temp_air'].mean(), pressure=df['pressure'].mean())\n", "sp2 = pvlib.solarposition.spa_python(**kwargs, temperature=df['temp_air'], pressure=df['pressure'])" ] }, { "cell_type": "code", "execution_count": 5, "id": "3a70c216-7c6d-421f-8c65-f4bf1d7a41e6", "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "annual average temperature/pressure - 1st and 99th percentiles: [-0.01106459 0.00836248]\n", "time series temperature/pressure - 1st and 99th percentiles: [-0.00489857 0.00491025]\n" ] }, { "data": { "image/png": "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\n", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "for case, sp in [('annual average temperature/pressure', sp1), ('time series temperature/pressure', sp2)]:\n", " aux = pd.DataFrame({'psm3': df['solar_zenith'], 'spa': sp['apparent_zenith']})\n", " aux['diff'] = aux['psm3'] - aux['spa']\n", " aux['diff'].plot(label=case)\n", " print(case, '- 1st and 99th percentiles:', aux['diff'].quantile([0.01, 0.99]).values)\n", "\n", "plt.ylabel('Solar Zenith Difference (PSM3 $-$ SPA) [degrees]')\n", "plt.axhline(+0.005, ls='--', c='k', label='precision bounds')\n", "plt.legend()\n", "plt.axhline(-0.005, ls='--', c='k');" ] }, { "cell_type": "markdown", "id": "c0a5b6d7-15a3-4351-b669-de60cc34bd48", "metadata": {}, "source": [ "Attentive readers may notice that the last few hours of the year have much larger error than the rest. This is due to the \"roll-over\" effect described in [End-of-year “roll-over”](rollover.ipynb). Let's correct for that:" ] }, { "cell_type": "code", "execution_count": 6, "id": "20a78440-1e49-4af3-b7f1-5876878c38f2", "metadata": {}, "outputs": [ { "data": { "text/html": [ "
\n", "\n", "\n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", " \n", "
difference without correcting rolloverdifference corrected for rollover
min-0.105-0.005
max0.0050.005
\n", "
" ], "text/plain": [ " difference without correcting rollover difference corrected for rollover\n", "min -0.105 -0.005\n", "max 0.005 0.005" ] }, "execution_count": 6, "metadata": {}, "output_type": "execute_result" } ], "source": [ "# mimic the PSM3 \"roll-over\" effect\n", "is_rolled = df.index > (df.index[-1] + df.index[-1].utcoffset())\n", "df_shift = df.copy()\n", "df_shift.index = np.where(is_rolled, df_shift.index - pd.DateOffset(years=1), df_shift.index)\n", "\n", "sp3 = pvlib.solarposition.spa_python(df_shift.index, meta['latitude'], meta['longitude'], meta['altitude'],\n", " pressure=df_shift['pressure'], temperature=df_shift['temp_air'])\n", "\n", "# finally, re-roll the index back to PSM3's weird index so we can compare with the API data\n", "sp3.index = df.index\n", "\n", "# Now we see that correcting for the roll-over effect brings the error\n", "# down to the +/- 0.005 degree precision limit for the entire year:\n", "difference = pd.DataFrame({\n", " 'difference without correcting rollover': sp2['apparent_zenith'],\n", " 'difference corrected for rollover': sp3['apparent_zenith'],\n", "}).subtract(df['solar_zenith'], axis=0)\n", "\n", "difference.describe().loc[['min', 'max']].round(3)" ] }, { "cell_type": "markdown", "id": "e79e01ca-7642-482e-a0fc-196a97e08163", "metadata": {}, "source": [ "Finally, let's further demonstrate that the API returns zenith angles for the center of the pixel instead of the specified coordinates. We do this by showing that the error exceeds the $\\pm 0.005°$ threshold when calculating position for the true location instead of the pixel's center. Note also the large excursions beyond the main noise region; these are caused by the discontinuous nature of the SPA's refraction correction combined with disagreement about whether the sun is slightly above or slightly below the horizon." ] }, { "cell_type": "code", "execution_count": 7, "id": "3ca7969a-8395-4f77-a559-7cdf9f1e84f4", "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "1st and 99th percentiles: [-0.01026768 0.01034264]\n" ] }, { "data": { "text/plain": [ "(-0.05, 0.05)" ] }, "execution_count": 7, "metadata": {}, "output_type": "execute_result" }, { "data": { "image/png": "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PT29PDkRERERaS21iyc7Ozvcu3evRPv58+dRp06dciVFREREpK3ULp7GjRuHKVOmICwsDCKRCAkJCdizZw9mzJiBwMBATeZIREREpDXUvlTBzJkzIZFI4Ovri5ycHPj4+MDQ0BAzZszAxIkTNZkjERERkdZQu3gCgG+++QZz587FzZs3IZVK4ebmJnedJyIiIqJ3TbmKJwAwMTGBh4eHJnIhIiIi0noqFU/Tp08vc2zxLVqIiIiI3iUqFU8RERFyj8PDw1FYWAhXV1cAwJ07d6Crq4tWrVppLkMiIiIiLaJS8XTmzBnZ/6tXr4a5uTl+/PFHVK9eHQCQlpaGjz/+GO3bt9dslkRERERaQu1LFaxatQpLly6VFU4AUL16dSxevBirVq3SSHJERERE2kbt4ikjIwNPnz4t0Z6cnIzMzMxyJUVERESkrdQunvr27YuPP/4Y+/fvx5MnT/DkyRPs378fo0ePRr9+/TSZIxEREZHWUPtSBZs3b8aMGTMQEBCA/Pz8os709DB69GisXLlSYwkSERERaRO1iycTExNs3LgRK1euxP379yEIAurVqwdTU1NN5kdERESkVVTabRcVFQWpVCrXZmpqimbNmqF58+YlCqcbN26goKCg/FkSERERaQmViqeWLVsiNTW1zPFeXl54/PixykkRERERaSuVdtsJgoCvvvoKJiYmZYrPy8tTKykiIiIibaVS8eTj44Pbt2+XOd7LywvGxsYqJ0VERESkrVQqns6ePVtBaRARERFVDWpf54mIiIjov4jFExEREZEKWDwRERERqYDFExEREZEKWDwRERERqUDt27MAQH5+PpKSkpCdnQ0rKyvUqFFDU3kRERERaSWVR56ysrKwZcsWdOzYEWKxGM7OznBzc4OVlRWcnJwwduxYXL58uSJyJSIiIqp0KhVPa9asgbOzM7Zt24ZOnTrh4MGDiIyMxO3btxEaGop58+ahoKAAfn5+8Pf3x927dysqbyIiIqJKodJuuwsXLuDMmTNo2rSpwult2rTBqFGjsGnTJuzYsQMhISGoX7++RhIlIiIi0gYqFU+//vprmeKMjIwQGBioVkJERERE2qxCzraLjIysiG6JiIiIKp3GiieJRIKNGzfC3d0drVq10lS3RERERFql3MXT6dOnERAQADs7O6xfvx49evTAlStXNJEbERERkdZR6zpPT548QVBQEHbs2IEXL15gwIAByM/Px4EDB+Dm5qbpHImIiIi0hsojTz169ICbmxtu3ryJ9evXIyEhAevXr6+I3IiIiIi0jsojTydOnMDkyZPx6aef8jIERERE9J+j8sjTuXPnkJmZCQ8PD3h6emLDhg149uxZReRGREREpHVULp68vLywbds2JCYmYty4cdi3bx9q1aoFqVSK4OBgZGZmVkSeRERERFpB7bPtTExMMGrUKJw/fx7R0dH47LPPsGzZMlhbW+ODDz7QZI5EREREWkMj13lydXXFihUr8OTJE+zdu1cTXRIRERFpJZWLp+zsbEyYMAG1atWCtbU1hgwZgpSUFACArq4u+vTpg8OHD2s8UWU2btwIFxcXGBkZoVWrVjh37lyp8SEhIWjVqhWMjIxQp04dbN68WW76tm3b0L59e1SvXh3Vq1dHly5dcOnSpYp8CURERFSFqFw8zZs3D0FBQejZsycGDx6M4OBgfPrppxWR2xv9/PPPmDp1KubOnYuIiAi0b98e3bt3x+PHjxXGx8bGokePHmjfvj0iIiLwxRdfYPLkyThw4IAs5uzZsxg8eDDOnDmD0NBQODo6omvXroiPj39bL4uIiIi0mEgQBEGVGerWrYtvvvkGgwYNAgBcunQJ7dq1Q05ODnR1dSskSWU8PT3h7u6OTZs2ydoaNWqEPn36YOnSpSXiZ82ahcOHDyMmJkbWNn78eFy7dg2hoaEKn6OwsBDVq1fHhg0bMHz48DLllZGRAbFYDIlEAgsLCxVfFZH2c579BwCgo6sVgj5uU8nZkLYqXk8A4OGynpWYCdGbOc/+A9LcbMStHfDG72+VR57i4uLQvn172eM2bdpAT08PCQkJ6mWrpry8PISHh6Nr165y7V27dsWFCxcUzhMaGloivlu3brhy5Qry8/MVzpOdnY38/HzUqFFDaS65ubnIyMiQ+yMiIqJ3k8rFU2FhIQwMDOTa9PT0UFBQoLGkyiIlJQWFhYWwsbGRa7exsUFSUpLCeZKSkhTGFxQUyI7bet3s2bNRq1YtdOnSRWkuS5cuhVgslv05ODio+GqIiIioqlD5CuOCIGDkyJEwNDSUteXk5GD8+PEwNTWVtR08eFAzGb6BSCQqkd/rbW+KV9QOACtWrMDevXtx9uxZGBkZKe1zzpw5mD59uuxxRkYGCygiIqJ3lMrF04gRI0q0BQQEaCQZVVhaWkJXV7fEKFNycnKJ0aVitra2CuP19PRQs2ZNufZvv/0WS5YswcmTJ9GsWbNSczE0NJQrJomIiOjdpXLxtHPnzorIQ2UGBgZo1aoVgoOD0bdvX1l7cHAwevfurXAeLy8vHDlyRK7txIkT8PDwgL6+vqxt5cqVWLx4Mf788094eHhUzAsgIiKiKkkjF8msLNOnT8cPP/yAHTt2ICYmBtOmTcPjx48xfvx4AEW70149Q278+PF49OgRpk+fjpiYGOzYsQPbt2/HjBkzZDErVqzAl19+iR07dsDZ2RlJSUlISkpCVlbWW399REREpH1ULp7CwsJw7NgxubZdu3bBxcUF1tbW+OSTT5Cbm6uxBEszcOBArF27FgsXLkSLFi3w119/4ejRo3BycgIAJCYmyl3zycXFBUePHsXZs2fRokULLFq0COvWrUP//v1lMRs3bkReXh4+/PBD2NnZyf6+/fbbt/KaiIiISLupvNtu/vz56NixI7p37w4AiI6OxujRozFy5Eg0atQIK1euhL29PebPn6/pXBUKDAxEYGCgwmlBQUEl2jp06ICrV68q7e/hw4cayoyIiIjeRSqPPEVGRqJz586yx/v27YOnpye2bduG6dOnY926dfjll180miQRERGRtlC5eEpLS5M7my0kJAT+/v6yx61bt0ZcXJxmsiMiraba/QmIiN4NKhdPNjY2iI2NBVB0le+rV6/Cy8tLNj0zM1PuzDUiIiKid4nKxZO/vz9mz56Nc+fOYc6cOTAxMZG7XUtUVBTq1q2r0SSJiIiItIXKB4wvXrwY/fr1Q4cOHWBmZoYff/xR7nYtO3bsKHH/OCIiIqJ3hcrFk5WVFc6dOweJRAIzMzPo6urKTf/1119hZmamsQSJiIiItInKxVMxsVissL1GjRpqJ0NERESk7ar0FcaJiIiI3jYWT0REREQqYPFEREREpAIWT0REREQq0EjxdPXqVeTl5WmiKyIiIiKtppHiqXXr1ryhLhEREf0naKR4EniDKyIiIvqP4DFPRERERCpg8URERESkAhZPRERERCpg8URERESkAhZPRERERCpg8URERESkAo0UT/PmzYOlpaUmuiIiIiLSanqa6GTevHma6IaIiIhI63G3HREREZEKWDwRERERqYDFUwXKzivQaH/afBscqVT93O4lZ+FlXiEAxcssPTsPuQWF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8skn6NWrl9yZdg0bNsTSpUvRt29fiEQiTJ06FUuWLEH9+vVRv359LFmyBCYmJhgyZAiAotEpRQeJOzo6wsXFpUJfExEREVUNap9td+XKFdStWxdr1qzB8+fPkZKSgjVr1qBu3bq4evWqJnNUaM+ePWjatCm6du2Krl27olmzZti9e7dczO3btyGRSGSPZ86cialTpyIwMBAeHh6Ij4/HiRMnYG5uXuH5EhER0btB7es8tW/fHvXq1cO2bdugp1c0gFVQUIAxY8bgwYMH+OuvvzSaaFXC6zwRERFVPWX9/la7eDI2NkZERAQaNmwo137z5k14eHggOztbnW7fCSyeiIiIqp4Kv0imhYUFHj9+XKI9Li6Ou8GIiIjonaV28TRw4ECMHj0aP//8M+Li4vDkyRPs27cPY8aMweDBgzWZIxEREZHWUPtsu2+//RYikQjDhw9HQUEBBEGAgYEBPv30UyxbtkyTORIRERFpjXLfGDg7Oxv379+HIAioX78+jI2NNZVblcVjnoiIiKqeCjvmKSwsDMeOHZM9NjExQUREBHr37g0nJyd88sknyM3NVS9rIiIiIi2ncvE0f/58REVFyR5HR0dj9OjR6NKlC2bPno0jR45g6dKlGk2SiIiISFuoXDxFRkaic+fOssf79u2Dp6cntm3bhunTp2PdunX45ZdfNJokERERkbZQuXhKS0uTu/luSEgI/P39ZY9bt26NuLg4zWRHREREpGVULp5sbGwQGxsLoOjGulevXoWXl5dsemZmJvT19TWXIREREZEWUbl48vf3x+zZs3Hu3DnMmTMHJiYmaN++vWx6VFQU6tatq9EkiYiIiLSFytd5Wrx4Mfr164cOHTrAzMwMP/74IwwMDGTTd+zYga5du2o0SSIiIiJtofZ1niQSCczMzKCrqyvX/vz5c5iZmckVVP81vM4TERFR1VPW72+1rzAuFosVtteoUUPdLomIiIi0ntr3tiMiIiL6L2LxRERERKQCFk9EREREKmDxRERERKQCFk9EREREKmDxRERERKQCFk9EREREKmDxRERERKQCFk9EREREKmDxRERERKQCFk9EREREKmDxRERERKQCFk9EREREKmDxRERERKQCFk9EREREKtCr7ATeRYIgAAAyMjIqORMiIiIqq+Lv7eLvcWVYPFWA1NRUAICDg0MlZ0JERESqSk1NhVgs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\n", "text/plain": [ "
" ] }, "metadata": {}, "output_type": "display_data" } ], "source": [ "sp3 = pvlib.solarposition.spa_python(df.index, lat, lon, altitude=meta['altitude'], temperature=df['temp_air'], pressure=df['pressure'])\n", "\n", "aux = pd.DataFrame({'psm3': df['solar_zenith'], 'spa': sp3['apparent_zenith']})\n", "aux['diff'] = aux['psm3'] - aux['spa']\n", "aux['diff'].plot()\n", "print('1st and 99th percentiles:', aux['diff'].quantile([0.01, 0.99]).values)\n", "\n", "plt.ylabel('Solar Zenith Difference (PSM3 $-$ SPA) [degrees]')\n", "plt.axhline(+0.005, ls='--', c='k', label='precision bounds')\n", "plt.legend()\n", "plt.axhline(-0.005, ls='--', c='k')\n", "plt.ylim(-0.05, 0.05)" ] }, { "cell_type": "code", "execution_count": 8, "id": "52b69958-a717-4112-9f0b-2f0965fe21d8", "metadata": {}, "outputs": [ { "name": "stdout", "output_type": "stream", "text": [ "Last updated: 2022-12-28 17:16:56\n", "\n", "numpy : 1.23.4\n", "matplotlib: 3.6.2\n", "pandas : 1.5.2\n", "pvlib : 0.9.3\n", "\n" ] } ], "source": [ "%load_ext watermark\n", "%watermark --iversions -u -d -t" ] }, { "cell_type": "code", "execution_count": null, "id": "af456e9b-4f9e-4d59-a96d-121193ce30f4", "metadata": {}, "outputs": [], "source": [] } ], "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.15" } }, "nbformat": 4, "nbformat_minor": 5 }