@rfkit/spectrum-analyzer 0.1.0

package/core/constants.d.ts

@@ -0,0 +1,31 @@
+export declare const SPECTRUM: {
+    readonly INITIAL_VALUE: 0;
+    readonly WATERFALL_MAX_FRAMES: 100;
+    readonly OUTPUT_POINTS: 1001;
+};
+export declare const DEFAULT_SPECTRUM_CONFIG: {
+    readonly maxPoints: 1001;
+    readonly waterfallMaxFrames: 100;
+    readonly initialValue: 0;
+    readonly processing: {
+        readonly enableWaterfall: false;
+        readonly enableMetrics: false;
+    };
+    readonly outputPoints: 1001;
+    readonly outputRange: {
+        readonly start: 0;
+        readonly end: 1001;
+    };
+};
+export declare const ERROR_MESSAGES: {
+    readonly EMPTY_SEGMENTS: "频段配置不能为空";
+    readonly INVALID_CONFIG: "必须且只能配置 segments 或 bandwidthConfig 其中之一";
+    readonly EMPTY_BANDWIDTH: "bandwidthConfig 不能为空";
+    readonly INVALID_SEGMENT: (index: number) => string;
+    readonly INDEX_OUT_OF_BOUNDS: (index: number) => string;
+    readonly INVALID_ANTENNA_FACTOR: (points: number) => string;
+    readonly INVALID_SAMPLING_RANGE: "采样范围无效";
+    readonly INVALID_MAX_POINTS: "点数必须大于0";
+    readonly INVALID_LENGTH: (expected: number) => string;
+};
+//# sourceMappingURL=constants.d.ts.map

package/core/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ;;;;CAIX,CAAC;AAEX,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;CAa1B,CAAC;AAEX,eAAO,MAAM,cAAc;;;;sCAIA,MAAM;0CACF,MAAM;8CACF,MAAM;;;wCAIZ,MAAM;CAEzB,CAAC"}

package/core/errors.d.ts

@@ -0,0 +1,16 @@
+export declare class SpectrumError extends Error {
+    readonly code: string;
+    readonly details?: unknown | undefined;
+    constructor(message: string, code: string, details?: unknown | undefined);
+}
+export declare class DataValidationError extends SpectrumError {
+    constructor(message: string, details?: unknown);
+}
+/**
+ * 索引越界错误
+ */
+export declare class IndexOutOfBoundsError extends SpectrumError {
+    readonly index: number;
+    constructor(message: string, index: number, details?: unknown);
+}
+//# sourceMappingURL=errors.d.ts.map

package/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,aAAc,SAAQ,KAAK;aAGpB,IAAI,EAAE,MAAM;aACZ,OAAO,CAAC,EAAE,OAAO;gBAFjC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,OAAO,YAAA;CAKpC;AAED,qBAAa,mBAAoB,SAAQ,aAAa;gBACxC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAG/C;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,aAAa;aAGpC,KAAK,EAAE,MAAM;gBAD7B,OAAO,EAAE,MAAM,EACC,KAAK,EAAE,MAAM,EAC7B,OAAO,CAAC,EAAE,OAAO;CAOpB"}

package/core/index.d.ts

@@ -0,0 +1,39 @@
+import type { ProcessInput, ScanSegment, SpectrumConfig, SpectrumOutputData, TimestampedFloat32Array } from './types';
+export default class SpectrumAnalyzer {
+    protected config: Required<Omit<SpectrumConfig, 'segments' | 'bandwidthConfig' | 'onSpectrumUpdate'>>;
+    private segments;
+    protected antennaFactorData: Float32Array;
+    protected realData: TimestampedFloat32Array;
+    protected sumData: Float32Array;
+    protected maxData: Float32Array;
+    protected minData: Float32Array;
+    protected avgData: Float32Array;
+    protected waterfallData: TimestampedFloat32Array[];
+    protected srcIndexCache: Uint32Array;
+    protected realOutputData: Float32Array;
+    protected waterfallOutputData: TimestampedFloat32Array[];
+    protected scanProgress: number;
+    protected lastIndex: number;
+    protected processTimes: number;
+    protected lastProcessTime: number;
+    private readonly onSpectrumUpdate?;
+    constructor(config: Partial<SpectrumConfig>);
+    process({ data, timestamp, segmentOffset, offset, }: ProcessInput): void;
+    setOccupancyData(data: Float32Array): Float32Array;
+    initializeSegments(segments: ScanSegment[]): void;
+    setAntennaFactor(data: Float32Array): void;
+    reset(): void;
+    getData(): Readonly<SpectrumOutputData>;
+    getPerformanceMetrics(): Readonly<Record<string, number | boolean>>;
+    updateSamplingRange(start: number, end: number): void;
+    protected resampleDataSeries(): Readonly<SpectrumOutputData>;
+    protected resampleWaterfallOutputData(): void;
+    protected updateWaterfallData(data: TimestampedFloat32Array, outputData: TimestampedFloat32Array): void;
+    protected updateMaxPoints(maxPoints: number): void;
+    protected validateInput(data: Float32Array, index: number): void;
+    private processDataPoints;
+    private notifySpectrumUpdate;
+    private calculateMemoryUsage;
+    private getOutputData;
+}
+//# sourceMappingURL=index.d.ts.map

