added planned projects and plotBand to time series chart, updated des…

…cription

about.html

@@ -28,7 +28,7 @@ <h1>About Illinois Solar Map</h1>
   <li><a href="#categories-of-solar-projects">Categories of solar projects</a></li>
   <li><a href="#projects-by-category">Projects by category</a></li>
   <li><a href="#solar-installations-over-time">Solar installations over time</a></li>
-  <li><a href="#energized-vs-planned">Energized vs planned projects</a></li>
+  <li><a href="#planned">Planned projects</a></li>
   <li><a href="#data-sources">Data sources</a></li>
   <li><a href="#missing-data">Missing data</a></li>
   <li><a href="#team-and-collaborators">Team and collaborators</a></li>
@@ -49,7 +49,7 @@ <h2 id="categories-of-solar-projects" class="mt-4">Categories of solar projects<
   <li><strong>Small Distributed Generation (Small DG)</strong>: Small Distributed Generation (DG) for systems 25 kW and below</li>
 </ul>
 
-<h2 id="projects-by-category" class="mt-4">Energized projects by category</h3>
+<h2 id="projects-by-category" class="mt-4">Energized projects by category</h2>
 <div class="row">
   <div class="col-md-7">
     <div id="table-summary"></div>
@@ -61,7 +61,23 @@ <h2 id="projects-by-category" class="mt-4">Energized projects by category</h3>
   </div>
 </div>
 
-<h2 id="planned-projects-by-category" class="mt-4">Planned projects by category</h3>
+<h2 id="solar-installations-over-time" class="mt-4">Solar installations over time</h2>
+
+<p>Our data covers utility solar projects starting in December 2009. Data from the Adjustable Block Program and Illinois Solar for All start in 2019.</p>
+
+<p>Planned projects are based on scheduled energization dates, which can be delayed. All planned projects have recieved official approval and, based on our research, have a >95% chance of being built.</p>
+
+<figure class="highcharts-figure">
+  <div id="timeseries-chart"></div>
+  <p class="highcharts-description"><strong>Description:</strong> Area chart showing the cumulative megawatts of Utility, Small Distributed Generation, Large Distributed Generation and Community solar energized and planned in Illinois. There is a notable increase in megawatts installed starting in late 2019.</p>
+
+</figure>
+
+<h2 id="planned" class="mt-4">Planned projects</h2>
+
+<p>An additional <strong>{{site.planned_mw}} megawatts</strong> of solar is planned or under construction in Illinois, over double what is currently energized.
+</p>
+
 <div class="row">
   <div class="col-md-7">
     <div id="table-summary-planned"></div>
@@ -72,23 +88,11 @@ <h2 id="planned-projects-by-category" class="mt-4">Planned projects by category<
     </figure>
   </div>
 </div>
+
+<p><em>** Note: our source data does not show planned community solar projects. They are likely grouped with Large DG.</em></p>
 
-<em>** Note: our source data does not show planned community solar projects. They are likely grouped with Large DG.</em>
-
-<h2 id="solar-installations-over-time" class="mt-4">Solar installations over time</h2>
-
-<p>Our data covers utility solar projects starting in December 2009. Data from the Adjustable Block Program and Illinois Solar for All start in 2019. </p>
+<p>You can view where and what kind of projects are planned by clicking the 'Planned' selector on the map:</p>
 
-<figure class="highcharts-figure">
-  <div id="timeseries-chart"></div>
-  <p class="highcharts-description"><strong>Description:</strong> Area chart showing the cumulative megawatts of Utility, Small Distributed Generation, Large Distributed Generation and Community solar installed in Illinois. There is a notable increase in megawatts installed starting in late 2019.</p>
-
-</figure>
-
-<h2 id="energized-vs-planned" class="mt-4">Energized vs planned projects</h2>
-
-<p>An additional <strong>{{site.planned_mw}} megawatts</strong> of solar is planned or under construction in Illinois, over double what is currently energized. You can view where and what kind of projects are planned by clicking the 'Planned' selector on the map:
-</p>
 <p class="text-center">
   <a href="/index.html#/?status=planned&geography=counties">
     <img src="/images/energized-vs-planned.jpg" class="img-fluid img-thumbnail" alt="Energized vs planned solar projects by County" title="Energized vs planned solar projects by County">

