excel-codegen 0.9.0__py3-none-any.whl

excel_codegen/examples/nastran/generated/cc_02_LC2.inc

@@ -0,0 +1,8 @@
+SUBCASE 2
+
+SUBTITLE = BEAM SEA
+
+
+LOAD = 1002
+SPC = 1
+

excel_codegen/examples/nastran/generated/cc_03_LC3.inc

@@ -0,0 +1,8 @@
+SUBCASE 3
+LABEL = QTR
+SUBTITLE = QUARTERING SEA
+
+METHOD = 1
+LOAD = 1003
+SPC = 2
+

excel_codegen/examples/nastran/generated/cc_04_COMB4.inc

@@ -0,0 +1,8 @@
+SUBCOM 4
+
+SUBTITLE = COMBINED 1.0 / 1.2 / 1.3
+
+
+
+
+SUBSEQ = 1, 1.2, 1.3

excel_codegen/examples/nastran/generated/cc_05_LC5.inc

@@ -0,0 +1,8 @@
+SUBCASE 5
+
+
+
+
+
+
+

excel_codegen/examples/nastran/generated/cc_summary_01_LC1.md

@@ -0,0 +1 @@
+SUBCASE 1 ｜ SUBTITLE=HEAD SEA ｜ METHOD= ｜ LOAD=1001 ｜ SPC=1 ｜ SUBSEQ=

excel_codegen/examples/nastran/generated/cc_summary_02_LC2.md

@@ -0,0 +1 @@
+SUBCASE 2 ｜ SUBTITLE=BEAM SEA ｜ METHOD= ｜ LOAD=1002 ｜ SPC=1 ｜ SUBSEQ=

excel_codegen/examples/nastran/generated/cc_summary_03_LC3.md

@@ -0,0 +1 @@
+SUBCASE 3 ｜ SUBTITLE=QUARTERING SEA ｜ METHOD=1 ｜ LOAD=1003 ｜ SPC=2 ｜ SUBSEQ=

excel_codegen/examples/nastran/generated/cc_summary_04_COMB4.md

@@ -0,0 +1 @@
+SUBCOM 4 ｜ SUBTITLE=COMBINED 1.0 / 1.2 / 1.3 ｜ METHOD= ｜ LOAD= ｜ SPC= ｜ SUBSEQ=1, 1.2, 1.3

excel_codegen/examples/nastran/generated/cc_summary_05_LC5.md

@@ -0,0 +1 @@
+SUBCASE 5 ｜ SUBTITLE= ｜ METHOD= ｜ LOAD= ｜ SPC= ｜ SUBSEQ=

excel_codegen/examples/nastran/nastran_case_control.yaml

