Main Input Keywords#

Setting (setting)#

log_level_cmd#

Set the level of logging messages printed to the command line.

  • Optional

  • Type: String

  • Arguments: debug|info|warning|error|critical

  • Default: info

Use the default Python logging levels (case insensitive). debug prints the most information, while critical prints the least.

log_level_file#

Set the level of logging messages printed to the log file.

  • Optional

  • Type: String

  • Arguments: debug|info|warning|error|critical

  • Default: info

Use the default Python logging levels (case insensitive). debug prints the most information, while critical prints the least.

log_file_name#

Set the name of the log file.

  • Optional

  • Type: String

  • Arguments: Any valid file name

  • Default: log.txt

Listing 21 Example#
1setting:
2  log_level_cmd: "info"
3  log_level_file: "debug"
4  log_file_name: "eval.log"
5  data_process_functions_file: "data_proc_funcs"

Structure (structure)#

name#

Name of the structure. Used only in logging messages.

  • Optional

  • Type: String

  • Arguments: Arbitrary

  • Default: structure_0

parameter#

Key-value pairs of the design parameters for the whole structure.

  • Optional

  • Type: Dictionary

  • Arguments: key: value pairs

  • Default: None

Listing 22 Example#
1structure:
2  parameter:
3    param1: "value1"
4    param2: 2
5    param3: 3.0
6    param4: 4e5
7    param5: true  # or on
8    param6: false  # or off

design#

Basic design setup of the structure.

  • Optional

  • Type: Dictionary

Listing 23 Example#
 1structure:
 2  name: "uh60_blade_1"
 3  parameter:
 4    cs_template: 'airfoil_gbox_uni.xml.tmp'
 5    airfoil: 'SC1095.dat'
 6    a2p1: 0.8
 7    a2p3: 0.6
 8    airfoil_point_order: -1
 9    lam_skin: "T300 15k/976_0.0053"
10    lam_cap: "Aluminum 8009_0.01"
11    lam_spar: "T300 15k/976_0.0053"
12    lam_front: "T300 15k/976_0.0053"
13    lam_back: "T300 15k/976_0.0053"
14    ssc_spar: "[-45/0/45/90]"
15  design:
16    type: 'discrete'
17    dim: 1
18    cs_assignment:
19      all: 'main_cs'
20  cs:
21    main_cs:
22      base: 'cs'
23      model: 'md1'

Cross-section library (cs)#

This block contains a list of cross-sectional base designs.

Listing 24 Example#
1cs:
2  - name: "cs_base_design_1"
3    ...
4  - name: "cs_base_design_2"
5    ...

name#

Name of the cross-sectional base design.

  • Required

  • Type: String

  • Arguments: Arbitrary

  • Default: None

parameter#

Key-value pairs of the design parameters for the current CS.

  • Optional

  • Type: Dictionary

  • Arguments: key: value pairs

  • Default: None

design#

Basic design setup of the current CS.

  • Optional

  • Type: Dictionary

tool#

PreVABS command used to create the cross-section.

  • Optional

  • Type: String

  • Default: prevabs

base_file#

File name of the cross-sectional design template.

  • Required

  • Type: String

  • Default: None

Listing 25 Example#
 1cs:
 2- name: "cs"
 3  parameter:
 4    cs_template: 'airfoil_gbox_uni.xml.tmp'
 5    mdb_name: "material_database_us_ft"
 6    rnsm: 0.001
 7    gms: 0.004
 8    mat_nsm: "lead"
 9    mat_fill_front: "Rohacell 70"
10    mat_fill_back: "Plascore PN2-3/16OX3.0"
11    mat_fill_te: "Plascore PN2-3/16OX3.0"
12  design:
13    dim: 2
14    tool: 'prevabs_153_dev'
15    base_file: cs_template
16  model:
17    md1:
18      tool: 'vabs'

Analysis (analysis)#

Listing 26 Example#
1analysis:
2  steps:
3    - step: "step 1"
4      type: "cs"
5      ...
6    - step: "step 2"
7      ...

steps#

Specification of analysis steps.

  • Required (at least one step)

  • Type: List

  • Default: None

step#

Name of the current step.

  • Required

  • Type: String

type#

Type of the current analysis step.

  • Required

  • Type: String

  • Arguments: cs|script

cs defines a cross-sectional analysis step. script defines a custom step using user-provided Python scripts.

Related pages

analysis#

Use under:

analysis:
  steps:
    - step: "..."
      type: "cs"
      analysis: "..."

Specify the cross-sectional analysis type.

  • Required

  • Type: String

  • Arguments: h|fi

file#

Use under:

analysis:
  steps:
    - step: "..."
      type: "script"
      file: "..."

Name of the custom Python script file.

  • Required

  • Type: String

Related pages

function#

Use under:

analysis:
  steps:
    - step: "..."
      type: "script"
      function: "..."

Name of the custom Python function.

  • Required

  • Type: String

Related pages

args#

Use under:

analysis:
  steps:
    - step: "..."
      type: "script"
      args:
        - arg1
        - arg2
        - ...

Extra positional arguments passed to the custom Python function.

  • Optional

  • Type: List

Related pages

kwargs#

Use under:

analysis:
  steps:
    - step: "..."
      type: "script"
      kwargs:
        kw1: arg1
        kw2: arg2
        ...

Extra keyword arguments passed to the custom Python function.

  • Optional

  • Type: Dictionary

Related pages

Listing 27 Example#
 1analysis:
 2  steps:
 3    - step: "cs analysis"
 4      type: 'cs'
 5      analysis: 'h'
 6    - step: "calc diff"
 7      type: "script"
 8      file: 'data_proc_funcs'
 9      function: "dakota_postpro"
10      kwargs:
11        beam_properties: ["gj", "ei22", "ei33"]
12        target: [2.29e3, 3.98e3, 2.44e5]

Design study configuration (study)#

Most of the keywords in this block are the same as those of Dakota. See their documentation for more information.

Related pages:

Listing 28 Example#
 1study:
 2  method:
 3    format: "keyword"
 4    output: "normal"
 5    soga:
 6      max_function_evaluations: 10
 7      population_size: 5
 8      seed: 1027
 9      print_each_pop: true
10  variables:
11    data_form: "compact"
12    data: |
13      a2p1, design, continuous, 0.7:0.9
14      a2p3, design, continuous, 0.5:0.7
15  responses:
16    data_form: "compact"
17    data: |
18      diff_gj,   objective, min, 0.5
19      diff_eiyy, objective, min, 0.8
20      diff_eizz, objective, min, 0.8
21  interface:
22    fork:
23      parameters_file: "input.in"
24      results_file: "output.out"
25      file_save: on
26      work_directory:
27        directory_tag: on
28        directory_save: on
29    required_files:
30      - "design/*"
31      - "scripts/*"