qtc_bazett_calculator.py•4.58 kB
"""
QTc Bazett Calculator
"""
import math
from typing import Dict, Any
from medcalc import (
BaseCalculator,
CalculatorInfo,
Parameter,
ParameterType,
ValidationResult,
CalculationResult,
register_calculator
)
from medcalc.utils import round_number
@register_calculator("qtc_bazett")
class QTcBazettCalculator(BaseCalculator):
"""QTc Bazett计算器实现"""
def get_info(self) -> CalculatorInfo:
return CalculatorInfo(
id=11,
name="QTc Bazett Calculator",
category="cardiology",
description="Calculate corrected QT interval using Bazett formula",
parameters=[
Parameter(
name="qt_interval",
type=ParameterType.NUMERIC,
required=True,
unit="msec",
min_value=200,
max_value=800,
description="QT interval in milliseconds"
),
Parameter(
name="heart_rate",
type=ParameterType.NUMERIC,
required=True,
unit="bpm",
min_value=30,
max_value=250,
description="Heart rate in beats per minute"
)
]
)
def validate_parameters(self, parameters: Dict[str, Any]) -> ValidationResult:
"""验证参数"""
errors = []
# 检查必需参数
if "qt_interval" not in parameters:
errors.append("Missing required parameter: qt_interval")
if "heart_rate" not in parameters:
errors.append("Missing required parameter: heart_rate")
if errors:
return ValidationResult(is_valid=False, errors=errors)
# 获取参数值
qt_interval = parameters["qt_interval"]
heart_rate = parameters["heart_rate"]
# 验证QT间期范围
if not isinstance(qt_interval, (int, float)):
errors.append("QT interval must be a number")
elif qt_interval < 200 or qt_interval > 800:
errors.append("QT interval must be between 200 and 800 msec")
# 验证心率范围
if not isinstance(heart_rate, (int, float)):
errors.append("Heart rate must be a number")
elif heart_rate < 30 or heart_rate > 250:
errors.append("Heart rate must be between 30 and 250 bpm")
return ValidationResult(
is_valid=len(errors) == 0,
errors=errors
)
def calculate(self, parameters: Dict[str, Any]) -> CalculationResult:
"""执行计算"""
qt_interval = parameters["qt_interval"]
heart_rate = parameters["heart_rate"]
# 计算RR间期（秒）
rr_interval_sec = round_number(60 / heart_rate)
# 计算QTc: QTc = QT间期 / √(RR间期)
qtc = round_number(qt_interval / math.sqrt(rr_interval_sec))
# 生成解释
explanation = self._generate_explanation(qt_interval, heart_rate, rr_interval_sec, qtc)
return CalculationResult(
value=qtc,
unit="msec",
explanation=explanation,
metadata={
"qt_interval": qt_interval,
"heart_rate": heart_rate,
"rr_interval": rr_interval_sec,
"formula": "QTc = QT / √(RR interval)"
}
)
def _generate_explanation(self, qt_interval: float, heart_rate: float,
rr_interval_sec: float, qtc: float) -> str:
"""生成计算解释"""
explanation = "The corrected QT interval using the Bazett formula is computed as QTc = QT interval / √(RR interval), "
explanation += "where the QT interval is in msec, and RR interval is given as 60/(heart rate).\n\n"
explanation += f"The patient's heart rate is {heart_rate} beats per minute.\n"
explanation += f"The QT interval is {qt_interval} msec.\n"
explanation += f"The RR interval is computed as 60/(heart rate), and so the RR interval is 60/{heart_rate} = {rr_interval_sec}.\n"
explanation += f"Hence, plugging in these values, we will get {qt_interval}/√({rr_interval_sec}) = {qtc}.\n"
explanation += f"The patient's corrected QT interval (QTc) is {qtc} msec."
return explanation