package/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,uBAAuB,EACxB,MAAM,SAAS,CAAC;AAKjB,MAAM,CAAC,OAAO,OAAO,gBAAgB;IACnC,SAAS,CAAC,MAAM,EAAE,QAAQ,CACxB,IAAI,CAAC,cAAc,EAAE,UAAU,GAAG,iBAAiB,GAAG,kBAAkB,CAAC,CAC1E,CAA2B;IAC5B,OAAO,CAAC,QAAQ,CAAqB;IAErC,SAAS,CAAC,iBAAiB,EAAG,YAAY,CAAC;IAC3C,SAAS,CAAC,QAAQ,EAAG,uBAAuB,CAAC;IAC7C,SAAS,CAAC,OAAO,EAAG,YAAY,CAAC;IACjC,SAAS,CAAC,OAAO,EAAG,YAAY,CAAC;IACjC,SAAS,CAAC,OAAO,EAAG,YAAY,CAAC;IACjC,SAAS,CAAC,OAAO,EAAG,YAAY,CAAC;IACjC,SAAS,CAAC,aAAa,EAAG,uBAAuB,EAAE,CAAC;IAEpD,SAAS,CAAC,aAAa,EAAG,WAAW,CAAC;IAEtC,SAAS,CAAC,cAAc,EAAG,YAAY,CAAC;IACxC,SAAS,CAAC,mBAAmB,EAAG,uBAAuB,EAAE,CAAC;IAC1D,SAAS,CAAC,YAAY,EAAG,MAAM,CAAC;IAEhC,SAAS,CAAC,SAAS,EAAG,MAAM,CAAC;IAC7B,SAAS,CAAC,YAAY,EAAG,MAAM,CAAC;IAChC,SAAS,CAAC,eAAe,EAAG,MAAM,CAAC;IAEnC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAqC;gBAE3D,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC;IAmBpC,OAAO,CAAC,EACb,IAAI,EACJ,SAAS,EACT,aAAiB,EACjB,MAAU,GACX,EAAE,YAAY,GAAG,IAAI;IAqDf,gBAAgB,CAAC,IAAI,EAAE,YAAY,GAAG,YAAY;IAwBlD,kBAAkB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI;IAwBjD,gBAAgB,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAa1C,KAAK,IAAI,IAAI;IAuCb,OAAO,IAAI,QAAQ,CAAC,kBAAkB,CAAC;IAavC,qBAAqB,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;IAUnE,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAa5D,SAAS,CAAC,kBAAkB,IAAI,QAAQ,CAAC,kBAAkB,CAAC;IAmD5D,SAAS,CAAC,2BAA2B,IAAI,IAAI;IAqB7C,SAAS,CAAC,mBAAmB,CAC3B,IAAI,EAAE,uBAAuB,EAC7B,UAAU,EAAE,uBAAuB,GAClC,IAAI;IAsBP,SAAS,CAAC,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAalD,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAShE,OAAO,CAAC,iBAAiB;IAqCzB,OAAO,CAAC,oBAAoB;IAW5B,OAAO,CAAC,oBAAoB;IAiB5B,OAAO,CAAC,aAAa;CActB"}

package/core/tools.d.ts