data/final/monthly-aggregate.csv

@@ -62,12 +62,38 @@ energization_date,CS,Large_DG,Small_DG,Utility
 2023-08-01,218,304,312,927
 2023-09-01,218,307,327,933
 2023-10-01,218,309,347,937
-2023-11-01,224,312,367,1067
-2023-12-01,224,316,386,1233
+2023-11-01,224,313,367,1067
+2023-12-01,224,317,386,1233
 2024-01-01,224,321,408,1233
 2024-02-01,247,327,429,1233
 2024-03-01,247,334,447,1233
-2024-04-01,247,341,462,1233
+2024-04-01,247,342,462,1233
 2024-05-01,261,346,474,1234
-2024-06-01,268,347,483,1234
-2024-07-01,268,347,483,1234
+2024-06-01,268,370,483,1271
+2024-07-01,268,377,484,1279
+2024-08-01,268,445,485,1346
+2024-09-01,268,486,486,1407
+2024-10-01,268,508,487,1417
+2024-11-01,268,540,489,1417
+2024-12-01,268,557,494,1704
+2025-01-01,268,582,497,2301
+2025-02-01,268,633,505,2301
+2025-03-01,268,650,511,2310
+2025-04-01,268,676,515,2310
+2025-05-01,268,710,525,2325
+2025-06-01,268,836,528,2332
+2025-07-01,268,905,537,2332
+2025-08-01,268,1025,542,2345
+2025-09-01,268,1137,552,2397
+2025-10-01,268,1233,556,2397
+2025-11-01,268,1348,559,2547
+2025-12-01,268,1359,560,2547
+2026-01-01,268,1429,574,2547
+2026-02-01,268,1445,574,2547
+2026-04-01,268,1455,574,2547
+2026-05-01,268,1522,574,2547
+2026-06-01,268,1530,574,2547
+2026-07-01,268,1530,574,2617
+2027-09-01,268,1530,574,3007
+2027-12-01,268,1530,574,4207
+2028-06-01,268,1530,574,4707

data/scripts/aggregate_utils.py

@@ -196,7 +196,8 @@ def generate_monthly_kw_time_series():
     """calculate aggregated solar by category over time"""
     print("Generating monthly time series...")
     # load csv into pandas dataframe
-    df = pd.read_csv("../final/all-projects-w-districts.csv")
+    all_files = ["../final/all-projects-w-districts.csv", "../final/all-projects_planned-w-districts.csv"]
+    df = pd.concat((pd.read_csv(f) for f in all_files), ignore_index=True)
 
     # set energization_date column to datetime
     df["energization_date"] = pd.to_datetime(df["energization_date"], format='mixed')

js/about.js

@@ -175,14 +175,24 @@ $.when($.get("/data/final/all_projects_summary.csv")).then(
           enabled: false
         },
         title: {
-            text: 'Cumulative MW of solar installed over time'
+            text: 'Cumulative MW of solar energized and planned over time'
         },
         xAxis: {
             type: 'datetime',
             min: Date.UTC(2018, 0, 1),
             labels: {
               format: '{value:%b %Y}'
-            }
+            },
+            plotBands: [{
+              from: Date.UTC(2024, 6, 1),
+              to: Date.UTC(2028, 5, 0),
+              color: '#ccc',
+              label: {
+                  text: 'Planned',
+                  verticalAlign: 'top',
+                  style: {color: '#333', fontWeight: 'bold'}
+              }
+          }]
         },
         yAxis: {
             title: {