Initial version (#1)

* Initial model and data

* Create main.yml

* Update README.md

* Update README.md

Author: David P. Chassin

.github/workflows/main.yml

@@ -0,0 +1,42 @@
+name: Simulation
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    container: lfenergy/arras:develop
+    
+    steps:
+    - uses: actions/checkout@v3
+
+    - name: Cache IEEE 123 model
+      id: ieee-123-model
+      uses: actions/cache@v3
+      with:
+        path: 123.glm
+        key: ${{ runner.os }}-build-${{ env.cache-name }}-${{ hashFiles('123.glm') }}
+        restore-keys: |
+          ${{ runner.os }}-build-${{ env.cache-name }}-
+          ${{ runner.os }}-build-
+          ${{ runner.os }}-
+
+    - name: Run simulation
+      run: gridlabd main.glm
+      
+    - name: Save voltage plot
+      uses: actions/upload-artifact@v3
+      with:
+        name: Load 114 voltage
+        path: voltage_114.png
+      
+    - name: Save voltage profile
+      uses: actions/upload-artifact@v3
+      with:
+        name: IEEE 123 voltage profile
+        path: IEEE-123-voltage-profile.png
+      

README.md

@@ -1,3 +1,30 @@
-# Lesson 9 - Importing data
+[![Simulation](../../actions/workflows/main.yml/badge.svg)](../../actions/workflows/main.yml)
 
-Coming soon...
+# Lesson 9 - Importing Data
+
+The goal of this lesson is to introduce the most direct way of importing data into the simulation while it is running.  The specific learning objectives are the following.
+
+1. Learn how to use the `player` object.
+2. Learn how to loop input data.
+
+The [`player`](https://docs.gridlabd.us/index.html?owner=arras-energy&project=gridlabd&branch=master&folder=/Module/Tape&doc=/Module/Tape/Player.md) read values from a CSV files and updates object based on the timestamp associated with the values.  There are two formats for timestamps.
+
+- `YYYY-MM-DD HH:MM:SS [ZZZ]`, which is used to specify absolute time.
+
+- +[DIGITS][UNIT], which is used to specify relative time. When this format is used the first timetamp must be absolute. If the `loop` option is used, the player data will be repeated the specified number of times.
+
+## Tasks
+
+1. Play a load into load 114 (see [`main.glm@11`](main.glm#L12-L18))
+2. Record the voltage at load 114 (see [`main.glm@20`](main.glm#L21-L27))
+3. Setup the clock (see [`main.glm@29`](main.glm#L30-L35))
+4. Generate the voltage plot (see [`main.glm@37`](main.glm#L38))
+
+# Exercices
+
+1. Place meters on all the loads added by tasks 1-5.
+
+# More Information
+
+* [Tape module](https://docs.gridlabd.us/index.html?owner=arras-energy&project=gridlabd&branch=master&folder=/Module&doc=/Module/Tape.md)
+* [Player object](https://docs.gridlabd.us/index.html?owner=arras-energy&project=gridlabd&branch=master&folder=/Module/Tape&doc=/Module/Tape/Player.md)

load_114.csv

@@ -0,0 +1,4 @@
+2020-07-01 00:00:00,2000.000000+1000.000000j
++6h,20000.000000+10000.000000j
++12h,10000.000000+5000.000000j
++6h,2000.000000+1000.000000j

main.glm

@@ -0,0 +1,40 @@
+#ifmissing "123.glm"
+#model get IEEE/123
+#endif
+#include "123.glm"
+
+module tape
+{
+    csv_header_type NAME;
+}
+
+// Task 1 - Play a load into load 114
+object player
+{
+    parent load_114;
+    file "load_114.csv";
+    property "constant_power_A";
+    loop 7;
+}
+
+// Task 2 - Record the voltage at load 114
+object recorder
+{
+    parent load_114;
+    file "voltage_114.csv";
+    property "voltage_A.real";
+    interval 1h;
+}
+
+// Task 3 - Setup the clock
+clock
+{
+    timezone "PST+8PDT";
+    starttime "2020-07-01 00:00:00 PDT";
+    stoptime "2020-07-08 00:00:00 PDT";
+}
+
+// Task 4 - Generate the voltage plot
+#on_exit 0 gridlabd plot -i=voltage_114.csv -o=voltage_114.png --plot:grid
+
+#output "IEEE-123-voltage-profile.png" -t profile -l 10