ocs-calculators 0.1.0 → 0.1.2

package/dist/dropper/index.d.cts

@@ -0,0 +1,84 @@
+import { C as CalculatorMeta } from '../types-C2OanO8N.cjs';
+
+declare const dropperMeta: CalculatorMeta;
+
+/** 悬挂类型 */
+type SuspensionType = 'simple' | 'elastic';
+interface DropperInput {
+    /** 悬挂类型。弹性链形须同时提供 messenger 参数 */
+    readonly suspension: SuspensionType;
+    /** 跨距 L，m */
+    readonly spanM: number;
+    /** 接触线张力 T_c，kN */
+    readonly contactTensionKN: number;
+    /** 结构高度 H，m */
+    readonly structureHeightM: number;
+    /** 接触线单位荷载 q_c，kN/m */
+    readonly contactLoadKNPerM: number;
+    /** 吊弦间距 d，m，须能整除跨距 */
+    readonly dropperSpacingM: number;
+    /**
+     * 承力索参数。弹性链形悬挂（'elastic'）必填，
+     * 简单链形悬挂传 null 或不传。
+     */
+    readonly messenger?: {
+        /** 承力索张力 T_m，kN */
+        readonly tensionKN: number;
+        /** 承力索单位荷载 q_m，kN/m */
+        readonly loadKNPerM: number;
+    } | null;
+}
+/** 单个吊弦点的计算结果 */
+interface DropperPoint {
+    /** 序号 i（0 为起始端） */
+    readonly index: number;
+    /** 距起始端的距离 x，m */
+    readonly positionM: number;
+    /** 接触线弛度 f_c(x)，m */
+    readonly contactSagM: number;
+    /** 承力索弛度 f_m(x)，m（简单链形恒为 0） */
+    readonly messengerSagM: number;
+    /** 吊弦长度 l，m */
+    readonly dropperLengthM: number;
+}
+interface DropperResult {
+    readonly points: readonly DropperPoint[];
+    /** 跨中最大弛度 f_max，m */
+    readonly maxSagM: number;
+    /** 最短吊弦长度，m（位于跨中） */
+    readonly shortestDropperM: number;
+    /** 吊弦数量（含两端） */
+    readonly count: number;
+}
+/**
+ * 抛物线弛度：f(x) = q·x·(L−x) / (2·T)
+ *
+ * 对接触线和承力索通用，区别只在传哪一组 q / T。
+ *
+ * @param xM 距起始端距离，m
+ * @param spanM 跨距 L，m
+ * @param loadKNPerM 单位荷载 q，kN/m
+ * @param tensionKN 张力 T，kN
+ * @returns 该点弛度，m
+ */
+declare function parabolaSagM(xM: number, spanM: number, loadKNPerM: number, tensionKN: number): number;
+/**
+ * 跨中最大弛度：f_max = q·L² / (8·T)
+ */
+declare function maxParabolaSagM(spanM: number, loadKNPerM: number, tensionKN: number): number;
+/**
+ * 生成吊弦点位（含两端）。
+ * @param spanM 跨距 L，m
+ * @param spacingM 吊弦间距 d，m，须能整除跨距
+ * @returns 各点位距起始端的距离，m
+ */
+declare function dropperPositionsM(spanM: number, spacingM: number): number[];
+/**
+ * 计算整跨各吊弦长度。
+ *
+ * 简单链形：l_i = H − f_c(x_i)
+ * 弹性链形：l_i = H − f_c(x_i) + f_m(x_i)
+ */
+declare function dropperLengths(input: DropperInput): DropperResult;
+
+export { type DropperInput, type DropperPoint, type DropperResult, type SuspensionType, dropperLengths, dropperMeta, dropperPositionsM, maxParabolaSagM, parabolaSagM };

package/dist/dropper/index.d.ts

