Skip to content

Commit

Permalink
Update documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
actions-user committed Aug 3, 2023
1 parent 389fa66 commit 194c608
Show file tree
Hide file tree
Showing 4 changed files with 162 additions and 162 deletions.
10 changes: 5 additions & 5 deletions _sources/tutorials/opt_cs_init_twist.rst
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
Optimize the cross-section considering beam initial twist
==========================================================



Optimize the cross-section considering beam initial twist
==========================================================



10 changes: 5 additions & 5 deletions _sources/tutorials/opt_spar_layup.rst
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
Optimize the spar layup of a cross-section
===========================================



Optimize the spar layup of a cross-section
===========================================



8 changes: 4 additions & 4 deletions _sources/tutorials/prepare_cs_template.rst
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
Prepare a cross-sectional design template
=========================================


Prepare a cross-sectional design template
=========================================


296 changes: 148 additions & 148 deletions _sources/tutorials/run_one_analysis.rst
Original file line number Diff line number Diff line change
@@ -1,148 +1,148 @@
Carry out a single cross-sectional analysis
============================================


This first tutorial will give the instructions to the basic functionalities of the tool.

Suppose that we want to carry out a single cross-sectional analysis.
The task is to carry out a quick cross-sectional analysis of a specific cross-sectional design.
Specifically, in this tutorial, we want to set values to the locations of spar webs and get the torsional and bending stiffness (|gj|, |eiyy|, |eizz|).


Run the example
----------------------

To run the tutorial, start a command line prompt, change directory to this tutorial folder, and run the following command:

.. code-block:: shell
python run.py cs_design_analysis.yml 1
Result can be found in the file ``cs_design_analysis.out``.




Files of this tutorial
-----------------------

Input
^^^^^^

For this and all analysis of |msgd|, there is one top-level yaml file as the main input and a Python script to trigger the analysis.
All others are the supporting files.

.. list-table:: Tutorial input files
:header-rows: 1

* - File
- Description
* - ``cs_design_analysis.yml``
- Main input file
* - ``run.py``
- Python script running the analysis
* - ``airfoil_simple.xml.tmp``
- Cross-sectional design template
* - ``SC1095.dat``
- Airfoil data
* - ``material_database_us_ft.xml``
- Material database

This tutorial mainly focuses on the main input file.
Tutorials on other files will be explained later.

Output
^^^^^^^^

.. list-table:: Tutorial output files
:header-rows: 1

* - File
- Description
* - ``cs_design_analysis.out``
- Analysis result


Main input file specification (``cs_design_analysis.yml``)
------------------------------------------------------------

.. note::

For more details on the syntax of the YAML format, please see :ref:`section-yaml`.



Basic layout of the main input file
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. code-block:: yaml
:linenos:
cs:
# Define cross-sectional designs
analysis:
# Define analysis steps
Define the cross-section
^^^^^^^^^^^^^^^^^^^^^^^^^^

This block specifies the base design of the cross-section that will be analyzed.

.. code-block:: yaml
:linenos:
cs:
- name: "airfoil"
parameter:
a2p1: 0.82
a2p3: 0.58
design:
dim: 2
tool: "prevabs"
base_file: "airfoil_simple.xml.tmp"
model:
md1:
tool: "vabs"
``cs``
Root key of the list of cross-section base designs.

`` - name: "airfoil"``
Name of the cross-section.

`` parameter:``
Root key of the parameter specification.


.. note::

For more details on how to prepare the parameterized base design of a cross-section (``airfoil_simple.xml.tmp``), please see :ref:`section-ivabs_parameterization`.




Define the analysis
^^^^^^^^^^^^^^^^^^^^^^

.. code-block:: yaml
:linenos:
analysis:
steps:
- step: "cs analysis"
type: "cs"
analysis: "h"
output:
- value: ["gj", "eiyy", "eizz"]
.. note::

For the complete list of available keys to get beam properties, see :ref:`section-beam_properties`.



Carry out a single cross-sectional analysis
============================================


This first tutorial will give the instructions to the basic functionalities of the tool.

Suppose that we want to carry out a single cross-sectional analysis.
The task is to carry out a quick cross-sectional analysis of a specific cross-sectional design.
Specifically, in this tutorial, we want to set values to the locations of spar webs and get the torsional and bending stiffness (|gj|, |eiyy|, |eizz|).


Run the example
----------------------

To run the tutorial, start a command line prompt, change directory to this tutorial folder, and run the following command:

.. code-block:: shell
python run.py cs_design_analysis.yml 1
Result can be found in the file ``cs_design_analysis.out``.




Files of this tutorial
-----------------------

Input
^^^^^^

For this and all analysis of |msgd|, there is one top-level yaml file as the main input and a Python script to trigger the analysis.
All others are the supporting files.

.. list-table:: Tutorial input files
:header-rows: 1

* - File
- Description
* - ``cs_design_analysis.yml``
- Main input file
* - ``run.py``
- Python script running the analysis
* - ``airfoil_simple.xml.tmp``
- Cross-sectional design template
* - ``SC1095.dat``
- Airfoil data
* - ``material_database_us_ft.xml``
- Material database

This tutorial mainly focuses on the main input file.
Tutorials on other files will be explained later.

Output
^^^^^^^^

.. list-table:: Tutorial output files
:header-rows: 1

* - File
- Description
* - ``cs_design_analysis.out``
- Analysis result


Main input file specification (``cs_design_analysis.yml``)
------------------------------------------------------------

.. note::

For more details on the syntax of the YAML format, please see :ref:`section-yaml`.



Basic layout of the main input file
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. code-block:: yaml
:linenos:
cs:
# Define cross-sectional designs
analysis:
# Define analysis steps
Define the cross-section
^^^^^^^^^^^^^^^^^^^^^^^^^^

This block specifies the base design of the cross-section that will be analyzed.

.. code-block:: yaml
:linenos:
cs:
- name: "airfoil"
parameter:
a2p1: 0.82
a2p3: 0.58
design:
dim: 2
tool: "prevabs"
base_file: "airfoil_simple.xml.tmp"
model:
md1:
tool: "vabs"
``cs``
Root key of the list of cross-section base designs.

`` - name: "airfoil"``
Name of the cross-section.

`` parameter:``
Root key of the parameter specification.


.. note::

For more details on how to prepare the parameterized base design of a cross-section (``airfoil_simple.xml.tmp``), please see :ref:`section-ivabs_parameterization`.




Define the analysis
^^^^^^^^^^^^^^^^^^^^^^

.. code-block:: yaml
:linenos:
analysis:
steps:
- step: "cs analysis"
type: "cs"
analysis: "h"
output:
- value: ["gj", "eiyy", "eizz"]
.. note::

For the complete list of available keys to get beam properties, see :ref:`section-beam_properties`.



0 comments on commit 194c608

Please sign in to comment.