บทแนะนำการแปลง DICOM เป็น JPG ด้วย Python

การแปลงภาพทางการแพทย์จาก DICOM ไปเป็น JPG เป็นงานที่ทำบ่อยเมื่อแอปพลิเคชันรังสีวิทยาต้องแสดงผลการศึกษาในพอร์ทัลเว็บหรือผู้ชมบนมือถือ. Aspose.HTML Cloud SDK for Python มีไลบรารีที่แข็งแกร่งซึ่งจัดการงานหนักบนฝั่งเซิร์ฟเวอร์. ในคู่มือนี้คุณจะได้เรียนรู้วิธีการทำการแปลง DICOM เป็น JPG ด้วย Python ทีละขั้นตอน, สำรวจตัวเลือกแบบหลายเธรด, และดูวิธีเรียกใช้บริการเดียวกันด้วย cURL สำหรับเวิร์กโฟลว์แบบ REST.

ข้อกำหนดการแปลง DICOM เป็น JPG

เครื่องทำงานด้านรังสีมักได้รับไฟล์ DICOM ที่ต้องแสดงเป็นภาพย่อ JPG ที่มีขนาดเบาเพื่อการแสดงตัวอย่างอย่างรวดเร็ว นักพัฒนาต้องการโซลูชันที่:

อ่านข้อมูล DICOM แบบไบนารีโดยไม่ต้องพึ่งพาไลบรารีการประมวลผลภาพภายนอก.
แปลงภาพเป็นรูปแบบที่ได้รับการสนับสนุนอย่างกว้างขวาง เช่น JPG พร้อมคงคุณภาพการวินิจฉัย.
จัดการไฟล์จำนวนมากได้อย่างมีประสิทธิภาพ โดยอุดมคติใช้การประมวลผลแบบขนาน.

การแปลงด้วยมือโดยใช้เครื่องมือบนเดสก์ท็อปใช้เวลานานและไม่สามารถขยายได้สำหรับสายงานด้านเซิร์ฟเวอร์ ทำให้ API อัตโนมัติเกี่ยวข้องเป็นสิ่งจำเป็นสำหรับซอฟต์แวร์รังสีวิทยาสมัยใหม่.

แนวทาง: กระบวนการแปลงคลาวด์ที่ได้รับการปรับแต่งให้เหมาะสม

Aspose.HTML Cloud SDK for Python ให้บริการ API บนคลาวด์ที่แยกตรรกะการแปลงออกจากกัน. บริการ:

รับข้อมูลไบต์ DICOM ดิบและส่งคืนสตรีมไบต์ JPG.
ทำงานในคลาวด์ของ Aspose โดยไม่ต้องใช้ตัวแยกวิเคราะห์ DICOM ในเครื่อง.
ให้ตัวเลือกการกำหนดค่าสำหรับคุณภาพภาพ ความละเอียด และการทำงานแบบหลายเธรด.

ดู เอกสารอย่างเป็นทางการ สำหรับรายละเอียดการรับรองและ อ้างอิง API สำหรับคลาส ConvertDocumentRequest ที่ใช้ในบทแนะนำนี้.

การแปลง DICOM เป็น JPG ใน Python

ด้านล่างเป็นการนำไปใช้เชิงปฏิบัติแบบขั้นตอนต่อขั้นตอนที่คุณสามารถผสานรวมเข้ากับระบบแบ็กเอนด์ของรังสีวิทยาใดก็ได้

ติดตั้ง Aspose.HTML Cloud SDK for Python

pip install asposehtmlcloud

กำหนดค่าไคลเอนต์ API ด้วยข้อมูลประจำตัวของคุณ

from asposehtmlcloud import HtmlApi, Configuration

config = Configuration()
config.api_key['api_key'] = api_key               # Replace with your actual API key
config.host = "https://api.aspose.cloud"

html_api = HtmlApi(config)

โหลดไฟล์ DICOM ลงในหน่วยความจำ

with open(input_file, "rb") as f:
    dicom_bytes = f.read()

สร้างคำขอการแปลงสำหรับเอาต์พุต JPG

from asposehtmlcloud import ConvertDocumentRequest

request = ConvertDocumentRequest(
    file=dicom_bytes,
    format="jpg"
)

เขียนไบต์ JPG ไปยังดิสก์

jpg_bytes = html_api.convert_document(request)

with open(output_file, "wb") as out_f:
    out_f.write(jpg_bytes)

ด้วยขั้นตอนเหล่านี้ กระบวนการแปลง DICOM เป็น JPG จะเสร็จสมบูรณ์แล้ว, และคุณสามารถรวมยูทิลิตี้นี้เข้ากับพายป์ไลน์ที่ใหญ่ขึ้นหรือเรียกใช้จากสคริปต์บรรทัดคำสั่งได้

ยูทิลิตี้การแปลง DICOM เป็น JPG - ตัวอย่างโค้ดเต็ม

ตัวอย่างต่อไปนี้แสดงกระบวนการแบบ end‑to‑end อย่างเต็มรูปแบบ

import os
from asposehtmlcloud import HtmlApi, Configuration, ConvertDocumentRequest

def dicom_to_jpg(input_file: str, output_file: str, api_key: str):
    # Configure Aspose.HTML Cloud SDK
    config = Configuration()
    config.api_key['api_key'] = api_key               # Replace with your actual API key
    config.host = "https://api.aspose.cloud"

# Initialize the API client
    html_api = HtmlApi(config)

# Read the DICOM file into memory
    with open(input_file, "rb") as f:
        dicom_bytes = f.read()

# Build the conversion request (target format: jpg)
    request = ConvertDocumentRequest(
        file=dicom_bytes,
        format="jpg"
    )

# Perform conversion – the response is a binary stream of the JPG image
    jpg_bytes = html_api.convert_document(request)

# Write the resulting JPG to disk
    with open(output_file, "wb") as out_f:
        out_f.write(jpg_bytes)

if __name__ == "__main__":
    # Example usage
    INPUT_DICOM = "sample.dcm"          # Path to your source DICOM file
    OUTPUT_JPG = "sample_converted.jpg" # Desired output path
    API_KEY = "YOUR_ASPOSE_CLOUD_API_KEY"

dicom_to_jpg(INPUT_DICOM, OUTPUT_JPG, API_KEY)

หมายเหตุ: ตัวอย่างโค้ดนี้แสดงการทำงานหลัก ก่อนนำไปใช้ในโครงการของคุณ ให้ตรวจสอบให้แน่ใจว่าได้อัปเดตเส้นทางไฟล์และค่าการกำหนดค่าต่าง ๆ ให้ตรงกับสภาพแวดล้อมจริงของคุณ ตรวจสอบว่าการพึ่งพาที่จำเป็นทั้งหมดได้ติดตั้งอย่างถูกต้อง และทดสอบอย่างละเอียดในสภาพแวดล้อมการพัฒนา หากคุณพบปัญหาใด ๆ โปรดดูที่ เอกสารอย่างเป็นทางการ หรือ ติดต่อทีมสนับสนุนที่ ทีมสนับสนุน เพื่อขอความช่วยเหลือ.

การแปลงหลายเธรดผ่าน REST API ด้วย cURL

หากคุณต้องการใช้วิธี REST แบบบริสุทธิ์เดียวกัน การแปลงเดียวกันสามารถทำได้ด้วยคำสั่ง cURL ซึ่งเป็นประโยชน์สำหรับการทำอัตโนมัติผ่านบรรทัดคำสั่งหรือการรวมเข้ากับ CI pipelines.

รับโทเค็นการเข้าถึง

curl -X POST "https://api.aspose.cloud/connect/token" \
     -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"

อัปโหลดไฟล์ DICOM

curl -X PUT "https://api.aspose.cloud/v4.0/html/storage/file/sample.dcm" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/dicom" \
     --data-binary "@sample.dcm"

ขอแปลงเป็น JPG

curl -X POST "https://api.aspose.cloud/v4.0/html/convert?format=jpg" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"FileName":"sample.dcm"}' \
     -o sample_converted.jpg

ดาวน์โหลด JPG ที่แปลงแล้ว (หากไม่ได้บันทึกโดยตรง)

curl -X GET "https://api.aspose.cloud/v4.0/html/storage/file/sample_converted.jpg" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o sample_converted.jpg

คำสั่งเหล่านี้แสดงตัวอย่างการทำงานของกระบวนการแปลงแบบหลายเธรดที่หลายไฟล์สามารถประมวลผลพร้อมกันโดยการส่งคู่ upload/convert หลายคู่พร้อมกันอย่างต่อเนื่อง สำหรับรายละเอียด API อย่างเต็มที่, ดูที่ เอกสาร API อย่างเป็นทางการ.

กำหนดค่าตัวเลือกการแปลงจาก DICOM เป็น JPG

SDK ช่วยให้คุณปรับแต่งผลลัพธ์ได้อย่างละเอียด ตัวเลือกทั่วไปรวมถึง:

คุณภาพภาพ - ปรับระดับการบีบอัดของ JPEG (0‑100).
ความละเอียด - ตั้งค่า DPI สำหรับผลลัพธ์ความละเอียดสูง.
โหมดสี - เลือกระหว่างระดับสีเทาและสีถ้า DICOM มีข้อมูลสี.