@@ -0,0 +1,84 @@
+import { C as CalculatorMeta } from '../types-C2OanO8N.js';
+
+declare const dropperMeta: CalculatorMeta;
+
+/** 悬挂类型 */
+type SuspensionType = 'simple' | 'elastic';
+interface DropperInput {
+    /** 悬挂类型。弹性链形须同时提供 messenger 参数 */
+    readonly suspension: SuspensionType;
+    /** 跨距 L，m */
+    readonly spanM: number;
+    /** 接触线张力 T_c，kN */
+    readonly contactTensionKN: number;
+    /** 结构高度 H，m */
+    readonly structureHeightM: number;
+    /** 接触线单位荷载 q_c，kN/m */
+    readonly contactLoadKNPerM: number;
+    /** 吊弦间距 d，m，须能整除跨距 */
+    readonly dropperSpacingM: number;
+    /**
+     * 承力索参数。弹性链形悬挂（'elastic'）必填，
+     * 简单链形悬挂传 null 或不传。
+     */
+    readonly messenger?: {
+        /** 承力索张力 T_m，kN */
+        readonly tensionKN: number;
+        /** 承力索单位荷载 q_m，kN/m */
+        readonly loadKNPerM: number;
+    } | null;
+}
+/** 单个吊弦点的计算结果 */
+interface DropperPoint {
+    /** 序号 i（0 为起始端） */
+    readonly index: number;
+    /** 距起始端的距离 x，m */
+    readonly positionM: number;
+    /** 接触线弛度 f_c(x)，m */
+    readonly contactSagM: number;
+    /** 承力索弛度 f_m(x)，m（简单链形恒为 0） */
+    readonly messengerSagM: number;
+    /** 吊弦长度 l，m */
+    readonly dropperLengthM: number;
+}
+interface DropperResult {
+    readonly points: readonly DropperPoint[];
+    /** 跨中最大弛度 f_max，m */
+    readonly maxSagM: number;
+    /** 最短吊弦长度，m（位于跨中） */
+    readonly shortestDropperM: number;
+    /** 吊弦数量（含两端） */
+    readonly count: number;
+}
+/**
+ * 抛物线弛度：f(x) = q·x·(L−x) / (2·T)
+ *
+ * 对接触线和承力索通用，区别只在传哪一组 q / T。
+ *
+ * @param xM 距起始端距离，m
+ * @param spanM 跨距 L，m
+ * @param loadKNPerM 单位荷载 q，kN/m
+ * @param tensionKN 张力 T，kN
+ * @returns 该点弛度，m
+ */
+declare function parabolaSagM(xM: number, spanM: number, loadKNPerM: number, tensionKN: number): number;
+/**
+ * 跨中最大弛度：f_max = q·L² / (8·T)
+ */
+declare function maxParabolaSagM(spanM: number, loadKNPerM: number, tensionKN: number): number;
+/**
+ * 生成吊弦点位（含两端）。
+ * @param spanM 跨距 L，m
+ * @param spacingM 吊弦间距 d，m，须能整除跨距
+ * @returns 各点位距起始端的距离，m
+ */
+declare function dropperPositionsM(spanM: number, spacingM: number): number[];
+/**
+ * 计算整跨各吊弦长度。
+ *
+ * 简单链形：l_i = H − f_c(x_i)
+ * 弹性链形：l_i = H − f_c(x_i) + f_m(x_i)
+ */
+declare function dropperLengths(input: DropperInput): DropperResult;
+
+export { type DropperInput, type DropperPoint, type DropperResult, type SuspensionType, dropperLengths, dropperMeta, dropperPositionsM, maxParabolaSagM, parabolaSagM };

package/dist/dropper/index.js

@@ -0,0 +1,15 @@
+import {
+  dropperLengths,
+  dropperMeta,
+  dropperPositionsM,
+  maxParabolaSagM,
+  parabolaSagM
+} from "../chunk-UO2PHBC3.js";
+export {
+  dropperLengths,
+  dropperMeta,
+  dropperPositionsM,
+  maxParabolaSagM,
+  parabolaSagM
+};
+//# sourceMappingURL=index.js.map

package/dist/dropper/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/force/index.cjs

@@ -0,0 +1,17 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+
+
+var _chunkRPKDEFSJcjs = require('../chunk-RPKDEFSJ.cjs');
+
+
+
+
+
+
+
+exports.REF_TARGET_COEFF = _chunkRPKDEFSJcjs.REF_TARGET_COEFF; exports.REF_TARGET_OFFSET_N = _chunkRPKDEFSJcjs.REF_TARGET_OFFSET_N; exports.assessContactForce = _chunkRPKDEFSJcjs.assessContactForce; exports.forceMeta = _chunkRPKDEFSJcjs.forceMeta; exports.referenceTargetForceN = _chunkRPKDEFSJcjs.referenceTargetForceN; exports.statisticalForcesN = _chunkRPKDEFSJcjs.statisticalForcesN;
+//# sourceMappingURL=index.cjs.map