@@ -0,0 +1,141 @@
+version: 1
+
+# =========================================================================== #
+# 示例：生成 NASTRAN 工况控制语句（Case Control）
+#
+# 为什么要用 local_direction: vertical（指南 §19）：
+#   工况控制语句在工程实践里就是"一行一个子工况、一列一条语句"的形态
+#   （SUBCASE / SUBTITLE / LOAD / SPC / SUBSEQ …），通常是从别处（表格、文本、
+#   另一个软件）整块拿到的。竖向的 Local 表可以**直接整块粘贴**，不用逐列转置；
+#   而生成的代码仍然横着排（direction: horizontal），方便并排比较。
+#
+# 引擎用 engine: excel（**公式模式**）：Code 表里写的是 Excel 公式，改 Global / Local
+#   里的参数后**打开 Excel 就重算**，不需要跑任何命令 —— 也可以直接把一列参数粘进去。
+#   代价是模板只能用"占位符 + 单行 {% if %}"（指南 §14.1.1）。
+#
+# 每一条语句都是**可选的**：留空就不输出。
+#   模板里用 `{% if x.value %}` 判断（公式模式的条件必须写 .value），一条语句占一行：
+#   条件不成立时那一格是**空的**（Excel 里就没有这条语句的文本），
+#   所以一行只填 subcase_id 也是合法的，输出就只有一条 `SUBCASE n`。
+#
+#   注意：Excel 里"空语句"是一格空单元格（横向布局下这一行是所有工况共用的，
+#   没法为某个工况单独删掉一整行）。把一列粘到文本编辑器后删掉空行即可：
+#       excel-codegen render -c nastran_case_control.yaml --outdir deck
+#       sed '/^$/d' deck/cc_*.inc > deck/case_control.deck
+#   快照模式（engine: snapshot）能用"把换行写进 if 里面"的办法完全不留空行 ——
+#   见指南 §20.2；这里为了"改 Excel 就改输出"选了公式模式。
+#
+# 关于语句本身（MSC / NX Nastran 的 Case Control 段）：
+#   * `SUBCASE n` 开一个子工况；后面的语句作用于它，直到下一个 SUBCASE / SUBCOM；
+#   * `SUBCOM n` 开一个**组合**子工况：它不重新定义载荷，而是用 `SUBSEQ` 把已经
+#     定义过的子工况按比例线性组合起来（`SUBSEQ = 1, 1.2, 1.3` 表示子工况
+#     1 / 2 / 3 分别按 1.0 / 1.2 / 1.3 加权 —— 具体写法以手头版本的参考手册为准，
+#     所以这里把它当成一段**原样输出的文本**，工具不解释它）；
+#   * `SUBTITLE` / `LABEL` / `METHOD` / `LOAD` / `SPC` / `ANALYSIS` 都是子工况级语句。
+#
+# 本示例只生成"子工况块"这一部分。整份输入文件仍然是：
+#     SOL 101 / CEND / <本示例生成的各子工况块> / BEGIN BULK
+# 前面的执行控制段与后面的 BULK 段不属于 case control，一笔手写即可。
+# =========================================================================== #
+
+excel:
+  output: "nastran_case_control.xlsx"
+  template_sheet: "Template"
+  howto_sheet: "HOWTO"
+  # 一个子工况一行（A 列写 Case 名，第 1 行 B 列起写语句名）
+  local_direction: "vertical"
+  sheets:
+    global: "Global Parameter"
+    local: "Local Parameter"
+    outputs: ["Case Control", "Summary"]
+
+variables:
+  global:
+    - name: analysis
+      description: "ANALYSIS 语句的取值（整份模型共用）；留空则这条语句不输出"
+      # 默认留空：清空 Global 表的这一格就等于"不输出 ANALYSIS"（填 STATICS 才会输出）
+      default: ""
+      type: string
+
+  local:
+    - name: seq
+      description: "排序号：只用来给导出文件排序（建议 01 / 02 …），不进入生成的语句"
+      default: "01"
+      type: string
+    - name: kind
+      description: "这一行的类型：SUBCASE（普通子工况）/ SUBCOM（组合子工况）"
+      default: "SUBCASE"
+      type: string
+      choices: ["SUBCASE", "SUBCOM"]
+    - name: subcase_id
+      description: "子工况编号 [i]（SUBCASE / SUBCOM 后面的整数）"
+      default: 1
+      type: int
+      min: 1
+    - name: label
+      description: "LABEL 语句；留空不输出"
+      default: ""
+      type: string
+    - name: subtitle
+      description: "SUBTITLE 语句；留空不输出"
+      default: ""
+      type: string
+    - name: method
+      description: "METHOD 语句（实特征值提取方法集号）；留空不输出"
+      default: ""
+      type: string
+    - name: load
+      description: "LOAD 语句（静力载荷集号）；留空不输出"
+      default: ""
+      type: string
+    - name: spc
+      description: "SPC 语句（单点约束集号）；留空不输出"
+      default: ""
+      type: string
+    - name: subseq
+      description: "SUBSEQ 语句的内容，原样输出（如 1, 1.2, 1.3）；留空不输出。只有 SUBCOM 用"
+      default: ""
+      type: string
+
+# 组合校验（指南 §3.6）：留空的语义是"不输出"，所以填错地方不会报错、只会悄悄少一条语句
+asserts:
+  - "kind.value != 'SUBCOM' or subseq.value != ''"  # 组合子工况必须给 SUBSEQ，否则这一行没有组合信息
+  - "kind.value != 'SUBCASE' or subseq.value == ''"  # SUBSEQ 只对 SUBCOM 有意义，写在 SUBCASE 行上是笔误
+
+templates:
+  # --------------------------------------------------------------------- 主产物 --
+  # 一个子工况一个 .inc 片段。拼成整段 case control 就是按 seq 顺序连起来
+  # （空语句在文件里是空行，删掉即可）：
+  #     excel-codegen render -c nastran_case_control.yaml --outdir deck
+  #     sed '/^$/d' deck/cc_*.inc > deck/case_control.deck
+  - name: case_control
+    description: "NASTRAN Case Control 子工况块（每个子工况一列，公式模式）"
+    output_sheet: "Case Control"
+    start_cell: "B2"
+    direction: "horizontal"
+    write_case_headers: true
+    engine: "excel"
+    filename: "cc_{{ seq }}_{{ case_name }}.inc"
+    # 一行一条语句 —— 公式模式下每一行编译成一格公式，
+    # 所以 {% if %} 必须和它管的语句写在同一行里（多行 {% if %} 公式模式表达不了）。
+    code: |
+      {{ kind }} {{ subcase_id }}
+      {% if label.value %}LABEL = {{ label }}{% endif %}
+      {% if subtitle.value %}SUBTITLE = {{ subtitle }}{% endif %}
+      {% if analysis.value %}ANALYSIS = {{ analysis }}{% endif %}
+      {% if method.value %}METHOD = {{ method }}{% endif %}
+      {% if load.value %}LOAD = {{ load }}{% endif %}
+      {% if spc.value %}SPC = {{ spc }}{% endif %}
+      {% if subseq.value %}SUBSEQ = {{ subseq }}{% endif %}
+
+  # ----------------------------------------------------------------- 人读的对照表 --
+  - name: cc_summary
+    description: "工况控制语句一览（一行一个子工况，公式模式）"
+    output_sheet: "Summary"
+    start_cell: "B2"
+    direction: "vertical"
+    write_case_headers: true
+    engine: "excel"
+    filename: "cc_summary_{{ seq }}_{{ case_name }}.md"
+    code: |-
+      {{ kind }} {{ subcase_id }} ｜ SUBTITLE={{ subtitle }} ｜ METHOD={{ method }} ｜ LOAD={{ load }} ｜ SPC={{ spc }} ｜ SUBSEQ={{ subseq }}

