@abasb75/dicom-parser 0.0.0-test23 → 0.0.1-a

package/README.md

@@ -1,88 +1,24 @@
-# @abasb75/dicom-parser
+# DICOM Parser
 
-```sh
-npm i @abasb75/dicom-parser pako --save
-npm i @types/pako --save-dev
-```
-
-# Demo
-
-<a href="https://abasb75.github.io/dicom-parser/">demo link</a>
-
-# Usage
-
-1. For Download dicom and parse from url:
-
-```javascript
-import { loadAndParseFromUrl } from "@abasb75/dicom-parser";
-
-...
-const url = "....dcm";
-loadAndParseFromUrl(url)
-.then(dataset=>{
-  console.log(dataset);
-})
-.catch(err=>{
-  console.log(error);
-})
+A lightweight and simple DICOM parser designed for browser and Node.js environments.  
+This library extracts metadata and pixel information from raw DICOM files using a clean and intuitive API.
 
-```
-
-
-2. For parse dataset from local files:
-
-```javascript
-import { loadAndParseFromFiles } from "@abasb75/dicom-parser";
+---
 
-...
-
-loadAndParseFromFiles(file)
-.then(dataset=>{
-  console.log(dataset);
-})
-.catch(err=>{
-  console.log(error);
-});
+## 📦 Installation
 
+```bash
+npm install @abasb75/dicom-parser
 ```
 
-3. For parsing arrayBuffer:
-
-```javascript
-import { parse } from "@abasb75/dicom-parser";
-
-...
-
-const dataset = parse(arrayBuffer);
-
-```
-
-
-4. Getting value for dicom tag
-
-```javascript
-
-...
-
-const transferSyntaxUID = dataset.get(0x0002,0x0010);
-const transferSyntaxUID = dataset.string(0x0002,0x0010);
-
-...
-
-const framePixelData = dataset.getPixelData(0); // requested frame number
-
-...
-
-```
+## 🚀 Usage
 
-6. get `palette color` map for `PALETTE COLOR` photometricInterpretation:
+To use this library, you must provide the ArrayBuffer of a DICOM file.
 
 ```js
-const paletteDataMap = dataset.getPaletteColorData();
+import { parse } from '@abasb75/dicom-parser';
 
-if(paletteDataMap){
-  // apply palette color to pixels
-  ...
-}
+const dataset = parse(dicomBuffer as ArrayBuffer);
 
