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) 有限元分析位置坐标,二维数组

  • 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],数组元素类型:[任意浮点数]

  • 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": [
            -0.000003,
            0.000003
        ],
        "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: