Merge pull request #30 from CURENT/develop

Develop

.github/workflows/WebBuild.yml

@@ -0,0 +1,29 @@
+name: Build and Test
+
+on:
+  pull_request:
+    branches:
+      - master
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v2
+
+      - name: Set up Ruby
+        uses: actions/setup-ruby@v1
+        with:
+          ruby-version: '3.x'  # Specify the version of Ruby you need
+
+      - name: Install Bundler
+        run: gem install bundler
+
+      - name: Install Jekyll Dependencies
+        run: bundle install
+
+      - name: Build Jekyll
+        run: bundle exec jekyll build
+        working-directory: ./  # Assuming your Jekyll project is in the root directory

README.md

@@ -1,23 +1,16 @@
 # CURENT LTB Web
 
-The web is hosting at https://ltb.curent.org
-
-The web is using the Jekyll Theme *Feeling Responsive*.
+The LTB website is develoepd using the Jekyll Theme [Feeling Responsive](https://github.com/Phlow/feeling-responsive).
 
 ## Maintenance
 
 The update should be made and tested on branch ``develop`` first, and then deployed to branch ``master`` as follow:
 
 1. Make sure the branch ``develop`` is update to the branch ``master``
 2. Update the contents in the branch ``develop``
-3. Run your Jekyll site locally on branch ``develop``
-
-```
-bundle exec jekyll serve
-```
-
-4. If update looks good locally, merge the updated branch ``develop`` into branch ``master``
-5. Wait the deployment of the updated website
+3. Run your Jekyll site locally on branch ``develop``: ``bundle exec jekyll serve``
+4. If update looks good locally, merge the updated branch ``develop`` into branch ``master`` using a pull request
+5. After the deployment, the website will be updated automatically
 
 ## Content
 

_config.yml

@@ -14,11 +14,11 @@ title: 'LTB'
 slogan: 'A fast-prototyping platform for large-scale power system'
 
 # The description is used on homepage and in the footer to quickly describe your website. Use a maximum of 150 characters for SEO-purposes.
-description: 'CURENT LTB is an open-source platform for large-scale power system analysis.'
+description: 'CURENT LTB is an open-source platform for large-scale power system analysis. This website is developed based on the Jekyll theme Feeling Responsive.'
 
 # The credits show up in the includes/_footer.html – It would be nice of you to leave a link to Phlow or Feeling Responsive as a thank you :)
 # credits: '<p>Created with &hearts; by <a href="http://jinningwang.github.io/">Jinning Wang</a> with <a href="http://jekyllrb.com/" target="_blank">Jekyll</a> based on <a href="http://phlow.github.io/feeling-responsive/">Feeling Responsive</a>.</p>'
-credits: 'Copyright © 2023 CURENT LTB'
+credits: 'Copyright © 2023-2024 CURENT LTB'
 
 # Main author of the website
 # See > authors.yml

_data/network.yml

@@ -5,21 +5,6 @@
   class: "network-entypo"
   title: "CURENT"
 
-- name: "Enliten Lab"
-  url: "https://enliten.utk.edu"
-  class: "network-entypo"
-  title: "Enliten Lab"
-
-- name: "Sustainable Energy Systems Lab (SENSL)"
-  url: "https://cui.eecps.com/group/"
-  class: "network-entypo"
-  title: "Sustainable Energy Systems Lab (SENSL)"
-
-- name: "Open-source projects for Power System Analysis"
-  url: "https://github.com/jinningwang/best-of-ps"
-  class: "network-entypo"
-  title: "Open-source projects for Power System Analysis"
-
 # - name: "Images by Unsplash"
 #   url: "http://unsplash.com/"
 #   class: "rss-link"

_layouts/home.html

@@ -124,11 +124,14 @@ <h1 style="text-align: center;"></h1>
         <h2>OVERVIEW</h2>
         <p>The CURENT Large-scale Testbed (LTB) is a state-of-the-art research facility designed for rapid prototyping of power systems.
           It is a tightly integrated, closed-loop system consisting of four major independent sub-packages: ANDES for dynamic simulation,
-          AMS (under development) for market simulation, DiME for distributed messaging environment, and AGVis for grid visualization.
+          AMS for dispatch simulation, AGVis for grid visualization, and DiME for distributed messaging environment.
           These LTB packages can be used individually or in a federated manner, making it a versatile tool for power system research and development.</p>
+        <p>Check out the installation and hands-on tutorial at <a href="/showcase/quickstart/" target="_blank">Getting Started with LTB</a>.
+        Take a look on showcase page for more examples of LTB applications at <a href="/showcase/" target="_blank">Showcase</a>.</p>
+        </p>
       </div>
-    </div>
-  
+  </div>
+
   <div class="row">
     <div class="small-24 columns" style="text-align: left; margin-top: 5px;">
       <div class="icon-container">
@@ -154,12 +157,15 @@ <h2>OVERVIEW</h2>
 
   <div class="row">
     <div class="small-12 columns">
-      <h2>CITE US</h2>
+      <h2>Design Philosophy</h2>
+      <p>The design philosophy of the LTB is to provide a rapid prototyping environment for power system research and development.
+      We kindly ask that you cite the following papers if LTB is used in your research.
       <ol>
         <li>F. Li, K. Tomsovic and H. Cui, "A Large-Scale Testbed as a Virtual Power Grid: For Closed-Loop Controls in Research and Testing," in IEEE Power and Energy Magazine, vol. 18, no. 2, pp. 60-68, March-April 2020, doi: 10.1109/MPE.2019.2959054.</li>
         <li>H. Cui, F. Li and K. Tomsovic, "Hybrid Symbolic-Numeric Framework for Power System Modeling and Analysis," in IEEE Transactions on Power Systems, vol. 36, no. 2, pp. 1373-1384, March 2021, doi: 10.1109/TPWRS.2020.3017019.</li>
         <li>N. Parsly, J. Wang, N. West, Q. Zhang, H. Cui and F. Li, "DiME and AGVis: A Distributed Messaging Environment and Geographical Visualizer for Large-Scale Power System Simulation," 2023 North American Power Symposium (NAPS), Asheville, NC, USA, 2023, pp. 1-5, doi: 10.1109/NAPS58826.2023.10318583.</li>
       </ol>
+      </p>
     </div>
   </div>
 

_posts/showcase/2021-10-13-tdcosim.md

@@ -7,10 +7,19 @@ permalink: "/showcase/tdcosim/"
 header: no
 ---
 
+# Abstract
+
+The rapid deployment of distributed energy resources (DERs) in distribution networks has made it challenging to balance the transmission system and stabilize frequency. DERs have the ability to provide frequency regulation services; however, existing frequency dynamic simulation tools—which were developed mainly for the transmission system—lack the capability to simulate distribution network dynamics with high penetrations of DERs. Although electromagnetic transient simulation tools can simulate distribution network dynamics, the computation efficiency limits their use for large-scale transmission-and-distribution (T&D) co-simulation. This paper presents an efficient open-source T&D dynamic co-simulation framework for DER frequency response based on the HELICS platform and off-the-shelf T&D simulators. The challenge of synchronizing the simulation between the transmission network and the DERs in the distribution network is solved through the detailed modeling of DERs in frequency dynamic models while DER power flow models are also preserved in the distribution networks, thereby respecting local voltage constraints when dispatching DER power for frequency response. DER frequency response (primary and secondary) is simulated in case studies to validate the proposed framework. Last, the accuracy of the proposed co-simulation model is benchmarked, and a large T&D system simulation (2k transmission and 1M distribution nodes) is presented to demonstrate the efficiency and effectiveness of the overall framework.
+
+# Proposed T-D Co-Sim Framework
+
 An efficient open-source transmission-and-distribution (T&D) co-simulation framework for DER frequency response based on the HELICS platform and off-the-shelf T&D simulators.
 
 ![T-D Co-sim](/images/showcase/tdcosim.png)
 
 Fig. Information exchange in Transmission-and-Distribution Dynamic Co-Simulation Framework
 
-W. Wang, X. Fang, H. Cui, F. Li, Y. Liu and T. J. Overbye, "Transmission-and-Distribution Dynamic Co-Simulation Framework for Distributed Energy Resource Frequency Response," in IEEE Transactions on Smart Grid, vol. 13, no. 1, pp. 482-495, Jan. 2022, doi: 10.1109/TSG.2021.3118292.
+# References
+
+1. W. Wang, X. Fang, H. Cui, J. Wang, F. Li, Y. Liu, T. J. Overbye, M. Cai, and C. Irwin, "Cyber-Physical Dynamic System (CPDS) Modeling for Frequency Regulation and AGC Services of Distributed Energy Resources," August 2022. [Online]. Available: https://www.osti.gov/biblio/1882191.
+1. W. Wang, X. Fang, H. Cui, F. Li, Y. Liu and T. J. Overbye, "Transmission-and-Distribution Dynamic Co-Simulation Framework for Distributed Energy Resource Frequency Response," in IEEE Transactions on Smart Grid, vol. 13, no. 1, pp. 482-495, Jan. 2022, doi: 10.1109/TSG.2021.3118292.

_posts/showcase/2024-01-08-quickstart.md

@@ -7,6 +7,18 @@ permalink: "/showcase/quickstart/"
 header: no
 ---
 
+<div class="row">
+<div class="medium-4 medium-push-8 columns" markdown="1">
+<div class="panel radius" markdown="1">
+**Table of Contents**
+{: #toc }
+*  TOC
+{:toc}
+</div>
+</div><!-- /.medium-4.columns -->
+
+<div class="medium-8 medium-pull-4 columns" markdown="1">
+
 This page provides a quick start guide for new users to get started with LTB.
 Each project has its own documentation, where more details about installation and example usage can be found.
 
@@ -72,6 +84,10 @@ For model development purpose, you may want to install the latest version and pl
 [Develop Install](https://docs.andes.app/en/latest/getting_started/install.html#develop-install) discusses how to install ANDES in development mode.
 It is also applicable to AMS and AGVis.
 
+# Hands-on Tutorial
+
+It is recommended to go through [ANDES Examples](https://docs.andes.app/en/latest/examples/index.html) and [AMS Examples](https://ltb.readthedocs.io/projects/ams/en/latest/examples/index.html) to get started with LTB.
+
 # Usage
 
 ## Jupyter Notebook
@@ -98,8 +114,16 @@ With Binder, open notebooks in an executable environment, making your code immed
 
 # Related Topics
 
+## Research Code
+
+[The Good Research Code Handbook](https://goodresearch.dev) by Patrick Mineault
+
 ## Software Development
 
+1. J. K. Ousterhout, A philosophy of software design, First edition. Palo Alto, CA: Yaknyam Press, 2018.
+
+## Software Quality
+
 [Semantic Versioning][Semantic Versioning];
 [Continuous Integration][Continuous Integration];
 [Continuous Deployment][Continuous Deployment]
@@ -119,7 +143,6 @@ Tools
 [pandapower][pandapower];
 [PyPSA][PyPSA]
 
-
 * * *
 
 [Better Grids]: https://db.bettergrids.org

pages/showcase.md

@@ -6,6 +6,19 @@ subheadline: "Power your research by LTB"
 permalink: "/showcase/"
 header: no
 ---
+
+<div class="row">
+<div class="medium-4 medium-push-8 columns" markdown="1">
+<div class="panel radius" markdown="1">
+**Table of Contents**
+{: #toc }
+*  TOC
+{:toc}
+</div>
+</div><!-- /.medium-4.columns -->
+
+<div class="medium-8 medium-pull-4 columns" markdown="1">
+
 ## Research
 
 [Virtual Inertia Scheduling (VIS) for Microgrids with Static and Dynamic Security Constraints by Buxin She](/showcase/microvis/)
@@ -14,7 +27,7 @@ header: no
 
 [Disturbance Propagation in Power Grids With High Converter Penetration by Dr. Hantao Cui](/showcase/emw/)
 
-[Transmission-and-Distribution Co-Simulation Framework by Dr. Wenbo Wang](/showcase/tdcosim/)
+[Transmission-and-Distribution Co-Simulation Framework by Dr. Xin Fang](/showcase/tdcosim/)
 
 ## Presentation