excel_codegen/examples/nastran/nastran_case_control_render.bat

@@ -0,0 +1,22 @@
+@echo off
+REM ===========================================================================
+REM  由 excel_codegen 生成 —— 改完参数双击本文件即可把结果写回 Output 表。
+REM  重新生成工作簿（init）时会一并覆盖本文件。
+REM ===========================================================================
+cd /d "%~dp0"
+
+where uv >nul 2>nul
+if %errorlevel%==0 (
+  uv run excel-codegen render -c "nastran_case_control.yaml" -x "nastran_case_control.xlsx" --write-excel
+) else (
+  excel-codegen render -c "nastran_case_control.yaml" -x "nastran_case_control.xlsx" --write-excel
+)
+
+echo.
+if errorlevel 1 (
+  echo [失败] 上面有报错信息。常见原因：依赖没装（跑一次 setup.sh / uv sync）、
+  echo        或者 Excel 正开着这个文件（先关掉再试）。
+) else (
+  echo [完成] 回到 Excel 打开「Output」表看结果。
+)
+pause

excel_codegen/examples/nastran/nastran_case_control_render.sh

@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+# ===========================================================================
+#  由 excel_codegen 生成 —— 改完参数跑一次本文件即可把结果写回 Output 表。
+#  重新生成工作簿（init）时会一并覆盖本文件。
+# ===========================================================================
+set -uo pipefail
+cd "$(dirname "$0")"
+
+if command -v uv >/dev/null 2>&1; then
+  uv run excel-codegen render -c "nastran_case_control.yaml" -x "nastran_case_control.xlsx" --write-excel
+else
+  excel-codegen render -c "nastran_case_control.yaml" -x "nastran_case_control.xlsx" --write-excel
+fi
+status=$?
+
+echo
+if [ "$status" -ne 0 ]; then
+  echo "[失败] 上面有报错信息。常见原因：依赖没装（跑一次 ./setup.sh 或 uv sync）、"
+  echo "       或者 Excel / WPS 正开着这个文件（先关掉再试）。"
+else
+  echo "[完成] 回到 Excel 打开「Output」表看结果。"
+fi
+exit "$status"