package/dist/force/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/ocs-calculators/ocs-calculators/dist/force/index.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACA;AACF,yDAA8B;AAC9B;AACE;AACA;AACA;AACA;AACA;AACA;AACF,mYAAC","file":"/home/runner/work/ocs-calculators/ocs-calculators/dist/force/index.cjs"}

package/dist/force/index.d.cts

@@ -0,0 +1,69 @@
+import { C as CalculatorMeta } from '../types-C2OanO8N.cjs';
+
+declare const forceMeta: CalculatorMeta;
+
+/** 供电制式，决定参考目标力 Fref 的常数项 */
+type PowerSystem = 'ac' | 'dc3kv' | 'dc15kv';
+/** 限值判定结果 */
+type LimitVerdict = 'pass' | 'fail' | 'not-assessed';
+/** Fref = 0.00097·v² + offset，offset 按供电制式取值 */
+declare const REF_TARGET_COEFF = 0.00097;
+/** 参考目标力常数项，N。AC 引自 EN 50367 表6，DC 引自 TSI ENE 2011/274/EU */
+declare const REF_TARGET_OFFSET_N: Record<PowerSystem, number>;
+interface ContactForceInput {
+    /** 平均接触力 Fm，N（同一 C1 检测区段统计均值） */
+    readonly meanForceN: number;
+    /** 标准差 σ，N（同一区段统计标准差） */
+    readonly stdDevN: number;
+    /** 速度 v，km/h。传 null 则不输出参考目标力 */
+    readonly speedKmH: number | null;
+    /** 验收上限 Fmax,lim，N。传 null 则不判定 */
+    readonly maxLimitN: number | null;
+    /** 验收下限 Fmin,lim，N。传 null 则不判定 */
+    readonly minLimitN: number | null;
+    /** 供电制式。缺省为交流 */
+    readonly system?: PowerSystem;
+}
+interface ContactForceResult {
+    readonly meanForceN: number;
+    readonly stdDevN: number;
+    /** 统计最大力 Fmax = Fm + 3σ，N */
+    readonly maxForceN: number;
+    /** 统计最小力 Fmin = Fm − 3σ，N */
+    readonly minForceN: number;
+    /** 参考目标力 Fref，N。未提供速度时为 null */
+    readonly referenceTargetN: number | null;
+    /** 均值对参考目标的偏差 Fm − Fref，N。未提供速度时为 null */
+    readonly meanDeviationN: number | null;
+    /** 上限判定 */
+    readonly maxVerdict: LimitVerdict;
+    /** 下限判定 */
+    readonly minVerdict: LimitVerdict;
+}
+/**
+ * 参考目标力 Fref，N。
+ *
+ * Fref = 0.00097·v² + offset
+ *
+ * @param speedKmH 速度 v，km/h
+ * @param system 供电制式，缺省 'ac'
+ * @returns 参考目标力，N
+ */
+declare function referenceTargetForceN(speedKmH: number, system?: PowerSystem): number;
+/**
+ * 统计极值：Fmax = Fm + 3σ，Fmin = Fm − 3σ。
+ *
+ * @returns 统计最大力与最小力，N
+ */
+declare function statisticalForcesN(meanForceN: number, stdDevN: number): {
+    readonly maxN: number;
+    readonly minN: number;
+};
+/**
+ * 弓网接触力统计评价（EN 50367 框架）。
+ *
+ * 上下限传 null 表示该侧不参与判定，对应判定结果为 'not-assessed'。
+ */
+declare function assessContactForce(input: ContactForceInput): ContactForceResult;
+
+export { type ContactForceInput, type ContactForceResult, type LimitVerdict, type PowerSystem, REF_TARGET_COEFF, REF_TARGET_OFFSET_N, assessContactForce, forceMeta, referenceTargetForceN, statisticalForcesN };

package/dist/force/index.d.ts

