m4-w-fast 1.0.12 → 1.0.13

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -1,202 +1,205 @@
-# m4文件绘图程序
-
-### 更新说明
-- v1.0.1: 修复了安装在vite环境打包时woker不正常工作的问题
-- v1.0.2: 新增了一个可以单独获取某一个break的等值面方法 `getIsoBandsByLayerBreak(breaks: number[], break: number)`
-  - **注意: 这个方法只用于取单等值面, 如果你需要获取所有等值面, 还是用 `getIsoBandsFast` 或者 `getIsoBandsFastByWorker` 方法**
-- v1.0.3:
-  - 添加了m4文件换行符的兼容
-  - 增加了配置项在解析的时候将开氏度转换为摄氏度 (K -> ℃) (-272.15)
-    - `read.start({ convertTemKtoC: true })`
-- v1.0.4:
-  - 提供了一个 `setParams(params: ParamsConfig, config?: ReadConfig)` 方法, 用于设置动态参数, 而非固定从文件获取数据
-  - 拆解了 `start()` 方法中的 `json: JSONData[]` 拼装, 如果需要json数据, 可以调用 `getJsonData()` 方法获取
-    - **注意: 这里获取到的数据,和`start(config? ReadConfig)`或`setParams(params: ParamsConfig, config?: ReadConfig)`中的config有关**
-  - 扩展了 `ReadConfig` 配置项, 新增:
-    - `plusOffset?: number` 数据偏移量, 默认无偏移
-  - ~~`getIsoBandsFastByWorker()` 和 `clipDataByJson()` 方法新增了 `useCpuCount` 参数, 用于设置`CPU`使用数量, 默认为`navigator.hardwareConcurrency - 4`~~
-- v1.0.5:
-  - `.start()`方法提供了一个Promise.reject的错误回调, 用于捕获文件读取错误
-  - 优化了在少数情况下, 绘图会出现有值但没有被绘制的问题
-- v1.0.6:
-  - 优化`getIsoBandsFast()`的绘图效果, 基于面积排序的结果存在一些未达预期的效果, 后续可能会撤销`getIsoBandsFastByWorker()`方法
-- v1.0.7:
-  - 修复`getIsoBandsFast()`的结果在裁剪时不匹配的问题
-- v1.0.8:
-  - 修复`getIsoBandsFast()`的返回类型兼容问题
-  - 新增`getIsoBandsCanvas(breaks: number[], colors: (number[] | string)[], options?: CanvasOptions)` 用于输出一个 `HTMLCanvasElement` 方便做图片操作
-  - 新增`getIsoBandsCanvasByMap(breaks: number[], colors: (number[] | string)[], map: L.Map, options?: CanvasOptions)` 用于输出一个基于 `Leaflet` 地图的 `HTMLCanvasElement`, 他的区别是实际坐标和地图坐标一致, 而不是标准的等值
-  - ~~新增`buildGridCanvas(options?: CanvasOptions)` 用于输出一个基于数据栅格的 `HTMLCanvasElement`, 只是个格子~~
-  - 新增`updateGridCanvas(points: Point[], updateVal: number)` 用于更新格点数据
-  - 新增 `umd` 版本支持, 可以直接通过 `script` 标签引入使用, 全局注册变量命名为 `M4WFast`
-- v1.0.9: 
-  - 新增`buildGridLineCanvas(options?: CanvasOptions)` 用于输出一个基于数据栅格的 `HTMLCanvasElement`, 只是个格子
-  - 新增`buildGridCanvas(breaks: number[], colors: (number[] | string)[], options?: CanvasOptions): HTMLCanvasElement | null` 用于输出一个基于数据栅格的 `HTMLCanvasElement`, 有填色
-  - 新增`buildGridCanvasClipByJson(breaks: number[], colors: (number[] | string)[], json: FeatureCollection, options?: CanvasOptions): HTMLCanvasElement | null` 用于输出一个基于数据栅格的 `HTMLCanvasElement`, 有填色并裁剪
-- v1.0.10
-  - 修复了 `getIsoBandsCanvas` 方法在`lat格距`为负值时结果不正确的问题
-- v1.0.11
-  - 修复了在 `vite8` 环境下的验证问题, 导出更加严格
-### 类型参照
-> ReadConfig
-
-| 参数 | 说明 | 类型        | 默认值   |
-|----|----|-----------|-------|
-|  convertTemKtoC  |  是否将温度从开氏度转换为摄氏度  | `boolean` | false |
-|  plusOffset  |  数据偏移量  | `number`   | 无 |
-
----
-
-> ParamsConfig
-
-| 参数     | 说明 | 类型         | 默认值 |
-|--------|----|------------|-----|
-| values |  数据值数组  | `number[]` | []  |
-| nx     |  栅格列数  | `number`     | 0   |
-| ny     |  栅格行数  |   `number`         | 0   |
-| minLng       |  最小经度  |    `number`        | 0   |
-|  minLat      |  最小纬度  |     `number`       | 0   |
-|  gjLng      |  经度分辨率  |    `number`        | 0   |
-|  gjLat      |  纬度分辨率  |      `number`      | 0   |
-
----
-
-> JSONData
-
-| 参数     | 说明 | 类型         | 默认值 |
-|---|---|---|---|
-| lng     | 经度  | `number` | 0 |
-| lat     | 纬度  | `number` | 0 |
-| val   | 数据值 | `number` | 0 |
-
-### 使用
-
-1. 安装这个库
-```shell
-npm i m4-w-fast
-```
-
-2. 使用示例
-```vue
-<script lang="ts" setup>
-import * as L from 'leaflet'
-import 'leaflet/dist/leaflet.css'
-import ReadFileM4Fast from 'm4-w-fast'
-
-const file = '' // 这里是你的m4文件路径
-
-const init = async() => ｛
-    const read = new ReadFileM4Fast(file)
-    await read.start()
-    // 此时, 你已经有解析过的数据了
-
-    // 开始计算等值面
-    const break = [] // 这里取决于你的色标分级
-    const isoBands = read.getIsoBandsFast(break)
-
-    // 叠加绘图 leaflet为例
-    L.geoJson(isoBands, {
-        style(feature) {
-            if (!feature) return {}
-            const z = feature.properties.z
-            const rgba = read.getColorFast(z, level, color)
-            return {
-                weight: 3,
-                opacity: 1,
-                color: 'red',
-                stroke: false,  // 如果你需要等值线开启他
-                fillColor: rgba,
-                fillOpacity: 0.5
-            }
-        }
-    }).addTo(map)
-｝
-</script>
-```
-
-3. webWorker使用示例 (worker主要用来裁切文件)
-   - **注意!`getIsoBandsFastByWorker()`即将弃用!, 请使用`getIsoBandsFast()`**
-```vue
-<script lang="ts" setup>
-import * as L from 'leaflet'
-import 'leaflet/dist/leaflet.css'
-import ReadFileM4Fast from 'm4-w-fast'
-import { getIsoWorkerUrl, getIntersectWorkerUrl } from 'm4-w-fast/worker-urls'
-import isoWorkerUrl from 'm4-w-fast/isoBands.worker.js?url'
-import intersectWorkerUrl from 'm4-w-fast/intersect.worker.js?url'
-
-import geojson from './620000.json'
-import type { FeatureCollection } from 'geojson'
-
-const file = '' // 这里是你的m4文件路径
-
-const init = async() => ｛
-    const read = new ReadFileM4Fast(file)
-    await read.start()
-    // 此时, 你已经有解析过的数据了
-
-    // 开始计算等值面
-    const break = [] // 这里取决于你的色标分级
-
-    // 如果数据量实在是大, 可以考虑用他来计算, 但是实测 180w条数据下也没必要用他
-    const isoBands = await read.getIsoBandsFastByWorker(break, isoWorkerUrl)
-
-    // 根据边界裁切文件
-    const intersection = await read.clipDataByJson(isoBands, geojson as FeatureCollection, intersectWorkerUrl)
-
-    // 叠加绘图 leaflet为例
-    L.geoJson(intersection, {
-        style(feature) {
-            if (!feature) return {}
-            const z = feature.properties.z
-            const rgba = read.getColorFast(z, level, color)
-            return {
-                weight: 3,
-                opacity: 1,
-                color: 'red',
-                stroke: false,  // 如果你需要等值线开启他
-                fillColor: rgba,
-                fillOpacity: 0.5
-            }
-        }
-    }).addTo(map)
-｝
-```
-
-3. 获取某一个break的等值面示例
-```typescript
-clearMap()
-const oneIsoBand = read.getIsoBandsByLayerBreak(lLevel.value, level)
-const geo = L.geoJson(oneIsoBand, {
-    style(feature) {
-        if (!feature) return {}
-        const z = feature.properties.z
-        const rgba = read!.getColorFast(z, lLevel.value, lColor.value)
-        return {
-            opacity: 1,
-            stroke: false,
-            fillColor: rgba,
-            fillOpacity: 1
-        }
-    }
-}).addTo(map!)
-
-```
-4. 使用 `setParams` 方法动态设置参数示例
-```typescript
-
-const read = new ReadFileM4Fast()
-read.setParams({
-    values: dataValues,
-    nx: dataNx,
-    ny: dataNy,
-    minLng: dataMinLng,
-    minLat: dataMinLat,
-    gjLng: dataGjLng,
-    gjLat: dataGjLat
-})
-
-```
-
-#### @author: wangrl
+# m4文件绘图程序
+
+### 更新说明
+- v1.0.1: 修复了安装在vite环境打包时woker不正常工作的问题
+- v1.0.2: 新增了一个可以单独获取某一个break的等值面方法 `getIsoBandsByLayerBreak(breaks: number[], break: number)`
+  - **注意: 这个方法只用于取单等值面, 如果你需要获取所有等值面, 还是用 `getIsoBandsFast` 或者 `getIsoBandsFastByWorker` 方法**
+- v1.0.3:
+  - 添加了m4文件换行符的兼容
+  - 增加了配置项在解析的时候将开氏度转换为摄氏度 (K -> ℃) (-272.15)
+    - `read.start({ convertTemKtoC: true })`
+- v1.0.4:
+  - 提供了一个 `setParams(params: ParamsConfig, config?: ReadConfig)` 方法, 用于设置动态参数, 而非固定从文件获取数据
+  - 拆解了 `start()` 方法中的 `json: JSONData[]` 拼装, 如果需要json数据, 可以调用 `getJsonData()` 方法获取
+    - **注意: 这里获取到的数据,和`start(config? ReadConfig)`或`setParams(params: ParamsConfig, config?: ReadConfig)`中的config有关**
+  - 扩展了 `ReadConfig` 配置项, 新增:
+    - `plusOffset?: number` 数据偏移量, 默认无偏移
+  - ~~`getIsoBandsFastByWorker()` 和 `clipDataByJson()` 方法新增了 `useCpuCount` 参数, 用于设置`CPU`使用数量, 默认为`navigator.hardwareConcurrency - 4`~~
+- v1.0.5:
+  - `.start()`方法提供了一个Promise.reject的错误回调, 用于捕获文件读取错误
+  - 优化了在少数情况下, 绘图会出现有值但没有被绘制的问题
+- v1.0.6:
+  - 优化`getIsoBandsFast()`的绘图效果, 基于面积排序的结果存在一些未达预期的效果, 后续可能会撤销`getIsoBandsFastByWorker()`方法
+- v1.0.7:
+  - 修复`getIsoBandsFast()`的结果在裁剪时不匹配的问题
+- v1.0.8:
+  - 修复`getIsoBandsFast()`的返回类型兼容问题
+  - 新增`getIsoBandsCanvas(breaks: number[], colors: (number[] | string)[], options?: CanvasOptions)` 用于输出一个 `HTMLCanvasElement` 方便做图片操作
+  - 新增`getIsoBandsCanvasByMap(breaks: number[], colors: (number[] | string)[], map: L.Map, options?: CanvasOptions)` 用于输出一个基于 `Leaflet` 地图的 `HTMLCanvasElement`, 他的区别是实际坐标和地图坐标一致, 而不是标准的等值
+  - ~~新增`buildGridCanvas(options?: CanvasOptions)` 用于输出一个基于数据栅格的 `HTMLCanvasElement`, 只是个格子~~
+  - 新增`updateGridCanvas(points: Point[], updateVal: number)` 用于更新格点数据
+  - 新增 `umd` 版本支持, 可以直接通过 `script` 标签引入使用, 全局注册变量命名为 `M4WFast`
+- v1.0.9: 
+  - 新增`buildGridLineCanvas(options?: CanvasOptions)` 用于输出一个基于数据栅格的 `HTMLCanvasElement`, 只是个格子
+  - 新增`buildGridCanvas(breaks: number[], colors: (number[] | string)[], options?: CanvasOptions): HTMLCanvasElement | null` 用于输出一个基于数据栅格的 `HTMLCanvasElement`, 有填色
+  - 新增`buildGridCanvasClipByJson(breaks: number[], colors: (number[] | string)[], json: FeatureCollection, options?: CanvasOptions): HTMLCanvasElement | null` 用于输出一个基于数据栅格的 `HTMLCanvasElement`, 有填色并裁剪
+- v1.0.10
+  - 修复了 `getIsoBandsCanvas` 方法在`lat格距`为负值时结果不正确的问题
+- v1.0.11
+  - 修复了在 `vite8` 环境下的验证问题, 导出更加严格
+- v1.0.12
+  - 新增 `getIsoBandsFastByMask(breaks: number[])` 方法, 和`getIsoBandsFast()`方法类似, 区别在于他做了数据挖孔, 可以给图层设置透明度而不影响图层的叠加效果
+  
+### 类型参照
+> ReadConfig
+
+| 参数 | 说明 | 类型        | 默认值   |
+|----|----|-----------|-------|
+|  convertTemKtoC  |  是否将温度从开氏度转换为摄氏度  | `boolean` | false |
+|  plusOffset  |  数据偏移量  | `number`   | 无 |
+
+---
+
+> ParamsConfig
+
+| 参数     | 说明 | 类型         | 默认值 |
+|--------|----|------------|-----|
+| values |  数据值数组  | `number[]` | []  |
+| nx     |  栅格列数  | `number`     | 0   |
+| ny     |  栅格行数  |   `number`         | 0   |
+| minLng       |  最小经度  |    `number`        | 0   |
+|  minLat      |  最小纬度  |     `number`       | 0   |
+|  gjLng      |  经度分辨率  |    `number`        | 0   |
+|  gjLat      |  纬度分辨率  |      `number`      | 0   |
+
+---
+
+> JSONData
+
+| 参数     | 说明 | 类型         | 默认值 |
+|---|---|---|---|
+| lng     | 经度  | `number` | 0 |
+| lat     | 纬度  | `number` | 0 |
+| val   | 数据值 | `number` | 0 |
+
+### 使用
+
+1. 安装这个库
+```shell
+npm i m4-w-fast
+```
+
+2. 使用示例
+```vue
+<script lang="ts" setup>
+import * as L from 'leaflet'
+import 'leaflet/dist/leaflet.css'
+import ReadFileM4Fast from 'm4-w-fast'
+
+const file = '' // 这里是你的m4文件路径
+
+const init = async() => ｛
+    const read = new ReadFileM4Fast(file)
+    await read.start()
+    // 此时, 你已经有解析过的数据了
+
+    // 开始计算等值面
+    const break = [] // 这里取决于你的色标分级
+    const isoBands = read.getIsoBandsFast(break)
+
+    // 叠加绘图 leaflet为例
+    L.geoJson(isoBands, {
+        style(feature) {
+            if (!feature) return {}
+            const z = feature.properties.z
+            const rgba = read.getColorFast(z, level, color)
+            return {
+                weight: 3,
+                opacity: 1,
+                color: 'red',
+                stroke: false,  // 如果你需要等值线开启他
+                fillColor: rgba,
+                fillOpacity: 0.5
+            }
+        }
+    }).addTo(map)
+｝
+</script>
+```
+
+3. webWorker使用示例 (worker主要用来裁切文件)
+   - **注意!`getIsoBandsFastByWorker()`即将弃用!, 请使用`getIsoBandsFast()`**
+```vue
+<script lang="ts" setup>
+import * as L from 'leaflet'
+import 'leaflet/dist/leaflet.css'
+import ReadFileM4Fast from 'm4-w-fast'
+import { getIsoWorkerUrl, getIntersectWorkerUrl } from 'm4-w-fast/worker-urls'
+import isoWorkerUrl from 'm4-w-fast/isoBands.worker.js?url'
+import intersectWorkerUrl from 'm4-w-fast/intersect.worker.js?url'
+
+import geojson from './620000.json'
+import type { FeatureCollection } from 'geojson'
+
+const file = '' // 这里是你的m4文件路径
+
+const init = async() => ｛
+    const read = new ReadFileM4Fast(file)
+    await read.start()
+    // 此时, 你已经有解析过的数据了
+
+    // 开始计算等值面
+    const break = [] // 这里取决于你的色标分级
+
+    // 如果数据量实在是大, 可以考虑用他来计算, 但是实测 180w条数据下也没必要用他
+    const isoBands = await read.getIsoBandsFastByWorker(break, isoWorkerUrl)
+
+    // 根据边界裁切文件
+    const intersection = await read.clipDataByJson(isoBands, geojson as FeatureCollection, intersectWorkerUrl)
+
+    // 叠加绘图 leaflet为例
+    L.geoJson(intersection, {
+        style(feature) {
+            if (!feature) return {}
+            const z = feature.properties.z
+            const rgba = read.getColorFast(z, level, color)
+            return {
+                weight: 3,
+                opacity: 1,
+                color: 'red',
+                stroke: false,  // 如果你需要等值线开启他
+                fillColor: rgba,
+                fillOpacity: 0.5
+            }
+        }
+    }).addTo(map)
+｝
+```
+
+3. 获取某一个break的等值面示例
+```typescript
+clearMap()
+const oneIsoBand = read.getIsoBandsByLayerBreak(lLevel.value, level)
+const geo = L.geoJson(oneIsoBand, {
+    style(feature) {
+        if (!feature) return {}
+        const z = feature.properties.z
+        const rgba = read!.getColorFast(z, lLevel.value, lColor.value)
+        return {
+            opacity: 1,
+            stroke: false,
+            fillColor: rgba,
+            fillOpacity: 1
+        }
+    }
+}).addTo(map!)
+
+```
+4. 使用 `setParams` 方法动态设置参数示例
+```typescript
+
+const read = new ReadFileM4Fast()
+read.setParams({
+    values: dataValues,
+    nx: dataNx,
+    ny: dataNy,
+    minLng: dataMinLng,
+    minLat: dataMinLat,
+    gjLng: dataGjLng,
+    gjLat: dataGjLat
+})
+
+```
+
+#### @author: wangrl
 #### 维护随缘