@@ -0,0 +1,17 @@
+import type { TimestampedFloat32Array } from './types';
+export declare const arrayKeepAttribute: (source: Float32Array & {
+    max?: number;
+    maxIndex?: number;
+    timestamp?: number;
+    progress?: number;
+}, target: Float32Array & {
+    max?: number;
+    maxIndex?: number;
+    timestamp?: number;
+    progress?: number;
+}) => void;
+export declare const resample: (data: TimestampedFloat32Array, antennaFactorData: Float32Array, interval: number) => {
+    realOutputData: TimestampedFloat32Array;
+    srcIndexCache: Uint32Array;
+};
+//# sourceMappingURL=tools.d.ts.map

package/core/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/core/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAGvD,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,YAAY,GAAG;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,EACD,QAAQ,YAAY,GAAG;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,SAMF,CAAC;AAEF,eAAO,MAAM,QAAQ,GACnB,MAAM,uBAAuB,EAC7B,mBAAmB,YAAY,EAC/B,UAAU,MAAM,KACf;IAAE,cAAc,EAAE,uBAAuB,CAAC;IAAC,aAAa,EAAE,WAAW,CAAA;CAiEvE,CAAC"}

package/core/types.d.ts

@@ -0,0 +1,56 @@
+export interface ScanSegment {
+    startFrequency: number;
+    stopFrequency: number;
+    stepFrequency: number;
+    pointCount: number;
+    startIndex: number;
+}
+export interface ProcessInput {
+    data: Float32Array;
+    frequency: number;
+    timestamp: number;
+    segmentOffset?: number;
+    offset?: number;
+}
+export interface ProcessingConfig {
+    readonly enableWaterfall: boolean;
+    readonly enableMetrics: boolean;
+}
+export interface SpectrumConfig {
+    maxPoints?: number;
+    waterfallMaxFrames?: number;
+    initialValue?: number;
+    processing?: Partial<ProcessingConfig>;
+    outputPoints?: number;
+    outputRange?: {
+        start: number;
+        end: number;
+    };
+    segments?: FrequencySegment[];
+    bandwidthConfig?: BandwidthConfig;
+    onSpectrumUpdate?: (data: SpectrumOutputData) => void;
+}
+export interface FrequencySegment {
+    startFrequency: number;
+    stopFrequency: number;
+    stepFrequency: number;
+}
+export interface BandwidthConfig {
+    frequency: number;
+    bandwidth: number;
+}
+export type TimestampedFloat32Array = Float32Array & {
+    timestamp: number;
+};
+export interface SpectrumOutputData {
+    realData: TimestampedFloat32Array;
+    maxData: Float32Array;
+    minData: Float32Array;
+    avgData: Float32Array;
+    waterfallData?: TimestampedFloat32Array[];
+    realOriginalData?: Float32Array;
+    waterfallOriginalData?: TimestampedFloat32Array[];
+    scanProgress?: number;
+    processTimes?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,YAAY,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IACF,QAAQ,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC9B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,IAAI,CAAC;CACvD;AAED,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,uBAAuB,GAAG,YAAY,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAC3E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,uBAAuB,CAAC;IAClC,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,YAAY,CAAC;IACtB,aAAa,CAAC,EAAE,uBAAuB,EAAE,CAAC;IAE1C,gBAAgB,CAAC,EAAE,YAAY,CAAC;IAChC,qBAAqB,CAAC,EAAE,uBAAuB,EAAE,CAAC;IAElD,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/index.d.ts

@@ -0,0 +1,6 @@
+import SpectrumAnalyzer from './core';
+export type { ProcessInput, ProcessingConfig, SpectrumConfig, FrequencySegment, BandwidthConfig, TimestampedFloat32Array, SpectrumOutputData, } from './core/types';
+export { SpectrumError, DataValidationError, IndexOutOfBoundsError, } from './core/errors';
+export { SPECTRUM, ERROR_MESSAGES } from './core/constants';
+export default SpectrumAnalyzer;
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,MAAM,QAAQ,CAAC;AAGtC,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAG5D,eAAe,gBAAgB,CAAC"}

package/index.js

@@ -0,0 +1 @@
+class SpectrumError extends Error{code;details;constructor(message,code,details){super(message),this.code=code,this.details=details;this.name="SpectrumError"}}class DataValidationError extends SpectrumError{constructor(message,details){super(message,"DATA_VALIDATION_ERROR",details)}}class IndexOutOfBoundsError extends SpectrumError{index;constructor(message,index,details){super(message,"INDEX_OUT_OF_BOUNDS_ERROR",{index,...details||{}}),this.index=index}}const arrayKeepAttribute=(source,target)=>{if(void 0!==source.max)target.max=source.max;if(void 0!==source.maxIndex)target.maxIndex=source.maxIndex;if(void 0!==source.timestamp)target.timestamp=source.timestamp;if(void 0!==source.progress)target.progress=source.progress};const resample=(data,antennaFactorData,interval)=>{const outputLength=data.length<=interval?data.length:interval;const srcIndexCache=new Uint32Array(outputLength);const hasAntennaFactor=antennaFactorData?.length>0;if(interval<=0||data.length<=interval){if(!hasAntennaFactor){for(let i=0;i<data.length;i++)srcIndexCache[i]=i;return{realOutputData:data,srcIndexCache}}const realOutputData=new Float32Array(data.length);realOutputData.timestamp=data.timestamp;for(let i=0;i<data.length;i++){srcIndexCache[i]=i;realOutputData[i]=data[i]+antennaFactorData[i]}return{realOutputData,srcIndexCache}}const ratio=data.length/interval;const realOutputData=new Float32Array(outputLength);realOutputData.timestamp=data.timestamp;let pos=ratio/2;for(let i=0;i<outputLength;i++){const start=Math.floor(pos);const end=Math.min(Math.floor(pos+ratio),data.length);let maxValue=data[start];let maxIndex=start;for(let j=start+1;j<end;j++)if(data[j]>maxValue){maxValue=data[j];maxIndex=j}realOutputData[i]=hasAntennaFactor?maxValue+antennaFactorData[maxIndex]:maxValue;srcIndexCache[i]=maxIndex;pos+=ratio}return{realOutputData,srcIndexCache}};const SPECTRUM={INITIAL_VALUE:0,WATERFALL_MAX_FRAMES:100,OUTPUT_POINTS:1001};const DEFAULT_SPECTRUM_CONFIG={maxPoints:SPECTRUM.OUTPUT_POINTS,waterfallMaxFrames:SPECTRUM.WATERFALL_MAX_FRAMES,initialValue:SPECTRUM.INITIAL_VALUE,processing:{enableWaterfall:false,enableMetrics:false},outputPoints:SPECTRUM.OUTPUT_POINTS,outputRange:{start:0,end:SPECTRUM.OUTPUT_POINTS}};const ERROR_MESSAGES={EMPTY_SEGMENTS:"频段配置不能为空",INVALID_CONFIG:"必须且只能配置 segments 或 bandwidthConfig 其中之一",EMPTY_BANDWIDTH:"bandwidthConfig 不能为空",INVALID_SEGMENT:index=>`无效的段索引: ${index}`,INDEX_OUT_OF_BOUNDS:index=>`索引超出范围: ${index}`,INVALID_ANTENNA_FACTOR:points=>`天线因子数据长度必须等于 maxPoints (${points})`,INVALID_SAMPLING_RANGE:"采样范围无效",INVALID_MAX_POINTS:"点数必须大于0",INVALID_LENGTH:expected=>`频率占用度数据长度不匹配，期望长度为 ${expected}`};class SpectrumAnalyzer{config=DEFAULT_SPECTRUM_CONFIG;segments=[];antennaFactorData;realData;sumData;maxData;minData;avgData;waterfallData;srcIndexCache;realOutputData;waterfallOutputData;scanProgress;lastIndex;processTimes;lastProcessTime;onSpectrumUpdate;constructor(config){const{onSpectrumUpdate,maxPoints}=config;this.onSpectrumUpdate=onSpectrumUpdate;this.config={...DEFAULT_SPECTRUM_CONFIG,...config,processing:{...DEFAULT_SPECTRUM_CONFIG.processing,...config.processing},outputRange:{start:config.outputRange?.start??0,end:config.outputRange?.end??maxPoints??SPECTRUM.OUTPUT_POINTS}}}process({data,timestamp,segmentOffset=0,offset=0}){const processStartTime=performance.now();try{if(0===data.length)return;let index=offset;if(this.segments.length){const segment=this.segments[segmentOffset];if(!segment)throw new DataValidationError(ERROR_MESSAGES.INVALID_SEGMENT(segmentOffset));index=segment.startIndex+offset;this.scanProgress=(index+data.length)/this.config.maxPoints}else if(data.length!==this.config.maxPoints)this.updateMaxPoints(data.length);this.validateInput(data,index);const{maxPoints}=this.config;const endIndex=index+data.length;this.lastIndex=endIndex;const isOver=endIndex>=maxPoints||endIndex<this.lastIndex;this.realData.set(data,index);this.realData.timestamp=timestamp;this.processDataPoints(data,index);const processedData=this.resampleDataSeries();if(isOver){this.updateWaterfallData(this.realData,processedData.realData);this.processTimes+=1}this.notifySpectrumUpdate(processedData)}catch(error){throw error instanceof Error?error:new Error(String(error))}finally{this.lastProcessTime=performance.now()-processStartTime}}setOccupancyData(data){const{maxPoints}=this.config;if(data.length!==maxPoints)throw new DataValidationError(ERROR_MESSAGES.INVALID_LENGTH(maxPoints));const{config:{outputRange:{start}}}=this;const len=this.srcIndexCache.length;new Float32Array(data);const occupancyOutputData=new Float32Array(len);for(let i=0;i<len;i++){const dataIndex=this.srcIndexCache[i]+start;occupancyOutputData[i]=data[dataIndex]}return occupancyOutputData}initializeSegments(segments){if(!segments?.length)throw new DataValidationError(ERROR_MESSAGES.EMPTY_SEGMENTS);let totalPoints=0;this.segments=segments.map(segment=>{const{startFrequency,stopFrequency,stepFrequency}=segment;const pointCount=Math.floor((stopFrequency-startFrequency)*1e3/stepFrequency)+1;const startIndex=totalPoints;totalPoints+=pointCount;return{startFrequency,stopFrequency,stepFrequency,pointCount,startIndex}});this.updateMaxPoints(totalPoints)}setAntennaFactor(data){const{maxPoints}=this.config;if(data.length!==maxPoints)throw new DataValidationError(ERROR_MESSAGES.INVALID_ANTENNA_FACTOR(maxPoints));this.antennaFactorData=new Float32Array(data)}reset(){const{maxPoints,waterfallMaxFrames}=this.config;this.antennaFactorData=new Float32Array(maxPoints);const realData=new Float32Array(maxPoints);realData.timestamp=0;this.realData=realData;this.sumData=new Float32Array(maxPoints);this.maxData=new Float32Array(maxPoints);this.minData=new Float32Array(maxPoints);this.avgData=new Float32Array(maxPoints);this.waterfallData=Array.from({length:waterfallMaxFrames},()=>new Float32Array);this.waterfallOutputData=Array.from({length:waterfallMaxFrames},()=>new Float32Array);this.srcIndexCache=new Uint32Array(maxPoints);this.scanProgress=0;this.lastIndex=0;this.processTimes=0;this.lastProcessTime=0;this.notifySpectrumUpdate({realData:this.realData,maxData:this.maxData,minData:this.minData,avgData:this.avgData})}getData(){const{realData,maxData,minData,avgData,waterfallData,processTimes}=this;return{realData,maxData,minData,avgData,waterfallData,processTimes}}getPerformanceMetrics(){return{lastProcessTime:this.lastProcessTime,dataPoints:this.config.maxPoints,waterfallFrames:this.waterfallData.length,isInitialized:this.realData.length>0,memoryUsage:this.calculateMemoryUsage()}}updateSamplingRange(start,end){if(start<0||end>this.config.maxPoints||start>=end)return;this.config={...this.config,outputRange:{start:Math.floor(start),end:Math.ceil(end)}};const processedData=this.resampleDataSeries();this.resampleWaterfallOutputData();this.notifySpectrumUpdate(processedData)}resampleDataSeries(){const{antennaFactorData,maxData,minData,avgData,config:{outputPoints,processing:{enableMetrics},outputRange:{start}}}=this;const{realOutputData,srcIndexCache}=resample(this.getOutputData(),antennaFactorData,outputPoints);this.srcIndexCache=srcIndexCache;if(!enableMetrics)return{realData:realOutputData,maxData:new Float32Array,minData:new Float32Array,avgData:new Float32Array};const len=srcIndexCache.length;const maxOutputData=new Float32Array(len);const minOutputData=new Float32Array(len);const avgOutputData=new Float32Array(len);for(let i=0;i<len;i++){const dataIndex=srcIndexCache[i]+start;maxOutputData[i]=maxData[dataIndex];minOutputData[i]=minData[dataIndex];avgOutputData[i]=avgData[dataIndex]}return{realData:realOutputData,maxData:maxOutputData,minData:minOutputData,avgData:avgOutputData}}resampleWaterfallOutputData(){const{antennaFactorData,waterfallData,config:{processing:{enableWaterfall},outputPoints}}=this;if(!enableWaterfall)return;this.waterfallOutputData=waterfallData.map(frame=>{const{realOutputData}=resample(this.getOutputData(frame),antennaFactorData,outputPoints);return realOutputData})}updateWaterfallData(data,outputData){const{waterfallMaxFrames,processing}=this.config;if(!processing.enableWaterfall)return;if(this.waterfallData.length>=waterfallMaxFrames){this.waterfallData.shift();this.waterfallOutputData.shift()}const newData=new Float32Array(data.length);newData.set(data);newData.timestamp=data.timestamp;this.waterfallData.push(newData);this.waterfallOutputData.push(outputData)}updateMaxPoints(maxPoints){if(this.config.maxPoints===maxPoints)return;this.config={...this.config,maxPoints,outputRange:{start:0,end:maxPoints}};this.reset()}validateInput(data,index){if(index<0||index+data.length>this.config.maxPoints)throw new IndexOutOfBoundsError(ERROR_MESSAGES.INDEX_OUT_OF_BOUNDS(index),index)}processDataPoints(data,index){const length=data.length;const{sumData,maxData,minData,avgData,antennaFactorData}=this;const times=this.processTimes;const hasAntennaFactor=antennaFactorData?.length>0;if(0===times){for(let i=0;i<length;i++){const dataIndex=index+i;const value=hasAntennaFactor?data[i]+antennaFactorData[dataIndex]:data[i];sumData[dataIndex]=value;maxData[dataIndex]=value;minData[dataIndex]=value;avgData[dataIndex]=value}return}for(let i=0;i<length;i++){const dataIndex=index+i;const value=hasAntennaFactor?data[i]+antennaFactorData[dataIndex]:data[i];const oldAvg=avgData[dataIndex];sumData[dataIndex]+=value;maxData[dataIndex]=value>maxData[dataIndex]?value:maxData[dataIndex];minData[dataIndex]=value<minData[dataIndex]?value:minData[dataIndex];avgData[dataIndex]=oldAvg+(value-oldAvg)/(times+1)}}notifySpectrumUpdate(processedData){this.onSpectrumUpdate?.({...processedData,waterfallData:this.waterfallOutputData,processTimes:this.processTimes,realOriginalData:this.realData,waterfallOriginalData:this.waterfallData,scanProgress:this.scanProgress})}calculateMemoryUsage(){const arraySize=this.config.maxPoints*Float32Array.BYTES_PER_ELEMENT;const baseArrayMemory=4*arraySize;const rawWaterfallMemory=this.waterfallData.reduce((sum,frame)=>sum+frame.length*Float32Array.BYTES_PER_ELEMENT,0);const outputWaterfallMemory=this.waterfallOutputData.reduce((sum,frame)=>sum+frame.length*Float32Array.BYTES_PER_ELEMENT,0);return baseArrayMemory+rawWaterfallMemory+outputWaterfallMemory}getOutputData(data){const{outputRange:{start,end}}=this.config;const sourceData=data??this.realData;const outputData=sourceData.subarray(start,end);outputData.timestamp=sourceData.timestamp;return outputData}}const src=SpectrumAnalyzer;export{DataValidationError,ERROR_MESSAGES,IndexOutOfBoundsError,SPECTRUM,SpectrumError,src as default};

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@rfkit/spectrum-analyzer",
+  "description": "A high-performance spectrum analyzer library for RF signal processing, supporting real-time spectrum analysis, waterfall display, and multi-segment frequency scanning",
+  "module": "index.js",
+  "author": "Hxgh",
+  "license": "MIT",
+  "version": "0.1.0",
+  "private": false,
+  "keywords": [
+    "spectrum-analyzer",
+    "rf",
+    "signal-processing",
+    "waterfall-plot",
+    "frequency-analysis",
+    "typescript",
+    "real-time",
+    "antenna-factor",
+    "frequency-scanning"
+  ]
+}