@@ -0,0 +1,69 @@
+import { C as CalculatorMeta } from '../types-C2OanO8N.js';
+
+declare const forceMeta: CalculatorMeta;
+
+/** 供电制式，决定参考目标力 Fref 的常数项 */
+type PowerSystem = 'ac' | 'dc3kv' | 'dc15kv';
+/** 限值判定结果 */
+type LimitVerdict = 'pass' | 'fail' | 'not-assessed';
+/** Fref = 0.00097·v² + offset，offset 按供电制式取值 */
+declare const REF_TARGET_COEFF = 0.00097;
+/** 参考目标力常数项，N。AC 引自 EN 50367 表6，DC 引自 TSI ENE 2011/274/EU */
+declare const REF_TARGET_OFFSET_N: Record<PowerSystem, number>;
+interface ContactForceInput {
+    /** 平均接触力 Fm，N（同一 C1 检测区段统计均值） */
+    readonly meanForceN: number;
+    /** 标准差 σ，N（同一区段统计标准差） */
+    readonly stdDevN: number;
+    /** 速度 v，km/h。传 null 则不输出参考目标力 */
+    readonly speedKmH: number | null;
+    /** 验收上限 Fmax,lim，N。传 null 则不判定 */
+    readonly maxLimitN: number | null;
+    /** 验收下限 Fmin,lim，N。传 null 则不判定 */
+    readonly minLimitN: number | null;
+    /** 供电制式。缺省为交流 */
+    readonly system?: PowerSystem;
+}
+interface ContactForceResult {
+    readonly meanForceN: number;
+    readonly stdDevN: number;
+    /** 统计最大力 Fmax = Fm + 3σ，N */
+    readonly maxForceN: number;
+    /** 统计最小力 Fmin = Fm − 3σ，N */
+    readonly minForceN: number;
+    /** 参考目标力 Fref，N。未提供速度时为 null */
+    readonly referenceTargetN: number | null;
+    /** 均值对参考目标的偏差 Fm − Fref，N。未提供速度时为 null */
+    readonly meanDeviationN: number | null;
+    /** 上限判定 */
+    readonly maxVerdict: LimitVerdict;
+    /** 下限判定 */
+    readonly minVerdict: LimitVerdict;
+}
+/**
+ * 参考目标力 Fref，N。
+ *
+ * Fref = 0.00097·v² + offset
+ *
+ * @param speedKmH 速度 v，km/h
+ * @param system 供电制式，缺省 'ac'
+ * @returns 参考目标力，N
+ */
+declare function referenceTargetForceN(speedKmH: number, system?: PowerSystem): number;
+/**
+ * 统计极值：Fmax = Fm + 3σ，Fmin = Fm − 3σ。
+ *
+ * @returns 统计最大力与最小力，N
+ */
+declare function statisticalForcesN(meanForceN: number, stdDevN: number): {
+    readonly maxN: number;
+    readonly minN: number;
+};
+/**
+ * 弓网接触力统计评价（EN 50367 框架）。
+ *
+ * 上下限传 null 表示该侧不参与判定，对应判定结果为 'not-assessed'。
+ */
+declare function assessContactForce(input: ContactForceInput): ContactForceResult;
+
+export { type ContactForceInput, type ContactForceResult, type LimitVerdict, type PowerSystem, REF_TARGET_COEFF, REF_TARGET_OFFSET_N, assessContactForce, forceMeta, referenceTargetForceN, statisticalForcesN };

package/dist/force/index.js

@@ -0,0 +1,17 @@
+import {
+  REF_TARGET_COEFF,
+  REF_TARGET_OFFSET_N,
+  assessContactForce,
+  forceMeta,
+  referenceTargetForceN,
+  statisticalForcesN
+} from "../chunk-WPMKM6NL.js";
+export {
+  REF_TARGET_COEFF,
+  REF_TARGET_OFFSET_N,
+  assessContactForce,
+  forceMeta,
+  referenceTargetForceN,
+  statisticalForcesN
+};
+//# sourceMappingURL=index.js.map

package/dist/force/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/icing/index.cjs

@@ -0,0 +1,9 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+var _chunkP6KUGPHDcjs = require('../chunk-P6KUGPHD.cjs');
+
+
+
+exports.icingCheck = _chunkP6KUGPHDcjs.icingCheck; exports.icingMeta = _chunkP6KUGPHDcjs.icingMeta;
+//# sourceMappingURL=index.cjs.map

package/dist/icing/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/ocs-calculators/ocs-calculators/dist/icing/index.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACF,yDAA8B;AAC9B;AACE;AACA;AACF,mGAAC","file":"/home/runner/work/ocs-calculators/ocs-calculators/dist/icing/index.cjs"}

