Radyoloji uygulamalarının çalışmalarını web portallarında veya mobil görüntüleyicilerde görüntülemesi gerektiğinde, tıbbi görüntüleri DICOM formatından JPG formatına dönüştürmek sık yapılan bir görevdir. Aspose.HTML Cloud SDK for Python sunucu tarafında ağır işleri halleden sağlam bir kütüphane sunar. Bu rehberde, Python’da DICOM’dan JPG’ye dönüşümü adım adım nasıl uygulayacağınızı, çok iş parçacıklı seçenekleri keşfedeceğinizi ve aynı hizmeti REST‑tabanlı iş akışları için cURL ile nasıl çağıracağınızı öğreneceksiniz.
DICOM’dan JPG’ye Dönüştürme Gereksinimleri
Radyoloji iş istasyonları genellikle hızlı ön izleme için hafif JPG küçük resimler olarak işlenmesi gereken DICOM dosyaları alır. Geliştiricilerin bir çözüm ihtiyacı vardır:
- Dış görüntüleme kütüphanelerine güvenmeden ikili DICOM verilerini okur.
- Görüntüyü, tanı kalitesini koruyarak JPG gibi yaygın desteklenen bir formata dönüştürür.
- Büyük dosya hacimlerini verimli bir şekilde işler, tercihen paralel işleme ile.
Masaüstü araçları kullanarak manuel dönüşüm zaman alıcıdır ve sunucu‑tarafı hatları için ölçeklenemez, bu da modern radyoloji yazılımı için otomatik bir API’yi zorunlu kılar.
Yaklaşım: Optimize Edilmiş Bulut Dönüştürme İş Akışı
Aspose.HTML Cloud SDK for Python, dönüşüm mantığını soyutlayan bulut‑tabanlı bir API sunar. Servis:
- Ham DICOM baytlarını kabul eder ve bir JPG bayt akışı döndürür.
- Aspose bulutunda çalışır, yerel DICOM ayrıştırıcılarına olan ihtiyacı ortadan kaldırır.
- Görüntü kalitesi, çözünürlük ve çok iş parçacıklı yürütme için yapılandırma seçenekleri sunar.
Kimlik doğrulama ayrıntıları için resmi belgeler ve bu öğreticide kullanılan ConvertDocumentRequest sınıfı için API referansı inceleyin.
Python’da DICOM’dan JPG’ye Dönüştürme Uygulaması
Aşağıda, herhangi bir radyoloji arka ucuna entegre edebileceğiniz pratik, adım adım bir uygulama bulunmaktadır.
Kur Aspose.HTML Cloud SDK for Python
pip install asposehtmlcloud
API İstemcisini Kimlik Bilgilerinizle Yapılandırın
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 Dosyasını Belleğe Yükle
with open(input_file, "rb") as f:
dicom_bytes = f.read()
JPG Çıktısı için Dönüştürme İsteği Oluştur
from asposehtmlcloud import ConvertDocumentRequest
request = ConvertDocumentRequest(
file=dicom_bytes,
format="jpg"
)
JPG Baytlarını Diske Yaz
jpg_bytes = html_api.convert_document(request)
with open(output_file, "wb") as out_f:
out_f.write(jpg_bytes)
Bu adımlarla DICOM’dan JPG’ye dönüşüm iş akışı tamamlanmıştır ve artık aracı daha büyük boru hatlarına entegre edebilir veya komut satırı betiklerinden çağırabilirsiniz.
DICOM’tan JPG’ye Dönüştürme Aracı - Tam Kod Örneği
Aşağıdaki örnek, tam uçtan uca süreci gösterir.
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)
Not: Bu kod örneği temel işlevselliği gösterir. Projenizde kullanmadan önce, tüm dosya yollarını ve yapılandırma değerlerini gerçek ortamınıza uygun şekilde güncellediğinizden, gerekli tüm bağımlılıkların doğru şekilde yüklendiğinden emin olun ve geliştirme ortamınızda kapsamlı bir şekilde test edin. Herhangi bir sorunla karşılaşırsanız, lütfen resmi belgelere bakın veya destek ekibi ile iletişime geçin.
cURL kullanarak REST API üzerinden Çok İş Parçacıklı Dönüştürme
Saf bir REST yaklaşımını tercih ediyorsanız, aynı dönüşüm cURL komutlarıyla gerçekleştirilebilir. Bu, komut satırı otomasyonu veya CI boru hatlarıyla entegrasyon için faydalıdır.
- Erişim belirteci alın
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 dosyasını yükleyin
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’ye Dönüştürme İsteği
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
- Dönüştürülmüş JPG’yi indirin (doğrudan kaydedilmediyse)
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
Bu komutlar, birden fazla dosyanın aynı anda birden çok yükleme/dönüştürme çifti gönderilerek paralel olarak işlenebileceği çok iş parçacıklı bir dönüştürme iş akışını gösterir. Tam API detayları için resmi API belgelerine bakın.
DICOM’dan JPG’ye Dönüşüm Seçeneklerini Yapılandırma
SDK, çıktıyı ince ayar yapmanıza olanak tanır. Yaygın seçenekler şunlardır:
- Görüntü Kalitesi - JPEG sıkıştırma seviyesini (0‑100) ayarlayın.
- Çözünürlük - Yüksek çözünürlüklü çıktı için DPI ayarlayın.
- Renk Modu - DICOM renk verisi içeriyorsa, gri tonlama ve renk arasında seçim yapın.
Bu seçenekleri istek yükünde geçirebilirsiniz. Örneğin, kaliteyi ayarlamak için:
request = ConvertDocumentRequest(
file=dicom_bytes,
format="jpg",
options={"quality": 90}
)
Desteklenen tüm parametreler API referansı açıklanmıştır. Özellikle büyük DICOM veri setleriyle çalışırken, dosya boyutu ve tanısal netlik arasında en iyi dengeyi sağlamak için bu ayarlarla deney yapın.
Sonuç
Python’da DICOM’tan JPG’ye dönüşüm Aspose.HTML Cloud SDK for Python ile sorunsuz hale gelir. Kütüphane ağır işleri halleder, yüksek verimli ortamlarda çok iş parçacıklı yürütme sunar ve görüntü kalitesi üzerinde ayrıntılı kontrol sağlar. Üretim dağıtımları için uygun bir ticari lisans almayı unutmayın; fiyatlandırma detayları ürün sayfasında mevcuttur ve geçici bir lisans geçici lisans sayfasından temin edilebilir. Yukarıdaki kod ve cURL örnekleriyle, güvenilir DICOM’tan JPG’ye dönüşümü bugün herhangi bir radyoloji uygulamasına entegre edebilirsiniz.
SSS
Aspose.HTML Cloud SDK, DICOM dışındaki hangi dosya formatlarını dönüştürebilir?
SDK, PDF, PNG, BMP, GIF, TIFF ve SVG dahil olmak üzere geniş bir format yelpazesini destekler. Tam liste için belgeler başvurun.
Dış araçlar kurmadan dönüşümü çalıştırmak mümkün mü?
Evet. Dönüşüm tamamen bulutta gerçekleştirilir, bu yüzden yerel DICOM kütüphaneleri veya görüntü işleme araçları gerekmez.
Çok iş parçacıklı dönüşüm performansı nasıl artırır?
Paralel olarak birden fazla dönüşüm isteği göndererek, Aspose sunucularındaki birden çok CPU çekirdeğini kullanabilir ve büyük DICOM dosyası toplulukları için toplam işleme süresini azaltabilirsiniz.
SDK’yı bir komut satırı betiğinde kullanabilir miyim?
Kesinlikle. Sağlanan cURL örnekleri bir komut satırı iş akışını gösterir ve Python betiği doğrudan bir terminalden veya zamanlanmış görevden çalıştırılabilir.