Final

ALSETLab · Nov 18, 2023 · cce6b31 · cce6b31
1 parent dc07e5a
commit cce6b31
Show file tree

Hide file tree

Showing 48 changed files with 1,375 additions and 4,533 deletions.
diff --git a/.editix/config.xml b/.editix/config.xml
@@ -1 +1 @@
-<?xml version="1.0" encoding="UTF-8"?><root nodestate="project;project/source"/>
+<?xml version="1.0" encoding="UTF-8"?><root nodestate="project"/>
diff --git a/.editix/workspace.xml b/.editix/workspace.xml
@@ -345,7 +345,9 @@
 <param name="lastView" value="Source"/>
 </file>
 <file open="true" path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\examples\bus-23\CIM\23bus_TP.xml" type="XML"/>
-<file open="false" path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\examples\bus-23\CIM\23bus_DY.xml" type="XML"/>
+<file open="false" path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\examples\bus-23\CIM\23bus_DY.xml" type="XML">
+<param name="lastView" value="Source"/>
+</file>
 <file open="true" path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\bus-23.mo" type="">
 <param name="lastView" value="Source"/>
 </file>
@@ -359,12 +361,12 @@
 <file open="false" path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\examples\bus-14\ieee14_EQ.xml" type="XML">
 <param name="lastView" value="Source"/>
 </file>
-<file open="true" path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\examples\nordic-44\CIM_new\N44_BC_EQ.xml" type="XML">
+<file open="false" path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\examples\nordic-44\CIM_new\N44_BC_EQ.xml" type="XML">
 <param name="lastView" value="Source"/>
 </file>
 <file path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\examples\nordic-44\CIM_new"/>
 <file path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\examples\nordic-44"/>
-<file open="true" path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\examples\nordic-44\CIM_new\N44_BC_SV.xml" type="XML">
+<file open="false" path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\examples\nordic-44\CIM_new\N44_BC_SV.xml" type="XML">
 <param name="lastView" value="Source"/>
 </file>
 <file open="false" path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\examples\bus-23\23bus.raw" type="">
@@ -473,5 +475,70 @@
 <file open="false" path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\Writerside\writerside.cfg" type="">
 <param name="lastView" value="Source"/>
 </file>
-<file open="true" path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\source\scenarios.xfl" type="XSC"/>
+<file open="true" path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\source\scenarios.xfl" type="XSC">
+<param name="lastView" value="Source"/>
+<param name="com.japisoft.editix.action.xml.DisabledEnabledCompletionAction" value="false"/>
+</file>
+<file open="false" path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\output\ieee14.mo" type="">
+<param name="lastView" value="Source"/>
+</file>
+<file path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\output"/>
+<file open="false" path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\output\nordic-44.mo" type="">
+<param name="lastView" value="Source"/>
+</file>
+<file open="false" path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\.editix\workspace.xml">
+<param name="encoding" value="AUTOMATIC"/>
+<param name="lastView" value="Source"/>
+</file>
+<file open="false" path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\source\imports\dynamics\ExcUserDefined.xsl" type="XSLT"/>
+<file path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\source\imports\dynamics"/>
+<file path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\source\imports"/>
+<file path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\source\imports\dynamics\ProprietaryParameterDynamics.xsl"/>
+<file open="false" path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\source\imports\dynamics\PPDStabilizer.xsl">
+<param name="encoding" value="AUTOMATIC"/>
+</file>
+<file open="false" path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\output\gencls.mo" type="">
+<param name="lastView" value="Source"/>
+</file>
+<file open="false" path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\examples\smib\Machines\GENCLS\CIM\smib_gencls_EQ.xml" type="XML">
+<param name="lastView" value="Source"/>
+</file>
+<file path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\examples\smib\Machines\GENCLS\CIM"/>
+<file path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\examples\smib\Machines\GENCLS"/>
+<file path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\examples\smib\Machines"/>
+<file path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\examples\smib"/>
+<file open="false" path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\examples\smib\Machines\GENCLS\CIM\smib_gencls_DY.xml" type="XML">
+<param name="lastView" value="Source"/>
+</file>
+<file open="false" path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\output\ieeet1.mo" type="">
+<param name="lastView" value="Source"/>
+</file>
+<file open="false" path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\output\brazil-7bus.mo" type="">
+<param name="lastView" value="Source"/>
+</file>
+<file open="false" path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\examples\brazil-7bus\CIM\Brazilian_7_bus_Equiv_Model_EQ.xml" type="XML">
+<param name="lastView" value="Source"/>
+</file>
+<file path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\examples\brazil-7bus\CIM"/>
+<file path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\examples\brazil-7bus"/>
+<file open="false" path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\output\csvgn1.mo" type="">
+<param name="lastView" value="Source"/>
+</file>
+<file open="false" path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\examples\smib\Machines\CSVGN1\CIM\smib_csvgn1_DY.xml" type="XML">
+<param name="lastView" value="Source"/>
+</file>
+<file path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\examples\smib\Machines\CSVGN1\CIM"/>
+<file path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\examples\smib\Machines\CSVGN1"/>
+<file open="false" path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\examples\smib\Machines\CSVGN1\CIM\smib_csvgn1_EQ.xml" type="XML">
+<param name="lastView" value="Source"/>
+</file>
+<file open="false" path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\examples\smib\Machines\CSVGN1\smib_csvgn1_package.mo" type="">
+<param name="lastView" value="Source"/>
+</file>
+<file path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\output\bus23_package.mo"/>
+<file open="false" path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\output\bus-23.mo" type="">
+<param name="lastView" value="Source"/>
+</file>
+<file path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\output\icelandic-sys.mo"/>
+<file path="C:\Users\glen\IdeaProjects\XSLTConferencePaper\output\ieee14-Rev4.txt"/>
 </root>
