მედიცინული სურათების გადაყვანა DICOM‑დან JPG‑ში ხშირად ხდება, როდესაც რადიოლოგიის აპლიკაციებს საჭიროა კვლევების ჩვენება ვებ‑პორტალებში ან მობილურ მაყურებლებში. Aspose.HTML Cloud SDK for Python უზრუნველყოფს ძლიერი ბიბლიოთეკას, რომელიც სერვერის მხარეს ახდენს რთული ოპერაციების შესრულებას. ამ გიდში თქვენ გაიგებთ, როგორ განხორციელდეს DICOM‑დან JPG‑ში გადაყვანა Python-ში ნაბიჯნაბიჯ, გაეცნოთ მრავალნაკადის (multi‑threaded) არჩევანებს და ნახავთ, როგორ უნდა გამოძახოთ იგივე სერვისი cURL‑ით REST‑ზე დაფუძნებული სამუშაო ნაკადებისთვის.
DICOM-დან JPG ფორმატში გადაყვანის მოთხოვნები
რადიოლოგიის სამუშაო სტაციები ხშირად იღებენ DICOM ფაილებს, რომლებიც უნდა იყოს გადაყვანილი მსუბუქ JPG მინიატურებად სწრაფი გადახედვისთვის. დეველოპერებს სჭირდება გადაწყვეტა, რომელიც:
- ბინარული DICOM მონაცემების წაკითხვა, არ ეყრდნობა გარე გამოსახულების ბიბლიოთეკებზე.
- გამოსახულების გადაყვანა ფართოდ მხარდაჭერილ ფორმატში, მაგალითად JPG, დიაგნოსტიკური ხარისხის შენარჩუნებით.
- დიდი რაოდენობის ფაილების ეფექტური დამუშავება, იდეალურად პარალელური დამუშავებით.
მანუალური კონვერსია დესკტოპის ინსტრუმენტებით დროის მოხმარებითა არის და არ მასშტაბირებს სერვერის‑გვერდის პაიპლაინებს, რაც ავტომატიზებული API‑ს აუცილებელია თანამედროვე რადიოლოგიის პროგრამისთვის.
მეთოდი: ოპტიმიზირებული ღრუბლოვანი კონვერტაციის სამუშაო ნაკადი
Aspose.HTML Cloud SDK for Python ღრუბლოვანი API-ს სთავაზობს, რომელიც აბსტრაქტულად ახორციელებს გადაყვანის ლოგიკას. სერვისი:
- იღებს DICOM-ის დაუმუშავებელ ბაიტებს და აბრუნებს JPG ბაიტურ ნაკადს.
- შესრულდება Aspose cloud-ში, რაც აცილებს ადგილობრივ 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‑ზე კონვერტაციის სამუშაო ნაკადი დასრულებულია, და ახლა შეგიძლიათ უტილიტის ინტეგრირება უფრო დიდ პაიპლაინებში ან მისი გაშვება command‑line სკრიპტებიდან.
DICOM to 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 პაიპლაინებთან ინტეგრაციისთვის.
- მიიღეთ წვდომის ჟეტონი
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
ეს ბრძანებები აჩვენებს მრავალნაკადის კონვერსიის სამუშაო ნაკადს, სადაც მრავალ ფაილს შეიძლება თანაბრად დამუშავება, ერთდროულად რამდენიმე ატვირთვა/გადაყვანის წყვილის გამოთავისუფლებით. სრულ 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 სკრიპტია შეიძლება პირდაპირ ტერმინალიდან ან დაგეგმილი დავალებით შესრულდეს.