-````
+console.log({ dataset });
+```

package/{types.d.ts → dist/index.d.mts}

@@ -1,22 +1,3 @@
-import Dataset from "./Dataset";
-import Tag from "./Tag";
-interface Tags {
-    [key: string]: Tag;
-}
-interface DicomDate {
-    year: string | number;
-    month: string | number;
-    day: string | number;
-}
-interface DicomTime {
-    hour: string | number;
-    minute: string | number;
-    second: string | number;
-}
-interface DicomDateTime extends DicomDate, DicomTime {
-}
-type DicomDataset = Dataset;
-type PixelArray = Int16Array | Uint16Array | Int32Array | Uint32Array | Int8Array | Uint8Array | Float32Array;
 interface DicomVOILutModule {
     voiLUTFunction: string;
     windowWidth: number | undefined;
@@ -69,18 +50,13 @@ interface DicomPixelModule {
     segmentedBluePaletteColorLookupTableData: any;
     segmentedAlphaPaletteColorLookupTableData: any;
     pixelMeasuresSequence: any;
+    spacingBetweenSlices: any;
 }
 interface DicomScalingModule {
     rescaleSlope: number | undefined;
     rescaleIntercept: number | undefined;
     modality: string;
-}
-interface PixelDataDecodeOptions {
-    pixelData: DataView;
-    bitsAllocated: number;
-    pixelRepresentation: number;
-    littleEndian: boolean;
-    dataset?: Dataset;
+    rescaleType: any;
 }
 interface PaletteColorDataColor {
     data: Uint8Array[] | Uint16Array[];
@@ -95,4 +71,67 @@ interface PaletteColorData {
     blue: PaletteColorDataColor | undefined;
     alpha: PaletteColorDataColor | undefined;
 }
-export type { Tags, DicomTime, DicomDate, DicomDateTime, DicomDataset, DicomVOILutModule, DicomPatientModule, DicomPixelModule, DicomScalingModule, PixelArray, PixelDataDecodeOptions, PaletteColorData, PaletteColorDataColor, };
+
+interface DatasetProperties {
+    littleEndian: boolean;
+    implicit: boolean;
+    elements: {
+        [key: string]: any;
+    };
+    bytes: Uint8Array;
+    transferSyntaxUID?: string | undefined | null;
+    prefix?: string | undefined | null;
+    metadata?: {
+        [key: string]: any;
+    } | undefined | null;
+    deflated?: boolean | undefined | null;
+}
+declare class Dataset {
+    static Float: string;
+    static Integer: string;
+    littleEndian: boolean;
+    implicit: boolean;
+    elements: {
+        [key: string]: any;
+    };
+    transferSyntaxUID: string | null | undefined;
+    prefix?: string | undefined | null;
+    metadata?: {
+        [key: string]: any;
+    } | undefined | null;
+    deflated?: boolean | undefined | null;
+    bytes: Uint8Array;
+    /** modules */
+    voiLUTModule: DicomVOILutModule | null;
+    patientModule: DicomPatientModule | null;
+    pixelModule: DicomPixelModule | null;
+    scalingModule: DicomScalingModule | null;
+    constructor(properties: DatasetProperties);
+    get(group: number | string, element?: number | null | undefined): any;
+    date(group: number, element: number): any;
+    int(group: number, element: number): number | number[];
+    float(group: number, element: number): number | number[];
+    time(group: number, element: number): any;
+    getGeometricTags(tagName: string, frameIndex?: number): any;
+    getPixelTypes(): "Float" | "Integer" | null;
+    hasPixelData(): boolean;
+    getPixelData(frameIndex?: number): DataView<ArrayBufferLike>;
+    getPaletteColorData(): PaletteColorData | undefined;
+    /** module geter */
+    getPatientModule(): DicomPatientModule;
+    getVOILutModule(): DicomVOILutModule;
+    getScalingModule(): DicomScalingModule;
+    getPixelModule(frameIndex?: number): DicomPixelModule;
+    recalculeModules(): void;
+}
+
+declare function loadAndParseFromUrl(url: string): Promise<Dataset>;
+declare function loadAndParseFromFiles(file: File): Promise<Dataset>;
+declare function parse(dicomBuffer: ArrayBuffer): Dataset;
+declare const _default: {
+    parse: typeof parse;
+    loadAndParseFromFiles: typeof loadAndParseFromFiles;
+    loadAndParseFromUrl: typeof loadAndParseFromUrl;
+};
+
+export { _default as default, loadAndParseFromFiles, loadAndParseFromUrl, parse };

package/dist/index.d.ts

@@ -0,0 +1,137 @@
+interface DicomVOILutModule {
+    voiLUTFunction: string;
+    windowWidth: number | undefined;
+    windowCenter: number | undefined;
+    voiLUTSequence: unknown;
+    lutDescriptor: any;
+    lutExplanation: any;
+    lutData: any;
+    windowCenterAndWidthExplanation: string;
+}
+interface DicomPatientModule {
+    patientName: string;
+    patientID: string;
+    typeofPatientID: string;
+    patientSex: string;
+    patientBirthDate: string;
+    patientAge: string;
+    patientSize: string;
+    otherPatientIDs: string;
+    otherPatientNames: string;
+    patientWeight: string;
+}
+interface DicomPixelModule {
+    photometricInterpretation: string;
+    numberOfFrames: number | undefined;
+    pixelRepresentation: number | undefined;
+    pixelSpacing: any | undefined;
+    rows: number | number | undefined;
+    columns: number | number | undefined;
+    bitsAllocated: number | undefined;
+    highBit: number | undefined;
+    bitsStored: number | undefined;
+    samplesPerPixel: number | undefined;
+    pixelDataProviderURL: any;
+    pixelPaddingRangeLimit: any;
+    extendedOffsetTable: any;
+    extendedOffsetTableLengths: any;
+    pixelAspectRatio: any;
+    planarConfiguration: number | undefined;
+    redPaletteColorLookupTableDescriptor: unknown;
+    greenPaletteColorLookupTableDescriptor: unknown;
+    bluePaletteColorLookupTableDescriptor: unknown;
+    alphaPaletteColorLookupTableDescriptor: unknown;
+    redPaletteColorLookupTableData: any;
+    greenPaletteColorLookupTableData: any;
+    bluePaletteColorLookupTableData: any;
+    alphaPaletteColorLookupTableData: any;
+    segmentedRedPaletteColorLookupTableData: any;
+    segmentedGreenPaletteColorLookupTableData: any;
+    segmentedBluePaletteColorLookupTableData: any;
+    segmentedAlphaPaletteColorLookupTableData: any;
+    pixelMeasuresSequence: any;
+    spacingBetweenSlices: any;
+}
+interface DicomScalingModule {
+    rescaleSlope: number | undefined;
+    rescaleIntercept: number | undefined;
+    modality: string;
+    rescaleType: any;
+}
+interface PaletteColorDataColor {
+    data: Uint8Array[] | Uint16Array[];
+    firstInputValueMapped: number;
+    lutEntries: number;
+    bitsPerEntry: number;
+    littleEndian: boolean;
+}
+interface PaletteColorData {
+    red: PaletteColorDataColor | undefined;
+    green: PaletteColorDataColor | undefined;
+    blue: PaletteColorDataColor | undefined;
+    alpha: PaletteColorDataColor | undefined;
+}
+
+interface DatasetProperties {
+    littleEndian: boolean;
+    implicit: boolean;
+    elements: {
+        [key: string]: any;
+    };
+    bytes: Uint8Array;
+    transferSyntaxUID?: string | undefined | null;
+    prefix?: string | undefined | null;
+    metadata?: {
+        [key: string]: any;
+    } | undefined | null;
+    deflated?: boolean | undefined | null;
+}
+declare class Dataset {
+    static Float: string;
+    static Integer: string;
+    littleEndian: boolean;
+    implicit: boolean;
+    elements: {
+        [key: string]: any;
+    };
+    transferSyntaxUID: string | null | undefined;
+    prefix?: string | undefined | null;
+    metadata?: {
+        [key: string]: any;
+    } | undefined | null;
+    deflated?: boolean | undefined | null;
+    bytes: Uint8Array;
+    /** modules */
+    voiLUTModule: DicomVOILutModule | null;
+    patientModule: DicomPatientModule | null;
+    pixelModule: DicomPixelModule | null;
+    scalingModule: DicomScalingModule | null;
+    constructor(properties: DatasetProperties);
+    get(group: number | string, element?: number | null | undefined): any;
+    date(group: number, element: number): any;
+    int(group: number, element: number): number | number[];
+    float(group: number, element: number): number | number[];
+    time(group: number, element: number): any;
+    getGeometricTags(tagName: string, frameIndex?: number): any;
+    getPixelTypes(): "Float" | "Integer" | null;
+    hasPixelData(): boolean;
+    getPixelData(frameIndex?: number): DataView<ArrayBufferLike>;
+    getPaletteColorData(): PaletteColorData | undefined;
+    /** module geter */
+    getPatientModule(): DicomPatientModule;
+    getVOILutModule(): DicomVOILutModule;
+    getScalingModule(): DicomScalingModule;
+    getPixelModule(frameIndex?: number): DicomPixelModule;
+    recalculeModules(): void;
+}
+
+declare function loadAndParseFromUrl(url: string): Promise<Dataset>;
+declare function loadAndParseFromFiles(file: File): Promise<Dataset>;
+declare function parse(dicomBuffer: ArrayBuffer): Dataset;
+declare const _default: {
+    parse: typeof parse;
+    loadAndParseFromFiles: typeof loadAndParseFromFiles;
+    loadAndParseFromUrl: typeof loadAndParseFromUrl;
+};
+
+export { _default as default, loadAndParseFromFiles, loadAndParseFromUrl, parse };