Add Base Documentation for SU2GUI

Author: Ujjawal179

Gemfile

@@ -1,6 +1,8 @@
 source 'https://rubygems.org'
 group :jekyll_plugins do
+    gem 'tzinfo'
     gem 'github-pages'
     gem 'jekyll-twitter-plugin'
     gem 'webrick'
+    gem 'tzinfo-data', platforms: [:mingw, :mswin, :x64_mingw, :jruby]
 end

_config.yml

@@ -16,11 +16,12 @@ bootwatch: yeti
 # Build settings
 markdown: kramdown
 highlighter: rouge
-gems:
+plugins:
   - jekyll-feed
   - jekyll-redirect-from
   - jekyll-seo-tag
   - jekyll-sitemap
+  - jekyll-gist
 
 whitelist:
   - jekyll-redirect-from
@@ -32,7 +33,9 @@ exclude:
   - .idea/
   - .gitignore
   - README.md
-timezone: Europe/Berlin
+
+timezone: "America/New_York"
+
 defaults:
 - scope:
     path: _posts
@@ -76,6 +79,16 @@ defaults:
     sectionid: vandv
     seo:
       type: "WebPage"
+
+- scope:
+    path: _su2gui
+    type: su2gui
+  values:
+    layout: su2gui
+    sectionid: su2gui
+    seo:
+      type: "WebPage"
+
 collections:
   docs:
     permalink: /:collection/:path/
@@ -89,12 +102,13 @@ collections:
   vandv:
     permalink: /:collection/:path/
     output: true
+  su2gui:
+    permalink: /:collection/:path/
+    output: true
   posts:
     permalink: /blog/:year/:month/:day/:title/
     output: true
 
 # Google Analytics
 google_analytics: UA-28187985-1
 
-plugins:
-  - jekyll-gist

_data/su2gui.yml

@@ -0,0 +1,19 @@
+- title: Introduction to SU2GUI
+  su2gui:
+  - Introduction
+  - Quick-Start
+
+- title: Installation
+  su2gui:
+  - Installation
+  - Build-From-Source
+
+- title: User Guide
+  su2gui:
+  - Terminal-Initialization
+  - Manage-Cases
+  - Mesh-File
+  - configurations
+  - Initialization
+  - Logs-Errors
+  - Result-Analysis

_includes/su2gui_nav.html

@@ -0,0 +1,22 @@
+<div class="panel-group" id="accordion" role="tablist" aria-multiselectable="true">
+{% for section in site.data.su2gui %}
+  <div class="panel panel-default">
+    <div class="panel-heading">
+      <h4 class="panel-title">
+        <a role="button" data-toggle="collapse" data-parent="#accordion" href="#collapse-{{forloop.index}}" aria-expanded="false" aria-controls="collapse-{{forloop.index}}">
+          {{ section.title }}
+        </a>
+      </h4>
+    </div>
+    <div id="collapse-{{forloop.index}}" class="panel-collapse collapse" role="tabpanel" aria-labelledby="headingOne">
+      <ul class="list-group">
+        {% for item in section.su2gui %}
+          {% assign item_url = item | prepend:"/su2gui/" | append:"/" %}
+          {% assign p = site.su2gui | where:"url", item_url | first %}
+          <a class="list-group-item {% if item_url == page.url %}active{% endif %}" href="{{ p.url  | relative_url }}">{{ p.title }}</a>
+        {% endfor %}
+      </ul>
+    </div>
+  </div>
+{% endfor %}
+</div>

_includes/su2gui_section_nav.html

@@ -0,0 +1,52 @@
+{% comment %}
+Map grabs the doc sections, giving us an array of arrays. Join, flattens all
+the items to a comma delimited string. Split turns it into an array again.
+{% endcomment %}
+{% assign su2gui = site.data.su2gui | map: 'su2gui' | join: ',' | split: ',' %}
+
+{% comment %}
+Because this is built for every page, lets find where we are in the ordered
+document list by comparing url strings. Then if there's something previous or
+next, lets build a link to it.
+{% endcomment %}
+
+{% for document in su2gui %}
+  {% assign document_url = document | prepend:"/su2gui/" | append:"/" %}
+  {% if document_url == page.url %}
+    <ul class="pager">
+      {% if forloop.first %}
+        <li class="previous disabled">
+          <a>
+            <span aria-hidden="true">&larr;</span> Previous
+          </a>
+        </li>
+      {% else %}
+        {% assign previous = forloop.index0 | minus: 1 %}
+        {% assign previous_page = su2gui[previous] | prepend:"/su2gui/" | append:"/" %}
+        <li class="previous">
+          <a href="{{ previous_page | relative_url }}">
+            <span aria-hidden="true">&larr;</span> Previous
+          </a>
+        </li>
+      {% endif %}
+
+      {% if forloop.last %}
+        <li class="next disabled">
+          <a>
+            Next <span aria-hidden="true">&rarr;</span>
+          </a>
+        </li>
+      {% else %}
+        {% assign next = forloop.index0 | plus: 1 %}
+        {% assign next_page = su2gui[next] | prepend:"/su2gui/" | append:"/" %}
+        <li class="next">
+          <a href="{{ next_page | relative_url }}">
+            Next <span aria-hidden="true">&rarr;</span>
+          </a>
+        </li>
+      {% endif %}
+    </div>
+    <div class="clear"></div>
+    {% break %}
+  {% endif %}
+{% endfor %}

_includes/topnav.html

@@ -21,6 +21,7 @@
                 <li {% if page.sectionid=='forum' %} class="active" {% endif %}><a href="{{ "https://www.cfd-online.com/Forums/su2/" }}">User Forum</a></li>
                 <li {% if page.sectionid=='slack' %} class="active" {% endif %}><a href="{{ "https://join.slack.com/t/su2devteam/shared_invite/zt-af0uuqf8-8XNExKMV9G~UVsnkvi5uVA" }}">Dev Team Slack</a></li>
                 <li {% if page.sectionid=='develop' %} class="active" {% endif %}><a href="{{ "/develop.html" relative_url }}">Develop</a></li>
+                <li {% if page.sectionid=='su2gui' %} class="active" {% endif %}><a href="{{ "/su2gui/introduction" relative_url }}">SU2GUI</a></li>
             </ul>
             <div class="navbar-right">
                 <ul class="nav navbar-nav">

_layouts/su2gui.html

@@ -0,0 +1,55 @@
+---
+layout: default
+---
+
+<div class="container">
+    <div class="row">
+        <div class="col-md-4">
+          {% include su2gui_nav.html %}
+        </div>
+
+        <div class="col-md-8">
+            <h1>{{ page.title }}</h1>
+            <div id="markdown-content-container">{{ content }}</div>
+            <hr>
+            {% unless true %}
+            <script>
+            
+            /**
+            *  RECOMMENDED CONFIGURATION VARIABLES: EDIT AND UNCOMMENT THE SECTION BELOW TO INSERT DYNAMIC VALUES FROM YOUR PLATFORM OR CMS.
+            *  LEARN WHY DEFINING THESE VARIABLES IS IMPORTANT: https://disqus.com/admin/universalcode/#configuration-variables*/
+            /*
+            var disqus_config = function () {
+            this.page.url = PAGE_URL;  // Replace PAGE_URL with your page's canonical URL variable
+            this.page.identifier = PAGE_IDENTIFIER; // Replace PAGE_IDENTIFIER with your page's unique identifier variable
+            };
+            */ 
+            (function() { // DON'T EDIT BELOW THIS LINE
+            var d = document, s = d.createElement('script');
+            s.src = 'https://su2code-github-io.disqus.com/embed.js';
+            s.setAttribute('data-timestamp', +new Date());
+            (d.head || d.body).appendChild(s);
+            })();
+            </script>
+            <noscript>Please enable JavaScript to view the <a href="https://disqus.com/?ref_noscript">comments powered by Disqus.</a></noscript>
+
+
+            <div id="disqus_thread"></div>
+            <hr>
+            {% endunless %}       
+            <p class="text-center">
+              <br />
+              <a target="_blank" href="{{site.git_edit_address}}/{{ page.path }}" class="btn btn-default githubEditButton" role="button">
+                <i class="fa fa-pencil fa-lg"></i> Improve this page
+              </a>
+            </p>
+            {% include su2gui_section_nav.html %}
+        </div>
+
+    </div>
+</div>
+
+<!-- Mathjax Support -->
+<script type="text/javascript" async
+  src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-MML-AM_CHTML">
+</script>

_su2gui/Build-From-Source.md

@@ -0,0 +1,24 @@
+---
+title: Build From Source and Contributions
+permalink: /su2gui/Build-From-Source/
+---
+
+This section guides you through using the source code to run SU2GUI on your device, enabling custom changes and optimizations.
+
+### Minimal Requirements
+
+- Python 3
+- SU2 Software
+- Python Libraries listed in [requirements.txt](Link)
+
+### Installation and Setup
+
+Clone the source code from our [GitHub repository](Link). Navigate to the root folder and run `su2gui.py`. You can also pass additional options or create your custom terminal arguments.
+
+### Command to Start the Server
+
+    usage: python su2gui.py [-h] [-p PORT] [-c CASE] [-m MESH] [--config CONFIG] [--restart RESTART]
+
+## Contributing to SU2 
+
+As an open-source organization, we actively develop SU2 software suite and greatly appreciate contributions from the community. Whether it's fixing bugs, adding new features, or improving documentation, your contributions are valuable. To get started, refer to our [Contribution Guide](./../../docs_v7/Gitting-Started/) for detailed instructions on how to contribute to SU2.

_su2gui/Configurations.md

@@ -0,0 +1,48 @@
+---
+title: Configurations
+permalink: /su2gui/configurations/
+---
+
+This section explains how to use the configuration file and Config Tab in SU2GUI. For an overview of what a configuration file is, please refer to the [configuration file](../../docs_v7/Configuration-File/) page.
+
+## Loading a Configuration File
+SU2GUI allows users to load a configuration file through both the GUI and the terminal. Loading the file is optional, as SU2GUI will create one if the user does not provide it. Before doing so, it is necessary for the user to initialize a Case. It is recommended to load the mesh file before the configuration file to set boundary condition properties and ensure proper functionality.
+
+**Steps to load configuration file:**
+
+ 1. Start a new case and load mesh file. Follow these guides for detailed steps on [starting a new case](./Manage-Cases/#starting-a-new-case) and [loading a mesh file](./mesh).
+ 
+
+ 2. Click on the "Load Config File" option. ![](../../su2gui_files/User_guide/Configuration/button-config-file.png)
+ 
+
+ 3. In the pop-up window, choose the desired configuration file. ![](../../su2gui_files/User_guide/Configuration/choose-config-file.png)
+ 
+
+ 4.  The configuration file should now be loaded, and the properties in the GUI should be updated accordingly. ![](../../su2gui_files/User_guide/Configuration/loaded-config-file.png)
+
+
+
+For instructions on loading a configuration file through the terminal, refer to the guide on [ Terminal Initialization](./../terminal-initialization).
+
+## Config Tab
+
+The Config Tab allows users to analyze and modify the current state of the Configuration File. It presents the data in JSON format, which is then converted into a configuration file for SU2 when the solver is initiated.
+
+![Config Tab](../../su2gui_files/User_guide/Configuration/config-tab.png)
+
+### Adding New Properties
+
+User can add/modify Properties in configuration file using this. Place the Key in key textbox and Value in Value textbox. By default, Key is capitalised and preceding and trailing spaces are removed from the Key. Ways to add Value for property are given below:
+
+- **Adding Float/Int**: The system attempts to convert all input into a float. If the conversion fails, it proceeds with other data types.
+  
+- **Adding Boolean**: The system recognizes "YES," "NO," "TRUE," and "FALSE" in any case (uppercase or lowercase) and stores them as boolean values.
+
+- **Adding List**: When a list is added, it creates a list of elements and checks if each element is a digit. Below are examples of correct and incorrect list formats:
+
+
+
+  | **Correct List**  | (outlet1, 101325, outlet2, 101325) | [outlet1, 101325, outlet2, 101325] | outlet1, 101325, outlet2, 101325 | outlet1 101325 outlet2 101325 |
+  |-------------------|------------------------------------|------------------------------------|---------------------------------|--------------------------------|
+  | **Incorrect List** | (outlet1, 101325, outlet2, 101325 | outlet1, 101325, outlet2, 101325} | outlet1, 101325 outlet2 101325 | outlet1101325 outlet2101325 |

_su2gui/Initialization.md

@@ -0,0 +1,66 @@
+---
+title: Initialization
+
+permalink: /su2gui/Initialization/
+---
+
+SU2GUI supports three methods for initializing a problem, which are available under the Initialization section of the menu:
+
+- [**Uniform Initialization**](#uniform-initialization)
+- [**Initialization using Restart File**](#initialization-using-restart-file)
+- [**Patch Initialization**](#patch-initialization)
+
+### Opening the Initialization Options
+
+1. Start a new case and load the mesh file. Follow these guides for detailed steps on [starting a new case](./Manage-Cases/#starting-a-new-case) and [loading a mesh file](./mesh).
+
+2. Navigate to the Initialization section from the left menu:  
+   ![](../../su2gui_files/User_guide/initialization/initialize-options.png)
+
+Follow the steps below according to the type of initialization needed.
+
+---
+
+## Uniform Initialization
+
+As the name suggests, this method sets all points to a constant value, and a solution file is created for SU2.
+
+**Steps for Uniform Initialization**
+
+1. After opening the Initialization options, select **Uniform Initialization** from the drop-down menu.
+
+2. Enter the required properties. The properties will vary depending on the selected Solver and Configurations.
+
+3. Press the **Initialize** button. The problem will be initialized, and the visualization window will update accordingly.![](../../su2gui_files/User_guide/initialization/loaded-uniform-initialize.png)
+
+---
+
+## Initialization using Restart File
+
+This method uses a Restart File to initialize the problem. SU2GUI supports both `.dat` and `.csv` formats for restart files.
+
+**Steps for Restart Initialization**
+
+1. After opening the Initialization options, select **Restart File Initialization** from the drop-down menu.
+
+2. Click on the **Load Restart File** option. ![](../../su2gui_files/User_guide/initialization/button-restart-file.png)
+
+3. In the pop-up window, choose the desired restart file. ![](../../su2gui_files/User_guide/initialization/choose-restart-file.png)
+
+4. The Restart file will be loaded, and the visualization window will update accordingly. ![](../../su2gui_files/User_guide/initialization/loaded-restart-file.png)
+
+For instructions on loading a restart file through the terminal, refer to the guide on [ Terminal Initialization](./../terminal-initialization).
+
+---
+
+## Patch Initialization
+
+SU2GUI currently supports three types of patch initialization: Plane, Sphere, and Box. In this method, a patch is created in the visualization window according to the inputs, and a solution file is generated for SU2.
+
+**Steps for Patch Initialization**
+
+1. After opening the Initialization options, select **Patch Initialization** from the drop-down menu.
+
+2. Select type of Patch and enter the required properties for both zones. The properties will change according to the selected Solver and Configurations.
+
+3. Press the **Initialize** button. The problem will be initialized, and the visualization window will update accordingly. ![](../../su2gui_files/User_guide/initialization/loaded-patch-initialize.png)