w-dwdata-tweq 1.0.0

package/docs/WDwdataTweq.mjs.html

@@ -0,0 +1,318 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    
+    <meta charset="utf-8">
+    <title>WDwdataTweq.mjs - Documentation</title>
+    
+    
+    <script src="scripts/prettify/prettify.js"></script>
+    <script src="scripts/prettify/lang-css.js"></script>
+    <!--[if lt IE 9]>
+      <script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
+    <![endif]-->
+    <link type="text/css" rel="stylesheet" href="styles/prettify.css">
+    <link type="text/css" rel="stylesheet" href="styles/jsdoc.css">
+    <script src="scripts/nav.js" defer></script>
+    
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+</head>
+<body>
+
+<input type="checkbox" id="nav-trigger" class="nav-trigger" />
+<label for="nav-trigger" class="navicon-button x">
+  <div class="navicon"></div>
+</label>
+
+<label for="nav-trigger" class="overlay"></label>
+
+<nav >
+    
+    
+    <h2><a href="index.html">Home</a></h2><h3>Global</h3><ul><li><a href="global.html#WDwdataTweq">WDwdataTweq</a></li></ul>
+    
+</nav>
+
+<div id="main">
+    
+    <h1 class="page-title">WDwdataTweq.mjs</h1>
+    
+
+    
+
+
+
+    
+    <section>
+        <article>
+            <pre class="prettyprint source linenums"><code>import fs from 'fs'
+import get from 'lodash-es/get.js'
+import each from 'lodash-es/each.js'
+import reverse from 'lodash-es/reverse.js'
+import isestr from 'wsemi/src/isestr.mjs'
+import isfun from 'wsemi/src/isfun.mjs'
+import fsIsFolder from 'wsemi/src/fsIsFolder.mjs'
+import fsCleanFolder from 'wsemi/src/fsCleanFolder.mjs'
+import fsCreateFolder from 'wsemi/src/fsCreateFolder.mjs'
+import fsDeleteFolder from 'wsemi/src/fsDeleteFolder.mjs'
+import fsTreeFolder from 'wsemi/src/fsTreeFolder.mjs'
+import WDwdataBuilder from 'w-dwdata-builder/src/WDwdataBuilder.mjs'
+import downloadEqs from './downloadEqs.mjs'
+import parseData from './parseData.mjs'
+import downloadPics from './downloadPics.mjs'
+import cropPic from './cropPic.mjs'
+
+
+/**
+ * 下載台灣氣象署地震資料
+ *
+ * @param {Integer} yearStart 輸入數據開始年整數
+ * @param {Integer} yearEnd 輸入數據結束年整數
+ * @param {Object} [opt={}] 輸入設定物件，預設{}
+ * @param {String} [opt.keyId] 輸入各筆數據之主鍵字串，預設keyId
+ * @param {String} [opt.fdDwAttime] 輸入當前下載數據資料夾字串，預設'./_dwAttime'
+ * @param {String} [opt.fdDwCurrent] 輸入已下載數據資料夾字串，預設'./_dwCurrent'
+ * @param {String} [opt.fdResult] 輸入已下載數據所連動生成數據資料夾字串，預設'./_result'
+ * @param {String} [opt.fdTaskCpSrc] 輸入任務狀態之來源端資料夾字串，預設'./_taskCpSrc'
+ * @param {Function} [opt.funDownload] 輸入自定義下載函數，回傳資料陣列
+ * @param {Function} [opt.funGetCurrent] 輸入自定義取得當前資料函數，回傳資料陣列
+ * @param {Function} [opt.funAdd] 輸入當有新資料時，需要連動處理之函數
+ * @param {Function} [opt.funModify] 輸入當有資料需更新時，需要連動處理之函數
+ * @param {Function} [opt.funRemove] 輸入當有資料需刪除時，需要連動處理之函數
+ * @returns {Object} 回傳事件物件，可呼叫函數on監聽change事件
+ * @example
+ *
+ * import WDwdataTweq from './src/WDwdataTweq.mjs'
+ *
+ * let yearStart = 2022
+ * let yearEnd = 2022
+ * let opt = {}
+ * let ev = await WDwdataTweq(yearStart, yearEnd, opt)
+ *     .catch((err) => {
+ *         console.log(err)
+ *     })
+ * ev.on('change', (msg) => {
+ *     delete msg.type
+ *     console.log('change', msg)
+ * })
+ * // change { event: 'start', msg: 'running...' }
+ * // change { event: 'proc-callfun-download', msg: 'start...' }
+ * // change { event: 'proc-callfun-download', msg: 'done' }
+ * // change { event: 'proc-callfun-getCurrent', msg: 'start...' }
+ * // change { event: 'proc-callfun-getCurrent', msg: 'done' }
+ * // change { event: 'compare', msg: 'start...' }
+ * // change { event: 'compare', msg: 'done' }
+ * // change { event: 'proc-add-callfun-add', id: '111001', msg: 'start...' }
+ * // change { event: 'proc-add-callfun-add', id: '111001', msg: 'done' }
+ * // change { event: 'proc-add-callfun-add', id: '111002', msg: 'start...' }
+ * // change { event: 'proc-add-callfun-add', id: '111002', msg: 'done' }
+ * // ...
+ *
+ */
+let WDwdataTweq = async(yearStart, yearEnd, opt = {}) => {
+
+    //keyId
+    let keyId = get(opt, 'keyId')
+    if (!isestr(keyId)) {
+        keyId = `id`
+    }
+
+    //fdDwAttime
+    let fdDwAttime = get(opt, 'fdDwAttime')
+    if (!isestr(fdDwAttime)) {
+        fdDwAttime = `./_dwAttime`
+    }
+    if (!fsIsFolder(fdDwAttime)) {
+        fsCreateFolder(fdDwAttime)
+    }
+
+    //fdDwCurrent
+    let fdDwCurrent = get(opt, 'fdDwCurrent')
+    if (!isestr(fdDwCurrent)) {
+        fdDwCurrent = `./_dwCurrent`
+    }
+    if (!fsIsFolder(fdDwCurrent)) {
+        fsCreateFolder(fdDwCurrent)
+    }
+
+    //fdResult
+    let fdResult = get(opt, 'fdResult')
+    if (!isestr(fdResult)) {
+        fdResult = './_result'
+    }
+    if (!fsIsFolder(fdResult)) {
+        fsCreateFolder(fdResult)
+    }
+
+    //fdTaskCpSrc
+    let fdTaskCpSrc = get(opt, 'fdTaskCpSrc')
+    if (!isestr(fdTaskCpSrc)) {
+        fdTaskCpSrc = './_taskCpSrc'
+    }
+    if (!fsIsFolder(fdTaskCpSrc)) {
+        fsCreateFolder(fdTaskCpSrc)
+    }
+
+    //funDownload
+    let funDownload = get(opt, 'funDownload')
+
+    //funGetCurrent
+    let funGetCurrent = get(opt, 'funGetCurrent')
+
+    //funAdd
+    let funAdd = get(opt, 'funAdd')
+
+    //funModify
+    let funModify = get(opt, 'funModify')
+
+    //funRemove
+    let funRemove = get(opt, 'funRemove')
+
+    //funDownloadDef
+    let funDownloadDef = async() => {
+
+        //downloadEqs
+        let v = await downloadEqs(yearStart, yearEnd)
+        // console.log('downloadEqs', v)
+
+        //parseData
+        let eqs = parseData(v)
+        // console.log('eqsAtt', eqsAtt, size(eqsAtt))
+
+        //reverse
+        eqs = reverse(eqs)
+
+        each(eqs, (v) => {
+
+            let fp = `${fdDwAttime}/${v[keyId]}.json`
+
+            fs.writeFileSync(fp, JSON.stringify(v), 'utf8')
+
+        })
+
+        return eqs
+    }
+    if (!isfun(funDownload)) {
+        funDownload = funDownloadDef
+    }
+
+    //funGetCurrentDef
+    let funGetCurrentDef = async() => {
+
+        //vfps
+        let vfps = fsTreeFolder(fdDwCurrent, 1)
+        // console.log('vfps', vfps)
+
+        //eqs
+        let eqs = []
+        each(vfps, (v) => {
+
+            let j = fs.readFileSync(v.path, 'utf8')
+            let eq = JSON.parse(j)
+
+            eqs.push(eq)
+
+        })
+
+        return eqs
+    }
+    if (!isfun(funGetCurrent)) {
+        funGetCurrent = funGetCurrentDef
+    }
+
+    //funRemoveDef
+    let funRemoveDef = async(v) => {
+
+        let fd = `${fdResult}/${v[keyId]}`
+
+        if (fsIsFolder(fd)) {
+            fsDeleteFolder(fd)
+        }
+
+    }
+    if (!isfun(funRemove)) {
+        funRemove = funRemoveDef
+    }
+
+    //funAddDef
+    let funAddDef = async(v) => {
+
+        let fd = `${fdResult}/${v[keyId]}`
+
+        if (fsIsFolder(fd)) {
+            fsCleanFolder(fd)
+        }
+
+        await downloadPics(fd, v)
+
+        let fnIn = 'picEqReport.gif'
+        let fpIn = `${fd}/${fnIn}`
+        let fnOut = 'picEqIntensityList.gif'
+        let fpOut = `${fd}/${fnOut}`
+        await cropPic(fpIn, fpOut, 364, 199, 276, 204)
+
+    }
+    if (!isfun(funAdd)) {
+        funAdd = funAddDef
+    }
+
+    //funModifyDef
+    let funModifyDef = async(v) => {
+
+        let fd = `${fdResult}/${v[keyId]}`
+
+        if (fsIsFolder(fd)) {
+            fsCleanFolder(fd)
+        }
+
+        await downloadPics(fd, v)
+
+    }
+    if (!isfun(funModify)) {
+        funModify = funModifyDef
+    }
+
+    //WDwdataBuilder
+    let optBdr = {
+        fdDwAttime,
+        fdDwCurrent,
+        fdResult,
+        fdTaskCpSrc,
+        funDownload,
+        funGetCurrent,
+        funRemove,
+        funAdd,
+        funModify,
+    }
+    let ev = await WDwdataBuilder(optBdr)
+
+    return ev
+}
+
+
+export default WDwdataTweq
+</code></pre>
+        </article>
+    </section>
+
+
+
+
+    
+    
+</div>
+
+<br class="clear">
+
+<footer>
+    Documentation generated by <a href="https://github.com/jsdoc3/jsdoc">JSDoc 4.0.4</a> on Sat Aug 23 2025 22:29:56 GMT+0800 (台北標準時間) using the <a href="https://github.com/clenemt/docdash">docdash</a> theme.
+</footer>
+
+<script>prettyPrint();</script>
+<script src="scripts/polyfill.js"></script>
+<script src="scripts/linenumber.js"></script>
+
+
+
+</body>
+</html>