diff --git a/documentation/images/ClassBrowser.png b/documentation/images/ClassBrowser.png
diff --git a/documentation/images/Components.png b/documentation/images/Components.png
diff --git a/documentation/images/N44.png b/documentation/images/N44.png
diff --git a/documentation/images/Validate.png b/documentation/images/Validate.png
diff --git a/documentation/redirection-rules.xml b/documentation/redirection-rules.xml
@@ -10,4 +10,16 @@
         <description>Created after removal of "About Tutorial" from Tutorial</description>
         <accepts>starter-topic.html</accepts>
     </rule>
+    <rule id="43266199">
+        <description>Created after removal of "XML Analysis" from Tutorial</description>
+        <accepts>XML-Analysis.html</accepts>
+    </rule>
+    <rule id="5ada88d">
+        <description>Created after removal of "Analysis" from Tutorial</description>
+        <accepts>Analysis.html</accepts>
+    </rule>
+    <rule id="375113e8">
+        <description>Created after removal of "How to Create Schema" from Tutorial</description>
+        <accepts>How-to-Create-Schema.html</accepts>
+    </rule>
 </rules>
diff --git a/documentation/t.tree b/documentation/t.tree
@@ -9,10 +9,7 @@
     <toc-element topic="Tutorials.md">
         <toc-element topic="Overview.md"/>
         <toc-element topic="How-to-perform-Basic-Translation.topic"/>
+        <toc-element topic="Open-Output-in-Wolfram-System-Modeler.md"/>
         <toc-element topic="PreconfiguredImport.topic"/>
-        <toc-element topic="How-to-Create-Schema.md"/>
-    </toc-element>
-    <toc-element topic="Analysis.md">
-        <toc-element topic="Relationships.topic"/>
     </toc-element>
 </instance-profile>
diff --git a/documentation/topics/Analysis.md b/documentation/topics/Analysis.md
diff --git a/documentation/topics/How-to-Create-Schema.md b/documentation/topics/How-to-Create-Schema.md
diff --git a/documentation/topics/How-to-perform-Basic-Translation.topic b/documentation/topics/How-to-perform-Basic-Translation.topic
@@ -27,6 +27,12 @@
         </p>
 
         <procedure  id="steps-sequence">
+            <step>
+                <p>Open Editix</p>
+                <code-block lang="plain text">
+                    Start -> editix-xmleditor
+                </code-block>
+            </step>
             <step>
                 <p>Open the <a href="https://www.editix.com/doc/manual21/index.html#mozTocId804917">project file</a> by entering the path to the local Github repository.</p>
 
@@ -35,33 +41,39 @@
                     Enter the path to the github repository 'XSLTConferencePaper'.
                 </code-block>
             </step>
-
             <step>
                 <p>The project will open in the Project Panel.</p>
-
-                <!-- The 'src' attribute should contain the name of an image from the '/images' folder in your project -->
                 <img src="Project.png" alt="Project.png"/>
             </step>
-
             <step>
                 <p>Double-click on the 'CIMtoMO4.xsl' file. The <a href="https://www.editix.com/doc/manual21/images/screenshot/xslt.jpg">multi-view window</a> will open. it will take a second for the XML document to load. The results view will remain empty.</p>
             </step>
             <step>
-                <p>Transform a document with this XSLT ...</p>
+                <p>With 'CIMtoMO4.xsl open' in the multi-view window, transform a document by selecting the menu item or clicking the toolbar.</p>
                 <code-block lang="plain text">
                     XSLT/XQuery -> Transform a document with this XSLT ...
                     or
                 </code-block>
                 <img src="Transform.png" alt="Transform.png"/>
             </step>
             <step>
-                <p>The transform dialog will appear. Re-path the XSLT Document, Document source, and Result document for the part including "\XSLTConferencePaper\..." .</p>
+                <p>The transform dialog will appear. Re-path the </p>
+                <code-block lang="plain text">
+                    XSLT Document (*.xsl, *.xslt)
+                    Document source (*.xml, *.json)
+                    Result document (*.html...)
+                </code-block>
+                <p>for the part including "\XSLTConferencePaper\..." .</p>
                 <img src="TransformDialog.png" alt="TransformDialog.png"/>
                 <p>Then, click on the Parameters tab and enter the parameters as shown.</p>
+                <warning><list>
+                    <li>The parameters may not be in the same order.</li>
+                    <li>You must tab past any entered value for it to register.</li>
+                </list></warning>
                 <img src="Parameters.png" alt="Parameters"/>
             </step>
             <step>
-                <p>The examples/bus-14 CIM files (ieee14_EQ.xml, ieee14_SV.xml, ieee14_TP.xml, and ieee14_DY.xml) are translated and shown in the Result window. These results can be pasted into Modelica IDE and run with the OpenIPSL library.</p><img src="Results.png" alt="Results.png"/>
+                <p>The examples/bus-14 CIM files (ieee14_EQ.xml, ieee14_SV.xml, ieee14_TP.xml, and ieee14_DY.xml) are translated and shown in the Result window. They are also stored in the file 'IEEE14.mo' in the 'output' folder.</p><img src="Results.png" alt="Results.png"/>
                 <p>If the operation is successful, you will see the blue box at the bottom right!</p>
                 <img src="OperationComplete.png" alt="Complete"/>
             </step>

diff --git a/documentation/topics/Open-Output-in-Wolfram-System-Modeler.md b/documentation/topics/Open-Output-in-Wolfram-System-Modeler.md
@@ -0,0 +1,56 @@
+# Open Output in Wolfram System Modeler
+
+The translation files located in the 'output' folder can be opened in any Modelica IDE. [Wolfram System Modeler](https://www.wolfram.com/system-modeler/) will be used for this example.
+
+
+## Before you start
+
+Make sure that:
+- You have cloned the [repository](https://github.com/alSETLab/XSLTConferencePaper/).
+- Install Wolfram System Modeler.
+
+## How to load and validate a model
+
+We validate the model to make sure we have valid code recognized by the Modelica Specification.
+
+1. Open System Modeler
+
+   ```bash
+    Start -> All apps -> Wolfram System Modeler - Wolfram System Modeler 14.0
+   ```
+
+2. Open IEEE14
+   ```bash 
+   File -> Open ...
+   Find 'ieee14.mo' in the 'XSLTConferencePaper/output' folder.
+   ```
+
+3. Locate 'ieee14_package' under 'User Classes'. Tip it over and double-click 'ieee14'.
+
+![Class Browser](ClassBrowser.png)
+
+4. The documentation screen will open. It can be closed
+5. The Component Browser has buses, loads, lines, generators, shunts, and transformers. It also has System Data and a Fault.
+
+![Component Browser](Components.png)
+
+6. Click the 'Validate' button.
+
+![Validate](Validate.png)
+
+7. It will take a few seconds until the following 'Translation' feedback is provided.
+
+```
+5 9:04 AM Validation of ieee14 started
+The result will become available in this view once the validation is completed.
+
+6 9:05 AM Validation of ieee14 finished
+Warning: C:\Users\glen\IdeaProjects\XSLTConferencePaper\output\ieee14.mo 258:48-258:55 Malformed annotation (expected <libName>(version = <ver>)): uses(Complex)
+Notification: The initialization problem is underdetermined, the following variables were chosen to be initialized from their start values: gen2_1.stabilizer.rampTrackingFilter.TF2 1 .x 1 , gen2_1.stabilizer.rampTrackingFilter.TF1 5 .x 1, gen2_1.stabilizer.rampTrackingFilter.TF1 3 .x 1 , gen2_1.stabilizer.rampTrackingFilter.TF1 2 .x 1 , gen2_1.stabilizer.rampTrackingFilter.TF1 1 .x 1 , gen2_1.stabilizer.Leadlag1.TF.x 1 , gen1_1.stabilizer.rampTrackingFilter.TF2 1 .x 1 , gen1_1.stabilizer.rampTrackingFilter.TF1 5 .x 1 , gen1_1.stabilizer.rampTrackingFilter.TF1 3 .x 1 , gen1_1.stabilizer.rampTrackingFilter.TF1 2 .x 1 , gen1_1.stabilizer.rampTrackingFilter.TF1 1 .x 1 , gen1_1.stabilizer.Leadlag1.TF.x 1 
+Notification: The start value for gen2_1.stabilizer.rampTrackingFilter.TF1 4 .x 1 was not used, since higher priority was given to the start value of gen2_1.stabilizer.Leadlag1.TF.x 1 .
+Notification: The start value for gen1_1.stabilizer.rampTrackingFilter.TF1 4 .x 1 was not used, since higher priority was given to the start value of gen1_1.stabilizer.Leadlag1.TF.x 1 .
+Validation of model ieee14_package.ieee14 completed successfully.
+The model is globally balanced.
+There are 720 equations in the transformed integration problem.
+Among these, 691 equations are trivial.
+```
Original file line number	Diff line number	Diff line change
		@@ -1 +1 @@
		<?xml version="1.0" encoding="UTF-8"?><root nodestate="project;project/source"/>
		<?xml version="1.0" encoding="UTF-8"?><root nodestate="project"/>