w-mesh-tecplot 1.0.9 → 1.0.11

package/src/convertColumn.mjs

@@ -2,6 +2,19 @@ import get from 'lodash-es/get.js'
 import each from 'lodash-es/each.js'
 
 
+/**
+ * 將柱狀(box)元素陣列轉換為Tecplot brick所需之節點與元素資料
+ *
+ * 各輸入元素以中心點(x、y、z)與長寬高(dx、dy、dz)展開為8個角節點，節點與元素皆帶有材料mat與類型type。
+ *
+ * @param {Array} eles 輸入元素物件陣列，各元素含x、y、z、dx、dy、dz、mat、type
+ * @return {Object} 回傳物件，含nodes(節點物件陣列，各含x、y、z、mat、type)與eles(元素物件陣列，各含nodes節點索引陣列、mat、type)
+ * @example
+ *
+ * let r = convertColumn([{ x: 0, y: 0, z: 0, dx: 1, dy: 1, dz: 1, mat: 1, type: 0 }])
+ * // => { nodes: [...], eles: [...] }
+ *
+ */
 function convertColumn(eles) {
 
     //ns, es

package/src/convertLay.mjs

@@ -0,0 +1,81 @@
+import path from 'path'
+import fs from 'fs'
+import { fileURLToPath } from 'url'
+import each from 'lodash-es/each.js'
+import isestr from 'wsemi/src/isestr.mjs'
+import sep from 'wsemi/src/sep.mjs'
+import parseViewData from './parseViewData.mjs'
+import parseSliceData, { eachSliceValue } from './parseSliceData.mjs'
+
+
+//範本與本模組同層(src/), 以模組位置定位, 不受執行cwd影響
+let __dirname = path.dirname(fileURLToPath(import.meta.url))
+let fpMesh = path.join(__dirname, '_tecplot_simple_mesh.lay.tmp')
+let fpHole = path.join(__dirname, '_tecplot_simple_hole.lay.tmp')
+let fpSlice = path.join(__dirname, '_tecplot_simple_slice.lay.tmp')
+
+/**
+ * 由來源Tecplot的lay套用內建範本，另存為展示用lay
+ *
+ * 視角設定(三軸範圍、旋轉原點、視角位置、角度、視距)由來源lay經parseViewData內部解析後，替換範本內對應佔位符；當type為'slice'時，另由parseSliceData就地移植切片起訖點座標與中間切片數，來源lay缺少者沿用範本預設。
+ *
+ * @param {String} fpInLay 輸入來源Tecplot的lay檔案位置字串，供內部解析視角與切片設定
+ * @param {String} fnInDat 輸入資料集名稱字串，替換範本內{fn}佔位符
+ * @param {String} type 輸入範本類型字串，可選'mesh'、'hole'、'slice'
+ * @param {String} fpOutLay 輸入另存展示用lay之檔案位置字串
+ * @example
+ *
+ * convertLay('./ttt.lay', 'abc', 'mesh', './out_mesh.lay')
+ *
+ */
+let convertLay = (fpInLay, fnInDat, type, fpOutLay) => {
+
+    let c = ''
+    if (type === 'mesh') {
+        c = fs.readFileSync(fpMesh, 'utf8')
+    }
+    else if (type === 'hole') {
+        c = fs.readFileSync(fpHole, 'utf8')
+    }
+    else if (type === 'slice') {
+        c = fs.readFileSync(fpSlice, 'utf8')
+    }
+    else {
+        throw new Error(`invalid type[${type}]`)
+    }
+
+    //視角19鍵由來源lay內部解析(與slice對稱), 併入fn(來源lay給不出的輸出名)後替換範本佔位符
+    let kp = {
+        ...parseViewData(fpInLay),
+        fn: fnInDat,
+    }
+    each(kp, (v, k) => {
+        c = c.replaceAll(`{${k}}`, v)
+    })
+
+    //slice型: 由來源lay就地移植切片起訖點座標與中間切片數
+    //容錯: 走訪範本內每個切片數值, 來源有值就覆寫, 來源缺的沿用範本預設並console.log提醒
+    if (type === 'slice') {
+        let src = parseSliceData(fpInLay)
+        let vs = sep(c, '\n')
+        let miss = []
+        eachSliceValue(vs, (key, k, val) => {
+            if (isestr(src[key])) {
+                vs[k] = vs[k].replace(/=[^\r\n]*/, `= ${src[key]}`) //保留範本縮排與換行, 只換等號後的值
+            }
+            else {
+                miss.push(key)
+            }
+        })
+        if (miss.length > 0) {
+            console.log(`[convertLay] slice提醒: 來源lay[${fpInLay}]缺少下列切片設定, 已沿用範本預設: ${miss.join(', ')}`)
+        }
+        c = vs.join('\n')
+    }
+
+    fs.writeFileSync(fpOutLay, c, 'utf8')
+
+}
+
+
+export default convertLay

package/src/execExportPng.mjs

@@ -11,8 +11,24 @@ import fsRenameFile from 'wsemi/src/fsRenameFile.mjs'
 import fsDeleteFile from 'wsemi/src/fsDeleteFile.mjs'
 
 
+/**
+ * 呼叫Tecplot執行檔執行巨集(*.mcr)，將lay輸出(export)為png圖檔
+ *
+ * 內部產生暫存巨集與暫存png，透過Tecplot批次模式產圖後改名至fpOut，並清除暫存檔；產圖失敗時throw。
+ *
+ * @param {String} fpLay 輸入Tecplot的lay檔案位置字串
+ * @param {String} fpOut 輸入另存png圖檔之檔案位置字串
+ * @param {Object} [opt={}] 輸入設定物件，預設{}
+ * @param {String} [opt.head] 輸入巨集開頭字串，預設'#!MC 1400'
+ * @param {String} [opt.fpExe] 輸入Tecplot執行檔位置字串，預設'C:\\Program Files\\Tecplot\\Tec360 2013R1\\bin\\tec360.exe'
+ * @param {Number} [opt.widthPic=1000] 輸入輸出圖片寬度數字，預設1000
+ * @return {Promise} 回傳Promise，resolve回傳undefined，reject回傳錯誤訊息
+ * @example
+ *
+ * await execExportPng('./ttt.lay', './out.png')
+ *
+ */
 let execExportPng = async(fpLay, fpOut, opt = {}) => {
-    //呼叫Tecplot執行檔, 執行巨集(*.mcr), 藉此輸出(export)圖png
 
     //d
     let head = get(opt, 'head', '')
@@ -38,12 +54,15 @@ let execExportPng = async(fpLay, fpOut, opt = {}) => {
     //fpLay
     fpLay = path.resolve(fpLay)
 
+    //id
+    let id = now2strp()
+
     //fpTempPng
-    let fpTempPng = `./_tecplot_pic_${now2strp()}.png`
+    let fpTempPng = `./_tecplot_pic_${id}.png`
     fpTempPng = path.resolve(fpTempPng)
 
     //fpTempMcr
-    let fpTempMcr = `./_tecplot_export_${now2strp()}.mcr`
+    let fpTempMcr = `./_tecplot_export_${id}.mcr`
     fpTempMcr = path.resolve(fpTempMcr)
 
     if (true) {

package/src/parseSliceData.mjs

@@ -0,0 +1,101 @@
+import fs from 'fs'
+import get from 'lodash-es/get.js'
+import each from 'lodash-es/each.js'
+import sep from 'wsemi/src/sep.mjs'
+
+
+/**
+ * 走訪Tecplot的lay內slice區段之每個可移植數值(切片起訖點座標與中間切片數)，對每個值呼叫回調函數
+ *
+ * @param {Array} vs 輸入lay逐行字串陣列
+ * @param {Function} fun 輸入回調函數，簽章為fun(key, k, val)，key如'SLICE2_START_X'或'SLICE2_NUMINTER'，k為該數值所在行索引，val為trim後字串
+ * @example
+ *
+ * eachSliceValue(vs, (key, k, val) => { ... })
+ *
+ */
+//座標塊結構: keyword在k, { 在k+1, X/Y/Z在k+2/k+3/k+4 (與parseViewData之prXYZ同構)
+let eachSliceValue = (vs, fun) => {
+
+    let g = 0
+    each(vs, (v, k) => {
+
+        //切片群組起始, 記住組號
+        let m = v.match(/^\$!SLICEATTRIBUTES\s+(\d+)/)
+        if (m) {
+            g = parseInt(m[1], 10)
+            return
+        }
+
+        //離開slice區段
+        if (v.indexOf('$!SLICELAYERS') >= 0) {
+            g = 0
+            return
+        }
+        if (g === 0) {
+            return
+        }
+
+        let t = v.trim()
+
+        //三種座標塊(PRIMARY/START/END)
+        let pos = ''
+        if (t === 'PRIMARYPOSITION') {
+            pos = 'PRIMARY'
+        }
+        else if (t === 'STARTPOSITION') {
+            pos = 'START'
+        }
+        else if (t === 'ENDPOSITION') {
+            pos = 'END'
+        }
+        if (pos !== '') {
+            each(['X', 'Y', 'Z'], (ax, i) => {
+                let li = k + 2 + i
+                let lv = get(vs, li, '')
+                if (lv.indexOf(`${ax} = `) >= 0) {
+                    fun(`SLICE${g}_${pos}_${ax}`, li, get(sep(lv, '='), 1, '').trim())
+                }
+            })
+            return
+        }
+
+        //中間切片數
+        if (t.indexOf('NUMINTERMEDIATESLICES = ') === 0) {
+            fun(`SLICE${g}_NUMINTER`, k, get(sep(v, '='), 1, '').trim())
+
+        }
+
+    })
+
+}
+
+
+/**
+ * 解析Tecplot的lay，提取slice切片起訖點座標與中間切片數
+ *
+ * 容錯設計：僅回傳實際解析到的鍵，來源lay未設定者不納入(與parseViewData之嚴格throw不同)。
+ *
+ * @param {String} fpLay 輸入Tecplot的lay檔案位置字串
+ * @return {Object} 回傳切片設定物件，各值為trim後字串，鍵如SLICE2_START_X、SLICE2_NUMINTER
+ * @example
+ *
+ * let kpSlice = parseSliceData('./ttt.lay')
+ * // => { SLICE1_START_X: '251615.668889', ..., SLICE2_NUMINTER: '3' }
+ *
+ */
+let parseSliceData = (fpLay) => {
+    let c = fs.readFileSync(fpLay, 'utf8')
+    let vs = sep(c, '\n')
+    let r = {}
+    eachSliceValue(vs, (key, k, val) => {
+        r[key] = val
+    })
+    return r
+}
+
+
+export {
+    eachSliceValue
+}
+export default parseSliceData

package/src/parseViewData.mjs

@@ -7,8 +7,20 @@ import sep from 'wsemi/src/sep.mjs'
 import strleft from 'wsemi/src/strleft.mjs'
 
 
+/**
+ * 解析Tecplot的lay，提取展示相關之視角與模型設定
+ *
+ * 提取三軸範圍與網格間距(XDETAIL/YDETAIL/ZDETAIL之RANGEMIN、RANGEMAX、GRSPACING)、旋轉原點(ROTATEORIGIN_X/Y/Z)、視角位置(VIEWERPOSITION_X/Y/Z)、視角角度(PSIANGLE、THETAANGLE、ALPHAANGLE)與視距(VIEWWIDTH)共19項；任一欄位非數字即throw。
+ *
+ * @param {String} fpLay 輸入Tecplot的lay檔案位置字串
+ * @return {Object} 回傳視角設定物件，各值為等號後含前導空白之原字串，鍵含XDETAIL_RANGEMIN至VIEWWIDTH共19項
+ * @example
+ *
+ * let kp = parseViewData('./ttt.lay')
+ * // => { XDETAIL_RANGEMIN: ' 159817.886...', ..., VIEWWIDTH: ' 71875.7' }
+ *
+ */
 let parseViewData = (fpLay) => {
-    //解析Tecplot的lay, 提取展示有關之視角與模型設定
 
     let c = fs.readFileSync(fpLay, 'utf8')
     // console.log('c', c)

package/toolg/gDistRollup.mjs

@@ -16,10 +16,14 @@ async function rp() {
         // bNodePolyfill: true,
         // bMinify: false,
         globals: {
+            'path': 'path',
             'fs': 'fs',
+            'url': 'url',
         },
         external: [
+            'path',
             'fs',
+            'url',
         ],
     })
         .catch((err) => {