electric-audiogram

v1.0.0

Published

8 months ago

一个非标准平面坐标系统下的用以表示听力值与频率关系的电测听力图类库

0High
0Medium
0Low

kohito

audiogram 电测听听力检测听力图 electric-audiogram

electro-audiogram 简介

电测听力图是由分贝值与频率数据矩阵构成的平面坐标图，由于频率值的统计是一个非连续性的过程，而每组频率和分贝数据需要与听力标记建立映射关系，因此需要构建一个适用于电测听力图的非标准平面坐标系，市面上如Echarts的数据可视化工具无法直接描述听力数据变化情况，因此electro-audiogram就是用来解决这个问题的工具库，基于此用canvas重新绘制可视化的听力数据描述。

用法

pnpm i electro-audiogram

import ElectroAudiogram from 'electro-audiogram'

// 每次实例化指定一侧耳朵方向
const leftElectroAudiogram = new ElectroAudiogram({
    mountedEl: HTMLCanvasElement,
    earDirection: 'LEFT',
});

const rightElectroAudiogram = new ElectroAudiogram({
    mountedEl: HTMLCanvasElement,
    earDirection: 'RIGHT',
});

/**
 * 当听力数据变化时，调用render则以最新数据重新渲染canvas
 * 若听力数据坐标重叠，marker则向X轴偏移
 */
leftElectroAudiogram.render([
    {
        frequency: 125,
        decibel: 25,
        conductionType: 'BC',
        status: 'COVERED',
    },
    {
        frequency: 250,
        decibel: 65,
        conductionType: 'BC',
        status: 'UNCOVERED',
    },
    {
        frequency: 125,
        decibel: 25,
        conductionType: 'AC',
        status: 'COVERED',
    },
    {
        frequency: 250,
        decibel: 65,
        conductionType: 'AC',
        status: 'UNCOVERED',
    }
]);

详细类型参见类型声明文件

// 实例化参数
interface IAudiogramOptions {
  mountedEl: HTMLCanvasElement,
  earDirection: 'LEFT' | 'RIGHT';
  primaryColor?: string
}

// 数据状态
type PointStatus = 'COVERED' | 'UNCOVERED' | 'COVERED_NO_RESPONSE' | 'UNCOVERED_NO_RESPONSE';

// 分贝值约束
type DecibelValues = 0 | 10 | -10 | 5 | -5 | 15 | 20 | 25 | 30 | 35 | 40 | 45 | 50 | 55 | 60 | 65 | 70 | 75 | 80 | 85 | 90 | 95 | 100 | 105 | 110 | 115 | 120;

// 频率值约束
type FrequencyValues = 125 | 250 | 500 | 1000 | 2000 | 3000 | 4000 | 6000 | 8000 | 10000 | 12000

// 听力数据
type AudiogramData = {
    /**
     * 频率 (Hz)
     */
    frequency: FrequencyValues;
    /**
     * 分贝 (dB)
     */  
    decibel: DecibelValues;
    /**
     * 传导类型，AC气导，BC骨导
     */  
    conductionType: 'AC' | 'BC';
    /**
     * 状态
     */  
    status: PointStatus;
}

vue3使用示例：

<script lang="ts" setup>
import ElectroAudiogram from 'electro-audiogram';

const canvasInstance = ref();

onMounted(() => {
  const electroAudiogram = new ElectroAudiogram({
    mountedEl: canvasInstance.value,
    earDirection: 'RIGHT',
  });

  electroAudiogram.render([
    {
      frequency: 125,
      decibel: 25,
      conductionType: 'BC',
      status: 'COVERED',
    },
    {
      frequency: 250,
      decibel: 65,
      conductionType: 'BC',
      status: 'UNCOVERED',
    },
    {
      frequency: 125,
      decibel: 25,
      conductionType: 'AC',
      status: 'COVERED',
    },
    {
      frequency: 250,
      decibel: 65,
      conductionType: 'AC',
      status: 'UNCOVERED',
    },
  ]);
});
</script>

<template>
  <div>
    <canvas ref="canvasInstance" />
  </div>
</template>

参考资料

《GBZ49-2014职业性噪声聋的诊断》 《GB/T 16403声学测听方法纯音气导和骨导听阈基本测听法》

标准设定

人的听阈范围在0-20000Hz以内，在日常生活中，主要在0-10000Hz内，其中125、250、500、1000、2000、3000、4000、6000、8000、10000、12000这11个频率基本能反应人们的听力状况。
通过气导耳机和骨导振子传声，由此判断人耳在各个频率上恰好能听到的最轻的声音（听阈），绘制成曲线图，在特殊情况下，增加骨导测试进行辅助测试。有时候为单耳测试的准确性（两只耳朵测量值相差较大时），会对另一只耳朵进行掩蔽。每次以5dB为一档逐步加大测试音直至得出反应。