DTS二次开发文档

Class: FiniteElement

FiniteElement

FiniteElement有限元分析对象，实现对有限元分析对象的操作
一般通过api.finiteElement调用其方法

new FiniteElement()

See:

Extends

Methods

add(data, fn)

添加一个或多个有限元分析对象

Parameters:
Name Type Description
data object | array

有限元分析对象的数据结构，可以是Object类型或者Array类型，对于每一个FiniteElement对象，支持以下属性：

  • id (string) 有限元分析的唯一标识符ID

  • groupId (string) 可选，Group分组

  • userData (string) 可选，用户自定义数据

  • dataPath (string) 必选，包含有限元分析数据的二进制文件路径

  • coordinate (array) 有限元分析位置坐标：[X,Y,Z]，取值示例，数组元素类型：(number)，取值范围：[任意数值]

  • coordinateType (number) 坐标系类型，取值范围：0为Projection类型，1为WGS84类型，2为火星坐标系(GCJ02)，3为百度坐标系(BD09)，默认值：0

  • rotation (array) 有限元分析旋转角度：[Pitch,Yaw,Roll]，数组元素类型：(number)，取值范围：[任意数值]，默认值：[0,0,0]

  • type (number) 有限元分析类型，共12种，类型：整数，取值范围：[0~11]，以下为类型数值对应关系：

    0： u1 沿X轴向空间位移

    1： u2 沿Y轴向空间位移

    2： u3 沿Z轴向空间位移

    3： s11 X轴向的应力，正值为拉应力，负值为压应力

    4： s22 Y轴向的应力，正值为拉应力，负值为压应力

    5： s33 Z轴向的应力，正值为拉应力，负值为压应力

    6： s12 在YZ平面上，沿Y向的剪力

    7： s13 在YZ平面上，沿Z向的剪力

    8： s23 在XZ平面上，沿Z向的剪力

    9： d1 X方向损伤

    10：d2 Y方向损伤

    11：d3 Z方向损伤

  • valueRange (array) 有限元分析结果对应值的范围：[min,max]，数组元素类型：[任意浮点数]

  • characteristicLine (object) 有限元对象的特征线对象，包含以下参数：

    filePath (string) 包含特征线信息的文件路径

    color (Color) 特征线的颜色

  • showLine (boolean) 是否显示等值线，默认值：false

  • showColorLine (boolean) 是否显示等值线颜色，默认值：false

  • contourParams (array) 控制有限元分析对象热力效果，从valueRange的min/max分割而来，二维数组，取值示例：[[min,max],[min,max],[min,max]...]

  • sections (array) 有限元分析对象的各部分设置可见性

    index (number) 待隐藏显示的模型索引

    visible (boolean) 是否可见，默认值：true

  • colors (object) 有限元分析对象的自定义调色板对象，包含颜色渐变控制、无效像素颜色和调色板区间数组

    size (number) 调色板图片尺寸

    gradient (boolean) 是否渐变

    invalidColor (Color) 无效像素点的默认颜色，默认白色

    colorStops (array) 调色板对象数组，每一个对象包含热力值和对应颜色值，结构示例：[{"value":0, "color":[0,0,1,1]}]，每一个调色板对象支持以下属性：


    color (Color) 值对应的调色板颜色

    value (number) 值
fn function

可选的回调函数，请参考二次开发：异步接口调用方式
Example
对象结构示例：