package/dist/icing/index.d.cts

@@ -0,0 +1,43 @@
+import { C as CalculatorMeta } from '../types-C2OanO8N.cjs';
+
+declare const icingMeta: CalculatorMeta;
+
+interface IcingCheckInput {
+    /** 线索直径 d，m */
+    readonly wireDiameterM: number;
+    /** 覆冰厚度 b，m。传 0 表示无冰 */
+    readonly iceThicknessM: number;
+    /** 线索张力 T，N */
+    readonly tensionN: number;
+    /** 跨距 l，m */
+    readonly spanM: number;
+    /** 线索自重 g_self，N/m */
+    readonly selfWeightNPerM: number;
+    /** 冰密度 ρ_ice，kg/m³。缺省 900 */
+    readonly iceDensityKgPerM3?: number;
+}
+interface IcingCheckResult {
+    /** 单位长度冰重 g_ice，N/m */
+    readonly iceLoadNPerM: number;
+    /** 覆冰后总垂直荷载 g_total，N/m */
+    readonly totalLoadNPerM: number;
+    /** 无冰弛度 f₀，m */
+    readonly sagNoIceM: number;
+    /** 覆冰弛度 f_ice，m */
+    readonly sagWithIceM: number;
+    /** 弛度增幅，% */
+    readonly growthPercent: number;
+    /** 冰重是否超过线索自重（重覆冰判据） */
+    readonly heavy: boolean;
+}
+/**
+ * 覆冰综合校核。
+ *
+ * 给出覆冰后的总垂直荷载、弛度及增幅；冰重超过线索自重时 `heavy` 为真。
+ *
+ * ⚠️ 弛度按抛物线近似，且**未与张力-温度状态方程耦合** —— 覆冰引起的
+ * 张力变化未计入，大覆冰工况偏于乐观。
+ */
+declare function icingCheck(input: IcingCheckInput): IcingCheckResult;
+
+export { type IcingCheckInput, type IcingCheckResult, icingCheck, icingMeta };

package/dist/icing/index.d.ts

@@ -0,0 +1,43 @@
+import { C as CalculatorMeta } from '../types-C2OanO8N.js';
+
+declare const icingMeta: CalculatorMeta;
+
+interface IcingCheckInput {
+    /** 线索直径 d，m */
+    readonly wireDiameterM: number;
+    /** 覆冰厚度 b，m。传 0 表示无冰 */
+    readonly iceThicknessM: number;
+    /** 线索张力 T，N */
+    readonly tensionN: number;
+    /** 跨距 l，m */
+    readonly spanM: number;
+    /** 线索自重 g_self，N/m */
+    readonly selfWeightNPerM: number;
+    /** 冰密度 ρ_ice，kg/m³。缺省 900 */
+    readonly iceDensityKgPerM3?: number;
+}
+interface IcingCheckResult {
+    /** 单位长度冰重 g_ice，N/m */
+    readonly iceLoadNPerM: number;
+    /** 覆冰后总垂直荷载 g_total，N/m */
+    readonly totalLoadNPerM: number;
+    /** 无冰弛度 f₀，m */
+    readonly sagNoIceM: number;
+    /** 覆冰弛度 f_ice，m */
+    readonly sagWithIceM: number;
+    /** 弛度增幅，% */
+    readonly growthPercent: number;
+    /** 冰重是否超过线索自重（重覆冰判据） */
+    readonly heavy: boolean;
+}
+/**
+ * 覆冰综合校核。
+ *
+ * 给出覆冰后的总垂直荷载、弛度及增幅；冰重超过线索自重时 `heavy` 为真。
+ *
+ * ⚠️ 弛度按抛物线近似，且**未与张力-温度状态方程耦合** —— 覆冰引起的
+ * 张力变化未计入，大覆冰工况偏于乐观。
+ */
+declare function icingCheck(input: IcingCheckInput): IcingCheckResult;
+
+export { type IcingCheckInput, type IcingCheckResult, icingCheck, icingMeta };

package/dist/icing/index.js

@@ -0,0 +1,9 @@
+import {
+  icingCheck,
+  icingMeta
+} from "../chunk-GN6QNOUL.js";
+export {
+  icingCheck,
+  icingMeta
+};
+//# sourceMappingURL=index.js.map

package/dist/icing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}