คุณสามารถส่งตัวเลือกเหล่านี้ใน payload ของคำขอได้ ตัวอย่างเช่น เพื่อกำหนดคุณภาพ:

request = ConvertDocumentRequest(
    file=dicom_bytes,
    format="jpg",
    options={"quality": 90}
)

พารามิเตอร์ที่รองรับทั้งหมดถูกอธิบายใน อ้างอิง API. ทดลองใช้การตั้งค่าเหล่านี้เพื่อให้ได้สมดุลที่ดีที่สุดระหว่างขนาดไฟล์และความชัดเจนในการวินิจฉัย โดยเฉพาะอย่างยิ่งเมื่อทำงานกับชุดข้อมูล DICOM ขนาดใหญ่.

สรุป

การแปลง DICOM เป็น JPG ใน Python กลายเป็นเรื่องง่ายด้วย Aspose.HTML Cloud SDK for Python. ไลบรารีจัดการงานหนัก, ให้การทำงานแบบหลายเธรดสำหรับสภาพแวดล้อมที่ต้องการประสิทธิภาพสูง, และให้การควบคุมละเอียดเกี่ยวกับคุณภาพของภาพ. จำไว้ว่าต้องจัดหาใบอนุญาตเชิงพาณิชย์ที่เหมาะสมสำหรับการใช้งานในผลิตภัณฑ์; รายละเอียดราคาอยู่บนหน้าผลิตภัณฑ์, และสามารถรับใบอนุญาตชั่วคราวได้จาก หน้าลิขสิทธิ์ชั่วคราว. ด้วยโค้ดและตัวอย่าง cURL ด้านบน, คุณสามารถรวมการแปลง DICOM เป็น JPG ที่เชื่อถือได้เข้าไปในแอปพลิเคชันรังสีวิทยาใด ๆ ได้แล้ววันนี้.

คำถามที่พบบ่อย

ไฟล์ฟอร์แมตใดบ้างที่ Aspose.HTML Cloud SDK สามารถแปลงได้ นอกจาก DICOM?
SDK รองรับรูปแบบไฟล์หลากหลายรวมถึง PDF, PNG, BMP, GIF, TIFF, และ SVG. ดูที่ เอกสาร สำหรับรายการเต็ม

เป็นไปได้หรือไม่ที่จะรันการแปลงโดยไม่ต้องติดตั้งเครื่องมือภายนอกใดๆ?
ใช่ การแปลงทำงานทั้งหมดบนคลาวด์ ดังนั้นจึงไม่จำเป็นต้องมีไลบรารี DICOM หรือเครื่องมือประมวลผลภาพในเครื่อง

การแปลงแบบหลายเธรดช่วยปรับปรุงประสิทธิภาพอย่างไร?
โดยการส่งคำขอแปลงหลายรายการพร้อมกัน คุณสามารถใช้หลายคอร์ของ CPU บนเซิร์ฟเวอร์ Aspose เพื่อลดเวลาในการประมวลผลโดยรวมสำหรับชุดไฟล์ DICOM ขนาดใหญ่

ฉันสามารถใช้ SDK ในสคริปต์บรรทัดคำสั่งได้หรือไม่?
แน่นอน ตัวอย่าง cURL ที่ให้มาสาธิตการทำงานแบบบรรทัดคำสั่ง และสคริปต์ Python สามารถเรียกใช้โดยตรงจากเทอร์มินัลหรือทำงานตามกำหนดเวลาได้

ข้อกำหนดการแปลง DICOM เป็น JPG#

แนวทาง: กระบวนการแปลงคลาวด์ที่ได้รับการปรับแต่งให้เหมาะสม#

การแปลง DICOM เป็น JPG ใน Python#

ติดตั้ง Aspose.HTML Cloud SDK for Python#

กำหนดค่าไคลเอนต์ API ด้วยข้อมูลประจำตัวของคุณ#

โหลดไฟล์ DICOM ลงในหน่วยความจำ#

สร้างคำขอการแปลงสำหรับเอาต์พุต JPG#

เขียนไบต์ JPG ไปยังดิสก์#

ยูทิลิตี้การแปลง DICOM เป็น JPG - ตัวอย่างโค้ดเต็ม#

การแปลงหลายเธรดผ่าน REST API ด้วย cURL#

กำหนดค่าตัวเลือกการแปลงจาก DICOM เป็น JPG#

สรุป#

คำถามที่พบบ่อย#

อ่านเพิ่มเติม#