let fe1 = {
        "id": "fe_1",
        "dataPath": "d:/out/",//目录
        "coordinate": [
            12984831,
            4800354.5,
            0
        ],
        "rotation": [
            0,
            0,
            0
        ],
        "type": 0,
        "valueRange": [
            -3,
            3
        ],
        "characteristicLine":{
            "filePath": "d:/aaa.json",
            "color": [1,1,0,1]
        },
        "sections": [
            {
                "index": 1,
                "visible": false
            },
            {
                "index": 2,
                "visible": false
            }
        ],
        "contourParams": [[-3,0],[0,1],[1,3]],//分割valueRange
        "showLine": true,
        "showColorLine": true,
        "colors": {
            "size": 2048,
            "gradient": true,
            "invalidColor": [0, 0, 0, 1],
            "colorStops": [
                {
                    "value": 0,
                    "color": [0, 0, 1, 1]
                },
                {
                    "value": 0.25,
                    "color": [0, 1, 1, 1]
                },
                {
                    "value": 0.5,
                    "color": [0, 1, 0, 1]
                },
                {
                    "value": 0.75,
                    "color": [1, 1, 0, 1]
                },
                {
                    "value": 1,
                    "color": [1, 0, 0, 1]
                }
            ]
        }
    };

clear(fn)

清空场景中所有的有限元分析对象

Parameters:
Name Type Description
fn function

可选的回调函数，请参考二次开发：异步接口调用方式

delete(ids, fn)

删除一个或多个有限元分析对象

Parameters:
Name Type Description
ids string | array

要删除的有限元分析对象ID或者ID数组（可以删除一个或者多个）
fn function

可选的回调函数，请参考二次开发：异步接口调用方式

focus(ids, distance, flyTime, rotation, fn)

自动定位到合适的观察距离

Parameters:
Name Type Description
ids string | array

有限元分析对象的ID或者ID数组
distance number

可选参数，观察点距离目标点（被拍摄物体）的距离，取值范围：[0.01~任意正数]，如果设置为0或者不设置，系统自动计算
flyTime number

可选参数，相机飞行的时间，取值范围：[0~任意正数]，单位：秒，默认值2秒
rotation array

可选参数，相机旋转的欧拉角：[Pitch,Yaw,Roll]，数组元素类型：(number)，取值范围：Pitch[-90~90] Yaw[-180~180] Roll[0]
fn function

可选的回调函数，请参考二次开发：异步接口调用方式

get(ids, fn)

根据有限元分析ID获取有限元分析的详细信息

Parameters:
Name Type Description
ids string | array

要获取的有限元分析对象ID或者ID数组（可以获取一个或者多个）
fn function

可选的回调函数，请参考二次开发：异步接口调用方式
Example
返回FiniteElement的详细信息 属性详情参见add方法参数

{
            "id": "h1",
            "dataPath": "C:/Users/Administrator/out",
            "coordinate": [
                12984831,
                4800354.5,
                0
            ],
            "rotation": [
                0,
                0,
                0
            ],
            "type": 0,
            "valueRange": [
                -0.000003,
                0.000003
            ],
            "colors": "base64..."
        }

hide(ids, fn)

隐藏有限元分析

Parameters:
Name Type Description
ids string | array

有限元分析对象的ID或者ID数组
fn function

可选的回调函数，请参考二次开发：异步接口调用方式

show(ids, fn)

显示有限元分析

Parameters:
Name Type Description
ids string | array

有限元分析对象的ID或者ID数组
fn function

可选的回调函数，请参考二次开发：异步接口调用方式

update(data, fn)

修改一个或多个有限元分析对象

Parameters:
Name Type Description
data object | array

有限元分析对象或对象数组，参考add方法
fn function

可选的回调函数，请参考二次开发：异步接口调用方式

updateBegin()

用于批量多次修改对象的属性

在开始修改之前调用updateBegin，然后可以多次调用setXXX方法，最后调用updateEnd提交修改更新数据
注意：
updateBegin不是异步调用，不需要await，也没有回调函数参数

Inherited From:
Overrides:
Example
fdapi.xxx.updateBegin();
for (let i = 0; i < 1000; i++) {
     fdapi.xxx.setColor(i, Color.Yellow);
} 
fdapi.xxx.updateEnd(function () {
     log('update finished!');
});

updateEnd(fn)

用于批量多次修改对象的属性，与updateBegin配套使用
注意：
updateEnd是异步调用，可以用回调函数也可以await

Parameters:
Name Type Description
fn function

可选的回调函数，请参考二次开发：异步接口调用方式
Inherited From:
Overrides: